Salta al contingut principal
Argentina ARCA Supplier Invoice Validation and Withholding Management

Posada en marxa d'ARCA Supplier Invoice Validation a Odoo: checklist per fases

Per posar en marxa Argentina ARCA Supplier Invoice Validation and Withholding Management necessites tres coses abans de tocar Odoo: un certificat .p12 o .pfx, la seva contrasenya i el CUIT titular d'aquest certificat. Amb això omples la configuració, comproves els camps del tiquet WSAA i, durant la primera setmana, repasses les matrius de retencions i percepcions, els codis d'error i els estats dels proveïdors. Aquí tens cada fase en caselles per anar marcant.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 4 de novembre de 2026

L'essencial

Versions
Odoo 17, 18, 19 i 20
Comprovat
al codi del mòdul, versió 20.0 · a les fonts enllaçades al final
Lectura
5 min

Abans d'instal·lar: versió, certificat i on el compres

El mòdul està publicat a Odoo Apps per a 17.0, 18.0, 19.0 i 20.0. A Odoo Apps costa 9 € per versió d'Odoo, pagament únic i sense IVA, per a 17, 18, 19 i 20; el servei local de FlexigoTech Cloud va a part, a 29 €/mes o 290 €/any sense IVA (Pro: 58 €/mes o 580 €/any).

  • Comprova que el teu Odoo és 17, 18, 19 o 20: són les versions amb fitxa publicada.
  • Tingues el certificat en format .p12 o .pfx. Si tens la clau privada i el certificat en fitxers separats, l'ajuda del mateix camp indica l'ordre: openssl pkcs12 -export -inkey private.key -in certificate.crt -out arca.p12.
  • Tingues a mà la contrasenya d'aquest fitxer.
  • Identifica el CUIT titular del certificat: és el que anirà a Company CUIT.
  • Decideix on compres: amb la subscripció, el mòdul per a les versions noves d'Odoo hi va inclòs si el vas comprar a flexigotech.com; a l'Odoo App Store, cada versió d'Odoo es compra allà.

Si encara no tens clar si el mòdul cobreix el que busques, abans d'aquest checklist llegeix si encaixa a la teva empresa.

En crear la configuració: els camps que has d'omplir

La configuració és un registre amb pocs camps. Aquests són els que has de revisar en crear-la:

  • Configuration Name: un nom per reconèixer la configuració.
  • company_id: l'empresa d'Odoo (camp lligat a res.company).
  • Company CUIT (represented_cuit): segons l'ajuda del camp, és el CUIT en nom del qual es consulta el padró (cuitRepresentada), el CUIT que té el certificat.
  • PKCS#12 Certificate: puja el fitxer .p12 o .pfx. Al costat hi ha Certificate Filename, amb el nom del fitxer.
  • Certificate Password: escriu la contrasenya del certificat.
  • Certificate Expiry Date: comprova la data de caducitat del certificat.

La contrasenya es desa xifrada, al camp Certificate Password (Encrypted). Quan tornes a editar la configuració, si deixes Certificate Password buit es manté l'actual. La casella Password Set et diu si hi ha una contrasenya desada.

Els camps del tiquet WSAA: què mirar després de configurar

A la mateixa configuració hi ha un grup de camps sobre el tiquet WSAA que val la pena llegir:

  • WSAA Token (Encrypted) i WSAA Sign (Encrypted): el token i la signatura, desats xifrats.
  • Last Ticket Request: la data i hora de l'última petició de tiquet.
  • Last Ticket Request Error: si té text, és l'error de l'última petició. Per interpretar-lo, tens els missatges d'error del mòdul.
  • Ticket Valid Until: fins quan és vàlid el tiquet.
  • Ticket Expired: la casella que marca si el tiquet ha caducat.
  • Configured: la casella que indica si la configuració consta com a configurada.

Els estats que veuràs a les llistes

El mòdul defineix diversos camps d'estat. Convé que qui revisi factures i proveïdors reconegui aquestes etiquetes:

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

Quin registre fa servir cadascun i com passa d'un valor a un altre ho explica l'article sobre com funciona el mòdul per dins.

  • Repassa aquestes etiquetes amb el teu equip abans de començar a treballar amb proveïdors reals.
  • Acordeu qui revisa els registres en Escalated to Manual Review i els que tinguin status en AFIP Debtor, Flagged o Apocryphal invoices (ARCA APOC base).
Recorregut per la llista de codis d'error, la matriu de percepcions, la llista de proveïdors ARCA i la memòria cau de proveïdors
De la llista de codis d'error a la memòria cau de proveïdors: l'únic proveïdor de la llista apareix amb estat Unknown i la memòria cau amb els comptadors d'encerts i errors a zero

La primera setmana: què revisar

Amb la configuració feta, toca repassar les taules que porta el mòdul i els primers registres.

  • Obre la matriu de retencions (arca.withholding.matrix) i revisa cada fila: codi, descripció, percentatge de retenció, categories aplicables, casella d'actiu i notes.
  • Obre la matriu de percepcions (arca.perception.matrix) i comprova codi, descripció, percentatge de percepció, codi de província i tipus de transacció.
  • Revisa la llista de codis d'error (arca.error.code): mira la severitat de cadascun i si està marcat com a reintentable.
  • A la llista de proveïdors (arca.supplier), mira quin estat té cada proveïdor i localitza els que estiguin en Unknown.
  • A la memòria cau de proveïdors (arca.supplier.cache), fes un cop d'ull als comptadors d'encerts i errors.
  • Torna diversos dies a Ticket Valid Until, Ticket Expired i Last Ticket Request Error a la configuració.
  • Apunta al calendari la Certificate Expiry Date.
Llista de la matriu de retencions amb sis files i columnes de codi, descripció, percentatge de retenció, categories aplicables, actiu i notes
La matriu de retencions (arca.withholding.matrix), amb sis files
Llista de la matriu de percepcions amb cinc registres actius i columnes de codi, descripció, percentatge, codi de província i tipus de transacció
La matriu de percepcions (arca.perception.matrix), amb cinc registres actius
Llista de codis d'error amb quatre registres i columnes de codi, missatge curt, missatge detallat, severitat i reintentable
Els codis d'error (arca.error.code), amb quatre registres

Si la subscripció s'atura

El mòdul treballa amb un servei local de FlexigoTech Cloud. Sense subscripció, o amb el servei suspès, s'atura el que dona la subscripció; les dades es queden al teu Odoo.

  • Revisa la data de renovació de la subscripció juntament amb la caducitat del certificat.

Com t'ajuda FlexigoTech

FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida. Si vols que fem amb tu aquesta posada en marxa, o necessites adaptar el mòdul a la teva manera de treballar amb proveïdors, escriu-nos des de la pàgina del mòdul.

Continua llegint

Com funciona Argentina ARCA Supplier Invoice Validation a Odoo per dinsGlossari de menús, tasques programades i dades del mòdul Argentina ARCA Supplier Invoice Validation and Withholding Management per a Odoo.Errors d'Argentina ARCA Supplier Invoice Validation a Odoo i com resoldre'lsMissatges d'error d'Argentina ARCA Supplier Invoice Validation a Odoo: CUIT no vàlid, ARCA sense resposta, override i lots. Quan surten i què fer.Argentina ARCA Supplier Invoice Validation: encaixa al teu Odoo? Un cas per decidirQuè cobreix i què no el mòdul Argentina ARCA Supplier Invoice per a Odoo 17 a 20, què cal abans d'instal·lar-lo i un cas inventat per decidir.
Comprovat al codi del mòdul (versió 20.0) i a les fonts enllaçades

Fonts