Integración REPSE con Coupa, Ariba, SAP y Oracle: validar antes de la orden y el pago

¿Qué significa integrar REPSE con Coupa, Ariba, SAP u Oracle?

Significa que el estatus de cumplimiento del proveedor —registro REPSE vigente, expediente del período, listas 69-B y 69 del SAT, opiniones de cumplimiento— aparece en los puntos donde su empresa decide. Esos puntos son tres. El alta del proveedor, la aprobación de la orden de compra y la liberación del pago.

La validación deja de ser un PDF que alguien abre aparte. Se vuelve una respuesta que el flujo de aprobación de su plataforma recibe y usa. Quien aprueba en Coupa ve el veredicto en Coupa. Quien libera el pago en SAP lo ve en SAP.

Lo que no cambia es dónde vive cada cosa. El padrón de proveedores sigue en su ERP. La contabilización y el pago siguen en su ERP. Vigía Legal es la capa de control antes de ambos.

¿Por qué validar REPSE dentro del ERP y no en una herramienta aparte?

El riesgo no ocurre en un tablero. Ocurre en el momento de la orden y del pago. La reforma de subcontratación de 2021 fijó la regla. Si el proveedor de servicios especializados no tiene registro vigente o incumple sus obligaciones fiscales y de seguridad social, la empresa que lo contrata responde de forma solidaria. Una validación que vive fuera del flujo se salta justo cuando más importa.

Compras y Cuentas por pagar trabajan a velocidad. Si verificar exige abrir otra pestaña y archivar un comprobante, alguien lo va a omitir en el cierre de mes. La exposición se concentra en la emisión de la orden y la liberación del pago, y ahí es donde una llamada por API frena la operación.

¿Cómo funciona técnicamente la integración REPSE en cada plataforma?

El mecanismo es el mismo en las cuatro plataformas. El flujo de su sistema llama a POST /api/v1/decisions/invoice con el RFC del proveedor y el identificador de la factura, o a POST /api/v1/decisions/po con la orden. Vigía Legal responde approved, hold o rejected, con un resumen legible y las razones tipificadas, por ejemplo sat_lista69b:presunto, sat_lista69:no_localizado o compliance:red.

El campo source identifica la plataforma que llama (coupa, oracle, sap_ariba o sap para S/4). El veredicto se guarda 24 horas por fuente, número de documento y RFC. El RFC entra en la clave porque en SAP el número de documento se repite entre sociedades y ejercicios. Una segunda llamada dentro de ese plazo devuelve el mismo veredicto marcado como cached, y cada decisión queda en bitácora con fecha y motivos.

Lo que hace el flujo con la respuesta lo decide su plataforma. Vigía responde; el workflow libera, retiene o escala.

Plataforma	Dónde vive la llamada	source	Qué hace el flujo con la respuesta
Coupa	Aprobación de la factura o de la orden en Procure-to-Pay	coupa	Retiene la factura o la orden con el motivo a la vista
SAP Ariba	Calificación del proveedor y aprobación de la orden	sap_ariba	Gate previo a la emisión de la orden
SAP S/4HANA	Verificación de facturas y bloqueo de pago en Cuentas por pagar	sap	Bloqueo de pago del proveedor no apto
Oracle	Workflow de aprobaciones de Cuentas por pagar	oracle	Retención previa a la liberación del pago

El estatus del proveedor también se consulta suelto, con GET /api/v1/providers/{rfc}/status, para el alta o para una revisión periódica desde su sistema de compras. Cómo se arma la compuerta a nivel de producto está en integraciones y en la plataforma.

Qué viaja entre su ERP y Vigía Legal

El gate responde una pregunta. Alrededor de él viajan cuatro cosas más, cada una por su camino y con su disparador.

Qué viaja	Por dónde	Quién lo dispara
Veredicto de pago por factura u orden	POST /api/v1/decisions/invoice · POST /api/v1/decisions/po	El flujo de aprobación de su ERP o de su sistema de compras
Órdenes de compra	Archivo con layout configurable, o POST /api/v1/ordenes-de-compra	Compras, o un proceso programado de su ERP
Factura del proveedor	Portal del proveedor con su número de orden, o POST /api/v1/cfdis	El proveedor, o su ERP si ya la recibió
Etapa de la factura	POST /api/v1/cfdis/{uuid}/etapa · GET /api/v1/cfdis/{uuid}	Su ERP, cuando la autorización y el pago viven ahí
Aviso de cada cambio de etapa	Webhook invoice.stage_changed	Vigía Legal, en cada cambio

