Histórico da Página

Tempo aproximado para leitura: 05 min

ÍNDICE

Índice
maxLevel

5

2
minLevel 2
indent 8.1.1
exclude

.*ndice

ÍNDICE
style none

Informações

title	Nota

Essa rotina foi ajustada para atender a Lei Geral de Proteção de Dados (Lei Esta rutina se ajustó para cumplir con la Ley general de protección de datos (Ley n° 13.70), sendo siendo que alguns algunos campos que apresentam informações consideradas como dados sensíveis e/ou pessoais, serão ofuscados deixando de ser legíveispresentan información considerada como datos sensibles y/o personales se ocultarán, dejando de ser legibles.

01.

VISÃO GERAL

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

Esse processo visa disponibilizar o envio de cartas de cobrança para os clientes que possuam títulos em atraso, a vencer ou em situações personalizadas.

A rotina de envio de carta de cobrança permite que os títulos que estejam em atraso, ou a vencer, possam ser devidamente cobrados através do envio de cartas de cobrança eletrônica

(e-mail)

e

y/

ou

o física.

Para que

as cartas possam ser geradas e envidas, primeiramente deve-se definir os tipos de situação de cobrança que serão considerados, o período no qual as cobranças se encontram (referente ao tempo de atraso e/ou período a vencer), além de definir o teor do texto de cobrança que será apresentado.

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

As cartas enviadas vão conter os juros e multas calculados até uma data pré definida (em parâmetro), possibilitando aos destinatários saber o valor atualizado de cobrança.

É possível o envio da

carta de diferentes tipos de texto

bem como é permitido complementar as validações

así como también se permite complementar las validaciones, de forma específica,

dos

de los clientes que

receberão as

recibirán las cartas de

cobrança

cobranza.

Um relatório de cobranças já efetuadas está disponível para facilitar o acompanhamento das cartas de cobrança enviadas e os seus respectivos destinatários e títulos cobrados

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.

REGRAS E DEFINIÇÕES

REGLAS Y DEFINICIONES

Expandir

title	Fluxo operacionalFlujo operativo

Expandir

title	Descrição do processo	Descripción del proceso

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 Parâmetros iniciais: Os parâmetros iniciais vão permitir efetuar os filtros de quais clientes, o intervalo de vencimento, valor, situação de cobrança, filiais, títulos ainda a vencer e determinar a data de apuração de juros e multa que serão considerados para envio das cartas de cobrança. É possível complementar os filtros de forma personalizada, para isso, deverá ser implementado um ponto lo cual debe implementarse un punto de entrada (F811QRY vide detalhamento na seção pontos ver detalle en la sección puntos de entrada desse de este documento) que que permita complementar a la query que considerará os parâmetros padrõeslos parámetros estándar.

Selección Seleção de layout: Será apresentada uma relação dos Se mostrará una lista de los layouts de carta de cobrança cadastrados cobranza registrados para que seja possível selecionar qual o layout que será utilizado para envio. Só poderá ser selecionado um sea posible seleccionar qué layout se utilizará para envío. Solamente podrá seleccionarse un único layout de carta de cobrança cobranza por envioenvío.

Selección Seleção de cliente: Será apresentada uma relação dos clientes que atendem aos critérios do Se mostrará una lista de los clientes que atienden los criterios del filtro, para que possam ser selecionados para envio das carta de cobrança. Todos serão apresentadas na tela já selecionadospuedan seleccionarse para envío de las cartas de cobranza. Todos se mostrarán en la pantalla seleccionados/marcados.

Selección Seleção de títulos: O processo de seleção dos títulos que irão compor a carta de cobrança segue os critérios definidos e sugeridos no envio das 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 a possibilidade la posibilidad de enviar títulos que estão ainda a aún están por vencer, de forma adicional. Ou seja, incluí-los como um lembrete e não como uma cobrança. Estes serão sugeridos, mas liberados para exclusão da carta, caso desejado.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.

É importante ressaltar que, com a implementação do Bloqueio por Situação de Cobrança (vide Cabe resaltar que, con la implementación del Bloqueo por situación de cobranza (vea http://tdn.totvs.com/pages/viewpage.action?pageId=381044073), os los títulos em situação de cobrança com bloqueio en situación de cobranza con bloqueo configurado para as las cartas de cobrança não estarão disponíveis neste processo de envio cobranza no estarán a disposición en este proceso de envío de e-mail. Sendo assim, estes não serão listados na seleção. Para efetuar este bloqueio, será adicionado um novo processo padrão aos já existentes e o mesmo será validado a cada envio.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 pendienteAlém disso, um título é elegível para o envio de cartas enquanto ainda tiver saldo em aberto.

Expandir

title	Exemplo Ejemplo de utilizaçãoutilización

1 - No dia El día 01/03/2015 , foi enviado um se envió un e-mail com os con los siguientes títulos abaixo para cobrançacobranza, considerando vencimentos com mais vencimientos con más de 10 dias días de atraso:

Título			VencimentoVencimiento	Dias em Días de atraso
DUP	22513	01	01/02/2015	28
DUP	22221	02	01/01/2015	59
DUP	25512	01	15/12/2014	76

2 - Em El 15/03/2015, o cliente efetuou o pagamento das duas parcelas com maior atraso, mas não quitou a parcela de el cliente efectuó el pago de dos cuotas con mayor atraso, pero no liquidó la cuota del 01/02/2015. Dessa forma, o título não quitado continuará sendo enviado nas novas cartas de cobrança, com o número de dias de atraso atualizadoDe 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ítulo			VencimentoVencimiento	Dias em Días de atraso
DUP	22513	01	01/02/2015	48

Ressaltamos Resaltamos que este exemplo considera somente o vencimento, mas que o título deve respeitar todas as regras do ejemplo considera solamente el vencimiento, pero que el título debe respetar todas las reglas del filtro.

Expandir

title	Definição do Definición del layout

RotinaRutina: FINA810 FINA810 - Layouts de Carta carta de Cobrançacobranza

Cada carta enviada será definida conforme o teor de cobrança, ou seja, será possível incluir um texto de um determinado teor 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 cobrançacobranzas.

Para tanto, serão disponibilizadas ello, se pondrán a disposición formas de configurar os los textos das cartas e associá-las a determinadas regras via cadastro. Estarão disponíveis somente características do cliente para validação combinada com o filtro de/até. Não sendo necessário, o mesmo poderá ser mantido em branco, para que as cartas sejam enviados para qualquer cliente.

As cartas obedecem aos filtros informados na rotina de envio, validando os dados do cliente associado, ao teor da carta. Esta configuração poderá utilizar campos customizados para sua composição.

Já na listagem de títulos, as colunas consideradas como padrão estão abaixo:

- Chave do título – Prefixo, número e parcela
- Data de vencimento
- Dias de atraso
- Valor Original
- Saldo do Título
- Multa
- Juros

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 Haverá a possibilidade de adição/retirada de novas colunas, desde que as mesmas façam parte do título a receber (SE1), considerando que, por se tratar de um envio tratarse de un envío de e-mail ey/ou o carta física, poderá haver algum puede haber algún tipo de restrição quanto a quantidade de informação contida na carta/folha.

Quando o método de envio selecionado for físico ou ambos, a carta deverá conter no topo, os dados de envio, contendo nome e endereço do cliente. O endereço utilizado será o endereço de cobrança contido no cadastro do cliente. Caso esse endereço esteja em branco, o envio será feito para o endereço do cliente. No layout da carta, será possível definir o alinhamento do endereço do cliente no topo da carta.

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 - Digitação do cabeçalho do cadastro onde é definido o método de envio, os textos (principal da carta, saudação e conclusão), bem como a posição do endereço (para cartas impressas).

- No rodapé existem 2 abas onde são definidos os campos do contas a receber (tabela SE1) que irão ser apresentados na carta (nro do 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, data fecha de vencimentovencimiento, etc.), bem como são definidas as regras así como se definen las reglas personalizadas de envioenvío. Nesse campo deve ser informado uma expressão como as En este campo debe informarse una expresión como las de filtros de tela pantalla (browse) do del Protheus. Está posicionada a tabela marcada la tabla de Clientes (SA1).

Rotina: FINR811 - Relatório das Cartas de Cobrança

O relatório permite a execução de 2 formas (analítica ou sintética). Na forma analítica é exibida a carta completa, contendo os textos e demais detalhes. Na forma sintética, são exibidos apenas as cartas que foram enviados, porém sem os textos, ou seja, apenas um resumo.

Além do tipo de impressão (sintético ou analítico), o relatório permite as seguintes parametrizações:

Image Removed

- Impressão no modelo analítico

Image Removed

Haverá um salto de página a cada impressão de carta e as colunas dos títulos não seguirão o configurado no layout, uma vez que o relatório exige uma estrutura fixa.

- Impressão no modelo sintético

Image Removed

Outros campos da tabela SE1 estarão disponíveis para adição no relatório, considerando a limitação da área de impressão x tamanho da página.

Lembrando que o modelo do relatório deve ser o mesmo do e-mail enviado, remontado em tempo de impressão com os dados armazenados.

Expandir

title	Envio das Cartas	Envío de las cartas

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

Rotina: FINA811 - Envio das Cartas de Cobrança

Para o envio das cartas, deve ser respondida cada etapa do wizard, conforme explicação a seguir.

- Tela Pantalla inicial do del wizard.

- Definição dos parâmetros para busca e filtragem das informaçõesDefinición de los parámetros para búsqueda y filtrado de la información.

Image RemovedImage Added

De Cliente

e loja de

y tienda (intervalo inicial de cliente

e loja

y tienda)

;

.
A Cliente

e loja até

y tienda (intervalo final de cliente

e loja

y tienda)

;

.

Vencimento de

De Vencimiento (intervalo de

vencimento

vencimiento inicial

dos

de los títulos)

;

.

Vencimento até

A Vencimiento (intervalo de

vencimento

vencimiento final

dos

de los títulos)

;

De Valor

de

(intervalo de valor inicial

dos

de los títulos)

;

.
A Valor

até

(intervalo de valor final

dos

de los títulos)

;

.

Seleciona filiais (caso seja definido com "Sim", a tela padrão de seleção de filiais será exibida para que as filiais possam ser selecionadas);

Situação de cobrança (será apresentada a mesma consulta já utilizada no requisito "Processos SERASA", permitindo que uma ou mais situações de cobrança sejam selecionadas. Este campo é validado para não ser deixado em branco ao avançar no processo);

Títulos a vencer (caso esteja como sim, o filtro vai considerar os títulos que ainda estão por vencer);

Data de referência para cálculo de juros e multa dos títulos;

Considera valor (caso seja definido com "1-Valor Total", sistema irá filtrar os registros com conteúdo no campo E1_VALOR entre os valores informados nos itens 5 e 6 dessa janela. Caso seja definido com

Selecciona sucursales (si se definiera con "Sí", la pantalla estándar de selección de sucursales se mostrará para que puedan seleccionarse las sucursales).
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).
Títulos por vencer (si estuviera como sí, el filtro va a considerar los títulos que aún están por vencer).
Fecha de referencia para cálculo de interés y multa de los títulos.
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",

o sistema irá filtrar os registros com conteúdo no

el sistema filtrará los registros con contenido en el campo E1_SALDO entre

os

los valores informados

nos itens 5 e 6 dessa janela ).

en los ítems 5 y 6 de esa ventana).
¿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 - Seleção do layout da carta (apenas 1 layout poderá ser selecionado).

- Seleção do(sSelección del(de los) cliente(s).

- Seleção do(s) título(s).

Image Removed

É importante ressaltar que a seleção de títulos deve considerar o bloqueio de situação de cobrança configurado (conforme já citado anteriormente).

- Envio ou impressão das cartas.

Image Removed

- Consulta de log dos envios e conclusão do processo.

Image Removed

- Consulta do log

Image Removed

- Modelo do e-mail enviado ao cliente.

Image Removed

Expandir

title	Considerações Importantes

Para toda e qualquer carta (enviada ou impressa) é gerado um registro na tabela FWT, que contém o layout utilizado, a data do envio, além da chave de identificação.

Todas as grids possuem a opção de marcar ou desmarcar todos os registros (com exceção da grid de layouts de cartas de cobrança, onde somente um layout poderá ser selecionado).

IMPORTANTE: É uma premissa que o e-mail no cadastro de clientes esteja preenchido para que a cobrança seja enviada e que o serviço de envio de e-mail do Protheus esteja configurado.

Ao final do envio, será gravado um registro de log da carta enviada para emissão de relatório. Para tanto, serão armazenadas as seguintes informações de cada título enviado:

- Número de processo - para identificação da carta enviada.
- Chave do título
- Data de Envio
- Código do layout

IMPORTANTE: Um título pode ter N ocorrências nesta tabela, mas em processos diferentes. Pode ocorrer de uma carta ser enviada mais de uma vez para um cliente em uma mesma data, e não haverá restrição quanto a isso, pois durante o dia poderão ocorrer baixas e inclusão de novos documentos no Protheus.

Somente estes dados são suficientes para reproduzir o e-mail com a cobrança enviada:

- Texto da carta (opcional)
- Listagem de títulos vencidos
- Listagem de título a vencer

Expandir

title	Relatório de Cartas de Cobrança

03. PARÂMETROS UTILIZADOS

Para envio das cartas por e-mail por e-mail são utilizados os parâmetros já existentes:

MV_RELSERV - Nome do servidor de envio de e-mail;
MV_RELACNT - Conta a ser utilizada no envio de e-mail;
MV_RELPSW - Senha da conta de e-mail;
MV_RELFROM - E-mail utilizado no campo FROM no envio do e-mail;
MV_RELBODY - Determina o assunto padrão no envio do e-mail;
MV_RELAUTH - Determina se o servidor exige autenticação
MV_RELAUSR - Usuário para autenticação no servidor de e-mail (caso servidor assim exigir);
MV_RELAPSW - Senha para autenticação no servidor de e-mail (caso servidor assim exigir).

As rotinas referentes ao processo de Carta de Cobrança não cria novos parâmetros.

04. PONTOS DE ENTRADA

F811PAR: Ponto de entrada para inicializar as variáveis private da segunda janela do wizard (parâmetros) de envio das cartas de cobrança. As variáveis disponíveis são:

cCliDe: Cliente de

cLojaDe: Loja do cliente de

cCliAte: Cliente até

cLojaAte: Loja do cliente até

dDataDe: Data de emissão de

dDataAte: Data de emissão até

nValDe: Valor de

nValAte: Valor até

cComboFil: Seleciona filial ("1"=Sim ; "2" = Não)

cSitCob: Seleciona situação de cobrança ("1"=Sim ; "2" = Não)

cComboVenc: Titulo a vencer ("1"=Sim ; "2" = Não)

dDtRef: Data de referência

cComboConVl: Considera Valor ("1"=Sim ; "2" = Não)

F811QRY: Ponto de entrada que permite complementar a query que considera os parâmetros informados para listas os clientes disponíveis. Esse ponto de entrada é executado na terceira janela do wizard (Seleção de Clientes) de envio das cartas de cobrança.

F811MAILTO: Ponto de entrada que permite modificar a variável cTo, que contém o endereço de e-mail ao qual será enviada a carta de cobrança de forma eletrônica.

05. DADOS TÉCNICOS

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).

Image Added

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.

Image Added

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

Image Added

- Consulta del log

Image Added

- Modelo del e-mail enviado al cliente.

Image Added

Expandir

title	Consideraciones importantes

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

Expandir

title	Informe de cartas de cobranza

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:

Image Added

- Impresión en el modelo analítico

Image Added

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

Image Added

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ámetro		Definición
FINA811 <= 23/08/2022	FINA811 > 23/08/2022	Definición
MV_RELSERV		Nombre del servidor de envío de e-mail
MV_RELACNT	MV_FINACNT	Cuenta que se utilizará en el envío de e-mail
MV_RELPSW	MV_FINPSW	Contraseña de la cuenta de e-mail
MV_RELFROM	MV_FINFROM	E-mail utilizado en el campo FROM en el envío del e-mail
MV_RELBODY		Determina el asunto estándar en el envío del e-mail. Se utilizará cuando no se complete el campo FWP_TXTASS
MV_RELAUTH		Determina si el servidor exige autenticación
MV_RELAUSR	MV_FINACNT	Usuario para autenticación en el servidor de e-mail (si así lo exigiera el servidor)
MV_RELAPSW	MV_FINPSW	Contraseñ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.

Informações

En la mayoria de los servidores SMTP, el carácter separador de direcciones de e-mail es el punto y coma (;). Pero en algunos otros servidores (como en el caso de Amazon), el separador de direcciones utilizado es el carácter de coma (,).

Para evitar esta situación existe el parámetro MV_RELSEP que permite al cliente informar cuál es el carácter permitido por el servidor de e-mail utilizado.

DFRM1-35358 DT Permitir el cambio de separador de emails

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

Mod. Ac. Unidade

Expandir

title	Diccionarios implementados

Archivo: FWP – Carta de cobranza

Tabla	Descripción
Sigla	FWP
Nombre	Cartas de cobranza
Mod. Ac. Sucursal	Exclusivo
Mod. Ac. Unidad

Expandir

title	Dicionários Implementados

Arquivo: FWP – Carta de Cobrança

Tabela

Descrição

Sigla

FWP

Nome

Cartas de Cobrança

Mod. Ac. Filial

Exclusivo

	Exclusivo
Mod. Ac. Empresa	Exclusivo

Chave

Clave única

FWP_FILIAL+FWP_CODCRT

Índice

Chave

Clave
01	FWP_FILIAL+FWP_CODCRT

Campo	FWP_FILIAL
Tipo

Caractere

Carácter

Tamanho

Tamaño

8

Descrição

Descripción

Filial do

Sucursal del sistema

Título

Filial

Sucursal
Picture	@!
Grupo de

Campos

campos	033
Help de

Campo

campo

Filial do

Sucursal del sistema

Campo	FWP_CODCRT
Tipo

Caractere

Carácter

Tamanho

Tamaño

6

Descrição

Descripción

Código

do Layout

del layout
Título	Cód. Layout
Picture	@!
Help de

Campo

campo

Defina

o

el código

do

del layout

da

de la Carta de

Cobrança

cobranza.

Campo	FWP_DESCRI
Tipo

Caractere

Carácter

Tamanho

Tamaño

40

Descrição

Descripción

Descrição do

Descripción del layout

Título

Descrição

Descripción
Picture	@!
Help de

Campo

campo

Defina

a descrição do layout da Carta de Cobrança. Essa descrição será exibida na rotina de envio de cartas de cobrança e no relatório de cobranças

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

Caractere

Carácter

Tamanho

Tamaño

1

Descrição

Descripción

Status do

Estatus del layout

Título

Status

Estatus
Picture	@!

Validação

Validación	Pertence("12")
Lista de

Opções

opciones

1=

Ativo

Activo;2=

Inativo

Inactivo

Help de

Campo

campo

Define

se o layout da

si el layout de la carta de

cobrança está ativo ou inativo. Somente layouts ativos poderão ser enviados em cobrança

cobranza está activo o inactivo. Solamente layouts activos podrán enviarse en cobranza.

Campo	FWP_TXTSAU
Tipo

Caractere

Carácter

Tamanho

Tamaño

60

Descrição

Descripción

Texto

da Saudação

de saludo

Título

Saudação

Saludo

Help de

Campo

campo

Texto de

saudação que será enviado na

saludo que se enviará en la carta de

cobrança

cobranza.

O

El texto de

saudação representa o início da

saludo representa el inicio de la carta.

Exemplo

Ejemplo: "

Prezado Cliente

Estimado cliente"

.

Campo	FWP_TXTCRT
Tipo	Memo

Tamanho

Tamaño

500

Descrição

Descripción

Texto

da Carta

de la carta
Título	Txt Carta
Help de

Campo

campo

O texto inserido neste campo é o texto que será enviado no corpo da carta contendo o teor da cobrança

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

Tamanho

Tamaño

500

Descrição

Descripción

Texto de

Conclusão

finalización

Título

Conclusão

Finalización

Help de

Campo

campo

O

El texto de

conclusão, caso informado, será enviado ao final da

finalización, si se informara, se enviará al final de la carta, como complemento

da cobrança efetuada ou com informações adicionais

de la cobranza efectuada o con información adicional.

Campo	FWP_ENVIO
Tipo

Caractere

Carácter

Tamanho

Tamaño

1

Descrição

Descripción

Tipo de

Envio

envío
Título	Tp

Envio

Envío
Picture	@!
Lista de

Opções

opciones

1=E-mail;2=Carta

Física

física;3=Ambos

Validação

Validación	Pertence("123")
Help de

Campo

campo

Tipo de

envio da

envío de la carta de

cobrança

cobranza,

sendo

siendo: E-mail -

as cartas serão enviadas para o

las cartas se enviarán al e-mail

contido no cadastro

contenido en el archivo de clientes; Carta

Física - o envio da carta será feito

física - el envío de la carta se realizará de forma física,

ou seja

es decir,

a carta impressa será enviada diretamente ao

la carta impresa se enviará directamente al cliente; Ambos -

o envio será efetuado das duas

el envío se efectuará de las dos formas.

Campo	FWP_POSVER
Tipo	Numérico

Tamanho

Tamaño

4

Descrição

Descripción

Pos

vertical do endereço

Vertical de la dirección
Título	Pos Vertical
Picture	@E

9999

9,999

Help de

Campo

campo

Posição

Posición inicial vertical

do endereço em

de la dirección en pixels.

Esse campo só será habilitado quando o layout estiver com a forma de envio

Este campo solamente se habilitará si el layout estuviera con la forma de envío definida como "Carta

Física

física"

ou

o "Ambos".

Campo	FWP_POSHOR
Tipo	Numérico

Tamanho

Tamaño

4

Descrição

Descripción

P Horizontal

do Endereço

de la dirección
Título	P Horizontal
Picture	@E

9999

9,999

Help de

Campo

campo

Posição

Posición inicial horizontal

do endereço em

de la dirección en pixels.

Esse campo só será habilitado quando o layout estiver com a forma de envio

Este campo solamente se habilitará si el layout estuviera con la forma de envío definida como "Carta

Física

física"

ou

o "Ambos".

Arquivo: FWQ – Regras Reglas de Envioenvío

Tabela

Tabla

Descrição

Descripción
Sigla	FWQ

Nome

Nombre

Regras

Reglas de

Envio

envío

Mod. Ac.

Filial

Sucursal	Exclusivo
Mod. Ac.

Unidade

Unidad	Exclusivo
Mod. Ac. Empresa	Exclusivo

Chave

Clave única

FWQ_FILIAL+FWQ_LAYOUT

Índice

Chave

Clave
01	FWQ_FILIAL+FWQ_LAYOUT
Campo	FWQ_FILIAL
Tipo

Caractere

Carácter

Tamanho

Tamaño

8

Descrição

Descripción

Filial do

Sucursal del sistema

Título

Filial

Sucursal
Picture	@!
Grupo de

Campos

campos	033
Help de

Campo

campo

Filial do

Sucursal del sistema

Campo	FWQ_LAYOUT
Tipo

Caractere

Carácter

Tamanho

Tamaño

6

Descrição

Descripción

Código

do Layout

del layout
Título	Cód Layout
Picture	@!
Help de

Campo

campo

Código

do

del layout

da

de la carta de

cobrança

cobranza
Campo	FWQ_FILTRA
Tipo

Caractere

Carácter

Tamanho

Tamaño

254

Descrição

Descripción

Exp de filtros

adicionais

adicionales

Título

Expressão

Expresión
Picture	@!
Help de

Campo

campo

Expressão

Expresión de filtro que

será utilizada

se utilizará para filtrar

os

los títulos que

poderão ser selecionados para cobrança na rotina de Envio de Cobrança. A expressão será construída com base nos campos da tabela de Títulos a Receber.

Arquivo: FWS – Dados dos Títulos

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

Tabela

Descrição


Sigla	FWS

Nome

Dados dos Títulos

Nombre	Datos de los títulos
Mod. Ac.

Filial

Sucursal	Exclusivo
Mod. Ac.

Unidade

Unidad	Exclusivo
Mod. Ac. Empresa	Exclusivo

Chave

Clave única

FWS_FILIAL+FWS_LAYOUT+FWS_CAMPO

Índice

Chave

Clave
01	FWS_FILIAL+FWS_LAYOUT+FWS_SEQ+FWS_CAMPO
Campo	FWS_FILIAL
Tipo

Caractere

Carácter

Tamanho

Tamaño

8

Descrição

Filial do Sistema

Descripción	Sucursal del sistema
Título

Filial

Sucursal
Picture	@!
Grupo de

Campos

campos	033
Help de

Campo

campo

Filial do

Sucursal del sistema

Campo	FWS_LAYOUT
Tipo

Caractere

Carácter

Tamanho

Tamaño

6

Descrição

Descripción

Código

do Layout

del layout
Título	Cód. Layout
Picture	@!
Help de

Campo

campo

Código

do Layout

del layout
Campo	FWS_SEQ
Tipo

Caractere

Carácter

Tamanho

Tamaño

4

Descrição

Descripción

Sequência

Secuencia de

Campos

campos

Título

Sequência

Secuencia
Picture	@!
Help de

CampoArmazena a sequência de gravação dos campos que serão exibidos nas

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

Caractere

Carácter

Tamanho

Tamaño

10

Descrição

Descripción

Campo

do

del título
Título	Campo
Picture	@!
Help de

Campo

campo

Campo que

será exibido no corpo da

se mostrará en el cuerpo de la carta de

cobrança

cobranza.
Campo	FWS_DESCRI
Tipo

Caractere

Carácter

Tamanho

Tamaño

15

Descrição

Descripción

Descripción del campo

Descrição do Campo

Título

Descrição

Descripción

Help de

Campo

campo

Descrição do

Descripción del campo que

será apresentada na

se mostrará en la carta de

cobrança. Caso a descrição esteja em branco, a descrição padrão do campo definido será utilizada.

Arquivo: FWT – Cartas Enviadas

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

Tabela

Descrição


Sigla	FWT

Nome

Nombre

Cartas

Enviadas

enviadas

Mod. Ac.

Filial

Sucursal	Exclusivo
Mod. Ac.

Unidade

Unidad	Exclusivo
Mod. Ac. Empresa	Exclusivo

Chave

Clave única

FWT_FILIAL+FWT_LAYOUT+FWT_PROCES+FWT_CHAVE

Índice

Chave

Clave
01	FWT_FILIAL+FWT_LAYOUT+FWT_PROCES+FWT_CHAVE
Campo	FWT_LAYOUT
Tipo

Caractere

Carácter

Tamanho

Tamaño

6

Descrição

Descripción

Código

do Layout

del layout
Título	Cód. Layout
Picture	@!
Help de

Campo

campo

Código

do Layout

del layout

Campo	FWT_DTENVI
Tipo

Data

Fecha

Tamanho

Tamaño

8

Descrição

Descripción

Data

Fecha de

Envio

envío

Título

Dt Envio

Fch Envío

Help de

Campo

campo

Data de envio da Carta de Cobrança

Fecha de envío de la carta de cobranza
Campo	FWT_CHAVE
Tipo

Caractere

Carácter

Tamanho

Tamaño

32

Descrição

Chave do Documento

Descripción	Clave del documento
Título

Chave

Clave
Picture	@!
Help de

Campo

campo

Chave do

Clave del título que

foi enviado na

se envió en la carta de

cobrança

cobranza

Campo	FWT_PROCES
Tipo

Caractere

Carácter

Tamanho

Tamaño

32

Descrição

Descripción

Número

do Processo

del proceso

Título

Processo

Proceso
Picture	@!
Help de

Campo

campo

Número

do processo onde a

del proceso donde se envió la carta de

cobrança foi enviada

cobranza.
Campo	FWT_DTREFE
Tipo

Data

Fecha

Tamanho

Tamaño

8

Descrição

Descripción

Data

Fecha de

Referência

referencia

Título

Dt

Fch. Referenc

Help de

Campo

campo

Data

Fecha de

Referência

referencia para

correção

corrección de valores

Grupo de

Perguntoas

preguntas (SX1):

FINR810

FINR810

X1_ORDEM	01
X1_PERGUNT	De Carta de

Cobrança de

cobranza

X1_TIPO

Caractere

Carácter
X1_TAMANHO	6
X1_GSC	Get
X1_VAR01	MV_PAR01
X1_F3	FWP
X1_HELP	Define

o range

el rango inicial de layout de cartas de

cobrança

cobranza.
X1_ORDEM	02
X1_PERGUNT	A Carta de

Cobrança até

cobranza

X1_TIPO

Caractere

Carácter
X1_TAMANHO	6
X1_GSC	Get
X1_VAR01	MV_PAR02
X1_F3	FWP
X1_HELP	Define

o range

el rango final de layout de cartas de

cobrança

cobranza.

X1_ORDEM	03
X1_PERGUNT

Data

De Fecha de

Envio de

envío

X1_TIPO

Data

Fecha
X1_TAMANHO	8
X1_GSC	Get
X1_VAR01	MV_PAR03
X1_HELP	Define

a data inicial do range das cobranças

la fecha inicial del rango de las cobranzas enviadas.
X1_ORDEM	04
X1_PERGUNT

Data

A Fecha de

Envio até

envío

X1_TIPO

Data

Fecha
X1_TAMANHO	8
X1_GSC	Get
X1_VAR01	MV_PAR04
X1_HELP	Define

a data final do range das cobranças

la fecha final del rango de las cobranzas enviadas.

X1_ORDEM	05
X1_PERGUNT	De Cliente

de

X1_TIPO

Caractere

Carácter
X1_TAMANHO	6
X1_GSC	Get
X1_VAR01	MV_PAR05
X1_F3	SA1
X1_GRPSXG	001
X1_HELP	Define

o Cliente inicial do range

el cliente inicial del rango.
X1_ORDEM	06
X1_PERGUNT

Loja de

De Tienda

X1_TIPO

Caractere

Carácter
X1_TAMANHO	2
X1_GSC	Get
X1_VAR01	MV_PAR06
X1_GRPSXG	002
X1_HELP	Define

a loja inicial do range.

la tienda inicial del rango.

X1_ORDEM	07
X1_PERGUNT	A Cliente

até

X1_TIPO

Caractere

Carácter
X1_TAMANHO	6
X1_GSC	Get
X1_VAR01	MV_PAR07
X1_F3	SA1
X1_GRPSXG	001
X1_HELP	Define

o

el cliente final

do range

del rango.
X1_ORDEM	08
X1_PERGUNT

Loja até

A Tienda

X1_TIPO

Caractere

Carácter
X1_TAMANHO	2
X1_GSC	Get
X1_VAR01	MV_PAR08
X1_GRPSXG	002
X1_HELP	Define

a loja final do range

la tienda final del rango.

X1_ORDEM	09
X1_PERGUNT	Imprime
X1_TIPO

Caractere

Carácter
X1_TAMANHO	1
X1_GSC	Combo
X1_VAR01	MV_PAR09
X1_DEF01	Analítico
X1_DEF02	Sintético
X1_HELP	Define

se o relatório será impresso em

si el informe se imprimirá en formato analítico (

com a

con la carta completa,

contendo os textos e demais detalhes) ou em

conteniendo los textos y otros detalles) o en formato sintético (

apenas com os registros enviados em cobrança e suas quebras).

