Árvore de páginas

Versões comparadas

Chave

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

Tempo aproximado para leitura: 05 min

ÍNDICE

Índice
maxLevel5
indent8.1.1
exclude.*ndice
stylenone


01. VISÃO GERAL

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/ou 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.

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, de forma específica, dos clientes que receberão as cartas de cobrança.

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.

02. REGRAS E DEFINIÇÕES


Expandir
titleFluxo operacional

Fluxo.png



Expandir
titleDescrição do processo
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 de entrada que permita complementar a query que considerará os parâmetros padrões.

Seleção de layout

Será apresentada uma relação dos layouts de carta de cobrança cadastrados para que seja possível selecionar qual o layout que será utilizado para envio. Só poderá ser selecionado um único layout de carta de cobrança por envio.

Seleção de clientes

Será apresentada uma relação dos clientes que atendem aos critérios do filtro, para que possam ser selecionados para envio das carta de cobrança. Todos serão apresentadas na tela já selecionados/marcados.

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

Existe a possibilidade de enviar títulos que estão ainda a 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.

É importante ressaltar que, com a implementação do Bloqueio por Situação de Cobrança (vide  http://tdn.totvs.com/pages/viewpage.action?pageId=381044073), os títulos em situação de cobrança com bloqueio configurado para as cartas de cobrança não estarão disponíveis neste processo de envio 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.

Além disso, um título será elegível para o envio de cartas enquanto ainda não foram quitados, ou seja, que atendem à regra de envio da cobrança. 

Expandir
titleExemplo de utilização

1 - No dia 01/03/2015, foi enviado um e-mail com os títulos abaixo para cobrança, considerando vencimentos com mais de 10 dias de atraso:


TítuloVencimentoDias em atraso
DUP225130101/02/201528
DUP222210201/01/201559
DUP255120115/12/201476


2 - Em 15/03/2015, o cliente efetuou o pagamento das duas parcelas com maior atraso, mas não quitou a parcela de 01/02/2015. A cobrança enviada continha:

TítuloVencimentoDias em atraso
DUP225130101/02/201548


Sendo assim, enquanto este não for recebida, o título será enviado em novas cobranças. Ressaltamos que este exemplo considera somente o vencimento, mas que o título deve respeitar todas as regras do filtro.


Expandir
titleDefinição do layout

Rotina: FINA810 - Layouts de Carta de Cobrança

Cada carta enviada será definida conforme o teor de cobrança, ou seja, será possível incluir um texto de um determinado teor para diferentes tipos de cobrança.

Para tanto, serão disponibilizadas formas de configurar os 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

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 de e-mail e/ou carta física, poderá haver algum 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.


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

Layout_1.JPG

 - 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 título, valor, data de vencimento, etc), bem como são definidas as regras personalizadas de envio. Nesse campo deve ser informado uma expressão como as de filtros de tela (browse) do Protheus. Está posicionada a tabela de Clientes (SA1). 

Layout_2.JPG

Expandir
titleEnvio das Cartas

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 inicial do wizard.

Step_1.JPG


 - Definição dos parâmetros para busca e filtragem das informações. 

  1. Cliente e loja de (intervalo inicial de cliente e loja);
  2. Cliente e loja até (intervalo final de cliente e loja);
  3. Vencimento de (intervalo de vencimento inicial dos títulos);
  4. Vencimento até (intervalo de vencimento final dos títulos);
  5. Valor de (intervalo de valor inicial dos títulos);
  6. Valor até (intervalo de valor final dos títulos);
  7. 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);
  8. 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);
  9. Títulos a vencer (caso esteja como sim, o filtro vai considerar os títulos que ainda estão por vencer);
  10. Data de referência para cálculo de juros e multa dos títulos;
  11. 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 "2-Saldo", o sistema irá filtrar os registros com conteúdo no campo E1_SALDO entre os valores informados nos itens 5 e 6 dessa janela ).


 - Seleção do layout da carta (apenas 1 layout poderá ser selecionado).

Step_3.JPG


 - Seleção do(s) cliente(s).

Step_4.JPG


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

Step_5.JPG

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

Step_6.JPG


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

Step_7.JPG

 - Consulta do log


 - Modelo do e-mail enviado ao cliente.

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


Expandir
titleConsideraçõ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
titleRelatório de Cartas de Cobrança

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:


 - Impressão no modelo analítico

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


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.


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.


As rotinas referentes aos 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. DICIONÁRIOS UTILIZADOS

Arquivo: FWP – Carta de Cobrança

Tabela

Descrição

Sigla

FWP

Nome

Cartas de Cobrança

Mod. Ac. Filial

Exclusivo

Mod. Ac. UnidadeExclusivo
Mod. Ac. EmpresaExclusivo
Chave únicaFWP_FILIAL+FWP_CODCRT

Índice

Chave

01

FWP_FILIAL+FWP_CODCRT

Campo

FWP_FILIAL

Tipo

Caractere

Tamanho

8

Descrição

Filial do sistema

Título

Filial

Picture

@!

Grupo de Campos033

Help de Campo

