"Aviso de alerta de riesgo: tome cuidado al utilizar el parámetro de configuración con la clave Security=0, porque esto ocasionará que las integraciones (API) no exijan autenticación, consecuentemente, los datos de su entorno podrán consultarse sin ningún control de autorización."

Integración PCP Protheus vs. PPI-Multitask 

Contexto de negócio

1. MES 
   Manufacturing Execution Systems, o simplemente MES, es el término utilizado para designar los sistemas enfocados en la administración de las actividades de producción y que establecen una conexión directa entre la Planificación y el Piso de fábrica. Los sistemas MES generan información precisa y en tiempo real, promoviendo la optimización de todas las etapas de la producción, desde la emisión de una orden hasta el embarque de los productos terminados. 
   La importancia de estos sistemas proviene de la laguna que usualmente existe entre el ERP (Entreprise Resource Planning) y los softwares específicos de la línea de producción. El MES puede importar datos del ERP e integrarlos con el día a día de la producción, administrando y sincronizando las tareas productivas con el flujo de materiales. Considerando que en la cadena de suministro el mayor valor agregado suele estar en la producción, tiene total sentido invertir en sistemas que optimicen el flujo, control y calidad del material (Fuente: PPI-Multitask).
   
   
2. Planificación y control de producción 
   La fusión de los medios de producción (materia prima, mano de obra y equipos) permite la fabricación de productos que surgen de la acción de los sistemas productivos. Los planes que sirven de guía para ejecutar y controlar la producción se comandan por el órgano auxiliar denominado Planificación y control de la producción (PCP), que dicta las normas a la línea de producción, teniendo como objetivo un flujo ordenado y continuo del proceso productivo.
   
   
3. Piso de fábrica 
   Permite al usuario planificar, "apuntar" y monitorear las actividades ejecutadas en cada centro de trabajo de la fábrica y máquina, permitiendo una visualización integrada de las operaciones realizadas, en ejecución y por procesarse. Permite la Administración y Monitoreo de los resultados (productividad, eficiencia, atrasos, calidad, utilización, niveles de parada, motivos de desecho, desvío de tiempo real / estándar, etc.) obtenidos. En la utilización integrada al MES, los apuntes se realizarán por el sistema MES.

Sistemas involucrados

• PCP PROTHEUS 
• PCP - SIGASFC PROTHEUS 
• PC-FACTORY (PPI MULTITASK)

Objetivo de la integración

El objetivo de la Integración PC Factory (software MES de la empresa PPI Multitask) VS. PROTHEUS es poner a disposición de los clientes TOTVS una nueva opción para control de la producción por medio de la automatización de los procesos, permitiendo la actualización y extracción de información de forma on-line para simplificar el flujo de los clientes. 

Alcance

 
Permite la integración entre el módulo PCP y SIGASFC del Protheus con el MES PC-Factory de la PPI-Multitask, que tiene como objetivo controlar los apuntes de las órdenes de producción. El Protheus tiene como responsabilidad la creación de las órdenes de producción y el PC-Factory, los apuntes.

La integración considera las siguientes rutinas y procesos en la ETAPA 1:

1. Parametrización: Permite parametrizar la utilización de la integración, indicando si está ACTIVA. Indica si ocurrirá la generación de los archivos XML de la información que transitará entre los sistemas, también permite definir los filtros que se aplicarán en la información.
2. Integradores: Los "adapters" son las funciones responsables por enviar o recibir la información que transita entre los sistemas PCP Protheus y PC-Factory. La integración considera la siguiente información: Producto, local de stock, recurso, órdenes de producción, apunte de producción y apunte de parada.
3. Asuntos pendientes: Permite administrar los asuntos pendientes de envío del PCP Protheus al PC-Factory, así como verificar el historial y errores del proceso de integración.
4. WebService: Permite procesar los apuntes de producción y parada enviados del PC-Factory al Protheus.
5. Sincronización: Permite realizar la sincronización de datos entre el PCP Protheus y el PC-Factory. Puede enviar los datos de los Productos, Local de stock, Recurso y Orden de producción.
6. Log de importación: Permite consultar el proceso de integración de los apuntes de producción y paradas enviados del PC-Factory al Protheus.
   
   
   

La integración considera las siguientes rutinas y procesos en la ETAPA 2:

La etapa 2 considera el consumo de los componentes, movimientos efectuados por el PC-Factory y saldos en stock. También considera el sistema SIGASFC - Piso de fábrica.

1. Parametrización: Permite parametrizar la utilización de la integración, indicando si está ACTIVA. Indica si ocurrirá la generación de los archivos XML de la información que transitará entre los sistemas, también permite definir los filtros que se aplicarán en la información.
2. Integradores: Los "adapters" son las funciones responsables por enviar o recibir la información que transita entre los sistemas PCP Protheus y PC-Factory. La integración considera la siguiente información: Producto, local de stock, recurso, máquinas, herramienta, procedimiento, estructura, ubicación, órdenes de producción, saldos en stock, movimientos y transferencias de stock, apunte de producción y apunte de parada y rechazo.
3. Asuntos pendientes: Permite administrar los asuntos pendientes de envío del Protheus al PC-Factory, así como verificar el historial y errores del proceso de integración.
4. WebService: Permite procesar los apuntes de producción y parada enviados del PC-Factory al Protheus.
5. Sincronización: Permite realizar la sincronización de datos entre el Protheus y el PC-Factory. Puede enviar los datos de Productos, Local de stock, Recurso, Máquina, Procedimiento, Estructura, Ubicación, Saldo en stock y Orden de producción.

