Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Totvs custom tabs box
tabs01- Acceso, 02 - Workflow, 03 - Puerta Multiprotocolo
idsconfig1,config2,config3,config4
Totvs custom tabs box items
defaultyes
referenciaconfig1
Informações
titleAcceso Embarcado - Protheus

*Embarcado: Acceso por menú del Protheus.

Es necesario agregar al menú de Compras la rutina PGCA010 para acceder al NFC mediante el menú del Protheus. A partir del release 12.1.2410 la rutina estará en el menú por estándar.

Ejemplo:

Totvs custom tabs box items
defaultno
referenciaconfig2
Informações
titleWORKFLOW

El Workflow se podrá configurar para enviar la solicitud de cotización, directamente a los proveedores participantes.
Esto permitirá al proveedor, por medio de un formulario recibido en el e-mail, informar precio, plazo y condiciones de oferta de su producto, actualizando automáticamente la cotización en el Protheus.

Informações
titleCÓMO CONFIGURAR EL WORKFLOW
Informações
titleAtención

El Workflow se puede configurar de dos maneras: por Wizard (Configuración del Workflow), que es un asistente paso a paso para facilitar la configuración, disponible en la página del NFC, solamente para usuarios administradores, así como también se puede configurar manualmente, siguiendo las orientaciones del presente documento.

Tenemos también el wizard para crear la caja de e-mail para los compradores - directamente en el workflow - que queda disponible si el parámetro MV_PGCWF estuviera activo en la base o también, la configuración se puede hacer manualmente.

Si desea utilizar el Wizard para configurar el WorkFlow, lea las instrucciones y haga clic en la solapa Por medio Wizard. Si desea configurar manualmente, lea las instrucciones de la solapa Por medio Manual

Aviso
titleSugerencia

Utilice el facilitador de prueba WFTEST estándar del Protheus para validar de manera fácil la configuración y funcionamiento del workflow. Acceda a la documentación: Haga clic aquí | WFTEST

Totvs custom tabs box
tabsPor medio Wizard, Por medio Manual
idswizard,manual
Totvs custom tabs box items
defaultyes
referenciawizard
Expandir
titleConfiguración WorkFlow
  • Para iniciar el proceso de configuración de Workflow por NFC, el usuario conectado debe ser del tipo administrador en el Protheus. Para configurar, siga los siguientes pasos:
    • Acceda al NFC con usuario administrador.
    • Haga clic en la opción de perfil (icono a la derecha, en la parte superior de la pantalla), para mostrar los submenús existentes. Haga clic en el menú con el nombre Wizard WebService/Parámetros
    • Siga las etapas del wizard, informando los datos solicitados:
      • En la primera etapa de la configuración - el sistema explicará para qué sirve el Wizard del Workflow y sus objetivos, para que el usuario pueda entender su funcionamiento.
      • En la segunda etapa del wizard - Parámetros y archivos - informe en el campo Directorio de trabajo del Workflow - el lugar (carpeta) donde los archivos físicos del wizard se grabarán en el servidor. Por ejemplo, si los archivos se grabarán en la estructura Protheus_Data\workflow, informe \workflow en el campo.
        OBS: El valor del campo se almacenará en los parámetros (SX6) MV_WFDIR y MV_WFDHTTP
        Además, constará en esta pantalla enlaces para el acceso a la documentación de referencia del NFC, así como a los dos archivos html que se utilizan para enviar el e-mail a los proveedores. Descargue (download) estos archivo y colóquelos en la misma carpeta de dicho campo.
        Haga clic en la opción Próxima etapa, para avanzar en el wizard.
      • En la tercera etapa - Datos del servidor - informe la Dirección (IP) pública del servidor del workflow. Informe el Puerto del Servidor de workflow. Informe el Nombre del Entorno donde el workflow se ejecuta y en el campo Nombre/IP y puerto del servidor, el sistema monta automáticamente la sugerencia, con la dirección IP, puerto y nombre del entorno.
        OBS: El valor del campo Nombre/IP y puerto del servidor de workflow se almacenará en el parámetro (SX6) MV_WFBRWSR.
        Haga clic en la opción Próxima etapa, para avanzar en el wizard.
      • En la cuarta etapa - Puerto Multiprotocolo - el sistema avisará si existe la clave [MULTIPROTOCOL] en el entorno, y si está activa.
        Haga clic en la opción Próxima etapa, para avanzar en el wizard.
      • En la quinta etapa - Parámetros de e-mail de los compradores - informe los datos solicitados en la pantalla, como dirección y puerto del servidor SMTP y POP3/MAP, para que cuando el parámetro MV_PGCWF esté activo, los usuarios no necesiten informar estos campos en el wizard de configuración de e-mail.
      • OBS: Los valores de los campos de esta etapa se grabarán en los parámetros (SX6):
        MV_PGCPISV - Servidor de e-mail POP 3/ IMAP de los compradores.
        MV_PGCPIPO - Puerto de e-mail POP 3/ IMAP de los compradores.
        MV_PGCSMSR - Servidor de e-mail SMTP de los compradores.
        MV_PGCSMPO - Puerto de e-mail SMTP de los compradores.
        MV_PGCTAUT - Tipo de autenticación del servidor de e-mail: TLS, SSL o ninguno
        Haga clic en la opción Próxima Etapa, para avanzar en el wizard.
      • En la sexta etapa - Finalización - el sistema avisa que al avanzar, los datos se grabarán en la base y el sistema montará el modelo de appserver.ini, además mostrará una notificación de éxito.