Filial do sistema

Campo

FWP_CODCRT

Tipo

Caractere

Tamanho

6

Descrição

Código do Layout

Título

Cód. Layout

Picture

@!

Help de Campo

Defina o código do layout da Carta de Cobrança.

Campo

FWP_DESCRI

Tipo

Caractere

Tamanho

40

Descrição

Descrição do layout

Título

Descrição

Picture

@!

Help de 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 enviadas.

Campo

FWP_STATUS

Tipo

Caractere

Tamanho

1

Descrição

Status do layout

Título

Status

Picture

@!

ValidaçãoPertence("12")
Lista de Opções1=Ativo;2=Inativo

Help de Campo

Define se o layout da carta de cobrança está ativo ou inativo. Somente layouts ativos poderão ser enviados em cobrança.

Campo

FWP_TXTSAU

Tipo

Caractere

Tamanho

60

Descrição

Texto da Saudação

Título

Saudação

Help de Campo

Texto de saudação que será enviado na carta de cobrança. O texto de saudação representa o início da carta. Exemplo: "Prezado Cliente".

Campo

FWP_TXTCRT

Tipo

Memo

Tamanho

500

Descrição

Texto da Carta

Título

Txt Carta

Help de Campo

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

Campo

FWP_TXTCON

Tipo

Memo

Tamanho

500

Descrição

Texto de Conclusão

Título

Conclusão

Help de Campo

O texto de conclusão, caso informado, será enviado ao final da carta, como complemento da cobrança efetuada ou com informações adicionais.

Campo

FWP_ENVIO

Tipo

Caractere

Tamanho

1

Descrição

Tipo de Envio

Título

Tp Envio

Picture

@!

Lista de Opções1=E-mail;2=Carta Física;3=Ambos
ValidaçãoPertence("123")

Help de Campo

Tipo de envio da carta de cobrança, sendo: E-mail - as cartas serão enviadas para o e-mail contido no cadastro de clientes; Carta Física - o envio da carta será feito de forma física, ou seja, a carta impressa será enviada diretamente ao cliente; Ambos - o envio será efetuado das duas formas.

Campo

FWP_POSVER

Tipo

Numérico

Tamanho

4

Descrição

Pos vertical do endereço

Título

Pos Vertical

Picture

@E 9999

Help de Campo

Posição inicial vertical do endereço em pixels. Esse campo só será habilitado quando o layout estiver com a forma de envio definida como "Carta Física" ou "Ambos".

Campo

FWP_POSHOR

Tipo

Numérico

Tamanho

4

Descrição

P Horizontal do Endereço

Título

P Horizontal

Picture

@E 9999

Help de Campo

Posição inicial horizontal do endereço em pixels. Esse campo só será habilitado quando o layout estiver com a forma de envio definida como "Carta Física" ou "Ambos".


Arquivo: FWQ – Regras de Envio 

Tabela

Descrição

Sigla

FWQ

Nome

Regras de Envio

Mod. Ac. Filial

Exclusivo

Mod. Ac. UnidadeExclusivo
Mod. Ac. EmpresaExclusivo
Chave únicaFWQ_FILIAL+FWQ_LAYOUT


Índice

Chave

01

FWQ_FILIAL+FWQ_LAYOUT

Campo

FWQ_FILIAL

Tipo

Caractere

Tamanho

8

Descrição

Filial do sistema

Título

Filial

Picture

@!

Grupo de Campos033

Help de Campo

Filial do sistema

Campo

FWQ_LAYOUT

Tipo

Caractere

Tamanho

6

Descrição

Código do Layout

Título

Cód Layout

Picture

@!

Help de Campo

Código do layout da carta de cobrança

Campo

FWQ_FILTRA

Tipo

Caractere

Tamanho

254

Descrição

Exp de filtros adicionais

Título

Expressão

Picture

@!

Help de Campo

Expressão de filtro que será utilizada para filtrar os 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 

Tabela

Descrição

Sigla

FWS

Nome

Dados dos Títulos

Mod. Ac. Filial

Exclusivo

Mod. Ac. UnidadeExclusivo
Mod. Ac. EmpresaExclusivo
Chave únicaFWS_FILIAL+FWS_LAYOUT+FWS_CAMPO


Índice

Chave

01

FWS_FILIAL+FWS_LAYOUT+FWS_SEQ+FWS_CAMPO

Campo

FWS_FILIAL

Tipo

Caractere

Tamanho

8

Descrição

Filial do Sistema

Título

Filial

Picture

@!

Grupo de Campos033

Help de Campo

Filial do sistema

Campo

FWS_LAYOUT

Tipo

Caractere

Tamanho

6

Descrição

Código do Layout

Título

Cód. Layout

Picture

@!

Help de Campo

Código do Layout

Campo

FWS_SEQ

Tipo

Caractere

Tamanho

4

Descrição

Sequência de Campos

Título

Sequência

Picture

@!

Help de Campo

Armazena a sequência de gravação dos campos que serão exibidos nas cartas enviadas por e-mail.

Campo

FWS_CAMPO

Tipo

Caractere

