ReferênciaFinanceiro

Extrato financeiro (lançamentos de conta)

Movimentações bancárias (lançamentos de conta) no período, filtradas pela **data de crédito**. Paginação opt-in (`page`/`perPage`). Intervalo máximo de 180 dias.

GET
/integracoes/financeiro/extrato/periodo

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.

inicio_periodo*string

Início do período (YYYY-MM-DD).

fim_periodo*string

Fim do período (YYYY-MM-DD).

page?integer

Página.

perPage?integer

Itens por página, 1–100 (nos endpoints de período, ativa a paginação).

callback?string

Se presente, a resposta é retornada como JSONP.

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/integracoes/financeiro/extrato/periodo?inicio_periodo=2026-06-01&fim_periodo=2026-06-30"
[  {    "id": 12345,    "data_operacao": "2026-01-15",    "data_credito": "2026-01-15",    "valor": 250,    "tipo": "CREDITO",    "descricao": "Recebimento venda 1001",    "numero_documento": "venda 1001",    "forma_recebimento": {},    "conta": {},    "categoria": {},    "cliente": {},    "venda": {},    "fornecedor": {}  }]

{  "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."}

Saldos das contas GET

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**.

Lançamentos de caixa GET

Lançamentos de caixa do período, filtrados pela **data de lançamento do caixa**. Paginação opt-in (`page`/`perPage`). Intervalo máximo de 180 dias.