6. Log de importación: Permite consultar el proceso de integración de los apuntes de producción y paradas y rechazos enviados del PC-Factory al Protheus.

Requisitos previos de instalación/implantación/utilización

Para la versión 12 del Protheus debe aplicarse el paquete de actualizaciones a partir de la versión 12.1.10 en la Etapa I.

También es posible utilizar en la versión 11.80.14 para la Etapa I y 11.80.17 para la Etapa II. Debe ejecutarse la actualización del diccionario con el programa U_UPDPCP34.

La Build debe ser igual o superior a 7.00.131227A y la fecha 08/09/2014.

Dirección de IP y puerto liberado para ejecución del WebService. Estos datos se utilizarán en el archivo APPSERVER.INI en la sesión WEBSERVICE.

Debe actualizar el archivo APPSERVER.INI en la sesión WEBSERVICE.

Para configurar un WebService debe verificarse el siguiente documento de configuración: : http://tdn.totvs.com/pages/viewpage.action?pageId=6064937

Ejemplo:

;CONFIGURACIÓN WEBSERVICE

[HTTP]
enable=1
port=8090

[10.80.62.219:8090]
ENABLE=1
Trace=1
PATH=C:\TOTVS 11\Microsiga\Protheus_Data\web\ws
ENVIRONMENT=mssqlserver
INSTANCENAME=WS
RESPONSEJOB=JOB_WS_9901
DEFAULTPAGE=wsindex.apw

[JOB_WS_9901]

SECURITY=1
TYPE=WEBEX
ENVIRONMENT=mssqlserver
INSTANCES=1,20
SIGAWEB=WS
INSTANCENAME=WS
ONSTART=__WSSTART
ONCONNECT=__WSCONNECT

;FIM CONFIGURACAO WEBSERVICE

 
También debe actualizarse en el archivo APPSERVER.INI en la sesión PROXY (si existiera proxy configurado)

[PROXY]

Enable=1

Server=proxy-jv.jv01.local

Port=8080

User=XXXXX

Password=*******
 

Cuadro de compatibilidad:

Checklist de adherencia al entorno del cliente

El siguiente checklist tiene como objetivo validar si el TOTVS MES está adherente al entorno actual del cliente, considerando que existen situaciones no consideradas en la integración.

Situaciones no atendidas o atendidas parcialmente por la Integración:

Instalación/Actualización

La integración PCP Protheus vs. PC-Factory PPI-Multitask se activa por medio de los siguientes pasos:

1. Abra el programa de Parámetros de la integración: PCPA109 (Actualizaciones -> Integración MES-> Parámetros)..
2. Marque el campo Activo a "1- Activo".
3. En el campo camino Informe la URL del WebService de la PPI-Multitask.
4. Verifique la conectividad del WebService por medio de la opción Probar.
5. Indique si la integración generará físicamente los archivos XML.
6. Configurare los filtros para cada información que transitará entre los sistemas.
7. Confirme la activación por medio de la opción CONFIRMA.

La opción Probar verifica si es posible realizar la conexión con el WebService informado en el campo Camino. Esta opción tiene dos devoluciones:

• Conexión con el WebService realizada con éxito.
• No fue posible realizar la conexión con el WebService del PC-Factory.

Para los clientes que desean utilizar administrador de conexión WSDL en el envío de mensajes en la Integración TOTVSMES, deben modificarse a TRUE los campos MV_COPPI

Al marcar el campo Genera XML se generarán los XML de los mensajes intercambiados. Si no estuviera marcado se grabará solamente en tablas. La generación de los archivos no es obligatoria. Sirve como una herramienta útil para encontrar problemas y podrá grabarse en el directorio de XML enviados con éxito o XML pendientes.

Los nombres de los archivos seguirán este estándar:

OK_<MSJ><FECHAHORA><REGISTRO>

PEND_<MSJ><FECHAHORA><REGISTRO>

ERR_<MSJ><FECHAHORA><REGISTRO>

Donde: OK - Si el mensaje se entrega sin problemas           

PEND- Si el mensaje no se hubiera enviado           

ERR - Si el mensaje se hubiera enviado, sin embargo devolvió error.           

MSJ - Nombre del mensaje. Ej.: Ítem, Wharehouse, Workcenter, etc.           

FECHAHORA: Fecha y hora del envío           

REGISTRO: Código del registro que se está enviando. Ej.: Código del ítem, número de la orden, etc.

Para cada archivo movido (producto, local de stock, recurso, herramienta, máquina, procedimiento, estructura, ubicación, movimientos, saldos y orden de producción) habrá una carpeta. En cada carpeta será posible elaborar filtros y definir parametrizaciones. Estos filtros se utilizarán en las rutinas que enviarán información al PC-Factory, permitiendo seleccionar lo que debe enviarse. Se mostrarán los campos de la tabla seleccionada (carpeta) y operadores para que se elaboren los filtros. Si no hubiera ningún filtro registrado, todo registro incluido, modificado o borrado se enviará al PC-Factory. Para elaborar los filtros el usuario debe conocer el diccionario de datos, pues frecuentemente se utiliza el nombre de las tablas y de los campos.

