B2B API — Unternehmen suchen (Classic)

Support DQE
Support DQE
  • Aktualisiert

Verwenden Sie diesen Endpunkt, um nach Unternehmen zu suchen und eine Liste passender Ergebnisse zurückzugeben.

Verwandte B2B Classic API-Dokumentation:

GET-Anfrage

Der Endpunkt RECSIRET kann anhand von Firmenname, Firmenname und Postleitzahl oder Postadresse durchsucht werden.

Nur Firmenname

Endpunkt

https://{SERVER_ADDRESS}/RECSIRET/?CompanyName={COMPANY_NAME}&Dictionary=Y&Country={COUNTRY_CODE}&Licence={LICENCE_CODE}&Filter={FILTER}&NbMax={NB_MAX}
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
CompanyName {COMPANY_NAME} Firmenname oder Teil des Firmennamens. Pflicht
Country {COUNTRY_CODE} ISO-3-Buchstaben-Ländercode. Pflicht
Dictionary Y Aktiviert die wörterbuchbasierte Unternehmenssuche. Pflicht
Filter {FILTER} Filter für den Unternehmensstatus. Mehrere Werte können durch Kommas getrennt werden. Optional. Standardwert: 1.
NbMax {NB_MAX} Maximale Anzahl der zurückzugebenden Ergebnisse. Optional. Standardwert: 10.
NAF25 {NAF25} Ruft den neuen Wert des Sic-Codes in Frankreich ab oder nicht: True / False Optional. Standardwert: False

Firmenname und Postleitzahl

Endpunkt

https://{SERVER_ADDRESS}/RECSIRET/?ZIP_Code={POSTAL_CODE}&CompanyName={COMPANY_NAME}&Dictionary=Y&Country={COUNTRY_CODE}&Licence={LICENCE_CODE}&Filter={FILTER}&NbMax={NB_MAX}
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
ZIP_Code {POSTAL_CODE} Postleitzahl oder Departement-Code. Pflicht
CompanyName {COMPANY_NAME} Firmenname. Pflicht
Country {COUNTRY_CODE} ISO-3-Buchstaben-Ländercode. Pflicht
Dictionary Y Aktiviert die wörterbuchbasierte Unternehmenssuche. Pflicht
Filter {FILTER} Filter für den Unternehmensstatus. Mehrere Werte können durch Kommas getrennt werden. Optional. Standardwert: 1.
NbMax {NB_MAX} Maximale Anzahl der zurückzugebenden Ergebnisse. Optional. Standardwert: 10.
NAF25 {NAF25} Ruft den neuen Wert des Sic-Codes in Frankreich ab oder nicht: True / False Optional. Standardwert: False

Nur Postadresse

Endpunkt

https://{SERVER_ADDRESS}/RECSIRET/?Address={ADDRESS}&CP={POSTAL_CODE}&City={CITY}&Country={COUNTRY_CODE}&Dictionary=Y&Licence={LICENCE_CODE}&Filter={FILTER}&NbMax={NB_MAX}
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
Address {ADDRESS} Straßentyp und Straßenname der zu prüfenden Geschäftsadresse. Pflicht
CP {POSTAL_CODE} Postleitzahl der zu prüfenden Geschäftsadresse. Pflicht
City {CITY} Stadtname der zu prüfenden Geschäftsadresse. Pflicht
Country {COUNTRY_CODE} ISO-3-Buchstaben-Ländercode. Pflicht
Dictionary Y Aktiviert die wörterbuchbasierte Unternehmenssuche. Pflicht
Filter {FILTER} Filter für den Unternehmensstatus. Mehrere Werte können durch Kommas getrennt werden. Optional. Standardwert: 1.
NbMax {NB_MAX} Maximale Anzahl der zurückzugebenden Ergebnisse. Optional. Standardwert: 10.
NAF25 {NAF25} Ruft den neuen Wert des Sic-Codes in Frankreich ab oder nicht: True / False Optional. Standardwert: False

Filterwerte

Wert Beschreibung
1 Geöffnete, veröffentlichungsfähige Unternehmen.
2 Geschlossene, veröffentlichungsfähige Unternehmen.
3 Geschlossene, veröffentlichungsfähige Altunternehmen, die älter als 3 Jahre sind.
4 Nicht veröffentlichungsfähige Unternehmen.
5 RNA-Einträge.

POST-Anfrage

Endpunkt

