Emprendé
Gs. 100.000
/mes
Hasta 200 comprobantes por mes
Gs. 1.000.000 por año (2 meses gratis)
ECAV SIFEN
Facturación electrónica en Odoo para Paraguay: SIFEN sin salir de Odoo
Timbrá desde la factura de Odoo y dejá que ECAV firme, envíe y concilie con la DNIT. Un módulo para Odoo 17 conectado al gateway SIFEN de ECAV, el mismo que ya usan los Odoo de ECAV en producción.
ECAV SIFEN para Odoo
Vista rápida
17
versión de Odoo
Timbrar
botón en la factura
KuDE
automático al aprobarse
Cómo funciona
¿Cómo funciona la facturación electrónica SIFEN en Odoo con ECAV?
Odoo no habla con la DNIT por su cuenta. El módulo ecav_sifen_client arma el documento a partir de la factura, apoyado en la localización paraguaya l10n_einvoice_py, lo manda al gateway SIFEN de ECAV y aplica el resultado que vuelve. El gateway lo firma con tu certificado, lo envía a la DNIT y guarda el CDC, el XML firmado y el KuDE.
Para quien factura, el flujo es este:
- Confirmás la factura en Odoo, como siempre.
- Con el perfil Emisor tocás «Timbrar», o lo hace el cron de emisión automática si lo activaste.
- El gateway acepta el documento y devuelve un identificador: la emisión es asíncrona.
- Odoo espera unos segundos el resultado. Si todavía no llegó, un cron lo consulta cada 10 minutos, y el gateway además puede avisar por webhook.
- La factura queda con su estado (Autorizado, Aprobado con observación, Rechazado, Cancelado o Error) y el resultado se anota en el chatter.
Cuando se envían varios documentos juntos, van en una sola solicitud para que el gateway los agrupe en el mismo lote de SIFEN.
Documentos
¿Qué documentos puedo emitir desde Odoo?
- Facturas electrónicas de venta.
- Notas de crédito electrónicas, desde las notas de crédito de Odoo.
- Autofacturas electrónicas, desde las facturas de proveedor con ese tipo de documento.
- Notas de remisión electrónicas, con el bloque de transporte: motivo del traslado, vehículo y transportista.
Además de timbrar, desde Odoo podés anular un documento con el botón «Anular» y su motivo, y emitir los demás eventos de SIFEN (inutilización, nominación, datos de transporte y eventos del receptor). Cada evento queda registrado con su resultado, porque un documento puede tener varios a lo largo de su vida.
Lo que hoy no cubrimos: e-Kuatia'i, el régimen simplificado de la DNIT, y la factura de exportación o importación. Si no sabés si e-Kuatia'i te alcanza, lo explicamos en la página de SIFEN.
Configuración
¿Qué tengo que configurar en Odoo?
Antes de timbrar necesitás tener resueltos los requisitos de la DNIT: certificado .p12, habilitación, timbrado y CSC. En Odoo se carga así:
- Certificado y CSC. El .p12, su contraseña, el CSC y el ID del CSC van en la ficha fiscal de la compañía. Solo el grupo de administración del sistema los ve: ni siquiera el perfil Emisor tiene acceso.
- Conexión al gateway. La URL y la clave API (
sk_test_osk_live_) van en la página «ECAV API» de la compañía. - Ambiente. Prueba o producción. Tiene que coincidir con la clave: el gateway rechaza una combinación incoherente.
- Webhooks. El botón «Sincronizar webhooks» trae el secreto con el que Odoo valida cada aviso firmado.
- Emisión automática. Es opcional y viene apagada. Espera 15 minutos por defecto antes de emitir, para que puedas corregir, y no toma documentos de más de 7 días.
- Actividades económicas. Se sincronizan desde el gateway con un botón y con un cron semanal.
El certificado vence, así que un cron diario avisa antes de que caduque el .p12.
Rechazos y estados
¿Qué pasa si la DNIT rechaza una factura o tarda en responder?
El estado de la factura en Odoo sale del estado que informa el gateway. El código de SIFEN solo sirve para describir qué pasó, no para decidir el estado. Estos son los estados:
| Estado en Odoo | Qué significa |
|---|---|
| En proceso | Encolado, todavía sin firmar. |
| Firmado | Ya tiene CDC y XML; falta el veredicto de la DNIT. |
| Autorizado | Aprobado por SIFEN. Genera el KuDE. |
| Aprobado con observación | Válido, con una observación de la DNIT. Genera el KuDE. |
| Rechazado | SIFEN lo rechazó; el chatter muestra el código y la explicación. |
| Cancelado | Anulado o inutilizado. |
| Error | Error técnico, sin veredicto de SIFEN. |
Dos protecciones evitan el error más caro, emitir dos veces el mismo número. Odoo no deja volver a borrador una factura que la DNIT ya tiene en curso o aprobada: se corrige con una nota de crédito o con el evento de cancelación. Y una vez emitido el CDC, el código de seguridad se conserva: volver a confirmar la factura no genera un CDC distinto para el mismo número. Reenviar un CDC que la DNIT ya conoce lo rechaza como duplicado, y puede terminar en el bloqueo del RUC emisor.
Si el rechazo se debe a un dato tuyo (un dato del receptor, un monto), corregís y reemitís. El catálogo de respuestas del módulo trae 350 códigos de SIFEN con su explicación.
Para el contador
¿Qué recibe mi contador?
Cada factura aprobada tiene su XML firmado y su KuDE en PDF, la representación gráfica del documento, descargables desde la propia factura. El resultado de la DNIT queda en el chatter con un ícono por categoría (éxito, pendiente, error, informativo), de modo que el historial de cada factura se lee sin salir de Odoo.
En la ficha del cliente, el botón «Consultar en el padrón» trae el nombre, el dígito verificador y el estado desde el padrón público de la DNIT, el mismo que usa la herramienta gratuita Consulta tu RUC. Los pagos tienen además un recibo en PDF que arma Odoo y que no es un documento fiscal.
Permisos y pruebas
¿Quién puede timbrar y cómo pruebo antes de pasar a producción?
El módulo trae tres perfiles de acceso. El Usuario prepara documentos y ve el estado SIFEN, pero no emite. El Emisor suma los botones «Timbrar» y «Anular» y las acciones masivas. El Administrador suma la configuración fiscal. Así separás quién carga las facturas de quién las envía a la DNIT.
Para probar, poné el ambiente de la compañía en prueba y usá una clave sk_test_: el gateway envía al ambiente de pruebas de la DNIT y nada de lo que emitas ahí tiene efecto fiscal. Cuando todo funciona, cambiás a producción con una clave sk_live_. El primer mes de ECAV SIFEN es gratis y no pide tarjeta.
API u Odoo
¿Cuándo conviene la API en lugar del módulo de Odoo?
Si tu sistema no es Odoo, o si otro sistema (un punto de venta, un e-commerce) tiene que emitir sin pasar por Odoo, usá la API SIFEN: es el mismo gateway que usa el módulo. Si todavía no usás Odoo y buscás un ERP completo, mirá ECAV ERP, el ERP Odoo con localización paraguaya. Y si no necesitás ERP, el portal permite emitir sin instalar nada.
Planes
¿Cuánto cuesta la facturación electrónica con ECAV en Odoo?
Los planes son los de ECAV SIFEN, por volumen mensual de comprobantes, con el primer mes gratis y sin tarjeta. Un documento rechazado por la DNIT no consume cuota. Hay más detalle en precios.
Más elegido
Pyme
Gs. 200.000
/mes
Hasta 500 comprobantes por mes
Gs. 2.000.000 por año (2 meses gratis)
Empresa
Gs. 300.000
/mes
Comprobantes ilimitados (uso razonable) · IVA incluido
Gs. 3.000.000 por año (2 meses gratis)
Uso razonable en Empresa: a partir de 3.000 comprobantes por mes te contactamos para asegurarte el mejor plan.
Preguntas frecuentes
Preguntas frecuentes sobre facturación electrónica en Odoo
¿Con qué versión de Odoo funciona?
Los módulos de ECAV para SIFEN son para Odoo 17.
¿Qué módulos intervienen?
La base l10n_einvoice y l10n_einvoice_py (localización paraguaya), ecav_sifen_client (el cliente SIFEN) y ecav_api_client (la conexión y las credenciales del gateway).
¿Tengo que instalar algo para firmar o para hablar con la DNIT?
No. El módulo solo arma el documento. La firma, el envío a la DNIT y la custodia del lote los hace el gateway de ECAV. El certificado lo cargás en la compañía de Odoo.
¿Qué pasa si la DNIT o el gateway no responden?
El documento queda en proceso y no se pierde: el cron de consulta lo vuelve a preguntar cada 10 minutos, y el gateway reintenta ante caídas de la DNIT.
¿Puedo anular una factura ya autorizada?
Sí, con el botón «Anular» y un motivo obligatorio. Se envía el evento de cancelación a SIFEN dentro del plazo que fija la DNIT.
¿Puedo probar sin emitir de verdad?
Sí. Con el ambiente en prueba y una clave sk_test_ el gateway usa el ambiente de pruebas de la DNIT, y el primer mes es gratis.
¿Cuánto cuesta?
Desde Gs. 100.000 por mes según el volumen de comprobantes, con el primer mes gratis. Ver los planes más arriba y en precios.