Beskrivning av xml-produkten Personinformation (P25)v 2.02

Transkript

1 1 (21) av xml-produkten Personinformation (P25)v 2.02 Datum: Version: 1.0

2 2 (21) Innehållsförteckning 1. Om dokumentet Allmänt om produkten Personinformation Resultatfil Personinformation Huvudstruktur Informationshuvud substruktur SvarsInformation substruktur Person substruktur Personhuvud substruktur Personidentitet substruktur Revisorskvalifikation substruktur PersonligKonkurs substruktur Konkursdatum substruktur Konkursdatum substruktur Beslut substruktur Tillsynssmyndighet substruktur Adress substruktur Forvaltare substruktur Adress substruktur Bitradesforbud substruktur Beslut substruktur Forbudsdatum substruktur Naringsforbud substruktur Forbudsdatum substruktur Beslut substruktur Undantag substruktur Foretag substruktur Foretagsidentitet substruktur Firma substruktur Foretagsform substruktur Status Foretradare substruktur Funktion substruktur Exempel på svar Exempel Exempel 2 20

3 3 (21) 1. Om dokumentet Detta dokument vänder sig till dig som är mottagare av en xml-produkt från Bolagsverket. Dokumentet är en teknisk beskrivning av xml-produkten P25Personinformation. Innehållet i xml-produkten beskrivs övergripande. Därefter följer en beskrivning av xmlfilens struktur och uppbyggnad: o Huvudstrukturen/rotelementet beskrivs först. o Substrukturer/element beskrivs därefter i separata avsnitt, i den ordning som de är nästlade. o En översiktlig bild över substrukturen inleder varje nytt avsnitt. o En tabell med beskrivning av element och attribut visas under varje bild. 2. Allmänt om produkten Personinformation Produkten visar aktuella uppdrag för en person/företag, samt eventuell information om personlig konkurs, näringsförbud eller biträdesförbud. Utsökningen visar inte de uppdrag där personen/företaget har avslutat sina uppdrag, eller de uppdrag i företag där företaget är upplöst sedan fem år tillbaka. Sökningen avbryts om uppdragen överstiger 300 st (felkod visas) och 300 st av uppdragen visas.

4 4 (21) 3. Resultatfil Filen följer den struktur som visas under respektive kapitel. En beskrivning av de taggar som visas kan läsas i tabellerna under respektive kapitel 3.1 Personinformation Huvudstruktur SchemaVersion Version av schemat. Personinformation Toppnoden för xml-filen. Innehåller data för xml-validering. informationshuvud200:informationshuvud Eventuell information om avsändare, svarsinformation, referenser etc. Person Information om den person som frågan avser Informationshuvud substruktur

5 5 (21) Avsandare Sekvensnummer MeddelandeTyp Referens MeddelandeDatumTid SvarsInformation SessionsId Referens2 Avsändare som skickat frågan och som får svaret. Detta värde kommer från frågan och det är viktigt att detta anges när frågan ställs. Referens som kan anges i sökningen och som sen presenteras i svaret. Datum och tid när svaret levereras. Svarsinformation, svarskod. Ytterligare referens som kan anges i sökningen och som sen presenteras i svaret SvarsInformation substruktur kod text Svarskod, möjliga svarskoder anges i anvisningsdokumentet Teknisk handledning XMLprodukter.pdf. Svarskod i klartext Person substruktur

6 6 (21) personhuvud200:personhuvud Behållare för information om den person som förfrågan gäller. revisor200:revisorskvalifikation Behållare för information om ev. revisorskvalifikation. personstatus202:personligkonkurs Behållare för information om ev personlig konkurs. personstatus202:bitradesforbud Behållare för information om ev biträdesförbud. personstatsu202:naringsforbud Behållare för information om ev näringsförbud. Foretag Behållare för de företag som personen finns registrerad i Personhuvud substruktur Personidentitet Fornamn Namn Behållare för det personnummer som förfrågan gäller. Företrädarens förnamn. Företrädarens efternamn (om fysisk person) eller firma (om juridisk person) Personidentitet substruktur

