Liberação de Pagamento CTRB/RPA
A rotina de Liberação de Pagamento CTRB/RPA realiza comunicação com as operadoras NDD, Pamcary e Repom, creditando o valor dos títulos de adiantamento e saldo de CIOT no cartão do proprietário ou motorista e realizando baixa financeira dos títulos. Possibilitando a seleção de lotes de títulos de CIOT, autorização de liberação de pagamento destes lotes no sistema das operadoras e baixa financeira dos títulos.
Sistema apresenta títulos de adiantamento/saldo de CIOT das operadoras NDD, Pamcary e Repom, conforme filtro definido pelo usuário. Após definido os títulos que serão liberados para pagamento, e é realizada comunicação com a operadora, exibindo tela ao usuário com o status da integração. Quando integração é realizada com sucesso, é executada a baixa financeira dos títulos no sistema. O que por sua vez agiliza o processo, permitindo liberar pagamento de lotes de títulos, sem a necessidade de acesso ao sistema da operadora e a baixa financeira destes títulos no sistema.
Pré-Requisitos
- Possuir CTRB/RPA com informação de CIOT registrado no sistema para operadora NDD, Pamcary ou Repom, com fatura/título vinculada.
- Utilizar a dll de uma das operadoras e os módulos FIN, FTR e CFG.
Configurações
Em FTR > Cadastros > Motoristas > Freteiros - É necessário que na guia Informações Complementares, grupo Dados para Geração do CIOT, as configurações Adiantamento e Saldo estejam iguais a Manual.
Desta maneira, no envio do arquivo de Operação de Transporte (NDD), será informado às operadoras que a liberação do pagamento será realizada em momento posterior.
Para permitir/bloquear pagamentos de CTRB/RPA acesse o módulo CFG > Utilitários > Configurações > TMS > Freteiros, guia CIOT e marque uma das opções desejada:
- Opção 1: Liberação de pagamento ao Freteiro apenas quando CTe vinculado a CTRB ter baixado os comprovantes de entrega.
- Opção 02: Liberação de pagamento ao Freteiro apenas quando coleta vinculada a CTRB estiver baixada.
Exemplo: Se no módulo FIN ao Liberar o pagamento do saldo ao freteiro com comprovante de entrega e coleta em aberto do CT-e:
Se as configurações estiverem marcadas: O pagamento do saldo ao freteiro, poderá ser feito apenas após todos os CT-e tiverem comprovante de entrega e coleta baixados
Se as configurações estiverem desmarcadas: O pagamento do saldo ao freteiro será liberado, mesmo com comprovantes de entrega e coleta em aberto ainda.
Quando operadora for NDD, será gerado um arquivo de Pagamento Imediato de Parcelas (que informa a NDD a liberação de pagamento) e um arquivo de Consulta de eventos de Efetivação de Pagamento (para verificar se o pagamento foi realizado).
O layout do arquivo de Pagamento Imediato de Parcelas deve ter o formato definido conforme manual da NDD.
Onde:
- Token: Se configuração Permitir a utilização de operadoras de pagamento eletrônico simultaneamenteestiver:
- Marcada: utilizar campo Token de Processamento, do Cadastro de Operadora de Pagamento eletrônico CTRB/RPA, guia Geração CIOT, grupo Geral.
- Desmarcada, utilizar campo Token de Processamento do Cadastro de Empresas, guia Freteiros, grupo Geração CIOT, guia Geral;
- Versão : Se configuração Permitir a utilização de operadoras de pagamento eletrônico simultaneamente
- Marcada: utilizar campo Versão da Integração, do Cadastro de Operadora de Pagamento eletrônico CTRB/RPA > Geração CIOT, grupo Geral.
- Desmarcada: utilizar campo Versão da Integração do Cadastro de Empresas > Freteiros, grupo Geração CIOT > Geral;
- CNPJ : utilizar lógica da função RetornarCNPJMatriz, da unit uCIOTNDD;
- Nome da Parcela: caso para o CTRB/RPA tenha sido gerado dois títulos, o primeiro (com final 01) será referente ao adiantamento e o segundo (com final 02) será referente ao saldo. Caso tenha sido gerado somente um título para o CTRB/RPA, este título será considerado como título de saldo. Para títulos de adiantamento o nome da parcela será Adiantamento, e para títulos de saldo o nome da parcela será Saldo;
- Motivo: Liberação de Pagamento
- Numero: Número do CIOT do CTRB/RPA
- Protocolo de Autorização: Número do protocolo do CTRB/RPA
O arquivo terá a seguinte nomenclatura: EnvPimd_+ código da empresa do CTRB/RPA + número do CTRB/RPA.txt
Para cada título será gerado um arquivo no diretório configurado. Após geração do arquivo Pagamento Imediato de Parcelas, é realizado leitura do arquivo de retorno.O arquivo de retorno referente ao Pagamento Imediato de Parcelas possui layout definido no manual NDD.
Ao realizar a leitura do arquivo de retorno referente ao Pagamento Imediato de Parcelas, será listado no campo Log da tela de Integração as seguintes informações:
- Empresa: empresa do CTRB/RPA
- CTRB/RPA: número do CTRB/RPA
- Título: número do título. Quando neste campo tiver a informação “Adiantamento”, refere-se ao título com final “01”, gerado para o CTRB/RPA. Quando neste campo tiver a informação “Saldo”, será verificado se foi gerado um ou dois títulos para o CTRB/RPA. Se tiver sido gerado somente um título, este refere-se ao saldo. Se tiver sido gerado dois títulos, o título com final “02” será o título referente ao saldo.
- Texto: Retorno Liberação de Pagamento + mensagem se a liberação de pagamento foi efetuada com sucesso ou não.
Após a leitura do arquivo de retorno referente ao Pagamento Imediato de Parcelas, se liberação de pagamento tenha sido efetuada com sucesso,será enviado arquivo de Consulta de eventos de Efetivação de Pagamento.
O layout do arquivo de Consulta de eventos de Efetivação de Pagamento deve ter o formato definido no seguinte manual
Onde:
- Token: Se configuração Permitir a utilização de operadoras de pagamento eletrônico simultaneamente estiver selecionada, utilizar campo Token de Processamento, do Cadastro de Operadora de Pagamento eletrônico CTRB/RPA, guia Geração CIOT, grupo Geral. Se configuração “Permitir a utilização de operadoras de pagamento eletrônico simultaneamente” não estiver selecionada, utilizar campo Token de Processamento do Cadastro de Empresas, guia Freteiros, grupo Geração CIOT, guia Geral;
- Versão: Se configuraçãoPermitir a utilização de operadoras de pagamento eletrônico simultaneamente estiver selecionada, utilizar campo Versão da Integração, do Cadastro de Operadora de Pagamento eletrônico CTRB/RPA, guia Geração CIOT, grupo Geral. Se configuração “Permitir a utilização de operadoras de pagamento eletrônico simultaneamente” não estiver selecionada, utilizar campo “Versão da Integração” do Cadastro de Empresas, guia Freteiros, grupo Geração CIOT, guia Geral;
- cnpjContratante : utilizar lógica da função RetornarCNPJMatriz, da unit uCIOTNDD;
- datainicial : data atual;
- datafinal : data atual.
Após geração do arquivo de Consulta de eventos de Efetivação de Pagamento, deve ser realizada leitura do arquivo de retorno (conforme o número de tentativas configurado em tela).
O arquivo de retorno referente a Consulta de eventos de Efetivação de Pagamento possui layout definido no Manual NDD.
Ao realizar a leitura do arquivo de retorno referente a Consulta de eventos de Efetivação de Pagamento, deverá ser listado no campo Log da tela de Integração as seguintes informações:
- Empresa: empresa do CTRB/RPA (obtido através da informação do campo numero - grupo 0140, que contém o código do CIOT – campo CdCIOT da tabela FTRCFT)
- CTRB/RPA: número do CTRB/RPA (obtido através da informação do campo numero - grupo 0140, que contém o código do CIOT – campo CdCIOT da tabela FTRCFT)
- Título: número do título. Obtido através da informação do campo nome (grupo 8200). Quando neste campo tiver a informação “Adiantamento”, refere-se ao título com final “01”, gerado para o CTRB/RPA. Quando neste campo tiver a informação “Saldo”, deverá ser verificado se foi gerado um ou dois títulos para o CTRB/RPA. Se tiver sido gerado somente um título, este refere-se ao saldo. Se tiver sido gerado dois títulos, o título com final “02” será o título referente ao saldo.
- Texto Retorno Consulta de Efetivação de Pagamento: concatenado com a informação do campo observação (grupo 1000), pois é nesse campo que consta a mensagem se a liberação de pagamento foi efetuada com sucesso ou não;
- Texto Situação Pagamento: concatenado com a informação do campo status (grupo 8200).
Caso o retorno referente ao arquivo de Consulta de eventos de Efetivação de Pagamento tenha sido processado com sucesso (campo ResponseCode igual a 200) e campo status (grupo 8200) for igual a 3 (Paga), serão gerados os seguintes registros com as seguintes informações:
- Movimentação Financeira:
- Tipo Lançamento: código informado no campo Baixa Total em Banco, guia Outros, pasta Tipos de Lançamentos, Configurações Gerais do módulo Financeiro;
- Data: data atual;
- Valor: valor do saldo do título (seja ele referente a adiantamento ou saldo de CTRB/RPA);
- Portador: portador configurado no Cadastro de Operadoras de Pagamento Eletrônico CTRB/RPA, guia Geração CIOT, guia Geral (conforme operadora informada no CTRB/RPA);
- Empresa: filial do título;
- Centro Custo: centro de custo do rateio do título;
- Observação: Movimentação gerada por Liberação de Pagamento de CTRB/RPA;
- Conta Corrente: conta corrente configurada no Cadastro de Operadoras de Pagamento Eletrônico CTRB/RPA, guia Geração CIOT, guia Geral (conforme operadora informada no CTRB/RPA);
- Sequência CC: próximo número sequencial da conta corrente utilizada.
- Movimentação de Conta Corrente:
- Conta Corrente: conta corrente utilizada no registro de movimentação financeira;
- Sequência: sequencia utilizada no registro de movimentação financeira;
- Histórico: histórico do título;
- Tipo de Movimento: Débito;
- Valor: valor do saldo do título;
- Data Movimento: data atual;
- Vencimento: data atual;
- Conciliação: se conciliação bancária do histórico estiver configurada como “Não Realiza a Conciliação”, a data de conciliação da movimentação será igual a data atual. Se a conciliação do histórico estiver configurada como “Realiza Conciliação”, a data de conciliação ficará em branco;
- Competência: Data atual;
- Complemento: Movimentação gerada por Liberação de Pagamento de CTRB/RPA;
- Cliente/Fornecedor: Fornecedor do título;
- Nº do título: número do título;
- Valor: valor do saldo do título;
- Conta: conta do rateio do título;
- Conta Corrente: conta corrente utilizada no registro de movimentação financeira (conta para a qual está se registrando a movimentação de conta corrente);
- Histórico: histórico utilizado no registro de movimentação financeira;
- Empresa: filial do título;
- Centro de Custo: centro de custo do rateio do título;
- Complemento: Movimentação gerada por Liberação de Pagamento de CTRB/RPA;
- Movimento contábil: se configurado integração on-line nas configurações gerais do módulo CTB.
Quando por alguma falha a leitura do arquivo de retorno não for executada (por exemplo, a NDD não ter gerado arquivo de retorno no diretório dentro do período em que são efetuadas as tentativas de leitura de retorno), será exibido no campo de Log os seguintes textos de acordo com o tipo do arquivo:
- Não foi possível realizar leitura do arquivo de retorno Pagamento Imediato de Parcelas referente ao título X.
- Não foi possível realizar leitura do arquivo de retorno Consulta de eventos de Efetivação de Pagamento referente ao título X.
Quando operadora for Pamcard, deve ser gerado um arquivo para Alterar Status da Parcela e um arquivo de Pagamento de Parcela.
O layout do arquivo Alterar Status da Parcela deve ter o formato definido no manual Sistema Pamcard - Especificação Integração - Contrato de Frete (002). Onde:
- viagem.id.cliente = Código da Empresa + Código do CTRB/RPA
- viagem.contratante.documento.numero = CNPJ do grupo ou da filial emitente do CTRB/RPA;
- viagem.unidade.documento.tipo = conforme descrito no manual, esta informação é obrigatória apenas quando a autenticação for realizada por uma filial. Se a empresa que estará realizando a autenticação for uma contratante, será obrigatório apenas a chave viagem.contratante.documento.numero. Para preenchimento deste campo, utilizar valor 1 (CNPJ);
- viagem.unidade.documento.numero = conforme descrito no manual, esta informação é obrigatória apenas quando a autenticação for realizada por uma filial. Se a empresa que estará realizando a autenticação for uma contratante, será obrigatório apenas a chave viagem.contratante.documento.numero. Para preenchimento deste campo, utilizar informação do CNPJ da filial emitente do CTRB/RPA;
- viagem.parcela.qtde = Neste campo deverá ser informada a quantidade de parcelas que serão alteradas. Como será gerado um arquivo para cada parcela, informar valor 1 nesse campo;
- viagem.parcelaN.status.id = informar valor 2, que corresponde ao status de liberado;
- viagem.parcelaN.numero.cliente = o valor da variável N será de acordo com o número de títulos gerados para a fatura do CTRB/RPA. Logo, o valor poderá variar de 1 a 2. A informação deste campo será o código do título;
- viagem.antt.ciot.numero = Número do CIOT.
Gerar arquivo com a seguinte nomenclatura: “UpdateParcelStatus_” + IniciaComZeros(IntToStr(CdEmpresa), 3) + IniciaComZeros(IntToStr(CdCTRBRPA), 6) + '.txt';
Onde CdEmpresa igual a empresa do CTRB/RPA e CdCTRBRPA é o número do CTRB/RPA. Para cada título será gerado um arquivo no diretório configurado.
Após geração do arquivo Alterar Status da Parcela, deve ser realizada leitura do arquivo de retorno (conforme o número de tentativas configurado em tela).
O arquivo de retorno referente a Alterar Status da Parcela possui layout definido no manual Sistema Pamcard - Especificação Integração - Contrato de Frete (002).
Ao realizar a leitura do arquivo de retorno referente a Alterar Status da Parcela, deverá ser listado no campo Log da tela de Integração as seguintes informações:
- Empresa: empresa do CTRB/RPA. Obtido através da informação do campo viagem.antt.ciot.numero do arquivo de envio;
- CTRB/RPA: Obtido através da informação do campo viagem.antt.ciot.numero do arquivo de envio;
- Título: número do título. Obtido através da informação do campo viagem.parcelaN.numero.cliente do arquivo de envio;
- Texto Retorno Alteração Status da Parcela: concatenado com a informação do campo mensagem.parcelaN.descricao, pois é nesse campo que consta a mensagem se a alteração do status da parcela foi efetuada com sucesso ou não.
Caso após a leitura do arquivo de retorno referente a Alterar Status da Parcela, a alteração do status tenha sido efetuada com sucesso, será enviado arquivo de Pagamento de Parcela.
Será considerada alteração de status efetuada com sucesso quando no arquivo de retorno o campo mensagem.parcelaN.codigo for igual a 0.
O layout do arquivo Pagamento de Parcela deve ter o formato definido no manual Sistema Pamcard - Especificação Integração - Contrato de Frete (002). Onde:
- viagem.id.cliente = Código da Empresa + Código do CTRB/RPA;
- viagem.contratante.documento.numero = CNPJ do grupo ou da filial emitente do CTRB/RPA;
- viagem.unidade.documento.tipo = conforme descrito no manual, esta informação é obrigatória apenas quando a autenticação for realizada por uma filial. Se a empresa que estará realizando a autenticação for uma contratante, será obrigatório apenas a chave viagem.contratante.documento.numero. Para preenchimento deste campo, utilizar valor 1 (CNPJ);
- viagem.unidade.documento.numero = conforme descrito no manual, esta informação é obrigatória apenas quando a autenticação for realizada por uma filial. Se a empresa que estará realizando a autenticação for uma contratante, será obrigatório apenas a chave viagem.contratante.documento.numero. Para preenchimento deste campo, utilizar informação do CNPJ da filial emitente do CTRB/RPA;
- viagem.parcela.qtde = Neste campo deverá ser informada a quantidade de parcelas que serão alteradas. Como será gerado um arquivo para cada parcela, informar valor 1 nesse campo;
- viagem.parcelaN.numero.cliente = o valor da variável N será de acordo com o número de títulos gerados para a fatura do CTRB/RPA. Logo, o valor poderá variar de 1 a 2. A informação deste campo será o código do título;
- viagem.antt.ciot.numero = Número do CIOT.
Gerar arquivo com a seguinte nomenclatura: “PayParcel_” + IniciaComZeros(IntToStr(CdEmpresa), 3) + IniciaComZeros(IntToStr(CdCTRBRPA), 6) + '.txt';
Onde CdEmpresa igual a empresa do CTRB/RPA e CdCTRBRPA é o número do CTRB/RPA. Para cada título será gerado um arquivo no diretório configurado.
Após geração do arquivo Pagamento de Parcela, deve ser realizada leitura do arquivo de retorno.
O arquivo de retorno referente a Pagamento de Parcela possui layout definido no manual Sistema Pamcard - Especificação Integração - Contrato de Frete (002).
Ao realizar a leitura do arquivo de retorno referente a Pagamento de Parcela, deverá ser listado no campo Log da tela de Integração as seguintes informações:
- Empresa: empresa do CTRB/RPA. Obtido através da informação do campo viagem.antt.ciot.numero do arquivo de envio;
- CTRB/RPA: Obtido através da informação do campo viagem.antt.ciot.numero do arquivo de envio;
- Título: número do título. Obtido através da informação do campo viagem.parcelaN.numero.cliente do arquivo de envio;
- Texto Retorno do Pagamento de Parcela: concatenado com a informação do campo descrição da parcela, pois é nesse campo que consta a mensagem se o pagamento da parcela foi efetuada com sucesso ou não.
Caso o retorno referente ao arquivo Pagamento de Parcela tenha sido processado com sucesso (campo igual a 0), serão gerados os seguintes registros com as seguintes informações:
- Movimentação Financeira:
- Tipo Lançamento: código informado no campo Baixa Total em Banco, guia Outros, pasta Tipos de Lançamentos, Configurações Gerais do módulo Financeiro;
- Data: data atual;
- Valor: valor do saldo do título (seja ele referente a adiantamento ou saldo de CTRB/RPA);
- Portador: portador configurado no Cadastro de Operadoras de Pagamento Eletrônico CTRB/RPA, guia Geração CIOT, guia Geral (conforme operadora informada no CTRB/RPA);
- Empresa: filial do título;
- Centro Custo: centro de custo do rateio do título;
- Observação: Movimentação gerada por Liberação de Pagamento de CTRB/RPA;
- Conta Corrente: conta corrente configurada no Cadastro de Operadoras de Pagamento Eletrônico CTRB/RPA, guia Geração CIOT, guia Geral (conforme operadora informada no CTRB/RPA);
- Sequência CC: próximo número sequencial da conta corrente utilizada.
- Movimentação de Conta Corrente:
- Conta Corrente: conta corrente utilizada no registro de movimentação financeira;
- Sequência: sequencia utilizada no registro de movimentação financeira;
- Histórico: histórico do título;
- Tipo de Movimento: Débito;
- Valor: valor do saldo do título;
- Data Movimento: data atual;
- Vencimento: data atual;
- Conciliação: se conciliação bancária do histórico estiver configurada como “Não Realiza a Conciliação”, a data de conciliação da movimentação será igual a data atual. Se a conciliação do histórico estiver configurada como “Realiza Conciliação”, a data de conciliação ficará em branco;
- Competência: Data atual;
- Complemento: Movimentação gerada por Liberação de Pagamento de CTRB/RPA;
- Cliente/Fornecedor: Fornecedor do título;
- Nº do título: número do título;
- Valor: valor do saldo do título;
- Conta: conta do rateio do título;
- Conta Corrente: conta corrente utilizada no registro de movimentação financeira (conta para a qual está se registrando a movimentação de conta corrente);
- Histórico: histórico utilizado no registro de movimentação financeira;
- Empresa: filial do título;
- Centro de Custo: centro de custo do rateio do título;
- Complemento: Movimentação gerada por Liberação de Pagamento de CTRB/RPA;
- Movimento contábil: se configurado integração on-line nas configurações gerais do módulo CTB.
Quando por alguma falha a leitura do arquivo de retorno não for executada (por exemplo, a Pamcary não ter gerado arquivo de retorno no diretório dentro do período em que são efetuadas as tentativas de leitura de retorno), será exibido no campo de Log os seguintes textos de acordo com o tipo do arquivo:
- Não foi possível realizar leitura do arquivo de retorno Alterar Status da Parcela referente ao título X.
- Não foi possível realizar leitura do arquivo de retorno Pagamento de Parcela referente ao título X.