Integraciones API¶
En esta página configuras las integraciones por API entre Planograma y los sistemas externos con los que trabaja tu empresa: plataformas de e-commerce y sistemas ERP. Una integración activa permite a Planograma obtener automáticamente pedidos, recepciones (NIR) o comprobantes de consumo del sistema externo y enviar de vuelta stocks y estados a medida que los documentos se procesan en el almacén.
Note
La configuración de las integraciones es una operación de administración. Las opciones son visibles y solo pueden guardarse por los usuarios con nivel de permiso de administrador. Determinadas acciones (por ejemplo la re-sincronización completa de los datos) están reservadas al superadministrador.
Integraciones disponibles¶
Cada integración se activa mediante un conmutador (switch). Las integraciones se excluyen mutuamente: cuando activas una, las demás se desactivan automáticamente, porque un tenant se comunica en un momento dado con un único sistema externo.
| Integración | Tipo de sistema | Activación |
|---|---|---|
| SofTech | ERP | conmutador "Comunicación con SofTech" |
| WinMentor | ERP | conmutador "Comunicación con Winmentor" |
| SoftOne | ERP | conmutador "Comunicación con SoftOne" |
| Nexus | ERP | conmutador "Comunicación con Nexus" |
| GoMag | plataforma e-commerce | conmutador "Comunicación con GoMag" |
| EasySales | plataforma e-commerce | conmutador "Comunicación con EasySales" |
| MerchantPro | plataforma e-commerce | conmutador "Comunicación con MerchantPro" |
Después de activar una integración, bajo el conmutador aparecen los campos específicos de configuración (datos de conexión, opciones de sincronización y los mapeos de estado).
Opciones comunes de sincronización¶
Independientemente del sistema elegido, las integraciones exponen un conjunto común de opciones, en forma de conmutadores:
- Sincronización de pedidos — Planograma obtiene los pedidos (las salidas) del sistema externo.
- Sincronización de NIR — Planograma obtiene los documentos de recepción (las entradas) del sistema externo.
- Sincronización de comprobantes de consumo — Planograma obtiene los comprobantes de consumo del sistema externo.
- Envío de stocks — Planograma envía de vuelta al sistema externo los stocks actualizados.
Note
No todas las opciones están disponibles en cada integración. Por ejemplo, la sincronización de los NIR aparece solo en los sistemas ERP (Nexus, SoftOne, WinMentor), y el envío de stock aparece en las plataformas de e-commerce y en una parte de los ERP.
Mapeo de los estados (Status ID)¶
Para las integraciones con pedidos y NIR rellenas los mapeos de estado entre Planograma y el sistema externo, agrupados en Ajustes de Status ID de Salidas y Ajustes de Status ID de Entradas:
- Status ID de elegibilidad para obtener la salida en Planograma — el estado del ERP en el que una salida pasa a ser elegible para obtenerse en Planograma.
- Status ID elegible para enviar el documento al picking — el estado en el que el documento se envía al picking.
- Status ID del ERP al finalizar el picking de la salida — el estado establecido en el ERP cuando el picking de la salida ha concluido.
- Status ID del ERP al finalizar la devolución — el estado establecido en el ERP al finalizar una devolución.
- Status ID correspondiente a una salida eliminada (normalmente 0) y Status ID correspondiente a una salida devuelta.
- Los equivalentes en la parte de entradas: Status ID de elegibilidad para obtener la entrada, Status ID del ERP al finalizar el procesamiento de la entrada, Status ID correspondiente a una entrada eliminada.
Los valores son los identificadores de estado usados por tu sistema externo; los obtienes de la configuración de ese sistema.
Los datos de conexión por integración¶
En función de la integración activada, rellenas lo siguiente:
- SofTech — ID de Colección, Cuenta de Usuario, Fuente de Datos, Código de Almacén de Stocks de Salidas, Código de Almacén de Stocks de Entradas, Nombre del Comisionista, Código del Centro de Coste, Código del Centro de Beneficio.
- WinMentor — IP, Puerto y los mapeos de estado (Anulada, Operada, Bloqueada, Cerrada).
- SoftOne — el ID de la aplicación, la URL de la aplicación, el Usuario de la aplicación, la Contraseña de la aplicación, Serie del NIR y los mapeos de estado para salidas y entradas.
- Nexus — IP, Puerto, API Key, más los filtros de lectura de pedidos (ver más abajo).
- GoMag — el ID de la aplicación, la URL de la aplicación y los mapeos de estado.
- EasySales — la URL de la aplicación, los mapeos de estado y una clave API (sección Credenciales, ver más abajo), más la lista de sitios web.
- MerchantPro — la URL de la aplicación, los mapeos de estado y una clave API (sección Credenciales).
Los filtros de pedidos de Nexus¶
Para Nexus, bajo "Configurador de lectura de pedidos" tienes conmutadores adicionales que acotan qué pedidos se obtienen: solo pedidos reservados íntegramente, incluir pedidos cerrados, solo pedidos firmes, solo pedidos aprobados, incluir pedidos aprobados para entrega, incluir pedidos atendidos, incluir detalles de líneas, incluir los componentes de los productos compuestos.
Generación y gestión de una clave API¶
Para las integraciones que usan una clave API (por ejemplo EasySales y MerchantPro), en la sección Credenciales rellenas:
- Api Key — la clave (el identificador) emitida por la plataforma externa.
- Api Secret — el secreto asociado a la clave.
- URL de la API — la dirección del endpoint API de la plataforma (viene precompletada con un valor predeterminado que puedes modificar).
Pulsa Añadir para guardar. La clave se almacena de forma segura en Planograma; junto a la etiqueta aparece un indicador visual: una marca verde si ya hay una clave guardada, o un signo de advertencia si aún no has introducido una.
Warning
Por motivos de seguridad, el secreto no se devuelve en claro tras guardarlo. Si tienes que cambiar la clave, introduce los valores nuevos y guarda de nuevo — sustituirán a la clave anterior.
Sitios web (token por tienda)¶
En las integraciones que admiten varias tiendas (por ejemplo EasySales), bajo Sitios web aparece la lista de las tiendas detectadas. Cada tienda se muestra como una etiqueta de color: verde si ya tiene un token configurado, o amarillo si el token falta (ver el mensaje al pasar el ratón). Pulsa sobre una tienda para abrir la ventana en la que introduces o restableces el Token de esa tienda, y luego guarda.
Re-sincronización y verificación¶
En la zona de integraciones tienes también acciones de control:
- Re-sincronización — desencadena una re-sincronización completa de los datos para el tenant actual. Es una acción reservada al superadministrador y la usas tras una reconfiguración o para forzar una alineación completa con el sistema externo.
- Fecha de la última sincronización — muestra el momento de la última sincronización correcta, como punto de referencia para verificar si la integración se ejecuta.
- Verificación de la integración — confirma si el tenant tiene al menos una integración activa configurada.
Note
Después de guardar la configuración de una integración, las sincronizaciones automáticas se ejecutan periódicamente en segundo plano. La re-sincronización manual solo es útil cuando quieres una alineación inmediata, fuera del programa automático.