Las órdenes de compra entran a Vigía como espejo de su ERP. Por archivo, con un layout configurable que admite CSV con o sin encabezado y ancho fijo; las columnas y los formatos se mapean sin código y hay una vista previa antes de confirmar. Por API, POST /api/v1/ordenes-de-compra recibe lotes de hasta 500 órdenes y es idempotente por número. Las filas inválidas vuelven en la respuesta con el campo que falló, sin frenar a las válidas. Con la orden en Vigía, la factura se cruza contra ella con las reglas de tolerancia, moneda y entrada que usted configura.

La factura entra por el portal del proveedor, con su número de orden, o por POST /api/v1/cfdis desde su ERP. En la misma llamada Vigía corre la recepción y devuelve la etapa y los motivos. La recepción revisa reglas del CFDI 4.0, estado ante el SAT, expediente REPSE del período, cruce con la orden y complemento de pago pendiente. Los motivos vuelven como claves tipificadas, las mismas que leen los webhooks y el gate. En el portal del proveedor y en la pantalla se leen con el dato, qué documento falta o qué orden no coincide.

La etapa viaja en las dos direcciones. Si la factura se autoriza y se paga dentro de Vigía, su ERP la lee con GET /api/v1/cfdis/{uuid}, con motivos e historial. Si la autorización y el pago viven en su ERP, es su ERP el que escribe.

Cuando la autorización y el pago viven en el ERP

Muchas empresas ya tienen la cadena de firmas y la corrida de pagos en SAP u Oracle y no la van a mover. Para ese caso su ERP le informa a Vigía en qué quedó la factura con POST /api/v1/cfdis/{uuid}/etapa. Las etapas son cuatro, autorizada, programada, pagada y rechazada, con un motivo o un comprobante cuando corresponde. Vigía registra el evento con fecha y actor y se lo cuenta al proveedor, por correo y en su portal.

La llamada tiene dos frenos. Una factura retenida no se puede marcar como autorizada desde el ERP; la respuesta es un 409 con los motivos de la retención. Y una etapa terminal, pagada o rechazada, no se reabre.

En cada cambio de etapa, venga de la pantalla, del portal o de su ERP, Vigía emite el webhook invoice.stage_changed. Con él su sistema de compras, su tesorería o su tablero se enteran sin consultar.

Si prefiere que la factura viva entera en Vigía, el camino es el módulo de cuentas por pagar. Ahí la factura se autoriza en cadena, con segregación de funciones, entra a una propuesta de pago y sale en el layout de su banco.

24 hvigencia del veredicto en caché, por fuente, número de documento y RFC

¿Qué decisiones se pueden automatizar con la integración?

Tres, y son las que más exposición concentran. Para cada una usted define en su plataforma si el proveedor no apto se bloquea, avanza con una alerta y aprobación excepcional, o se retiene hasta regularizar.

• Alta de proveedor. Consulta del estatus en el onboarding, para que un proveedor de servicios especializados no entre al maestro sin REPSE vigente.
• Orden de compra. Gate previo a la emisión. Si el proveedor cayó en incumplimiento desde la última revisión, la orden se detiene o escala.
• Pago. Veredicto en Cuentas por pagar cuando el estatus dejó de ser apto, antes de que el pago cristalice el riesgo.
• Revalidación. El cumplimiento caduca. Los barridos programados contra las fuentes del SAT y el vencimiento de las opiniones cambian el semáforo, y la siguiente llamada trae el veredicto nuevo.

Lo que no es una característica encendida

La conexión directa por OData o BAPI, en la que SAP empuja sus órdenes y lee las etapas sin archivos de por medio, es trabajo de implementación por cliente. Hoy las órdenes entran por layout o por API, las decisiones se consultan con source: sap y la etapa avanza por API. Un conector que hable OData contra su S/4 o SOAP sobre BAPI contra su ECC se construye en la puesta en marcha, con su sistema y su ambiente de calidad.

