El 21 de abril de 2026 la Dirección General de Tributación publicó el comunicado «Actualización de los Anexos y Estructuras versión 4.4 y validación de comprobantes electrónicos». No es una versión nueva del formato, sigue siendo la 4.4, pero trae códigos y reglas que todo sistema de emisión debe aplicar a partir del 1.º de noviembre de 2026. Este artículo resume qué cambia, con la fuente oficial a la vista, y qué está hecho en Almendro desde el 13 de octubre para que usted no tenga que hacer nada.
Qué dice Hacienda, con sus palabras
El comunicado explica que la actualización busca «mejorar la trazabilidad de las operaciones» y enumera los ajustes. Los citamos tal como están escritos:
- «Se incluyen en la nota 9 los códigos 13, 14 y 15, para efectos de reflejar su efecto contable en el período que corresponda.»
- «Se incluyen en la nota 9 los códigos 16 y 17 para la correcta referencia a un comprobante electrónico rechazado, así como la aplicación de un pago en un Recibo Electrónico.»
- «Se ajusta el código 12 para la correcta aplicación de los efectos contables del crédito.»
- «Se incluyen en la nota 10 los códigos 19 y 20 para facilitar la correcta referencia a los comprobantes electrónicos “Factura Electrónica de Exportación” y “Recibo Electrónico de Pago” cuando se requiera.»
- «Los nuevos códigos deberán implementarse en los sistemas de emisión de comprobantes electrónicos a partir del 1.º de noviembre del presente año. No obstante, antes de dicha fecha, los obligados tributarios que ya tengan implementados los cambios en sus sistemas podrán iniciar con su uso cuando así lo deseen.»
- «El ajuste ya se encuentra disponible tanto en el ambiente de pruebas (STAG), como en el ambiente de producción.»
- Y sobre la identificación: se aclara «que se permite el uso de cédulas jurídicas alfanuméricas para Sociedades, conforme a las disposiciones del Registro Nacional, cuando este así lo comunique».
La fuente es el comunicado oficial de Hacienda (PDF).
Los códigos nuevos, uno por uno
La nota 9 es el «código de referencia»: el motivo por el que un comprobante referencia a otro. Quedan así los nuevos:
- 13, anula documento de referencia por error material.
- 14, corrige monto por error material.
- 15, sustituye comprobante electrónico por error material.
- 16, sustituye comprobante electrónico rechazado.
- 17, pago a comprobante electrónico; solo se usa en el Recibo Electrónico de Pago.
- El 12 pasa a llamarse «nota de crédito financiera por exoneración posterior a la facturación».
La nota 10 es el «tipo de documento de referencia»: qué clase de documento se está referenciando. Suma el 19, Factura Electrónica de Exportación, y el 20, Recibo Electrónico de Pago.
La diferencia entre el 13 y el 01, o entre el 14 y el 02, es contable: los códigos 13 y 14 llevan su efecto al período del comprobante que modifican, y los códigos 01, 02 y 06 lo llevan al período de la nota. Si una anulación con 13 obliga a emitir de nuevo, la factura nueva lleva el 15; si la anulación fue con 01, la nueva lleva el 07. Y para reemitir una factura que Hacienda rechazó se usa el 16, referenciando el documento rechazado con el tipo 10, porque Hacienda no conserva los comprobantes que rechaza.
En los esquemas XSD cambia además el tipo de la clave: pasa de admitir solo dígitos a admitir letras y dígitos, cincuenta caracteres, para cuando el Registro Nacional active las cédulas jurídicas alfanuméricas.
Qué hay en Almendro desde el 13 de octubre
Todo lo anterior está en producción en fe.almendro.cr desde el 13 de octubre de 2026. En concreto:
- Los esquemas XSD vigentes validan cada comprobante antes de firmarlo.
- Los códigos 13, 14, 15, 16 y 17 y los tipos 19 y 20 están disponibles en el portal y en la API, filtrados según el tipo de comprobante que usted esté emitiendo.
- Las listas por tipo se respetan tal como las fija el documento oficial: el Recibo Electrónico de Pago solo referencia los tipos 01, 04, 07, 08, 10 y 20; el 09 solo va en notas de crédito y débito; el 16 solo en la Factura Electrónica de Compra; el 12 solo en la nota de crédito; el 17 solo en el recibo de pago; y el 20 nunca en una nota. Una combinación fuera de lista se detiene antes de gastar consecutivo, en vez de salir rechazada de Hacienda.
- La clave de cincuenta caracteres alfanumérica se acepta en consultas, referencias y en el buzón de recibidos.
- Al anular desde el portal usted elige el motivo, 01 o 13; la factura de exportación admite notas de crédito y débito con el tipo 19 y también se puede anular; el recibo de pago paga con el 17; y la factura, el tiquete y la exportación aceptan una referencia opcional, que es el camino de las sustituciones 15 y 16.
- El detalle de cada comprobante muestra los documentos que referencia, con el código y la razón, y los PDF imprimen la descripción del código en lugar del número.
- Si una referencia apunta a un comprobante suyo que Hacienda rechazó, Almendro lo avisa antes de emitir: para Hacienda ese documento no existe y respondería con el error -29.
- La documentación de la API para integradores en fe.almendro.cr/docs-v2 trae las tablas nuevas y la regla del período contable.
Además, el recibo electrónico de pago con IVA totaliza como pide el documento oficial; una nota de crédito o de débito no referencia un recibo de pago, porque Hacienda la rechaza por los códigos CABYS; y la ubicación del emisor es obligatoria en la factura, el tiquete y la exportación: si su cuenta no la tiene completa, Almendro la pide antes de emitir, y debe ser la misma que está inscrita en TRIBU-CR, porque Hacienda la compara y deja la observación -37 cuando difiere.
Qué tiene que hacer usted
Si factura desde el portal, nada: los códigos aparecen donde corresponde y las reglas se aplican solas. Si tiene una integración por API, revise que su sistema use los códigos nuevos cuando apliquen, sobre todo el 13 y el 15 para errores materiales, el 16 para reemitir un comprobante rechazado y el 17 en los recibos de pago, y que acepte claves con letras. Tiene hasta el 1.º de noviembre, pero puede empezar hoy: Hacienda ya los acepta en producción. Si le queda una duda, escríbanos a support@almendro.cr o por WhatsApp al 8862 0662.