Saltar al contenido principal
Argentina ARCA Supplier Invoice Validation and Withholding Management

Puesta en marcha de ARCA Supplier Invoice Validation en Odoo: checklist por fases

Para poner en marcha Argentina ARCA Supplier Invoice Validation and Withholding Management necesitas tres cosas antes de tocar Odoo: un certificado .p12 o .pfx, su contraseña y el CUIT titular de ese certificado. Con eso rellenas la configuración, compruebas los campos del ticket WSAA y, durante la primera semana, repasas las matrices de retenciones y percepciones, los códigos de error y los estados de proveedores. Aquí tienes cada fase como casillas para ir marcando.

FlexigoTech · Responsable: Víctor Gómez · Actualizado el 4 de noviembre de 2026

Lo esencial

Versiones
Odoo 17, 18, 19 y 20
Comprobado
en el código del módulo, versión 20.0 · en las fuentes enlazadas al final
Lectura
5 min

Antes de instalar: versión, certificado y dónde lo compras

El módulo está publicado en Odoo Apps para 17.0, 18.0, 19.0 y 20.0. En Odoo Apps cuesta 9 € por versión de Odoo, pago único y sin IVA, para 17, 18, 19 y 20; el servicio local de FlexigoTech Cloud va aparte, a 29 €/mes o 290 €/año sin IVA (Pro: 58 €/mes o 580 €/año).

  • Comprueba que tu Odoo es 17, 18, 19 o 20: son las versiones con ficha publicada.
  • Ten el certificado en formato .p12 o .pfx. Si tienes la clave privada y el certificado en archivos distintos, la ayuda del propio campo indica el comando: openssl pkcs12 -export -inkey private.key -in certificate.crt -out arca.p12.
  • Ten a mano la contraseña de ese archivo.
  • Identifica el CUIT titular del certificado: es el que irá en Company CUIT.
  • Decide dónde compras: con la suscripción, el módulo para las versiones nuevas de Odoo va incluido si lo compraste en flexigotech.com; en el Odoo App Store, cada versión de Odoo se compra allí.

Si aún no tienes claro si el módulo cubre lo que buscas, antes de este checklist lee si encaja en tu empresa.

Al crear la configuración: los campos que tienes que rellenar

La configuración es un registro con pocos campos. Estos son los que tienes que revisar al crearla:

  • Configuration Name: un nombre para reconocer la configuración.
  • company_id: la empresa de Odoo (campo ligado a res.company).
  • Company CUIT (represented_cuit): según la ayuda del campo, es el CUIT en cuyo nombre se consulta el padrón (cuitRepresentada), el CUIT que tiene el certificado.
  • PKCS#12 Certificate: sube el archivo .p12 o .pfx. Al lado está Certificate Filename, con el nombre del archivo.
  • Certificate Password: escribe la contraseña del certificado.
  • Certificate Expiry Date: comprueba la fecha de caducidad del certificado.

La contraseña se guarda cifrada, en el campo Certificate Password (Encrypted). Cuando vuelves a editar la configuración, si dejas Certificate Password vacío se mantiene la actual. La casilla Password Set te dice si hay una contraseña guardada.

Los campos del ticket WSAA: qué mirar después de configurar

En la misma configuración hay un grupo de campos sobre el ticket WSAA que conviene leer:

  • WSAA Token (Encrypted) y WSAA Sign (Encrypted): el token y la firma, guardados cifrados.
  • Last Ticket Request: la fecha y hora de la última petición de ticket.
  • Last Ticket Request Error: si tiene texto, es el error de la última petición. Para interpretarlo, tienes los mensajes de error del módulo.
  • Ticket Valid Until: hasta cuándo vale el ticket.
  • Ticket Expired: la casilla que marca si el ticket ha caducado.
  • Configured: la casilla que indica si la configuración consta como configurada.

Los estados que vas a ver en las listas

El módulo define varios campos de estado. Conviene que quien revise facturas y proveedores reconozca estas etiquetas:

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

Qué registro usa cada uno y cómo pasa de un valor a otro lo explica el artículo sobre cómo funciona el módulo por dentro.

  • Repasa estas etiquetas con tu equipo antes de empezar a trabajar con proveedores reales.
  • Acordad quién revisa los registros en Escalated to Manual Review y los que tengan status en AFIP Debtor, Flagged o Apocryphal invoices (ARCA APOC base).
Recorrido por la lista de códigos de error, la matriz de percepciones, la lista de proveedores ARCA y la caché de proveedores
De la lista de códigos de error a la caché de proveedores: el único proveedor de la lista aparece con estado Unknown y la caché con los contadores de aciertos y fallos a cero

La primera semana: qué revisar

Con la configuración hecha, toca repasar las tablas que el módulo trae y los primeros registros.

  • Abre la matriz de retenciones (arca.withholding.matrix) y revisa cada fila: código, descripción, porcentaje de retención, categorías aplicables, casilla de activo y notas.
  • Abre la matriz de percepciones (arca.perception.matrix) y comprueba código, descripción, porcentaje de percepción, código de provincia y tipo de transacción.
  • Revisa la lista de códigos de error (arca.error.code): mira la severidad de cada uno y si está marcado como reintentable.
  • En la lista de proveedores (arca.supplier), mira qué estado tiene cada proveedor y localiza los que estén en Unknown.
  • En la caché de proveedores (arca.supplier.cache), echa un vistazo a los contadores de aciertos y fallos.
  • Vuelve varios días a Ticket Valid Until, Ticket Expired y Last Ticket Request Error en la configuración.
  • Apunta en el calendario la Certificate Expiry Date.
Lista de la matriz de retenciones con seis filas y columnas de código, descripción, porcentaje de retención, categorías aplicables, activo y notas
La matriz de retenciones (arca.withholding.matrix), con seis filas
Lista de la matriz de percepciones con cinco registros activos y columnas de código, descripción, porcentaje, código de provincia y tipo de transacción
La matriz de percepciones (arca.perception.matrix), con cinco registros activos
Lista de códigos de error con cuatro registros y columnas de código, mensaje corto, mensaje detallado, severidad y reintentable
Los códigos de error (arca.error.code), con cuatro registros

Si la suscripción se para

El módulo trabaja con un servicio local de FlexigoTech Cloud. Sin suscripción, o con el servicio suspendido, se para lo que da la suscripción; los datos se quedan en tu Odoo.

  • Revisa la fecha de renovación de la suscripción junto con la caducidad del certificado.

Cómo te ayuda FlexigoTech

FlexigoTech implanta Odoo 17, 18, 19 y 20 y desarrolla conectores e integraciones a medida. Si quieres que hagamos contigo esta puesta en marcha, o necesitas adaptar el módulo a tu forma de trabajar con proveedores, escríbenos desde la página del módulo.

Sigue leyendo

Cómo funciona Argentina ARCA Supplier Invoice Validation en Odoo por dentroGlosario de menús, tareas programadas y datos del módulo Argentina ARCA Supplier Invoice Validation and Withholding Management para Odoo.Errores de Argentina ARCA Supplier Invoice Validation en Odoo y cómo resolverlosMensajes de error de Argentina ARCA Supplier Invoice Validation en Odoo: CUIT no válido, ARCA sin respuesta, override y lotes. Cuándo salen y qué hacer.Argentina ARCA Supplier Invoice Validation: ¿encaja en tu Odoo? Un caso para decidirQué cubre y qué no el módulo Argentina ARCA Supplier Invoice para Odoo 17 a 20, qué hace falta antes de instalarlo y un caso inventado para decidir.
Comprobado en el código del módulo (versión 20.0) y en las fuentes enlazadas

Fuentes