B2B API — Unternehmensinformationen abrufen (REST)

Support DQE
Support DQE
  • Aktualisiert

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

Verwandte Restful B2B API-Dokumentation:

GET-Anfrage

Komprimierte Form

GET https://{SERVER_ADDRESS}/{VERSION}/infosr/?SEARCH_REF={SEARCHREF}&Country={COUNTRY_CODE}&Licence={LICENCE_CODE}&extension={EXTENSION}

Ersetzen Sie die Werte in geschweiften Klammern einfach durch Ihre Informationen.

Parameter Beschreibung Pflicht/Optional
SERVER_ADDRESS Adresse des DQE-Servers, der die Daten verarbeitet. Pflicht
VERSION Version der API. Beispiel: v1 Pflicht
Licence Ihnen als Lizenzcode zugewiesene Nummer. Pflicht
SEARCH_REF Vom Endpunkt Lookup zurückgegebene Suchreferenz. Pflicht
Country ISO-3-Buchstaben-Ländercode. Pflicht
extension Wenn auf all gesetzt, wird die erweiterte Form (vollständiges JSON) zurückgegeben. Optional. Standardwert: 1
NAF25 Ruft den neuen Wert des Sic-Codes in Frankreich ab oder nicht: True / False Optional. Standardwert: False

Erweiterte Form

GET https://{SERVER_ADDRESS}/{VERSION}/infocnum/CompanyNumber={INPUT}/?&Country={COUNTRY_CODE}&Licence={LICENCE_CODE}
Parameter Beschreibung Pflicht/Optional
SERVER_ADDRESS Adresse des DQE-Servers, der die Daten verarbeitet. Pflicht
VERSION Version der API. Beispiel: v1 Pflicht
Licence Ihnen als Lizenzcode zugewiesene Nummer. Pflicht
CompanyNumber SIRET-Nummer des Unternehmens. Pflicht
Country ISO-3-Buchstaben-Ländercode. Pflicht
NAF25 Ruft den neuen Wert des Sic-Codes in Frankreich ab oder nicht: True / False Optional. Standardwert: False

POST-Anfrage

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

Komprimierte Form

POST https://{SERVER_ADDRESS}/{VERSION}/infosr/
Parameter Beschreibung Pflicht/Optional
Licence Ihnen als Lizenzcode zugewiesene Nummer. Pflicht
SEARCH_REF Vom Endpunkt Lookup zurückgegebene Suchreferenz. Pflicht
Country ISO-3-Buchstaben-Ländercode. Pflicht
extension Wenn auf all gesetzt, wird die erweiterte Form (vollständiges JSON) zurückgegeben. Optional. Standardwert: 1
NAF25 Ruft den neuen Wert des Sic-Codes in Frankreich ab oder nicht: True / False Optional. Standardwert: False

Erweiterte Form

POST https://{SERVER_ADDRESS}/{VERSION}/infocnum/{CompanyNumber}/
Parameter Beschreibung Pflicht/Optional
Licence Ihnen als Lizenzcode zugewiesene Nummer. Pflicht
CompanyNumber SIRET-Nummer des Unternehmens. Pflicht
Country ISO-3-Buchstaben-Ländercode. Pflicht
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 Objekt, das zwei Hauptschlüssel enthält:

  • Found: Anzahl der gefundenen Unternehmen.
  • Companies: Liste mit einem oder mehreren Unternehmensobjekten.

Jedes Unternehmensobjekt enthält die folgenden Schlüssel:

Schlüssel Beschreibung Typ / Einschränkungen
L1Standardized Standardisierte Adresszeile 1, häufig der eingetragene Name. String, bis zu 255 Zeichen
MainCompanyFlag Gibt an, ob es sich um den Hauptdatensatz des Unternehmens handelt. 1: ja; 0: nein. String oder Integer
CompanyStatus Administrativer Status des Unternehmens. String oder Integer
Country ISO-3166-1-Alpha-3-Ländercode. String, 3 Zeichen
VatNumber Innergemeinschaftliche USt-IdNr.
Dieses Feld ist leer, wenn das Unternehmen nicht umsatzsteuerpflichtig ist.
String
City Stadt, in der sich das Unternehmen befindet. String, bis zu 100 Zeichen
SearchRef Interne Referenz, die das Ergebnis mit der Suchanfrage verknüpft. String
PhoneNumber Telefonnummer des Unternehmens. String
LegalStructure Rechtsform des Unternehmens. Array von Objekten: { Value, Label }
L2Standardized Standardisierte Adresszeile 2. String
Email E-Mail-Adresse des Unternehmens. String
CompanyNumber Rechtliche Kennungen, wie SIREN und NIC. Array von Objekten: { Type, Value }
CompanyCName Handelsname oder alternativer Firmenname. String
Fax Faxnummer des Unternehmens. String
IncorporationDate Gründungsdatum des Unternehmens. String, YYYY-MM-DD
StaffCount Anzahl der Mitarbeiter oder Mitarbeiterbereich. String
L5Standardized Standardisierte Adresszeile 5. String
DissolutionDate Auflösungsdatum des Unternehmens, sofern zutreffend. String, YYYY-MM-DD
Classification Tätigkeitsklassifizierungscodes, wie NAF. Array von Objekten: { Type, Value, Label }
L4Standardized Standardisierte Straßenadresse. String
CompanyName2 Sekundärer Firmenname. String
TurnOver Gemeldeter Umsatz. String oder Zahl
PosCod Postleitzahl. String, bis zu 10 Zeichen

