Conector Odoo

Conectar o Odoo faz a Notavia emitir a NF-e das suas faturas de cliente. Você continua faturando no Odoo como sempre; a Notavia lê a fatura lançada, calcula os impostos pela sua matriz de impostos, emite a NF-e na SEFAZ e devolve o XML e o DANFE anexados à própria fatura, com a chave de acesso no histórico dela.

A tela fica em Administração → Integração → Conectores ERP. O conector está em piloto: se o bloco não aparece para você, fale com o suporte para liberá-lo na sua conta.

O que precisa estar pronto no Odoo

1. Acesso à API. No Odoo Online, a API externa só vem no plano Custom (não está nos planos One App Free e Standard). No Odoo.sh e em instalação própria ela já vem liberada.

2. App Faturamento (ou Contabilidade) instalado. A nota nasce das faturas de cliente; notas de crédito viram NF-e de devolução.

3. Um usuário só para a integração, com acesso ao Faturamento e uma única empresa ativa (a do CNPJ que emite). Um usuário exclusivo facilita revogar o acesso sem afetar ninguém.

4. Uma chave de API desse usuário. Entre com ele e vá em Preferências → Segurança da conta → Nova chave de API. Dê um nome (ex.: "Notavia") e copie a chave: ela aparece uma única vez.

⚠️ No Odoo 19 a chave de API vale no máximo 3 meses. Quando ela vence, a conexão para e os Admins da conta recebem um e-mail. Gere uma chave nova e use Conectar ERP de novo, com a mesma URL e o mesmo banco: a conexão é reaproveitada e as faturas do período são lidas assim que ela volta.

5. Nenhum outro módulo emitindo NF-e. Se o Odoo já emite NF-e (localização brasileira com Avalara, por exemplo), desligue essa emissão antes: senão a mesma venda sai em duas notas.

O cadastro que a nota usa

A Notavia não copia o cadastro do Odoo inteiro: cada fatura traz o cliente e os itens, e o produto é reconhecido pelo código.

• Produtos: a Referência interna do produto no Odoo precisa ser igual ao código do produto na Notavia, e o produto na Notavia precisa ter NCM. O jeito mais rápido é exportar os produtos do Odoo para planilha e importá-los na Notavia.
• Clientes: o contato da fatura precisa de CNPJ ou CPF (campo NIF/CNPJ) e de endereço completo: rua, bairro, cidade, estado e CEP. O número pode vir no campo próprio da localização brasileira ou no fim da rua ("Rua das Flores, 123"); sem número, a nota sai com "S/N". Sem o campo de bairro da localização brasileira, o bairro é lido da 2ª linha do endereço. O cliente é criado ou atualizado na Notavia automaticamente na emissão.
• Empresa: a nota usa o contato da empresa (parceiro comercial) da fatura: fatura para "Empresa X, João" sai no CNPJ da Empresa X.

Quando falta algum desses dados, a fatura aparece na aba Documentos como Pendência no ERP, dizendo exatamente o que corrigir. Corrija no Odoo: a Notavia relê a fatura na próxima varredura.

Conectar

1. Em Conectores ERP, clique em Conectar ERP → Odoo.
2. Preencha a URL (ex.: https://suaempresa.odoo.com — pode colar o endereço do navegador), o banco (no Odoo Online, o nome antes de .odoo.com), o usuário de integração e a chave de API.
3. Em Configurar, escolha o emitente, a operação fiscal padrão (a venda) e, se você emite notas de crédito, a operação de devolução.

A conexão lê as faturas lançadas a partir do momento em que foi feita: faturas antigas não são puxadas (elas já tiveram nota por outro caminho).

Como a emissão acontece

• Gatilho: quando a fatura é lançada (padrão), quando é paga, ou só manual.
• Assistida (padrão): a fatura aparece em Documentos como Pronto para emitir e você emite com um clique (um a um ou Emitir pendentes). Recomendado no começo, para conferir as primeiras.
• Automática: marque Emitir automaticamente e a nota sai sozinha.
• A varredura acontece a cada 5 minutos.
• Teste primeiro com o emitente em homologação (ambiente de testes da SEFAZ, sem valor fiscal).

Cancelamento e devolução

• Fatura cancelada no Odoo: com Cancelar a NF-e quando o documento for cancelado marcado, a Notavia cancela a NF-e automaticamente (a SEFAZ aceita o cancelamento só dentro do prazo, em geral 24 horas). Sem a opção, a fatura fica marcada e você cancela a nota pelo portal.
• Nota de crédito: vira NF-e de devolução referenciando a NF-e da venda original, desde que a venda tenha sido emitida pela Notavia e a nota de crédito tenha sido criada a partir da fatura (botão Nota de crédito do Odoo). Os itens precisam ser os mesmos produtos da venda.

Odoo na rede interna da empresa

Se o seu Odoo não é acessível pela internet, escolha Conectividade: via agente ao conectar e use Parear agente para gerar o token do agente Notavia, um programa leve instalado num computador da sua rede que só faz conexões de saída (nenhuma porta aberta no firewall). Fale com o suporte para instalar o agente.