Province is only required for addresses in Spain

province is no longer required on an Address outside Spain: a foreign customer or inline recipient without one is accepted. A Spanish address without it still answers 422 PROVINCE_EMPTY.

ChangelogSep 28, 2026Breaking

Many foreign addresses have no province, yet a customer or an inline recipient in France or the United States without province was rejected with 422 VALIDATION_ERROR.

province is now required only when the address is in Spain (country_code ES, or no country). Outside Spain it is optional, and a response carries it only when it was sent.

What else changed

A foreign address without province answers 201 when you create a customer or an invoice with an inline recipient. With a Spanish address it still answers 422 PROVINCE_EMPTY.
Breaking only if you read province from a customer echo: the customer returned as received in customers_validation (bulk create and the import previews) can now come without province when the customer is foreign.
Nothing changes for Spanish addresses, nor for invoices already issued.

Where to go next

Create a customer

More than one NIF on the API plan: a 403 that routes to sales

On the API plan with no agreed price, a second NIF, or going Live with several, answers `403 CONTACT_SALES_REQUIRED` with a link to sales.

Simplified invoice exchanges are recorded with VeriFactu

With VeriFactu, exchanging simplified invoices now issues the full invoice and records it as `F3`. `SIMPLIFIED_EXCHANGE_NOT_RECORDABLE` now only means a simplified invoice issued without VeriFactu.