Beispiel:

{
  "Found": 1,
  "Companies": [
    {
      "L1Standardized": "LAPIED CARRELAGE",
      "MainCompanyFlag": "1",
      "CompanyStatus": "1",
      "Country": "FRA",
      "VatNumber": "FR 62 402284269",
      "City": "MONETEAU",
      "SearchRef": "_24663079",
      "PhoneNumber": "",
      "LegalStructure": [{"Value": "5499", "Label": "Société à responsabilité limitée (sans autre indication)"}],
      "L2Standardized": "",
      "Email": "",
      "CompanyNumber": [{"Type": "Siren", "Value": "402284269"}, {"Type": "Nic", "Value": "00022"}],
      "CompanyCName": "",
      "Fax": "",
      "IncorporationDate": "2000-09-15",
      "StaffCount": "3-5",
      "L5Standardized": "",
      "DissolutionDate": "",
      "Classification": [{"Type": "NAF08", "Value": "4333Z", "Label": ""}],
      "L4Standardized": "4 RUE DES CAILLOTTES",
      "CompanyName2": "",
      "TurnOver": "",
      "PosCod": "89470"
    }
  ]
}

Erweiterte Form

Die JSON-Antwort ist ein Objekt, das zwei Hauptschlüssel enthält:

  • Found: Anzahl der gefundenen Unternehmen.
  • Companies: Liste mit einem oder mehreren Unternehmensobjekten.

Jedes Unternehmensobjekt enthält die folgenden Schlüssel:

