B2Brouter-Verzeichnis

Das B2Brouter-Verzeichnis ist eine kuratierte Liste von Entitäten. Bei den Entitäten handelt es sich überwiegend um Rechnungsempfänger. B2Brouter verwendet dieses Verzeichnis, um einem Kontakt den richtigen Dokumenttyp und Transporttyp zuzuweisen. Die B2Brouter-App verfügt bereits über eine integrierte Verzeichnisfunktion für die Kontakterstellung. Um das Verzeichnis jedoch in Ihrer eigenen Anwendung zu nutzen, müssen Sie diese API verwenden.

Die B2Brouter-Directory-API erlaubt keine Auflistung aller Entitäten. Sie können einen Empfänger nur abfragen, wenn Ihnen bereits dessen Land und Kennung bekannt sind:

Country: Das Land der Entität. Sie können alle verfügbaren Länder und deren Codes über die API hier abrufen.
Scheme: Das EAS (Electronic Address Scheme) der Entität. Um die in B2Brouter verfügbaren Schemes aufzulisten, können Sie die Schemes-API verwenden.
Id: Die Kennung der Entität. Dies kann eine Steueridentifikationsnummer oder eine andere zum jeweiligen Scheme oder Land passende Kennung sein.

Entitätensuche

Um Informationen über die Transportmethode und Dokumenttypen zu erhalten, die eine Entität empfangen kann, führen Sie eine Suche in unserem Verzeichnis durch. Wenn die Entität vorhanden ist, erhalten Sie eine JSON-Antwort mit grundlegenden Entitätsinformationen sowie spezifischen Angaben zum Dokumentenempfang.

Die Antwort enthält einen Schlüssel für jeden Dokumenttyp, wie Rechnung, Bestellung, Lieferschein usw. Jedes Dokument enthält folgende Informationen:

transport_type_code zur Identifizierung des Transporttyps, der am häufigsten verwendet wird, um Dokumente an die Entität zu senden.
document_type_code zur Identifizierung des am besten geeigneten Dokumenttyps für den Versand von Dokumenten.
other_document_type_codes, ein Array weiterer Dokumenttypen, die die Entität empfangen kann.

Für Kunden, die Peppol verwenden, können Sie ebenfalls eine Suche im Verzeichnis durchführen, um alle verfügbaren Peppol-Dokumenttypen aufzulisten, die Ihr Kunde verwendet. Beachten Sie, dass bei der Transportart Peppol die Liste der weiteren Dokumenttyp-Codes Dokumenttypen enthalten kann, die B2Brouter nicht generieren kann. Alle von B2Brouter unterstützten Dokumenttypen finden Sie hier.

Länderspezifische Routing-Codes

Einige öffentliche Einrichtungen mit organisatorischen Einheiten oder Abteilungen können spezielle Routing-Codes verwenden. Wenn Sie eine Rechnung an eine öffentliche Verwaltung senden möchten, müssen Sie möglicherweise diese Codes verwenden.

Verschiedene Länder nutzen unterschiedliche Codes zur Kennzeichnung öffentlicher Einrichtungen und Abteilungen. B2Brouter verwendet die Felder cinX_scheme und cinX_value für Routing-Codes, wobei X eine Zahl zwischen 1 und 5 sein kann. Die Bedeutung eines Wertes hängt vom jeweiligen Scheme ab.

Hinweis: Die Schemes 8xxx sind nicht Teil der EAS-Codeliste. Dieser Bereich ist spezifisch für B2Brouter.

Spanien (DIR3 / DIRe)

Spanische öffentliche Einrichtungen verwenden DIR3 (Scheme 8014) Routing-Codes:

cin1_value: Buchhaltungsstelle (Oficina contable)
cin2_value: Verwaltungsorgan (Órgano gestor)
cin3_value: Bearbeitungseinheit (Unidad tramitadora)
cin4_value: Vorschlagendes Organ (Órgano proponente)

Spanische private Unternehmen verwenden DIRe (Scheme 8015) Routing-Codes:

cin5_value: DIRe-Code (Código DIRe)

Frankreich

Französische Unternehmen oder öffentliche Einrichtungen können den Code service (Scheme 8017) verwenden. Mehr erfahren

cin1_value: Code service

Kroatien

Kroatische Entitäten können den Croatian internal code business unit (cicbu) (Scheme 8016) verwenden.

cin1_value: cicbu

EDIFACT-Routing-Codes

EDIFACT verwendet GLN-Codes (Scheme 0088):

cin1_value: Käufer (Comprador)
cin2_value: Lieferort (Lugar de entrega)
cin3_value: Rechnungsempfänger (Receptor de la factura)
cin4_value: Zahler (Pagador)
cin5_value: Endempfänger (Destinatario final)

Suche im Verzeichnis

Beispielanfrage:

curl --request GET \
  --url https://api-staging.b2brouter.net/directory/es/ESB12345678 \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'accept: application/json'