Tamanho

10

Descrição

Campo do título

Título

Campo

Picture

@!

Help de Campo

Campo que será exibido no corpo da carta de cobrança.

Campo

FWS_DESCRI

Tipo

Caractere

Tamanho

15

Descrição

Descrição do Campo

Título

Descrição

Help de Campo

Descrição do campo que será apresentada na 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 

Tabela

Descrição

Sigla

FWT

Nome

Cartas Enviadas

Mod. Ac. Filial

Exclusivo

Mod. Ac. UnidadeExclusivo
Mod. Ac. EmpresaExclusivo
Chave únicaFWT_FILIAL+FWT_LAYOUT+FWT_PROCES+FWT_CHAVE


Índice

Chave

01

FWT_FILIAL+FWT_LAYOUT+FWT_PROCES+FWT_CHAVE

Campo

FWT_FILIAL

Tipo

Caractere

Tamanho

8

Descrição

Filial do Sistema

Título

Filial

Picture

@!

Grupo de Campos033

Help de Campo

Filial do sistema

Campo

FWT_LAYOUT

Tipo

Caractere

Tamanho

6

Descrição

Código do Layout

Título

Cód. Layout

Picture

@!

Help de Campo

Código do Layout

Campo

FWT_DTENVI

Tipo

Data

Tamanho

8

Descrição

Data de Envio

Título

Dt Envio

Help de Campo

Data de envio da Carta de Cobrança

Campo

FWT_CHAVE

Tipo

Caractere

Tamanho

32

Descrição

Chave do Documento

Título

Chave

Picture

@!

Help de Campo

Chave do título que foi enviado na carta de cobrança

Campo

FWT_PROCES

Tipo

Caractere

Tamanho

32

Descrição

Número do Processo

Título

Processo

Picture

@!

Help de Campo

Número do processo onde a carta de cobrança foi enviada.

Campo

FWT_DTREFE

Tipo

Data

Tamanho

8

Descrição

Data de Referência

Título

Dt. Referenc

Help de Campo

Data de Referência para correção de valores

Grupo de Perguntas (SX1)

Nome: FINR810

X1_ORDEM

01

X1_PERGUNT

Carta de Cobrança de

X1_TIPO

Caractere

X1_TAMANHO

6

X1_GSC

Get

X1_VAR01

MV_PAR01

X1_F3

FWP

X1_HELP

Define o range inicial de layout de cartas de cobrança.

X1_ORDEM

02

X1_PERGUNT

Carta de Cobrança até

X1_TIPO

Caractere

X1_TAMANHO

6

X1_GSC

Get

X1_VAR01

MV_PAR02

X1_F3

FWP

X1_HELP

Define o range final de layout de cartas de cobrança.

X1_ORDEM

03

X1_PERGUNT

Data de Envio de

X1_TIPO

Data

X1_TAMANHO

8

X1_GSC

Get

X1_VAR01

MV_PAR03

X1_HELP

Define a data inicial do range das cobranças enviadas.

X1_ORDEM

04

X1_PERGUNT

Data de Envio até

X1_TIPO

Data

X1_TAMANHO

8

X1_GSC

Get

X1_VAR01

MV_PAR04

X1_HELP

Define a data final do range das cobranças enviadas.

X1_ORDEM

05

X1_PERGUNT

Cliente de

X1_TIPO

Caractere

X1_TAMANHO

6

X1_GSC

Get

X1_VAR01

MV_PAR05

X1_F3

 SA1

X1_GRPSXG

001

X1_HELP

Define o Cliente inicial do range.

X1_ORDEM

06

X1_PERGUNT

Loja de

X1_TIPO

Caractere

X1_TAMANHO

2

X1_GSC

Get

X1_VAR01

MV_PAR06

X1_GRPSXG

002

X1_HELP

Define a loja inicial do range.

X1_ORDEM

07

X1_PERGUNT

Cliente até

X1_TIPO

Caractere

X1_TAMANHO

6

X1_GSC

Get

X1_VAR01

MV_PAR07

X1_F3

 SA1

X1_GRPSXG

001

X1_HELP

Define o cliente final do range.

X1_ORDEM

08

X1_PERGUNT

Loja até

X1_TIPO

Caractere

X1_TAMANHO

2

X1_GSC

Get

X1_VAR01

MV_PAR08

X1_GRPSXG

002

X1_HELP

Define a loja final do range.

X1_ORDEM

09

X1_PERGUNT

Imprime

X1_TIPO

Caractere

X1_TAMANHO

1

X1_GSC

Combo

X1_VAR01

MV_PAR09

X1_DEF01

Analítico

X1_DEF02Sintético

X1_HELP

Define se o relatório será impresso em formato analítico (com a carta completa, contendo os textos e demais detalhes) ou em formato sintético (apenas com os registros enviados em cobrança e suas quebras).

Consulta Padrão (SXB)

Consulta: FWP

Descrição

Cartas de Cobrança

Tipo

Consulta Padrão

Tabela

FWP

Índice

Código

Campo

Código;Descrição

Retorno

FWP_CODCRT