Impostos

Bilteo aplica els impostos per línia, no per factura. Cada línia referencia fins a tres impostos del catàleg del tenant. El backend calcula bases, quotes i desglossament; tu tries els impostos de cada línia.

Catàleg: GET /taxes

Els impostos són entitats del tenant. Consulta els de venda amb taxes:read:

curl "https://api.test.bilteo.com/api/v1/taxes?tax_use=sale&is_active=true" \
  -H "Authorization: Bearer bk_live_xxx"

Camp	Ús
id	Valor que envies a main_tax_id i camps equivalents.
type	Família fiscal: sujeto, exento, retencion, recargo…
amount / amount_type	Tipus i forma de càlcul.
tax_use	sale, purchase o none.
tax_scope	service o consu.
exempt_reason	Causa d'exempció.
label / invoice_label	Etiquetes per mostrar i imprimir.

Tres espais per línia

{
  "description": "Servei professional",
  "quantity": "1",
  "unit_price": "1000.00",
  "main_tax_id": "…",
  "retention_tax_id": "…",
  "surcharge_tax_id": "…"
}

Camp	Tipus admesos	Efecte
main_tax_id	sujeto, sujeto_isp, sujeto_agri, exento, no_sujeto, no_sujeto_loc, no_deducible, dua	Impost principal, habitualment IVA.
retention_tax_id	retencion	Retenció d'IRPF; resta del total a pagar.
surcharge_tax_id	recargo	Recàrrec d'equivalència; suma sobre la base.

Si omets main_tax_id en una venda normal, s'aplica l'impost principal per defecte del tenant. Una línia amb product_id hereta els impostos del producte, tret que els sobreescriguis.

Famílies fiscals

• sujeto: operació subjecta i no exempta.
• exento: subjecta però exempta, amb exempt_reason i quota zero.
• no_sujeto / no_sujeto_loc: no subjecta, incloses regles de localització.
• sujeto_isp: inversió del subjecte passiu; liquida el destinatari.
• retencion: IRPF, a retention_tax_id.
• recargo: recàrrec d'equivalència, a surcharge_tax_id.

El territori —IVA, IGIC o IPSI— el determina l'impost triat del catàleg, no un camp separat.

Suplerts

Per a una despesa pagada per compte del client sense impostos, utilitza line_type: "sup"; el valor per defecte és "pos". Els totals són:

Total	Significat
base	Bases imposables de les línies pos.
tax_amount	Quota total d'impostos.
total	base + tax_amount.
total_suplidos	Línies sup.
total_payable	Import que paga el client, amb suplerts i retencions.

Desglossament

GET /invoices/{id} inclou tax_breakdown, agregat per impost. És el que apareix al PDF i es remet a l'AEAT.

"tax_breakdown": [
  { "tax_id": "…", "tax_rate": "21", "base": "1000.00", "tax_amount": "210.00" }
]

Consulta exemples complets al Receptari.