Integration - API. Teknisk beskrivning

Integration - API GrunduppgifterPlus Företag

Senast ändrad 2020-03-17

___________________________________________________________________________

Integration - API

GrunduppgifterPlus Företag

Teknisk beskrivning

Integration - API GrunduppgifterPlus Företag

Senast ändrad 2020-03-17

___________________________________________________________________________

1 Introduktion

Produkten GrunduppgifterPlus Företag levererar förutom aktuella grunduppgifter för ett organisationsnummer även bifirmor och verksamhetsuppgifter. Informationen kommer från Bolagsverket och SCB och varierar beroende på företagsform.

2018-01-23 Version 1.2 Lägger ut attribut bokstavskod i <Ftgform> (företagsform) 2018-02-28 Version 1.3 Nytt element <Statuskod>

2019-05-28 Version 1.4 Ingen förändring i schema 2019-09-12 Version 1.5 Ingen förändring i schema

2020-03-17 Version 1.6 Lagt till beslutade arbetsgivaravgifter <Arbgivavglista>

2 Anrop

Action [URL]

Method POST

Produkt-ID BFtgruP

Version 1.6

3 Frågan

FRÅGA

<?xml version="1.0" encoding="iso-8859-1" ?>

<Fraga>

<Produkt id="BFtgruP" ver="1.6">

<Objektlista antal="1">

<Objekt>

<Idnr>5561234567</Idnr>

</Objekt>

</Objektlista>

</Produkt>

<Process timestamp="" timeout="" />

<Kund nr="7777777" anv="xxxxxxxxxx" ipaddress="xxx.xxx.xxx" />

</Fraga>

Integration - API GrunduppgifterPlus Företag

Senast ändrad 2020-03-17

___________________________________________________________________________

3.1 Element

<Idnr>5561234567</Idnr> Organisationsnummer 10 siffror

4 Svaret

PRODUKTSPECIFIKT SVAR

<Objekt>

<Omfragad id="5561234567" not="”>

<Namnlista>

<Namn tilltal="”>AB Storbolaget</Namn>

</Namnlista>

<Adresslista>

<Adress typ="padr” not="”>

<Coadress></Coadress>

<Fortsadress></Fortsadress>

<Gatabox>Storgatan</Gatabox>

<Postnr>12345</Postnr>

<Postort>STORSTAD</Postort>

</Adress>

</Adresslista>

<Statustext>Fusion pågår per 2018-01-17. Detta bolag är övertagande.</Statustext>

<Statuskod text="Fusion pågår”>49</Statuskod>

<Ftgform kod="AB” lagerbolag="N”>Aktiebolag</Ftgform>

<Regdatum>20100101</Regdatum>

<Avregdatum></Avregdatum>

<Regverk>20100107</Regverk>

<Bolsate>Storstad / Storstads län</Bolsate>

<Styregdatum>20120701</Styregdatum>

<Aktiekapital dec="2” valuta"SEK”>100000</Aktiekapital>

<Rakenskapsar from"0101” tom="1231”></Rakenskapsar>

<Histnamn>AB Melllanbolaget<Histnamn>

<Firmalista>

<Firma>

<Firmanr></Firmanr>

<Firmanamn></Firmanamn>

<Adresslista>

<Adress typ="” not="”>

<Coadress></Coadress>

<Gatabox></Gatabox>

Integration - API GrunduppgifterPlus Företag

Senast ändrad 2020-03-17

___________________________________________________________________________

<Postnr></Postnr>

<Postort></Postort>

</Adress>

</Adresslista>

<Firmastatus></Firmastatus>

</Firma>

</Firmalista>

<Koncernmoder not="Ingår i koncern”></Koncernmoder>

<Bfirmalista>

<Bifirma typ=”Särskilt företagsnamn”>Mellanbolaget</Bifirma>

<Bifirma typ=”Registrering på annat språk”>Lilla bolaget</Bifirma>

</Bifirmalista>

<Verksamhet>

<Reg_SCB></Reg_SCB>

<Avreg_SCB></Avreg_SCB>

<Verksam_sedan>20100201</Verksam_sedan>

<Arbetsstallen antal=”1” ></Arbetsstallen>

<Antal_anst>10-19 anställda</Antal_anst>

<Omsattning ar=”2013”>20 000 – 49 999 tkr</Omsattning>

<Branschlista>

<Bransch>