https://{SERVER_ADDRESS}/RECSIRET/

Fügen Sie die folgenden Parameter im Anfragetext mittels x-www-form-urlencoded hinzu.

Nur Firmenname

Parameter Wert Beschreibung Pflicht/Optional
Licence {LICENCE_CODE} Ihrem Konto zugewiesener Lizenzcode. Pflicht
CompanyName {COMPANY_NAME} Firmenname oder Teil des Firmennamens. Pflicht
Country {COUNTRY_CODE} ISO-3-Buchstaben-Ländercode. Pflicht
Dictionary Y Aktiviert die wörterbuchbasierte Unternehmenssuche. Pflicht
Filter {FILTER} Filter für den Unternehmensstatus. Mehrere Werte können durch Kommas getrennt werden. Optional. Standardwert: 1.
NbMax {NB_MAX} Maximale Anzahl der zurückzugebenden Ergebnisse. Optional. Standardwert: 10.
NAF25 {NAF25} Ruft den neuen Wert des Sic-Codes in Frankreich ab oder nicht: True / False Optional. Standardwert: False

Firmenname und Postleitzahl

Parameter Wert Beschreibung Pflicht/Optional
Licence {LICENCE_CODE} Ihrem Konto zugewiesener Lizenzcode. Pflicht
ZIP_Code {POSTAL_CODE} Postleitzahl oder Departement-Code. Pflicht
CompanyName {COMPANY_NAME} Firmenname. Pflicht
Country {COUNTRY_CODE} ISO-3-Buchstaben-Ländercode. Pflicht
Dictionary Y Aktiviert die wörterbuchbasierte Unternehmenssuche. Pflicht
Filter {FILTER} Filter für den Unternehmensstatus. Mehrere Werte können durch Kommas getrennt werden. Optional. Standardwert: 1.
NbMax {NB_MAX} Maximale Anzahl der zurückzugebenden Ergebnisse. Optional. Standardwert: 10.
NAF25 {NAF25} Ruft den neuen Wert des Sic-Codes in Frankreich ab oder nicht: True / False Optional. Standardwert: False

Nur Postadresse

Parameter Wert Beschreibung Pflicht/Optional
Licence {LICENCE_CODE} Ihrem Konto zugewiesener Lizenzcode. Pflicht
Address {ADDRESS} Straßentyp und Straßenname der zu prüfenden Geschäftsadresse. Pflicht
CP {POSTAL_CODE} Postleitzahl der zu prüfenden Geschäftsadresse. Pflicht
City {CITY} Stadtname der zu prüfenden Geschäftsadresse. Pflicht
Country {COUNTRY_CODE} ISO-3-Buchstaben-Ländercode. Pflicht
Dictionary Y Aktiviert die wörterbuchbasierte Unternehmenssuche. Pflicht
Filter {FILTER} Filter für den Unternehmensstatus. Mehrere Werte können durch Kommas getrennt werden. Optional. Standardwert: 1.
NbMax {NB_MAX} Maximale Anzahl der zurückzugebenden Ergebnisse. Optional. Standardwert: 10.
NAF25 {NAF25} Ruft den neuen Wert des Sic-Codes in Frankreich ab oder nicht: True / False Optional. Standardwert: False

Filterwerte

Wert Beschreibung
1 Geöffnete, veröffentlichungsfähige Unternehmen.
2 Geschlossene, veröffentlichungsfähige Unternehmen.
3 Geschlossene, veröffentlichungsfähige Altunternehmen, die älter als 3 Jahre sind.
4 Nicht veröffentlichungsfähige Unternehmen.
5 RNA-Einträge.

Antwort

Erfolg

Die JSON-Antwort ist ein Dictionary, dessen Schlüssel DATA1, DATA2 usw. lauten. Jeder Wert ist ein Dictionary mit den Daten des Unternehmens. Es enthält den Schlüssel SEARCH_REF, der zum Abrufen vollständiger Unternehmensdetails über SIRETINFO benötigt wird.