Ejemplo:

Elaborar un filtro para que solamente se envíen los productos que se clasifiquen como Producto terminado. El filtro será: B1_TIPO = "PA"

El envío de información del PCP Protheus al PC-Factory PPI-Multitask ocurre en las siguientes transacciones:

• Registro, modificación y borrado de producto MATA010, local de stock AGRA045 y recurso MATA610, SFCA006 y SFCA002.
• Registro y modificación de órdenes MATA650.
• Proceso para FIRMAR órdenes MATA651.
• Mantenimiento de operaciones MATA632 o PCPA124.
• Mantenimiento de las reservas, MATA380 y MATA381.
• Registro, modificación y borrado de Operaciones vs. Componentes MATA637.
• Carga máquina – MATA690.
• Cálculo del MRP MATA712 (versión 11.8) o PCPA107 (versión 12).
• Registro, modificación y borrado de estructura, MATA200 y PCPA200.
• Splits de producción generados por las rutinas que manejan orden y el SFCA310 Apunte Modelo 1 del Piso de fábrica.
• Registro, modificación y borrado de ubicación MATA015.
• Registro, modificación y borrado de herramientas MATA620.
• Actualización de saldos.
  • Fact. de Entrada - Rutinas que ejecutan la función B2ATUCOMD1.
  • Fact. de Venta - Rutinas que ejecutan la función B2ATUCOMD2.
  • Mov. Internos - Rutinas que ejecutan la función B2ATUCOMD3.
  • Inclusión de saldo MATA220 y MATA805.

El envío de información del PC-Factory PPI-Multitask al Protheus ocurre en las siguientes transacciones:

• Registro de motivos de parada SFCA004.
• Registro de motivos de desecho SFCA003.
• Movimientos sueltos de stock. Entrada MATA250. Salida MATA240.
• Transferencia de stock MATA261.
• Apunte de producción MATA681 y SFCA310.
• Apunte de parada MATA682 y SFCA311.
• Rechazo/Apunte de pérdida MATA685.

Control de versión

El grupo TOTVS representado por sus marcas administrará las demandas de evolución de los layouts y otros ajustes, acordando con los solicitantes el plazo de liberación del release.

Todas las evoluciones programadas deben discutirse y aprobarse por las marcas antes de iniciar el desarrollo y solamente se desarrollarán si se encuentran en concordancia con las marcas y alineadas con las directivas definidas por el Comité de integración TOTVS.

Soporte

El soporte a los recursos de integración es de responsabilidad de todas las líneas, de esta manera, los equipos de soporte de los productos RM Conector y Backoffice Protheus están aptos para realizar el primer análisis y si fuera necesario, repasar al equipo más adecuado en cada caso.

Transacciones/Entes/Mensajes únicos

Las siguientes transacciones se intercambiarán entre TOTVS y PPI-Multitask:

Flujo de información

Flujo de información de las transacciones:

• Producto, local de stock y recurso: en el momento de la creación, modificación o borrado de un producto en el programa MATA010, de un local de stock en el programa AGRA045 o de un recurso en los programas MATA610 o SFCA006 o SFCA002 (máquina) y herramientas en el MATA620. Los programas verifican si la integración está activa y si estuviera activa, efectuará el envío del archivo al PC-Factory. Si no ocurriera error, el archivo no presentará ningún mensaje, sin embargo, si ocurriera error se mostrará un mensaje preguntando si desea crear un asunto pendiente de envío en el programa PCPA110. Si optara por generar el asunto pendiente, el proceso se actualizará en el Protheus y la actualización para el PC-Factory debe realizarse por medio del PCPA110. 
  En la ingeniería también se integran los registros de estructura (MATA200, PCPA200, PCPA120, PCPA135), procedimiento (MATA632, MATA637 o PCPA124), y ubicaciones MATA015, siempre y cuando ocurra la creación, modificación o borrado de un registro.
• Orden de producción: en el momento de la creación o modificación de una orden de producción, o durante la modificación de la situación de una orden (asignación/carga máquina, requisición, modificación de operaciones o reservas, MRP, creación de splits), el programa verificará si la integración está activa y si estuviera activa, efectuará el envío del archivo al PC-Factory. Si no ocurriera error el archivo no mostrará ningún mensaje. Si ocurriera error, se mostrará* un mensaje y un asunto pendiente de envío podrá crearse en el programa PCPA110. Al final del proceso de las rutinas que procesan múltiples órdenes, como por ejemplo carga máquina, se mostrarán las cantidades de registros que se enviaron al PPI-Multitask y también las que tuvieron asuntos pendientes de envío. Obs.: Algunas rutinas generan asuntos pendientes sin realizar la pregunta debido al número de órdenes procesadas. 
  Rutinas afectadas por la integración: Mantenimiento de órdenes (MATA650), Rutina para órdenes en firme (MATA651), Mantenimiento de las operaciones (MATA632, MATA637 o PCPA124), Mantenimiento de reservas (MATA380 y MATA381), Carga máquina (MATA690) y MRP (MATA712), Splits de producción (SFCA310).