Expandir
titleConfiguración - e-mail del comprador
  • Para iniciar el proceso de configuración de E-mail del comprador por NFC, el parámetro MV_PGCWF debe estar activo en el entorno. Para configurar, siga los siguientes pasos:
    • Acceda al NFC.
    • Haga clic en la opción de perfil (icono a la derecha, en la parte superior de la pantalla), para mostrar los submenús existentes. Haga clic en el menú con el nombre Wizard E-mail comprador
    • Siga las etapas del wizard, informando los datos solicitados:
      • En la primera etapa de la configuración - el sistema explicará para qué sirve el Wizard del E-mail del comprador y sus objetivos, para que el usuario pueda entender su funcionamiento.
      • En la segunda etapa del wizard - E-mail del comprador - el sistema traerá en el campo e-mail del comprador el e-mail que consta en el usuario conectado, simplemente informe el nombre que estará en el e-mail.
        Haga clic en la opción Próxima etapa, para avanzar en el wizard.
      • En la tercera etapa - Autenticación - el campo de e-mail se completará automáticamente, según el e-mail registrado en el usuario, y debe informar la contraseña del e-mail, que se utilizará en la autenticación de los servidores de e-mail.
        Haga clic en la opción Próxima Etapa, para avanzar en el wizard.
      • En la cuarta etapa - Servidores SMTP y POP 3/IMAP - si el usuario administrador utilizó el wizard de configuración de parámetros y webservice, o haya informado los parámetros MV_PGCPISV, MV_PGCPIPO, MV_PGCSMSR, MV_PGCSMPO y MV_PGCTAUT, las informaciones de servidores SMTP y PO3/IMAP estarán informadas automáticamente, es solo seguir la siguiente etapa. Pero si es necesario, el usuario puede cambiar manualmente, según su necesidad.
        Haga clic en la opción Próxima etapa, para avanzar en el wizard.
      • En la quinta etapa - Finalización - el sistema avisa que al avanzar se creará una nueva caja de e-mail y se enviará un e-mail como prueba, para verificar los datos imputados. Al final, aparecerá un aviso de éxito, indicando que la cuenta se creó con éxito.



    • Para editar la contraseña u otra característica del e-mail creado del comprador:
      • Es solo repetir dichas etapas, para que el sistema entienda que se trata de un cambio y grabe los nuevos valores en el sistema. Al final, el sistema emitirá un aviso, informando que el e-mail se modificó con éxito.
