Reference

Changelog

Cambios de reglas de Hacienda que Aster ya maneja y cambios de la API, del más reciente al más antiguo.

This content is not available in your language yet.

Los cambios de reglas de Hacienda se aplican en Aster sin que tengás que cambiar tu integración, salvo que se indique lo contrario. Los cambios de la API son compatibles con versiones anteriores.

Octubre 2026

Precios (9 de octubre): Crecimiento pasa a US$49 al mes; Escala a US$99 con 10 000 comprobantes; Plataforma incluye 25 000 comprobantes compartidos; nuevo plan Empresa para más de 50 000 al mes. Archeion, el archivo de 5 años, viene incluido en Escala, Plataforma y Empresa, y se suma por US$5 por empresa al mes en Inicial y Crecimiento; la importación de tu historial está incluida. Si dejás de tener Archeion, tus archivos se guardan 90 días más para exportarlos. Nueva integración a la medida desde US$500. Ver precios.
API: llaves aster_test_ y aster_live_ por organización, con el ambiente decidido por la llave, y llaves de cuenta (aster_test_… / aster_live_… creadas sin organización) para administrar organizaciones y llaves con /organizations y /api-keys. Ver autenticación.
API: la idempotencia (X-Idempotency-Key) y los límites de solicitudes ahora son persistentes: se mantienen entre reinicios y entre servidores. Los límites diarios usan el día calendario de Costa Rica.
API: límites por dirección IP en las rutas públicas (/reference/*, /hacienda/taxpayers, /status, POST /auth/token). Ver catálogos.
API: protección de las URL de webhooks. Solo se aceptan URL https:// con un host público (sin localhost, direcciones privadas, de loopback ni link-local) y sin credenciales en la URL. Las entregas se niegan a conectar con direcciones no públicas aunque el DNS cambie después, y siguen como máximo 3 redirecciones.
API: la API solo acepta llamadas desde navegadores de los orígenes de Aster. Las llaves se usan desde tu servidor.
Hacienda: validación de las reglas de IVA devuelto de la revisión del 22 de abril de 2026 (obligatorias desde el 1 de noviembre de 2026). Cuando totals.total_iva_returned es mayor que cero: al menos una línea debe tener un CABYS de servicios de salud (prefijo 93) con tarifa del 4 % (código 04 o 06), el medio de pago debe ser tarjeta (02) y el monto no puede superar el impuesto de esas líneas. Ver IVA devuelto.
Contribuyentes: si una cédula no está en el registro de Aster, /hacienda/taxpayers y la validación previa al envío la consultan en vivo a Hacienda y guardan la respuesta.
Envíos: los comprobantes en cola por indisponibilidad de Hacienda se reenvían, y los que no recibieron callback se consultan en Hacienda, las 24 horas del día.
Envíos: un comprobante que ya tiene veredicto de Hacienda nunca vuelve a un estado intermedio, y una respuesta repetida de Hacienda no vuelve a disparar el webhook.

Setiembre 2026

Hacienda: Aster ya no rechaza comprobantes con fecha de emisión de más de 90 días. Hacienda los recibe como extemporáneos; Aster solo rechaza fechas futuras.
Hacienda: unidades de medida de servicio completas según la versión 4.4, incluidas Alc, Cm, I y las unidades de tiempo.
Tipo de cambio: el BCCR retiró su página de tipo de cambio de ventanilla por entidad. Aster cambió de fuente y /exchange-rates/pair ahora informa fallback y stale para que sepás de dónde viene cada dato.

Agosto 2026

Hacienda: códigos de referencia de la Nota 9 13 (anula por error material), 14 (corrige monto por error material), 15 (sustituye por error material), 16 (sustituye comprobante rechazado) y 17 (pago a comprobante electrónico, solo en el Recibo Electrónico de Pago). Obligatorios desde el 1 de noviembre de 2026; disponibles desde ya.
Hacienda: tipos de documento de referencia de la Nota 10 19 (Factura Electrónica de Exportación) y 20 (Recibo Electrónico de Pago). El Recibo Electrónico de Pago solo puede referenciar los tipos 01, 04, 07, 08, 10 y 20.
Hacienda: en la facturación de mes vencido (tipo de referencia 13), el número, el código y la razón de la referencia son opcionales.
Hacienda: se aceptan números de teléfono cortos de 3 o 4 dígitos (como 911), además de los de 8 a 20 dígitos.
Consecutivos: garantía de no reutilización por organización y ambiente. Un consecutivo que llegó a Hacienda, aceptado o rechazado, responde 409 duplicate_consecutive si se intenta usar de nuevo. Ver consecutivo.
Catálogos: nuevos /reference/reference-codes y /reference/reference-doc-types.

Julio 2026

Hacienda: con el código de referencia 99 (Otros) se envía CodigoReferenciaOTRO desde reference.code_other_description, y Aster exige el campo antes de enviar (-491).
Envíos: una caída del servicio de autenticación de Hacienda deja el comprobante en cola para reenvío automático en vez de marcarlo como error.

Junio 2026

Hacienda: una nota de crédito o débito solo puede incluir CABYS presentes en el comprobante original (-509). Aster lo verifica antes de enviar.
Hacienda: un CABYS exento se factura con la tarifa 10 (Tarifa Exenta), no con otra tarifa del 0 %. Aster lo verifica antes de enviar para evitar los rechazos -107, -483 y -485.
Tipo de cambio: tipo de cambio de ventanilla por entidad (/exchange-rates/entities y entity en /exchange-rates/pair) e histórico del BCCR (/exchange-rates/historical).

Mayo 2026

Validación: el primer dígito del CABYS decide si una línea es bien o servicio, y la unidad de medida tiene que ser coherente con él (-110, -111).
Validación: los montos se comparan en unidades enteras de 5 decimales, igual que Hacienda, para evitar falsos rechazos por redondeo.
Validación: toda línea lleva su bloque de impuesto explícito.
Consecutivos: la verificación de duplicados se hace por ambiente; el mismo consecutivo puede usarse una vez en pruebas y una vez en producción.

Abril 2026

Hacienda: cédulas jurídicas alfanuméricas del Registro Nacional. Una identificación de tipo 02 puede contener letras mayúsculas (por ejemplo 3101A00001), y la clave las admite en el segmento del emisor.
Hacienda: una nota de crédito no puede superar el total del comprobante original (-512).
Hacienda: notas de crédito y débito sobre facturas electrónicas de compra.
Hacienda: en la Factura Electrónica de Compra la clave lleva la identificación del receptor, que es quien firma (-60).
API: descarga de todos los XML en un ZIP con GET /documents/export.

Marzo 2026

Hacienda: verificación de que una nota de crédito o débito referencia un comprobante aceptado y del mismo receptor (-17, -29).
API: no se firma con un certificado vencido (certificate_expired).
API: Mensaje Receptor (POST /receptor-messages) y Recibo Electrónico de Pago (tipo 10).

Setiembre 2025

Hacienda: la versión 4.4 de comprobantes electrónicos es obligatoria desde el 1 de setiembre de 2025 (la resolución MH-DGT-RES-0001-2025 movió la fecha original del 1 de junio). Aster emite exclusivamente en 4.4, incluido el nuevo campo ProveedorSistemas, el Recibo Electrónico de Pago y las tarifas de IVA 09 (0,5 %), 10 (Exenta) y 11 (0 % sin derecho a crédito).