7 7 (21) bolagsverketsid Sekel Organisationsnummer Personnummer Samordningsnummer GDnummer OvrigIdentitet Lopnummer Internt idnummer på företrädaren. Sekel till personnummer eller samordningsnummer. Värdet kan vara blankt/8/9/0. 8 = = = 2000 Blankt = inget sekel Organisationsnummer på företrädare om den är en juridisk person. Personnummer på företrädare. För person folkbokförd i Sverige visas 10 siffror, för ej folkbokförd i Sverige anges 6 siffror. Samordningsnummer som företrädare. Sk. GDnummer som organisationsnummer. Annan typ av organisationsnummer om företrädarens identitet ej är någon av organisationsnummer, personnummer, samordningsnummer eller GDnummer. Löpnummer för företrädaren. Löpnummer sätts för företagsformer som kan ha flera firmor registrerade med samma organisationsnummer/personnummer Revisorskvalifikation substruktur

8 8 (21) typ Vilken typ av revisorskvalifikation en revisor har PersonligKonkurs substruktur dodsbonummer Konkursdatum Beslut Tillsynsmyndighet Forvaltare Sk. dödsbonummer. Numret är tilldelat av skatteverket. Behållare för information om konkursdatum. Behållare för information om beslut om konkurs. Behållare för information om tillsynsmyndighet. Behållare för information om förvaltare Konkursdatum substruktur Inledd Avslutad Upphavd Behållare för information om inledd konkurs. Datum när personliga konkursen avslutades. Datum när personliga konkursen upphävdes Konkursdatum substruktur

9 9 (21) datum Beslutsfattare kod Datum när personliga konkursen inleddes. Vilken beslutsinstans som tog beslutet (text). Vilken beslutsinstans som tog beslutet (kod) Beslut substruktur Malnummer Målnummer på ärendet Tillsynssmyndighet substruktur Namn Adress Tillsynsmyndighet för personliga konkursen. Behållare för information om adress till tillsynsmyndigheten Adress substruktur

10 10 (21) CO Postadress Postnummer Postort Land Webbadress Telefon Epost Tillsynsmyndighetens c/o. Tillsynsmyndighetens postadress. Tillsynsmyndighetens postnummer. Tillsynsmyndighetens postort. Tillsynsmyndighetens land Forvaltare substruktur Fornamn Namn Adress Konkursförvaltare för personliga konkursen (förnamn). Konkursförvaltare för personliga konkursen (efternamn). Behållare för information om adress till konkursförvaltaren.

11 11 (21) Adress substruktur CO Postadress Postnummer Postort Land Webbadress Telefon Epost Konkursförvaltarens c/o. Konkursförvaltarens postadress. Konkursförvaltarens postnummer. Konkursförvaltarens postort. Konkursförvaltarens land Bitradesforbud substruktur fritext Beslut Forbudsdatum Ev. fritext gällande biträdesförbudet. Behållare för information om beslutet. Behållare för information om förbudsdatum Beslut substruktur

12 12 (21) typ kod Beslutsfattare Malnummer datum Vilken typ av beslut. Vilken beslutsinstans som tog beslutet (kod). Vilken beslutsinstans som tog beslutet (text). Datum när beslutet togs Forbudsdatum substruktur slutligt/from Fr.o.m. datum som det slutliga biträdesförbudet skall gälla.

13 13 (21) slutligt/tom tillfalligt/from upphavning/from T.o.m. datum som det slutliga biträdesförbudet skall gälla. Fr.o.m. datum som det tillfälliga biträdesförbudet skall gälla. Fr.o.m. datum som upphävandet av biträdesförbudet skall gälla Naringsforbud substruktur fritext Forbudsdatum Beslut Undantag avveckling Ev. fritext gällande näringsförbudet. Behållare för information om förbudsdatum. Behållare för information om beslutet. Behållare för information om ev. undantag. Visar fr.o.m. vilket datum avvecklingen gäller Forbudsdatum substruktur slutligt/from Fr.o m. datum som det slutliga näringsförbudet skall gälla.

14 14 (21) slutligt/tom tillfalligt/from upphavning/from T.o.m. datum som det slutliga näringsförbudet skall gälla. Fr.o m. datum som det tillfälliga näringsförbudet skall gälla. Fr.o.m. datum som upphävandet av näringsförbudet skall gälla Beslut substruktur typ kod Beslutsfattare Malnummer datum Vilken typ av beslut. Vilken beslutsinstans som tog beslutet (kod). Vilken beslutsinstans som tog beslutet (text). Datum när beslutet togs Undantag substruktur from tom aterkalldat Fr.o.m. vilket datum undantaget gäller. T.o.m. vilket datum undantaget gäller. Datum när undantaget återkallades Foretag substruktur

