Empreenda
Gs. 100.000
/mês
Até 200 documentos por mês
Gs. 1.000.000 por ano (2 meses grátis)
ECAV SIFEN
Faturamento eletrônico no Odoo para o Paraguai: SIFEN sem sair do Odoo
Timbre a partir da fatura do Odoo e deixe a ECAV assinar, enviar e conciliar com a DNIT. Um módulo para Odoo 17 conectado ao gateway SIFEN da ECAV, o mesmo que os Odoo da própria ECAV já usam em produção.
ECAV SIFEN para Odoo
Visão rápida
17
versão do Odoo
Timbrar
botão na fatura
KuDE
automático na aprovação
Como funciona
Como funciona o faturamento eletrônico SIFEN no Odoo com a ECAV?
O Odoo não fala com a DNIT por conta própria. O módulo ecav_sifen_client monta o documento a partir da fatura, apoiado na localização paraguaia l10n_einvoice_py, envia ao gateway SIFEN da ECAV e aplica o resultado que volta. O gateway assina com o seu certificado, envia à DNIT e guarda o CDC, o XML assinado e o KuDE.
Para quem fatura, o fluxo é este:
- Você confirma a fatura no Odoo, como sempre.
- Com o perfil Emissor, toca em «Timbrar», ou o cron de emissão automática faz isso se você o ativou.
- O gateway aceita o documento e devolve um identificador: a emissão é assíncrona.
- O Odoo espera alguns segundos pelo resultado. Se ainda não chegou, um cron consulta a cada 10 minutos, e o gateway também pode avisar por webhook.
- A fatura fica com seu estado (Autorizado, Aprovado com observação, Rejeitado, Cancelado ou Erro) e o resultado é anotado no chatter.
Quando vários documentos são enviados juntos, vão em uma única solicitação para que o gateway os agrupe no mesmo lote do SIFEN.
Documentos
Quais documentos posso emitir a partir do Odoo?
- Faturas eletrônicas de venda.
- Notas de crédito eletrônicas, a partir das notas de crédito do Odoo.
- Autofaturas eletrônicas, a partir das faturas de fornecedor com esse tipo de documento.
- Notas de remessa eletrônicas, com o bloco de transporte: motivo do traslado, veículo e transportador.
Além de timbrar, no Odoo você pode cancelar um documento com o botão «Anular» e seu motivo, e emitir os demais eventos do SIFEN (inutilização, nominação, dados de transporte e eventos do receptor). Cada evento fica registrado com o seu resultado, porque um documento pode ter vários ao longo da vida.
O que hoje não cobrimos: o e-Kuatia'i, o regime simplificado da DNIT, e a fatura de exportação ou importação. Se não sabe se o e-Kuatia'i basta para você, explicamos na página do SIFEN.
Configuração
O que preciso configurar no Odoo?
Antes de timbrar você precisa ter resolvidos os requisitos da DNIT: certificado .p12, habilitação, timbrado e CSC. No Odoo eles são carregados assim:
- Certificado e CSC. O .p12, sua senha, o CSC e o ID do CSC vão na ficha fiscal da empresa. Só o grupo de administração do sistema os vê: nem o perfil Emissor tem acesso.
- Conexão com o gateway. A URL e a chave de API (
sk_test_ousk_live_) vão na página «ECAV API» da empresa. - Ambiente. Teste ou produção. Tem que coincidir com a chave: o gateway rejeita uma combinação incoerente.
- Webhooks. O botão «Sincronizar webhooks» traz o segredo com que o Odoo valida cada aviso assinado.
- Emissão automática. É opcional e vem desligada. Espera 15 minutos por padrão antes de emitir, para você poder corrigir, e não pega documentos com mais de 7 dias.
- Atividades econômicas. São sincronizadas a partir do gateway com um botão e um cron semanal.
O certificado vence, por isso um cron diário avisa antes de o .p12 caducar.
Rejeições e estados
O que acontece se a DNIT rejeitar uma fatura ou demorar a responder?
O estado da fatura no Odoo vem do estado que o gateway informa. O código do SIFEN só serve para descrever o que aconteceu, não para decidir o estado. Estes são os estados:
| Estado no Odoo | O que significa |
|---|---|
| Em processo | Enfileirado, ainda sem assinar. |
| Assinado | Já tem CDC e XML; falta o veredicto da DNIT. |
| Autorizado | Aprovado pelo SIFEN. Gera o KuDE. |
| Aprovado com observação | Válido, com uma observação da DNIT. Gera o KuDE. |
| Rejeitado | O SIFEN rejeitou; o chatter mostra o código e a explicação. |
| Cancelado | Anulado ou inutilizado. |
| Erro | Erro técnico, sem veredicto do SIFEN. |
Duas proteções evitam o erro mais caro, emitir duas vezes o mesmo número. O Odoo não deixa voltar a rascunho uma fatura que a DNIT já tem em andamento ou aprovada: corrige-se com uma nota de crédito ou com o evento de cancelamento. E, uma vez emitido o CDC, o código de segurança é mantido: confirmar a fatura de novo não gera um CDC diferente para o mesmo número. Reenviar um CDC que a DNIT já conhece o rejeita como duplicado e pode terminar no bloqueio do RUC emissor.
Se a rejeição se deve a um dado seu (um dado do receptor, um valor), você corrige e reemite. O catálogo de respostas do módulo traz 350 códigos do SIFEN com sua explicação.
Para o contador
O que o meu contador recebe?
Cada fatura aprovada tem seu XML assinado e seu KuDE em PDF, a representação gráfica do documento, baixáveis da própria fatura. O resultado da DNIT fica no chatter com um ícone por categoria (sucesso, pendente, erro, informativo), de modo que o histórico de cada fatura se lê sem sair do Odoo.
Na ficha do cliente, o botão «Consultar en el padrón» traz o nome, o dígito verificador e a situação a partir do cadastro público da DNIT, o mesmo da ferramenta gratuita Consulta de RUC. Os pagamentos também têm um recibo em PDF que o Odoo monta e que não é um documento fiscal.
Permissões e testes
Quem pode timbrar e como testo antes de ir para produção?
O módulo traz três perfis de acesso. O Usuário prepara documentos e vê o estado SIFEN, mas não emite. O Emissor acrescenta os botões «Timbrar» e «Anular» e as ações em massa. O Administrador acrescenta a configuração fiscal. Assim você separa quem lança as faturas de quem as envia à DNIT.
Para testar, coloque o ambiente da empresa em teste e use uma chave sk_test_: o gateway envia ao ambiente de testes da DNIT e nada do que você emitir ali tem efeito fiscal. Quando tudo funciona, você passa para produção com uma chave sk_live_. O primeiro mês do ECAV SIFEN é grátis e não pede cartão.
API ou Odoo
Quando a API convém mais do que o módulo do Odoo?
Se o seu sistema não é Odoo, ou se outro sistema (um PDV, um e-commerce) precisa emitir sem passar pelo Odoo, use a API SIFEN: é o mesmo gateway que o módulo usa. Se você ainda não usa Odoo e quer um ERP completo, veja o ECAV ERP, o ERP Odoo com localização paraguaia. E se não precisa de ERP, o portal permite emitir sem instalar nada.
Planos
Quanto custa o faturamento eletrônico com a ECAV no Odoo?
Os planos são os do ECAV SIFEN, por volume mensal de documentos, com o primeiro mês grátis e sem cartão. Um documento rejeitado pela DNIT não consome cota. Há mais detalhes em preços.
Mais escolhido
Pyme
Gs. 200.000
/mês
Até 500 documentos por mês
Gs. 2.000.000 por ano (2 meses grátis)
Empresa
Gs. 300.000
/mês
Documentos ilimitados (uso razoável) · IVA incluído
Gs. 3.000.000 por ano (2 meses grátis)
Uso razoável no Empresa: a partir de 3.000 documentos por mês entramos em contato para garantir o melhor plano.
Perguntas frequentes
Perguntas frequentes sobre faturamento eletrônico no Odoo
Com qual versão do Odoo funciona?
Os módulos da ECAV para o SIFEN são para o Odoo 17.
Quais módulos participam?
A base l10n_einvoice e l10n_einvoice_py (localização paraguaia), ecav_sifen_client (o cliente SIFEN) e ecav_api_client (a conexão e as credenciais do gateway).
Preciso instalar algo para assinar ou falar com a DNIT?
Não. O módulo só monta o documento. A assinatura, o envio à DNIT e a custódia do lote são feitos pelo gateway da ECAV. O certificado você carrega na empresa do Odoo.
O que acontece se a DNIT ou o gateway não responderem?
O documento fica em processo e não se perde: o cron de consulta pergunta de novo a cada 10 minutos, e o gateway tenta novamente quando a DNIT cai.
Posso cancelar uma fatura já autorizada?
Sim, com o botão «Anular» e um motivo obrigatório. O evento de cancelamento vai ao SIFEN dentro do prazo que a DNIT define.
Posso testar sem emitir de verdade?
Sim. Com o ambiente em teste e uma chave sk_test_, o gateway usa o ambiente de testes da DNIT, e o primeiro mês é grátis.
Quanto custa?
A partir de Gs. 100.000 por mês conforme o volume de documentos, com o primeiro mês grátis. Veja os planos acima e em preços.