Odoo

A ligação ao Odoo no Tillor exporta clientes e faturas lançadas para o Odoo. Os relatórios de pagamentos para o Odoo chegam numa versão posterior; até lá, utilize o Admisol se quiser enviar automaticamente os relatórios de pagamentos.

InstalaçãoCopiar a ligação para esta secção

1. Aceda a Definições e abra o App Marketplace.
2. Procure o cartão Odoo e clique em Instalar.
3. Preencha primeiro, em Ligação:
   • URL do Odoo - por exemplo https://mijnbedrijf.odoo.com ou apenas mijnbedrijf (o Tillor completa então o URL .odoo.com)
   • Nome de utilizador - utilizador com acesso à API
   • Chave API - chave API (Odoo: perfil do utilizador > chaves API)
4. Clique em Continuar para a base de dados. O Tillor obtém as bases de dados disponíveis (ou permite-lhe introduzir o nome manualmente).
5. Escolha a base de dados em Base de dados e conclua a instalação.

Ao guardar, o Tillor testa a ligação.

Parâmetros de contabilidade (app Odoo)Copiar a ligação para esta secção

Após a instalação, defina os parâmetros de exportação em Definições na app Odoo (além do URL, da base de dados, do utilizador e da chave API). O Tillor obtém em direto, a partir do Odoo, os diários de vendas e as contas de proveitos; escolhe-os através de um campo de pesquisa (código e nome).

Para cada linha de fatura, o Tillor procura primeiro uma conta do Odoo com o mesmo código que o número de razão da linha; caso contrário, usa a conta de proveitos predefinida. Para o IVA, o Tillor procura no Odoo um IVA de vendas com a mesma percentagem que a da linha.

Regimes de IVACopiar a ligação para esta secção

Uma linha de fatura com um regime sem IVA, como a autoliquidação, precisa no Odoo de um IVA de vendas próprio: um 0% normal vai parar à grelha errada da sua declaração. Por isso, nas definições de exportação, introduza para cada regime que utiliza o nome do IVA de vendas no Odoo, exatamente como aparece no Odoo em Contabilidade > Configuração > Impostos (num Odoo belga, por exemplo, 0% EU S para serviços na UE). Existem cinco campos: autoliquidação (serviços na UE), autoliquidação (cocontratante), entrega intracomunitária, exportação para fora da UE e isento de IVA.

Se o campo de um regime estiver vazio ou o IVA não existir no Odoo, a exportação dessa fatura termina com uma mensagem de erro. Introduza o nome e envie a fatura novamente.

PDF da fatura no OdooCopiar a ligação para esta secção

Com Anexar PDF da fatura (ativado por predefinição), o Tillor carrega o mesmo PDF que existe no Tillor. Numa nova exportação, isso acontece antes do lançamento no Odoo, para que a pré-visualização possa ser associada à direita da fatura. O nome do ficheiro segue o número da fatura do Tillor (p. ex. INV_2026_0001.pdf). O Tillor define também esse PDF como anexo principal da fatura no Odoo.

Nos Eventos da fatura do Tillor pode ver se a exportação foi bem-sucedida, incluindo cliente, fatura, PDF e UBL.

• Se a fatura do Odoo já existir (mesma referência: o número da fatura do Tillor), o Tillor atualiza o cliente, as linhas, as datas e a referência de pagamento. Se a fatura já estava lançada no Odoo, o Tillor repõe-na primeiro como rascunho, ajusta os dados e volta a lançá-la quando Registar faturas automaticamente está ativado ou a fatura já estava lançada.
• Depois, os anexos PDF e UBL são substituídos ou adicionados, quando essas opções estão ativadas.
• Se o carregamento falhar após a criação de uma fatura em rascunho, essa fatura do Odoo é eliminada, para que uma exportação seguinte possa tentar de novo.

UBL Peppol no OdooCopiar a ligação para esta secção

Com Anexar UBL Peppol (ativado por predefinição), o Tillor carrega o UBL Peppol como anexo adicional da fatura no Odoo. O nome do ficheiro segue o número da fatura do Tillor (p. ex. INV_2026_0001.xml).

• O Tillor não gera UBL por si: o ficheiro só fica disponível após uma entrega Peppol bem-sucedida.
• Se o UBL ainda não estiver pronto no momento da exportação, o Tillor ignora o anexo UBL; assim que o UBL chegar, é colocado na fatura do Odoo já existente.
• Se o carregamento do UBL falhar, a exportação completa para o Odoo não falha (ao contrário do PDF). Apenas um erro de PDF após uma fatura nova reverte o rascunho do Odoo.

FaturasCopiar a ligação para esta secção

• Ao lançar ou relançar uma fatura, o Tillor exporta-a automaticamente para o Odoo.
• Manualmente: ações da fatura > exportar para a contabilidade (o mesmo botão que no Admisol).
• Apenas as faturas com o estado Lançada são exportadas.
• Se já existir uma fatura do Odoo com o mesmo número de fatura do Tillor, não é criada uma segunda fatura. O Tillor atualiza o cliente, as linhas e as datas nessa fatura (por exemplo, após a mudança para outro cliente ou um relançamento) e substitui os anexos PDF/UBL quando essas opções estão ativadas.
• Se o PDF da fatura mudar após um pagamento (ou outro montante no documento), o Tillor substitui o anexo PDF existente no Odoo assim que o novo PDF estiver pronto. Não surge uma segunda fatura no Odoo e nenhum pagamento é lançado no Odoo.

ClientesCopiar a ligação para esta secção

Os clientes são atualizados ou criados no Odoo com o número de cliente do Tillor como referência. Os parceiros existentes com o mesmo número são atualizados.

Relatórios de pagamentosCopiar a ligação para esta secção

O envio automático e manual de relatórios de pagamentos para o Odoo ainda não está disponível. O processo diário de relatórios de pagamentos ignora o Odoo sem mensagem de erro.

Requisitos no OdooCopiar a ligação para esta secção

• Diário de vendas com o código definido (por predefinição INV)
• Contas de razão com códigos que correspondam às linhas do Tillor ou à conta de proveitos predefinida
• Opcional: taxas de IVA de vendas no Odoo com as mesmas percentagens que no Tillor

Ver tambémCopiar a ligação para esta secção