• Programa de gestión de asuntos pendientes PCPA110 - este programa tiene por función administrar los asuntos pendientes/excepciones referentes a la integración que se crean si el mensaje no se envía al PC-Factory, sean estos, asuntos pendientes o error. Permite el reprocesamiento de un mensaje, borrado de un asunto pendiente y la visualización del XML, además de tener filtro por fecha de envío, transacción, tipo de asunto pendiente y rutina generadora. La rutina también permite consultar los mensajes enviados con éxito.
• Programa de sincronización PCPA111 - permite el envío de la información del producto, local de stock, recurso, herramientas, procedimiento, estructura, ubicación, saldo en stock y orden de producción y tiene como objetivo efectuar una actualización de la base de datos del PC Factory. Además de los filtros definidos en el PCPA109, también es posible agregar nuevos filtros para cada tabla..
• Apunte de producción: En el WebService esta rutina tiene por objetivo recibir los apuntes de producción realizados en el PC-Factory. Puede procesar apuntes de producción y parada de recurso. Ejecutará el mismo proceso que las rutinas MATA681 y MATA682. Si el Piso de fábrica estuviera instalado, ejecutará el mismo proceso que la rutina SFCA316 y SFCA311. 
  El flujo de la integración será el siguiente: 
  a. El operador efectúa un informe generalmente de acuerdo con su operación en el PC-Factory. 
  b. En un proceso batch o activado paralelamente en el sistema, ocurre la elaboración del mensaje(XML) de acuerdo con el Schema de mensaje único TOTVS y el envío de este mensaje(XML) al PCP Protheus, que validará el mensaje y encaminará al respectivo adapter de negocio (MATA681/MATA682 o SFCA316/SFCA311) para procesamiento. 
  c. En caso de errores, este informe quedará con estatus de pendiente para envío dentro del software MES y el usuario podrá tomar acciones en el propio PC Factory (el Protheus no mantendrá trazabilidad de los mensajes recibidos, pero registrará el procesamiento en LOG). 
  d. En caso de éxito en el informe, se devolverá al PC-Factory el número del registro del informe realizado en el Protheus. Este número puede utilizarse en caso de reversión.
• La actualización de saldo en el PC-Factory ocurrirá de las siguientes maneras: 
  a. Request: el PC-Factory solicita un saldo generando un mensaje XML de request. En este mensaje puede solicitar el saldo por ítem, por local de stock, etc. 
  b. Actualización Protheus: Si ocurre una actualización de saldo en el Protheus debe enviar un mensaje XML al PC-Factory. Se consideran las principales rutinas del ERP, como Factura de entrada y venta, algunos movimientos internos y la inclusión de saldo vía MATA220 y MATA805.
• Movimientos de stock: Si el PC-Factory realiza movimientos de stock y transferencias, estos movimientos se actualizarán en el Protheus. 
  En caso de movimientos, si fuera E (entrada), debe ejecutar el MATA250. Si fuera S (salida), debe ejecutar MATA240. En casos de transferencia ejecutará el MATA261.
• Rechazo/Apunte de pérdida En el WebService esta rutina tiene por objetivo recibir los registros de rechazo realizados en el PC-Factory. Ejecutará el mismo proceso que las rutinas MATA685.
• Consulta de Log de importación PCPA112: Esta rutina consiste en la consulta de los registros de los apuntes procesados por la integración Protheus vs. PC-Factory. La rutina debe mostrar los apuntes efectuados y el estatus de cada proceso.

Punto de entrada

Para facilitar el uso de la integración y hacer el uso flexible en cualquier entorno de producción se crearon algunos puntos de entrada para solucionar posibles situaciones específicas no atendidas por el estándar y también permitir configuraciones más precisas en el uso de la integración:

Apunte: el punto de entrada MATI681CRG permite agregar información que se utilizará en el apunte de producción y en el apunte de parada, tabla SH6. Ejemplo: Si existiera algún campo específico o tabla específica no tratada por la integración, puede utilizar esta función para marcar su contenido. Detalles en:  MATI681CRG_Agregar_informacion_Adapter_del_apunte.

Apunte: el punto de entrada MT680VAL permite validar si alguna información debe ser obligatoria, como tiempo, cantidad, etc. Estas validaciones quedarán a cargo de los clientes, pues cada uno tendrá su regla. Detalles en: MT680VAL - Inclusión_de_las producciones.

Apunte: el punto de entrada MATI680OPR permite modificar el código de la operación recibida en el apunte de producción. Detalles en: MATI681OPR_Modificar_codigo_operacion_mensaje_apunte_produccion. 

Apunte: el punto de entrada MTI681QTAP permite modificar la cantidad recibida en el apunte de la producción. Este punto de entrada está indicado para aplicar el factor de conversión en la cantidad del apunte cuando el ERP y el PC-Factory trabajan con una unidad de medida diferente. Detalles en: MTI681QTAP_Modificar_cantidad_del_apunte_ProductionAppointment.

Apunte: el punto de entrada MATI681EXC permite verificar si el apunte se ejecutará o no. Este punto de entrada está indicado para validaciones que impidan el apunte de producción y parada. También se utiliza en casos en los que es necesario actualizar alguna información antes del apunte (ejemplo: revertir un control de ubicación). Detalles en: MATI681EXC_Procesa_mensaje_apunte.

