B2B API — Unternehmensinformationen per SIRET abrufen (Classic)

Support DQE
Support DQE
  • Aktualisiert

Verwenden Sie diesen Endpunkt, um detaillierte rechtliche Informationen zu einem ausgewählten Unternehmen abzurufen.

Verwandte B2B Classic API-Dokumentation:

GET-Anfrage

Es gibt zwei Möglichkeiten, Unternehmensdetails abzurufen:

  • Komprimierte Form: mit dem von RECSIRET zurückgegebenen SEARCH_REF.
  • Erweiterte Form: direkt mit der Unternehmens-Siret-Nummer.

Komprimierte Form

Endpunkt

https://{SERVER_ADDRESS}/SIRETINFO/?SEARCH_REF={REF}&Dictionary=Y&Country={COUNTRY_CODE}&Licence={LICENCE_CODE}

Ersetzen Sie die Werte in geschweiften Klammern durch Ihre eigenen Informationen:

Parameter Wert Beschreibung Pflicht/Optional
SERVER_ADDRESS {SERVER_ADDRESS} Adresse des DQE-Servers, der die Daten verarbeitet. Pflicht
Licence {LICENCE_CODE} Ihrem Konto zugewiesener Lizenzcode. Pflicht
SEARCH_REF {REF} Von der RECSIRET-Suche zurückgegebene Unternehmensreferenz. Pflicht
Dictionary Y Aktiviert die wörterbuchbasierte Suche. Pflicht
Country {COUNTRY_CODE} ISO-3-Buchstaben-Ländercode. Pflicht
NAF25 {NAF25} Ruft den neuen Wert des Sic-Codes in Frankreich ab oder nicht: True / False Optional. Standardwert: False

Erweiterte Form

Endpunkt

https://{SERVER_ADDRESS}/SIRETINFO/?Siret={SIRET}&Country={COUNTRY_CODE}&Licence={LICENCE_CODE}
Parameter Wert Beschreibung Pflicht/Optional
SERVER_ADDRESS {SERVER_ADDRESS} Adresse des DQE-Servers, der die Daten verarbeitet. Pflicht
Licence {LICENCE_CODE} Ihrem Konto zugewiesener Lizenzcode. Pflicht
Siret {SIRET} SIRET-Nummer des Unternehmens. Pflicht
Country {COUNTRY_CODE} ISO-3-Buchstaben-Ländercode. Pflicht
NAF25 {NAF25} Ruft den neuen Wert des Sic-Codes in Frankreich ab oder nicht: True / False Optional. Standardwert: False

POST-Anfrage

Komprimierte Form

Endpunkt

https://{SERVER_ADDRESS}/SIRETINFO/

Senden Sie die folgenden Parameter im Anfragetext mittels x-www-form-urlencoded.

Parameter Wert Beschreibung Pflicht/Optional
Licence {LICENCE_CODE} Ihrem Konto zugewiesener Lizenzcode. Pflicht
SEARCH_REF {REF} Von der RECSIRET-Suche zurückgegebene Unternehmensreferenz. Pflicht
Dictionary Y Aktiviert die wörterbuchbasierte Suche. Pflicht
Country {COUNTRY_CODE} ISO-3-Buchstaben-Ländercode. Pflicht
NAF25 {NAF25} Ruft den neuen Wert des Sic-Codes in Frankreich ab oder nicht: True / False Optional. Standardwert: False

Erweiterte Form

Endpunkt

https://{SERVER_ADDRESS}/SIRETINFO/

Senden Sie die folgenden Parameter im Anfragetext mittels x-www-form-urlencoded.

Parameter Wert Beschreibung Pflicht/Optional
Licence {LICENCE_CODE} Ihrem Konto zugewiesener Lizenzcode. Pflicht
Siret {SIRET} SIRET-Nummer des Unternehmens. Pflicht
Country {COUNTRY_CODE} ISO-3-Buchstaben-Ländercode. Pflicht
NAF25 {NAF25} Ruft den neuen Wert des Sic-Codes in Frankreich ab oder nicht: True / False Optional. Standardwert: False

Antwort

Erfolg

Komprimierte Form

