Gestão de caixa

Listagem por Banco

A listagem por banco exibe as seguintes informações:

Banco: Nome do banco.
Valor disponível: Saldo disponível para movimentação.
Valor bloqueado: Saldo que está bloqueado ou não disponível para movimentação.

Ao expandir a grid, é exibida uma sublistagem com as seguintes colunas:

Agência: Número da agência bancária.
Conta: Número da conta bancária.
Valor disponível: Saldo disponível por conta.
Valor bloqueado: Saldo bloqueado por conta.

Listagem de valor Consolidado diário

Esta listagem mostra o saldo consolidado diário das movimentações, com as seguintes colunas:

Data: Data da movimentação.
Saldo: Saldo consolidado para o dia.

Ao expandir a grid, a sublistagem inclui:

Operação: Tipo de operação realizada.
Descrição: Descrição da movimentação.
Banco: Banco relacionado à movimentação.
Agência: Número da agência bancária relacionada.
Conta: Número da conta bancária envolvida.
Movimentação: Valor da movimentação.

Listagem das Movimentações

A listagem de movimentações das contas bancárias exibe 7 colunas:

Data: Data da movimentação.
Operação: Tipo da operação.
Descrição: Descrição da operação.
Banco: Banco associado à operação.
Agência: Número da agência bancária.
Conta: Número da conta bancária.
Movimentação: Valor da movimentação.

Arquivo

O que fazer:

Nesta etapa você envia o arquivo OFX para o sistema.

Na área de Arrastar e soltar, arraste o arquivo .ofx ou clique para selecioná-lo do seu computador;
O arquivo é enviado para análise;
O sistema faz a leitura do arquivo, identifica as contas e movimentações, e apresenta um resumo por conta;
Clique em Próximo para seguir para a etapa Resumo.

Importante

Apenas arquivos no formato OFX com extensão .ofx são aceitos. Se o arquivo vier de um banco que ainda usa OFX 1.x (SGML), será necessário convertê-lo para o padrão XML (OFX 2.x).

Resumo

O que aparece:

Uma tabela com as contas identificadas no arquivo, mostrando:

Banco, Agência, Número: identificação da conta
Tipo: tipo de conta (Conta Corrente, Poupança, etc.)
Período: data inicial e final do extrato
Movimentações: quantidade de lançamentos
Total de Créditos e Débitos: soma dos valores

O que fazer:

Para cada conta listada, você deve informar qual filial (CNPJ) ela pertence. Isso associa a conta ao seu CNPJ para que os lançamentos sejam registrados corretamente no ERP.

Clique no campo Filial de cada conta;
Selecione a filial correspondente na lista;
Se a conta já teve uma importação anterior concluída com sucesso, o campo de filial não é solicitado - a filial já está vinculada;

Atenção: contas sem filial vinculada serão ignoradas na importação definitiva. Se você pular esta etapa para alguma conta, ela não será importada.

Após informar a filial de todas as contas, clique em Próximo para seguir para a Saldo Inicial.

Saldo Inicial

Quando aparece:

Esta etapa aparece apenas para contas sem histórico prévio no ERP Banking, ou seja, contas novas que estão sendo importadas pela primeira vez.

Atenção: se a conta já existe no ERP Banking (de importações anteriores ou do Open Finance), o saldo inicial informado nessa etapa não substituirá o saldo existente.

Nesse caso, a importação somará o líquido do arquivo sobre o saldo já registrado.

O que fazer:

Para cada conta nova, você informa o saldo inicial e a data de referência (data-base). Esses valores são a âncora para o cálculo do saldo acumulado.

Preencha o Saldo Inicial com o saldo da conta no dia da data de referência;
Preencha a Data de Referência com a mesma data da primeira movimentação do arquivo ou a data em que você deseja começar o histórico.

Importante: a data de referência não pode ser uma data futura. Ela deve ser igual ou anterior à data do primeiro lançamento do arquivo.

Após preencher todas as contas, clique em Próximo para seguir para a etapa Conferência.

