Schemes

Dieser Leitfaden soll einen klaren und umfassenden Überblick über die verschiedenen Identifikationsschemata (scheme) geben, die Unternehmenskennungen über die B2Brouter API regeln. Er erklärt die Konzepte von TIN, CIN, PIN und taxcode sowie die EAS- und ICD-Schemata und das Feld country, damit jede Integration genau weiß, welche Informationen in welchem Szenario angegeben werden müssen.

Jede offizielle Unternehmens-Identifikationsnummer hat ein entsprechendes Schema, das angibt, welchen Typ von TIN, CIN oder PIN sie repräsentiert.

Sie können jeden Identifikator über den Endpoint GET /schemes prüfen, der die Schemanummer, ob es sich um eine steuerliche Kennung handelt und ob sie in den gültigen Identifikatorlisten für EAS und ICD enthalten ist, zurückgibt.

Beispielantwort des /schemes Endpoints:

{
  "code": "9914",
  "name": "UID",
  "country": "at",
  "eas": true,
  "icd": false,
  "taxcode": true
}

code: Identifikationsnummer des Schemas (in diesem Fall 9914).
name: Offizieller Name des Identifikators (in diesem Fall UID).
country: Land, das dem Identifikator entspricht (at für Österreich).
eas: Gibt an, ob es zur EAS-Liste gehört (in diesem Fall true).
icd: Gibt an, ob es zur ICD-Liste gehört (in diesem Fall false).
taxcode: Gibt an, ob der Identifikator eine TIN (true) oder CIN (false) ist. Hier bedeutet true, dass es sich um eine TIN (Steueridentifikationsnummer) handelt.

Grundlegende Definitionen

TIN (Tax Identifier Number)

Die primäre steuerliche Identifikationsnummer eines Unternehmens, gültig sowohl für nationale als auch internationale Rechnungsstellung. Um zu prüfen, ob ein Identifikator die Steueridentifikationsnummer für ein bestimmtes Land ist, verwenden Sie den B2Brouter Schemes Endpoint.

Für Europa validiert das VIES Portal die Identifikatoren der EU-Mitgliedstaaten. Alle europäischen TINs beginnen mit dem ISO-Ländercode.

Wenn "taxcode": true, wird der Identifikator als TIN betrachtet und kann für steuerliche Rechnungsstellung verwendet werden.

Beispiele:

Deutsche USt-IdNr.:

"tin_scheme": 9930,
"tin_value": "DE123456789"

Spanische NIF:

"tin_scheme": 9920,
"tin_value": "ESB12345678"

Französische Umsatzsteuer-Identifikationsnummer:

"tin_scheme": 9957,
"tin_value": "FR12345678901"

Italienische Partita IVA:

"tin_scheme": 9906,
"tin_value": "IT12345678901"

Hinweis: Wenn der ISO 3166-1 alpha-2 Ländercode nicht bereits in tin_value enthalten ist, wird er beim Speichern einer TIN automatisch vorangestellt.

CIN (Company Identifier Number)

Jede gültige Unternehmenskennung außer der Steueridentifikationsnummer, wie z. B. Kennungen für Untereinheiten, öffentliche Verwaltungen, Bankkonten usw. Um ein Konto oder einen Kontakt ohne Angabe einer TIN zu erstellen, setzen Sie "taxcode": false. Alle Schemas mit taxcode: false werden als CINs behandelt. Ein Unternehmen kann mehrere CINs haben.

Beispiele:

Französische SIRET:

"cin_scheme": 0009,
"cin_value": "1234567890"

Global Location Number (GLN):

"cin_scheme": 0088,
"cin_value": "1234567890"

Schwedische Organisationsnummer:

"cin_scheme": 0007,
"cin_value": "1234567890"

Hinweis: In Schweden müssen Sie für die steuerliche Rechnungsstellung das Boolean-Feld registered_for_empl_tax aktivieren, sobald die F-Steuer genehmigt wurde.

PIN (Peppol Identifier Number)

Wird für die Business Terms „Seller electronic address ID“ (BT-34) und „Buyer electronic address ID“ (BT-49) verwendet, wobei scheme das Identifikationsschema angibt (z. B. KVK mit Code 0088).