Die JSON-Antwort ist ein Dictionary mit dem Schlüssel DATA1. Es enthält die verfügbaren Felder für das ausgewählte Unternehmen.

Schlüssel Wert Frankreich International
SEARCH_REF Suchreferenz. STRING STRING
CompanyCName Ergänzender Firmenname oder Handelsname. STRING(50) STRING(255)
LegalStructureLabel Rechtsform des Unternehmens. STRING(100) STRING(100)
IncorporationDate Datum der Ansiedlung des Unternehmens in der aktuellen Stadt. STRING STRING
MainCompanyFlag 1: Hauptsitz; 0: sonstige Niederlassung. STRING(1) STRING(1)
CompanyStatus 1: Unternehmen in Betrieb; 0: Unternehmen nicht mehr in Betrieb. STRING(1) STRING(1)
CompanyName Firmenname. STRING(131) STRING(255)
CompanyAddress2 Unternehmensadresse. STRING(38) STRING(50)
CompanyAddress3 Zusätzliche Adressinformationen. STRING(38) STRING(50)
CompanyAddress1 Zusätzliche Adressinformationen. STRING(38) STRING(50)
Locality Unternehmensstadt. STRING(38) STRING(50)
Phone Wird nicht mehr verwendet.
DissolutionDate Datum, an dem das Unternehmen den Betrieb eingestellt hat. STRING STRING
StaffCount Anzahl der Mitarbeiter. STRING STRING
CompanySIC NAF-Code des Unternehmens. STRING(5)
LegalStructureCode Rechtsformcode des Unternehmens. STRING(4) STRING(4)
IntraNumber Innergemeinschaftliche USt-IdNr. STRING(15) STRING
ZIP_Code Postleitzahl der Unternehmensstadt. STRING(5) STRING(10)
TurnOver Wird nicht mehr verwendet.
CompanyNumber SIRET-Nummer des Unternehmens. STRING(14) STRING(14)
CompanyName2 Zusätzlicher Firmenname. STRING STRING
Activity1 Rechtsformcode. STRING STRING
Activity2 Unternehmensgröße, z. B. PME, ME oder GE. STRING(3) STRING(3)
Email Wird nicht mehr verwendet.
Fax Wird nicht mehr verwendet.
Country ISO-3-Buchstaben-Ländercode. STRING(3) STRING(3)

Beispiel:

{
  "DATA1": {
    "MainCompanyFlag": "0",
    "Locality": "VILLENEUVE D ASCQ",
    "IntraNumber": "FR 51 306138900",
    "Email": "",
    "SEARCH_REF": "_13367292",
    "Fax": "",
    "IncorporationDate": "2024-06-24",
    "StaffCount": "Non-employer",
    "Phone": "",
    "LegalStructureLabel": "Société européenne",
    "ZIP_Code": "59650",
    "CompanyStatus": "1",
    "Country": "FRA",
    "CompanySIC": "8559A",
    "LegalStructureCode": "5800",
    "CompanyNumber": "30613890003910",
    "CompanyCName": "",
    "Activity1": "5800",
    "Activity2": "GE",
    "CompanyName": "DECATHLON",
    "CompanyAddress1": "",
    "CompanyAddress2": "52 ALLEE LAKANAL",
    "CompanyAddress3": "",
    "DissolutionDate": "",
    "CompanyName2": "",
    "TurnOver": ""
  }
}

Erweiterte Form

Die JSON-Antwort ist ein Dictionary, das die verfügbaren Felder für das ausgewählte Unternehmen enthält.

