Protheus - Guia Cloud TOTVS - TDN

ÍNDICE

01. VISIÓN GENERAL

Mientras las Fintechs son empresas del mercado financiero que utilizan tecnología para ofrecer servicios convencionales, la Techfin va más lejos: se trata de una empresa de tecnología y datos, que ofrece servicios financieros personalizados y más competitivos para ayudar a las empresas a superar los desafíos de sus negocios.

TOTVS Techfin llega al mercado con el objetivo de revolucionar las soluciones de crédito, pagos y servicios, utilizando para ello el poder de la tecnología, en esta página es posible evaluar las configuraciones necesarias para las integraciones de Techfin con Protheus

02. DETALLE

    Para iniciar el Wizard de configuración, el usuario debe digitar WizardTF1 en la pantalla inicial


    Haga clic en OK

    Verifique si los requisitos iniciales están atendidos y haga clic en Avanzar


    Digite un usuario con poder de Administrador, su contraseña, y seleccione las empresas que se configurarán y haga clic en Avanzar

    Seleccione el Producto que se configurará, en este caso será TOTVS Más plazo o TOTVS Anticipa y haga clic en Avanzar


    Acepte la verificación del uso compartido de los parámetros


    Digite el ClientID y la Client Secret, enviadas por Techfin

    Complete los parámetros de acuerdo con lo solicitado







    Para más información sobre la integración TOTVS Anticipa, consulte el siguiente enlace:

    Integración Protheus vs. TOTVS Anticipa

    Para más información sobre la integración TOTVS Panel financiero, consulte el siguiente enlace:

    Integración Protheus vs. TOTVS Panel financiero

    Para iniciar la implementación del TOTVS Más plazo es necesario:

    1) Aplicar la última expedición continua del Protheus, junto con el diferencial de diccionario por medio del UPDDISTR, de acuerdo con su versión de la Release. 

    2) Efectuar los registros de los siguientes ítems:

    • Proveedor Supplier.
    • Modalidad financiera. 
    • Motivo de baja que no genera movimiento bancario ni cartera pagar (P)

    3) Ejecutar el wizard de acuerdo con los pasos, según la solapa Wizard de configuración

    La operación consiste en programar en agenda la ejecución por el FINA137F, que es el JOB responsable por solicitar los movimientos a la TechFin y ejecutarlos en el Protheus. 

    Flujo de operaciones:

    1)  El JOB FINA137F con programación en agenda y periodicidad de 1 en 1 hora, permitirá una solicitud ante TechFin para recibir el mensaje, con los movimientos que se ejecutarán en el Protheus. El cliente podrá ajustar su periodicidad, sin embargo, se recomienda no aumentar demasiado este intervalo, para mantener el portal de la Techfin, lo más sincronizado posible con el Protheus

    2) Una vez realizado el movimiento en el Protheus, el sistema enviará a Techfin las operaciones realizadas en el Protheus. Manteniendo sincronizados de esta manera el Protheus y el Portal Techfin.

    3) Los títulos que pueden negociarse son los que tienen código de barras registrados. 

    La baja de los títulos se realizará con el motivo de baja configurado en el Wizard, recordando que el Motivo de baja, no genera movimiento bancario, por esta razón esta baja no se mostrará en el extracto bancario. Su historial se enviará por la Plataforma. 


    Esta baja no genera movimiento bancario, observe que el motivo de baja es TEC, la misma seleccionada en el wizard registrada previamente, con la opción Genera movimiento bancario = "N", el Historial "BOLETA PAGADA" es enviado por la Techfin, la fecha de baja es la fecha de procesamiento. 


    La Inclusión de nuevos títulos se efectuará de acuerdo con la negociación realizada en el portal Techfin, los valores se informarán con los intereses incluidos. Así como las fechas de vencimientos acordadas. Los códigos de barra se pondrán a disposición debidamente registrados en el título. 

    Observe el rastreo de los títulos y sus desdoblamientos, de acuerdo con las imágenes




    Es posible la prorrogación de los títulos que se negociaron previamente. 

    Las solicitudes de prorrogación se incluirán cuando estén liberadas por el Portal Techfin. 

    Se modificarán las parcelas solicitadas con nuevas fechas de vencimiento, nuevos códigos de barra y aumentadas de intereses negociados.

    Los intereses se incluyen vía Valores adicionales - FKD, con el código seleccionado en el momento del Wizard.




    Tablas involucradas:

    • SE2 - Tablas de cuentas por pagar
    • SE5 - Tabla de movimiento bancario
    • FI8 - Tabla de modalidades financieras
    • FKC - Códigos valores adicionales
    • FKD - Títulos vs. Valores adicionales

    Parámetros involucrados:

    • MV_PRETECF – Prefijo de los títulos negociados, debe contener el prefijo de los títulos a favor de Supplier
    • MV_TPTECF – Tipo de títulos negociados, debe contener el tipo de título de los títulos a favor de Supplier
    • MV_NTTECF – Modalidad de títulos negociados, debe contener la modalidad financiera registrada para los títulos en favor de Supplier
    • MV_FNTECF – Proveedor de títulos negociados, debe contener el código del proveedor registrado para los títulos a favor de Supplier
    • MV_LFTECF – Tienda del proveedor negociado, debe contener el código de la tienda del proveedor registrado para los títulos a favor de Supplier
    • MV_MBXTECF - Código del motivo de baja, de los títulos que se anticiparon.
    • MV_VATECF – Código de los valores adicionales, de los títulos negociados a favor de Supplier, que tuvieron pedido de prorrogación

    **** Importante: El uso compartido de los parámetros debe observarse de acuerdo con la estructura del cliente, se sugiere que los códigos de Proveedores y Modalidades sean los mismos, en todas las sucursales, sin embargo, si esto no fuera posible, debe tratarse de forma exclusiva.

     

    Fuentes involucrados:

    • FINA137E.PRW  (Responsable por la requisición del TOKEN ante Carol)
    • FINA137F.PRW  (Responsable por el JOB que recibe el Json con los títulos que se darán baja / se incluirán o se modificarán)
    • FINA137G.PRW (Responsable por el envío del POST en la plataforma para informar que los títulos generaron movimientos debidamente en el Protheus)
    • FINXAPI.PRW    (Responsable por las rutinas de Baja / Generación de títulos y Modificación de los títulos)

    Con la generación de movimiento a mano, se activarán las siguientes funciones: 

    • FaBaixaCp() para bajar los títulos informados
    • FaIncSE2() para incluir los títulos nuevos
    • FaAltSE2() para modificar los títulos prorrogados

    Después de ejecutar el Wizard, estas tags se agregarán en el appserver.ini

    En la sesión Environment

    fw-tf-debug=0
    fw-tf-carol-endpoint=https://totvstechfindev.carol.ai/api
    fw-tf-platform-endpoint=https://fmscash.dev.totvs.io
    fw-tf-rac-endpoint=https://admin.rac.dev.totvs.app

    [
    {
    "cnpj": "53485215000106",
    "boletos": {
    "pagos": [
    {
    "platformId": "5",
    "erpId": "T1|D MG 01 ||20210121A||NF|000001|01",
    "dataMovimento": "2021-01-21",
    "valor": 350000,
    "historico": "BOLETO PAGO"
    }
    ],
    "gerados": [
    {
    "platformId": "99999900000000001",
    "numeroTransacao": "200000001",
    "valorTotal": 360000.60,
    "juros": 10000.6,
    "parcelas": [
    {
    "numeroParcela": "1",
    "valorParcela": 120000.20,
    "dataVencimento": "2021-02-21",
    "dataEmissao": "2021-01-21",
    "numeroLinhaDigitavel": "34191092060023598295680002060004687700002288835",
    "numeroCodigoBarras": "34196877000022888351092000235982958000206000",
    "historico": "PARCELA GERADA"
    },
    {
    "numeroParcela": "2",
    "valorParcela": 120000.20,
    "dataVencimento": "2021-03-21",
    "dataEmissao": "2021-01-21",
    "numeroLinhaDigitavel": "34191092060023598295680002060004687700002288835",
    "numeroCodigoBarras": "34196877000022888351092000235982958000206000",
    "historico": "PARCELA GERADA"
    },
    {
    "numeroParcela": "3",
    "valorParcela": 120000.20,
    "dataVencimento": "2021-04-21",
    "dataEmissao": "2021-01-21",
    "numeroLinhaDigitavel": "34191092060023598295680002060004687700002288835",
    "numeroCodigoBarras": "34196877000022888351092000235982958000206000",
    "historico": "PARCELA GERADA"
    }
    ],
    "boletoOrigem": [
    {
    "erpId": "T1|D MG 01 ||20210121A||NF|000001|01"
    }
    ]
    }
    ],
    "alterados": []
    }
    },
    {
    "cnpj": "20412968000132",
    "boletos": {
    "pagos": [
    {
    "platformId": "6",
    "erpId": "T2|D MG 01 ||20210121C||NF|TST001|01",
    "dataMovimento": "2021-01-21",
    "valor": 450000,
    "historico": "BOLETO PAGO"
    }
    ],
    "gerados": [
    {
    "platformId": "99999900000000002",
    "numeroTransacao": "200000002",
    "valorTotal": 480000.60,
    "juros": 30000.6,
    "parcelas": [
    {
    "numeroParcela": "1",
    "valorParcela": 240000.30,
    "dataVencimento": "2021-02-22",
    "dataEmissao": "2021-01-21",
    "numeroLinhaDigitavel": "34191092060023598295680002060004687700002288835",
    "numeroCodigoBarras": "34196877000022888351092000235982958000206000",
    "historico": "PARCELA GERADA"
    },
    {
    "numeroParcela": "2",
    "valorParcela": 240000.30,
    "dataVencimento": "2021-03-22",
    "dataEmissao": "2021-01-21",
    "numeroLinhaDigitavel": "34191092060023598295680002060004687700002288835",
    "numeroCodigoBarras": "34196877000022888351092000235982958000206000",
    "historico": "PARCELA GERADA"
    }
    ],
    "boletoOrigem": [
    {
    "erpId": "T2|D MG 01 ||20210121C||NF|TST001|01"
    }
    ]
    }
    ],
    "alterados": []
    }
    }
    ]

    Para habilitar los logs en Console.Log, es necesario incluir en el Appserver.Ini la siguiente línea en la Sesión Environment, de acuerdo con  MP - ADVPL - Cómo activar la función FWLogMsg. – Central de atención TOTVS

    FWLOGMSG_DEBUG = 1