Utformning av tjänster anslutna till den Sammansatta bastjänsten för grundläggande uppgifter om företag Version: 3.0 1 (19)
Innehållsförteckning 1 Ändringshistorik... 2 2 Inledning... 3 3 Inledande text... 3 4 Hämta uppgifter på egen begäran... 3 5 Ändring av uppgifter... 4 6 Företagsuppgifter för olika företagsformer... 4 7 er och presentation av företagsuppgifter... 6 8 Företagslista... 17 8.1 Presentation 17 8.2 Sorteringsordning 17 9 Felmeddelande... 19 1 Ändringshistorik Version Datum Beskrivning Ansvarig 2.0 2017-11-07 Första officiella publicerade version av detta dokument i samband med release november 2017. Ingemar Öhrner 3.0 2019-05-09 Ändrat namn på dokumentet från: Användargränssnitt för e-tjänster anslutna till SSBT till: Utformning av tjänster anslutna till SSBT i samband med funktionalitet för direkt återanvändning. Uppdaterad med företagsuppgiften Juridisk form. Ingemar Öhrner 2 (19)
2 Inledning I detta dokument finns texter som skall eller bör användas av tjänster som hämtar företagsuppgifter från. Med tjänster menas i detta sammanhang e-tjänster och verksamhetssystem. Vissa delar gäller enbart e-tjänster och andra delar gäller både e-tjänster och verksamhetssystem, detta beskrivs i respektive kapitel. 3 Inledande text Detta kapitel gäller enbart e-tjänster. En användare skall informeras om möjligheten att hämta företagsuppgifter från andra myndigheter och vad det innebär, innan en e-tjänst startas eller innan inloggning. Vi rekommenderar följande text med länk till en informationssida på Bolagsverket. Hämta dina företagsuppgifter I e-tjänsten kan du välja att hämta dina företagsuppgifter från Bolagsverket, SCB och Skatteverket, så att du slipper fylla i dem. Läs mer på sidan Så här hämtas dina företagsuppgifter. Använd denna länk till texten Så här hämtas dina företagsuppgifter : http://bolagsverket.se/sammansatt-bastjanst-foretagsuppgifter 4 Hämta uppgifter på egen begäran Detta kapitel gäller enbart e-tjänster. Användaren skall hämta uppgifter på egen begäran, det måste vara ett medvetet val som användaren skall informeras om. Denna egen begäran och logiken kring hämtning kan utformas på olika sätt, nedan ger vi ett exempel hur det kan utformas. I detta exempel har användaren även valet att fortsätta i e-tjänsten utan förifyllnad av hämtade uppgifter. Exempel på lösning: Mina företagsuppgifter Jag vill använda tjänsten med mina företagsuppgifter som hämtas från Bolagsverket, SCB och Skatteverket och jag vill fylla i mina företagsuppgifter själv. 3 (19)
5 Ändring av uppgifter Detta kapitel gäller enbart e-tjänster. I anslutning till uppgifter hämtade via skall denna text finnas eller en länk till texten. Exempel på lösning: Vill du ändra uppgifter om ditt företag? Det gör du på verksamt.se. Om du som enskild näringsidkare vill ändra folkbokföringsadress gör du det hos Skatteverket. Länk till verksamt.se : https://www.verksamt.se/ Länk till Skatteverket : https://www.skatteverket.se/ 6 Företagsuppgifter för olika företagsformer Detta kapitel gäller för både e-tjänster och verksamhetssystem. Företagsuppgifter finns tillgängliga för olika företagsformer. Tabellen nedan är en sammanställning av vilka uppgifter som finns för respektive företagsform. För att ge användaren en bättre användarupplevelse bör e-tjänsten enbart efterfråga uppgifter som finns per företagsform. 4 (19)
UD nummer Beskrivning Företagsform Enskild näringsidkare Registrerad Bolagsverket Registrerad enbart Skatteverket Juridisk person AB HB / KB Organisationsnummer X X X Personnummer X X EK / BRF Tillgängliga för direkt återanvändning UD0001 Registrerat företagsnamn X X X X X 2 UD0002 Juridisk form X X X X X UD0003 Juridisk person postadress X X X X 2 UD0004 E-postadress till företaget X X X X X 2 UD0006 Telefonnummer till företaget X X X X X UD0009 Postadress till företagets arbetsställen X X X X X UD0010 Belägenhetsadress till företagets arbetsställen X X X X X UD0011 Kommunkod säte X X X X X 2 UD0012 Länskod säte X X X X X 2 UD0014 Räkenskapsår X X X 2 UD0020 Enskild näringsidkares fullständiga namn X X UD0023 Enskild näringsidkares folkbokföringsadress X X UD0024 SNI-koder företag X X X 1 X 1 X 1 UD0025 Företagsform X X X X X 2 UD0026 Datum för företagets registrering X X X X UD0027 Företagets status X X X X X 2 UD0028 Näringslivsregistrering X X X X X 2 UD0029 F-skatt skatteform X X X 1 X 1 X 1 UD0031 Momsregistrering X X X 1 X 1 X 1 UD0033 Arbetsgivarregistrering X X X 1 X 1 X 1 UD0034 CFAR-nummer X X X X X UD0039 SNI-koder för företagets arbetsställen X X X X X UD0040 Belägenhetsadress till företaget X X X X X UD0042 Antal arbetsställen X X X X X UD0043 Benämning på företagets arbetsställen X X X X X UD0044 Markering för huvudarbetsställe X X X X X UD0045 Firmateckning X X X X 2 UD0046 Verksamhetsbeskrivning X X X X X 2 UD0047 Samlade funktionärer X X X X X 2 UD0048 Aktiekapital/aktier X X 2 UD0049 Telefonnummer till företagets arbetsställen X X X X X X 1, Krav på rollintyg då uppgifterna endast utlämnas till firmatecknare, gäller e-tjänster, indirekt återanvändning. X 2, Direkt återanvändning erbjuds de myndigheter, utom statliga affärsverk, som enligt Förordning (2007:755) om det allmänna myndighetsregistret finns registerförda i myndighetsregistret. 5 (19)
7 er och presentation av företagsuppgifter Tabellen nedan ger vilka ledtexter som skall användas samt rekommenderat format på presenterade företagsuppgifter i e-tjänsterna och verksamhetssystem. I -gränssnittet har en entydig, neutral representation valts för ett flertal informationsbärande element. Denna representation är i vissa fall inte rekommenderad att visa direkt för e-tjänsters användare. gränssnitt Organisationsnummer Organisationsnummer 10 siffror xxxxxx-xxxx Exempel Organisationsnummer: 556000-4755 gränssnitt Personnummer Personnummer 12 siffror ååååmmdd-xxxx Exempel Personnummer: 19810105-2382 UD0001 Registrerat företagsnamn Bolagsverket gränssnitt Företagsnamn < ForetagNamn >, text max 200 tecken [ForetagNamn], text Exempel Företagsnamn: Exempelbygg AB UD0002 Juridisk form SCB gränssnitt Juridisk form < JuridiskFormKod >, 2 siffror < JuridiskFormBeskrivning >, text max 30 tecken [JuridiskFormKod][ JuridiskFormBeskrivning] Exempel Juridisk form: 49 Aktiebolag 6 (19)
UD0003 Juridisk person postadress Bolagsverket gränssnitt Postadress < COAdress >, text max 50 tecken < Utdelningsadress1 >, text max 32 tecken < Utdelningsadress2 >, text max 32 tecken < Postnummer >, 5 siffror < Port >, text max 32 tecken < Land >, text max 32 tecken Rekommendation c/o [COAdress] [Utdelningsadress1] [Utdelningsadress2] [Postnummer ][Postort] [Land] Om c/o ingår i värdet för c/o adress skall c och o visas som gemener och första bokstaven i varje del av adressen som föregås av ett blanktecken visas som versal. Övriga bokstäver visas om gemener. Fösta bokstaven i Utdelningsadress 1 resp. Utdelningsadress 2 visas versalt och bokstäver efter blanktecken visas också versalt. Övriga bokstäver visas som gemener. De två sista siffrorna i postnummer skall föregås av ett blanktecken. Postort och Land skall visa första bokstav versalt och övriga bokstäver som gemener. De olika adressfälten visas när uppgifter finns. Saknas t.ex. COAdress så tas den raden bort. Om ingen adress alls finns att tillgå visas blankt. Exempel Postadress: Testgatan 1 851 81 Sundsvall UD0004 E-postadress till företag Bolagsverket från E-postadress < EPostAdress >, text max 50 tecken [EPostAdress], text Exempel E-postadress: exempelbygg@example.com 7 (19)
UD0006 Telefonnummer till företaget SCB från Telefon < Telefonnummer >, text max 11 tecken [Telefonnummer] Exempel Telefon: 070-1234567 UD0009 Postadress till företagets arbetsställen SCB från Postadress < COAdress >, text max 50 tecken < Utdelningsadress1 >, text max 32 tecken < Utdelningsadress2 >, text max 32 tecken < Postnummer >, 5 siffror < Port >, text max 32 tecken < Land >, text max 32 tecken Rekommendation c/o [COAdress] [Utdelningsadress1] [Utdelningsadress2] [Postnummer ][Postort] [Land] Om c/o ingår i värdet för c/o adress skall c och o visas som gemener och första bokstaven i varje del av adressen som föregås av ett blanktecken visas som versal. Övriga bokstäver visas om gemener. Fösta bokstaven i Utdelningsadress 1 resp. Utdelningsadress 2 visas versalt och bokstäver efter blanktecken visas också versalt. Övriga bokstäver visas som gemener. De två sista siffrorna i postnummer skall föregås av ett blanktecken. Postort och Land skall visa första bokstav versalt och övriga bokstäver som gemener. De olika adressfälten visas när uppgifter finns. Saknas t.ex. COAdress så tas den raden bort. Om ingen adress alls finns att tillgå visas blankt. Visas inte om det endast finns ett arbetsställe. Exempel Postadress: c/o Andersson Storgatan 1 852 45 Orten Sweden 8 (19)
UD0010 Belägenhetsadress till företagets arbetsställen SCB från Arbetsställets belägenhetsadress < CFARNummer >, 8 siffror < LanKod >, 2 tecken < LanNamn >, text < KommunKod >, 4 tecken < KommunNamn >, text < Adressomrade >, text < Adressplats >, text < Postnummer >, 5 siffror < Postort >, text Rekommendation [Adressomrade][ adressplats],[ postnummer][ Postort] Första bokstaven i adressområde samt bokstäver som föregås av ett blanktecken skall visas versalt. Övriga bokstäver med gemener. Bokstäver i adressplats skall visas som versaler Postnumret skall presenteras med ett mellanslag före de två sista siffrorna. Postort skall visa första bokstav versalt och övriga bokstäver som gemener. De olika adressfälten visas när uppgifter finns. Saknas alla adressuppgifter visas blankt värde. Exempel Arbetsställets belägenhetsadress: Sidsjövägen 2B, 852 37 Sundsvall UD0011 Kommunkod säte Bolagsverket från Exempel Län och kommun: < KommunKod >, 4 tecken < KommunNamn >, text [Län],[ Kommun][(kommunkod)] Första bokstaven i län skall vara versal, övriga bokstäver gemener. Första bokstaven i kommun skall vara versal, övriga bokstäver gemener. Presentation om län och kommun kombineras från UD0011 och UD0012 Län och kommun: Västernorrlands län, Sundsvalls kommun (2281) 9 (19)
UD0012 Länskod säte Bolagsverket från Län och kommun: <LanKod>, 2 tecken <LanNamn>, text [Län],[ Kommun][(kommunkod)] Första bokstaven i län skall vara versal, övriga bokstäver gemener. Första bokstaven i kommun skall vara versal, övriga bokstäver gemener. Presentation om län och kommun kombineras från UD0011 och UD0012. Exempel Län och kommun: Västernorrlands län, Sundsvalls kommun (2281) UD0014 Räkenskapsår Bolagsverket från Exempel Räkenskapsår <RakenskapsarFrom.Manad>, heltal 1-12 <RakenskapsarFrom.Dag>, heltal 1-31 <RakenskapsarTom.Manad>, heltal 1-12 <RakenskapsarTom.Dag>, heltal 1-31 [mmdd] [mmdd] Räkenskapsår: 0101-1231 UD0020 Enskild näringsidkares fullständiga namn Skatteverket från Namn <Fornamn>, text <Tilltalsnamn >, Ja / Nej <Mellannamn>, text <Efternamn>, text [Förnamn1 ][Förnamn2..n ][Mellannamn ][Efternamn]. Varje namnuppgift skall visas med inledande bokstav versalt och resten av namnet med gemener. För namn som är sammansatta med bindestreck skall båda namnen inledas med versal. Tilltalsnamnet skall vara understruket (om den uppgiften levereras) Exempel Namn: Lars-Erik Anders Urban Svensson Persson 10 (19)
UD0023 Enskild näringsidkares folkbokföringsadress Skatteverket från Folkbokföringsadress < COAdress >, text max 50 tecken < Utdelningsadress1 >, text max 32 tecken < Utdelningsadress2 >, text max 32 tecken < Postnummer >, 5 siffror < Port >, text max 32 tecken < Land >, text max 32 tecken Rekommendation c/o [COAdress] [Utdelningsadress1] [Utdelningsadress2] [Postnummer ][Postort] [Land] Om c/o ingår i värdet för c/o adress skall c och o visas som gemener och första bokstaven i varje del av adressen som föregås av ett blanktecken visas som versal. Övriga bokstäver visas om gemener. Fösta bokstaven i Utdelningsadress 1 resp. Utdelningsadress 2 visas versalt och bokstäver efter blanktecken visas också versalt. Övriga bokstäver visas som gemener. De två sista siffrorna i postnummer skall föregås av ett blanktecken. Postort och Land skall visa första bokstav versalt och övriga bokstäver som gemener. De olika adressfälten visas när uppgifter finns. Saknas t.ex. COAdress så tas den raden bort. Om ingen adress alls finns att tillgå visas blankt. Exempel Folkbokföringsadress: c/o Andersson Storgatan 1 852 45 Orten Sweden 11 (19)
UD0024 SNI-koder företag Skatteverket Verksamhet (SNI 2007) från <SNIKod>, 5 siffror <SNIBeskrivning>, text [xx.xxx] [Beskrivning] Kod formateras med 2 siffror, punkt, 3 siffror. Beskrivning skrivs som text. Regler för visning: Visas alltid om värde/värden levererar. Visas som blankt värde om blankt värde levererar och registrering om F-/FAskatt, moms eller arbetsgivare finns. döljs om registrering om F-/FA-skatt, moms och arbetsgivare saknas samt att blankt värde levereras Exempel Verksamhet (SNI 2007): 25.710 Tillverkning av bestick 71.123 Teknisk konsultverksamhet inom elteknik UD0025 Företagsform Bolagsverket från Företagsform <ForetagsformKod>, 1-4 tecken <ForetagsformBeskrivning>, text Företagsform kan anta följande värden. Kod E AB HB KB EK BRF Beskrivning Enskild näringsidkare. Aktiebolag. Handelsbolag. Kommanditbolag. Ekonomisk förening. Bostadsrättsförening. [Beskrivning] Exempel Företagsform: Aktiebolag UD0026 Datum för företagets registrering Bolagsverket från Registrerat datum < date > [åååå-mm-dd] Exempel Registrerat datum: 2011-03-25 12 (19)
UD0027 Företagets status Bolagsverket gränssnitt Status < AvvecklingKod >, 2 siffror < AvvecklingBeskrivning >, text max 80 tecken < AvvecklingDatum >, datum [Beskrivning] [Datum] Är blankt om det inte finns någon statusanmärkning på företaget. Om företaget är aktivt kommer värdet att vara blankt. Exempel Företagets status: Konkurs inledd 2011-03-28 UD0029 F-skatt skatteform Skatteverket från Godkänd för F-skatt < Skatteform >, enumeration Ja / Nej [Skatteform] Exempel Godkänd för F-skatt: Ja UD0031 Momsregistrering Skatteverket från Registrerad för moms < Momsregistrerad >, enumeration Ja / Nej [Momsregistrerad] Exempel Registrerad för moms: Ja UD0033 Arbetsgivarregistrering Skatteverket från Exempel Registrerad som arbetsgivare < Arbetsgivarregistrerad >, enumeration Ja / Nej [Arbetsgivarregistrerad] Registrerad som arbetsgivare: Nej UD0034 CFAR-nummer SCB från CFAR-nummer < CFARNummer >, 8 siffror Lista med noll till många CFAR-nummer. [xxxx-xxxx] Exempel CFAR-nummer: 1234-5678 13 (19)
UD0039 SNI-koder för företagets arbetsställen SCB Verksamhet (SNI 2007) från <CFARNummer>, 8 siffror <SNIKod>, 5 siffror <SNIBeskrivning>, text [SNI-kod][ Beskrivning], Exempel Verksamhet (SNI 2007) 62.020 Datorkonsultverksamhet UD0040 Belägenhetsadress till företaget SCB från Företagets belägenhetsadress < LanKod >, 2 tecken < LanNamn >, text < KommunKod >, 4 tecken < KommunNamn >, text < Adressomrade >, text < Adressplats >, text < Postnummer >, 5 siffror < Postort >, text Rekommendation [Adressomrade][ adressplats],[ postnummer][ Postort] Första bokstaven i adressområde samt bokstäver som föregås av ett blanktecken skall visas versalt. Övriga bokstäver med gemener. Bokstäver i adressplats skall visas som versaler Postnumret skall presenteras med ett mellanslag före de två sista siffrorna. Postort skall visa första bokstav versalt och övriga bokstäver som gemener. De olika adressfälten visas när uppgifter finns. Saknas alla adressuppgifter visas blankt värde. Exempel Företagets belägenhetsadress: Sidsjövägen 2B, 852 37 Sundsvall UD0042 Antal arbetsställen SCB från Antal arbetsställen < AntalArbetsstallen >, heltal större eller lika med 1 [antal] Exempel Antal arbetsställen: 2 14 (19)
UD0043 Benämning på företagets arbetsställen SCB från Benämning < CFARNummer >, 8 siffror < ArbetsstalleBenamning >, text [benämning] Exempel Benämning: Daghemmet blåsippan UD0044 Markering för huvudarbetsställe SCB från Huvudarbetsställe < CFARNummer >, 8 siffror < Huvudarbetsstalle >, enumeration Ja / Nej [Huvudarbetsstalle] Exempel Huvudarbetsställe: Ja UD0045 Firmateckning Bolagsverket från Firmateckning < FirmateckningBeskrivning >, text [Beskrivning] Exempel Firmateckning: Firman tecknas av styrelsen UD0046 Verksamhetsbeskrivning Bolagsverket från Verksamhetsbeskrivning < Verksamhetsbeskrivning >, text [Verksamhetsbeskrivning] Exempel Verksamhetsbeskrivning: Testverksamhet UD0047 Samlade funktionärer Bolagsverket från Samlade funktionärer < SamladeFunktionarerBeskrivning >, text [Beskrivning], text Exempel Samlade funktionärer: Styrelseledamot 198101032384 EN10003, FN10003, SUNDSVALL Styrelsesuppleant 198101052382 EN10005, FN10005, SUNDSVALL Revisor 198104122380 EN10102, FN10102, SUNDSVALL 15 (19)
UD0048 Aktiekapital Bolagsverket Sammanställning av aktiekapital Aktiekapital: Antal aktier: Fördelning av utgivna aktier Aktieslag: Antal: Röstvärde: från Exempel < AktierAntal >, heltal < Aktiekapital >, decimaltal 19,6 < Redovisningsvaluta, attributes >, enumeration SEK / EUR < AktieslagBeteckning >, 30 tecken < AktieslagAntal >, heltal < AktieslagRostvarde >, 10 tecken Sammanställning av aktiekapital Aktiekapital: 1 500 000 SEK Antal aktier: 15 000 Fördelning av utgivna aktier Aktieslag: A Antal: 10 000 Röstvärde: 10 Aktieslag: B Antal: 5 000 Röstvärde: 1 UD0049 Telefonnummer till företaget arbetsställen SCB från Telefon < CFARNummer >, 8 siffror < Telefonnummer >, text max 11 tecken [Telefonnummer], text Exempel Telefon: 070-1234567 16 (19)
8 Företagslista Detta kapitel gäller för både e-tjänster och verksamhetssystem. När Engagemangstjänstens resultat skall presenteras, i en e-tjänst eller verksamhetssystem, rekommenderas följande sorteringsordning på företagen i företagslistan. 8.1 Presentation Engagemangstjänsten hämtar uppgifter om företagsengagemang från Bolagsverket och Skatteverket. Bolagsverket har uppgifter om Aktiebolag, Bostadsrättsförening, Ekonomiskförening, Handelsbolag, Kommanditbolag och Enskild näringsidkare med namnskydd. Skatteverket har uppgifter om Enskild näringsverksamhet. 8.2 Sorteringsordning Företagslistan bör sorteras i följande ordning: 1. Enskild näringsidkare med namnskydd i bokstavsordning 2. Enskild näringsverksamhet om ingen Enskild näringsidkare finns registrerad hos Bolagsverket 3. Tom rad eller skiljetecken 4. Övriga företagsformer sorterad i bokstavsordning Exempel 1: Registrering av Enskild näringsverksamhet hos Skatteverket, inge registrering av Enskild näringsidkare med namnskydd hos Bolagsverket. 17 (19)
Exempel 2: Ingen registrering av Enskild näringsverksamhet hos Skatteverket, registrering av Enskild näringsidkare med namnskydd hos Bolagsverket. Exempel 3: Registrering av Enskild näringsverksamhet hos Skatteverket, registrering av Enskild näringsidkare med namnskydd hos Bolagsverket. Exempel 4: Ingen registrering av Enskild näringsverksamhet hos Skatteverket, ingen registrering av Enskild näringsidkare med namnskydd hos Bolagsverket. 18 (19)
9 Felmeddelande Denna beskrivning gäller för både e-tjänster och verksamhetssystem. Förslag på felmeddelande vid fel från, om feltyp finns skriv ut den annars utelämnas det fältet. För ytterligare information om felhantering av fel från se dokumentet Sammansatta bastjänsten för grundläggande uppgifter om företag teknisk guide, kapitel 5.3 Felhantering. Fel vid hämtning av företagsuppgifter från myndigheter. Försök igen senare eller fyll i dina uppgifter själv., feltyp nnnnnnnnnnnnnn 19 (19)