Saltar para o conteúdo principal
Argentina ARCA Supplier Invoice Validation and Withholding Management

Como funciona por dentro o Argentina ARCA Supplier Invoice Validation no Odoo

O módulo acrescenta ao Odoo o menu ARCA Suppliers, com onze submenus que vão de Suppliers e Supplier Cache às matrizes de perceções e retenções, e ainda um menu Batch Import (RFE). Por baixo correm três ações agendadas: uma mensal que sincroniza a lista de exclusão de fornecedores (base APOC), outra a cada 5 minutos que volta a tentar as faturas de fornecedor que a ARCA não conseguiu validar e outra a cada hora que apaga os arquivos de dados pessoais cujo link de download expirou. Este glossário explica cada peça pelo seu nome literal para a encontrares no teu Odoo.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 4 de novembro de 2026

O essencial

Versões
Odoo 17, 18, 19 e 20
Verificado
no código do módulo, versão 20.0 · nas fontes indicadas no fim
Leitura
5 min

O que o módulo acrescenta ao teu Odoo

Depois de instalado, aparece uma entrada de menu raiz chamada ARCA Suppliers. Dela dependem Result Codes, Invoice Queue, Perception Matrix, Suppliers, Audit Log, Supplier Cache, Exclusion List, Overrides, Withholding Matrix, Configuration e Data Requests. À parte, sob o menu raiz ARCA Suppliers, está Batch Import (RFE).

A página no Odoo Apps organiza o que o módulo faz em seis secções: «Supplier check at ARCA», «APOC exclusion list», «Withholding and perception estimates», «Retries when ARCA is down», «Batch import of suppliers» e «Personal data requests». Os termos deste glossário estão agrupados por tema: primeiro os fornecedores, depois perceções, retenções e faturas, a seguir as ações agendadas e, no fim, os modelos de códigos de erro e relatórios.

Glossário: fornecedores e os seus dados

ARCA Suppliers › Suppliers
A lista de fornecedores do módulo, assente no modelo arca.supplier. Na captura, com um único registo, veem-se as colunas de CUIT, nome, categoria e estado, o botão New, a pesquisa e a paginação.
Unknown
O estado que o único fornecedor da captura mostra na coluna de estado de arca.supplier. É o valor que se lê nessa vista; para os restantes estados e a sua ordem, consulta a configuração inicial do módulo.
Lista de fornecedores ARCA com um único registo no estado Unknown, botão New, pesquisa e paginação
A lista de Suppliers com um só registo, no estado Unknown.
ARCA Suppliers › Supplier Cache
Menu sob ARCA Suppliers dedicado à cache de fornecedores. No percurso animado mais abaixo aparece a lista do modelo arca.supplier.cache com um registo: o fornecedor e o seu CUIT, os contadores de acertos e falhas (a zero nesse ecrã) e a data de criação da cache.
ARCA Suppliers › Exclusion List
Menu sob ARCA Suppliers com a lista de exclusão. A página dedica-lhe a secção «APOC exclusion list», e uma das ações agendadas sincroniza a lista de exclusão de fornecedores (base APOC).
Batch Import (RFE)
Menu que depende do menu raiz ARCA Suppliers. A página inclui uma secção intitulada «Batch import of suppliers».

Glossário: perceções, retenções e faturas

ARCA Suppliers › Perception Matrix
A matriz de perceções, assente no modelo arca.perception.matrix. A sua lista tem colunas de código, descrição, percentagem de perceção, código de província e tipo de transação.
Lista da matriz de perceções com cinco registos ativos e colunas de código, descrição, percentagem, província e tipo de transação
A Perception Matrix com cinco registos ativos, botão Novo e barra de pesquisa.
ARCA Suppliers › Withholding Matrix
Menu sob ARCA Suppliers com a matriz de retenções. Na página, o que diz respeito a retenções e perceções está na secção «Withholding and perception estimates».
ARCA Suppliers › Invoice Queue
Menu sob ARCA Suppliers com a fila de faturas. Na página, a secção «Retries when ARCA is down» trata das novas tentativas quando a ARCA não responde.

