Árvore de páginas

01. DATOS GENERALES


Producto

TOTVS Backoffice

Línea de producto: 

Línea Protheus

Segmento:

Backoffice

Módulo:SIGAFIN - Financiero
Función:
RutinaNombreFecha
receipt.service.tlppServicio de recibos de cobro.28/11/2022
receipt.data.tlppData del servicio de recibos.28/11/2022
delete-receipt.service.tlppServicio de borrado de recibos de cobro.29/11/2022
F887FINMEX.prwEventos del modelo para país México.29/11/2022
cancel-receipt.service.tlppServicio de cancelación de recibo.29/11/2022

cancel-receipt.controller.tlpp

Controlador de servicio de cancelación de recibo.29/11/2022
FINA998.prwAplicativo Totvs Recibos29/11/2022
FINA998A.tlppFuente puente para comunicación de Endpoint.29/11/2022
F887FIN.prwEventos del modelo para todos los países.29/11/2022
País:México
Ticket:NA
Requisito/Story/Issue (informe el requisito vinculado):DMINA-17536


02. SITUACIÓN/REQUISITO

Dentro de la rutina de Totvs Recibos (FINA998), al momento de realizar el borrado de un recibo que tiene una forma de pago tipo CC - Tarjeta de Crédito, el saldo del titulo cobrado no se actualiza correctamente. Además en la rutina anterior de Cobros Diversos (FINA087A), se observa que no se permite el borrado de un recibo de cobro con las mismas características y manda el siguiente mensaje:

 


03. SOLUCIÓN

Dentro de la rutina Aplicativo Totvs Recibos (FINA998.prw), se realizan los siguientes ajustes:

  • En la función que es encargada de Realizar las petición jsonToAdvpl (JsToAdvpl), se realiza el ajuste para esperar la respuesta de la petición al servicio de cancelación de recibo en formato json.

Dentro de la rutina Fuente puente para comunicación de Endpoint (FINA998A.tlpp), se realizan los siguientes ajustes:

  • En la función dedicada especialmente para acceder a los endpoints desarrollados en TLPP a través de un fuente PRW o PRX (FIN998TL), se realiza el ajuste para mandar como parámetro la respuesta de la petición al servicio de cancelación de recibo en formato json.

Dentro de la rutina Servicio de cancelación de recibos de cobro (cancel-receipt.service.tlpp), se realizan los siguientes ajustes:

  • En la función que es encargada de retornar la confirmación de anulado del recibo (getcancelReceiptService), se realiza el ajuste para retornar un json al controlador con el mensaje de error y si fue exitoso o no el proceso de anulación.

Dentro de la rutina Controlador de Servicio de cancelación de recibos de cobro (cancel-receipt.controller.tlpp), se realizan los siguientes ajustes:

  • En la función Endpoint para el anulado del recibo (postCancelReceipt), se realiza el ajuste para retornar un json en la petición.

Dentro de la rutina Servicio de  borrado de recibos de cobro (delete-receipt.service.tlpp), se realizan los siguientes ajustes:

  • En la función que encargada de retornar la confirmación de borrado del recibo (getdeleteReceiptService), se realiza el ajuste para detonar la validación del modelo antes de realizar la transacción y evitar el borrado si un recibo cuenta con una cuenta por cobrar ya liquidada. 

Dentro de la rutina Eventos del Modelo para todos los países (F887FIN), se realizan los siguientes ajustes:

  • En la función llamada ModelPosVld, se omite el llamado a la cancelación del recibo. El llamado a la función de cancelación de recibo se realiza al momento de realizar el commit en el modelo (BeforeTTS).

Dentro de la rutina Eventos del Modelo para pais México (F887FINMEX), se realizan los siguientes ajustes:

  • Se crea una nueva función llamada ModelPosVld para detonar las validaciones del modelo antes de realiza la transacción. Se valida si un recibo tiene cuentas por cobrar ya liquidadas, si es el caso, se agrega un mensaje de validación que se mostrara cuando se intente borrar o anular.

Dentro de la rutina Servicio de recibos de cobro (receipt.data.tlpp), se realizan los siguientes ajustes:

  • Se omiten líneas de código que fueron trasladas a la rutina Eventos del Modelo para país México (F887FINMEX).


Consideraciones Previas:

  1. Realizar un respaldo del repositorio (RPO).
  2. Aplicar el parche correspondiente al issue DMINA-17536.
  3. Validar que las rutinas actualizadas en el repositorio, coincidan con las descritas en el encabezado del presente Documento Técnico, así como las fechas.
  4. Registrar en el módulo Financiero el Tipo de Título:
    1. Tipo original del sistema (ES_TIPORIG) = CC
    2. Tipo (ES_TIPO) = CC
    3. Cartera (ES_CARTEIR) =  3-Todas
    4. Suma/Resta (ES_SINAL) = + - Suma
    5. Pagar/Cobrar (ES_BXRCOP) = 1 - Si
    6. Gen. en RC/OP (ES_RCOPGER) = 1 - Tit por cobrar/Pagar
  5. Registrar en el módulo Financiero un cliente (SA1) normal de ventas el cual será vinculado con una Administradora Financiera.
  6. Registrar en el módulo Financiero un cliente (SA1) normal de ventas.
  7. Registrar en el módulo Financiero una Administradora Financiera (SAE) registrando en el campo Cliente (AE_CODCLI) el registrado en el punto 5.
  8. Generar una Factura de Venta (SIGAFAT >> Actualizaciones | Facturación | Facturaciones) registrando el Cliente (F2_CLIENTE) registrado en el punto 6. 
  1. Registrar un recibo de cobro en TOTVS Recibo (SIGAFIN >> Movimientos | Cuentas por Cobrar | TOTVS Recibo)
  2. Se ingresa a la opción de "Nuevo recibo".
  3. Capturar los datos del encabezado.
  4. Seleccionar en la sección de "Títulos a Cobrar o Compensar" la factura generada en las pre-condiciones (8).
  5. Agregar la forma de pago:
    1. Seleccionar Tipo Valor (EL_TIPO) = CC - Crédito.
  6. A continuación, informar la Administradora Financiera y guardar el recibo.
  7. Verificar en Títulos a Cobrar  (SIGAFIN >> Consultas| Archivos | Cuentas por Cobrar | Posición de Títulos a Cobrar) que el registro generado de tipo CC se muestre como Movimiento Anulado (Status Rojo).
  8. Desde la opción "Buscar Recibo", se procede a borrar el recibo de cobro.
  9. Al dar clic en "Borrar".
  10. En la siguiente ventana se confirma el borrado del recibo y se mostrará el siguiente mensaje y no permitirá el borrado:


04. INFORMACIÓN ADICIONAL


¡IMPORTANTE!

La presente solución aplica para versión 12.1.33 o superior, siempre y cuando se tengan las rutinas actualizadas a la fecha indicada en la sección 01 - Datos Generales.


05. ASUNTOS RELACIONADOS

  • Totvs Recibos - Funcionalidad - Nuevo Recibo