v1.1.0 — recipient and payment_info
Invoice recipient and payment_info become structured objects, and new series get sensible defaults.
ChangelogBreaking
Invoice recipient and payment_info schemas have been refactored to use structured objects with allOf composition. This change normalizes the API and enables future extensibility. Also adds new series defaults endpoints.
What breaks
- PUT /v1/invoices/{invoice_id} schema change —
recipientandpayment_infonow useallOfcomposition referencingRecipientandPaymentInfoschemas. The fields (nif,legal_name,iban,method, etc.) remain available but the schema path changed from inline properties to a $ref. Clients using generated SDKs may need to regenerate. - SDK regeneration recommended — If you use generated clients from the OpenAPI spec, regenerate them to pick up the new schema references. The underlying fields are the same; only the structure (and how the SDK types represent them) has changed.
What else changed
- Structured
recipientandpayment_info— PUT /v1/invoices/{invoice_id} now usesallOfcomposition withPaymentInfoandRecipientschemas. Fields likenif,legal_name,iban,methodare still available via the referenced schemas, but the structure changed from inline to composed. Regenerate your SDK if you use one. - New series defaults endpoints — POST /v1/configuration/series/defaults and GET /v1/configuration/series/defaults-status allow setting and checking per-document-type default series.
- Idempotency-Key header — Now formally documented on POST /v1/customers.
- Invoice email options — All invoice endpoints now return
email_configandsend_automaticallyfields in responses.
Endpoints
- PUT/v1/invoices/{invoice_id}recipient and payment_info now use allOf composition — update your request payload structure
- POST/v1/configuration/series/defaultsSet default series per document type
- GET/v1/configuration/series/defaults-statusCheck which series have defaults configured
Where to go next
v1.2.0 — VeriFactu validation pack
Invalid fiscal combinations now fail at request time with specific `422`s. Adds a public error-code catalog, metadata filters, the RD-ley rates and BIZUM.
v1.0.3 — exemptions and document types
VeriFactu exemptions and document types, plus stricter validation on fiscal fields.