Tempo aproximado para leitura: 05 min

ÍNDICE

Nota

Esta rutina se ajustó para cumplir con la Ley general de protección de datos (Ley n° 13.70), siendo que algunos campos que presentan información considerada como datos sensibles y/o personales se ocultarán, dejando de ser legibles.


01. VISIÓN GENERAL

Este proceso tiene por objetivo poner a disposición el envío de cartas de cobranza a los clientes que tengan títulos atrasados, por vencer o en situaciones personalizadas.

La rutina de envío de carta de cobranza permite que los títulos que estén atrasados, o por vencer, puedan ser cobrados debidamente por medio del envío de cartas de cobranza electrónica (e-mail) y/o física.

Para que las cartas puedan generarse y enviarse, primero deben definirse los tipos de situación de cobranza que se considerarán, el período en el cual se encuentran las cobranzas (referente al tiempo de atraso y/o período por vencer), además de definir el contenido del texto de cobranza que se mostrará.

Las cartas enviadas van a contener los intereses y multas calculados hasta una fecha definida previamente (en parámetro), permitiendo a los destinatarios saber el valor actualizado de la cobranza.

Es posible el envío de la carta de diferentes tipos de texto así como también se permite complementar las validaciones, de forma específica, de los clientes que recibirán las cartas de cobranza.

Un informe de cobranzas efectuadas está a disposición para facilitar el seguimiento de las cartas de cobranza enviadas y sus respectivos destinatarios y títulos cobrados.


02. REGLAS Y DEFINICIONES


Fluxo.png



Parámetros iniciales: Los parámetros iniciales van a permitir efectuar los filtros de los clientes, el intervalo de vencimiento, valor, situación de cobranza, sucursales, títulos por vencer y determinar la fecha de cálculo de interés y multa que se considerarán para envío de las cartas de cobranza. Es posible complementar los filtros de forma personalizada, para lo cual debe implementarse un punto de entrada (F811QRY ver detalle en la sección puntos de entrada de este documento) que permita complementar la query que considerará los parámetros estándar.

 

Selección de layout: Se mostrará una lista de los layouts de carta de cobranza registrados para que sea posible seleccionar qué layout se utilizará para envío. Solamente podrá seleccionarse un único layout de carta de cobranza por envío.

 

Selección de cliente: Se mostrará una lista de los clientes que atienden los criterios del filtro, para que puedan seleccionarse para envío de las cartas de cobranza. Todos se mostrarán en la pantalla seleccionados/marcados.

 

Selección de títulos: El proceso de selección de los títulos que formarán parte de la carta de cobranza sigue los criterios definidos y sugeridos en el envío de las cartas.

Existe la posibilidad de enviar títulos que aún están por vencer, de forma adicional. Es decir, incluirlos como un recordatorio y no como una cobranza. Estos se sugerirán, pero estarán liberados para borrarlos de la carta, si así se determinase.

