Pagamento Eletrônico e Cobrança Escritural

Alguns conceitos básicos:

Importação= Retorno

Exportação= Remessa

Um layout de Pagamento Eletrônico e Cobrança Escritural, seja ele de retorno ou remessa jamais poderá ser executado pelo menu Recursos/Implementações/Importação/Exportação/Executar.

Eles somente serão executados via Tela de cobrança escritural:

F310PRB_FRES - Finanças / Gestão de Contas a Receber / Cobrança Escritural / Remessa

F310RTB_FRES - Finanças / Gestão de Contas a Receber / Cobrança Escritural / Retorno

ou Pagamento eletrônico:

F510PRM_FPPE - Finanças / Gestão de Contas a Pagar / Pagamento Eletrônico / Remessa

F510PRT_FPPE - Finanças / Gestão de Contas a Pagar / Pagamento Eletrônico / Retorno

Lembrando que o vínculo dos mesmos é através da tela de cadastro de portador -> F039POR - Cadastros / Finanças / Portadores. Campos “Código Layout Exportação”, “Código Layout Importação” referentes a cobrança escritural e os campos “Código Layout Exportação PE” e “Código Layout Importação PE” do Pagamento eletrônico.

O layout de remessa sempre será do Tipo Layout Fixo:

A WWMEMTITULOS é uma tabela virtual, ela não existe no Sapiens.TBS e não é uma função. A utilização dela é na grade do layout de cobrança escritural ou pagamento eletrônico para disponibilizar valores em referidos campos.

Exemplo:

Para obter uma informação da WWMEMTITULOS e jogar direto no txt de remessa o valor, basta colocar este campo na grade conforme exemplo acima. Isso vale tanto para pagamento eletrônico quanto para cobrança escritural.

Não é possível fazer cursor para obter valores da WWMEMTITULOS e nem atribuir valor direto para a mesma.

Veja que já ocorre erro na compilação, pois não reconhece a estrutura da WWMEMTITULOS:

Em resumo, jamais pode ser utilizada em regras no layout WWMEMTITULOS.+NomeVariavel e nem construção de cursor com a WWMEMTITULOS.

Todos os campos da WWMEMTITULOS estão no help: Ajuda > Ajuda do ERP > Funções para regras e Gerador de relatórios > Variáveis.

Portanto no layout de remessa para obter informações da WWMEMTITULOS nas regras do layout é necessário utilizar FINPE+nome variável se pagamento eletrônico e, FIN+nome variável de cobrança escritural. Veja que na figura acima já traz o nome da variável com a nomenclatura FIN no início.

Dentro das regras do layout essas variáveis ficam na cor vermelha. Veja exemplo abaixo do uso das variáveis num layout de remessa de pagamento eletrônico:

Valores fixos no layout

Quando existir valores que não são alterados, pode-se fixar as informações no campo variável colocando o valor desejado entre aspas duplas " ". Segue abaixo um exemplo:

Valores variáveis com tratamento em regras

Quando existir variáveis no campo Variável é necessário sempre ter um tratamento via regra no layout para obter valores nesses campos.

Exemplo de regras com tratamentos dos campos:

Retorno da cobrança escritural e pagamento eletrônico:

O Tipo Layout sempre será Layout Fixo. Porém a forma de importação poderá ser diferente. Veja que na figura abaixo é do layout padrão 51 e a importação consta somente uma linha com tamanho de 240 posições e é feito o controle tudo via regra separando os campos:

Após separar os campos em cada variável, é necessário atribuir para campos que o Sistema irá receber os valores. No caso, terá que fazer através da função AlteraCampoRetorno na cobrança escritural e AlteraCampoRetornoPE no pagamento eletrônico.

Em resumo, no retorno do pagamento eletrônico e cobrança escritural não é possível atribuir um valor para WWMEMTITULOS, igual já comentamos dos layouts de remessa. Neste caso do retorno terá que fazer uso das funções AlteraCampoRetorno ou AlteraCampoRetornoPE.