solamente con los registros enviados en cobranza y sus divisiones).

Consulta Padrão Consultas estándar (SXB): FWP FWP

Descrição

Descripción

Cartas de

Cobrança

cobranza
Tipo	Consulta

Padrão

estándar

Tabela

Tabla	FWP
Índice	Código
Campo	Código;

Descrição

Descripción

Retorno

Devolución

FWP_

CODCRT

Expandir

title	Execução AutomáticaEjecución automática

Para a correta execução automática da rotina FINA811, é necessário informar os parâmetros da função conforme abaixo:

nOpcAuto = Parâmetro não utilizado no momento, enviar valor 0.

a811Param = Este array deverá receber o filtro desejado para seleção dos registros e envio das cartas de cobrança. Todos os registros retornados pelo filtro terão uma carta de cobrança gerada.

Ex.:

a811Param[01] := Código do cliente De (tipo caracter)

a811Param[02] := Loja do cliente De (tipo caracter)

a811Param[03] := Código do cliente Até (tipo caracter)

a811Param[04] := Loja do cliente Até (tipo caracter)

a811Param[05] := Data de emissão De (tipo data)

a811Param[06] := Data de emissão Até (tipo data)

a811Param[07] := Data de referência (tipo data)

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

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

a811Param[10] := "2" (tipo caracter) - IMPORTANTE: SEMPRE 2 PARA NÃO APRESENTAR TELA DE SELEÇÃO DE FILIAIS

