Nesta integração com o Gestão de Receita Recorrente, os títulos associados as faturas da plataforma serão cobrados pelo TOTVS Pagamentos e na plataforma é possível acompanhar todo o processo financeiro, previsão de recebimento e conciliação financeira dos recebíveis, tudo de forma automatizada.
Pré-requisitos
Pacote acumulado de expedição contínua do financeiro atualizado, á partir de 12/2023.
Para controle dos recebíveis recorrentes, são utilizadas as tabelas a seguir:
Tabela | Descrição |
HRF | Controle de mensagens do GRR |
HRI | Ordem de Pagamento GRR |
Tabela | Ordem | Campo | Tipo | Tamanho | Decimal | Título |
HRF | 1 | HRF_FILIAL | C | 8 | 0 | Filial |
HRF | 2 | HRF_CODE | C | 10 | 0 | Código |
HRF | 3 | HRF_TYPE | C | 1 | 0 | Tipo |
HRF | 4 | HRF_SOURCE | C | 30 | 0 | Rotina |
HRF | 5 | HRF_TRANID | C | 36 | 0 | Transação |
HRF | 6 | HRF_MESSAG | C | 30 | 0 | Mensagem |
HRF | 7 | HRF_DATA | M | 10 | 0 | Dados da Msg |
HRF | 8 | HRF_ENTITY | C | 3 | 0 | Entidade |
HRF | 9 | HRF_UNQKEY | C | 50 | 0 | Chave Única |
HRF | 10 | HRF_STATUS | C | 1 | 0 | Status |
HRF | 11 | HRF_STARDT | D | 8 | 0 | Dt. Início |
HRF | 12 | HRF_STARHR | C | 8 | 0 | Hr. Início |
HRF | 13 | HRF_FINADT | D | 8 | 0 | Dt. Final |
HRF | 14 | HRF_FINAHR | C | 8 | 0 | Hr. Final |
HRF | 15 | HRF_OBSERV | M | 10 | 0 | Observação |
Tabela | Ordem | Campo | Tipo | Tamanho | Decimal | Título |
HRI | 1 | HRI_FILIAL | C | 8 | 0 | Cód Filial |
HRI | 2 | HRI_SRCFIL | C | 8 | 0 | Filial Orig. |
HRI | 3 | HRI_ALIAS | C | 8 | 0 | Alias |
HRI | 4 | HRI_SOURCE | C | 30 | 0 | Origem |
HRI | 5 | HRI_REQCD | C | 40 | 0 | Cod. Solicit |
HRI | 6 | HRI_CHARID | C | 36 | 0 | ID Charge |
HRI | 7 | HRI_BILLID | C | 36 | 0 | ID Bill |
HRI | 8 | HRI_CUSIID | C | 36 | 0 | Cust Int ID |
HRI | 9 | HRI_BOLETO | C | 250 | 0 | Boleto |
HRI | 10 | HRI_STATUS | C | 1 | 0 | Status |
HRI | 11 | HRI_VALOR | N | 14 | 2 | Valor |
HRI | 12 | HRI_VENCTO | D | 8 | 0 | Vencimento |
HRI | 13 | HRI_PAYMET | C | 1 | 0 | Met de Pagto |
Quando selecionado o provedor Protheus na plataforma GRR, é necessário que o ERP possua toda a configuração bancária cadastrada, para geração de borderô e RdMake de geração do documento de cobrança (boleto). O documento gerado pelo RdMake deve ser associado a fatura do GRR. Segue exemplo abaixo:
//Exemplo de implementação da função de envio de documento para o GRR //Função para resgatar os documentos vinculados a NF Static Function GetAnexo(cNF) Local aAnexos := {} Local aBol := {} Local i := 0 Local cUrlGRR := GRRGetUrlBankSlip() // Busca arquivo PDF da nota fiscal If File(cDirNFSE+"\NF_"+cNF+".pdf") // Se arquivo de NF existe // Copia para servidor CpyT2S(cDirNFSE+"\NF_"+cNF+".pdf",cDirSrv) // Copia da NF para pasta do GRR CpyT2S(cDirNFSE+"\NF_"+cNF+".pdf",cUrlGRR) If File(cDirSrv+"\NF_"+cNF+".pdf") aAdd(aAnexos,cDirSrv+"\NF_"+cNF+".pdf") lNf := .T. Endif Endif // Verifica os arquivos do diretório aBol := Directory(cDirBol+"\BOL_"+cNF+"*.PDF") For i := 1 To Len(aBol) If "BOL_"+cNF $ aBol[i][1] // Se nome de arquivo contém número de NF // Busca arquivo PDF do boleto If File(cDirBol+"\"+aBol[i][1]) // Se arquivo de NF existe // Copia para servidor CpyT2S(cDirBol+"\"+aBol[i][1],cDirSrv) // Copia para servidor CpyT2S(cDirBol+"\"+aBol[i][1],cUrlGRR) If File(cDirSrv+"\"+aBol[i][1]) aAdd(aAnexos,cDirSrv+"\"+aBol[i][1]) lBol := .T. Endif Endif Endif Next Return aAnexos //Pega o caminho do boleto Local cUrlGRR := GRRGetUrlBankSlip() // Copia da NF para pasta do GRR CpyT2S(cDirNFSE+"\NF_"+cNF+".pdf",cUrlGRR)
Gravação do documento
Caso ocorra erro na gravação do documento, verificar as permissões da pasta pai para a conta de serviço do produto.
A criação/atualização dos títulos é feita através da execução da rotina:
Faturas Pagas (GRRI060)
A conciliação é feita através da execução da rotina:
Conciliação Bancária (GRRI070)
Provedor Protheus
Quando a integração utiliza o Protheus como provedor de pagamentos, é necessário realizar o processo de envio e recepção do arquivo de retorno da instituição bancária configurada.
Em um processo de geração de título customizado ou provisionado diretamente pelo módulo consumidor, é necessário associar manualmente para que a plataforma faça a atualização necessária com relação ao pagamento e conciliação financeira.
//Associar título provisionado pelo módulo PLS com a subscrição GRR //Parâmetros: Tabela, Campo, Rotina de origem GRRSetHRHInfo( 'BBT', BBT->BBT_NUMTIT, "PLSA627" )
Saiba Mais
Saiba mais em: TOTVS Gestão de Receita Recorrente
Saiba mais sobre a integração em: Módulo de Financeiro (SIGAFIN)
Saiba mais sobre boleto: Backoffice Linha Protheus - SIGAFIN - Boletos no Protheus