Logo abaixo segue exemplo da função AlteraCampoRetorno da cobrança escritural. Veja que no campo TitBan foi passado zero no último parâmetro, já no campo VlrTit tem aspas duplas no segundo campo. Isso é necessário devido os tipos dos campos serem diferentes. Ou seja, o TitBan é um campo Alfa e o VlrTit numérico. Neste exemplo abaixo estamos atribuindo a informações do campo VTitBan para TitBan e VVlrTit para VlrTit.

Essas informações dos tipos dos campos e quais estão disponíveis para o layout de retorno fica no mesmo lugar da remessa. Ajuda > Ajuda do ERP > Funções para regras e Gerador de relatórios > Variáveis. Somente muda o link conforme pode ser visto abaixo:

Dica: Clicando uma vez encima do nome da variável é possível ver o tipo da mesma.

Outro tipo de layout que é fixo porém não precisa fazer a separação dos campos via regra é o padrão 045. Veja figura abaixo, perceba que os campos que serão importados já constam em Campo Tabela.

Nos layouts de retorno, sempre a tabela destino será a WWMEMTITULOS.

Código de Registro (+): é a letra que vem do txt para identificar qual registro será importado.

Nunca usar consistência padrão. Sugerimos sempre deixar todas as opções padrão. Veja um exemplo abaixo:

Erros comuns de layout de exportação (remessa):

-Na geração do arquivo de remessa para o Banco, retorna uma mensagem de erro:

Access violation at address 430EE60E in module 'rts02.bpl'.

Read of address 0000002C

Resposta: Este erro ocorre quando o layout de exportação(remessa) está escrito errado o nome da WWMEMTITULOS

As vezes é trocado o M por N ou esquecem do S do final ou então colocam 3 W ou invés de 2.

Dessa forma, para solução basta arrumar o nome correto: WWMEMTITULOS

- Como buscar o número de identificação da empresa no Banco? Podemos usar o campo E039Por.NumCce ?

Resposta: Deverá fazer um cursor na tabela E039POR passando o código do portador(FinCodPor) e empresa no "Where" e retornando o campo NumCce.

- Qual o campo que descreve o número do endereço, rua e bairro e de onde o Sistema busca para a cobrança escritural?

Resposta:

O campo que possui o número do endereço do cliente é wwmemtitulos.NenCli

O campo que possui o nome da rua ficou wwmemtitulos.EndCli

Segue exemplo, pode ser utilizado no layout: 35 ENDCLI e 5 NENCLI.

- Quando é gerado uma remessa de arquivo de boletos agrupados para o Banco, a data de emissão fica zerada e o Banco rejeita a remessa.

Resposta:

É necessário fazer o tratamento do campo DatEmi.

Para isso, é necessário tirar da grid do layout o campo WWMEMTITULOS.DATEMI e substituir por uma variável. Depois essa variável deverá ser alimentada via regra no layout no procedimento a cada gravação.

Segue sugestão de regra:

Se (FinCodTpt = "AGR")

vdatemi = FinDatGer;

Senao

vdatemi = FinDatEmi;

Dessa forma, quando o título for agrupado deverá preencher com a informação da data da geração da remessa. Assim atenderá a exigência do Banco.

Lembrando que essa informação deverá ser alterada em todos os registros que tenham o campo DatEmi.

- Não grava o nosso número no arquivo txt e quando isso ocorre, o nosso número é repetido para os títulos da remessa.

Resposta:

Se estiver calculando o nosso número dentro do layout de remessa, é necessário depurar o modelo que atualiza o nosso número para verificar se está atualizando as variáveis abaixo:

Finnosnum - atualiza o nosso número no título

Finrecunn - atualiza o nosso número no cadastro do portador

Erros comuns de layout de importação (retorno):

- Ao fazer a importação do arquivo de retorno da cobrança escritural ou pagamento eletronico ocorre a seguinte mensagem:

Access violation at address 43B83F18 in module 'svcl02.bpl'

Resposta:

É necessário abrir o arquivo de retorno num aplicativo que identifica se o txt possui caracteres especiais. Neste caso sugerimos o aplicativo UltraEdit ou similar, pois ele identifica esses casos.

Sabendo quais posições tem estes caracteres, basta excluir do txt para resolver o problema.

