Comprobantes

Nota de Débito

Emití Notas de Débito (tipo 02) para aumentar el monto de un comprobante aceptado, por corrección de precio o cargos financieros.

La Nota de Débito Electrónica (document_type: "02") aumenta el monto de un comprobante ya aceptado por Hacienda. Es el inverso de la nota de crédito.

Cuándo usarla

Caso	`reference.code`
Corregir un precio facturado por debajo de lo acordado	`02` (corrige monto)
Cobrar intereses o cargos financieros sobre una factura	`10` (nota de débito financiera)
Corregir un monto por un error material al emitir	`14` (corrige monto por error material)
Anular una nota de crédito emitida por error	`01` (anula el documento de referencia), con `reference.document_type: "03"`

El código 14 se registra en el período del comprobante original, no en el de la nota, y puede obligar a rectificar una declaración ya presentada. Usalo solo para errores materiales. Los demás códigos se registran en el período de la nota.

El bloque `reference`

Igual que en la nota de crédito: document_type del original (Nota 10), number con la clave de 50 caracteres, date del original, code y reason. Ver la tabla de campos en nota de crédito.

Ejemplo: corrección de precio

La instalación de la factura de ejemplo se facturó en ₡100 000, pero el precio acordado era ₡120 000. La nota de débito cobra la diferencia con su IVA.

{
  "document": {
    "document_type": "02",
    "activity_code": "475201",
    "date": "2026-10-08T17:05:00-06:00",
    "situation": "1",
    "branch": "001",
    "terminal": "00001"
  },
  "commercial_info": {
    "currency": "CRC",
    "sale_condition": "01",
    "payment_method": "04"
  },
  "issuer": {
    "type": "02",
    "id": "3101654321",
    "name": "Ferretería La Sabana S.A.",
    "email": "facturas@ferreterialasabana.cr",
    "phone": "22905511",
    "address": {
      "province": "1",
      "canton": "08",
      "district": "01",
      "details": "Del Más x Menos 200 m sur"
    }
  },
  "receiver": {
    "type": "01",
    "id": "109870654",
    "name": "Laura Jiménez Mora",
    "email": "laura.jimenez@example.com"
  },
  "items": [
    {
      "line_number": 1,
      "cabys_code": "8731000000000",
      "quantity": 1,
      "unit": "St",
      "description": "Ajuste de precio: instalación de estantería metálica en bodega",
      "price": 20000,
      "tax": [
        { "type": "01", "rate_code": "08", "rate": 13 }
      ]
    }
  ],
  "reference": {
    "document_type": "01",
    "number": "50608102600310165432100100001010000001042147201936",
    "date": "2026-10-08T10:15:00-06:00",
    "code": "02",
    "reason": "Diferencia de precio de la instalación de estantería"
  }
}

Concepto	Monto
Subtotal	20 000
IVA 13 %	2 600
Total de la nota	22 600

curl https://aster.astranexo.com/api/v1/electronic-documents \
  -H "Authorization: Bearer aster_test_8KfQ2mVx3TzL9pRw" \
  -H "Content-Type: application/json" \
  -H "X-Idempotency-Key: ajuste-precio-1042" \
  --data @nota-debito.json

{
  "success": true,
  "message": "Document submitted for processing.",
  "data": {
    "id": 331,
    "document_key": "50608102600310165432100100001020000000015128461093",
    "consecutive_number": "00100001020000000015",
    "document_type": "02",
    "document_type_name": "Nota de Débito Electrónica",
    "status": "processing",
    "environment": "staging",
    "queued_at": "2026-10-08T23:05:01Z"
  }
}

Intereses y cargos financieros

Para cobrar intereses moratorios, emití la nota con code: "10" y describí el cargo en la línea (por ejemplo, “Intereses moratorios, 30 días de atraso”). Tené en cuenta que cada línea de la nota debe usar un CABYS que aparezca en el comprobante original (Hacienda -509), así que usá el CABYS de la línea a la que corresponde el cargo, con una unidad acorde a ese CABYS. El tratamiento de IVA de los intereses depende de tu caso; confirmalo con tu contador.

Verificaciones contra el comprobante original

Aster aplica a la nota de débito las mismas verificaciones que a la nota de crédito, salvo el tope de monto:

Verificación	Código de Hacienda que evita
El original fue aceptado por Hacienda	`-17` / `-29`
La identificación del receptor coincide con la del original	`-17`
Cada `cabys_code` de la nota aparece en el original	`-509`
El total de la nota es mayor que cero	—

A diferencia de la nota de crédito, la nota de débito puede superar el total del original.

Otras reglas

receiver con type e id es obligatorio.
Los códigos de tarifa transitorios 05 y 06 se aceptan en notas de débito.
Una nota de débito sobre una Factura de Compra usa reference.document_type: "18"; el receptor de la nota sos vos (Hacienda -60).
Con code: "99", reference.code_other_description es obligatorio (Hacienda -491).

Ver errores.