01. VISÃO GERAL
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 pelo produto Conta Digital.
O atributo type indica o evento a ser executado no ERP.
O job FWTOTVSLINKJOB identifica uma nova mensagem e faz a chamada à classe ReconciliationMessageMessageReader (FINA477), responsável pela inclusão dos registros de conciliação nas tabelas SIF e SIG.
{ "specversion": "1.0", "time": "2024-01-03T03:00:00.4432653Z", "id": "9dfe239b-3932-4969-a4d6-9a63f8c1641e", "tenantId": "%Exp:cTenantId%", "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": { "tenantId": "78229ab2-2ca5-4161-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 } ] } }
05. TABELAS UTILIZADAS
SIF - Cabeçalho Imp.Extrato Bancario
SIG - Itens Import Extrato Bancário