Apunte: el punto de entrada MATI681INT permite procesar el XML en el PE para validación/grabación personalizada, pudiendo optar  por ejecutar la rutina estándar de apunte de producción o no. Si hubiera ejecución de la rutina estándar y hubiera error, solo se revertirá lo que se realizó en la rutina estándar. El punto de entrada se llama antes del inicio de la transacción de la rutina estándar de apunte de producción. Detalles en: MATI681INT - Permite procesar XML antes del mensaje de apunte de producción

Apunte: el punto de entrada MT681ALXML permite modificar cualquier información del mensaje. Este punto se indica para empresas que tienen productos con controles distintos entre el ERP y el PC-Factory. Por ejemplo, controla Lote en el PC-Factory y no controla en el ERP. El Lote se genera en el XML y se retira vía punto de entrada. Detalles en: MT681ALXML - Modificar información XML ProductionAppointment.

Orden de producción: el punto de entrada MTI650ADOP permite agregar una nueva operación en el mensaje de órdenes de producción. Para cada operación que se está enviando, este punto de entrada se ejecutará una vez. Detalles en: MTI650ADOP_Agregar_nueva_operacion_adapter_orden_de_produccion. 

Orden de producción: el punto de entrada MTI650FCOP permite modificar el factor de conversión de la segunda unidad de medida de la operación que se enviará en el mensaje de órdenes de producción. Detalles en: MTI650FCOP_Modificar_factor_de_conversion_segunda_unidad_de_medida_de_la_operacion_adapter_orden_de_produccion.  

Orden de producción: el punto de entrada MTI650QTOP permite modificar la cantidad de la operación que se enviará en el mensaje de órdenes de producción. Detalles en: MTI650QTOP_Modificar_cantidad_de_la_operacion_adapter_orden_de_produccion. 

Orden de producción: el punto de entrada MTI650UMOP permite modificar la segunda unidad de medida de la operación que se enviará en l mensaje de órdenes de producción. Detalles en: MTI650UMOP_Modificar_segunda_unidad_de_medida_de_la_operacion_adapter_orden_de_produccion. 

Orden de producción: el punto de entrada MTI650TMAC permite modificar el tiempo de máquina (TimeMachine) en el mensaje de ProductionOrder. Detalles en: MTI650TMAC_Modificar_cantidad_del_tiempo_maquina_production_order. 

Orden de producción: el punto de entrada MTI650LOTE permite generar el Lote de la orden en la tag LotCode en el mensaje ProductionOrder. Detalles en: MTI650LOTE_Agregar_lote_en_ el_mensaje_de_ordenes_de_produccion. 

Orden de producción: el punto de entrada MTI650UTTP permite modificar el valor enviado en la tag UnitTimeType. Detalles en: MTI650UTTP - Modificar el valor de la tag UnitTimeType del mensaje ProductionOrder.

Registros: el punto de entrada PCPXFUNPPI permite inhibir la integración en determinada rutina. Ejemplo: Si en la creación de órdenes MATA650 no desea que ocurra la integración, puede utilizar esta función para inhibir el uso. Detalles en: PCPXFUNPPI_Rutinas_que_no_realizan_integracion_con_el_PC_Factory.

Registro de ítem: el punto de entrada PCPADDTAGS permite incluir tags específicas en los mensajes estándar TOTVS. Está habilitado para el registro de ítem MATA010. Detalles en: PCPADDTAGS_Agregar_informacion_XML_integracion_TOTVS_MES. 

Registro de procesos: el punto de entrada PCPADDTAGS permite incluir tags específicas en los mensajes estándar TOTVS. Está habilitado para el registro de procedimiento MATA632. Detalles en: PCPADDTAGS_Agregar_informacion_XML_integracion_TOTVS_MES. 

Registro de procesos: el punto de entrada MTI63UTTP permite modificar el valor enviado en la tag UnitTimeType. Detalles en: MTI632UTTP - Modificar el valor de la tag UnitTimeType del mensaje ItemScript.

Registro de máquina: el punto de entrada MTI610UTTP permite modificar el valor enviado en la tag UnitTimeType. Detalles en: MTI610UTTP - Modificar el valor de la tag UnitTimeType del mensaje Machine.

Movimientos internos. los puntos de entrada MATI250CRG y MATI240CRG permiten alguna validación específica. Estas validaciones quedarán a cargo de los clientes, pues cada uno tendrá su regla. No pueden modificarse los valores de los campos que se generaron por el mensaje. Detalles en: MATI240CRG_Agregar_informacion_Adapter_de_movimientos_internos y MATI250CRG_Agregar_informacion_Adapter_de_movimientos_de_produccion.

Transferencias: el punto de entrada MI261RCV permita la no ejecución de la integración. Detalles en: MI261RCV_Ejecutar_integracion_TransferWarehouse.

Rechazo: el punto de entrada MATI685EXC permite verificar si el rechazo se ejecutará o no. Este punto de entrada está indicado para validaciones que impidan el apunte de rechazo o actualizaciones de información necesarias para realizar el rechazo. Detalles en: MATI685EXC_Procesa_mensaje_rechazo.

