Guides

Anular un comprobante

Anulá un comprobante aceptado con una nota de crédito total en una sola llamada, y reemplazá correctamente los comprobantes rechazados.

This content is not available in your language yet.

En Hacienda un comprobante aceptado no se borra ni se edita: se anula con una nota de crédito que lo referencia. Aster lo resuelve en una sola llamada.

Anulación total en una llamada

curl -X POST https://aster.astranexo.com/api/v1/documents/50608102600310165432100100001010000001042147201936/void \
  -H "Authorization: Bearer aster_test_8KfQ2mVx3TzL9pRw" \
  -H "Content-Type: application/json" \
  -H "X-Idempotency-Key: anular-1042" \
  --data '{ "reason": "Factura emitida al cliente equivocado" }'

reason es opcional: es el texto que va en la referencia de la nota (de 3 a 180 caracteres). Si lo omitís, Aster usa una razón genérica de anulación. La llave necesita el permiso invoices:void.

Aster arma una Nota de Crédito Electrónica completa:

Copia el emisor, el receptor, la moneda, el tipo de cambio y todas las líneas del original, con sus cantidades, precios, descuentos, impuestos y exoneraciones.
Agrega la referencia con document_type del original, su clave, su fecha y code: "01" (anula el documento de referencia).
La firma, la envía a Hacienda y te devuelve la nota.

{
  "success": true,
  "message": "Document submitted for processing.",
  "data": {
    "id": 329,
    "document_key": "50608102600310165432100100001030000000088136015729",
    "consecutive_number": "00100001030000000088",
    "document_type": "03",
    "document_type_name": "Nota de Crédito Electrónica",
    "status": "processing",
    "environment": "staging",
    "queued_at": "2026-10-08T23:10:01Z"
  }
}

La nota es un comprobante como cualquier otro: consume un consecutivo de nota de crédito, sigue el ciclo de vida normal y cuenta para el uso de tu plan cuando Hacienda da su veredicto.

Antes de firmar, Aster aplica las mismas verificaciones que a una nota manual: el original tiene que estar aceptado y la llave tiene que ser del mismo ambiente que el original. Si el original no está aceptado, la respuesta es 422 y no se emite nada.

El evento `document.voided`

Cuando Hacienda acepta la nota de crédito, el comprobante original queda en estado voided y Aster envía el evento document.voided a tus webhooks, además del document.accepted de la nota.

{
  "document_key": "50608102600310165432100100001010000001042147201936",
  "document_type": "01",
  "status": "voided"
}

Si Hacienda rechaza la nota, el original sigue aceptado y vigente: revisá el hacienda_message de la nota, corregí y volvé a intentar.

Correcciones parciales

/void siempre anula el total. Para devolver una parte, rebajar un precio o acreditar una exoneración posterior, emití una nota de crédito manual con las líneas y montos que corresponden. Ver nota de crédito.

Si lo que necesitás es cobrar más, emití una nota de débito.

Error material: código 13 en lugar de 01

Desde el 1 de noviembre de 2026, Hacienda distingue dos formas de anular:

Código	Cuándo	Período en que se registra la anulación	Código del comprobante de reemplazo
`01` Anula el documento de referencia	Anulación normal: la venta se deshizo o se facturó por error y se reemplaza ahora	El de la nota de crédito	`07`
`13` Anula por error material	El comprobante tenía un error material al emitirse (un dato equivocado)	El del comprobante original	`15`

/void usa siempre 01. Para anular por error material, emití la nota de crédito manual con reference.code: "13". Como el código 13 se registra en el período del original, puede obligar a rectificar una declaración ya presentada: decidilo con tu contador.

Si después de anular emitís el comprobante correcto, agregale un bloque reference que apunte al anulado, con el código de reemplazo de la tabla.

Comprobantes rechazados

Un comprobante rechazado por Hacienda no tiene efecto fiscal, así que no se anula: /void y las notas de crédito sobre un comprobante rechazado responden 422.

Lo que corresponde es emitir uno nuevo, corregido, con un consecutivo nuevo. Un consecutivo enviado a Hacienda no se reutiliza nunca, aunque el comprobante haya sido rechazado; si lo intentás, la API responde 409 duplicate_consecutive.

El comprobante de reemplazo referencia al rechazado:

{
  "document_type": "10",
  "number": "50608102600310165432100100001010000001042147201936",
  "date": "2026-10-08T10:15:00-06:00",
  "code": "16",
  "reason": "Sustituye comprobante rechazado por Hacienda"
}

Campo	Valor
`document_type`	`10`: comprobante electrónico rechazado por el Ministerio de Hacienda
`number`	La clave del comprobante rechazado
`code`	`16`: sustituye comprobante electrónico rechazado

Si dejás que Aster numere (sin clave ni consecutive_number en el cuerpo), el reemplazo recibe automáticamente el siguiente consecutivo.

Ver errores.