Die Unternehmenskennung, die als Peppol-Mailbox-Adresse verwendet wird. Eine PIN kann entweder eine TIN oder eine CIN sein, sofern sie in der EAS-Liste enthalten ist. Sie können PINs über den Schemes Endpoint abrufen. Ein Unternehmen kann mehrere PINs haben und sich über mehrere Rechnungssoftwarelösungen mit Peppol verbinden.

Implementierung:

Peppol Transport: Fügen Sie Ihre PIN in den Transport-Einstellungen hinzu, indem Sie Ihre Peppol-Verbindung aktivieren.
API Referenz - POST create-transport
Kontakte und Rechnungen: Geben Sie eine PIN beim Erstellen des Kontakts oder direkt auf der Rechnung an.
API Referenz - POST create-contact

Beispiel:

"pin_scheme": 0208,
"pin_value": "BCE/KBO/ZDU"

Unterstützte Schemas

EAS (EN 16931 – Electronic Address Scheme)
Offizielle Liste elektronischer Adressidentifikationsschemata, die vom europäischen E-Rechnungsstandard (EN 16931) anerkannt werden. Gepflegt von Digital Europe (Nachfolger von CEF seit Januar 2022) und zweimal jährlich aktualisiert, um neue Schemas oder ISO 6523 ICD-registrierte Codes hinzuzufügen, die für elektronische Adressierung relevant sind. Diese Liste ermöglicht neue Peppol-Identifikatoren.
ICD (ISO 6523 – International Code Designator)
Globales Register von Entity-Identifikationsschemata, gepflegt von ISO. Jede Vergabestelle (z. B. staatliche Register oder Kodierungsdienste) besitzt einen eindeutigen numerischen Code (ICD). Dies bildet die Grundlage für die weltweite eindeutige Organisationsidentifikation, einschließlich Peppol. Viele EAS-Schemas stammen aus diesem Katalog, da nur ISO 6523-Einträge zu EAS befördert werden können.

Beispiele:
- DUNS Nummer (D&B – global):
```
"cin_scheme": "0060",
"cin_value": "123456789"
```
- Französische SIRENE:
```
"cin_scheme": "0002",
"cin_value": "12345678900000"
```
B2Brouter interne Schemas
Für Länder ohne offizielle ISO 6523 ICD- oder EAS-Einträge definiert B2Brouter interne Schemas. Diese numerischen Codes beginnen mit 8XXX und ermöglichen steuerliche oder kommerzielle Identifikatoren, die von keinem globalen Register abgedeckt werden. Beachten Sie, dass diese Codes temporär sein können, bis ein offizielles Schema genehmigt wird.
Universelles Schema (0001)
Ein generisches Fallback-Schema für Fälle, in denen die steuerliche ID eines Unternehmens keinem anerkannten offiziellen Schema (EAS, ISO 6523 ICD oder intern) entspricht. Kann als tin_scheme oder cin_scheme für nationale oder kommerzielle Identifikatoren ohne formale Zuordnung verwendet werden.

Warnung: Vermeiden Sie nach Möglichkeit die Verwendung des Schemas 0001. Es kann zu Validierungs- oder rechtlichen Problemen führen, wenn Behörden offiziell regulierte Codes verlangen. Prüfen Sie immer zuerst, ob ein offizielles Schema existiert.

Beispiele zur API-Verwendung

Peppol Transport erstellen
POST /accounts/{ACCOUNT_ID}/transports

{
  "transport": {
    "code": "peppol",
    "enabled": true,
    "reception": true,
    "pin_scheme": 9934,
    "pin_value": "123456789"
  }
}

Ein Konto mit CIN erstellen
POST /accounts

{
  "name": "Voorbeeld B.V.",
  "cin_scheme": "0106",
  "cin_value": "12345678",
  "country": "nl",
  "address": "Kerkstraat 12",
  "city": "Amsterdam",
  "postalcode": "1017 GM",
  "email": "john.doe@example.com"
}

Directory Lookup nach Schema
GET /directory/{scheme}/{value}

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