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

Arranque do ARCA Supplier Invoice Validation no Odoo: checklist por fases

Para pôr a funcionar o Argentina ARCA Supplier Invoice Validation and Withholding Management precisa de três coisas antes de mexer no Odoo: um certificado .p12 ou .pfx, a respetiva palavra-passe e o CUIT titular desse certificado. Com isso preenche a configuração, verifica os campos do ticket WSAA e, durante a primeira semana, revê as matrizes de retenções e perceções, os códigos de erro e os estados dos fornecedores. Aqui tem cada fase em caixas para ir assinalando.

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

Antes de instalar: versão, certificado e onde comprar

O módulo está publicado no Odoo Apps para 17.0, 18.0, 19.0 e 20.0. No Odoo Apps custa 9 € por versão do Odoo, pagamento único e sem IVA, para 17, 18, 19 e 20; o serviço local da FlexigoTech Cloud é à parte, a 29 €/mês ou 290 €/ano sem IVA (Pro: 58 €/mês ou 580 €/ano).

  • Confirme que o seu Odoo é 17, 18, 19 ou 20: são as versões com ficha publicada.
  • Tenha o certificado em formato .p12 ou .pfx. Se tiver a chave privada e o certificado em ficheiros separados, a ajuda do próprio campo indica o comando: openssl pkcs12 -export -inkey private.key -in certificate.crt -out arca.p12.
  • Tenha à mão a palavra-passe desse ficheiro.
  • Identifique o CUIT titular do certificado: é o que vai em Company CUIT.
  • Decida onde compra: com a subscrição, o módulo para as novas versões do Odoo está incluído se o comprou em flexigotech.com; na Odoo App Store, cada versão do Odoo compra-se lá.

Se ainda não tem a certeza de que o módulo cobre o que procura, antes desta checklist leia se se adequa à sua empresa.

Ao criar a configuração: os campos a preencher

A configuração é um registo com poucos campos. Estes são os que deve rever ao criá-la:

  • Configuration Name: um nome para reconhecer a configuração.
  • company_id: a empresa do Odoo (campo ligado a res.company).
  • Company CUIT (represented_cuit): segundo a ajuda do campo, é o CUIT em nome do qual se consulta o padrão (cuitRepresentada), o CUIT que detém o certificado.
  • PKCS#12 Certificate: carregue o ficheiro .p12 ou .pfx. Ao lado está Certificate Filename, com o nome do ficheiro.
  • Certificate Password: introduza a palavra-passe do certificado.
  • Certificate Expiry Date: verifique a data de validade do certificado.

A palavra-passe é guardada cifrada, no campo Certificate Password (Encrypted). Quando volta a editar a configuração, se deixar Certificate Password vazio mantém-se a atual. A caixa Password Set indica se existe uma palavra-passe guardada.

Os campos do ticket WSAA: o que ver depois de configurar

Na mesma configuração há um grupo de campos sobre o ticket WSAA que vale a pena ler:

  • WSAA Token (Encrypted) e WSAA Sign (Encrypted): o token e a assinatura, guardados cifrados.
  • Last Ticket Request: a data e hora do último pedido de ticket.
  • Last Ticket Request Error: se tiver texto, é o erro do último pedido. Para o interpretar, consulte as mensagens de erro do módulo.
  • Ticket Valid Until: até quando o ticket é válido.
  • Ticket Expired: a caixa que indica se o ticket expirou.
  • Configured: a caixa que indica se a configuração consta como configurada.

Os estados que vai ver nas listas

O módulo define vários campos de estado. Convém que quem revê faturas e fornecedores reconheça estas etiquetas:

  • Um campo state com Draft, Finalized e Submitted to ARCA.
  • Outro state com Queued, Retry Success, Retry Failed e Escalated to Manual Review.
  • Um campo status com Active (Activo), Suspended (Suspendido), Canceled (Cancelado), Not Registered (No registrado) e Unknown.
  • Outro status com Suspended, Cancelled, Not Registered, AFIP Debtor, Flagged e Apocryphal invoices (ARCA APOC base).
  • Um state com New, Verifying Identity, Gathering Data, Redacting Sensitive Info, Completed e Rejected.
  • Um campo verification_status com Pending, Verified e Failed.
  • Um state com Upload, Validating, Results e Error.

Que registo usa cada um e como passa de um valor para outro é explicado no artigo sobre como o módulo funciona por dentro.

  • Reveja estas etiquetas com a sua equipa antes de começar a trabalhar com fornecedores reais.
  • Combinem quem revê os registos em Escalated to Manual Review e os que tenham status em AFIP Debtor, Flagged ou Apocryphal invoices (ARCA APOC base).
Percurso pela lista de códigos de erro, pela matriz de perceções, pela lista de fornecedores ARCA e pela cache de fornecedores
Da lista de códigos de erro à cache de fornecedores: o único fornecedor da lista aparece com estado Unknown e a cache com os contadores de acertos e falhas a zero

A primeira semana: o que rever

Com a configuração feita, é altura de rever as tabelas que o módulo traz e os primeiros registos.

  • Abra a matriz de retenções (arca.withholding.matrix) e reveja cada linha: código, descrição, percentagem de retenção, categorias aplicáveis, caixa de ativo e notas.
  • Abra a matriz de perceções (arca.perception.matrix) e verifique código, descrição, percentagem de perceção, código de província e tipo de transação.
  • Reveja a lista de códigos de erro (arca.error.code): veja a severidade de cada um e se está marcado como repetível.
  • Na lista de fornecedores (arca.supplier), veja o estado de cada fornecedor e localize os que estão em Unknown.
  • Na cache de fornecedores (arca.supplier.cache), dê uma vista de olhos aos contadores de acertos e falhas.
  • Volte em vários dias a Ticket Valid Until, Ticket Expired e Last Ticket Request Error na configuração.
  • Anote no calendário a Certificate Expiry Date.
Lista da matriz de retenções com seis linhas e colunas de código, descrição, percentagem de retenção, categorias aplicáveis, ativo e notas
A matriz de retenções (arca.withholding.matrix), com seis linhas
Lista da matriz de perceções com cinco registos ativos e colunas de código, descrição, percentagem, código de província e tipo de transação
A matriz de perceções (arca.perception.matrix), com cinco registos ativos
Lista de códigos de erro com quatro registos e colunas de código, mensagem curta, mensagem detalhada, severidade e repetível
Os códigos de erro (arca.error.code), com quatro registos

Se a subscrição parar

O módulo trabalha com um serviço local da FlexigoTech Cloud. Sem subscrição, ou com o serviço suspenso, para aquilo que a subscrição fornece; os dados ficam no seu Odoo.

  • Reveja a data de renovação da subscrição juntamente com a validade do certificado.

Como a FlexigoTech pode ajudar

A FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se quiser que façamos consigo este arranque, ou precisar de adaptar o módulo à sua forma de trabalhar com fornecedores, contacte-nos a partir da página do módulo.

Continue a ler

Como funciona por dentro o Argentina ARCA Supplier Invoice Validation no OdooGlossário de menus, ações agendadas e dados do módulo Argentina ARCA Supplier Invoice Validation and Withholding Management para Odoo.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.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