Schlüssel Beschreibung Frankreich
DQE_status FOUND oder NOT FOUND. STRING(10)
SIREN Unternehmenskennung. STRING(9)
NIC Interne Klassifizierungsnummer der Niederlassung. STRING(5)
TVAINTRA Innergemeinschaftliche USt-IdNr.
Dieses Feld ist leer, wenn das Unternehmen nicht umsatzsteuerpflichtig ist.
STRING(25)
Normalisierte deklarierte Adresse
L1_NORMALISEE Adresszeile 1: Firmenname, normalisiert nach AFNOR-Standard. STRING(38)
L2_NORMALISEE Adresszeile 2: Wohnung, Tür, Treppe, normalisiert nach AFNOR-Standard. STRING(38)
L3_NORMALISEE Adresszeile 3: Gebäude, normalisiert nach AFNOR-Standard. STRING(38)
L4_NORMALISEE Adresszeile 4: Straße und Hausnummer, normalisiert nach AFNOR-Standard. STRING(38)
L5_NORMALISEE Adresszeile 5: Cedex, Postfach, Ortsname, normalisiert nach AFNOR-Standard. STRING(38)
L6_NORMALISEE Adresszeile 6: Postleitzahl und Stadt, normalisiert nach AFNOR-Standard. STRING(38)
L7_NORMALISEE Adresszeile 7: Land im ISO3-Code, normalisiert nach AFNOR-Standard. STRING(38)
Deklarierte Adresse
L1_DECLAREE Deklarierte Adresse der Niederlassung. STRING(38)
L2_DECLAREE Deklarierte Adresse der Niederlassung. STRING(38)
L3_DECLAREE Deklarierte Adresse der Niederlassung. STRING(38)
L4_DECLAREE Deklarierte Adresse der Niederlassung. STRING(38)
L5_DECLAREE Deklarierte Adresse der Niederlassung. STRING(38)
L6_DECLAREE Deklarierte Adresse der Niederlassung. STRING(38)
L7_DECLAREE Deklarierte Adresse der Niederlassung. STRING(38)
Geografische Adresse
NUMVOIE Hausnummer. STRING(4)
INDREP Zusätzliche Information zur Hausnummer. STRING(1)
TYPVOIE Straßentyp. STRING(4)
LIBVOIE Straßenname. STRING(32)
CODPOS Postleitzahl. STRING(5)
CEDEX CEDEX-Code. STRING(5)
Geografische Lage der Niederlassung
RPET Region. STRING(2)
LIBREG Regionsbezeichnung. STRING(70)
DEPET Departement. STRING(2)
ARRONET Bezirk. STRING(2)
CTONET Kanton. STRING(3)
COMET Stadt. STRING(3)
LIBCOM Stadtname. STRING(32)
DU Departement der städtischen Einheit. STRING(2)
TU Größe der städtischen Einheit. STRING(1)
UU Nummer der städtischen Einheit. STRING(2)
EPCI Zugehörigkeit der Niederlassung zu einem öffentlichen Zweckverband für interkommunale Zusammenarbeit. STRING(9)
TCD Detaillierte Gemeindezone. STRING(2)
ZEMET Beschäftigungsgebiet. STRING(4)
Informationen zur Niederlassung
SIEGE Gibt an, ob es sich bei der Niederlassung um den Hauptsitz handelt. STRING(1)
ENSEIGNE Firmenschild oder Name der Niederlassung. STRING(50)
IND_PUBLIPO Indikator für Direktmarketing-Feld. STRING(1)
DIFFCOM Verbreitungsstatus der Niederlassung. STRING(1)
AMINTRET Jahr und Monat der Aufnahme der Niederlassung in die Datenbank. STRING(6)
Wirtschaftliche Merkmale der Niederlassung
NATETAB Art der Niederlassung eines Einzelunternehmers. STRING(1)
LIBNATETAB Bezeichnung der Art. STRING(30)
APET700 Haupttätigkeit. STRING(5)
LIBAPET Bezeichnung der Haupttätigkeit. STRING(65)
DAPET Gültigkeitsjahr der Haupttätigkeit. STRING(4)
TEFET Mitarbeiterzahl-Bereich der Niederlassung. STRING(2)
LIBTEFET Bezeichnung des Bereichs. STRING(23)
EFETCENT Anzahl der Mitarbeiter der Niederlassung, auf 100 gerundet. STRING(6)
DEFET Gültigkeitsjahr der Mitarbeiterzahl der Niederlassung. STRING(4)
ORIGINE Ursprung der Gründung der Niederlassung. STRING(2)
DCRET Gründungsdatum der Niederlassung. STRING(8)
DDEBACT Beginn der Tätigkeit. STRING(8)
ACTIVNAT Art der Tätigkeit der Niederlassung. STRING(2)
LIEUACT Ort der Tätigkeit der Niederlassung. STRING(2)
ACTISURF Geschäftstyp. STRING(2)
SAISONAT Gibt an, ob die Tätigkeit der Niederlassung saisonal ist. STRING(2)
MODET Art der Haupttätigkeit der Niederlassung. STRING(1)
PRODET Produktive Art der Niederlassung. STRING(1)
PRODPART Spezifische Beteiligung an der Produktion der Niederlassung. STRING(1)
AUXILT Hilfscharakter der Tätigkeit der Niederlassung. STRING(1)
Unternehmenskennung
NOMEN_LONG Name oder Firmenname des Unternehmens. STRING(131)
SIGLE Firmenzeichen oder Logo des Unternehmens. STRING(20)
NOM Geburtsname. STRING(100)
PRENOM Vorname. STRING(30)
CIVILITE Anrede von Einzelunternehmern. STRING(1)
RNA Kennnummer im nationalen Vereinsregister. STRING(10)
Informationen zum Firmensitz des Unternehmens
NICSIEGE Interne Klassifizierungsnummer des Hauptsitzes. STRING(5)
RPEN Region, in der sich der Hauptsitz befindet. STRING(2)
DEPCOMEN Departement oder Stadt, in dem/der sich der Hauptsitz befindet. STRING(5)
ADR_MAIL Wird nicht mehr verwendet.
TELEPHONE Wird nicht mehr verwendet.
Wirtschaftliche Merkmale des Unternehmens
NJ Rechtsform des Unternehmens. STRING(4)
LIBNJ Bezeichnung der Rechtsform. STRING(100)
APEN700 Haupttätigkeit des Unternehmens. STRING(5)
LIBAPEN Bezeichnung der Haupttätigkeit. STRING(65)
DAPEN Gültigkeitsjahr der Haupttätigkeit. STRING(4)
APRM Haupttätigkeit im Handelsregister. STRING(6)
ESS Zugehörigkeit zum Bereich der Sozial- und Solidarwirtschaft. STRING(1)
DATEESS ESS-Datum. STRING(8)
TEFEN Mitarbeiterzahl-Bereich des Unternehmens. STRING(2)
LIBTEFEN Bezeichnung des Bereichs. STRING(23)
EFENCENT Anzahl der Mitarbeiter der Niederlassung, auf 100 gerundet. STRING(6)
DEFEN Gültigkeitsjahr der Mitarbeiterzahl des Unternehmens. STRING(4)
CATEGORIE Unternehmenskategorie. STRING(5)
DCREN Gründungsdatum des Unternehmens. STRING(8)
AMINTREN Jahr und Monat der Aufnahme des Unternehmens in die Datenbank. STRING(6)
MONOACT Monoaktivitätsindex des Unternehmens. STRING(1)
MODEN Art der Haupttätigkeit des Unternehmens. STRING(1)
PRODEN / ESAANN / TCA / ESAAPEN / ESASEC1N–4N Wird nicht mehr verwendet.
Aktualisierungsspezifische Daten
VMAJ Art der Aktualisierung: C Gründung der Niederlassung; E Löschung der Niederlassung; I Änderung Ausgangszustand; F Änderung Endzustand; D Aufnahme in die Verteilung; O Entfernung aus der Verteilung. STRING(1)
VMAJ1 / VMAJ2 / VMAJ3 Wird nicht mehr verwendet.
DATEMAJ Verarbeitungsdatum der Aktualisierung. STRING(19)

