Overview
Know what changed in each version.
B2Brouter uses date-based versioning. Pin a version in every request with X-B2B-API-Version and upgrade at your own pace — changes never apply automatically.
Key changes by version
Section titled “Key changes by version”v2026-04-20 (Latest)
Section titled “v2026-04-20 (Latest)”| Change | Area | Type | |
|---|---|---|---|
Peppol transport: new sml_status and peppol_directory_status fields. | Peppol transport | Changed | Breaking |
Validate tin_value and tin_scheme against parent contact. | Contacts | Changed | Breaking |
Credit notes now use invoice_references instead of amend fields. | Invoices | Changed | Breaking |
payment_method_info removed from invoice responses. | Invoices | Removed | Breaking |
| New TIN verification endpoint — verify tax IDs against AEAT asynchronously. | Verification | Added | |
New routing_codes field on accounts for additional identifiers. | Accounts | Added |
v2026-03-02
Section titled “v2026-03-02”| Change | Area | Type | |
|---|---|---|---|
Scheme fields (tin_scheme, cin_scheme) changed from number to zero-padded string — e.g. 7 → "0007". | Contacts, Invoices | Changed | Breaking |
type_document renamed to type_code across all formats. | Invoices | Changed | Breaking |
POST endpoints now return 201 Created instead of 200 OK. | API | Changed | Breaking |
correction_method now validates against an enum of allowed values. | Invoices | Changed | Breaking |
Deprecated discount_amount and charge_amountfields removed. | Invoices | Removed | Breaking |
New X-B2B-API-Request-Id response header for end-to-end request tracing. | API | Added |
v2025-10-13
Section titled “v2025-10-13”| Change | Area | Type | |
|---|---|---|---|
New domain api.b2brouter.net — old app.b2brouter.net no longer valid. | Infrastructure | Changed | Breaking |
/projects renamed to /accounts, /clients renamed to /contacts. | Resources | Changed | Breaking |
Tax codes split into tin_scheme and tin_value structured fields. | Contacts | Changed | Breaking |
| All API responses now default to English. | API | Changed | Breaking |
PUT, DELETE, and POST operations now return complete resource representations instead of 204 No Content | API | Changed | Breaking |
cin*_value nested under routing_codes object | API | Changed | Breaking |
| XML support removed — all responses are now JSON only. | API | Removed | Breaking |
| Deprecated Tax Reports API removed — new RESTful Tax Reports API is now the only option. | Tax Reports | Removed | Breaking |