- Ao fazer o retorno da cobrança escritural do Banco do Brasil na tela F310RTB, clicar em mostrar para visualizar os títulos na tela e posteriormente clicar em "Imprimir" para verificar os relatórios com o log de erro aparece a mensagem: Erro ou cancelamento na seleção do modelo! Título "980607/001", Tipo " " não foi localizado na filial x.

Resposta:

Ao mostrar esta mensagem é necessário verificar como está no layout o retorno da variável ESPBAN e verificar na tela F030COB - Cadastros / Finanças / Bancos / Parâmetros / Cobrança Escritural na guia espécie, se a espécie que está retornando está vinculada a um tipo de título interno.

- Ao executar a leitura do arquivo de retorno, apresenta a mensagem Conta Empresa está em branco para ocorrência e liquidação 06.

Resposta:

Primeiramente verificar no cadastro da conta interna tela F600CCO - Cadastros / Finanças / Tesouraria / Contas Internas, está informado a conta banco e verificar no layout de retorno, se o campo CTAEMP está informado para este registro.

- Ao fazer o retorno da cobrança escritural ocorre a seguinte mensagem de erro: “Banco “000” e Código “00” não possuem um Código Interno ligado – E030ORT”

Resposta:

Alterar o código do banco através das seguintes opções:

- AlteraCampoRetorno(“CodBan”,“001”,0);

- ou no layout, para o Campo Tabela CODBAN, informar na coluna Variável o valor “001”.

Procedimento de DATAS no retorno da Cobrança Escritural:

Exemplo explicativo:

No arquivo de retorno da Cobrança Escritural existem as seguintes datas:

DATMOV=20/07/2016 : É a data do movimento na baixa do Contas a Receber (esta não é a data de movimento da Tesouraria);

DATPGT=15/07/2016: É a data de pagamento da baixa do Contas a Receber.

Na tela F310RTB_FRES - Finanças / Gestão de Contas a Receber / Cobrança Escritural / Retorno, ao mostrar estes campos, serão carregados para a grade "Retorno - Sem Erro" nos campos "Dat.Mov.", "Dat.Pgto" e "Dat.Cré." respectivamente.

Ao PROCESSAR na tela F310RTB:

Será aberta a tela F301BMA carregando:

DATPGT (15/07/2016) para os campos "Data Baixa" no grupo Recebimento e "Data Movimento" no grupo Tesouraria (a DATA MOVIMENTO da Tesouraria pode ser alterada).

Ao PROCESSAR nesta tela, os movimentos (contas a receber e Tesouraria) ficarão com as seguintes datas:

MOVIMENTO DO CONTAS A RECEBER:

DATA MOVIMENTO: receberá a data do movimento apresentada na tela de retorno da Cobrança Escritural (DATMOV), conforme descrito acima, ou seja, 20/07/2016;

DATA PAGAMENTO: receberá a data da baixa (DATPGT) apresentada no campo "Data Baixa" da tela F301BMA, ou seja, 15/07/2016;

DATA MOVIMENTO TESOURARIA (abaixo da Conta Interna): receberá a "Data do Movimento" da tesouraria apresentada na tela F301BMA, ou seja, 15/07/2016 (pode ser alterado pelo usuário);

DATA LIBERAÇÃO (é a data de liberação do movimento do Contas a Receber e não da Tesouraria): também recebe a data de pagamento (DATPGT, 15/07/2016).

MOVIMENTO DA TESOURARIA:

DATA MOVIMENTO: recebe a "Data Movimento" da tela F301BMA, ou seja, DATPGT (15/07/2016) - (se foi alterado pelo usuário, será gravada a data informada pelo usuário);

DATA CONTÁBIL: recebe a DATPGT (15/07/2016) ou a nova data alterada pelo usuário;

DATA LIBERAÇÃO: recebe a DATPGT (15/07/2016) ou a nova data alterada pelo usuário.

OBSERVAÇÃO: Caso houver Data de Geração (DATGER) diferente de zero no layout do arquivo de retorno da CE, esta data será carregada para a Data de Baixa do movimento do Contas a Receber e para a Data de MOVIMENTO da Tesouraria, na tela F301BMA_FRCR - Finanças / Gestão de Contas a Receber / Contas a Receber / Baixas de Títulos / Por Lote - Automáticas.