Totvs custom tabs box items
defaultno
referenciamanual
Expandir
titlePaso 1 - Configuración del WebService en el appserver.ini
  • Actualice el appserver.ini de su entorno con configuraciones esenciales, esto permitirá que el proveedor reciba y responda el formulario de solicitud de cotización.

    Copie e incluya en su entorno el siguiente ejemplo, modifique las informaciones en negrita a informaciones de su entorno, tales como:
    PATH: Camino de las carpetas en su servidor hasta el directorio Protheus_data\http-root (si la carpeta http-root no existe, puede crearla)
    PORT: Puerto de comunicación del WebService (Generalmente se inicia con 80)
    ENVIRONMENT: Nombre del entorno/RPO
    localhost:8091: IP público y puerto abierto para que el proveedor logre enviar la respuesta del formulario de cotización
    ONSTART: Si su appserver.ini ya tenía una clave ONSTART, agregue los job JOB_WS_T1,WF_INDEX a esta clave.

    Informações
    iconfalse
    titleEXEMPLO WEBSERVICE PGC

    ;-------------------------------- WEBSERVICE - NFC--------------------------------------------

    [HTTP]
    ENABLE=1
    PATH=C:\TOTVS\Protheus12_2310\Protheus_data\http-root
    PORT=8091
    ENVIRONMENT=P2310
    INSTANCES=1,10
    XFRAMEOPTIONS=ALLOW-FROM *
    UPLOADPATH=\web

    [localhost:8091/ws]
    ENABLE=1
    PATH=C:\TOTVS\Protheus12_2310\Protheus_data\web\ws
    ENVIRONMENT=P2310
    INSTANCENAME=WS
    RESPONSEJOB=JOB_WS_T1
    DEFAULTPAGE=wsindex.apw

    [JOB_WS_T1]
    TYPE=WEBEX
    ENVIRONMENT=P2310
    INSTANCES=1,10
    SIGAWEB=WS
    INSTANCENAME=WS
    ONSTART=__WSSTART
    ONCONNECT=__WSCONNECT
    PREPAREIN=ALL

    [localhost:8091/wf]
    enable=1
    port=8091
    PATH=C:\TOTVS\Protheus12_2310\Protheus_data
    environment=P2310
    responsejob=WF_INDEX
    DEFAULTPAGE=wsindex.apw

    [WF_INDEX] 
    TYPE=WEB
    environment=P2310
    INSTANCES=1,10
    SIGAWEB=WF
    INSTANCENAME=WF
    ONSTART=STARTWEBEX
    ONCONNECT=CONNECTWEBEX
    ONEXIT=FINISHWEBEX

    [MAIL]
    Protocol=SMTP
    ExtendSMTP=1
    SSLVersion=3
    AuthLOGIN=1
    AuthPLAIN=1
    TLSVersion=3

    [OnStart]
    jobs=JOB_WS_T1,WF_INDEX

Expandir
titlePaso 2 - Configuración del parámetro MV_WFBRWSR

Realice la configuración del parámetro que indicará la URL o nombre del servidor  HTTP.

  • En el paso 1, definimos el IP y Puerta público que se utilizará para recibir la respuesta de la solicitud de cotización de nuestro proveedor, este mismo IP y Puerto se deben informar en el parámetro MV_WFBRWSR.

    Aviso
    titleImportante:

    El parámetro se debe informar iniciando con http:// o https://
    Ejemplo:
    http://localhost:8091/wf 
    Donde localhost:8091 será su IP y puerto público definido en el paso 1.                                                                                                                                                      




Expandir
titlePaso 3 - Directorio de disponibilidad de los HTML