Cabe resaltar que, con la implementación del Bloqueo por situación de cobranza (vea  http://tdn.totvs.com/pages/viewpage.action?pageId=381044073), los títulos en situación de cobranza con bloqueo configurado para las cartas de cobranza no estarán a disposición en este proceso de envío de e-mail. De esta manera, estos no se listarán en la selección. Para efectuar este bloqueo, se agregará un nuevo proceso estándar a los existentes y este se validará en cada envío.

Además, un título es elegible para el envío de cartas mientras aún tuviera saldo pendiente.

1 - El día 01/03/2015 se envió un e-mail con los siguientes títulos para cobranza, considerando vencimientos con más de 10 días de atraso:


TítuloVencimientoDías de atraso
DUP225130101/02/201528
DUP222210201/01/201559
DUP255120115/12/201476


2 - El 15/03/2015, el cliente efectuó el pago de dos cuotas con mayor atraso, pero no liquidó la cuota del 01/02/2015. De esta manera, el título no liquidado continuará siendo enviado en las nuevas cartas de cobranza, con el número de días de atraso actualizado.

TítuloVencimientoDías de atraso
DUP225130101/02/201548


Resaltamos que este ejemplo considera solamente el vencimiento, pero que el título debe respetar todas las reglas del filtro.


Rutina: FINA810 - Layouts de carta de cobranza

Cada carta enviada 

se definirá de acuerdo con el contenido de cobranza, es decir, será posible incluir un texto de un determinado contenido para diferentes tipos de cobranzas.

Para ello, se pondrán a disposición formas de configurar los textos de las cartas y vincularlas a determinadas reglas vía registro. Estarán a disposición solamente características del cliente para validación combinada con el filtro de/a. No siendo necesario, este podrá mantenerse en blanco, para que las cartas se envíen a cualquier cliente.

Las cartas obedecen los filtros informados en la rutina de envío, validando los datos del cliente vinculado al contenido de la carta. Esta configuración puede utilizar campos personalizados para su composición.

En la lista de títulos, las columnas consideradas como estándar están a continuación:

    • Clave del título – Prefijo, número y cuota
    • Fecha de vencimiento
    • Días de atraso
    • Valor original
    • Saldo del título
    • Multa
    • Interés

Habrá la posibilidad de agregar/retirar nuevas columnas, siempre y cuando estas formen parte del título por cobrar (SE1), considerando que, por tratarse de un envío de e-mail y/o carta física, puede haber algún tipo de restricción con respecto a la cantidad de información contenida en la carta/planilla.

Si el método de envío seleccionado fuera físico o ambos, la carta debe contener en la parte superior, los datos de envío, con el nombre y dirección del cliente. La dirección utilizada será la dirección de cobranza contenido en el archivo del cliente. Si esta dirección estuviera en blanco, el envío se realizará a la dirección del cliente. En el layout de la carta, es posible definir el alineamiento de la dirección del cliente en la parte superior de la carta.


  - Digitación del encabezado del archivo donde se define el método de envío, los textos (principal de la carta, saludo y finalización), así como la posición de la dirección (para cartas impresas).

Layout_1.JPG

 - En el pie de página existen 2 solapas donde se definen los campos del cuentas por cobrar (tabla SE1) que se presentarán en la carta (nº del título, valor, fecha de vencimiento, etc.), así como se definen las reglas personalizadas de envío. En este campo debe informarse una expresión como las de filtros de pantalla (browse) del Protheus. Está marcada la tabla de Clientes (SA1). 

Layout_2.JPG

Rutina: FINA811 - Envío de las cartas de cobranza

Para el envío de las cartas, debe responderse cada etapa del wizard, de acuerdo con la siguiente explicación.

 - Pantalla inicial del wizard.

Step_1.JPG


 - Definición de los parámetros para búsqueda y filtrado de la información. 

  1. De Cliente y tienda (intervalo inicial de cliente y tienda).
  2. A Cliente y tienda (intervalo final de cliente y tienda).
  3. De Vencimiento (intervalo de vencimiento inicial de los títulos).
  4. A Vencimiento (intervalo de vencimiento final de los títulos)
  5. De Valor (intervalo de valor inicial de los títulos).
  6. A Valor (intervalo de valor final de los títulos).
  7. Selecciona sucursales (si se definiera con "Sí", la pantalla estándar de selección de sucursales se mostrará para que puedan seleccionarse las sucursales).
  8. Situación de cobranza (se mostrará la misma consulta utilizada en el requisito "Procesos SERASA", permitiendo que se seleccione una o más situaciones de cobranza. Este campo se valida para no dejarse en blanco al avanzar en el proceso).
  9. Títulos por vencer (si estuviera como sí, el filtro va a considerar los títulos que aún están por vencer).
  10. Fecha de referencia para cálculo de interés y multa de los títulos.
  11. Considera valor (si se definiera con "1-Valor total", el sistema filtrará los registros con contenido en el campo E1_VALOR entre los valores informados en los ítems 5 y 6 de esa ventana. Si se definiera con "2-Saldo", el sistema filtrará los registros con contenido en el campo E1_SALDO entre los valores informados en los ítems 5 y 6 de esa ventana).
  12. ¿Considera cliente bloqueado? Esta pregunta validará el campo A1_MSBLQL de los clientes. Si se cumplimenta con SÍ, se considerarán todos los clientes independientemente del estatus del campo de bloqueo. Si NO, solo se considerarán clientes activos. 


  - Selección del layout de la carta (solamente podrá seleccionarse 1 layout).


Step_3.JPG


 - Selección del(de los) cliente(s).

Step_4.JPG


IMPORTANTE: En esta pantalla del wizard existe una opción para la realización de filtros en la lista de clientes ("Filtrar"), pero solamente los campos presentados en pantalla están disponibles para filtro. Para incluir otros campos, inclusive campos personalizados, pueden utilizarse los siguientes puntos de entrada:

F811FL3 - Permite incluir campos en la ventana de filtro de la página 3

F811FL4 - Permite incluir campos en la ventana de filtro de la página 4

F811FL5 - Permite incluir campos en la ventana de filtro de la página 5


 - Selección del(de los) título(s).

Step_5.JPG

Cabe resaltar que la selección de títulos debe considerar el bloqueo de situación de cobranza configurado (conforme se citó anteriormente).

 

 - Envío o impresión de las cartas.

Step_6.JPG


 - Consulta de log de los envíos y finalización del proceso.

Step_7.JPG

 - Consulta del log


 - Modelo del e-mail enviado al cliente.

image2019-1-29_18-12-0.png


Para toda y cualquier carta (enviada o impresa) se genera un registro en la tabla FWT, que contiene el layout utilizado, la fecha del envío, además de la clave de identificación.

Todas las grillas tienen la opción de marcar o desmarcar todos los registros (con excepción de la grilla de layouts de cartas de cobranza, donde solamente podrá seleccionarse un layout).

IMPORTANTE: Es una premisa que el e-mail en el archivo de clientes esté completado para que la cobranza se envíe y que el servicio de envío de e-mail del Protheus esté configurado.

Al final del envío, se grabará un registro de log de la carta enviada para emisión de informe. Para ello, se almacenará la siguiente información de cada título enviado:

    • Número de proceso - para identificación de la carta enviada.
    • Clave del título
    • Fecha de envío
    • Código del layout

IMPORTANTE: Un título puede tener N ocurrencias en esta tabla, pero en procesos diferentes. Puede ocurrir que una carta se envíe más de una vez a un cliente en una misma fecha, y no habrá restricciones con respecto a eso, pues durante el día podrán ocurrir bajas e inclusión de nuevos documentos en el Protheus.

Solamente estos dados son suficientes para reproducir el e-mail con la cobranza enviada:

    • Texto de la carta (opcional)
    • Lista de títulos vencidos.
    • Lista de títulos por vencer

Los títulos de los siguientes tipos no se consideran en la selección, además de los parámetros informados, ya que no representan valores de cobranza adeudados:

  • Provisionales (PR)
  • Cobranzas anticipadas (RA)
  • Tasas (TX, TXA) 
  • NCC
  • Descuentos

Rutina: FINR811 - Informe de cartas de cobranza

El informe permite la ejecución de 2 formas (analítica o sintética). En la forma analítica se muestra la carta completa, con los textos y otros detalles. En la forma sintética, solamente se muestran las cartas que se enviaron, sin embargo, sin los textos, es decir, solamente un resumen.

Además del tipo de impresión (sintético o analítico), el informe permite las siguientes parametrizaciones:


 - Impresión en el modelo analítico

Habrá un salto de página en cada impresión de carta y las columnas de los títulos no seguirán la configuración en el layout, ya que el informe exige una estructura fija. 


 - Impresión en el modelo sintético


Otros campos de la tabla SE1 estarán disponibles para agregar al informe, considerando la limitación del área de impresión vs. tamaño de la página.

 

Recordando que el modelo del informe debe ser el mismo del e-mail enviado, reestructurado en tiempo de impresión con los datos almacenados.


03. PARÁMETROS UTILIZADOS

Para envío de las cartas por e-mail se utilizan los siguientes parámetros:

ParámetroDefinición
FINA811
<= 23/08/2022
FINA811
 > 23/08/2022
MV_RELSERVNombre del servidor de envío de e-mail
MV_RELACNTMV_FINACNT Cuenta que se utilizará en el envío de e-mail
MV_RELPSWMV_FINPSWContraseña de la cuenta de e-mail
MV_RELFROMMV_FINFROME-mail utilizado en el campo FROM en el envío del e-mail
MV_RELBODYDetermina el asunto estándar en el envío del e-mail. Se utilizará cuando no se complete el campo FWP_TXTASS
MV_RELAUTHDetermina si el servidor exige autenticación
MV_RELAUSRMV_FINACNT Usuario para autenticación en el servidor de e-mail (si así lo exigiera el servidor)
MV_RELAPSWMV_FINPSWContraseña para autenticación en el servidor de e-mail (si así lo exigiera el servidor)


Para más información, acceda a Utilización de los parámetros MV_FINACNT, MV_FINPSW y MV_FINFROM.


04. PUNTOS DE ENTRADA

Para información sobre los puntos de entrada de esta rutina acceda a Envío de carta de cobranza - FINA811.


05. DATOS TÉCNICOS


Archivo: FWP – Carta de cobranza

Tabla

Descripción

Sigla

FWP

Nombre

Cartas de cobranza

Mod. Ac. Sucursal

Exclusivo

Mod. Ac. Unidad

Exclusivo

Mod. Ac. Empresa

Exclusivo

Clave única

FWP_FILIAL+FWP_CODCRT

Índice

Clave

01

FWP_FILIAL+FWP_CODCRT

Campo

FWP_FILIAL

Tipo

Carácter

Tamaño

8

Descripción

Sucursal del sistema

Título

Sucursal

Picture

@!

Grupo de campos

033

Help de campo

Sucursal del sistema

Campo

FWP_CODCRT

Tipo

Carácter

Tamaño

6

Descripción

Código del layout

Título

Cód. Layout

Picture

@!

Help de campo

Defina el código del layout de la Carta de cobranza.

Campo

FWP_DESCRI

Tipo

Carácter

Tamaño

40

Descripción

Descripción del layout

Título

Descripción

Picture

@!

Help de campo

Defina la descripción del layout de la carta de cobranza. Esta descripción se mostrará en la rutina de envío de cartas de cobranza y en el informe de cobranzas enviadas.

Campo

FWP_STATUS

Tipo

Carácter

Tamaño

1

Descripción

Estatus del layout

Título

Estatus

Picture

@!

Validación

Pertence("12")

Lista de opciones

1=Activo;2=Inactivo

Help de campo

Define si el layout de la carta de cobranza está activo o inactivo. Solamente layouts activos podrán enviarse en cobranza.

Campo

FWP_TXTSAU

Tipo

Carácter

Tamaño

60

Descripción

Texto de saludo

Título

Saludo

Help de campo

Texto de saludo que se enviará en la carta de cobranza. El texto de saludo representa el inicio de la carta. Ejemplo: "Estimado cliente"

Campo

FWP_TXTCRT

Tipo

Memo

Tamaño

500

Descripción

Texto de la carta

Título

Txt Carta

Help de campo

El texto incluido en este campo es el texto que se enviará en el cuerpo de la carta con el contenido de la cobranza.

Campo

FWP_TXTCON

Tipo

Memo

Tamaño

500

Descripción

Texto de finalización

Título

Finalización

Help de campo

El texto de finalización, si se informara, se enviará al final de la carta, como complemento de la cobranza efectuada o con información adicional.

Campo

FWP_ENVIO

Tipo

Carácter

Tamaño

1

Descripción

Tipo de envío

Título

Tp Envío

Picture

@!

Lista de opciones

1=E-mail;2=Carta física;3=Ambos

Validación

Pertence("123")

Help de campo

Tipo de envío de la carta de cobranza, siendo: E-mail - las cartas se enviarán al e-mail contenido en el archivo de clientes; Carta física - el envío de la carta se realizará de forma física, es decir, la carta impresa se enviará directamente al cliente; Ambos - el envío se efectuará de las dos formas.

Campo

FWP_POSVER

Tipo

Numérico

Tamaño

4

Descripción

Pos Vertical de la dirección

Título

Pos Vertical

Picture

@E 9,999

Help de campo

Posición inicial vertical de la dirección en pixels. Este campo solamente se habilitará si el layout estuviera con la forma de envío definida como "Carta física" o "Ambos".

Campo

FWP_POSHOR

Tipo

Numérico

Tamaño

4

Descripción

P Horizontal de la dirección

Título

P Horizontal

Picture

@E 9,999

Help de campo

Posición inicial horizontal de la dirección en pixels. Este campo solamente se habilitará si el layout estuviera con la forma de envío definida como "Carta física" o "Ambos".


Arquivo: FWQ – Reglas de envío  

Tabla

Descripción

Sigla

FWQ

Nombre

Reglas de envío

Mod. Ac. Sucursal

Exclusivo

Mod. Ac. Unidad

Exclusivo

Mod. Ac. Empresa

Exclusivo

Clave única

FWQ_FILIAL+FWQ_LAYOUT


 

Índice

Clave

01

FWQ_FILIAL+FWQ_LAYOUT

Campo

FWQ_FILIAL

Tipo

Carácter

Tamaño

8

Descripción

Sucursal del sistema

Título

Sucursal

Picture

@!

Grupo de campos

033

Help de campo

Sucursal del sistema

Campo

FWQ_LAYOUT

Tipo

Carácter

Tamaño

6

Descripción

Código del layout

Título

Cód Layout

Picture

@!

Help de campo

Código del layout de la carta de cobranza

Campo

FWQ_FILTRA

Tipo

Carácter

Tamaño

254

Descripción

Exp de filtros adicionales

Título

Expresión

Picture

@!

Help de campo

Expresión de filtro que se utilizará para filtrar los títulos que podrán seleccionarse para cobranza en la rutina Envío de cobranza. La expresión se construirá con base en los campos de la tabla Títulos por cobrar.

 

Archivo FWS – Datos de los títulos 

Tabla

Descripción

Sigla

FWS

Nombre

Datos de los títulos

Mod. Ac. Sucursal

Exclusivo

Mod. Ac. Unidad

Exclusivo

Mod. Ac. Empresa

Exclusivo

Clave única

FWS_FILIAL+FWS_LAYOUT+FWS_CAMPO

Índice

Clave

01

FWS_FILIAL+FWS_LAYOUT+FWS_SEQ+FWS_CAMPO

Campo

FWS_FILIAL

Tipo

Carácter

Tamaño

8

Descripción

Sucursal del sistema

Título

Sucursal

Picture

@!

Grupo de campos

033

Help de campo

Sucursal del sistema

Campo

FWS_LAYOUT

Tipo

Carácter

Tamaño

6

Descripción

Código del layout

Título

Cód. Layout

Picture

@!

Help de campo

Código del layout

Campo

FWS_SEQ

Tipo

Carácter

Tamaño

4

Descripción

Secuencia de campos

Título

Secuencia

Picture

@!

Help de campo

Almacena la secuencia de grabación de los campos que se mostrarán en las cartas enviadas por e-mail.

Campo

FWS_CAMPO

Tipo

Carácter

Tamaño

10

Descripción

Campo del título

Título

Campo

Picture

@!

Help de campo

Campo que se mostrará en el cuerpo de la carta de cobranza.

Campo

FWS_DESCRI

Tipo

Carácter

Tamaño

15

Descripción

Descripción del campo

Título

Descripción

Help de campo

Descripción del campo que se mostrará en la carta de cobranza. Si la descripción estuviera en blanco, la descripción estándar del campo definido se utilizará.

 

Archivo FWT – Cartas enviadas 

Tabla

Descripción

Sigla

FWT

Nombre

Cartas enviadas

Mod. Ac. Sucursal

Exclusivo

Mod. Ac. Unidad

Exclusivo

Mod. Ac. Empresa

Exclusivo

Clave única

FWT_FILIAL+FWT_LAYOUT+FWT_PROCES+FWT_CHAVE

Índice

Clave

01

FWT_FILIAL+FWT_LAYOUT+FWT_PROCES+FWT_CHAVE

Campo

FWT_LAYOUT

Tipo

Carácter

Tamaño

6

Descripción

Código del layout

Título

Cód. Layout

Picture

@!

Help de campo

Código del layout

Campo

FWT_DTENVI

Tipo

Fecha

Tamaño

8

Descripción

Fecha de envío

Título

Fch Envío

Help de campo

Fecha de envío de la carta de cobranza

Campo

FWT_CHAVE

Tipo

Carácter

Tamaño

32

Descripción

Clave del documento

Título

Clave

Picture

@!

Help de campo

Clave del título que se envió en la carta de cobranza

Campo

FWT_PROCES

Tipo

Carácter

Tamaño

32

Descripción

Número del proceso

Título

Proceso

Picture

@!

Help de campo

Número del proceso donde se envió la carta de cobranza.

Campo

FWT_DTREFE

Tipo

Fecha

Tamaño

8

Descripción

Fecha de referencia

Título

Fch. Referenc

Help de campo

Fecha de referencia para corrección de valores

 

Grupo de preguntas (SX1): FINR810

X1_ORDEM

01

X1_PERGUNT

De Carta de cobranza

X1_TIPO

Carácter

X1_TAMANHO

6

X1_GSC

Get

X1_VAR01

MV_PAR01

X1_F3

FWP

X1_HELP

Define el rango inicial de layout de cartas de cobranza.

X1_ORDEM

02

X1_PERGUNT

A Carta de cobranza

X1_TIPO

Carácter

X1_TAMANHO

6

X1_GSC

Get

X1_VAR01

MV_PAR02

X1_F3

FWP

X1_HELP

Define el rango final de layout de cartas de cobranza.

X1_ORDEM

03

X1_PERGUNT

De Fecha de envío

X1_TIPO

Fecha

X1_TAMANHO

8

X1_GSC

Get

X1_VAR01

MV_PAR03

X1_HELP

Define la fecha inicial del rango de las cobranzas enviadas.

X1_ORDEM

04

X1_PERGUNT

A Fecha de envío

X1_TIPO

Fecha

X1_TAMANHO

8

X1_GSC

Get

X1_VAR01

MV_PAR04

X1_HELP

Define la fecha final del rango de las cobranzas enviadas.

X1_ORDEM

05

X1_PERGUNT

De Cliente

X1_TIPO

Carácter

X1_TAMANHO

6

X1_GSC

Get

X1_VAR01

MV_PAR05

X1_F3

 SA1

X1_GRPSXG

001

X1_HELP

Define el cliente inicial del rango.

X1_ORDEM

06

X1_PERGUNT

De Tienda

X1_TIPO

Carácter

X1_TAMANHO

2

X1_GSC

Get

X1_VAR01

MV_PAR06

X1_GRPSXG

002

X1_HELP

Define la tienda inicial del rango.

 

 

X1_ORDEM

07

X1_PERGUNT

A Cliente

X1_TIPO

Carácter

X1_TAMANHO

6

X1_GSC

Get

X1_VAR01

MV_PAR07

X1_F3

 SA1

X1_GRPSXG

001

X1_HELP

Define el cliente final del rango.

X1_ORDEM

08

X1_PERGUNT

A Tienda

X1_TIPO

Carácter

X1_TAMANHO

2

X1_GSC

Get

X1_VAR01

MV_PAR08

X1_GRPSXG

002

X1_HELP

Define la tienda final del rango.

X1_ORDEM

09

X1_PERGUNT

Imprime

X1_TIPO

Carácter

X1_TAMANHO

1

X1_GSC

Combo

X1_VAR01

MV_PAR09

X1_DEF01

Analítico

       X1_DEF02

Sintético

X1_HELP

Define si el informe se imprimirá en formato analítico (con la carta completa, conteniendo los textos y otros detalles) o en formato sintético (solamente con los registros enviados en cobranza y sus divisiones).

 

      Consultas estándar (SXB): FWP

Descripción

Cartas de cobranza

Tipo

Consulta estándar

Tabla

FWP

Índice

Código

Campo

Código;Descripción

Devolución

FWP_CODCRT 

Para la correcta ejecución automática de la rutina FINA811, es necesario informar los parámetros de la función de acuerdo con lo siguiente:


PosiciónTipoDescripción
1NumericOpción de ejecución. Enviar siempre valor 0.
2Array

Contiene los parámetros de la rutina, incluyendo el filtro deseado para la selección de los registros y envío de las cartas de cobranza. Todos los registros devueltos por el filtro tendrán una carta de cobranza generada. 

a811Param[01] := De Código del cliente (tipo carácter)

a811Param[02] := De Tienda del cliente (tipo carácter)

a811Param[03] := A Código del cliente (tipo carácter)

a811Param[04] := A Tienda del cliente (tipo carácter)

a811Param[05] := De Fecha de vencimiento (tipo fecha)        

a811Param[06] := A Fecha de vencimiento (tipo fecha)  

a811Param[07] := Fecha de referencia (tipo fecha)     

a811Param[08] := De Valor (tipo numérico)     

a811Param[09] := A Valor (tipo numérico)        

a811Param[10] := "2" (tipo carácter) - IMPORTANTE: ENVIAR 2 PARA NO PRESENTAR PANTALLA DE SELECCIÓN DE SUCURSALES, O 1 SI SE UTILIZA EL PUNTO DE ENTRADA ctGetFil()

a811Param[11] := Títulos por vencer (tipo carácter donde "1" = Sí o "2" = No)

a811Param[12] := Considera valor (tipo carácter donde "1" = Total o  "2" = Saldo)

a811Param[13] :="2" (tipo carácter) - IMPORTANTE: ENVIAR 2 PARA NO PRESENTAR PANTALLA DE SELECCIÓN DE SITUACIÓN DE COBRANZA

a811Param[14] := {} (tipo vector) - IMPORTANTE: ENVIAR ARRAY VACÍO

a811Param[15] := "" (tipo carácter) - IMPORTANTE: ENVIAR ARRAY VACÍO

a811Param[16] := Código del layout de la carta que se utilizará (tipo carácter) 

a811Param[17] := Considera clientes bloqueados (A1_MSBLQL) en el filtro. Se espera contenido "1" para considerar clientes bloqueados o "2" para considerar solamente clientes activos

3LogicalUso interno. Enviar NIL o .F.
4CharacterExpresión SQL para complementar el filtro de títulos. Ejemplo: "E1_TIPO = 'BOL'"
Ejemplo de ejecución automática FINA811
#INCLUDE "PROTHEUS.CH"
#INCLUDE "TBICONN.CH"

User Function ctGetFil() //Se utiliza para envío de cartas de cobranza a partir de una sucursal centralizadora
    Local aFiliais As Array

    aFiliais := {}

    If FwIsInCallStack("FINA811")
        aFiliais := FWAllFilial(NIL, NIL, cEmpAnt, .F.)
    EndIf

Return aFiliais

User Function EXEC811()

    Local a811Param As Array
    Local cFiltro As Character

    Private lMsErroAuto := .F.
    Private lAutoErrNoFile := .F.

    PREPARE ENVIRONMENT EMPRESA "T1" FILIAL "D MG 01 "
 
    cFiltro := "E1_TIPO = 'BOL' " 

    a811Param := {}
    aSize(a811Param, 17)

    a811Param[01] := "      " //De Código del cliente (tipo carácter)
    a811Param[02] := "  " //De Tienda del cliente (tipo carácter)
    a811Param[03] := "ZZ" //A Código del cliente (tipo carácter)
    a811Param[04] := "ZZZZZZ" //A Tienda del cliente (tipo carácter)
    a811Param[05] := cToD("01/12/2022") //De Fecha de emisión (tipo fecha)        
    a811Param[06] := cToD("01/12/2022") //A Fecha de emisión (tipo fecha)  
    a811Param[07] := cToD("01/12/2022") //Fecha de referencia (tipo fecha)     
    a811Param[08] := 0 //Valor de (tipo numérico)     
    a811Param[09] := 9999999 //A Valor (tipo numérico)        
    a811Param[10] := "1" //(tipo carácter) - IMPORTANTE:  SIEMPRE 2 PARA NO PRESENTAR PANTALLA DE SELECCIÓN DE SUCURSALES
    a811Param[11] := "1" //Títulos por vencer (tipo carácter  donde "1" = Sí o "2" = No)
    a811Param[12] := "1" //Considera valor (tipo carácter donde "1" = Total o  "2" = Saldo)
    a811Param[13] := "2" //(tipo carácter) - IMPORTANTE: SIEMPRE 2 PARA NO PRESENTAR PANTALLA DE SELECCIÓN DE SITUACIÓN DE COBRANZA
    a811Param[14] := {} //(tipo array) - IMPORTANTE: ENVIAR ARRAY VACÍO
    a811Param[15] := "" //(tipo caracter) - IMPORTANTE: SIEMPRE VACÍO
    a811Param[16] := "CTE001" //Código del layout de la carta que se utilizará (tipo carácter) 
    a811Param[17] := "1" //Considera clientes bloqueados (A1_MSBLQL) en el filtro. Se espera contenido "1" para considerar clientes bloqueados o "2" para considerar solamente clientes activos

    MSExecAuto({|a,b,c,d| FINA811(a,b,c,d)}, 0, a811Param, NIL, cFiltro)

    If (lMsErroAuto)
            MostraErro()

            ConOut(Repl("-", 80))
            ConOut(PadC("FINA460 automatic routine ended with error", 80))
            ConOut(PadC("Ends at: " + Time(), 80))
            ConOut(Repl("-", 80))
        Else
            ConOut(Repl("-", 80))
            ConOut(PadC("FINA460 automatic routine successfully ended", 80))
            ConOut(PadC("Ends at: " + Time(), 80))
            ConOut(Repl("-", 80))
        EndIf

    RESET ENVIRONMENT

Return