Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

01. VISÃO GERAL

Os movimentos de Boletos e Pix movimentados no TOTVS Conta Digital são disponibilizados para integração com o Protheus.

...

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

O job FwTotvsLinkJob é o responsável pela leitura das mensagens recebidas na fila do SmartLink e deve ser configurado no Schedule.

...

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
languagejs
titleExemplo de Mensagem de Movimento de Conciliação
{
    	"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

...