Verifique la existencia de la carpeta "workflow" dentro de la carpeta "Protheus_data" en el directorio de instalación del Protheus. Si no existe, se puede crearla.

  • Realice la descarga (download) del siguiente archivo, descomprima y colóquelos dentro de la carpeta workflow mencionada anteriormente.


Ejemplo
:



Aviso
titleImportante:

Si decide poner a disposición los archivos en otro directorio, no deje de actualizar el parámetro MV_WFDIR del paso 4.                                                                                                                                                    


  • Versión:
    • Es esencial verificar la versión correcta de los archivos del formulario workflow. Si no se encuentran o están en una versión incorrecta, el sistema muestra el siguiente mensaje: 'El archivo pgca030_mailXXX_AAAAMMDD.HTML utilizado por el workflow no se encontró o está desactualizado. Para bajar el archivo actual, consulte la documentación del NFC en la sección de Workflow'.
  • Observaciones:
    • Para paquetes de expedición continua anteriores al 28/03/2024, debe utilizarse el archivo zip
    • Para preservar la integridad de la funcionalidad del workflow, es importante no modificar el nombre de los archivos HTML.
  • Versiones:
Expandir
titlePaso 4 - Configuración del parámetro MV_WFDIR

Realice la configuración del parámetro que indicará el directorio donde los archivos HTML del paso 4 se pusieron a disposición.

  • En el paso 3, definimos el directorio donde se pondrán a disposición los archivos HTML, este mismo directorio se debe informar en el parámetro MV_WFDIR

Ejemplo de contenido del parámetro MV_WFDIR: \workflow





Aviso
titleImportante:

Si decide poner a disposición los archivos en otro directorio, no deje de mover los archivos HTML al directorio correcto, siguiendo el paso 3.                                                                                                                                           

Aviso
titleAtención - WFTEST

El workflow del NFC se comporta igual a la rutina WFTEST - rutina que busca probar si las configuraciones de workflow están correctas, enviando e-mail de prueba.
Luego, si al ejecutar la rutina WFTEST ocurre un error - el workflow del NFC tampoco se enviará, porque sigue el mismo comportamiento - verifique si las configuraciones de parámetros (SX6) y del appserver.ini del entorno están correctas - verificando las informaciones presentes en este manual - para que el workflow del NFC funcione adecuadamente.

Informaciones sobre la rutina WFTEST están en el tópico Asuntos relacionados.

Expandir
titlePaso 5 - Configuración de e-mail en el Protheus

Realice la configuración del e-mail por el que enviará el formulario al proveedor, solicitando la cotización:

  • Acceda al módulo de configuración > Entorno > WorkFlow > Cuentas de e-mail > Incluir


    Ejemplo de configuración de e-mail de GMAIL:

    mceclip0.png

    Informações
    titleObservaciones:
    • Actualmente la mayoría de los proveedores SMTP utilizan un puerto diferente del estándar, generalmente utilizan la 465 o 587. 
    • El Gmail utiliza el puerto 465 cuando la seguridad utilizada es la SSL y el puerto 587 cuando la seguridad es la TLS.
    Aviso
    titleImportante:

    Dicho proceso no está relacionado a la configuración de e-mail para informes, descrito en la documentación: Configure el SMTP para enviar los informes por e-mail.



Expandir
titlePaso 6 - (Opcional) - Envío de solicitud de cotización con el e-mail del comprador

Se puede enviar la solicitud de cotización al proveedor utilizando el e-mail del comprador, esto permite que el proveedor responda directamente al comprador alguna duda o pregunta.

¿Cómo habilitar este recurso?

  1. Habilite el parámetro MV_PGCWF
  2. Realice el paso 5 de la configuración, registrando el e-mail del comprador (Esta rutina de registro se pondrá a disposición en el menú del comprador para que este mismo realice el registro - WFC003).
  3. El e-mail registrado debe constar en el registro de usuario del mismo.

    Aviso
    titleImportante:

    El valor estándar del parámetro MV_PGCWF se desactiva, donde se utilizará la cuenta de e-mail estándar del Protheus definida en el MV_WFMLBOX.