Ejecutar en varias sucursales

En un entorno con varias sucursales es necesario solamente un WEBSERVICE en ejecución. Las TAG que indican la sucursal donde se procesa el apunte son:

<CompanyId>10</CompanyId>

<BranchId>CLSC0001</BranchId>

Si las tags estuvieran en blanco el sistema considera lo que estuviera definido en el APPSERVER.ini en la sesión WEBSERVICE campo PrepareIn.

[WebServices]

PrepareIn=99,01

Control de latencia

Existen situaciones en las que el tiempo de espera del webservice es inferior al tiempo de procesamiento de las importaciones para el ERP. Puede ocurrir la situación en la que el ERP continúe procesando la importación y el WebService del PC-Factory para de esperar la respuesta. Cuando el PC-Factory no recibe la respuesta a tiempo, el mismo archivo se reenvía, pudiendo generar duplicidad en el procesamiento del mensaje.

Solución:

Controlar el ID del PC-Factory para los mensajes recibidos. Todos los mensajes recibidos deben tener este tratamiento:

• ProductionAppointment
• StopReport
• MovementsInternal
• TransferWarehouse
• StopReason
• WasteReason
  
  

En los XML se utilizará la TAG  Key name = "IDPCfactory"

<BusinessEvent>

      <Entity>Entity</Entity>

      <Event>upsert</Event>

      <Identification>

        <key name="IDPCFactory">29892829</key>

      </Identification>

</BusinessEvent>

La devolución con error muestra el mensaje con el siguiente estándar:

<ProcessedOn>2017-03-28T09:11:17</ProcessedOn>

   <Status>ERROR</Status>

   <ListOfMessages>

      <Message type="ERROR" code="N">MENSAGEM</Message>

   </ListOfMessages>

</ProcessingInformation>

El XML de devolución debe respetar la siguiente regla:

• Cuando el ID está procesado y contiene ERROR

              Devuelve el ID PC-Factory en la tag <UUID>
              En la tag Message type="ERROR" code="2", utiliza 2 para indicar error.
              El mensaje será: ID xxxx procesado. Estatus: mensaje de error".

             Ejemplo: <Message type="ERROR" code="2">ID productionappointment-0038 procesado. Estatus: ProductionOrderNumber no registrada en el Protheus.</Message>

• Cuando el ID se procesó con éxito

              Devuelve el ID PC-Factory en la tag  <UUID>
              En la tag Message type="ERROR" code="3", utiliza 3 para indicar el procesamiento con éxito.
             El mensaje será: ID xxxx procesado. Estatus: ID del Protheus" o  "ID xxxx procesado. Estatus: Reprocesado. ID del Protheus" cuando el PC-Factory envía más de una vez

.             Ejemplo 1:      <Message type="ERROR" code="3">ID productionappointment-0038 procesado. Estatus: 5091</Message>

              Ejemplo 2:      <Message type="ERROR" code="3">ID productionappointment-0038 procesado. Estatus: Reprocessado. 5091</Message>.

• Cuando el ID está en la base, pero en procesamiento

              Devuelve el ID PC-Factory en la tag  <UUID>
              En la tag Message type="ERROR" code="4", utiliza 4 para indicar que está en procesamiento.
              El mensaje será: ID xxxx se está procesando por el Protheus.

              Ejemplo: <Message type="ERROR" code="4">ID apapapapeaaa se está procesando por el Protheus.</Message>

 
Situaciones inesperadas que pueden ocurrir: la parada del servicio del Protheus, base de datos fuera del aire, falta de energía, etc. Si ocurriera durante el procesamiento de la integración, el registro del PC-Factory (ID del PC-Factory) puede quedar trabado y el mensaje no sale de la fila de procesamiento. Para tratar esta situación:

El PC-Factory intenta enviar por determinado tiempo, parametrizado en el PC-Factory. Si continua recibiendo el mismo mensaje después del tiempo parametrizado, el PC-Factory genera un asunto pendiente de envío y pasa al próximo registro. Al pasar al próximo registro, se genera un contador de mensajes no enviadas. Cuando este contador alcanza un límite (parametrizado), el proceso de integración se paraliza para que los usuarios puedan resolver el problema. El control de procesamiento quedará registrado en tabla de LOG SOH.

A continuación se muestra la tabla de los códigos enviados:

Autenticación

Cuando el usuario y la contraseña estén registrados en el PCPA109 (Parámetros), carpeta Seguridad, estos datos se enviarán en el mensaje para que el PC-Factory efectúe la autenticación.

Estos datos se enviarán en el encabezado del mensaje de la siguiente manera:

Authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l

Donde: el valor será usuario:contraseña encriptado en Base64.

La recepción de los mensajes también seguirá el mismo modelo, pero el PC-Factory enviará un usuario del Protheus.

Security = 0 -> No utiliza autenticación.

Security = 1 -> Utiliza autenticación.

Rutinas involucradas

Parametrización - PCPA109

La parametrización influirá directamente sobre los registros que se moverán entre los dos sistemas.
La rutina de parametrización tendrá los siguientes campos:

