Salta al contingut
B2Brouter Docs B2Brouter Docs B2Brouter Docs
Log in
API reference

Informe fiscal

Atributs d’impostos (taxes_attributes)

Section titled “Atributs d’impostos (taxes_attributes)”

Aquesta guia explica com omplir correctament la matriu taxes_attributes en crear factures via API perquè els integradors sàpiguen quins noms i categories d’impostos s’esperen per país.

Important

  • Els percentatges mostrats són els valors predeterminats de B2Brouter per facilitar la integració; les taxes fiscals poden canviar. Valideu sempre amb la legislació vigent de cada país.
  • Els noms d’impostos han de coincidir amb els valors esperats d’aquesta guia. No inventeu noms nous (per exemple, "Exento", "Umsatzsteuer", "Sales tax").
  • Molts formats reutilitzen comment com a motiu d’exempció/“no subjecte”. Ompliu-lo sempre que establiu 0%/exempció/inversió del subjecte passiu, tret que el vostre compte ja tingui el motiu predeterminat correcte.

Useu aquesta guia juntament amb:

Aspectes a tenir en compte

Section titled “Aspectes a tenir en compte”
  • Useu només aquests camps dins de cada objecte taxes_attributes: name (string), category (string, enum), percent (float), comment (string o null). Cap altra clau com amount, base, type, etc.
  • Els percentatges són valors predeterminats esperats; les lleis canvien. Si el vostre cas d’ús utilitza una taxa diferent, envieu-la però manteniu els name i category correctes.
  • Per a retencions, useu percent negatiu i el nom d’impost adequat (IRPF, IRNR, IRPEF, etc.).
  • comment s’usa com a motiu d’exempció/“no subjecte” en molts formats. Proporcioneu un motiu sempre que percent sigui 0 i l’operació sigui exempta/no subjecta/inversió del subjecte passiu (exemple: comment: "E2").
  • La configuració del compte afecta el càlcul: apply_taxes_per_line (booleà) controla si els impostos s’apliquen per línia o sobre la suma; rounding_method controla l’arrodoniment.

Estructura de taxes_attributes

Section titled “Estructura de taxes_attributes”

Cada línia de factura (invoice_lines_attributes) pot contenir una matriu d’impostos:

"taxes_attributes": [
  {
    "name": "VAT",
    "category": "S",
    "percent": 21.0,
    "comment": "Standard VAT"
  }
]

Per a cada objecte d’impost:

  • name (requerit): Nom de l’impost (ha de coincidir amb un dels valors esperats per al país de l’empresa, vegeu la referència per país).
  • category (recomanat): Codi de categoria d’impost (vegeu les categories d’impostos).
  • percent (requerit): Percentatge d’impost. Useu valors negatius per a retencions.
  • comment (opcional però recomanat per a 0%/exempció/inversió del subjecte passiu): Text lliure usat per diversos formats i autoritats fiscals.

Es poden aplicar múltiples impostos a la mateixa línia afegint múltiples objectes a taxes_attributes.

Només aquests camps són vàlids. No inclogueu amount, base ni altres camps personalitzats; es calculen internament per evitar inconsistències.

camptipusrequeritdescripció
namestringsíNom de l’impost (ha de coincidir amb els valors predeterminats del país)
categorystring, enumrecomanatCodi de categoria d’impost (vegeu la llista inferior)
percentfloatsíPercentatge d’impost (negatiu per a retencions)
commentstring o nullopcionalMotiu/explicació, requerit per a molts casos d’exempció/no subjecte

Configuració d’impostos a nivell de compte que afecten els càlculs

Section titled “Configuració d’impostos a nivell de compte que afecten els càlculs”
  • apply_taxes_per_line (booleà): Quan és true, els impostos s’apliquen per línia i s’afegeixen; quan és false, les bases es sumen i l’impost s’aplica al total.
  • rounding_method: Estratègia d’arrodoniment (half_up per defecte). Vegeu Càlcul de factura.

Categories d’impostos

Section titled “Categories d’impostos”