a811Param[11] := Títulos a vencer (tipo caracter sendo "1" = Sim ou "2" = Não)

a811Param[12] := Considera valor (tipo caracter sendo "1" = Total ou "2" = Saldo)

a811Param[13] :="2" (tipo caracter) - IMPORTANTE: SEMPRE 2 PARA NÃO APRESENTAR TELA DE SELEÇÃO DE SITUAÇÃO DE COBRANÇA

a811Param[14] := {} (tipo array) - IMPORTANTE: ENVIAR ARRAY VAZIO

a811Param[15] := "" (tipo caracter) - IMPORTANTE: SEMPRE VAZIO

a811Param[16] := Código do layout da carta a ser utilizado (tipo caracter)

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ón	Tipo	Descripción
1	Numeric	Opción de ejecución. Enviar siempre valor 0.
2	Array	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
3	Logical	Uso interno. Enviar NIL o .F.
4	Character	Expresión SQL para complementar el filtro de títulos. Ejemplo: "E1_TIPO = 'BOL'"

Bloco de código

language	java
theme	Midnight
firstline	1
title	Ejemplo de ejecución automática FINA811
linenumbers	true

#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

Atalhos

Árvore de páginas

Versões comparadas

Versão antiga 1

Nova versão Atual

Chave

ÍNDICE

Índice
maxLevel

2
minLevel 2
indent 8.1.1
exclude

ÍNDICE
style none

01.

VISIÓN GENERAL

02.

REGLAS Y DEFINICIONES

03. PARÂMETROS UTILIZADOS

04. PONTOS DE ENTRADA

05. DADOS TÉCNICOS

03. PARÁMETROS UTILIZADOS

05. DATOS TÉCNICOS

Atalhos

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 1

Nova versão Atual

Chave

ÍNDICE

ÍndicemaxLevel

2minLevel2indent8.1.1exclude

ÍNDICEstylenone

01.

VISIÓN GENERAL

02.

REGLAS Y DEFINICIONES

03. PARÂMETROS UTILIZADOS

04. PONTOS DE ENTRADA

05. DADOS TÉCNICOS

03. PARÁMETROS UTILIZADOS

05. DATOS TÉCNICOS

Índice
maxLevel

2
minLevel 2
indent 8.1.1
exclude

ÍNDICE
style none