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.

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

Primitivas para atualizar extrato e atualizar saldo

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