Mensaje Receptor

Cuando un proveedor te emite una factura electrónica, vos sos el receptor. El Mensaje Receptor es el comprobante con el que le confirmás a Hacienda si aceptás esa factura, la aceptás en parte o la rechazás. Es lo que respalda el crédito fiscal de IVA y el gasto de las compras que declarás.

Aster arma, firma y envía el mensaje por vos con POST /receptor-messages, y lo numera en su propia serie.

Tipos de mensaje

message	Significado	Comprobante generado	Raíz del XML
1	Aceptación	05	ConfirmacionAceptacionComprobante
2	Aceptación parcial	06	ConfirmacionParcialComprobante
3	Rechazo	07	RechazoComprobante

La aceptación parcial requiere explicar el motivo en message_detail, con un máximo de 160 caracteres.

Plazo

Hacienda define un plazo para enviar el Mensaje Receptor desde que recibís la factura. Revisá la normativa vigente y enviá el mensaje en cuanto registrés la compra.

Ejemplo

Ferretería La Sabana S.A. recibió una factura de su proveedor Distribuidora del Valle S.A. y la acepta:

Terminal

curl https://aster.astranexo.com/api/v1/receptor-messages \
  -H "Authorization: Bearer $ASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Idempotency-Key: mr-50605102600310111223300100001010000000877158301947" \
  -d '{
    "clave": "50605102600310111223300100001010000000877158301947",
    "message": "1",
    "issuer_id": "3101112233",
    "issuer_id_type": "02",
    "receiver_id": "3101654321",
    "receiver_id_type": "02",
    "issue_date": "2026-10-05T10:15:00-06:00",
    "total": 226000,
    "total_tax": 26000,
    "activity_code": "475201",
    "tax_condition": "01",
    "original_doc_type": "01"
  }'

201 Created

{
  "success": true,
  "data": {
    "id": 412,
    "document_key": "50605102600310111223300100001010000000877158301947",
    "consecutive_number": "00100001050000000031",
    "document_type": "05",
    "document_type_name": "Aceptación Comprobante",
    "status": "processing",
    "environment": "staging",
    "queued_at": "2026-10-08T16:31:07Z"
  },
  "timestamp": "2026-10-08T16:31:07Z",
  "api_version": "1.0"
}

document_key es la clave de la factura del proveedor y consecutive_number es el consecutivo de tu mensaje, de tipo 05. A partir de ahí el mensaje sigue el mismo ciclo de vida que cualquier comprobante, con los mismos webhooks.

Para un rechazo, el cambio es mínimo:

{
  "clave": "50605102600310111223300100001010000000877158301947",
  "message": "3",
  "message_detail": "Mercadería no recibida",
  "issuer_id": "3101112233",
  "issuer_id_type": "02",
  "receiver_id": "3101654321",
  "receiver_id_type": "02",
  "issue_date": "2026-10-05T10:15:00-06:00",
  "total": 226000
}

Campos

Campo	Tipo	Requerido	Descripción
clave	string	Sí	Clave de 50 dígitos de la factura del proveedor (alias key)
message	string	Sí	1 aceptación, 2 aceptación parcial, 3 rechazo (alias mensaje)
message_detail	string	Si message es 2	Motivo, máximo 160 caracteres (alias detalle_mensaje, detail)
issuer_id	string	Sí	Identificación del proveedor que emitió la factura (alias emisor_id, cedula_emisor)
issuer_id_type	string	Sí	Tipo de identificación del proveedor, 01–06 (alias emisor_id_type, tipo_emisor)
receiver_id	string	Sí	Tu identificación (alias receptor_id, cedula_receptor)
receiver_id_type	string	Sí	Tu tipo de identificación, 01–06 (alias receptor_id_type, tipo_receptor)
issue_date	string	Sí	Fecha de emisión de la factura del proveedor (alias fecha_emision, date)
total	number	Sí	Total de la factura, mayor que 0 (alias total_factura)
total_tax	number	No	Impuesto total de la factura (alias total_impuesto, monto_total_impuesto)
activity_code	string	No	Tu código de actividad económica, 6 dígitos
tax_condition	string	No	Condición del impuesto, 01–05
total_tax_credit	number	No	Monto de impuesto a acreditar (alias monto_total_impuesto_acreditar)
total_applicable_expense	number	No	Monto de gasto aplicable (alias monto_total_gasto_aplicable)
original_doc_type	string	No	Tipo del comprobante del proveedor, por defecto 01 (alias tipo_documento_original)
callback_url	string	No	URL adicional para recibir los eventos de este mensaje

Copiá clave, issuer_id, issue_date, total y total_tax del XML que te envió el proveedor. Si no coinciden con lo que Hacienda tiene registrado, Hacienda rechaza el mensaje.

Numeración

Cada tipo de mensaje tiene su propia serie de consecutivos, en la sucursal 001 y la terminal 00001: las aceptaciones usan el tipo 05, las parciales el 06 y los rechazos el 07. Igual que con los demás comprobantes, un consecutivo de mensaje no se reutiliza.

Uso del plan

Cada Mensaje Receptor de producción con veredicto final de Hacienda cuenta como medio comprobante. Ver ambientes.

Para registrar las facturas de proveedores, listarlas y guardar su XML junto con tu mensaje, ver la guía de comprobantes recibidos.