Salta al contingut
B2Brouter Docs B2Brouter Docs B2Brouter Docs
Log in
API reference

v2026-03-02

Changelog

Aquesta versió implementa canvis incompatibles. Cada canvi incompatible està marcat amb l’etiqueta Breaking.

Afegit

Section titled “Afegit”
  • Nou camp invoice_lines[].base_quantity (decimal, per defecte 1) per suportar la Quantitat Base de Preu (BT-149), on price representa el preu per base_quantity unitats.
  • Nous camps tax_currency_code i tax_amount_in_tax_currency: tax_currency_code (cadena ISO 4217) i tax_amount_in_tax_currency (decimal) per al suport de doble moneda de la Moneda de Comptabilitat Fiscal (BT-6 i BT-111).
  • Nou camp bank_accounts[].is_default (booleà) per marcar un compte bancari per empresa com el predeterminat.
  • Nova capçalera de resposta X-B2B-API-Request-Id retornada a cada petició d’API registrada per a la traçabilitat de les peticions.
  • Nous camps de només lectura en informes fiscals: annulled_by_id i corrected_by_id (enter, nul·lable) per referenciar l’informe fiscal que ha anul·lat o corregit l’actual.
  • Nous camps específics de KSeF en informes fiscals: payment_account_name (cadena), purchase_order_reference (cadena), sales_order_reference (cadena) i tax_inclusive_amount_before_allowances_and_charges (decimal).
  • Nous camps en línies d’informes fiscals: tax_report_lines[].item_seller_identifier i tax_report_lines[].item_standard_identifier (cadena) en línies d’informes fiscals de TicketBAI i KSeF per a identificadors d’articles assignats pel venedor i estàndards.
  • Nou endpoint DELETE /attachments/:id per eliminar un adjunt.
  • Nous codis d’unitat per a invoice_lines[].unit:
    • 37 — Tones (UN/ECE: TNE)
    • 38 — Megawatt-hora (UN/ECE: MWH)
    • 39 — Mesos (UN/ECE: MON)
    • 40 — Anys (UN/ECE: ANN)
    • 41 — Unitat/peça (UN/ECE: C62)
  • Configuració d’informes fiscals: els endpoints PUT i DELETE /accounts/{account}/tax_report_settings/{code} ara suporten DgfipTaxReportSetting com a variant de resposta addicional per a la configuració de l’e-reporting francès.

Modificat

Section titled “Modificat”

🚨 Breaking

  • Canvi de tipus dels camps d’esquema (número → cadena): tin_scheme, cin_scheme, pin_scheme han canviat de número a cadena de 4 caràcters amb zeros a l’esquerra (p. ex., 7 → "0007") a tots els endpoints (comptes, contactes, factures, transports). Quan el valor de l’esquema és null, el camp també es retorna com a null.
  • type_document renomenat a type_code per als codis de tipus de document en tots els formats (Peppol, CII, KSeF, FatturaPA).
  • correction_method restringit a enum: anteriorment acceptava qualsevol cadena, ara valida contra els valors permesos: 01 (substitució completa), 02 (diferències), 03 (acord global en el període), 04 (autoritzat per l’Agència Tributària). Les factures amb valors no vàlids rebran un error de validació.
  • Els endpoints POST retornen 201 Created: POST /accounts/{account}/invoices, POST /accounts/{account}/invoices/import, POST /accounts/{account}/tax_reports, POST /accounts/{account}/tax_reports/import i POST /accounts/{account}/contacts ara retornen 201 Created en lloc de 200 OK.
  • Resposta asíncrona de consulta al directori: ara retorna 202 Accepted amb una URL de polling quan es troba un participant al SML de Peppol però encara no al directori local.
  • contact.is_provider ara té el valor per defecte true en crear contactes via API.
  • contact_id ignorat per a IssuedSimplifiedInvoice: les factures simplificades sempre utilitzen els camps de contacte en línia.
  • El camp payments_on_account ara és visible a GET /invoices/{invoice}.

Obsolet

Section titled “Obsolet”

Cap funcionalitat s’ha marcat com a obsoleta en aquesta versió.

Eliminat

Section titled “Eliminat”

🚨 Breaking

  • Paràmetre de consulta taxcode: eliminat de GET /accounts/{account}/invoices. Utilitza el paràmetre query amb tin_value=<valor> en el seu lloc.

  • Camps obsolets de descompte/recàrrec de factura eliminats: els camps següents van ser marcats com a obsolets a la v2025-10-13 en favor de allowance_charges_attributes i han estat eliminats. Tot i estar eliminats de la resposta, l’API accepta aquests camps a l’entrada sense retornar error, però els ignora.

    Camp eliminatMigració a allowance_charges_attributes
    discount_amount[{allowance_charge_indicator: "allowance", amount: X}]
    discount_percent[{allowance_charge_indicator: "allowance", percentage: X}]
    discount_text[{allowance_charge_indicator: "allowance", description: "..."}]
    charge_amount[{allowance_charge_indicator: "charge", amount: X}]
    charge_percent[{allowance_charge_indicator: "charge", percentage: X}]
    charge_reason[{allowance_charge_indicator: "charge", description: "..."}]
    charge_is_reimbursable_expense[{allowance_charge_indicator: "charge", is_reimbursable_expense: true}]
    apply_taxes_to_chargeUtilitza apply_taxes dins de allowance_charges_attributes

Corregit

Section titled “Corregit”
  • Les factures Facturae rebudes amb correction_method: "01" ara retornen el valor original en lloc de retornar incorrectament "02".
  • Les factures poloneses en EUR amb dades de moneda fiscal BT-6/BT-111 ara deriven correctament el tipus de canvi per als informes KSeF.

Seguretat

Section titled “Seguretat”

No s’han documentat canvis específics de seguretat en aquesta versió.