Conferência

O que aparece:

Uma listagem das movimentações agrupadas por conta, mostrando:

Data, Operação: data e tipo do lançamento (crédito ou débito)
Valor, Descrição: montante e detalhamento do lançamento
Saldo Acumulado: evolução do saldo após cada movimentação

O que você pode fazer:

Nesta etapa você pode excluir lançamentos que não devem ser importados e incluir lançamentos manuais que não constam do arquivo.

Para excluir um lançamento:

Localize o lançamento na tabela;
Clique no ícone de exclusão na linha do lançamento;
O lançamento é removido da listagem e não será importado.

Para incluir um lançamento manual:

Clique no botão Incluir Lançamento Manual.
Preencha:
- Conta: selecione a conta bancária
- Data: data do lançamento
- Operação: crédito (entrada) ou débito (saída)
- Valor: montante (deve ser maior que zero)
- Descrição: detalhamento do lançamento (máximo 255 caracteres)
Clique em Salvar;
O lançamento é adicionado à listagem.

Observação: todas as movimentações (do arquivo e manuais) são exibidas em ordem cronológica e participam do cálculo do saldo acumulado.

Após revisar e ajustar as movimentações, clique em Próximo para seguir para a etapa Importação.

Importação

O que acontece:

Ao confirmar nesta etapa, o sistema:

Valida todos os dados (contas, movimentações, saldos iniciais);
Grava as movimentações nas tabelas de extrato do ERP Banking;
Atualiza o saldo de cada conta;
Envia as movimentações para o ERP automaticamente;
Exibe o status de processamento com contadores de sucesso.

O que fazer:

Clique em Confirmar Importação Definitiva;
O sistema inicia o processamento;
Uma barra de progresso mostra o andamento;
Após a conclusão, uma mensagem é exibida confirmando o sucesso ou alertando sobre possíveis erros.

Visualizar o histórico de importações

Dentro da guia Importação de Extratos, clique em Histórico de Importações ou role para baixo.
Uma lista mostra todas as importações já realizadas, com data, arquivo, status e contadores.

Se uma importação ficar em erro

Localize a importação na lista;
Verifique a mensagem de erro exibida;
Clique no botão Reenviar ao ERP;
O sistema republica as movimentações para o seu ERP.

Importante

A ação de Reenviar, republica todas as movimentações da importação, não apenas as que falharam.

Isso garante a consistência, mas cuidado com possíveis duplicações.

Após a Importação Definitiva

Uma vez que a importação é concluída e as movimentações são enviadas ao ERP:

Os lançamentos aparecem nas guias Movimentações, Consolidado Diário e Banco da Gestão de Caixa.
O saldo das contas é atualizado e pode ser consultado em Saldo por Conta.
Os dados são tratados como qualquer outra movimentação do ERP Banking, sem diferenciação visual de que vieram de arquivo OFX.

atualizarExtrato

A primitiva atualizarExtrato é responsável por processar a atualização do extrato no BTG. Quando essa primitiva é executada, o evento statementUpdated é disparado, enviando as informações do extrato atualizado para o ERP.