<Branschkod>38300</Branschkod>

<Branschtext>Återvinning</Branschtext>

</Bransch>

</Branschlista>

<Skattelista>

<Fskatt datum=”20100201” not=””>Godkänd för F-skatt</Fskatt>

<Moms datum=”” not=””>Registrerad för moms</Moms>

<Arbgiv datum=””>Registrerad som arbetsgivare</Arbgiv>

<Arbgivavglista not=””>

<Arbgivavg>

<Avgift_ar>2020</Avgift_ar>

<Avgiftlista>

<Avgift>

<Period>02</Period>

<Belopp dec=”0” enhet=”kr”>163645</Belopp>

</Avgift>

<Avgift>

<Period>01</Period>

<Belopp dec=”0” enhet=”kr”>169235</Belopp>

</Avgift>

</Avgiftlista>

</Arbgivavg>

Integration - API GrunduppgifterPlus Företag

Senast ändrad 2020-03-17

___________________________________________________________________________

</Arbgivavglista>

</Skattelista>

</Verksamhet>

<Bokslut not="”>

<Bokslutsinfo typ="” nyckeltal="Tillgängligt som nyckeltal.” utskrift="Tillgängligt för utskrift”>

<Period_fr>20110101</Period_fr>

<Period:to>20111231</Period_to>

<Godkdatum>20120509</Godkdatum>

</Bokslutsinfo>

</Bokslut>

</Omfragad>

</Objekt>

</Objektlista>

4.1 Element

<Namnlista> Omslutande element till ett/flera namn

<Namn tilltal="”>AB Storbolaget</Namn> Företagets / Innehavarens namn

<Adresslista> Omslutande element till en/flera adresser

<Adress typ="padr” not="”> Omslutande element till en adress

<Coadress></Coadress> Företagets / Innehavarens c/o-adress

<Gatabox>Storgatan</Gatabox> Företagets / Innehavarens gata/box

<Postnr>12345</Postnr> Företagets / Innehavarens postnummer

<Postort>STORSTAD</Postort> Företagets / Innehavarens postort

<Statustext>Fusion pågår per 2018-01-17. Detta bolag är

övertagande.</Statustext> Företagets eventuella status *

<Statuskod text="Fusion pågår”>49</Statuskod> Företagets status enligt Bolagsverket **

<Ftgform lagerbolag="N”>Aktiebolag</Ftgform> Företagsform ***

<Avregdatum></Avregdatum> Avregistreringsdatum

<Regdatum>20100101</Regdatum> Registreringsdatum

<Regverk>20100107</Regverk> Verksam startar

<Bolsate>Storstad / Storstads län</Bolsate> Säteskommun / Säteslän

<Styregdatum>20120701</Styregdatum> Styrelsens registreringsdatum

<Aktiekapital dec="2” valuta"SEK”>100000</Aktiekapital> Aktiekapital

<Rakenskapsar from"0101” tom="1231”></Rakenskapsar> Räkenskapsår

<Histnamn>AB Melllanbolaget<Histnamn> Tidigare namn

<Firmalista> Omslutande element för ett/flera firmanamn

<Firma> Omslutande element för firmanamn (enskild)

<Firmanr></Firmanr> Löpnummer; om flera enskilda firmor; 001-999

<Firmanamn></Firmanamn> Firmanamn för enskild firma

<Firmastatus></Firmastatus> Status för enskild firma

<Koncernmoder not="Ingår i koncern.”></Koncernmoder> Koncerntillhörighet

Integration - API GrunduppgifterPlus Företag

Senast ändrad 2020-03-17

___________________________________________________________________________

<Bfirmalista> Omslutande element till ett/flera

extra företagsnamn

<Bifirma typ=” Särskilt företagsnamn”>Mellanbolaget Extra företagsnamn ****

</Bifirma>

<Verksamhet> Omslutande element till avdelning

Verksamhet

<Reg_SCB></Reg_SCB> Registreringsdatum SCB

<Avreg_SCB></Avreg_SCB> Avregistreringsdatum SCB

<Verksam_sedan>20100201</Verksam_sedan> Rörelsen verksam sedan

<Arbetsstallen antal=”1” ></Arbetsstallen> Arbetsställen finns

<Antal_anst>10-19 anställda</Antal_anst> Storleksklass; antal anställda

<Omsattning ar=”2013”>20 000 – 49 999 tkr</Omsattning> Omsättningsklass