15 15 (21) privat publikt Foretagsidentitet firma201: Firma Foretagsform Status Foretradare Markering om företaget är privat. Markering om företaget är publik. Behållare för information om organisationsnummer som ingår i svaret. Behållare för information om företagets namn (firma). Behållare för information om företagets företagsform. Behållare för information om företagets status. Behållare för de företrädare som förfrågan gäller Foretagsidentitet substruktur

16 16 (21) bolagsverketsid Sekel Organisationsnummer Personnummer Samordningsnummer GDnummer OvrigIdentitet Lopnummer Internt idnummer på företaget. Sekel till personnummer eller samordningsnummer. Värdet kan vara blankt/8/9/0. 8 = = = 2000 Blankt = inget sekel Företagets organisationsnummer. Personnummer som organisationsnummer. Samordningsnummer som organisationsnummer. Samordningsnummer tilldelas av Skatteverket för utländska eller svenska medborgare folkbokförd utomlands som ska registrera sig som enskild näringsidkare eller som företrädare i någon annan associationsform. Samordningsnummer skiljer sig från ett vanligt personnummer så till vida att dag alltid är större än 60 (personens födelsedag adderas med 60). Sk. GDnummer som organisationsnummer. GDnummer tilldelas av Skatteverket. Ett juridiskt nummer där månad är större än 1. T.ex Checksiffran stämmer. Har ersatts av samordningsnummer. Dock finns gamla kvar i registret. Annan typ av organisationsnummer. Löpnummer för företrädaren. Löpnummer sätts för företagsformer som kan ha flera firmor registrerade med samma organisationsnummer/personnummer Firma substruktur Namn Företagets namn (firma).

17 17 (21) Registrerad lan200:huvudskyddslan Foretagsform substruktur Foretagsform typ Företagsform på företaget (text). Företagsform på företaget (kod) Status Status kod Ev. Status på företaget (text). Ev. Status på företaget (kod) Foretradare substruktur arbetstagarrepresentant Markering om företrädaren är arbetstagarrepresentant. forsakringstagarrepresentant Markering om företrädaren är försäkringsrepresentant.

18 18 (21) Funktion Utlandsbosatt Behållare för information om företrädarens funktion. Markering om företrädaren är utlandsbosatt Funktion substruktur Funktion kod Vilken funktion företrädaren har (text). Vilken funktion företrädaren har (kod). 4 Exempel på svar Här presenteras exempel på personinformation. Observera att detta är testmaterial och används bara i informationssyfte. I svaret för P25Personinformation så presenteras informationen så här. 4.1 Exempel 1 <?xml version="1.0" encoding="iso "?> <p25:personinformation SchemaVersion="2.02" xmlns:p25=" <inf:informationshuvud xmlns:inf=" ud_200"> <inf:avsandare>peek-a-boo</inf:avsandare> <inf:sekvensnummer>1</inf:sekvensnummer>

19 19 (21) <inf:meddelandetyp>string</inf:meddelandetyp> <inf:referens>2</inf:referens> <inf:meddelandedatumtid> t12:58: :00</inf:meddelandedatumtid> <inf:svarsinformation kod="0" text="ok"/> </inf:informationshuvud> <p25:person> <per:personhuvud xmlns:per=" <per:personidentitet> <iden:sekel xmlns:iden=" Sekel> <iden:personnummer xmlns:iden=" 6</iden:Personnummer> </per:personidentitet> <per:namn>efternamn 2, Förnamn 2</per:Namn> </per:personhuvud> <p25:foretag> <p25:foretagsidentitet> <iden:organisationsnummer xmlns:iden=" 9</iden:Organisationsnummer> </p25:foretagsidentitet> <fir:firma xmlns:fir=" <fir:namn>testbolag Handelsbolag</fir:Namn> </fir:firma> <p25:foretagsform typ="hb">handelsbolag</p25:foretagsform> <p25:foretradare> <p25:funktion kod="bo">bolagsman</p25:funktion> <p25:utlandsbosatt>false</p25:utlandsbosatt> </p25:foretradare> </p25:foretag> <p25:foretag> <p25:foretagsidentitet> <iden:organisationsnummer xmlns:iden=" 97</iden:Organisationsnummer> </p25:foretagsidentitet> <fir:firma xmlns:fir=" <fir:namn>testbolaget 1 AB</fir:Namn> </fir:firma> <p25:foretagsform typ="ab">aktiebolag</p25:foretagsform> <p25:foretradare> <p25:funktion kod="le">styrelseledamot</p25:funktion> <p25:utlandsbosatt>false</p25:utlandsbosatt> </p25:foretradare> </p25:foretag> <p25:foretag> <p25:foretagsidentitet> <iden:organisationsnummer xmlns:iden=" 52</iden:Organisationsnummer>

