O que faz a tarefa em cada passagem

Que tarefa é esta e de quanto em quanto tempo corre?
É a tarefa agendada Octopia: obter finanças (operações, pagamentos, faturas, DAC7) (Octopia: pull finance (operations, payouts, invoices, DAC7)). Corre uma vez por dia e vem ativa ao instalar o módulo. Existe no Odoo 17, 18, 19 e 20; no Odoo 17 leva o valor que a repete sem fim. No Odoo 20, a tarefa segue os passos e a ordem descritos a seguir.

Sobre que contas trabalha e onde as vejo?
Apenas sobre as contas Octopia ligadas. As fichas abrem-se em Octopia › Configuração › Contas (Octopia › Configuration › Accounts). Consoante as tuas permissões, vês uns troços do menu ou outros: Contas exige Administrador Octopia (Octopia Admin), Configuração exige Gestor Octopia (Octopia Manager) e Octopia exige Utilizador Octopia (Octopia User); se não tiveres um deles, não vês esse troço.
Por que ordem descarrega?
Conta a conta: primeiro as operações, depois os pagamentos, a seguir as faturas novas e, no fim, os relatórios DAC7. Se um passo de uma conta falhar por completo, os que faltavam para essa conta não se executam nessa passagem. Nos relatórios DAC7, a tarefa pede a lista de relatórios da conta e, por cada um com identificador, cria-o ou atualiza-o com canal de venda, nome do canal, referência do relatório, código de país e ano de validade.
Que período pede e como evita duplicados?
Operações: pede-as por data de alteração, desde a última data guardada menos 30 minutos (uma pequena sobreposição) até ao momento da passagem; sem data guardada, recua 90 dias. A nova marca é a data de alteração mais recente que viu, não a hora da passagem. Se uma operação já existe (mesma referência, mesmos tipos de evento e mesma data de criação), atualiza-a em vez de a duplicar. Pagamentos: pede-os por data de pagamento, desde o último guardado menos 2 dias, ou 365 dias atrás se não houver marca; como não trazem identificador, considera o mesmo pagamento o que coincide em data de pagamento, canal de venda e montante total. O que não se consegue guardar é ignorado e fica anotado no log do servidor.
Que verificação faz ao terminar as operações?
Se a Octopia indicar o total da janela, se tiver sido importado algo e esse total diferir em mais de um cêntimo da soma do que foi importado, a tarefa marca o resultado como erro, com um aviso de possível desfasamento de paginação que aconselha a descarregar de novo.

Faturas de comissão e faturas de fornecedor
O que faz com as faturas de comissão?
Depois das operações e dos pagamentos, a tarefa olha para as referências de fatura que trazem as operações da conta. Por cada referência que ainda não tem ficha de fatura no Odoo, cria uma. A cada fatura nova descarrega as linhas de detalhe (se já tivesse linhas, apaga-as e volta a criá-las) e o PDF, que guarda como anexo da fatura quando a Octopia devolve conteúdo. As faturas que já existiam não entram nesta parte da passagem.
Quando cria a fatura de fornecedor e como fica?
Só se estiver marcada a caixa Criar automaticamente faturas de fornecedor de comissões (Auto-create Commission Vendor Bills), na ficha de Contas Octopia (Octopia Accounts), separador Automatização (Automation), grupo Contabilidade (Accounting). A sua ajuda diz: Criar um rascunho de fatura de fornecedor para cada fatura de comissão Octopia importada pela sincronização financeira. A tarefa aplica-a às faturas novas dessa passagem, logo depois de descarregar o seu detalhe e o seu PDF. Se a fatura já tinha fatura de fornecedor associada, não cria outra; se não tinha linhas, descarrega-as antes. Os sinais mantêm-se: as linhas de devolução ou abatimento chegam em negativo e subtraem, e se o total líquido ficar negativo cria-se uma nota de crédito de fornecedor em vez de uma fatura. A referência é Fatura de comissão Octopia … (Octopia commission invoice …) seguida da referência da fatura da Octopia.
Se não faz nada
Porque pode não fazer nada com uma conta?
A tarefa não faz nada com uma conta nestes casos: a conta não está ligada, pelo que nem entra na tarefa; ou a conta passa pelo FlexigoTech Cloud e não tem lá guardadas as credenciais, ou não há serviço segundo a permissão guardada. Nesse caso a tarefa não chama a Octopia com essa conta e passa à seguinte. Essa verificação faz-se sem rede e não afeta as contas com ligação direta. Se o serviço for pausado a meio de uma passagem, a tarefa não marca nada, ao FlexigoTech Cloud só chega o código da pausa e a execução seguinte continua. Sem subscrição, ou com o serviço suspenso, pára o que a subscrição dá; os dados ficam no teu Odoo.
O que acontece se uma conta falhar e o que reviso?
O erro fica no log do servidor do Odoo com o identificador da conta e a tarefa segue com a conta seguinte. Na que falhou, os passos posteriores à falha não se executam nessa passagem; a tarefa volta a correr na sua execução diária seguinte. O que ver: que a conta esteja ligada, que tenha credenciais e serviço se passar pelo FlexigoTech Cloud, que a caixa de faturas de fornecedor esteja marcada se esperavas rascunhos, que as tuas permissões te deixem ver o menu de contas e, se houver uma falha de descarga, o log do servidor.
Que versões, quanto custa e quem me pode ajudar?
O módulo é de pagamento único por versão do Odoo e precisa da subscrição do FlexigoTech Cloud (plano Conector). Está publicado no Odoo Apps para 17, 18, 19 e 20 (consulta a ficha do Odoo Apps). No Odoo App Store, cada versão do Odoo compra-se lá. O plano Conector custa 49 €/mês ou 490 €/ano sem IVA, com até 3 contas da plataforma. A ligação passa pelo FlexigoTech Cloud, que guarda cifradas as credenciais, vigia a sincronização e avisa por e-mail se falhar. Se precisares de implementar o Odoo ou uma integração à medida, a FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida.
Continue a ler
Verificado no código do conector (versão 17.0 e 20.0) e nas fontes indicadas
Fontes
- Código do módulo: flexigobe_octopia_connector 20.0 (4848da6a): data/octopia_cron_data.xml
- Código do módulo: flexigobe_octopia_connector 17.0 (c53d3736): data/octopia_cron_data.xml
- Código do módulo: flexigobe_octopia_connector 20.0 (4848da6a): models/octopia_finance.py
- Código do módulo: flexigobe_octopia_connector 20.0 (4848da6a): models/octopia_account.py
- apps.odoo.com/apps/modules/20.0/flexigobe_octopia_connector
- flexigotech.com/precios.html
- flexigotech.com/en/services.html