Totvs custom tabs box items
defaultno
referenciaconfig3
Informações
titlePuerto Multiprotocolo
    • En la sección GENERAL, se debe incluir l clave “App_Environment”, cuyo valor debe ser el nombre del entorno donde los servicios se ejecutarán. 
    • En la sección DRIVERS,  se debe habilitar el puerto multiprotocoloen la clave “MultiProtocolPort” con el valor = 
    • Por Como estándar la conexión conexión SSLestá activa en el puerto multiprotocolo, los detalles de las configuraciones están disponibles en la documentación Application Server - Puerto Multiprotocolo. Para inhabilitar la conexión por SSL es necesario informar la clave “MultiProtocolPortSecure = 0”
    Para más información sobre esta configuración, acceda a la página Application Server - Puerto Multiprotocolo.

...

A continuación se pueden visualizar todas las novedades en cada versión:

Expandir
titleExpandir
Expandir
titleMarzo/2024
  1. Implementación de la opción "grabar borrador" en el formulario workflow.
  2. Correcciones generales de usabilidad y desempeño.
Expandir
titleFebrero/2024
  1. Implementación del análisis de cotización por ítem parcial.
  2. Correcciones generales de usabilidad y desempleño.
Expandir
titleEnero/2024
  1. Implementación de la visualización de la observación de la solicitud de compras
  2. Implementación de filtro por comprador en la lista de cotizaciones
  3. Visualización de dados del proveedor en la pantalla de edición de la cotización
  4. Visualización clara de moneda utilizada en la edición de la cotización
  5. Correcciones generales de usabilidad.
Expandir
titleDiciembre/2023
  1. Implementación de generación de cotización utilizando Producto vs Proveedor y MV_SELFOR = N
  2. Implementación de visualización de solicitudes de compras vinculadas a la cotización.
  3. Implementación del listado de pedidos y contratos generados por la cotización.
  4. Corrección de ordenación de propuesta por precio, considerando impuestos.
  5. Modificación de texto para una mejor atención de análisis por propuesta completa.
  6. Ajuste para permitir modificar el TES cuando la cotización se completó por Workflow.
  7. Implementación de la guía de configuración del e-mail del comprador.
  8. Implementación de la guía de configuración y sugerencia del WORKFLOW.
Expandir
titleNoviembre/2023
  1. Corrección en el funcionamiento del WorkFlow, permitiendo la utilización del "WFTEST" estándar para probar el funcionamiento.
  2. Corrección en la lista de solicitudes de compras cuando el campo C1_DATPRF esté marcado como browse.
  3. Correcciones generales de usabilidad y desempeño.
Expandir
titleOctubre/2023
  1. Correcciones diversas en los documentos adjuntos.
  2. Corrección en el filtro de la necesidad de compras.
  3. Corrección en el registro de nuevo participante.
  4. Corrección en el refresh del carriño de compras.
  5. Corrección en el formulario de workflow.
  6. Correcciones generales de desempeño y usabilidad.
Expandir
titleSetiembreSeptiembre/2023
  1. Se implementó la funcionalidad para obtener informaciones del RCPJ del proveedor, por medio de la API de TOTVS Carol.
  2. Se implementó la generación de cotización para proveedor Participantes.
  3. Se incluyó nueva columna que muestra la cantidad de respuestas de los proveedores recibidas por la cotización.
  4. Se implementó la generación del contrato.
  5. Se implementó la funcionalidad para generación de nuevo proveedor para la cotización.
  6. Corrección para limpieza del localStorage en la inicialización de la aplicación.
  7. Corrección para encontrar los documentos adjuntos correctamente si el proveedor fuera participante.
  8. Se retiró cargamento de campos del tipo Memo a la pantalla de Necesidad de compras.
  9. Corrección para validar tipo de contrato y planilla fijos independientemente del parámetro MV_VLDTPFI.
  10. Corrección para que las columnas devuelvan la cantidad de propuestas respondidas y descartadas.
