Factura electrónica en Odoo para Costa Rica: el conector v4.4

Respuesta corta: el conector de Facturaencr para Odoo 19 emite los comprobantes electrónicos de Costa Rica (v4.4) desde la contabilidad de Odoo: al validar la factura sale el comprobante ante Hacienda, con su clave de 50 dígitos y su consecutivo. Son cuatro módulos —contabilidad y tres puentes para Ventas, Punto de Venta y tienda en línea— y corren en Odoo instalado en tu servidor o en tu propia nube, no en Odoo Online.

Odoo es un ERP muy usado, pero no trae la facturación electrónica de Costa Rica lista para la v4.4. Esta guía explica cómo funciona el conector, qué necesitás y qué resuelve.

Qué necesitás

Requisito	Detalle
Odoo 19	En tu servidor o en tu propia nube (odoo.sh y hospedajes con acceso a addons). No en Odoo Online, que no permite instalar módulos propios
Cuenta de Facturaencr	Con una API key con permiso documents:write
Certificado de Hacienda	El .p12 cargado para la cédula del emisor. Ver llave criptográfica de producción
CAByS por categoría	Se clasifica una vez

Si estás en una versión anterior de Odoo, la migración del conector es acotada, pero hay que hacerla.

Cómo se instala

Son cuatro módulos que se instalan juntos: el de contabilidad y tres puentes que se activan solos si tenés Ventas, Punto de Venta o la tienda en línea. En Contabilidad → Ajustes pegás tu API key y su secreto y pulsás «Probar conexión»: ahí se confirma el ambiente (pruebas o producción) y los permisos de la llave.

Las credenciales, el emisor, los consecutivos y el webhook viven en la compañía: un contador lleva varias empresas en la misma base, cada una con su certificado.

El CAByS, por categoría

Cada línea del comprobante necesita un CAByS de 13 dígitos, y clasificar miles de productos de a uno no es viable. En el conector, el CAByS se pone en la categoría y lo heredan todos sus productos, incluidos los que crees después. También se asigna en lote desde la lista de productos, con un buscador que consulta el catálogo. Ver qué es el CAByS.

Qué pasa al validar una factura

1. Revisión local. Antes de emitir se revisa lo que Hacienda va a rechazar —un CAByS que falta, una cédula mal formada, un impuesto sin mapear— y se bloquea con la lista completa de problemas.
2. Emisión. Al validar el asiento, la API responde al instante con la clave y el consecutivo, que aparecen en la pestaña «Factura Electrónica». La llave de idempotencia se deriva de tu base y del asiento, así que un reintento devuelve el resultado original en vez de facturar dos veces. Ver idempotencia en la facturación electrónica.
3. Respuesta de Hacienda. Llega por webhook si tu Odoo tiene una URL pública en https; si no, un proceso automático la consulta cada cinco minutos.
4. Archivos. Al ser aceptada, la factura queda con el XML firmado, la respuesta de Hacienda y el PDF adjuntos.

Si Hacienda rechaza, la factura queda marcada con el motivo y se reemite con un botón, con consecutivo nuevo: un rechazado carece de validez y no se corrige. Ver qué hacer si Hacienda rechaza una factura.

Si se cae la conexión, la factura se postea igual y queda en estado «error» para reintentar: frenar la contabilidad por una caída de internet sería peor que el problema.

Ventas, Punto de Venta y tienda en línea

• Ventas: una cotización no es un documento fiscal. El puente te adelanta qué comprobante saldría y qué datos le faltan, y emite cuando la venta se factura.
• Punto de Venta: el tiquete se arma en el navegador de la caja, así que sale aunque se caiga internet, con clave, consecutivo y QR.
• Tienda en línea: la venta web emite sin frenar al comprador. Ojo: sin la «facturación automática» encendida en Odoo, el eCommerce no crea la factura y no hay nada que emitir; el conector te lo advierte.
• Cédula en el formulario: Odoo no la pide; el puente la agrega a la dirección y decidís si es opcional, obligatoria o no se muestra.

Recibos de pago y proveedores

• El recibo electrónico de pago solo se emite en las condiciones que difieren el IVA al cobro (08 y 10). En una venta a crédito normal el IVA ya se declaró al facturar. Ver recibo electrónico de pago.
• Las facturas de tus proveedores se responden desde la bandeja de gastos con el mensaje receptor. Ver mensaje receptor.

Licencia y servicio

El módulo cuesta USD 250 + IVA, en un solo pago por versión de Odoo. La instalación no tiene costo: la hacemos nosotros con un usuario desarrollador de tu Odoo, configuramos la compañía y dejamos la primera factura aceptada por Hacienda. Aparte se paga el consumo de la plataforma (los comprobantes que emitís). Los cambios de Hacienda que pide el conector llegan sin costo; los cambios a la medida se cotizan por hora (₡20.000 + IVA la hora). Si sos partner de Odoo, una sola cuenta de Facturaencr te permite emitir por las cédulas de todos tus clientes, cada uno con su certificado.

Preguntas frecuentes

¿Funciona en Odoo Online?

No. Odoo Online no permite instalar módulos propios; el conector corre en Odoo instalado en tu servidor o en tu propia nube.

¿Qué versión de Odoo soporta?

Odoo 19.

¿Emite todos los comprobantes?

Factura, tiquete, notas de crédito y débito, factura de compra, exportación y recibo de pago, además del mensaje receptor para las compras.

¿Puedo probar antes de emitir en producción?

Sí. Con una llave de pruebas, el conector emite contra el ambiente de pruebas de Hacienda. Ver sandbox de Hacienda.

Conocé el conector y pedí la instalación en la integración con Odoo. Si tu ERP es otro, la API es la misma que usa el conector y está documentada en /docs.