Tributos (Impuestos/Retenciones)

Esta guía te explica cómo enviar tributos en arreglos dentro del JSON de la API.

1. Estructura en arreglos

Los tributos se reportan en:

taxes: impuestos.

withholdings: retenciones.

Ejemplo:

{
  "taxes": [
    {
      "name": "IVA",
      "code": "01",
      "type": "P",
      "rate": 19,
      "amount": 1007,
      "base": 5300
    }
  ],
  "withholdings": [
    {
      "name": "ReteFuente",
      "code": "06",
      "type": "P",
      "rate": 2.5,
      "amount": 132.5,
      "base": 5300
    }
  ]
}

2. Campos de cada ítem de tributo

Cada objeto dentro de taxes o withholdings usa esta estructura:

name: nombre del tributo.

code: código del tributo.

type: tipo de valor del tributo.

rate: tarifa.

amount: valor calculado del tributo.

base: base gravable.

Valores de `type`

`type`	Significado
`P`	Porcentaje
`F`	Valor fijo

3. Catálogo de impuestos (`taxes`)

Usa estos códigos dentro del arreglo taxes.

Código	Nombre corto	Descripción
`01`	IVA	Impuesto sobre las ventas
`02`	IC	Impuesto al consumo departamental nominal
`03`	ICA	Impuesto de industria, comercio y avisos
`04`	INC	Impuesto nacional al consumo
`08`	IC Porcentual	Impuesto al consumo departamental porcentual
`20`	FtoHorticultura	Cuota de fomento hortifrutícola
`21`	Timbre	Impuesto de timbre
`22`	INC Bolsas	Impuesto nacional al consumo de bolsa plástica
`23`	INCarbono	Impuesto nacional del carbono
`24`	INCombustibles	Impuesto nacional a los combustibles
`25`	Sobretasa Combustibles	Sobretasa a los combustibles
`26`	Sordicom	Contribución minoristas, combustibles
`30`	IC Datos	Impuesto al consumo de datos
`32`	ICL	Impuesto al consumo de licores
`33`	INPP	Impuesto nacional a productos plásticos
`34`	IBUA	Impuesto a las bebidas ultraprocesadas azucaradas ****
`35`	ICUI	Impuesto a los productos comestibles ultraprocesados industrialmente y/o con alto contenido de azúcares añadidos, sodio o grasas saturadas
`36`	ADV	Ad valorem
`ZZ`	Nombre de la figura tributaria	Otros tributos, tasas, contribuciones y similares

4. Catálogo de retenciones (`withholdings`)

Usa estos códigos dentro del arreglo withholdings.

Código	Nombre corto	Descripción
`05`	ReteIVA	Retención sobre el IVA
`06`	ReteRenta	Retención sobre renta
`07`	ReteICA	Retención sobre el ICA
`ZZ`	Nombre de la figura tributaria	Otros tributos, tasas, contribuciones y similares

5. Regla práctica

Usa code según el catálogo oficial configurado en tu integración.

Usa taxes para impuestos y withholdings para retenciones.

Usa type: "P" cuando rate representa un porcentaje.

Usa type: "F" cuando el tributo es de valor fijo.

Mantén amount coherente con base y rate.

Si no aplica un tributo, no lo envíes.

6. Errores comunes

Enviar códigos fuera del catálogo.

Enviar retenciones en taxes o impuestos en withholdings.

Enviar type incorrecto, P o F, para la forma de cálculo del tributo.

Enviar rate o amount con valores que no corresponden a la base.

Enviar code: "ZZ" sin un nombre claro de la figura tributaria en name.

7. Nota

El marcador **** en IBUA se conserva como referencia de tu fuente original.

1. Estructura en arreglos#

2. Campos de cada ítem de tributo#

Valores de type#

3. Catálogo de impuestos (taxes)#

4. Catálogo de retenciones (withholdings)#

5. Regla práctica#

6. Errores comunes#

7. Nota#