Claus de règim

La facturació espanyola sobrecarrega la paraula règim. Tres conceptes diferents la comparteixen, viuen en nivells diferents del document i només un és una cosa que enviïs per l'API pública:

Confondre els dos primers és, de bon tros, la causa més habitual d'una factura mal qualificada. Aquesta pàgina els separa.

Quan aplica

Sempre: tota factura emesa declara una qualificació i, per a gairebé tots els règims fiscals, una clau de règim. El que varia és si deixes totes dues a la derivació o les declares explícitament per línia.

Declara una clau de règim explícita quan l'operació pertanyi a un règim especial — béns usats, agències de viatges, criteri de caixa, agricultura, recàrrec d'equivalència, vendes a distància per finestreta única. La derivació per capçalera només produeix el règim general o l'exportació, així que la granularitat del catàleg complet només s'assoleix per línia.

El catàleg tancat

lines[].regime_key accepta exactament aquests disset codis de dos dígits, de la llista ClaveRegimen L8.1 de l'AEAT (BR-INV-031). Qualsevol altre valor respon 422 amb la llista completa a allowed_values.

Els números 12, 13 i 16 hi falten a propòsit — no formen part de la llista, i enviar-los es rebutja igual que qualsevol altre valor fora del catàleg.

Què envia l'API

regime_key és un camp opcional, per línia i additiu de POST /v1/invoices i PUT /v1/invoices/{id}. Una línia que l'omet cau a la clau derivada de la capçalera de la factura:

{
  "lines": [
    { "description": "Reventa de maquinaria de ocasión", "quantity": 1, "unit_price": 100, "regime_key": "03" },
    { "description": "Servicio de instalación", "quantity": 1, "unit_price": 50, "tax_rate": 21 }
  ]
}

La primera línia declara el règim de béns usats; la segona, sense clau, es deriva de la capçalera. Ometre el camp a totes les línies reprodueix exactament el comportament que existia abans d'introduir les claus per línia, huella inclosa — que és la raó per la qual el camp és additiu i no obligatori (BR-INV-031).

Tres dels quatre exemples publicats de creació de factura —b2c, intracomunitario_bienes i con_irpf, al desplegable d'exemples del cos de petició— declaren regime_key: "01" de manera explícita en lloc de recolzar-se en el valor derivat. El quart, b2b_nacional, l'omet i deixa que el règim el posi la capçalera, cosa igualment vàlida. Copia el costum explícit: una clau per línia es documenta a si mateixa i sobreviu a un canvi en la derivació per capçalera.

El règim de capçalera és de només lectura a la v1

L'objecte factura retorna operation_regime, i ni l'operació de creació ni la d'actualització no l'accepten. Tota factura creada per l'API pública neix sota el règim general. La causa d'exempció a nivell de document —exemption_reason a l'objecte factura— és de només lectura pel mateix motiu.

La conseqüència és concreta i convé dir-la sense embuts: la qualificació derivada de la capçalera serà S1 en qualsevol factura creada per la v1, així que l'exempció i la no subjecció s'han de declarar per línia, amb lines[].exemption_reason. És exactament el que fa l'exemple intracomunitario_bienes —tax_rate: 0 més exemption_reason: "E5"— en lloc de recolzar-se en un règim de capçalera que no pot fixar.

Vegeu Classificació fiscal i exempcions per línia per al catàleg de línia, i Abast i limitacions per a què permet i què no aquesta frontera.

El catàleg llegible per màquina

GET /v1/tax-catalog (scope taxes:read) publica els catàlegs fiscals que descriu aquesta pàgina — règims indirectes amb els seus tipus vàlids i els seus codis AEAT, règims d'operació amb les seves mencions legals, causes d'exempció amb el seu article de la LIVA, tipus de retenció del sistema i els parells legals d'IVA i recàrrec — amb etiquetes en espanyol, anglès i català a cada resposta.

curl https://api.factuarea.com/v1/tax-catalog \
  -H "Authorization: Bearer fact_live_3pXnR2VbY7TcA9eFmN5z8KqW"

Dues propietats fan segur posar-lo a la memòria cau de manera agressiva (BR-TAX-028): és idèntic per a totes les empreses —la consulta no porta identificador d'empresa i cap de les seves fonts no està acotada a un tenant, així que dues API keys reben cossos idèntics byte a byte i per tant el mateix ETag— i es deriva dels objectes de valor tancats del codi i no d'una llista copiada, de manera que un cas nou hi apareix automàticament en lloc de desincronitzar-se en silenci.

Què surt al PDF

La clau de règim en si no s'imprimeix. El que veu qui llegeix el document és la menció legal derivada del règim d'operació — la referència a l'art. 25 LIVA en un lliurament intracomunitari, a l'art. 21 en una operació amb tercers països, a l'art. 84.Uno.2 en la inversió del subjecte passiu — i res en absolut per al règim general, que no necessita menció (BR-TAX-024).

Com que aquestes mencions deriven del règim de capçalera, i el règim de capçalera no es pot fixar a la v1, una factura creada per l'API pública no imprimeix cap menció automàtica de règim. Fes servir notes si el document necessita declarar l'exempció en prosa.

Què arriba a l'AEAT

Viatgen dos camps diferents per cada grup de desglossament, i responen preguntes diferents.

La qualificació respon a «quina classe d'operació és aquesta?», i es deriva del règim de capçalera (BR-VFC-029):

Els codis E1, E3, E4 i E6 existeixen al catàleg de l'AEAT però aquesta derivació no els produeix mai: només s'assoleixen com a causa d'exempció de línia. Una línia que en declari una guanya al valor derivat de la capçalera (BR-INV-032).

La clau de règim respon a «sota quin règim especial?», i no s'emet de manera incondicional (BR-VFC-035):

• Sota IPSI no s'emet mai. Les regles de validació de l'AEAT són explícites que aquest impost no porta ClaveRegimen.
• Sota IVA i IGIC la clau es deriva, amb un valor general conservador, i no es fixa mai de manera rígida a 08. El codi 08 correspon a un emissor peninsular amb una operació localitzada a Canàries, Ceuta o Melilla — no a un emissor establert allà, que declara el seu propi impost amb la seva pròpia llista.
• Una causa d'exempció a nivell de document que porti la seva pròpia clau de règim especial —béns usats, agricultura, agències de viatges, criteri de caixa, recàrrec d'equivalència— té prioritat sobre aquest valor per defecte.

Traçabilitat

Derivat de les regles de domini del backend de Factuarea:

• BR-INV-031 — el catàleg tancat L8.1 de lines[].regime_key, el seu valor derivat de la capçalera i la invariant de huella idèntica.
• BR-INV-032 — les causes d'exempció de línia guanyant a la qualificació derivada de la capçalera.
• BR-VFC-029 — el mapa de qualificacions des del règim d'operació de capçalera, i el fet que per aquesta via només s'assoleixen E5 i E2.
• BR-VFC-035 — com es deriva ClaveRegimen: mai fixada de manera rígida a 08, mai emesa per a l'IPSI, prioritat de la clau especial de la causa d'exempció.
• BR-TAX-024 — la causa d'exempció a nivell de document i la menció legal automàtica.
• BR-TAX-028 — el catàleg fiscal públic: les seves cinc fonts, la seva independència del tenant i la publicació en positiu dels tipus de retenció.