Tipus de factura

El camp type segueix la nomenclatura Veri*Factu de l'AEAT. Alguns tipus es creen amb POST /invoices; els derivats només neixen d'una acció sobre una factura emesa.

Catàleg

type	Nom	Com es produeix
F1	Factura ordinària amb receptor identificat	POST /invoices
F2	Factura simplificada o tiquet	POST /invoices
F3	Substitutiva d'una o diverses F2	POST /invoices/{id}/actions/replace
R1	Rectificativa per error fundat en dret o art. 80 U, Dos i Sis LIVA	POST /invoices/{id}/actions/rectify
R2	Rectificativa per concurs de creditors	…/actions/rectify
R3	Rectificativa per crèdits incobrables	…/actions/rectify
R4	Rectificativa per altres causes	…/actions/rectify
R5	Rectificativa d'una factura simplificada	…/actions/rectify

Només F1 i F2 es creen directament

Les R1–R5 i F3 hereten dades i relacions de la factura original. Consulta Corregir o anul·lar.

F1 — factura ordinària

Requereix un receptor identificat amb partner_id. Ometre'l retorna 400 (invoices.partner_required).

curl -X POST https://api.test.bilteo.com/api/v1/invoices \
  -H "Authorization: Bearer bk_live_xxx" -H "Content-Type: application/json" \
  -d '{ "type": "F1", "partner_id": "…",
        "lines": [{ "description": "Consultoria", "quantity": "1", "unit_price": "1000.00" }] }'

F2 — factura simplificada

No cal identificar el receptor; partner_id és opcional. Si després el client necessita una factura completa, emet una F3 substitutiva.

curl -X POST https://api.test.bilteo.com/api/v1/invoices \
  -H "Authorization: Bearer bk_live_xxx" -H "Content-Type: application/json" \
  -d '{ "type": "F2",
        "lines": [{ "description": "Venda de mostrador", "quantity": "1", "unit_price": "30.00" }] }'

F3 — substitutiva

L'acció replace sobre una F2 emesa crea l'F3 en esborrany, l'enllaça amb l'F2 i recalcula les línies agrupant bases per combinació d'impostos. Consulta Substitutives.

R1–R5 — rectificatives

L'acció rectify les crea des de la factura original. El tipus R es deriva de rectification_cause i del tipus original. Consulta Rectificatives.

Sèries i numeració

Cada factura rep un número correlatiu i immutable d'una sèrie compatible:

Sèrie (type)	Tipus que numera
normal	F1, F3
simplified	F2
rectified	R1–R5
quote	Pressupostos; fora de l'API pública

• code és únic per tenant (409 serie.code_taken).
• resets_per_fiscal_year controla si la numeració es reinicia per exercici.
• Després del primer document numerat només es poden canviar name i is_active (serie.numbering_started).
• type és immutable (serie.type_immutable).
• No es pot eliminar una sèrie amb documents ni l'última del seu tipus.

Número inicial (start_number)

Per continuar una numeració anterior, indica start_number en crear la sèrie:

{ "code": "F26", "name": "Factures 2026", "type": "normal",
  "prefix": "F26-", "num_size": 4, "start_number": 1250 }

Només inicialitza el primer període i es pot editar fins que la sèrie numera el primer document. Si omets serie_id, Bilteo aplica la cascada de valors per defecte.