# Aster

> Aster is an electronic invoicing (factura electrónica) API for Costa Rica. It receives JSON, validates it against Hacienda's FE 4.4 rules, builds and signs the XML (XAdES-EPES), sends it to Hacienda and reports the verdict by signed webhook. It is the same engine Astra (https://astra.astranexo.com) uses for its invoices. Made by AstraNexo (https://astranexo.com); documentation in Spanish and English.

Key facts:
- Covers all 7 document types of version 4.4: Factura Electrónica (01), Nota de Débito (02), Nota de Crédito (03), Tiquete Electrónico (04), Factura Electrónica de Compra (08), Factura Electrónica de Exportación (09), Recibo Electrónico de Pago (10), plus the Mensaje Receptor (accept, partial accept or reject a supplier's invoice).
- Checks before signing what Hacienda would reject: CABYS codes and IVA rates per line, line and document totals, credit/debit note references, the receiver's ID against Hacienda's registry and economic activities. Errors name the exact field and the Hacienda code.
- Engine time (request in → validated, signed, stored and queued to Hacienda): median 0.46 s in production over the last 30 days.
- When Hacienda is down, documents are signed, queued and resent automatically; webhooks report document.queued and then the verdict.
- Also: PDF and email delivery, idempotency keys, per-company API keys, BCCR and per-bank exchange rates, CABYS and location catalogs, live Hacienda status.
- Files (signed XML, Hacienda response, PDF) are kept 90 days after the verdict on every plan; Archeion keeps them 5 years, as the law requires.

Pricing (US dollars per month, plus 13% IVA; annual billing gets 2 months free):
- Sandbox: US$0/month, test documents only, 1 company, staging or simulated Hacienda
- Inicial: US$19/month, 500 live documents, 1 company, Archeion add-on US$5 per company
- Crecimiento: US$49/month, 3,000 live documents, 10 companies, Archeion add-on US$5 per company
- Escala: US$99/month, 10,000 live documents, 50 companies, Archeion included
- Plataforma: US$149/month + US$2 per active company, 25,000 documents pooled, unlimited companies, account keys to create companies by API, Archeion included (for ERPs, POS and accounting firms)
- Empresa: custom price above 50,000 documents a month, Archeion included
- Integration services by AstraNexo: from US$500 per project

API base URL: https://aster.astranexo.com/api/v1. Authentication: Bearer API key (aster_test_… for staging, aster_live_… for production).
Contact: app@astranexo.com or WhatsApp +1 (229) 536-0790. Sign up (free Sandbox, no card): https://aster.astranexo.com/app/signup

## Key pages
- [Home (Spanish)](https://aster.astranexo.com/): what Aster does
- [Home (English)](https://aster.astranexo.com/en/)
- [Precios](https://aster.astranexo.com/precios) / [Pricing](https://aster.astranexo.com/en/pricing): plans explained
- [Archeion](https://aster.astranexo.com/archeion): 5-year fiscal archive of every document
- [Para plataformas](https://aster.astranexo.com/plataformas): one integration for all of a platform's customers
- [Seguridad](https://aster.astranexo.com/seguridad): certificates, credentials and data protection
- [Estado de Hacienda](https://aster.astranexo.com/haciendastatus): live availability of Hacienda's e-invoicing services
- [Tipo de cambio](https://aster.astranexo.com/exchange-rates): today's dollar rate at each Costa Rican bank
- [API reference](https://aster.astranexo.com/docs/api/) and [OpenAPI document](https://aster.astranexo.com/api/v1/openapi.yaml)

## Docs (Spanish)
- [Introducción](https://aster.astranexo.com/docs/): Qué es Aster, qué resuelve por vos y cómo está organizada esta documentación.
- [Autenticación y llaves](https://aster.astranexo.com/docs/autenticacion/): Tipos de llave, ambientes, permisos, rotación y buenas prácticas para autenticarte contra la API de Aster.
- [Catálogos](https://aster.astranexo.com/docs/catalogos/): Endpoints de consulta para CABYS, ubicaciones, tablas de códigos de Hacienda, contribuyentes y tipo de cambio.
- [Changelog](https://aster.astranexo.com/docs/changelog/): Cambios de reglas de Hacienda que Aster ya maneja y cambios de la API, del más reciente al más antiguo.
- [Ambientes](https://aster.astranexo.com/docs/conceptos/ambientes/): Diferencias entre el modo de prueba y el de producción, el sandbox simulado y qué cuenta para el uso de tu plan.
- [Ciclo de vida](https://aster.astranexo.com/docs/conceptos/ciclo-de-vida/): Los estados de un comprobante desde que lo enviás hasta el veredicto de Hacienda, y los webhooks de cada paso.
- [Clave numérica](https://aster.astranexo.com/docs/conceptos/clave/): Estructura de la clave de 50 caracteres que identifica cada comprobante ante Hacienda, y cómo la maneja Aster.
- [Consecutivo](https://aster.astranexo.com/docs/conceptos/consecutivo/): El número consecutivo de 20 dígitos, quién lo asigna y por qué nunca se puede reutilizar una vez que llegó a Hacienda.
- [Mensaje Receptor](https://aster.astranexo.com/docs/conceptos/mensaje-receptor/): Cómo aceptar, aceptar parcialmente o rechazar ante Hacienda una factura que recibiste de un proveedor.
- [Sucursal y terminal](https://aster.astranexo.com/docs/conceptos/sucursal-terminal/): Cómo usar la sucursal y la terminal del consecutivo para modelar locales y puntos de venta.
- [Errores](https://aster.astranexo.com/docs/errores/): Formato de los errores de la API, catálogo de códigos y los rechazos de Hacienda que Aster detecta antes de enviar.
- [Estado](https://aster.astranexo.com/docs/estado/): Dónde ver el estado de Aster y de Hacienda, y qué pasa con tus comprobantes cuando Hacienda no está disponible.
- [Anular un comprobante](https://aster.astranexo.com/docs/guias/anular/): Anulá un comprobante aceptado con una nota de crédito total en una sola llamada, y reemplazá correctamente los comprobantes rechazados.
- [Archeion](https://aster.astranexo.com/docs/guias/archeion/): Conservá durante 5 años los XML, respuestas de Hacienda y PDF de todos tus comprobantes, con búsqueda, descarga, exportación e importación.
- [Exoneraciones](https://aster.astranexo.com/docs/guias/exoneraciones/): Aplicá exoneraciones de IVA por línea, con los tipos de la Nota 10.1, las instituciones de la Nota 23 y el cálculo que exige Hacienda.
- [Factura de Compra](https://aster.astranexo.com/docs/guias/factura-compra/): Emití Facturas Electrónicas de Compra (tipo 08) para respaldar compras a proveedores del exterior o que no emiten comprobantes electrónicos.
- [Factura Electrónica](https://aster.astranexo.com/docs/guias/factura-electronica/): Emití una Factura Electrónica (tipo 01) con servicios y mercancías, descuentos, IVA y venta a crédito.
- [Factura de Exportación](https://aster.astranexo.com/docs/guias/factura-exportacion/): Emití Facturas Electrónicas de Exportación (tipo 09) para ventas a compradores del exterior, en moneda extranjera y con partida arancelaria.
- [Idempotencia](https://aster.astranexo.com/docs/guias/idempotencia/): Reintentá cualquier solicitud de escritura sin riesgo de emitir dos comprobantes, con el encabezado X-Idempotency-Key.
- [IVA devuelto](https://aster.astranexo.com/docs/guias/iva-devuelto/): Declará el IVA devuelto en servicios de salud pagados con tarjeta, con las reglas que Hacienda exige desde el 1 de noviembre de 2026.
- [Límites de uso](https://aster.astranexo.com/docs/guias/limites/): Documentos incluidos por plan, qué cuenta para el uso, límites de solicitudes por minuto y cómo ampliar tu asignación con paquetes.
- [Migrar desde otro proveedor](https://aster.astranexo.com/docs/guias/migrar/): Pasá tu facturación electrónica a Aster sin perder la numeración, reutilizando tu certificado y tus credenciales, y con un período de prueba en paralelo.
- [Moneda extranjera](https://aster.astranexo.com/docs/guias/moneda-extranjera/): Emití comprobantes en dólares u otras monedas con el tipo de cambio correcto, usando las tasas del BCCR o de un banco específico.
- [Nota de Crédito](https://aster.astranexo.com/docs/guias/nota-credito/): Emití Notas de Crédito (tipo 03) para devoluciones, descuentos posteriores y anulaciones, con las verificaciones contra el comprobante original.
- [Nota de Débito](https://aster.astranexo.com/docs/guias/nota-debito/): Emití Notas de Débito (tipo 02) para aumentar el monto de un comprobante aceptado, por corrección de precio o cargos financieros.
- [PDF y correo](https://aster.astranexo.com/docs/guias/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.
- [Plataformas multi-emisor](https://aster.astranexo.com/docs/guias/plataformas/): Administrá muchos emisores desde una sola cuenta, como ERP, sistema de punto de venta o despacho contable, con llaves de cuenta y llaves por organización.
- [Comprobantes recibidos](https://aster.astranexo.com/docs/guias/recibidos/): Listá los comprobantes que te emiten tus proveedores, aceptalos o rechazalos con un Mensaje Receptor y conservá los tres XML juntos.
- [Recibo Electrónico de Pago](https://aster.astranexo.com/docs/guias/recibo-pago/): Emití Recibos Electrónicos de Pago (tipo 10) para documentar el cobro total o parcial de una venta a crédito.
- [Tiquete Electrónico](https://aster.astranexo.com/docs/guias/tiquete-electronico/): Emití Tiquetes Electrónicos (tipo 04) desde un punto de venta, sin identificar al cliente y con numeración propia por caja.
- [Webhooks](https://aster.astranexo.com/docs/guias/webhooks/): Recibí los veredictos de Hacienda en tu servidor, verificá la firma de cada entrega y procesá los eventos una sola vez.
- [Inicio rápido](https://aster.astranexo.com/docs/inicio-rapido/): Creá una cuenta, obtené tu llave de prueba y enviá tu primera Factura Electrónica en cinco minutos.

## Docs (English)
- [Introduction](https://aster.astranexo.com/en/docs/): What Aster is, what it handles for you, and how this documentation is organized.
- [Authentication and keys](https://aster.astranexo.com/en/docs/autenticacion/): Key types, environments, permissions, rotation and good practices for authenticating against the Aster API.
- [Errors](https://aster.astranexo.com/en/docs/errores/): The API error format, the error code catalog and the Hacienda rejections Aster catches before sending.
- [Quickstart](https://aster.astranexo.com/en/docs/inicio-rapido/): Create an account, get your test key and send your first Factura Electrónica in five minutes.

## Optional
- [All docs in one file](https://aster.astranexo.com/llms-full.txt): every docs page as Markdown