Histórico da Página
01. VISÃO GERAL
Os movimentos de Boletos e Pix movimentados no TOTVS Conta Digital são disponibilizados para integração com o Protheus.
O envio de dados é realizado via SmartLink utilizando o Padrão CloudEvents para envio de mensagens no formato Json.
O job FwTotvsLinkJob é o responsável pela leitura das mensagens recebidas na fila do SmartLink e deve ser configurado no Schedule.
...
Rotina responsável por trazer do produto Conta Digital os movimentos financeiros do contas a pagar e receber que estão com o status de pago, para a realização de conciliação financeira no Protheus.
02. CONFIGURAÇÃO
Para a utilização da funcionalidade de recebimento dos movimentos do produto Conta Digital é necessário:
- Realizar a configuração do SmartLink.
- Cadastrar um agendamento da rotina FWTOTVSLINKJOB no Schedule (CFGA010) do módulo Configurador.
03. PROCESSAMENTO
Na execução da rotina FINA477 (Recebimento de Mensagens de Conciliação) o Protheus receberá as movimentações do produto Conta Digital e fará a gravação dos registros nas tabelas SIF (Cabeçalho Imp.Extrato Bancario) e SIG (Itens Import Extrato Bancário).
Ao gravar cada registro será enviado para o produto Conta Digital uma notificação de que o movimento foi recebido pelo Protheus.
Para mais detalhes sobre a gravação dos status na tabela SIG, ver a documentação da rotina FINA476 (Job de Atualização e Envio de Status da Conciliação).
04. DADOS TÉCNICOS DA INTEGRAÇÃO
Abaixo temos o modelo de mensagem enviada pela pelo produto Conta Digital.
O atributo type indica o evento a ser executado no ERP.
O job FWTotvsLinkJob FWTOTVSLINKJOB identifica uma nova mensagem e faz a chamada a à classe ReconciliationMessageMessageReader (FINA477), responsável pela inclusão dos registros de conciliação nas tabelas SIF e SIG.
Bloco de código | ||||
---|---|---|---|---|
| ||||
{ "specversion": "1.0", "time": "2024-01-03T03:00:00.4432653Z", "id": "9dfe239b-3932-4969-a4d6-9a63f8c1641e", "tenantId": "78229ab2-2ca5-4161-a20e-6842bc3f1db2%Exp:cTenantId%", "transactionid "transactionId": "TESTE_CONTA_DIGITAL_20240103_001", "type": "ReconciliationMessage", "source": "techfin-conta-digital", "datacontenttype": "application/json", "locale": "pt-BR", "correlationid": "87b190c3-dcde-4e12-96fe-c78fe19e15f5", "data": { "id "tenantId": "9dfe239b78229ab2-39322ca5-49694161-a4d6-9a63f8c1641e", "tenantId": "78229ab2-2ca5-4161-a20e-6842bc3f1db2", a20e-6842bc3f1db2", "bank": "TCD", "branch": "TCD", "accountNumber": "TCD", "checkDigit": "", "tenantCNPJ": "12123456000199", "items": [ { "id": "9dfe239b-3932-4969-a4d6-9a63f8c1641e", "transactionId": "TESTE_CONTA_DIGITAL_20240103_001", "description": "MOVIMENTO EXTRATO", "movementDate": "2024-01-03T03:00:00+00:00", "operationAmount": 123456.78, "operationType": 1, "movementType": 1, "bank": "TCD", "branch": "TCD", "accountNumber": "TCD", "checkDigit": "", "tenantCNPJ": "12123456000199" } ] } } |
...
05. TABELAS UTILIZADAS
SIF - Cabeçalho Imp.Extrato Bancario
...