Edita sèries de numeració
Actualitza una sèrie amb PUT /v1/series/{series} i la tool MCP update_series, sota les mateixes guardes fiscals que l’aplicació web.
4 d’octubre de 2026
Una sèrie de numeració ja es pot editar per l’API i per MCP. L’operació nova és
PUT /v1/series/{series} (scope
series:write) i la tool MCP és update_series, amb el mateix contracte.
És una actualització parcial: només canvien els camps que envies.
| Camp | Significat |
|---|---|
name | Nom de la sèrie (1–100 caràcters). |
code | Prefix de la sèrie (1–10 caràcters: lletres, números, - i _). |
counter_reset | never, annual o monthly. monthly exigeix el token {MM} a la màscara. El canvi és prospectiu. |
year_reset | Àlies booleà deprecat de counter_reset; mana counter_reset si arriben els dos. |
number_format | Màscara de numeració, per exemple {code}-{YYYY}-{000}. |
initial_number | Número des del qual comença el comptador (1 o més). |
invoice_kind | Propòsit d’una sèrie de factures: complete, simplified, corrective o simplified_corrective. |
document_type no es pot enviar. La crida respon 200 amb el recurs
Series actualitzat, 404
series_not_found quan la sèrie no és teva i 422 quan una guarda rebutja el
canvi. En aquest cas no es modifica res.
Guardes fiscals
Cada guarda és un 422 business_rule_violation amb el seu propi subcode:
subcode | Regla |
|---|---|
series_code_immutable_with_documents | code només canvia mentre la sèrie no té documents. |
series_format_immutable_with_documents | number_format només canvia fins que s’emet el primer document. |
series_locked_by_verifactu | Quan l’AEAT ha acceptat un registre d’alguna de les seves factures, code, number_format i initial_number queden bloquejats. |
series_initial_number_creates_gap | initial_number no pot obrir un salt després de documents de l’any en curs. |
series_invoice_kind_locked | invoice_kind queda fix amb la primera factura de la sèrie. |
series_default_kind_change | La sèrie predeterminada d’un propòsit no pot canviar de propòsit. |
Un code ja usat per una altra sèrie del mateix tipus de document retorna 422
amb param: code. Un número inicial invàlid (invalid_series_number) o un propòsit
invàlid (series_invoice_kind_invalid) responen parameter_invalid_value, i
counter_reset: monthly amb una màscara sense el token {MM} respon
monthly_requires_month_segmented_format. El codi
series_format_immutable_with_documents és nou al
catàleg d’errors.
Webhooks i la resta d’operacions de sèries
- Canviar només
counter_resettambé emet el webhookseries.updated. PATCHiDELETEsobre/v1/series/{series}continuen responent405series_immutable; la resposta ara portaAllow: GET, PUT. Una sèrie mai no s’elimina: arxiva-la ambPOST /v1/series/{series}/archive.- La descripció de l’operació d’arxivat indica els seus rebutjos com a
422business_rule_violation:cannot_archive_last_default_seriesiseries_already_archived. - Les descripcions del recurs de sèrie i de l’operació de creació indiquen quins camps es poden editar després i fins quan.
Nous endpoints1
| Endpoint | Descripció |
|---|---|
PUT/v1/series/{series} | Actualitzar una sèrie |
Endpoints actualitzats3
| Endpoint | Descripció |
|---|---|
POST/v1/series | Crea una sèrie |
GET/v1/series/{series} | Obtenir una sèrie |
POST/v1/series/{series}/archive | Arxivar una sèrie |