Skip to content
B2Brouter Docs B2Brouter Docs B2Brouter Docs
Log in
API reference

An FACe mit importierter Datei senden

Die B2Brouter API ermöglicht es Ihnen, Rechnungen nahtlos an FACe zu senden. Der Prozess umfasst:

  1. Eine Rechnung erstellen: Importieren Sie Ihr Rechnungsdokument oder einen JSON-Payload in B2Brouter.
  2. Empfängerinformationen überprüfen: Stellen Sie sicher, dass die Empfängerangaben korrekt und vollständig sind.
  3. Die Rechnung senden: Fahren Sie mit dem Versenden der Rechnung fort.
  4. Das Dokument verfolgen: Überwachen Sie die Nachverfolgbarkeit Ihres gesendeten Dokuments.

Eine Rechnung erstellen

Section titled “Eine Rechnung erstellen”

Um eine Rechnung über unsere API zu erstellen, stehen Ihnen folgende Optionen zur Verfügung:

  • Option 1: JSON-Payload — Verwenden Sie einen JSON-Payload, um Ihre ausgestellte Rechnung zu erstellen.

  • Option 2: Import eines unterstützten Dateiformats

Terminal window
curl --request POST \
  --url https://api-staging.b2brouter.net/accounts/{ACCOUNT_ID}/invoices/import \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/octet-stream' \
  --data '@invoice.xml'

Nach dem Import Ihres Rechnungsdokuments generiert B2Brouter ein Rechnungsobjekt, sofern das Dokument die Standard-Validierungskriterien erfüllt.

Empfängerinformationen überprüfen

Section titled “Empfängerinformationen überprüfen”

Wenn Sie zum ersten Mal ein Dokument an den Empfänger senden, wird automatisch ein Kontakt anhand der in der Rechnung enthaltenen Daten erstellt. Sie können auch prüfen, ob der Empfänger in unserem öffentlichen Verzeichnis vorhanden ist:

Terminal window
curl --request GET \
  --url https://api-staging.b2brouter.net/directory/es/9920/ESP2800500G \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/json'

Beispielantwort:

{
    "name": "Ayuntamiento de Alcalá de Henares",
    "tin_scheme": "9920",
    "tin_value": "ESP2800500G",
    "invoice": {
        "transport_type_code": "es.face",
        "document_type_code": "xml.facturae.3.2"
    },
    "routing_codes": {
        "cin1_scheme": "8014",
        "cin2_scheme": "8014",
        "cin3_scheme": "8014",
        "cin1_value": "L01280053",
        "cin2_value": "L01280053",
        "cin3_value": "L01280053"
    }
}

Sie können auch Ihre Kontaktinformationen bearbeiten, um DIR3-Codes hinzuzufügen:

Terminal window
curl --request PUT \
  --url https://api-staging.b2brouter.net/contacts/{CONTACT_ID} \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/json' \
  --data '{
    "contact": {
        "transport_type_code": "es.face",
        "document_type_code": "xml.facturae.3.2.2",
        "cin1_scheme": "8014",
        "cin1_value": "{DIR3_ACCOUNTING}",
        "cin2_scheme": "8014",
        "cin2_value": "{DIR3_MANAGING}",
        "cin3_scheme": "8014",
        "cin3_value": "{DIR3_PROCESSING}"
    }
  }'

Weitere Informationen finden Sie in unseren Codelisten:

Ihre Rechnung senden

Section titled “Ihre Rechnung senden”
Terminal window
curl --request POST \
  --url https://api-staging.b2brouter.net/invoices/send_invoice/{INVOICE_ID} \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/json'

Wenn das importierte Dokument den Transportanforderungen des Empfängers entspricht (z. B. ein facturaE ist) und unverändert bleibt, senden wir die Originaldatei direkt. Andernfalls generieren wir ein Dokument, das dem erforderlichen Dokumenttyp entspricht. Vor der Übermittlung an FACe prüfen wir außerdem, ob die XML-Datei signiert ist; falls nicht, signieren wir sie.

Ihre Rechnung verfolgen

Section titled “Ihre Rechnung verfolgen”

B2Brouter bietet zwei Möglichkeiten zur Überwachung des Status Ihres Dokuments: