Kovix SCP
Integraciones · cuestionario para el proveedor de sistemas

Para quién es este documento. Para el proveedor o responsable del ERP del cliente (por ejemplo SAP Business One o Plataforma). El objetivo de la reunión es acordar qué nivel de integración conviene y qué necesita cada parte. Ninguna respuesta bloquea el proyecto: SCP funciona desde el día uno sin integración, y cada nivel se puede sumar después.

Cómo se integra SCP

SCP es un servicio en la nube con API REST/JSON autenticada por API key (una credencial por ambiente, provista por Kovix). Hay tres mecanismos, todos opcionales y combinables:

MecanismoDirecciónCómo funciona
Import de maestros e históricosERP → SCPArchivos (CSV/Excel, el importador interpreta columnas) o llamadas a la API. Puede ser puntual o programado.
Feed de órdenes con confirmaciónSCP → ERPEl ERP (o un job intermedio) consulta GET /integration/<tipo>/feed, crea sus documentos y confirma con POST /integration/<tipo>/ack. Lo confirmado desaparece del feed: reintentar es seguro.
Webhook de eventosERP → SCPEl ERP notifica hechos (recepción, parte de producción, despacho, venta) con un POST firmado por API key y clave de idempotencia: el mismo evento dos veces no duplica nada.

Referencias típicas: en SAP Business One estos flujos se resuelven con Service Layer o DI-API más un job programado; en Plataforma, con exports programados o su API según versión. Kovix entrega la documentación de endpoints, ejemplos de payload y un ambiente de prueba.

Los niveles de integración

NivelQué habilitaQué requiere del ERP
N0 · ManualTodo el ciclo de planificación. Órdenes exportables a Excel.Nada. Exports puntuales de maestros y ventas.
N1 · Maestros e históricosDatos siempre al día sin carga manual: productos, recetas, proveedores con su parametría, ventas, stock.Export programado o API de lectura, con frecuencia acordada (típico: diaria para ventas y stock, semanal para maestros).
N2 · Órdenes salientesLas OC, OF y transferencias confirmadas en SCP entran solas al circuito administrativo del ERP.Poder crear esos documentos por API o import, y un job que consuma el feed y confirme (ack).
N3 · Ejecución de vueltaEl plan se compara con la realidad sin carga manual: recepciones, partes de producción y despachos actualizan órdenes, stock y KPIs.Emitir eventos al confirmar esos documentos (webhook), o permitir consulta periódica para que un job los emita.
La recomendación habitual: arrancar en N0 o N1 para el go-live, y sumar N2 y N3 en los ciclos siguientes, cuando el proceso ya está rodado. Los niveles son independientes: se puede tener N3 sin N2 y viceversa.

Matriz de datos: dónde vive cada cosa

Para completar en la reunión. "¿Sale del ERP?" incluye el mecanismo: API, export programado, vista de base de datos o reporte.

EntidadCampos que usa SCP¿Vive en el ERP?¿Cómo sale? / Notas
Productoscódigo, descripción, tipo (terminado / insumo / reventa), unidad  
Recetas (BOM)producto, componentes y cantidades, versión vigente  
Proveedores por insumoproveedor, plazo de entrega, mínimo de compra, múltiplo La parametría (plazos, mínimos) suele estar incompleta: vale marcar qué campo sí y qué campo no.
Ventas históricasproducto, cantidad, fecha, cliente o canal (12-24 meses)  
Stock actualproducto, depósito, cantidad disponible  
OC abiertasproveedor, líneas, cantidades pendientes, fecha estimada  
OF en cursoproducto, cantidad, avance Si la producción se registra fuera del ERP, anotar dónde.
Depósitos / sucursalescódigo, nombre, tipo  

Cuestionario

A · El sistema

B · Maestros e históricos (N1)

C · Órdenes salientes (N2)

D · Ejecución de vuelta (N3)

E · Operativa

Qué pone Kovix

Con este cuestionario respondido, Kovix propone el nivel por fase, el esfuerzo estimado de cada lado y el orden de implementación.