Ir directamente al contenido
Español
  • No hay sugerencias porque el campo de búsqueda está vacío.

Factura con AIU por API

El AIU (Administración, Imprevistos y Utilidad) se usa en contratos de obra, servicios generales y vigilancia. Por API se marca con "operation": "AIU", y cada componente va como un ítem.

La API no calcula los porcentajes: los valores de Administración, Imprevistos y Utilidad los calcula tu sistema según el contrato, y tampoco se comprueba que cuadren.

{
  "invoice": {
    "operation": "AIU",
    "items": [
      {
        "sku": "SERVICIO",
        "description": "Prestación del servicio",
        "quantity": 1,
        "price": 120000,
        "aiu_administration": true,
        "aiu_contract": "Mantenimiento de zonas comunes"
      },
      { "sku": "AIU-A", "description": "Administración (9%)", "quantity": 1, "price": 10800 },
      { "sku": "AIU-I", "description": "Imprevistos (1%)", "quantity": 1, "price": 1200 },
      {
        "sku": "AIU-U",
        "description": "Utilidad (3%)",
        "quantity": 1,
        "price": 3600,
        "taxes": [ { "tax_category": "IVA", "tax_rate": 19 } ]
      }
    ]
  }
}

Reglas

  • Al menos un ítem tiene que traer aiu_administration en true y aiu_contract.
  • aiu_contract es el objeto del contrato. Aparece en el XML de la DIAN como "Contrato de servicios AIU por concepto de: ..." seguido del texto que envíes, así que escribe el concepto, no un código.
  • El IVA se calcula solo sobre la Utilidad: por eso el impuesto va en el ítem AIU-U. Para AIU sin IVA o con otra tarifa, cambia o quita el impuesto de ese ítem. Ver AIU para otro IVA o sin IVA.

Error si ningún ítem trae los campos de AIU

La respuesta no nombra el campo que falta:

El campo indicado no cumple una validación para la que no hay un mensaje específico. Contacta a soporte con el documento enviado.

Antes de escalarlo, revisa que el ítem del servicio lleve aiu_administration y aiu_contract.

Recursos Adicionales