• Activo: Indica si la integración está activa. Al seleccionar este campo, se habilitan los otros. Si este campo estuviera desmarcado, ninguna otra acción podrá realizarse en la rutina.
• Camino: Indica el camino del WebService y del PC-Factory. Después del camino, habrá la opción probar para verificar si está activo el webservice.
• Habrá un panel XML. 
  En este panel podrá indicar: 
  - Genera XML - Al seleccionar este campo, generará los XML de los mensajes intercambiados. Si no estuviera marcado se grabará solamente en tablas. La generación de los archivos no es obligatoria. Sirve como una herramienta útil para encontrar problemas. El envío siempre se realizará con base en lo que estuviera registrado en las tablas. 
  - Enviados - Directorio donde se grabarán los XML enviados con éxito al PC-Factory 
  - Asunto pendiente - Directorio donde se grabarán los XML que no se enviaron al PC-Factory 
  Los nombres de los archivos seguirán este estándar: 
  OK_<MSJ><FECHAHORA><REGISTRO> 
  PEND_<MSJ><FECHAHORA><REGISTRO> 
  ERR_<MSJ><FECHAHORA><REGISTRO> 
  Donde: OK - Si el mensaje se entrega sin problemas            
  PEND- Si el mensaje no se hubiera enviado            
  ERR - Si el mensaje se hubiera enviado, sin embargo devolvió error.            
  MSJ - Nombre del mensaje. Ej.: Ítem, Wharehouse, Workcenter, etc.           
  FECHAHORA: Fecha y hora del envío            
  REGISTRO: Código del registro que se está enviando. Ej.: Código del ítem, número de la orden, etc. 
  Obs.: Si se selecciona Genera XML, deben informarse los directorios.

Para cada archivo movido habrá una carpeta. Para cada carpeta será posible elaborar filtros. Estos filtros se utilizarán en las rutinas que enviarán información al PC-Factory, permitiendo seleccionar lo que debe enviarse.  Se mostrarán los campos de la tabla seleccionada (carpeta) y operadores para que se elaboren los filtros. Además de los filtros, algunos archivos tienen parametrizaciones.
La rutina tendrá las siguientes carpetas:

• Producto
• Local de stock
• Recurso
• Máquina La carpeta máquina solamente se mostrará si el piso de fábrica estuviera en uso.
• Herramienta
• Orden de producción 
  Panel MRP: Indica cómo el sistema debe comportarse con relación a las órdenes generadas por el MRP. Tendrá las siguientes opciones: 
  "No integra": Las órdenes generadas por el MRP no se enviarán al PC-Factory por el cálculo del MRP 
  "Genera asunto pendiente": Las órdenes generadas por el MRP quedarán registradas en los asuntos pendientes de envío 
  "Integra": Las órdenes generadas por el MRP se enviarán al PC-Factory por el cálculo del MRP. 
  
  Panel "Consumo de componentes". Determina cómo será el consumo de los componentes. Este campo puede contener los siguientes valores: 
  "1" - BackFlush: Siempre realizará la baja de los componentes de acuerdo con lo definido en la ingeniería. 
  "2" - Consumo Real: Consumirá de acuerdo con la lista de componentes.

          "3" - Consumo Real/Act Reserva: consumirá de acuerdo con la lista de componentes y no existiera saldo suficiente de la cantidad               reservada se ajustará automáticamente la cantidad reservada.  

           Panel "Operaciones": define si el filtro creado en la carpeta "Procedimientos" debe utilizarse para filtrar las operaciones de la                     orden de producción.     

           Panel "Desecho": define el local de stock/depósito para el ítem desechado cuando el desecho fuera el mismo producto de la                     orden de producción. Si el depósito - "WharehouseCodeTo" viniera en blanco en el mensaje ProductionAppointment utilice lo                 que se definió en el parámetro.

           Panel "APS": define si la integración considera órdenes generadas por el APS. 

• Procedimientos
• Estructura
• Ubicación
• Movimientos y transferencia 
  Los movimientos de stock, entrada o salida y también las transferencias son archivos recibidos por el Protheus. No necesita de filtros, sin embargo deben crearse algunos parámetros para el procesamiento. Estos son: 
  Tipo de movimiento de entrada Producción: utilice el campo SOE.OE_VAR1 
  Tipo de movimiento de salida: utilice el campo SOE.OE_VAR2 
  Tipo de movimiento coproducto: utilice el campo SOE.OE_VAR3

          Tipo de movimiento de entrada Stock: utilice el campo SOE.OE_VAR4

Estos tipos de movimiento se registran en MATA230

• Saldo stock 
  Para la carpeta Saldo de stock tendrá la opción de tres filtros. Tabla SB2, SB8 y SBF. 
  También puede indicar en qué proceso de movimiento debe enviar el saldo al PC-Factory 
  Donde:  
  Factura de entrada: SOE.OE_VAR1 (Marcado = 1; Desmarcado = 0 ) 
  Factura de venta: SOE.OE_VAR2 (Marcado = 1; Desmarcado = 0 ) 
  Movimientos internos: SOE.PARINTG (Marcado = 1; Desmarcado = 0 ) 
  Implantación de saldo: SOE_OE_VAR3(Marcado = 1; Desmarcado = 0 ) 
  Estas opciones son válidas solamente para el envío del Protheus al PC-Factory. Para el request (solicitud del PC-Factory) no tendrá filtros.
  
  