B2Brouter usa categories d’impostos alineades amb la llista de codis PEPPOL/UNCL5305 i, per a alguns països, codis addicionals requerits per l’autoritat fiscal local.

Codis de categoria habituals:

  • S – Taxa estàndard.
  • H – Taxa alta.
  • AA – Taxa reduïda.
  • AAA – Taxa superreduïda.
  • Z – Subministrament a taxa zero (0% però subjecte a IVA).
  • E – Exempt (0% i exempt d’IVA).
  • AE – Inversió del subjecte passiu / “Inversión del sujeto pasivo”.
  • G – Article d’exportació lliure, IVA no carregat.
  • K – Subministrament intracomunitari de béns/serveis (IVA exempt dins de l’EEE).
  • NS – No subjecte.
  • O – Fora de l’àmbit de l’impost / altres operacions.

Només s’accepten aquests valors de categoria; altres codis seran rebutjats.

Singapur usa codis de categoria GST addicionals (vegeu Singapur), i Itàlia usa codis FatturaPA N.. “natura” (vegeu Itàlia).

Recomanacions generals

Section titled “Recomanacions generals”
  • Useu els noms d’impostos predeterminats del país de les taules de sota (coincideixen amb la configuració predeterminada de B2Brouter quan es crea una empresa). Manteniu noms/codis fins i tot si la vostra taxa difereix.
  • Per a l’IVA estàndard, useu el nom principal d’IVA i category: "S" amb el percent adequat.
  • Per a taxes reduïdes, useu category: "AA" o category: "AAA" segons els valors predeterminats mostrats.
  • Per a operacions a taxa zero o exemptes:
    • Useu percent: 0.
    • Trieu category basant-vos en la situació legal:
      • Z: imposable però 0%.
      • E: exempt.
      • AE: inversió del subjecte passiu.
      • Codis locals per a règims específics (Itàlia N.., categories GST de Singapur, etc.).
  • Per a retencions, useu percentatges negatius (per exemple, -19 per a l’IRPF espanyol) i el nom d’impost per a la retenció (per exemple, IRPF, IRNR, IRPEF).

Referència per país – noms d’impostos vàlids i taxes predeterminades

Section titled “Referència per país – noms d’impostos vàlids i taxes predeterminades”

Les taules següents llisten els noms d’impostos esperats per país amb les taxes predeterminades i categories que preconfigurarem. Useu-les com a referència per a la nomenclatura i les categories; ajusteu percent si la legislació o el vostre escenari ho requereix.

Andorra (ad)

Section titled “Andorra (ad)”
nompercentcategorynotes
IGI4.5, 2.5, 1, 0S, AA, AAA, ZIVA (estàndard/reduït/0%).
IRNR10, 5, 1.5, -20S, AA, AAA, SImpost sobre la renda de no residents (retenció quan és negatiu).

Àustria (at)

Section titled “Àustria (at)”
nompercentcategorynotes
MwSt20, 10, 13, 0S, AA, AA, ZIVA.

Austràlia (au)

Section titled “Austràlia (au)”
nompercentcategorynotes
GST10, 0S, EImpost sobre béns i serveis.

Bèlgica (be)

Section titled “Bèlgica (be)”
nompercentcategorynotes
TVA21, 6, 12, 0S, AA, AA, Z, E, AEIVA (estàndard, reduït, exempt, inversió del subjecte passiu).

Bulgària (bg)

Section titled “Bulgària (bg)”
nompercentcategorynotes
ДДС20, 9, 0S, AA, ZIVA.

Suïssa (ch)

Section titled “Suïssa (ch)”
nompercentcategorynotes
VAT8.1, 2.6, 3.8, 0S, AA, AA, EIVA; 0% normalment exports.

Xipre (cy)

Section titled “Xipre (cy)”
nompercentcategory
ΦΠΑ19, 5, 9, 0S, AA, AA, Z

República Txeca (cz)

Section titled “República Txeca (cz)”
nompercentcategory
DPH21, 12, 0S, AA, Z

Alemanya (de)

