Impuestos adicionales y retenciones

Folyo declara el código tributario en cada línea con impuestos. El catálogo calcula la tasa y el monto salvo en los combustibles, donde debes informar el monto fijo vigente de cada línea. El resultado y el listado del documento devuelven el desglose en impuestos; cuando hay una retención parcial también devuelven iva_no_retenido. (v1.23.0)

{
  "detalle": [
    {
      "nombre": "Producto afecto",
      "monto": 100000,
      "impuestos": [{ "codigo": "26" }]
    }
  ]
}

El campo admite hasta dos códigos por línea. No lo uses en líneas exentas. Una misma emisión no mezcla impuestos adicionales y retenciones.

Impuestos que suman al total

Estos códigos suman al total del documento. Las bebidas, suntuarios y combustibles se declaran por línea en los tipos de DTE que el catálogo habilite para esa familia.

Para tasas porcentuales, Folyo calcula un único monto por código sobre la suma de las líneas afectas y redondea por documento. Por ejemplo, con neto 100000 y código 26, el impuesto es 20500, el IVA es 19000 y el total es 139500.

Combustibles: monto fijo sin tasa

Los códigos 28 (diésel), 35 (gasolina), 51 (gas natural comprimido) y 52 (gas licuado) son de monto fijo. El integrador debe enviar el monto vigente para cada línea afectada; no envíes tasa.

{
  "nombre": "Diésel",
  "monto": 100000,
  "impuestos": [{ "codigo": "28", "monto": 6500 }]
}

Folyo valida que el monto exista y se consolida por código. La determinación de la vigencia y el valor aplicable corresponde a quien emite el documento.

Retenciones y anticipos

Las retenciones restan del total. Para factura de compra, NDF y las notas que la corrigen consulta la guía de factura de compra.

Los anticipos 18 (carne, 5%) y 19 (harina, 12%) son códigos adicionales: se calculan por porcentaje y suman al total. El código 17 tiene un perfil especial de faenamiento. Los códigos 16, 40, 14 y 50 no están habilitados.

En una liquidación-factura (43) solo se admiten impuestos adicionales del catálogo aplicable. No se admiten retenciones, iva_no_retenido ni MntBase.

Faenamiento: código 17

El código 17 es IVA anticipado de faenamiento de carne, no un impuesto genérico. Sólo se acepta en DTE 33 y en notas 56/61 que referencian una 33 de faenamiento. Cada línea lleva el código y un perfil obligatorio; cantidad representa kilos y unidad debe ser KG.

{
  "tipo_dte": 33,
  "detalle": [{
    "nombre": "Servicio de faenamiento bovino",
    "cantidad": 245.5,
    "unidad": "KG",
    "monto": 800000,
    "impuestos": [{ "codigo": "17" }],
    "faenamiento": {
      "codigo_cpcs": "1701",
      "cantidad_cabezas": 2,
      "monto_base_faena": 490000
    }
  }]
}

Folyo deriva MntBase como la suma de monto_base_faena y el anticipo de 5%. La base debe corresponder al precio ODEPA declarado para la especie. Cada base individual y su suma no pueden superar 9007199254740991; las cantidades, convertidas a micro-unidades, tienen el mismo límite para preservar paridad exacta. No combines 17 con otro impuesto, descuento o recargo global. La empresa emisora debe acreditar operativamente su calidad de agente retenedor antes de cualquier habilitación en producción.

IVA retenido oro: código 46

codigo: "46" significa IVA retenido oro y no una Factura de Compra. Sólo se acepta en DTE 33 y en notas 56/61 que referencian una 33. No lo envíes en un DTE tipo 46.

La compra de oro sometida a cambio de sujeto por la Res. Ex. 3338/1992 continúa con una Factura de Compra y codigo: "15"; no conviertas uno de estos flujos en el otro.

Descuentos y recargos globales

Con impuestos por código puedes usar descuentos o recargos globales porcentuales (tipo_valor: "%"). Folyo los prorratea entre el neto y cada base de impuesto antes de calcular los montos. Los descuentos o recargos globales en pesos (tipo_valor: "$") se rechazan si hay impuestos por código. Este cálculo porcentual permanece sujeto a validación en certificación antes de cualquier habilitación productiva.

Sigue sin permitirse combinar estos impuestos con rebaja_base_imponible.

XML y respuesta

Cada código se emite como CodImpAdic en la línea y se consolida en ImptoReten en los totales. La respuesta del job entrega codigo, glosa, tasa, monto y retencion. iva_no_retenido solo aparece para una retención parcial.

curl -X POST "https://api.folyo.cl/v1/dte/emitir" \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"tipo_dte": 33,
"receptor": { "rut": "76.543.210-K", "razon_social": "Distribuidora El Roble Ltda", "giro": "Comercio", "direccion": "Av. Matta 1450", "comuna": "Santiago", "ciudad": "Santiago" },
"detalle": [{ "nombre": "Cerveza lager", "cantidad": 8, "precio": 12500, "monto": 100000, "impuestos": [{ "codigo": "26" }] }]
}'

Res. Ex. 83/2026

La Res. Ex. 83/2026 contempla un régimen voluntario de cambio de sujeto para ciertos servicios agrícolas. La procedencia exige que el emisor cumpla los requisitos del régimen. El código 15 es una inferencia operativa mientras se valida externamente su aplicación, no una confirmación de aceptación ni una habilitación automática. Confirma la elegibilidad con tu asesor tributario antes de clasificar una operación.

Disponibilidad y errores

Las familias de esta guía se usan primero en certificación. En producción, cada código usado debe estar habilitado explícitamente en IMPUESTOS_ADICIONALES_PROD después de su validación externa; de otro modo responde 422 IMPUESTO_PENDIENTE_CERT antes de asignar un folio. El código 15 sin descuento o recargo global conserva su compatibilidad histórica. Si se usa 15 con un descuento o recargo porcentual, también debe estar listado explícitamente y validado en certificación. Los problemas de código, tipo de DTE, línea exenta, combinaciones no admitidas o monto fijo sin monto responden 400 INVALID_REQUEST antes de la emisión.