Para las actas de servicio el conector S/4 OData existe. Al aprobar un acta se crea la hoja de entrada en su SAP, y esa conexión se implementa en la puesta en marcha con cada cliente.

Lo que se queda en el ERP en cualquier modelo es contabilizar la factura y ejecutar el pago en el banco. Vigía no reemplaza a SAP ni a Oracle; produce el veredicto, el archivo y el rastro.

¿Qué pasa con los proveedores y operaciones anteriores a la integración?

La integración protege lo que viene. La exposición de su empresa empezó en 2021. Si la autoridad revisa ejercicios pasados, usted necesita demostrar qué verificó, cuándo y con qué documento. La auditoría retroactiva reconstruye el pasado; la integración cuida el presente.

En sectores intensivos en subcontratación, limpieza, seguridad, logística, manufactura o construcción, el volumen de proveedores y la rotación cambian cómo configurar las compuertas. El enfoque por sector está en industrias.

¿Cuánto tarda implementar una integración REPSE y qué requiere de TI?

La parte técnica es una llamada por API desde el flujo que ya existe. Lo que ordena el calendario son las etapas de la implementación, y cada una depende de un archivo o de una decisión de su lado.

1. Inventario y reglas. Qué proveedores ponen personal a trabajar en su empresa y por tanto requieren REPSE vigente. Con Compras, Cuentas por pagar y Legal se define qué se bloquea, qué escala y quién aprueba excepciones.
2. El archivo de órdenes real. Una exportación de su ERP, con las columnas como salen, sirve para configurar el layout y ver la vista previa. Con datos reales aparecen los formatos de fecha, los ceros a la izquierda y las órdenes de otra sociedad.
3. El archivo del banco. Si la propuesta de pago va a salir de Vigía, el layout se configura con el archivo que su banco acepta hoy. La compatibilidad con un banco se afirma después de probar con su archivo, no antes.
4. Permisos y llaves. Una API key por sistema, roles con lo que cada uno necesita y 2FA obligatorio para quien ve datos bancarios. El rol de Tesorería no ve el expediente REPSE por diseño.
5. Pruebas en ambiente de calidad. Veredictos, órdenes, facturas y etapas contra el ambiente de calidad de su ERP, con un grupo piloto de proveedores, antes de tocar producción.

De TI hacen falta dos personas. Quien pueda llamar una API desde el flujo de aprobación y quien sea dueño de ese flujo en el ERP. El costo depende del número de proveedores, de los módulos y de las plataformas a conectar; puede revisar su caso en precios. El papel de la lectura automática de documentos está en la guía de validación REPSE con inteligencia artificial.

¿Vale la pena integrar si ya tiene un software REPSE?

Sí, si ese software vive fuera de su flujo de compras. Una plataforma REPSE que nadie abre en el cierre de mes no reduce el riesgo. La integración es lo que convierte la validación en un control activo. Si todavía está evaluando herramientas, revise primero los criterios en cómo elegir software de cumplimiento REPSE y después exija que se integre con su ERP.

La pregunta para cualquier proveedor de tecnología es una. ¿En qué punto exacto de mi flujo en Coupa, Ariba, SAP u Oracle me detiene el sistema un pago a un proveedor que dejó de estar vigente? Si la respuesta no es un punto concreto del workflow, no tiene una integración; tiene un repositorio.

Cómo lo hace Vigía Legal

El gate de pago se consulta desde Coupa, Oracle, SAP Ariba y SAP S/4 con la misma llamada, y responde con razones tipificadas y un resumen legible. Las órdenes de compra entran por archivo con layout configurable o por API; la factura, por el portal del proveedor o por API, y vuelve con su etapa y sus motivos. Cómo se ve ese control desde el escritorio de quien paga está en REPSE para Cuentas por pagar.

Si la autorización y el pago viven en su ERP, su ERP escribe la etapa y Vigía avisa al proveedor. Si prefiere que la factura viva en Vigía, el módulo de cuentas por pagar la lleva de la recepción al archivo del banco. En los dos casos, contabilizar y pagar se quedan donde ya están.