Saldos das contas

Retorna o saldo de cada conta financeira **ativa** da empresa em uma data de referência, mais o saldo total consolidado. Resposta **não paginada**.

Authorization

userToken

AuthorizationBearer <token>

Token de usuário do ssOtica, obtido na tela de perfil do sistema. Enviado como Authorization: Bearer {token}.

In: header

Query Parameters

cnpj?string

CNPJ/CPF da empresa (com ou sem máscara). Informe cnpj e/ou empresa.

empresa?string

Chave de contrato da empresa. Informe cnpj e/ou empresa.

data?string

Data de referência do saldo (YYYY-MM-DD). Padrão: hoje.

callback?string

Se presente, a resposta é retornada como JSONP.

Response Body

`application/json`

curl -X GET "https://example.com/integracoes/financeiro/saldos"

{  "data_referencia": "2026-06-17",  "saldo_total": 15430.75,  "contas": [    {      "id": 1,      "descricao": "Caixa Loja",      "saldo": 1200.5    },    {      "id": 2,      "descricao": "Conta Corrente BB",      "saldo": 14230.25    }  ]}

{  "error": "DATA_INVALIDA",  "error_info": "O campo \"inicio_periodo\" contém uma data inválida. Utilize o formato AAAA-MM-DD (ex.: 2026-06-30)."}

{  "error": "Unauthenticated."}

Authorization

Query Parameters

Response Body

200application/json

400application/json

401application/json

Example data_invalida

Example periodo_invalido

Example empresa

Example parametro

`application/json`

`application/json`

`application/json`