Guías

Comprobantes recibidos

Listá los comprobantes que te emiten tus proveedores, aceptalos o rechazalos con un Mensaje Receptor y conservá los tres XML juntos.

Los comprobantes recibidos son los que te emiten tus proveedores: facturas, tiquetes y notas donde tu organización es el receptor. Con Aster podés listarlos, responderlos ante Hacienda con un Mensaje Receptor y descargar su respaldo.

Listar los recibidos

curl "https://aster.astranexo.com/api/v1/documents?direction=received&from=2026-10-01&to=2026-10-31" \
  -H "Authorization: Bearer aster_test_8KfQ2mVx3TzL9pRw"

Parámetro	Descripción
`direction`	`received` para recibidos; `issued` para los que emitiste
`from`, `to`	Rango de fechas de emisión, `AAAA-MM-DD`
`type`	Tipo de documento, por ejemplo `01`
`status`	Estado del documento
`cursor`	El valor de `meta.next_cursor` de la página anterior

{
  "success": true,
  "data": [
    {
      "document_key": "50606102600310122334400100001010000008812151037246",
      "consecutive_number": "00100001010000008812",
      "document_type": "01",
      "direction": "received",
      "emisor_name": "Distribuidora Ferretera del Valle S.A.",
      "emisor_identification": "3101223344",
      "total_amount": 565000,
      "tax_amount": 65000,
      "currency": "CRC",
      "status": "accepted"
    }
  ],
  "meta": { "next_cursor": null }
}

La lista es paginada por cursor: seguí pidiendo con cursor mientras meta.next_cursor no sea null.

Responder con un Mensaje Receptor

El Mensaje Receptor le comunica a Hacienda si aceptás el comprobante del proveedor. Es lo que respalda tu crédito fiscal de IVA y tu gasto.

`message`	Significado	Documento que genera Aster
`1`	Aceptación total	Tipo `05` (`ConfirmacionAceptacionComprobante`)
`2`	Aceptación parcial (requiere `message_detail`)	Tipo `06` (`ConfirmacionParcialComprobante`)
`3`	Rechazo	Tipo `07` (`RechazoComprobante`)

Los datos salen del XML del proveedor:

{
  "clave": "50606102600310122334400100001010000008812151037246",
  "message": "1",
  "issuer_id": "3101223344",
  "issuer_id_type": "02",
  "receiver_id": "3101654321",
  "receiver_id_type": "02",
  "issue_date": "2026-10-06T14:22:10-06:00",
  "total": 565000,
  "total_tax": 65000,
  "activity_code": "475201",
  "tax_condition": "01",
  "total_tax_credit": 65000,
  "original_doc_type": "01"
}

Campo	Descripción
`clave`	La clave del comprobante del proveedor
`message`	`1`, `2` o `3`
`message_detail`	Motivo, hasta 160 caracteres. Obligatorio con `message: "2"`
`issuer_id`, `issuer_id_type`	La identificación del proveedor
`receiver_id`, `receiver_id_type`	Tu identificación
`issue_date`	La fecha de emisión del comprobante del proveedor
`total`, `total_tax`	El total y el impuesto del comprobante del proveedor
`activity_code`	Tu actividad económica a la que se asigna la compra
`tax_condition`	Condición del IVA: `01` genera crédito, `02` genera crédito parcial, `03` bienes de capital, `04` gasto corriente sin crédito, `05` proporcionalidad
`total_tax_credit`, `total_applicable_expense`	Montos de IVA acreditable y de gasto aplicable
`original_doc_type`	Tipo del comprobante del proveedor: `01` por defecto, `04` para un tiquete, etc.

curl https://aster.astranexo.com/api/v1/receptor-messages \
  -H "Authorization: Bearer aster_test_8KfQ2mVx3TzL9pRw" \
  -H "Content-Type: application/json" \
  -H "X-Idempotency-Key: mr-50606102600310122334400100001010000008812151037246" \
  --data @mensaje-receptor.json

{
  "success": true,
  "message": "Document submitted for processing.",
  "data": {
    "id": 381,
    "document_key": "50606102600310122334400100001010000008812151037246",
    "consecutive_number": "00100001050000000064",
    "document_type": "05",
    "document_type_name": "Aceptación Comprobante",
    "status": "processing",
    "environment": "staging",
    "queued_at": "2026-10-08T18:02:11Z"
  }
}

El mensaje lleva su propio consecutivo (tipo 05, 06 o 07) y el veredicto de Hacienda llega igual que el de cualquier comprobante, por webhook o consulta. La clave del proveedor es una buena llave de idempotencia: nunca vas a responder dos veces el mismo comprobante.

La llave necesita el permiso invoices:sign. Como en todo el API, el ambiente lo decide la llave.

Los tres XML, juntos

Para cada comprobante recibido, Aster guarda en un mismo lugar, bajo la clave del proveedor:

El XML del comprobante del proveedor.
Tu Mensaje Receptor firmado.
La respuesta de Hacienda a tu mensaje.

Es el respaldo completo que te puede pedir Hacienda en una fiscalización. Descargalo con GET /documents/{clave}/zip, o cada archivo por separado con /xml y /response-xml. Ver PDF y correo.

Cuánto tiempo se guardan

Con cualquier plan, Aster conserva los XML de emitidos y recibidos durante 90 días desde el veredicto de Hacienda, y te avisa por correo 7 días antes de borrarlos, con un enlace de exportación. La obligación de conservar los comprobantes durante 5 años es del contribuyente.

Para que Aster los conserve por vos los 5 años, activá Archeion, el archivo fiscal. Viene incluido en Escala, Plataforma y Empresa; en Inicial y Crecimiento cuesta $5 por empresa al mes.

Uso del plan

Cada Mensaje Receptor de producción con veredicto final de Hacienda cuenta como medio documento en el uso de tu plan. Los mensajes de prueba no cuentan. Ver límites de uso.