<Branschlista> Omslutande element för en/flera branscher

<Bransch> Omslutande element för en bransch

<Branschkod>38300</Branschkod> Sni-kod

<Branschtext> Återvinning</Branschtext Bransch i klartext

<Skattelista> Omslutande element till Skatteregistrering

<Fskatt datum=”20100201” not=””>Godkänd för F-skatt F-skatteregistrering

</Fskatt>

<Moms datum=”” not=””>Registrerad för moms</Moms> Momsregistrering

<Arbgiv datum=””>Registrerad som arbetsgivare</Arbgiv> Arbetsgivarregistrering

<Arbgivavglista not=””> Omslutande element till arbetsgivaravgifter

<Arbgivavg> Omslutande element till arbetsgivaravgifter/år

<Avgift_ar>2020</Avgift_ar> År

<Avgiftlista> Omslutande element till arbetsgivaravgifter

/period

<Avgift> Omslutande element till periodens avgift

<Period>02</Period> Period beslutad arbetsgivaravgift

<Belopp dec=”0” enhet=”kr”>163645</Belopp> Belopp beslutad arbetsgivaravgift

<Bokslut not="”> Omslutande element för senaste bokslut

<Bokslutsinfo typ="” nyckeltal="” utskrift="”> Omslutande element för ett bokslut

<Period_fr>20110101</Period_fr> Period; startdatum

<Period_to>20111231</Period_to> Period; slutdatum

<Godkdatum>20120509</Godkdatum> Godkänt av Bolagsverket

* Utökad text

** Samtliga statuskoder finns i bilaga 2

*** Samtliga företagsformer finns i bilaga 1

**** ”Bifirma” och ”Parallellfirma” byter benämning per 2019-01-01 till

”Särskilt företagsnamn” och

”Registrering på annat språk”

Integration - API GrunduppgifterPlus Företag

Senast ändrad 2020-03-17

___________________________________________________________________________

4.2 Attribut

<Namn tilltal="Hans” Innehavarens tilltalsnamn (enskild firma)

<Adress typ="fbf” fbf=folkbokföringsadress (innehavare)

<Adress typ="sps" sps=särskild postadress (innehavare)

<Adress typ="spu" spu=utländsk särskild postadress (innehavare)

<Adress typ="padr" padr=företagets postadress

<Adress not="Senast kända folkbokföringsuppgifter” Status folkbokföring (innehavare)

<Statuskod text="Fusion pågår” Statuskod i klartext

<Ftgform lagerbolag="N” Lagerbolag;

J=JA

N=NEJ

<Aktiekapital dec="2” Antal decimaler

<Aktiekapital valuta"SEK”> Valuta;

SEK=svenska kronor

EUR=euro

<Rakenskapsar from="0101” Räkenskapsår; från och med månad och dag

<Rakenskapsar tom="1231” Räkenskapsår; till och med månad och dag

<Koncernmoder not="Ingår i koncern.” Ingår/Ingår ej i svensk koncern

<Bifirma typ=”Bifirma” Typ; Bifirma/Parallellfirma

<Arbetsstallen antal=”1” > Antal arbetsställen

<Omsattning ar=”2013” År omsättningsklass

<Moms datum=”” Registreingsdatum

<Moms not=”” Meddelande

<Arbgiv datum=”” Registreringsdatum

<Fskatt datum=”20100201” Registreringsdatum

<Fskatt not=”” Meddelande

<Arbgivavglista not=”” Meddelande

<Belopp dec=”0” Belopp arbgivavgift; decimaler

<Belopp enhet=”kr” Belopp arbgivavgift; enhet

<Bokslut not="Bolaget har inte ingivit något bokslut” Notering senaste bokslut

<Bokslutsinfo typ="Delår” Delårsbokslut

<Bokslutsinfo nyckeltal="Tillgängligt som nyckeltal” Tillgängligt / Ännu ej tillgängligt som nyckeltal

/excel

<Bokslutsinfo utskrift=" Tillgängligt för utskrift” Tillgängligt / Ännu ej tillgängligt för utskrift

som pdf

5 Kontakt Syna

Tekniska frågor

Kerstin Andersson

Telefon: 040-25 85 12

Integration - API GrunduppgifterPlus Företag

Senast ändrad 2020-03-17

___________________________________________________________________________

E-post: kerstin.andersson@syna.se