Zahlungsmethoden

Dieser Leitfaden beschreibt die internen Zahlungsmethoden-Codes in B2Brouter sowie deren entsprechende Kodierung in UBL, Facturae und FatturaPA.

Entsprechungen:

• Internes B2Brouter-Feld: payment_method
• Facturae-Feld: PaymentMeans (Element unter /facturae:Facturae/Invoices/Invoice/PaymentDetails/Installment/PaymentMeans)
• UBL-Feld: cbc:PaymentMeansCode (Element unter /Invoice/cac:PaymentMeans/cbc:PaymentMeansCode)
• FatturaPA-Feld: ModalitaPagamento (Element unter /p:FatturaElettronica/FatturaElettronicaBody/DatiPagamento/DettaglioPagamento/ModalitaPagamento)
• CII-Feld: TypeCode (Element unter rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ram:SpecifiedTradeSettlementPaymentMeans/ram:TypeCode)
• Business Terms ID: BT-81

1. Tabelle der Zahlungscodes

Methode	Interne Referenz	UBL	Facturae	FatturaPA	Beschreibung
CASH	1	10	01	MP01	Zahlung mit Bargeld (einschließlich Banknoten und Münzen im Umlauf), einschließlich Einzahlungen auf Girokonten.
DEBIT	2	49	02	MP19	Lastschrift (Der Betrag wird oder wurde direkt vom Bankkonto des Kunden abgebucht).
HOLD	3	8	03	MP12	Gibt an, dass die Bank die Zahlung zur Abholung durch den Begünstigten oder gemäß anderer Anweisungen zurückhalten soll.
TRANSFER	4	30	04	MP05	Banküberweisung (Der Betrag wird oder wurde direkt dem Bankkonto des Lieferanten gutgeschrieben).
AWARDING	7	ZZZ	07		Zahlung durch Abtretung oder Zuschlag
PAGARE N O	10	60	10	MP06	Nicht übertragbarer Schuldschein. Zahlung durch ein bedingungsloses schriftliches Zahlungsversprechen, das von einer Person an eine andere gerichtet und vom Aussteller unterzeichnet ist, zahlbar auf Verlangen oder zu einem festen zukünftigen Zeitpunkt.
CHEQUE	11	20	11	MP02	Zahlung mittels eines vorgedruckten Formulars, mit dem ein Kontoinhaber (eine Bank oder Bausparkasse) angewiesen wird, einen bestimmten Betrag an einen benannten Empfänger zu zahlen.
REPOSITION	12	ZZZ	12	MP22	Erstattung über offenes Konto.
SPECIAL/OTHER	13	ZZZ	13	MP22	Definiert jede andere Zahlungsmethode; verwenden Sie payment_method_text für benutzerdefinierte Beschreibungen.
COMPENSATION	14	97	14	MP22	Beträge, die sich zwei Partner gegenseitig schulden und zur Vermeidung unnötiger Zahlungen verrechnet werden.
PLUSGIRO	15	50	15	MP18	Standardisierte schwedische Zahlungsmethode über das Postgiro-System.
CHEQUE B	17	23	17	MP03	Zahlung mittels eines vorgedruckten Formulars, das von einem Finanzinstitut ausgefüllt wurde und einen Kontoinhaber anweist, einen bestimmten Betrag an einen benannten Empfänger zu zahlen.
BANK CARD	19	48	19	MP08	Zahlung mittels einer von einer Bank oder einem anderen Finanzinstitut ausgestellten Karte.
DEBIT TRANSFER	31	31	04	MP13	Zahlung durch Belastungsbuchung von Geldern von einem Konto auf ein anderes.
CREDIT CARD	54	54	19	MP08	Zahlung mittels Kreditkarte
BANKGIRO	56	56	04	MP03	Zahlungsmethode über das Bankgiro-Netzwerk.
TRANSFER SEPA	58	58	04	MP05	SEPA-Überweisung (Die Gelder werden dem Bankkonto des Lieferanten gutgeschrieben).
DEBIT SEPA	59	59	02	MP19	SEPA-Lastschrift (Die Gelder werden vom Bankkonto des Kunden abgebucht; ein Mandat kann erforderlich sein).
GIRO	101	ZZZ	13		Giro
PAY NOW	102	ZZZ	13		Sofortige Zahlung (Pay Now)

1.1 Zusätzlich erforderliche Felder (API)

Abhängig von der verwendeten payment_method müssen möglicherweise zusätzliche Felder angegeben werden, damit die Rechnung korrekt erstellt/exportiert werden kann.
Dieser Abschnitt konzentriert sich auf allgemeine Anforderungen für Bank- und Zahlungsdaten; einige E-Rechnungsformate können dennoch bestimmte Zahlungscodes einschränken.

Allgemeine Anforderungen

• Bankkonto des Kunden (Zahler): DEBIT (2), DEBIT SEPA (59).
  Erforderlich in bestimmten Formaten/Workflows, jedoch nicht allgemein. Zum Beispiel erfordert XRechnung \common_xrechnung_v23 invoice.contact_iban, XRechnung v3 zusätzlich mandate_reference_identifier, und Facturae verlangt das Bankkonto des Kunden (contact.bank_account_number oder ein gültiges invoice.contact_iban). Dies gilt nicht für IssuedSimplifiedInvoice.
• Zahlungsbedingungen: DEBIT (2).
  Geben Sie terms an (darf nicht 0/leer sein).
• Zahlungsfälligkeitsdatum (die meisten Exporte):
  Wenn Sie eine payment_method setzen und terms = "custom" verwenden, müssen Sie due_date angeben (außer bei einigen Transportarten wie PEPPOL und SDI). Bei nicht benutzerdefinierten terms wird due_date automatisch abgeleitet.
