Exportar cambios manuales

Descripción

v7.6.2

Los clientes que tengan activado el sistema de fichaje manual, o cambio de estado manual. Tienen la opción de activar también el envío de los cambios realizados por POST a la API del ERP para informar el ERP de los cambios realizados.

Configuración para activar la exportación de cambios manuales

Para habilitar el envío de información a la api del ERP en el momento de hacer cambios en fichaje manual hay que habilitar la opción Activa el envío al ERP de modificaciones hechas manualmente en fases de la of en la sección de Sincronizaciones en la configuración de la aplicación

En la misma sección se puede activar Exportación de datos con gestión de cola. Con esta opción activa, los cambios se registran como pendientes y se envían al ERP en el siguiente procesamiento de la cola, que se ejecuta cada minuto. Si se desactiva, el envío se realiza directamente al confirmar el cambio.

Aparte de esto deberá de informar al equipo técnico de desarrollo los datos de conexión para que los configuren en el entorno de su sistema ePolca.

Los datos necesarios a informar son los siguientes:

• endpoint: Url completa donde hacer la petición POST con los datos.
• timeout: Tiempo que el sistema debe esperar respuesta de la API del ERP antes de indicar error de conexión. Por defecto se establecen 3 segundos.
• attempts: Intentos de conexión en caso de fallo que el sistema intentará antes de lanzar una excepción y parar el proceso.
• autenticación: Modo de autenticación para acceder a la API de su ERP. Se aceptan los siguientes modos:
  • ninguno: Esto quiere decir que la url es abierta y que se puede hacer la petición sin ningún tipo de autenticación
  • basic: Esto indica que requiere autenticación basica segun el estándar API Rest
  • bearer: Esto indica que será necesario un Bearer Token para hacer la conexión

En caso de autenticación, segun sea necesario también deberan de informar de los siguientes campos:

• user: Usuario de conexión para la autenticación
• password: Contrasenya del usuario para la autenticación
• token: Token de conexión en caso de tener autenticación por Bearer Token

Proceso de exportación de cambios manuales

Cuando un operario realice cualquier cambio en la sección de secuenciador > órdenes por fase ePolca preparará la información para el ERP si la configuración está activa.

• Con la gestión de cola desactivada, el sistema intenta enviar la información al ERP al confirmar el cambio.
• Con la gestión de cola activada, el sistema guarda un trabajo pendiente y lo procesa cada minuto. El cambio de estado queda guardado en ePolca aunque el ERP no esté disponible.
• Si falla un envío de una OF, los cambios posteriores pendientes de esa misma OF se mantienen bloqueados hasta que se procese el envío anterior. Esto evita que el ERP reciba cambios fuera de orden.

El sistema enviará datos a la Api del Erp del cliente mediante petición POST con los siguientes campos:

• order_code: Código de la OF que estamos modificando
• changed_at: Marca de tiempo del momento en que se ha hecho la modificación. en formato (Y-m-d H:i:s)
• data: Objeto con los atributos de la información adicional del cambio, puede variar en función del tipo de cambio

Ejemplo

{
  "order_code": "438117",
  "operation": null,
  "erp_item_code": "438117_1",
  "article_code": "T150138",
  "group_code": null,
  "state_timestamp": 1748853646,
  "state_datetime": "2025-06-02 10:40:46",
  "state_name": "Pausada",
  "state_id": 4,
  "incidence_type_id": 1,
  "incidence_type_name": "Fin de turno",
  "cell_code": "T",
  "cell_name": "Tall",
  "assigned_operators": [],
  "time_left": 0.1,
  "working_time": 0.1,
  "worked_time": 0.001099537037037037,
  "machines": [],
  "step": 1,
  "total_steps": 11,
  "item_disabled": false,
  "current_order_item": true,
  "is_last_active_item": true,
  "signing": {
    "total_seconds": 0,
    "total_string": "0:00:00",
    "total_seconds_group": 0,
    "total_string_group": "0:00:00",
    "signs": []
  }
}

---

Definición de campos del JSON

• order_code: Código identificador de la orden.
• operation: Operación asociada (puede ser nulo si no aplica).
• erp_item_code: Código del ítem en el ERP.
• article_code: Código del artículo o producto.
• group_code: Código de grupo (puede ser nulo si no aplica).
• state_timestamp: Marca de tiempo del estado (en formato UNIX timestamp).
• state_datetime: Fecha y hora legible del estado.
• state_name: Nombre del estado actual de la orden.
• state_id: Identificador numérico del estado.
• incidence_type_id: Identificador del motivo de la pausa.
• incidence_type_name: Nombre del tipo de la pausa.
• cell_code: Código de la célula actual.
• cell_name: Nombre de la célula actual.
• assigned_operators: Lista de operadores asignados.
• time_left: Tiempo restante estimado para finalizar (en días).
• working_time: Tiempo total estimado de trabajo (en días).
• worked_time: Tiempo ya trabajado (en días).
• machines: Lista de máquinas asociadas.
• step: Paso actual del proceso.
• total_steps: Total de pasos del proceso.
• item_disabled: Indica si el paso está deshabilitado.
• current_order_item: Indica si esta operación está activada actualmente o por overlapping.
• is_last_active_item: Indica si es la última operación de la OF.
• signing: Información sobre fichajes de operarios. (solo aplica si el módulo está activado)
  • total_seconds: Total de segundos firmados.
  • total_string: Total de tiempo firmado en formato legible.
  • total_seconds_group: Total de segundos firmados por grupo.
  • total_string_group: Total de tiempo firmado por grupo en formato legible.
  • signs: Lista de fichajes registrados.