Schlüssel Beschreibung Typ / Einschränkungen
Title Titel im Zusammenhang mit dem Unternehmensdatensatz. String
ClassificationEnt Tätigkeitsklassifizierungscodes auf Unternehmensebene. Array von Objekten: { Type, Value, Label }
Department Französischer Departement-Code. String
SocialSolidarityEconomy Indikator für die Klassifizierung der Sozial- und Solidarwirtschaft. String
ActivityType Art der Tätigkeit. String
RangeCodeStaffCountEnt Mitarbeiterzahl-Bereichscode für das Unternehmen. String
PhoneNumber Telefonnummer des Unternehmens. String
CompanyNumber Rechtliche Kennungen, wie SIREN und NIC. Array von Objekten: { Type, Value }
CityId Interne Stadtkennung. String
NatureCode Code, der die Art des Unternehmens darstellt. String
StreetName Straßenname ohne Hausnummer. String
District Bezirk oder Arrondissement. String
FourthActivityEnt Vierte gemeldete Tätigkeit des Unternehmens. String
State Bezeichnung der Region oder des Bundeslands. String
NatureLastUpdate Indikator für die Art der Aktualisierung. String
Acronym Akronym des Unternehmens. String
ThirdActivityEnt Dritte gemeldete Tätigkeit des Unternehmens. String
DistributionDate Datum der Verteilung oder Veröffentlichung. String
EntYearValidity Gültigkeitsjahr für Änderungen der Unternehmensdaten. String
L1Standardized Standardisierte Adresszeile 1. String
StartDateActivities Datum des Tätigkeitsbeginns. String, YYYY-MM-DD
L2Registered Eingetragene Adresszeile 2. String
Distribution Verteilungsindikator. String
L3Standardized Standardisierte Adresszeile 3. String
Seasonality Saisonalitätsindikator. String
EmployementArea Beschäftigungsgebietscode. String
PosCod Postleitzahl. String
Category Unternehmensgrößenkategorie. String
SecondActivityEnt Zweite gemeldete Tätigkeit des Unternehmens. String
FirstName Vorname des Vertreters. String
IndPublipo Werbeindikator. String
MainActivityMethodEnt Methode zur Bestimmung der Haupttätigkeit. String
L6Registered Eingetragene Adresszeile 6. String
L4Standardized Standardisierte Adresszeile 4. String
CharityNumber Kennung der eingetragenen gemeinnützigen Organisation, sofern zutreffend. String
NatureLabel Bezeichnung der Art des Unternehmens. String
ProductiveEnt Indikator für produktives Unternehmen. String
Classification Tätigkeitsklassifizierungscodes. Array von Objekten: { Type, Value, Label }
L4Registered Eingetragene Adresszeile 4. String
City Stadtname. String
StateCode Verwaltungscode der Region oder des Bundeslands. String
ActivityPlace Ort, an dem die Haupttätigkeit ausgeübt wird. String
SpecificProduction Indikator für spezifische Produktion. String
RangeLabelStaffCount Bezeichnung des Mitarbeiterzahl-Bereichs. String
NicHeadquarter NIC-Kennung des Hauptsitzes. String
ClassificationYear Jahr im Zusammenhang mit der Tätigkeitsklassifizierung. String
MainActivityMethod Methode zur Festlegung der Haupttätigkeit. String
TurnOver Umsatz des Unternehmens. String oder Zahl
IncorporationDateEnt Gründungsdatum des Unternehmens. String, YYYY-MM-DD
StaffCountYearEnt Referenzjahr für die Mitarbeiterzahl des Unternehmens. String
UrbanUnitNumber Code der städtischen Einheit. String
StaffCountYear Jahr der Mitarbeiterzahlerhebung. String
L7Standardized Standardisierte Adresszeile 7. String
StaffCountEnt Mitarbeiterzahl des Unternehmens. String
StoreType Klassifizierung des Geschäftstyps. String
IncorporationDate Gründungsdatum des Unternehmens. String, YYYY-MM-DD
RangeLabelStaffCountEnt Bezeichnung des Mitarbeiterzahl-Bereichs für das Unternehmen. String
StreetNum Hausnummer. String
RangeCodeStaffCount Code, der den Mitarbeiterzahl-Bereich darstellt. String
L5Standardized Standardisierte Adresszeile 5. String
MainActivity Code der Haupttätigkeit. String
AuxiliaryActivity Code der Nebentätigkeit. String
PoBox Postfachnummer. String
StreetType Straßentyp. String
VatNumber USt-IdNr. String
Email E-Mail-Adresse des Unternehmens. String
StaffCount Mitarbeiterzahl. String
L3Registered Eingetragene Adresszeile 3. String
L1Registered Eingetragene Adresszeile 1. String
UrbanUnitDpt Departement-Code der städtischen Einheit. String
UrbanUnitRange Bereich der städtischen Einheit. String
L6Standardized Standardisierte Adresszeile 6. String
Origine Ursprung des Unternehmensdatensatzes. String
CompNum Zusätzliche Unternehmensnummer. String
CompanyCName Handelsname des Unternehmens. String
Headquarter Gibt an, ob es sich bei dem Datensatz um den Hauptsitz handelt. String oder Integer
L2Standardized Standardisierte Adresszeile 2. String
Productive Indikator für produktive Niederlassung. String
LastName Nachname des Vertreters. String
NatureLastUpdate1 / NatureLastUpdate2 / NatureLastUpdate3 Zusätzliche Indikatoren für die Art der Aktualisierung. String
DetailCityRange Detaillierter Städtebereichscode. String
MonoActivity Gibt an, ob das Unternehmen nur eine Tätigkeit ausübt. String
L5Registered Eingetragene Adresszeile 5. String
StateCodeEnt Bundesland- oder Regionscode des Unternehmens. String
County Landkreiscode. String
L7Registered Eingetragene Adresszeile 7. String
ClassificationYearEnt Klassifizierungsjahr des Unternehmens. String
LegalStructure Liste der Rechtsformen. Array von Objekten: { Value, Label }
LongCompanyName Vollständiger offizieller Firmenname. String
SocialSolidarityEconomyDate Datum des Eintritts in die Sozial- und Solidarwirtschaft. String
CityIdEn Erweiterte Stadtkennung. String
PublicCompCoopIntercom Code für interkommunale Zusammenarbeit. String
FirstActivityEnt Erste gemeldete Tätigkeit des Unternehmens. String
LastUpdate Datum der letzten Datenaktualisierung. String
MainActivityEnt Code der Haupttätigkeit des Unternehmens. String
DistributionDateEnt Verteilungsdatum für Daten auf Unternehmensebene. String

Beispiel:

