O erro «Não foi possível listar os documentos da Scrive: …» no Odoo, passo a passo

Quando surge exatamente

Surge ao clicar em Importar do arquivo Scrive, o botão da ficha da conta da Scrive. Chegas a essa ficha a partir do menu Scrive › Configuração › Contas (Scrive › Configuration › Accounts). O primeiro nível Scrive pede a permissão Utilizador (User) e o nível Configuração (Configuration) pede Gestor (Manager): se não tiveres uma das duas, não vês esse nível. O botão vê-se sempre no Odoo 17, 18, 19 e 20, e a mensagem está no código publicado dessas quatro versões.

No Odoo 20.0, a ação faz isto, por ordem:

• Verifica que tens permissão de gestor da Scrive para a executar.
• Pede à Scrive a lista de documentos da conta, página a página, com estes filtros: sem modelos, sem os do lixo, apenas aqueles de que a conta é autora e um filtro de estado que nomeia todos os estados (assim aparecem também os documentos pendentes de arrancar, que sem esse filtro a lista não devolve).
• Deixa de pedir páginas quando uma chega vazia ou sem nenhum documento novo, ou quando se esgota o limite de páginas de uma única importação.
• Se a Scrive devolver um erro ao consultar a lista, a ação pára e lança Não foi possível listar os documentos da Scrive: ….
• Só se nenhuma consulta da lista falhar, começa a criar ou atualizar documentos no Odoo. Se o limite de páginas se esgotou, importa os documentos lidos até aí e avisa com O arquivo é maior do que uma única importação consegue processar — execute «Importar do arquivo Scrive» novamente para continuar.

A consequência prática: com a mensagem Não foi possível listar os documentos da Scrive: … no ecrã, nada foi importado nem atualizado nesse clique, porque a falha ocorre antes de percorrer qualquer documento.

O que significa o que vem depois dos dois pontos

As reticências da mensagem são um valor: o módulo cola aí o texto do erro ocorrido ao consultar a lista na Scrive. A mensagem em si só diz que não foi possível ler a lista; o motivo concreto está nessa parte final, por isso copia-a inteira antes de fechar o aviso.

O mesmo texto, com o Odoo noutros idiomas, vê-se assim:

Caso ilustrativo: uma importação que se interrompe

Exemplo Caso ilustrativo: a empresa e os seus dados são inventados para explicar o fluxo.

A Maderas Ribera é uma carpintaria inventada que já usa o Scrive Connector. A Marta, que tem a permissão de gestor, entra em Scrive › Configuração › Contas, abre a conta da empresa e clica em Importar do arquivo Scrive para trazer para o Odoo os documentos que foram criados diretamente na Scrive.

No ecrã aparece Não foi possível listar os documentos da Scrive: …, com um texto depois dos dois pontos. A Marta tira duas conclusões do comportamento do módulo:

• Nada foi importado a meio: a falha ocorreu ao ler a lista, antes de criar ou atualizar qualquer documento.
• O texto depois dos dois pontos é o detalhe da falha ao consultar a Scrive, pelo que é o que há a guardar para diagnosticar.

A Marta volta a clicar no botão. Se já havia documentos dessa conta importados antes, a ação atualiza-os em vez de os criar de novo. Se desta vez a lista for lida, a importação continua com os documentos. Se a mensagem surgir outra vez, a Marta guarda também esse texto e envia-o à FlexigoTech juntamente com o primeiro.

O que fazer, passo a passo

1. Copia a mensagem completa, incluindo o que vem depois dos dois pontos.
2. Volta a clicar em Importar do arquivo Scrive na ficha da conta.
3. Se surgir outra vez, guarda também esse texto.
4. Escreve-nos com as mensagens completas, o nome da conta e a versão do Odoo.
5. Quando o erro desaparecer, volta a lançar a importação e verifica que já não se interrompe com esta mensagem.

Outras mensagens do módulo têm o seu próprio guia, por exemplo a dos callbacks.

O que esta mensagem não cobre

Este erro só protege a leitura da lista. Depois de lida, cada documento é importado em separado e um problema com um em concreto não pára os restantes nem provoca esta mensagem.

Custo do módulo e como a FlexigoTech te ajuda

O Scrive Connector é um módulo de pagamento único por versão do Odoo (o valor de cada versão está na ficha) e precisa da subscrição do FlexigoTech Cloud, plano Conector: 49 €/mês ou 490 €/ano sem IVA, até três 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. Sem subscrição, ou com o serviço suspenso, pára o que a subscrição dá, e os dados ficam no teu Odoo. Podes ver o módulo na sua página.

A FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se o texto depois dos dois pontos não te levar a lado nenhum, envia-no-lo tal como está.

Continue a ler

Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes

• Código do módulo: flexigobe_scrive_connector 20.0 (21b3b940): models/scrive_account.py
• Código do módulo: flexigobe_scrive_connector 20.0 (21b3b940): views/scrive_account_views.xml
• apps.odoo.com/apps/modules/20.0/flexigobe_scrive_connector
• flexigotech.com/en/services.html
• flexigotech.com/precios.html