Section titled “Alemanya (de)”
nompercentcategorynotes
USt19, 7, 0S, AA, ZIVA.

Dinamarca (dk)

Section titled “Dinamarca (dk)”
nompercentcategory
VAT25, 0S, Z, E

Estònia (ee)

Section titled “Estònia (ee)”
nompercentcategory
km22, 9, 0S, AA, Z

Espanya (es)

Section titled “Espanya (es)”

Espanya té diversos règims d’IVA depenent del codi postal de l’empresa:

  • Península/Illes Balears: IVA.
  • Illes Canàries: IGIC.
  • Ceuta/Melilla: IPSI.

comment s’usa per al motiu d’exempció/no subjecte a Facturae/Verifactu. Si envieu percent: 0 per a una operació exempta o no subjecta, afegiu el motiu a comment (exemple: comment: "E2").

Península/Illes Balears (predeterminat)

Section titled “Península/Illes Balears (predeterminat)”
nompercentcategorynotes
IVA21, 10, 7.5, 5, 4, 2, 0S, AA, AA, AA, AAA, AAA, Z/E/AEIVA.
IRPF-19, -15, -7SRetenció IRPF.

Illes Canàries (IGIC) / Ceuta i Melilla (IPSI)

Section titled “Illes Canàries (IGIC) / Ceuta i Melilla (IPSI)”
nompercentcategorynotes
IGIC15, 9.5, 7, 3, 1.5, 0H, H, S, AA, AA, ZIVA equivalent a les Canàries.
IPSI10, 8, 4, 2, 1, 0.5H, H, S, AA, AA, SImpost indirecte local per a Ceuta/Melilla.
IRPF-19, -15, -7SRetenció.

Finlàndia (fi)

Section titled “Finlàndia (fi)”
nompercentcategory
ALV25.5, 10, 14, 0S, AA, AA, Z/E

França (fr)

Section titled “França (fr)”
nompercentcategory
TVA20, 5.5, 10, 2.1, 0S, AA, AA, AAA, Z/AE

Regne Unit (gb)

Section titled “Regne Unit (gb)”
nompercentcategory
VAT20, 5, 0S, AA, Z

Grècia (gr)

Section titled “Grècia (gr)”
nompercentcategory
ΦΠΑ24, 6, 13, 0S, AA, AA, Z

Croàcia (hr)

Section titled “Croàcia (hr)”
nompercentcategory
PDV25, 5, 13, 0S, AA, AA, Z

Hongria (hu)

Section titled “Hongria (hu)”
nompercentcategory
ÁFA27, 5, 18, 0S, AA, AA, Z

Irlanda (ie)

Section titled “Irlanda (ie)”
nompercentcategory
VAT23, 9, 13.5, 4.8, 0S, AA, AA, AA, Z

Islàndia (is)

Section titled “Islàndia (is)”
nompercentcategory
VSK24, 11, 0S, AA, Z/E

Itàlia (it)

Section titled “Itàlia (it)”
nompercentcategorynotes
IVA22, 10, 5, 4, 0S, AA, AA, AAA, N.. / E / Z / AEIVA.
IRPEFnegatiu (per exemple, -20)SImpost sobre la renda (quan s’aplica via FatturaPA).

Per a FatturaPA, les operacions no imposables usen codis category com N1, N2.1, N2.2, N3.1, N3.2, N3.3, N3.4, N3.5, N3.6, N4, N5, N6.1… Han d’enviar-se com a IVA 0% amb name: "IVA" i category: "N..".

Japó (jp)

Section titled “Japó (jp)”
nompercentcategorynotes
VAT10, 8, 0S, AA, E/G/OImpost de consum japonès.

Lituània (lt)

Section titled “Lituània (lt)”
nompercentcategory
PVM21, 5, 9, 0S, AA, AA, Z

Luxemburg (lu)

Section titled “Luxemburg (lu)”
nompercentcategory
TVA17, 3, 8, 14, 0S, AA, AA, AA, Z

Letònia (lv)

Section titled “Letònia (lv)”
nompercentcategory
PVM21, 5, 12, 0S, AA, AA, Z

