Mètodes de pagament

Aquesta guia descriu els codis de mètode de pagament interns a B2Brouter i la seva codificació corresponent en UBL, Facturae i FatturaPA.

Equivalències:

• Camp intern de B2Brouter: payment_method
• Camp Facturae: PaymentMeans (element a /facturae:Facturae/Invoices/Invoice/PaymentDetails/Installment/PaymentMeans)
• Camp UBL: cbc:PaymentMeansCode (element a /Invoice/cac:PaymentMeans/cbc:PaymentMeansCode)
• Camp FatturaPA: ModalitaPagamento (element a /p:FatturaElettronica/FatturaElettronicaBody/DatiPagamento/DettaglioPagamento/ModalitaPagamento)
• Camp CII: TypeCode (element a rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ram:SpecifiedTradeSettlementPaymentMeans/ram:TypeCode)
• ID de Business Term: BT-81

1. Taula de codis de pagament

Mètode	Referència interna	UBL	Facturae	FatturaPA	Descripció
CASH	1	10	01	MP01	Pagament en moneda (inclosos bitllets i monedes) en circulació, inclosos els dipòsits en compte corrent.
DEBIT	2	49	02	MP19	Dèbit directe (l’import s’ha de, o s’ha deduït directament del compte bancari del client).
HOLD	3	8	03	MP12	Indica que el banc ha de retenir el pagament per a la seva recollida pel beneficiari o d’altres instruccions.
TRANSFER	4	30	04	MP05	Transferència bancària (l’import s’ha de, o s’ha acreditat directament al compte bancari del proveïdor).
AWARDING	7	ZZZ	07		Pagament per cessió o adjudicació
PAGARE N O	10	60	10	MP06	Pagaré no transferible.
CHEQUE	11	20	11	MP02	Pagament amb xec.
REPOSITION	12	ZZZ	12	MP22	Reemborsament en compte obert.
SPECIAL/OTHER	13	ZZZ	13	MP22	Defineix qualsevol altre mètode de pagament; useu payment_method_text per a descripcions personalitzades.
COMPENSATION	14	97	14	MP22	Imports que dos socis es deuen mútuament per compensar-se i evitar pagaments innecessaris.
PLUSGIRO	15	50	15	MP18	Mètode de pagament suec estàndard que utilitza el sistema de gir postal.
CHEQUE B	17	23	17	MP03	Pagament amb xec de caixa emès per una entitat financera.
BANK CARD	19	48	19	MP08	Pagament amb targeta emesa per un banc o altra entitat financera.
DEBIT TRANSFER	31	31	04	MP13	Pagament per moviment de dèbit de fons d’un compte a un altre.
CREDIT CARD	54	54	19	MP08	Pagament amb targeta de crèdit
BANKGIRO	56	56	04	MP03	Mètode de pagament que utilitza la xarxa bancgiro.
TRANSFER SEPA	58	58	04	MP05	Transferència de crèdit SEPA (els fons s’acrediten al compte bancari del proveïdor).
DEBIT SEPA	59	59	02	MP19	Dèbit directe SEPA (els fons es dedueixen del compte bancari del client; pot ser necessari un mandat).
GIRO	101	ZZZ	13		Giro
PAY NOW	102	ZZZ	13		Pagament immediat (Pay Now)

1.1 Camps addicionals requerits (API)

Depenent del payment_method, pot ser necessari proporcionar camps addicionals perquè la factura es pugui generar/exportar correctament.

Requisits universals

• Compte bancari del client (pagador): DEBIT (2), DEBIT SEPA (59).
• Termes de pagament: DEBIT (2). Proporcioneu terms (no pot ser 0/buit).
• Data de venciment del pagament: si definiu un payment_method i useu terms = "custom", heu de proporcionar due_date.
• Compte bancari de l’empresa (beneficiari): TRANSFER (4), TRANSFER SEPA (58), DEBIT TRANSFER (31), PLUSGIRO (15), BANKGIRO (56), AWARDING (7). Proporcioneu bank_account_id.
• Descripció personalitzada: SPECIAL/OTHER (13). Proporcioneu payment_method_text.

Casos especials (tipus de factura)

• IssuedSelfInvoice: DEBIT (2) / DEBIT SEPA (59) requereixen bank_account_id.
• IssuedSimplifiedInvoice: DEBIT (2) / DEBIT SEPA (59) no requereixen invoice.contact_iban.

Casos especials (format d’exportació)

• Facturae: si definiu un payment_method i la factura no és una nota de crèdit, heu de proporcionar terms vàlid o due_date.
• Svefaktura: els pagaments de dèbit (DEBIT/DEBIT SEPA) no estan admesos.
• FatturaPA: COMPENSATION (14) no està permès.
• XRechnung (UBL/CII): si la factura és DEBIT/DEBIT SEPA, heu de proporcionar bank_assigned_creditor_reference i invoice.contact_iban.

2. Ús dels endpoints

2.1. Crear comptes bancaris

Quan creeu un compte bancari, heu d’especificar el type del compte:

• number: useu només el camp number.
• iban: useu iban i bic.

Exemple de petició:

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'
'

Resposta d’exemple:

{
  "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"
  }
}

Guardeu bank_account.id per referenciar aquest compte en futures peticions.

Referència de l’API de comptes bancaris

2.2. Crear contacte

Exemple de petició:

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'
'

Referència de l’API de contactes

2.3. Crear factura

No cal tornar a especificar cap camp de pagament que ja s’hagi definit al contacte tret que necessiteu substituir-los.

Exemple de petició:

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'
    '

I si no heu proporcionat bank_account_id, sempre podeu incloure l’objecte bank_account:

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