"API responsável por atualizar o extrato de acordo com as movimentações financeiras da conta"
        action atualizarExtrato {
            in movimentoConta
            out {}
        }
        
        "Evento público responsável por informar a atualização do extrato de acordo com as movimentações financeiras da conta"
        public event statementUpdated {
        	payload accountMovement
        }

        "Dados da movimentação"
        record movimentoConta {
        	"Id do webhook"
                 webhookId: string?
                "Evento publicado"
                ^event: string?
        	"Detalhes da movimentação"
        	data: detalhesMovimentacao
        }

        "Dados da movimentação"
        record accountMovement {
            "Dados da conta"
            account: recAccount
            "Data da movimentação"
            movementDate: dateTime
            "Indica se é crédito ou débito"
            creditDebitIndicator: enumCreditDebitIndicator
            "Valor da movimentação"
            amount: money
            "Moeda"
            currency: string
            "Número do documento"
            documentNumber: string?
            "Tipo de pagamento/cobrança"
            movementType: enumMovementType?
            "Razão"
            reason: string?
            "Dados da parte relacionada"
            relatedParty: recRelatedParty?
            "Dados de transação"
            transaction: recTransaction?
            "Descrição"
            description: string?
            "Código de ocorrência"
            febrabanCode: string?
        }

        "Dados da parte relacionada"
        record recRelatedParty {
            "Número do documento"
            taxId : string?
            "Código do banco"
            bankCode : string?
            "Nome"
            name : string?
            "Moeda"
            currency : string?
            "Agência"
            branchCode : string?
            "Número da conta"
            number : string?
        }

        "Dados de transação"
        record recTransaction {
        	"Id da transação"
        	txId : string?
        	"Id da transação pix"
        	endToEndId : string?
        	"Código de barras"
        	barCode : string?
        	"Nosso número"
        	ourNumber : string?
        }

CURL de exemplo da chamada da primitiva atualizarExtrato

curl --location 'https://cloud-leaf.senior.com.br/t/senior.com.br/bridge/1.0/rest/erpx_bnk_tes/contas/actions/atualizarExtrato' \
--header 'authority: cloud-leaf.senior.com.br' \
--header 'accept: application/json, text/plain, */*' \
--header 'accept-language: en-US,en;q=0.9' \
--header 'content-type: application/json' \
--header 'cookie: _ga=GA1.4.587465384.1711023471; _gid=GA1.4.412339593.1711023471; com.senior.domain=.senior.com.br; com.senior.services.url=https%3A%2F%2Fcloud-leaf.senior.com.br%2Ft%2Fsenior.com.br%2Fbridge%2F1.0%2F; com.senior.x.services.url=https%3A%2F%2Fcloud-leaf.senior.com.br%2Ft%2Fsenior-x%2F; com.senior.token=%7B%22version%22%3A1%2C%22scope%22%3A%22desktop+device_90e3e115-5d54-4415-9305-4c6a1560faa4%22%2C%22expires_in%22%3A21600%2C%22username%22%3A%22admin%40matheusw.com.br%22%2C%22token_type%22%3A%22bearer%22%2C%22access_token%22%3A%22Ag6g66Mc8GaITaIwz6C0MtkHbx86rEyO%22%2C%22refresh_token%22%3A%227LMsPHVVgW4YA7PxGJ7gh0zlDP1fjRMc%22%2C%22type%22%3A%22internal%22%2C%22email%22%3A%22matheus.werner%40senior.com.br%22%2C%22fullName%22%3A%22admin+matheusw%22%2C%22tenantName%22%3A%22matheusw%22%2C%22locale%22%3A%22pt-BR%22%7D; com.senior.base.url=https%3A%2F%2Fcloud-leaf.senior.com.br; com.senior.portal.url=https%3A%2F%2Fcloud-leaf.senior.com.br%2Ftecnologia%2Fplatform%2Fsenior-x%2F; _gid=GA1.3.412339593.1711023471; _hjSessionUser_3478075=eyJpZCI6IjUyYzJhYTBlLTFiOGQtNTU5Ny05ZjZlLWM5YTJmNTFkOTU1ZiIsImNyZWF0ZWQiOjE3MTEwMjM0ODcwNTgsImV4aXN0aW5nIjpmYWxzZX0=; _hjSession_3478075=eyJpZCI6ImY2Y2YwNThmLWYzZTAtNGJjZS05ZWMyLWEyYTk0N2U2Yjc3MCIsImMiOjE3MTEwMjM0ODcwNTksInMiOjAsInIiOjAsInNiIjowLCJzciI6MCwic2UiOjAsImZzIjoxLCJzcCI6MH0=; _ga=GA1.1.587465384.1711023471; _ga_97FJ1SLB15=GS1.1.1711023471.1.1.1711023541.50.0.0; _ga_1400JXY1D1=GS1.1.1711023471.1.1.1711023541.0.0.0; _ga_3761W091CF=GS1.1.1711023536.1.1.1711023553.0.0.0' \
--header 'origin: https://cloud-leaf.senior.com.br' \
--header 'referer: https://cloud-leaf.senior.com.br/gestao-empresarial/erpx_bnk_cob/pix/cobranca-item-pix' \
--header 'sec-ch-ua: "Chromium";v="122", "Not(A:Brand";v="24", "Google Chrome";v="122"' \
--header 'sec-ch-ua-mobile: ?0' \
--header 'sec-ch-ua-platform: "Windows"' \
--header 'sec-fetch-dest: empty' \
--header 'sec-fetch-mode: cors' \
--header 'sec-fetch-site: same-origin' \
--header 'user-agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36' \
--header 'trusted: true' \
--header 'Authorization: Bearer DLQ4NIQ68dP4Dy4tRF4tj73OTQnYLszp' \
--data '{
    "webhookId": "156d4fds5f48d7sf98sd7f8",
    "event": "update-atualizarextrato",
    "data": {
        "accountId": "72936e01-208-1122-94321",
        "date": "2025-04-04T00:00:00.000Z",
        "creditDebitIndicator": "DEBIT",
        "amount": "80",
        "currency": "BRL",
        "transactionId": "112233445566",
        "type": "BOLETO",
        "reason": "Comprado Pen Drive 64gb",
        "relatedParty": {
            "taxId": "f698fd2e-60f4-43d1-b84b-8e841521194b",
            "bankCode": "208",
            "name": "BTG_PACTUAL",
            "currency": "BRL",
            "branchCode": "1",
            "number": "1"
        },
        "payload": {
            "txId": "96344a39-18b8-4de9-8ebb-1228ec23c42c",
            "endToEndId": "123456",
            "barCode": "545456412122123100002154511564651005181987891205618940",
            "ourNumber": "12345"
        },
        "description": "Pen Drive 64gb",
        "febrabanCode": "189015"
    }
}

