Guides

PDF y correo

Generá la representación gráfica en PDF con tu marca, enviale al cliente el XML y el PDF por correo y descargá los archivos de cada comprobante.

This content is not available in your language yet.

Hacienda recibe el XML firmado, pero tu cliente espera un PDF legible y una copia de los archivos en su correo. Aster genera el PDF, lo envía por correo si lo pedís y deja todos los archivos disponibles para descarga.

El PDF

curl https://aster.astranexo.com/api/v1/documents/50608102600310165432100100001010000001042147201936/pdf \
  -H "Authorization: Bearer aster_test_8KfQ2mVx3TzL9pRw" \
  -o factura-1042.pdf

La respuesta es application/pdf. El PDF incluye:

Los datos del emisor, con tu logo, y los del receptor.
El tipo de comprobante, la clave de 50 dígitos, el consecutivo y la fecha de emisión.
Las líneas con su código CABYS, cantidad, unidad, precio, descuentos, impuestos y exoneraciones.
Los totales en la moneda del documento y, si no es colones, su equivalente en colones con el tipo de cambio declarado.
Un código QR que lleva a la página pública de verificación del comprobante.
El estado ante Hacienda: aceptado, rechazado o pendiente.

Podés pedir el PDF en cualquier momento, también antes del veredicto. Mientras Hacienda no responda, el PDF lo indica como pendiente.

Tu marca

Configurá la apariencia de los PDF y los correos de cada organización con su llave:

curl -X PUT https://aster.astranexo.com/api/v1/organizations/me/branding \
  -H "Authorization: Bearer aster_test_8KfQ2mVx3TzL9pRw" \
  -H "Content-Type: application/json" \
  --data @branding.json

{
  "logo": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==",
  "primary_color": "#1F6F4A",
  "footer": "Gracias por su compra. Horario: lunes a sábado, 7:00 a 18:00.",
  "email_sender_name": "Ferretería La Sabana",
  "email_reply_to": "ventas@ferreterialasabana.cr"
}

Campo	Descripción
`logo`	Imagen PNG o JPEG en base64
`primary_color`	Color de acento del PDF, en hexadecimal
`footer`	Texto al pie del PDF
`email_sender_name`	Nombre que ve el cliente como remitente
`email_reply_to`	Dirección a la que llegan las respuestas del cliente

GET /organizations/me/branding devuelve la configuración vigente. La llave necesita el permiso settings:manage para modificarla.

Envío por correo

El envío es opcional y se pide por comprobante. Agregá delivery al cuerpo de POST /electronic-documents:

{
  "receiver": {
    "type": "01",
    "id": "109870654",
    "name": "Laura Jiménez Mora",
    "email": "laura.jimenez@example.com"
  },
  "delivery": {
    "email": true
  }
}

Cuando Hacienda acepta el comprobante, Aster le envía a receiver.email:

El XML firmado.
El PDF.
El XML de respuesta de Hacienda.

El correo sale con el nombre de remitente y la dirección de respuesta de tu configuración de marca. Si Hacienda rechaza el comprobante, no se envía nada: corregí y emití uno nuevo. Sin delivery, Aster no envía correos, útil si tu sistema ya se encarga de eso.

Reenviar o enviar a otros destinatarios

curl -X POST https://aster.astranexo.com/api/v1/documents/50608102600310165432100100001010000001042147201936/email \
  -H "Authorization: Bearer aster_test_8KfQ2mVx3TzL9pRw" \
  -H "Content-Type: application/json" \
  --data '{ "to": ["contabilidad@example.com", "laura.jimenez@example.com"] }'

Sin cuerpo, reenvía al correo del receptor. Con to, envía a esas direcciones. El correo lleva los mismos archivos que el envío original. Solo se pueden enviar comprobantes aceptados.

Descargas

Cada comprobante, emitido o recibido, tiene estas descargas:

Endpoint	Contenido	Tipo
`GET /documents/{clave}/xml`	XML firmado del comprobante	`application/xml`
`GET /documents/{clave}/response-xml`	XML de respuesta de Hacienda	`application/xml`
`GET /documents/{clave}/pdf`	Representación gráfica	`application/pdf`
`GET /documents/{clave}/zip`	Todos los archivos anteriores en un ZIP	`application/zip`

En un comprobante recibido, el ZIP incluye el XML del proveedor, tu Mensaje Receptor firmado y la respuesta de Hacienda. Ver recibidos.

/response-xml responde 404 mientras Hacienda no haya dado su veredicto.

Para descargar muchos comprobantes a la vez, por mes o por rango de fechas, usá las exportaciones de Archeion o GET /documents/export.