Introducción

Aster es la API de facturación electrónica de Hacienda que vende AstraNexo. Recibe un JSON, lo valida contra las reglas de la versión 4.4, arma el XML, lo firma, lo envía a Hacienda y te avisa del resultado. Es el mismo motor que usa Astra para emitir sus comprobantes.

La API vive en una sola URL base:

https://aster.astranexo.com/api/v1

Qué hace Aster por vos

• Los 7 comprobantes de la versión 4.4: Factura Electrónica (FE, 01), Nota de Débito (ND, 02), Nota de Crédito (NC, 03), Tiquete Electrónico (TE, 04), Factura Electrónica de Compra (FEC, 08), Factura Electrónica de Exportación (FEE, 09) y Recibo Electrónico de Pago (REP, 10). También el Mensaje Receptor para aceptar o rechazar facturas de proveedores.
• Firma XAdES-EPES con el certificado .p12 de cada emisor. Vos no tocás XML ni criptografía.
• Validación antes de enviar. Aster revisa cálculos, CABYS, tarifas, referencias de notas y cédulas antes de firmar, y detecta rechazos de Hacienda como -107, -400, -509 y -512 antes de que ocurran. El detalle está en Errores.
• Respuesta de Hacienda garantizada. Aster recibe el callback de Hacienda y, si no llega, consulta el estado por su cuenta. Si Hacienda no está disponible, guarda el comprobante y lo reenvía solo cuando Hacienda vuelve. Ver ciclo de vida.
• Webhooks firmados con HMAC-SHA256 para cada cambio de estado. Ver webhooks.
• Idempotencia en todas las escrituras con X-Idempotency-Key, para reintentar sin duplicar comprobantes. Ver idempotencia.
• PDF y correo al receptor, con el XML firmado y la respuesta de Hacienda. Ver PDF y correo.
• Catálogos listos para usar: CABYS, provincias, cantones y distritos, tablas de códigos, búsqueda de contribuyentes y tipo de cambio del BCCR. Ver catálogos.
• Almacenamiento: todos los planes guardan el XML firmado, la respuesta de Hacienda y el PDF durante 90 días, con descarga masiva. Archeion los guarda 5 años, el plazo que la ley le exige al emisor: viene incluido desde Escala y se suma por $5 por empresa al mes en Inicial y Crecimiento.

Proveedor de sistemas

Desde la versión 4.4 cada comprobante lleva el campo ProveedorSistemas con la cédula de quien provee el sistema de facturación. AstraNexo está inscrita ante Hacienda como proveedor de sistemas y Aster llena ese campo por vos. Si tu empresa también está inscrita como proveedor y querés usar tu propia cédula, podés enviarla en document.provider_system_id.

Cómo está organizada esta documentación

• Empezar: inicio rápido para enviar tu primera factura en cinco minutos y autenticación para entender las llaves.
• Conceptos: lo que conviene entender una vez antes de integrar: la clave, el consecutivo, los ambientes, sucursal y terminal, el ciclo de vida y el Mensaje Receptor.
• Comprobantes y guías: un ejemplo completo por tipo de comprobante y guías para casos concretos (exoneraciones, moneda extranjera, anulaciones, webhooks, plataformas con muchos emisores).
• Referencia: la referencia interactiva de la API, donde podés probar cada endpoint con tu llave de prueba, el catálogo de errores, los catálogos, el changelog y el estado del servicio y de Hacienda.

Consejo

Todo lo que hagás con una llave aster_test_… es gratis e ilimitado. Podés integrar completo antes de pagar un plan.

Inicio rápidoCreá una cuenta y enviá tu primera Factura Electrónica de prueba.

ConceptosClave, consecutivo, ambientes, sucursal y terminal, ciclo de vida.

GuíasWebhooks, idempotencia, exoneraciones, notas de crédito y más.

Referencia APITodos los endpoints, con ejemplos y prueba en vivo.