atualizarSaldo

A primitiva atualizarSaldo é responsável por processar a atualização do saldo ocorrido no BTG.

 "API responsável por atualizar o saldo da conta"
        action atualizarSaldo {
            in accountBalance
            out {}
        }

        "Dados da movimentação"
        record accountBalance {
            "Id do evento"
            eventId: string?
            "Id dos metadados"
            metadataId: string?
            "Id do tenant"
            tenantId : string?
            "Dados do saldo da conta"
            message: recMessage
        }

        "Dados do saldo da conta"
        record recMessage {
        	"Id da conta"
        	accountId : string
        	"Cóigo do banco"
        	bankCode : string
        	"Documento CNPJ/CPF"
        	taxId : string
        	"Agência"
        	branchCode : string
        	"Número da conta"
        	number : string
        	"Data/hora da atualização do saldo"
        	timestamp : string
        	"Dados do valor disponível"
        	available: recAvailable
        }

CURL de exemplo da chamada da primitiva atualizarSaldo

curl --location 'https://cloud-leaf.senior.com.br/t/senior.com.br/bridge/1.0/rest/erpx_bnk_tes/contas/actions/atualizarSaldo' \

--header 'Authorization: bearer xHERh31Dy8jUFOqO4nwmV7Y2gxxdGw2X' \

--header 'Content-Type: application/json' \

--data '{

    "eventId": "32946124-4ddb-4f62-9554-4ab75352940a",

    "message": {

        "accountId": "32946124-4ddb-4f62-9554-4ab75352940a",

        "bankCode": "CITIBANK",

        "branchCode": "4",

        "number": "234436784",

        "available": {

            "amount": "7000"

        }

    }

}'

Gestão de caixa

Processo de Autorização (Consentimento) com o Banco BTG

Listagens de Saldos e Movimentações

Filtros de Período

Importação de Extratos

Primitivas para atualizar extrato e atualizar saldo

PORTAL DE DOCUMENTAÇÃO
Gestão Empresarial \| ERP senior X