Mònaco (mc)

Section titled “Mònaco (mc)”
nompercentcategory
TVA20, 5.5, 10, 2.1, 0S, AA, AA, AAA, Z/AE

Malta (mt)

Section titled “Malta (mt)”
nompercentcategory
VAT18, 5, 7, 0S, AA, AA, Z

Malàisia (my)

Section titled “Malàisia (my)”
nompercentcategorynotes
SST10, 8, 6, 5, 0T, T, T, T, E/OImpost sobre vendes i serveis.

Països Baixos (nl)

Section titled “Països Baixos (nl)”
nompercentcategory
BTW21, 9, 0S, AA, Z/AE

Noruega (no)

Section titled “Noruega (no)”
nompercentcategory
MVA25, 15, 12, 0S, AA, AA, Z/E

Nova Zelanda (nz)

Section titled “Nova Zelanda (nz)”
nompercentcategory
GST15, 0S, Z/E

Polònia (pl)

Section titled “Polònia (pl)”
nompercentcategory
PTU23, 5, 8, 0S, AA, AA, Z

Portugal (pt)

Section titled “Portugal (pt)”
nompercentcategory
IVA23, 6, 13, 0S, AA, AA, Z

Romania (ro)

Section titled “Romania (ro)”
nompercentcategory
TVA19, 9, 5, 0S, AA, AA, Z

Suècia (se)

Section titled “Suècia (se)”
nompercentcategory
Moms25, 6, 12, 0S, AA, AA, Z/E

Aràbia Saudita (sa)

Section titled “Aràbia Saudita (sa)”
nompercentcategory
ضريبة القيمة المضافة15, 0S, Z/E/O

Singapur (sg)

Section titled “Singapur (sg)”

Singapur usa categories GST específiques mandades per IRAS. El nom d’impost és sempre GST; la category codifica el tractament GST.

nompercentcategorynotes
GST9SRSubministrament a taxa estàndard.
GST0ZRSubministrament a taxa zero.
GST0 / 9SRCA-SComptabilitat del client – vendes.
GST9SRCA-CComptabilitat del client – compres.
GST9SRRCInversió del subjecte passiu.
GST9SROVR-RSRegistre de venedors d’ultramar – serveis remots.
GST9SROVR-LVGRegistre de venedors d’ultramar – béns de baix valor.
GST9SRLVGBéns de baix valor locals.
GST0ES33Exempt: regulació 33.
GST0ESN33Exempt: no-regulació 33.
GST9DSSubministraments ignorats.
GST0OSFora d’àmbit.
GST0NGCàrrec no GST.

Eslovènia (si)

Section titled “Eslovènia (si)”
nompercentcategory
DDV22, 9.5, 0S, AA, Z

Eslovàquia (sk)

Section titled “Eslovàquia (sk)”
nompercentcategory
DPH20, 10, 0S, AA, Z

Estats Units (us)

Section titled “Estats Units (us)”
nompercentcategorynotes
VAT0OS’usa per indicar “sense IVA” / fora d’àmbit.

Exemples

Section titled “Exemples”

Exemple – Línia de factura espanyola amb IVA i IRPF

Section titled “Exemple – Línia de factura espanyola amb IVA i IRPF”
"taxes_attributes": [
  {
    "name": "IVA",
    "category": "S",
    "percent": 21.0
  },
  {
    "name": "IRPF",
    "category": "S",
    "percent": -15.0
  }
]

Exemple – Venda alemanya exempta dins de la UE (inversió del subjecte passiu)

Section titled “Exemple – Venda alemanya exempta dins de la UE (inversió del subjecte passiu)”
"taxes_attributes": [
  {
    "name": "USt",
    "category": "AE",
    "percent": 0.0,
    "comment": "Intra‑community supply – reverse charge"
  }
]

Exemple – GST a taxa estàndard de Singapur

Section titled “Exemple – GST a taxa estàndard de Singapur”
"taxes_attributes": [
  {
    "name": "GST",
    "category": "SR",
    "percent": 9.0
  }
]