Expandir
titleJunio/2023
  1. Se implementaron Campos personalizados en el Browse de Necesidad de compras y cotizaciones.
  2. Se implementó la funcionalidad de grabar preferencias de campos del tipo suite en Necesidad de compras.
  3. Se efectuó la mejora de devolución de mensaje de la API de Workflow para facilitar la implantación.
  4. Corrección para que después de efectuar la búsqueda por código de producto y limpiar el campo.
  5. Corrección para retirar la obligatoriedad de los campos en la actualización de los contactos.
  6. Corrección para que al declinar una Propuesta del Workflow el proceso ocurra correctamente.
  7. Corrección para que al utilizar otras monedas en el formulario de Workflow la grabación ocurra correctamente.
  8. Corrección para el bloqueo de productos que ocurría de forma intermitente en la Generación de cotización.
  9. Corrección del ícono de documento adjunto al visualizar documentos adjuntos y finalizar la lista.
  10. Corrección para considerar los valores de gasto y seguro en el Análisis por ítem.
  11. Corrección para que después de efectuar el Análisis "Por ítem" de Cotización parcial, sea posible dar continuidad al proceso con la cantidad restante.
  12. Corrección para ejecutar la URL correcta de la API de Análisis de la cotización.
  13. Corrección para que al borrar todos los documentos adjuntos antes de enviar el Workflow, no ocurra la validación de Documento adjunto no encontrado.
  14. Corrección para que no se permita fecha de recepción de la cotización inferior a la fecha actual.
Expandir
titleMayo/2023
  1. Se implementó el Mapa de cotización.
  2. Se implementó el Filtro por grupo de producto.
  3. Se incluyó el Campo de TES en la Edición de la cotización.
  4. Se incluyó la funcionalidad de Borrado de propuesta.
  5. Corrección de documento adjunto no encontrado.
  6. Corrección de descripción del Título de la pantalla de edición de la cotización.
  7. Corrección del campo de descuento al utilizar Nueva propuesta.
  8. Corrección para no permitir descuento negativo en la Edición de la cotización.
  9. Corrección de error al desistir de bajar el documento ajunto.
  10. Corrección en el Endpoint para devolver propuestas parciales de Proveedores.
  11. Corrección de mensaje de producto bloqueado para productos liberados.
  12. Corrección de error mostrado al realizar un filtro en la solapa Atendidas.
  13. Corrección en el loading de búsqueda de producto.
  14. Corrección en la pantalla de Otros campos para no grabar datos al hacer clic en Finalizar.
  15. Corrección del campo cantidad disponible si MV_ZERPROP = 1.
  16. Corrección en la exhibición de los Impuestos complementarios en la pantalla de impuestos por ítem.
  17. Corrección en el campo Tipo de flete da edición de cotización para el mismo comportamiento del legado.
  18. Corrección de devolución de las cotizaciones por orden del total de la cotización.
Expandir
titleAbril/2023
  1. Implementación de los campos de Cantidad de proveedores participantes y cantidad de productos cotizados en la lista de cotizaciones.
  2. Implementación del de filtro por estatus "Todos, pendientes, en análisis y finalizado" en la lista de cotizaciones.
  3. Implementación de los campos personalizados de la tabla SC8 en la edición de cotización.
  4. Implementación de edición de la observación que se llevará al pedido de compra en el análisis de cotización.
  5. Implementación de opción para generar nuevas propuestas, manual y vía workflow.
  6. Corrección en el envío de e-mail por workflow.
  7. Corrección para mostrar mensaje de aviso al actualizar contacto de proveedor abierto por otro usuario.
  8. Correcciones generales de usabilidad y desempeño.

...