Documentación de Integración: ERP-Blunae <-> Galyco (Albaranes de Venta)
Este documento detalla el procedimiento de comunicación bidireccional entre el ERP y la agencia Galyco para la gestión de estados de albaranes de venta.
1. Definición de Estados (Indicador "Galyco")
El flujo de trabajo se basa en el campo indicador "Galyco" dentro de los albaranes, con los siguientes valores:
| Valor | Descripción | Origen del Cambio |
|---|---|---|
| 0 | Pte. FTP (Valor inicial) | ERP (Sistema) |
| 1 | Enviado FTP | Usuario / Proceso Salida |
| 2 | Pte. de etiquetas | Usuario / Proceso Salida |
| 3 | Etiquetas OK | Usuario / Proceso Salida |
| 4 | En Agencia | Galyco (Proceso Entrada) |
2. Flujo de Salida: ERP → Galyco
Objetivo: Notificar a Galyco los cambios de estado (1, 2 o 3) realizados en el ERP.
- Disparador (Trigger): Proceso Q2X (
id_quliqtox=1,ident=ENVIO) monitorizando la tablacialdocoestlog. - Lógica de Negocio: Detecta inserciones/cambios en
cialdocoest(vía log) hacia los estados 1, 2 y 3. - Ejecución: Se dispara el informe automatizado (Plantilla de ejecución nº 1).
- Formato de salida: Archivo CSV.
- Protocolo de envío: FTP.
- Enrutamiento según estado:
- Si estado 1 o 2: Directorio remoto
/IN/CARPETA_A. - Si estado 3: Directorio remoto
/IN/CARPETA_B.
- Si estado 1 o 2: Directorio remoto
3. Flujo de Entrada: Galyco → ERP
Objetivo: Actualizar el albarán al estado final (4) una vez procesado por la agencia.
- Planificación (Scheduler): Tarea CRON ID=72.
- Frecuencia: Diaria (22:07).
- Mecanismo de entrada: Genera un registro en
quliqtoxget(id_quliqtox:1,ident:RECEPCION). - Servicio de Procesamiento: Ejecución de
Qfexdatmaptreemediante los siguientes componentes:- Conector (serfexcon_id:17): Conexión FTP con Galyco. Descarga de ficheros
SALIDAS*.xls(formato real CSV) desde el directorio remoto/OUTal local/galyco/in. - Estructura de Datos (serdat_id:6): Transforma el contenido de los archivos descargados a una estructura JSON.
- Mapping (sermap_id:4): Procesa el JSON e impacta directamente en la tabla
cialdocoest, actualizando el indicador al valor 4 (En Agencia).
- Conector (serfexcon_id:17): Conexión FTP con Galyco. Descarga de ficheros
4. Trazabilidad y Logs
- Toda la actividad de entrada se registra en el log del Q2X asociado al
ident:RECEPCION. - PENDIENTE (TO DO): Implementar la vinculación de este log general con los registros específicos de los albaranes afectados para facilitar la auditoría individual.
Notas Técnicas Adicionales
Importante: Aunque los archivos de salida de Galyco tienen extensión
.xls, el sistema debe tratarlos estrictamente como archivos de texto plano delimitados (CSV) según la configuración actual delserdat_id:6.