IVA devuelto

El IVA de los servicios de salud privados pagados con tarjeta se le devuelve al paciente. El comprobante lo declara en el campo TotalIVADevuelto del resumen, que en Aster es totals.total_iva_returned.

La revisión de Anexos y Estructuras v4.4 del 22 de abril de 2026 agregó reglas para este campo. Son obligatorias desde el 1 de noviembre de 2026: a partir de esa fecha, Hacienda rechaza el comprobante que no las cumple. Aster ya las aplica, así que te enterás con un 422 antes de firmar.

Las reglas

Cuando totals.total_iva_returned es mayor que cero:

Regla	Detalle
Hay al menos una línea de servicios de salud al 4 %	El cabys_code empieza con 93 y el impuesto usa rate_code: "04" (en notas de crédito y débito también vale el transitorio "06")
El medio de pago es tarjeta	commercial_info.payment_method: "02"
El monto no supera el IVA de esas líneas	Solo cuenta el IVA de las líneas de salud al 4 %, no el del resto del comprobante

Si una regla no se cumple, la API responde 422 validation_error en totals.total_iva_returned con el motivo.

Devolver el IVA es una decisión del contribuyente: una venta de salud pagada con tarjeta puede omitir el campo. Las reglas solo se aplican cuando lo enviás.

Cómo cambia el total

El IVA devuelto se resta del total del comprobante:

TotalComprobante = TotalVentaNeta + TotalImpuesto + TotalOtrosCargos − TotalIVADevuelto

total_iva_returned es el único campo de totals que enviás vos; Aster calcula el resto y aplica esta fórmula.

Ejemplo completo

Una clínica dental cobra con tarjeta una consulta de odontología (4 %) y vende dos cepillos de dientes (1 %). Devuelve el IVA de la consulta.

factura-salud.json

{
  "document": {
    "document_type": "01",
    "activity_code": "862001",
    "date": "2026-10-08T09:45:00-06:00",
    "situation": "1",
    "branch": "001",
    "terminal": "00001"
  },
  "commercial_info": {
    "currency": "CRC",
    "sale_condition": "01",
    "payment_method": "02"
  },
  "issuer": {
    "type": "02",
    "id": "3101665544",
    "name": "Clínica Dental Sabana Norte S.A.",
    "email": "facturas@clinicasabananorte.example",
    "phone": "22907788",
    "address": {
      "province": "1",
      "canton": "08",
      "district": "01",
      "details": "Frente al costado norte del parque"
    }
  },
  "receiver": {
    "type": "01",
    "id": "109870654",
    "name": "Laura Jiménez Mora",
    "email": "laura.jimenez@example.com"
  },
  "items": [
    {
      "line_number": 1,
      "cabys_code": "9310100001700",
      "quantity": 1,
      "unit": "Sp",
      "description": "Consulta de odontología, chequeo general",
      "price": 40000,
      "tax": [
        { "type": "01", "rate_code": "04", "rate": 4 }
      ]
    },
    {
      "line_number": 2,
      "cabys_code": "3899302019900",
      "quantity": 2,
      "unit": "Unid",
      "description": "Cepillo de dientes de cerdas suaves",
      "price": 2500,
      "tax": [
        { "type": "01", "rate_code": "02", "rate": 1 }
      ]
    }
  ],
  "totals": {
    "total_iva_returned": 1600
  }
}

Concepto	Monto
Consulta (servicio de salud, 4 %)	40 000
Cepillos (mercancía, 1 %)	5 000
Venta neta	45 000
IVA de la consulta	1 600
IVA de los cepillos	50
Total de impuestos	1 650
IVA devuelto	−1 600
Total del comprobante	45 050

El tope del IVA devuelto es 1 600: el IVA de la línea 93… al 4 %. Los 50 colones de los cepillos no se pueden devolver, porque no son un servicio de salud.

Terminal

curl https://aster.astranexo.com/api/v1/electronic-documents \
  -H "Authorization: Bearer aster_test_8KfQ2mVx3TzL9pRw" \
  -H "Content-Type: application/json" \
  -H "X-Idempotency-Key: cita-20261008-0915" \
  --data @factura-salud.json

201 Created

{
  "success": true,
  "message": "Document submitted for processing.",
  "data": {
    "id": 377,
    "document_key": "50608102600310166554400100001010000000311159204736",
    "consecutive_number": "00100001010000000311",
    "document_type": "01",
    "document_type_name": "Factura Electrónica",
    "status": "processing",
    "environment": "staging",
    "queued_at": "2026-10-08T15:45:01Z"
  }
}

Dónde se permite el campo

total_iva_returned se acepta en la Factura Electrónica, el Tiquete Electrónico y las notas de crédito y débito. No existe en la Factura de Compra, la Factura de Exportación ni el Recibo Electrónico de Pago: enviarlo ahí responde 422.

Errores que Aster detecta antes de firmar

Situación	Qué hacer
Ninguna línea tiene un CABYS 93… con tarifa 04 o 06	Revisá el CABYS y el código de tarifa de las líneas de salud
payment_method distinto de 02	El IVA solo se devuelve en pagos con tarjeta; si el pago fue de otra forma, omití el campo
El monto supera el IVA de las líneas de salud al 4 %	Bajá el monto al IVA de esas líneas
El campo aparece en un tipo de documento que no lo admite	Omitilo

Los datos de la clínica de este ejemplo son ficticios. Ver errores.