Schlüssel Wert Frankreich International
SEARCH_REF Suchreferenz, die als Eingabe für SIRETINFO verwendet wird. STRING STRING
CompanyCName Ergänzender Name des Unternehmens (oder Handelsname). STRING(50) STRING(255)
LegalStructureLabel Rechtsform des Unternehmens (Bezeichnung). 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 Kann den zweiten Teil des CompanyName enthalten, wenn der Name zu lang ist. STRING(38) STRING(50)
Locality Stadt des Unternehmens. 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. Siehe StaffCount-Werte unten. STRING STRING
CompanySIC NAF-Code des Unternehmens. STRING(5) STRING
LegalStructureCode Rechtsform des Unternehmens (Code). STRING(4) STRING(4)
IntraNumber Innergemeinschaftliche USt-IdNr.
Dieses Feld ist leer, wenn das Unternehmen nicht umsatzsteuerpflichtig ist.		 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)
Country ISO-3-Buchstaben-Ländercode. STRING(3) STRING(3)

StaffCount-Werte:

StaffCount-Wert
Not declared
Non-employer
0
1-2
3-5
6-9
10-19
20-49
50-99
100-199
200-249
250-499
500-999
1000-1999
2000-4999
5000-9999
10000+

Beispiel:

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

Fehler

Nur Firmenname

Fehlertyp Anfrage Antworttyp
Fehlender Parameter Licence https://{SERVER_ADDRESS}/RECSIRET/?CompanyName={COMPANY_NAME}&Dictionary=Y&Country=FRA 400 Bad Request-Fehler
Leerer Parameter Licence https://{SERVER_ADDRESS}/RECSIRET/?CompanyName={COMPANY_NAME}&Dictionary=Y&Country=FRA&Licence= 400 Bad Request-Fehler
Fehlender oder leerer Parameter CompanyName https://{SERVER_ADDRESS}/RECSIRET/?Dictionary=Y&Country=FRA&Licence={LICENCE_CODE}
https://{SERVER_ADDRESS}/RECSIRET/?CompanyName=&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE} 
{
  "DATA1": {
    "SEARCH_REF": "",
    "CompanyCName": "",
    "IncorporationDate": "",
    "MainCompanyFlag": "",
    "CompanyStatus": "",
    "CompanyName": "",
    "CompanyAddress2": "",
    "CompanyAddress3": "",
    "CompanyNumber": "",
    "CompanyAddress1": "",
    "Locality": "",
    "Phone": "",
    "DissolutionDate": "",
    "CompanySIC": "",
    "LegalStructureCode": "",
    "IntraNumber": "",
    "LegalStructureLabel": "",
    "TurnOver": "",
    "ZIP_Code": "",
    "StaffCount": ""
  }
}
Fehler bei einem Parameter https://{SERVER_ADDRESS}/RECSIRET/?Companyame={COMPANY_NAME}&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE} Gleiche leere Antwort wie oben

Firmenname und Postleitzahl

Fehlertyp Anfrage Antworttyp
Fehlender Parameter Licence https://{SERVER_ADDRESS}/RECSIRET/?ZIP_Code={POSTAL_CODE}&CompanyName={COMPANY_NAME}&Dictionary=Y&Country=FRA Leere Antwort
Leerer Parameter Licence https://{SERVER_ADDRESS}/RECSIRET/?ZIP_Code={POSTAL_CODE}&CompanyName={COMPANY_NAME}&Dictionary=Y&Country=FRA&Licence= Leere Antwort
Fehlender oder leerer Parameter CompanyName https://{SERVER_ADDRESS}/RECSIRET/?ZIP_Code={POSTAL_CODE}&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE}
https://{SERVER_ADDRESS}/RECSIRET/?ZIP_Code={POSTAL_CODE}&CompanyName=&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE} 		Gleiche leere Antwort wie oben

Nur Postadresse

Fehlertyp Anfrage Antworttyp
Fehlender Parameter Licence https://{SERVER_ADDRESS}/RECSIRET/?Address={ADDRESS}&CP={POSTAL_CODE}&City={CITY}&Dictionary=Y&Country=FRA 400 Bad Request-Fehler
Leerer Parameter Licence https://{SERVER_ADDRESS}/RECSIRET/?Address={ADDRESS}&CP={POSTAL_CODE}&City={CITY}&Dictionary=Y&Country=FRA&Licence= 400 Bad Request-Fehler
Fehler bei einem Parameter https://{SERVER_ADDRESS}/RECSIRET/?Address={ADDRESS}&CP={POSTAL_CODE}&City={CITY}&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE} Gleiche leere Antwort wie oben

Swagger-Dokumentation

Siehe auch

Verknüpfung mit

War dieser Beitrag hilfreich?

0 von 0 fanden dies hilfreich