• Seguridad
  Se utiliza para realizar el control de autenticación en el cambio de mensaje entre los sistemas. Permite informar usuario y contraseña que deben ser válidos en el PC-Factory, es decir, informar el usuario y contraseña registrados en el PC-Factory.

Image Added

 Sincronización - PCPA111

La sincronización es el proceso que se utilizará para completar o actualizar la base del PC-Factory con los datos del Protheus. El funcionamiento se dará de la misma forma que las otras rutinas de integración, enviando un mensaje XML al WebService del PC-Factory, respetando las parametrizaciones definidas en el PCPA109. La única diferencia es que se visualizarán todos los datos de la tabla que se estuviera integrando (respetando los filtros) en lugar de un único registro.
 

 

Asuntos pendientes - PCPA110
Rutina para reenviar los mensajes no enviados al sistema PC-Factory, sean estos asuntos pendientes o error. La rutina también permite consultar los mensajes enviados (LOG de envío).
Puede verificar los asuntos pendientes y log de los mensajes que transitan entre los sistemas:

• Archivo de estructuras
• Producto/Ítem
• Local de stock (depósitos)
• Recurso PCP
• Órdenes de producción (Operaciones, Procedimientos, Componentes, Splits) 
• Recursos del piso de fábrica - Herramientas, Equipo y Operador
• Herramientas
• Máquinas del Piso de fábrica
• Procedimiento - Operaciones
• Ubicaciones
• Saldo 

Tiene las siguientes opciones: 

• Reprocesar:  
  Para cada línea seleccionada debe ejecutar el envío de los mensajes.
• Borrar 
  Debe borrar los registros seleccionados
• Grabar XML 
  Esta opción permite grabar el XML en un directorio local de la máquina que está procesando la rutina de asuntos pendientes.
• Actualizar 
  Rehará la búsqueda de los registros, actualizando los datos en la pantalla

Log de importación - PCPA112
Al recibir datos del PC-Factory, el WebService Protheus graba la información para que puedan consultarse (tabla SOG). ). A continuación se listan los movimientos que generan LOG:

• Apunte de producción
• Apunte de parada
• Motivo de desecho
• Motivo de parada
• Movimientos de stock
• Transferencia

Mensajes

Archivos

Transacción ítem: Item_3_001.xsd

Identificador del mensaje: Ítem

Versión: 3_001

Módulo Protheus: SIGAPCP

Tipo de envío: Síncrónica
 

Transacción depósito: Warehouse_1_001.xsd

Identificador del mensaje: Warehouse

Versión: 1_001

Módulo Protheus: SIGAPCP

Tipo de envío: Síncrónica
 

 
Transacción recurso PCP / Máquina SFC: Machine_1_000.xsd

Identificador del mensaje: Machine

Versión: 1_000

Módulo Protheus: SIGAPCP, SIGASFC

Tipo de envío: Síncrónica

En el PCP las máquinas se registran en la rutina de recursos MATA610 y en el Piso de fábrica la rutina es SFCA002. La nomenclatura también está modificada. Al utilizar Piso de fábrica, se denominará MÁQUINA. Al utilizar solamente el PCP, será RECURSO. La rutina de parámetros PCPA109 está preparada para mostrar el nombre de acuerdo con el uso del sistema.
 
Transacción recurso SFC: Resource_1_000

Identificador del mensaje: Resource

Versión: 1_000

Módulo Protheus: SIGASFC

Tipo de envío: Síncrónica

Transacción estructura: ItemStructure_1_000.xsd

Identificador del mensaje: ItemStructure

Versión: 1_000

Módulo Protheus: SIGAPCP

Tipo de envío: Síncrónica
 

Transacción procedimiento - Operaciones del ítem: ItemScript_1_000.xsd

Identificador del mensaje: ItemScript

Versión: 1_000

Módulo Protheus: SIGAPCP

Tipo de envío: Síncrónica
 

Transacción ubicaciones: AdressStock_1_000.xsd

Identificador del mensaje: AdressStock

Versión: 1_000

Módulo Protheus: SIGAPCP

Tipo de envío: Síncrónica
 

 
Transacción saldo: ItemStockLevel_1_000.xsd

Identificador del mensaje: ItemStockLevel

Versión: 1_000 Módulo Protheus: Varios

Tipo de envío: Síncrónica
 

Transacción Motivo de desecho: WasteReason_1_000.xsd

Identificador del mensaje: WasteReason

Versión: 1_000

Módulo Protheus: SIGAPCP/SIGASFC

Tipo de envío: Síncrónica
 

Transacción Motivo de parada: StopReason_1_000.xsd
Identificador del mensaje: StopReason

Versión: 1_000

Módulo Protheus: SIGAPCP/SIGASFC

Tipo de envío: Síncrónica
 

 Transacción Orden de producción: ProductionOrder_2_004.xsd

Identificador del mensaje: ProductionOrder

Versión: 2_003

Módulo Protheus: SIGAPCP

Tipo de envío: Síncrónica

Procesos

Transacción Apunte de producción: ProductionAppointment_2_000.xsd

Identificador del mensaje: ProductionAppointment

Versión: 2_003

Módulo Protheus: SIGAPCP/SIGASFC

Tipo de envío: Síncrónica