Beispiel:

{
  "DQE_status": "FOUND",
  "SIREN": "",
  "NIC": "",
  "L1_NORMALISEE": "ASSOCIATION SPORTIVE DECATHLON",
  "L2_NORMALISEE": "",
  "L3_NORMALISEE": "",
  "L4_NORMALISEE": "4 BD DE MONS",
  "L5_NORMALISEE": "",
  "L6_NORMALISEE": "59650 VILLENEUVE D ASCQ",
  "L7_NORMALISEE": "FRA",
  "L1_DECLAREE": "ASSOCIATION SPORTIVE DECATHLON",
  "L2_DECLAREE": "",
  "L3_DECLAREE": "",
  "L4_DECLAREE": "4 BD DE MONS",
  "L5_DECLAREE": "",
  "L6_DECLAREE": "59650 VILLENEUVE D'ASCQ",
  "L7_DECLAREE": "FRA",
  "NUMVOIE": "4",
  "INDREP": "",
  "TYPVOIE": "BD",
  "LIBVOIE": "DE MONS",
  "CODPOS": "59650",
  "CEDEX": "",
  "RPET": "32",
  "LIBREG": "HAUTS DE FRANCE",
  "DEPET": "59",
  "ARRONET": "5",
  "CTONET": "40",
  "COMET": "009",
  "LIBCOM": "VILLENEUVE D ASCQ",
  "DU": "59",
  "TU": "7",
  "UU": "02",
  "EPCI": "245900410",
  "TCD": "51",
  "ZEMET": "3111",
  "SIEGE": "1",
  "ENSEIGNE": "ASSOCIATION SPORTIVE DECATHLON",
  "IND_PUBLIPO": "",
  "DIFFCOM": "O",
  "AMINTRET": "",
  "NATETAB": "",
  "LIBNATETAB": "",
  "APET700": "",
  "LIBAPET": "",
  "DAPET": "1994",
  "TEFET": "NN",
  "LIBTEFET": "Non-employer",
  "EFETCENT": "",
  "DEFET": "",
  "ORIGINE": "",
  "DCRET": "1994-05-06",
  "DDEBACT": "1994-05-06",
  "ACTIVNAT": "",
  "LIEUACT": "",
  "ACTISURF": "",
  "SAISONAT": "",
  "MODET": "",
  "PRODET": "",
  "PRODPART": "",
  "AUXILT": "",
  "NOMEN_LONG": "ASSOCIATION SPORTIVE DECATHLON",
  "SIGLE": "ASSOCIATION SPORTIVE DECATHLON",
  "NOM": "",
  "PRENOM": "",
  "CIVILITE": "",
  "RNA": "W595011565",
  "NICSIEGE": "",
  "RPEN": "",
  "DEPCOMEN": "",
  "ADR_MAIL": "",
  "NJ": "9220",
  "LIBNJ": "Association déclarée",
  "APEN700": "",
  "LIBAPEN": "",
  "DAPEN": "",
  "APRM": "",
  "ESS": "O",
  "DATEESS": "",
  "TEFEN": "NN",
  "LIBTEFEN": "Non-employer",
  "EFENCENT": "",
  "DEFEN": "",
  "CATEGORIE": "",
  "DCREN": "1994-05-06",
  "AMINTREN": "",
  "MONOACT": "",
  "MODEN": "",
  "PRODEN": "",
  "ESAANN": "",
  "TCA": "",
  "TELEPHONE": "",
  "ESAAPEN": "",
  "ESASEC1N": "",
  "ESASEC2N": "",
  "ESASEC3N": "",
  "ESASEC4N": "",
  "VMAJ": "F",
  "VMAJ1": "",
  "VMAJ2": "",
  "VMAJ3": "",
  "DATEMAJ": "2026-06-25",
  "TVAINTRA": ""
}

Fehler

Komprimierte Form

Fehlertyp Anfrage Antworttyp
Fehlender Parameter Licence https://{SERVER_ADDRESS}/SIRETINFO/?SEARCH_REF=_29613410&Dictionary=Y&Country=FRA 400 Bad Request-Fehler
Leerer Parameter Licence https://{SERVER_ADDRESS}/SIRETINFO/?SEARCH_REF=_29613410&Dictionary=Y&Country=FRA&Licence= 400 Bad Request-Fehler
Fehler bei einem Parameter https://{SERVER_ADDRESS}/SIRETINFO/?SEARCH_REF=_29613410&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE} Leere Antwort

Erweiterte Form

Fehlertyp Anfrage Antworttyp
Fehlender Parameter Licence https://{SERVER_ADDRESS}/SIRETINFO/?Siret={SIRET} 400 Bad Request-Fehler
Leerer Parameter Licence https://{SERVER_ADDRESS}/SIRETINFO/?Siret={SIRET}&Licence= 400 Bad Request-Fehler

Swagger-Dokumentation

Siehe auch

Verknüpfung mit

War dieser Beitrag hilfreich?

0 von 0 fanden dies hilfreich