• Bankkonto des Unternehmens (Empfänger): TRANSFER (4), TRANSFER SEPA (58), DEBIT TRANSFER (31), PLUSGIRO (15), BANKGIRO (56), AWARDING (7).
  Geben Sie bank_account_id an (oder schließen Sie das Objekt bank_account beim Erstellen/Aktualisieren der Rechnung ein).
• Benutzerdefinierte Beschreibung: SPECIAL/OTHER (13).
  Geben Sie payment_method_text an (wird nur beibehalten, wenn payment_method = 13).
• Alle anderen Zahlungsmethoden erfordern keine zusätzlichen Bank-/Zahlungsfelder.

Sonderfälle (Rechnungstyp)

• IssuedSelfInvoice:
  • DEBIT (2) / DEBIT SEPA (59) erfordern bank_account_id (Firmenbankkonto).
  • Überweisungsähnliche Methoden (TRANSFER (4), TRANSFER SEPA (58), DEBIT TRANSFER (31), PLUSGIRO (15), BANKGIRO (56), AWARDING (7)) erfordern invoice.contact_iban (einige reine PDF-Workflows benötigen dies möglicherweise nicht, die meisten E-Rechnungsexporte jedoch schon).
• IssuedSimplifiedInvoice: DEBIT (2) / DEBIT SEPA (59) erfordern kein invoice.contact_iban.

Sonderfälle (Exportformat)

• Facturae:
  • Wenn Sie eine payment_method setzen und die Rechnung keine Gutschrift ist, müssen Sie entweder gültige terms (nicht benutzerdefiniert) oder due_date (bei terms = "custom") angeben.
  • Wenn die Rechnung DEBIT/DEBIT SEPA verwendet, muss das Bankkonto des Kunden verfügbar sein (das bank_account_number des Kontakts oder ein gültiges invoice.contact_iban).
  • Wenn die Rechnung TRANSFER (einschließlich überweisungsähnlicher Methoden) verwendet, muss das Firmenbankkonto verfügbar sein (über bank_account_id / bank_account) und eine gültige Kontonummer/IBAN enthalten.
• Svefaktura: Lastschriftzahlungen (DEBIT/DEBIT SEPA) werden nicht unterstützt.
• FatturaPA: COMPENSATION (14) ist nicht zulässig.
• XRechnung (UBL/CII):
  • Wenn die Rechnung DEBIT/DEBIT SEPA verwendet, müssen Sie bank_assigned_creditor_reference und invoice.contact_iban angeben.
  • Für v3-Profile ist zusätzlich mandate_reference_identifier erforderlich.

2. Verwendung der Endpunkte

Nachfolgend zeigen wir, wie die wichtigsten Endpunkte verwendet werden, um Zahlungen und Bankkonten zu verwalten, die mit Kontakten und Rechnungen verknüpft sind.

2.1. Bankkonten erstellen

Beim Erstellen eines Bankkontos müssen Sie den type des Kontos angeben, um festzulegen, welche Felder verwendet werden:

• number: Verwenden Sie nur das Feld number.
  • number: Bankkontonummer.
• iban: Verwenden Sie iban und bic.
  • iban: Internationale Bankkontonummer.
  • bic: SWIFT-Code der Bank.

Beispielanfrage:

curl --request POST \
  --url https://api-staging.b2brouter.net/accounts/{ACCOUNT_ID}/bank_accounts \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'accept: application/json' \
  --header 'content-type: application/json'
'

sufix ist das Suffix, das für die Gläubigerkennung in SEPA-Dateien verwendet wird.

Beispielantwort:

{
  "bank_account": {
    "type": "number",
    "id": 3296,
    "name": "Ejemplo S.L.",
    "number": "ES9121000418450200051332",
    "sufix": 123,
    "country": "es",
    "created_at": "2025-07-14T11:37:02.000Z",
    "updated_at": "2025-07-14T11:37:02.000Z"
  }
}

Speichern Sie bank_account.id, um dieses Konto in zukünftigen Anfragen zu referenzieren.

Bankkonto API-Referenz

2.2. Kontakt erstellen

Die Konfiguration der Zahlungsdetails für Rechnungen, die an einen Kontakt gesendet werden, ist nützlich, um diese Informationen nicht jedes Mal erneut verwalten zu müssen, wenn ein Dokument gesendet werden soll.

Beispielanfrage:

curl --request POST \
  --url https://api-staging.b2brouter.net/accounts/{ACCOUNT_ID}/contacts \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'accept: application/json' \
  --header 'content-type: application/json'
'

Kontakt API-Referenz

2.3. Rechnung erstellen

Sie müssen keine Zahlungsfelder erneut angeben, die bereits im Kontakt definiert wurden, es sei denn, Sie möchten sie überschreiben. Um API-Aufrufe zu minimieren, sollten alle erforderlichen Zahlungsdetails – wie payment_method, bank_account_id, payment_terms usw. – direkt in der Anfrage zum Erstellen der Rechnung angegeben werden, anstatt Kontakte oder Bankkonten vorher anzulegen.

Beispielanfrage:

curl --request POST \
  --url https://api-staging.b2brouter.net/accounts/{ACCOUNT_ID}/invoices \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'content-type: application/json'
    '

Und wenn Sie keine bank_account_id angegeben haben, können Sie jederzeit das Objekt bank_account einfügen:

    {"invoice": {
        ...
        "bank_account": {
            "type": "number",
            "number": "ES9121000418450200051332"
    },
        ...
    }}
    '