{
  "Found": 1,
  "Companies": [
    {
      "Title": "",
      "ClassificationEnt": [{"Type": "NAF08", "Value": "4333Z", "Label": "Travaux de revêtement des sols et des murs"}],
      "Department": "89",
      "SocialSolidarityEconomy": "",
      "ActivityType": "",
      "RangeCodeStaffCountEnt": "02",
      "PhoneNumber": "",
      "CompanyNumber": [{"Type": "Siren", "Value": "402284269"}, {"Type": "Nic", "Value": "00022"}],
      "CityId": "263",
      "NatureCode": "",
      "StreetName": "DES CAILLOTTES",
      "District": "1",
      "FourthActivityEnt": "",
      "State": "BOURGOGNE FRANCHE COMTE",
      "NatureLastUpdate": "F",
      "Acronym": "",
      "ThirdActivityEnt": "",
      "DistributionDate": "",
      "EntYearValidity": "",
      "L1Standardized": "LAPIED CARRELAGE",
      "StartDateActivities": "2000-09-15",
      "L2Registered": "",
      "Distribution": "O",
      "L3Standardized": "",
      "Seasonality": "",
      "EmployementArea": "2612",
      "PosCod": "89470",
      "Category": "PME",
      "SecondActivityEnt": "",
      "FirstName": "",
      "IndPublipo": "",
      "MainActivityMethodEnt": "",
      "L6Registered": "89470 MONETEAU",
      "L4Standardized": "4 RUE DES CAILLOTTES",
      "CharityNumber": "",
      "NatureLabel": "",
      "ProductiveEnt": "",
      "Classification": [{"Type": "NAF08", "Value": "4333Z", "Label": "Travaux de revêtement des sols et des murs"}],
      "L4Registered": "4 RUE DES CAILLOTTES",
      "City": "MONETEAU",
      "StateCode": "27",
      "ActivityPlace": "",
      "SpecificProduction": "",
      "RangeLabelStaffCount": "3-5",
      "NicHeadquarter": "00022",
      "ClassificationYear": "1995",
      "MainActivityMethod": "",
      "TurnOver": "",
      "IncorporationDateEnt": "1995-09-01",
      "StaffCountYearEnt": "2023",
      "UrbanUnitNumber": "02",
      "StaffCountYear": "2023",
      "L7Standardized": "FRA",
      "StaffCountEnt": "",
      "StoreType": "",
      "IncorporationDate": "2000-09-15",
      "RangeLabelStaffCountEnt": "3-5",
      "StreetNum": "4",
      "RangeCodeStaffCount": "02",
      "L5Standardized": "",
      "MainActivity": "4333ZZ",
      "AuxiliaryActivity": "",
      "PoBox": "",
      "StreetType": "RUE",
      "VatNumber": "FR 62 402284269",
      "Email": "",
      "StaffCount": "",
      "L3Registered": "",
      "L1Registered": "LAPIED CARRELAGE",
      "UrbanUnitDpt": "89",
      "UrbanUnitRange": "4",
      "L6Standardized": "89470 MONETEAU",
      "Origine": "",
      "CompNum": "",
      "CompanyCName": "",
      "Headquarter": "1",
      "L2Standardized": "",
      "Productive": "",
      "LastName": "",
      "NatureLastUpdate1": "",
      "NatureLastUpdate3": "",
      "NatureLastUpdate2": "",
      "DetailCityRange": "17",
      "MonoActivity": "",
      "L5Registered": "",
      "StateCodeEnt": "",
      "County": "02",
      "L7Registered": "FRA",
      "ClassificationYearEnt": "",
      "LegalStructure": [{"Value": "5499", "Label": "Société à responsabilité limitée (sans autre indication)"}],
      "LongCompanyName": "LAPIED CARRELAGE",
      "SocialSolidarityEconomyDate": "",
      "CityIdEn": "89263",
      "PublicCompCoopIntercom": "200067114",
      "FirstActivityEnt": "",
      "LastUpdate": "2025-01-22",
      "MainActivityEnt": "",
      "DistributionDateEnt": ""
    }
  ]
}

Fehler

Komprimierte Form

Fehlertyp Anfrage Antworttyp
Fehlender Parameter Licence https://{SERVER_ADDRESS}/{VERSION}/infosr/?SEARCH_REF=_24663079&Country=FRA {"status":400,"message":"Missing parameters","details":"Licence","error":"bad request"}
Leerer Parameter Licence https://{SERVER_ADDRESS}/{VERSION}/infosr/?SEARCH_REF=_24663079&Country=FRA&Licence= {"status":400,"message":"Missing parameters","details":"Licence","error":"bad request"}
Fehler bei einem Parameter https://{SERVER_ADDRESS}/{VERSION}/infosr/?SEARCH_REF=&Country=FRA&Licence={LICENSE} {"status":400,"message":"Missing parameters","details":"SEARCH_REF","error":"bad request"}

Erweiterte Form

Fehlertyp Anfrage Antworttyp
Fehlender Parameter Licence https://{SERVER_ADDRESS}/{VERSION}/infocnum/40228426900022&Country=FRA {"status":400,"message":"Missing parameters","details":"Licence","error":"bad request"}
Leerer Parameter Licence https://{SERVER_ADDRESS}/{VERSION}/infocnum/40228426900022&Country=FRA&Licence= {"status":400,"message":"Missing parameters","details":"Licence","error":"bad request"}

Swagger-Dokumentation

Siehe auch

Verknüpfung mit

War dieser Beitrag hilfreich?

0 von 0 fanden dies hilfreich