Completam o menu Result Codes, Audit Log, Overrides e Configuration. As definições a preencher em Configuration estão no artigo de configuração inicial.

Glossário: as ações agendadas

ARCA: sync supplier exclusion list (APOC base)
Ação ativa que corre todos os meses e sincroniza a lista de exclusão de fornecedores da base APOC.
ARCA: retry vendor bills ARCA could not validate
Ação ativa que corre a cada 5 minutos e volta a tentar as faturas de fornecedor que a ARCA não conseguiu validar.
ARCA: delete personal data archives whose download link expired
Ação ativa que corre a cada hora e apaga os arquivos de dados pessoais cujo link de download expirou. Junto a ela estão o menu Data Requests e a secção «Personal data requests» da página.

As três ações aparecem como ativas. Se uma não correr, verifica no Odoo se continua ativa antes de procurar a falha noutro lado.

Glossário: códigos de erro e relatórios

arca.error.code
Modelo «ARCA Error Code Mapping». A sua lista mostra código de erro, mensagem curta, mensagem detalhada, gravidade e se o erro admite nova tentativa. O significado de cada mensagem e o que fazer com ela estão no artigo de erros e avisos.
Lista de códigos de erro ARCA com quatro registos e colunas de código, mensagem curta, mensagem detalhada, gravidade e nova tentativa
A tabela de códigos de erro com quatro registos, botão New, pesquisa e paginação.
arca.compliance.report
Modelo «ARCA Monthly Compliance Report». As suas linhas guardam-se em arca.compliance.report.line, «ARCA Compliance Report Line».
Percurso por quatro listas: códigos de erro, matriz de perceções, fornecedores e cache de fornecedores
Dos códigos de erro à cache de fornecedores, passando pela Perception Matrix e por Suppliers.

O que acontece a cada tipo de registo

Com o que os menus e as ações mostram, o percurso lê-se assim. Um fornecedor está em Suppliers com o seu estado, e na vista de cache com os contadores de acertos e falhas. A lista de exclusão APOC é sincronizada uma vez por mês. Uma fatura de fornecedor que a ARCA não conseguiu validar é apanhada pela ação de nova tentativa a cada 5 minutos. Um arquivo de dados pessoais cujo link de download expirou é apagado pela ação horária. Os códigos de erro têm a sua própria tabela com gravidade e indicação de nova tentativa.

A parte que depende do serviço externo

A página avisa numa secção própria: «Before you buy: some features of this app use a paid external service». Este módulo usa o serviço local da FlexigoTech Cloud. O módulo custa 9 € sem IVA, pagamento único por versão, no Odoo Apps para Odoo 17, 18, 19 e 20, e o serviço custa 29 €/mês ou 290 €/ano sem IVA (Pro: 58 €/mês ou 580 €/ano). Sem subscrição, ou com o serviço suspenso, para o que a subscrição fornece e os dados ficam no teu Odoo. Com a subscrição, o módulo para novas versões do Odoo está incluído se o compraste em flexigotech.com; na Odoo App Store, cada versão compra-se lá. Se tens dúvidas sobre se te serve, lê o que cobre e o que não cobre.

Como a FlexigoTech te ajuda

A FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se queres ajuda para pôr este módulo a funcionar ou adaptá-lo ao teu fluxo de compras, tens os detalhes na página do módulo.

Continue a ler

Erros de Argentina ARCA Supplier Invoice Validation no Odoo e como resolvê-losMensagens de erro de Argentina ARCA Supplier Invoice Validation no Odoo: CUIT inválido, ARCA sem resposta, override e lotes. Quando surgem e o que fazer.Arranque do ARCA Supplier Invoice Validation no Odoo: checklist por fasesQue campos preencher na configuração ARCA, como ler o ticket WSAA, que estados o módulo define e o que rever no Odoo durante a primeira semana.Argentina ARCA Supplier Invoice Validation: serve ao seu Odoo? Um caso para decidirO que cobre e o que não cobre o módulo Argentina ARCA Supplier Invoice para Odoo 17 a 20, o que é preciso antes de o instalar e um caso fictício para decidir.
Verificado no código do módulo (versão 20.0) e nas fontes indicadas

Fontes