20 20 (21) </p25:foretagsidentitet> <fir:firma xmlns:fir=" <fir:namn>testbolaget 2 AB</fir:Namn> </fir:firma> <p25:foretagsform typ="ab">aktiebolag</p25:foretagsform> <p25:foretradare> <p25:funktion kod="le">styrelseledamot</p25:funktion> <p25:utlandsbosatt>false</p25:utlandsbosatt> </p25:foretradare> </p25:foretag> <p25:foretag> <p25:foretagsidentitet> <iden:organisationsnummer xmlns:iden=" 7</iden:Organisationsnummer> </p25:foretagsidentitet> <fir:firma xmlns:fir=" <fir:namn>testbolaget 3 AB</fir:Namn> </fir:firma> <p25:foretagsform typ="ab">aktiebolag</p25:foretagsform> <p25:foretradare> <p25:funktion kod="su">styrelsesuppleant</p25:funktion> <p25:utlandsbosatt>false</p25:utlandsbosatt> </p25:foretradare> </p25:foretag> </p25:person> </p25:personinformation> 4.2 Exempel 2 <?xml version="1.0" encoding="iso "?> <Personinformation SchemaVersion="2.01" xmlns=" xmlns:adress200=" xmlns:identitet200=" xmlns:informationshuvud200=" d/informationshuvud_200" xmlns:personhuvud200=" vud_200" xmlns:personstatus200=" us_200"> <informationshuvud200:informationshuvud> <informationshuvud200:avsandare>peek-a-boo</informationshuvud200:avsandare> <informationshuvud200:sekvensnummer>1</informationshuvud200:sekvensnummer> <informationshuvud200:meddelandetyp>string</informationshuvud200:meddelandetyp> <informationshuvud200:referens>2</informationshuvud200:referens> <informationshuvud200:meddelandedatumtid> T12:28: :00</informationshuvud200:MeddelandeDatumTid> <informationshuvud200:svarsinformation kod="0" text="ok"/> <informationshuvud200:sessionsid>tj4dyekflsweenxsaiwctxij.jvm01-dh1-prod- </informationshuvud200:sessionsid> <informationshuvud200:referens2>1</informationshuvud200:referens2> </informationshuvud200:informationshuvud>

21 21 (21) <Person avliden="false" obefintlig="false" register=" Personregistret" sekretess="false" utvandrad="false"> <personhuvud200:personhuvud> <personhuvud200:personidentitet> <identitet200:sekel>19</identitet200:sekel> <identitet200:personnummer> </identitet200:personnummer> </personhuvud200:personidentitet> <personhuvud200:fornamn>förnamn 1</personhuvud200:Fornamn> <personhuvud200:namn>efternamn 1</personhuvud200:Namn> </personhuvud200:personhuvud> <adress200:adress> <adress200:co/> <adress200:postadress>gatan 79</adress200:Postadress> <adress200:postnummer>243 99</adress200:Postnummer> <adress200:postort>staden</adress200:postort> <adress200:land/> </adress200:adress> <personstatus200:personligkonkurs> <personstatus200:konkursdatum> <personstatus200:inledd> <personstatus200:datum> </personstatus200:datum> <personstatus200:beslutsfattare kod="">tingsrätt </personstatus200:beslutsfattare> </personstatus200:inledd> </personstatus200:konkursdatum> <personstatus200:beslut> <personstatus200:malnummer>k 99-99</personstatus200:Malnummer> </personstatus200:beslut> <personstatus200:forvaltare> <personstatus200:fornamn>fornamn 4</personstatus200:Fornamn> <personstatus200:namn>efternamn 4</personstatus200:Namn> <personstatus200:adress> <adress200:postadress>box</adress200:postadress> <adress200:postnummer>221 05</adress200:Postnummer> <adress200:postort>lund</adress200:postort> </personstatus200:adress> </personstatus200:forvaltare> </personstatus200:personligkonkurs> </Person> </Personinformation>