ReferênciaFinanceiro

Contas a receber

Parcelas do crediário da loja (boleto, carnê) no período. Pagamentos em dinheiro, PIX ou cartão não geram parcelas e constam nos lançamentos de caixa e no extrato.

GET
/integracoes/financeiro/contas-a-receber/periodo

Authorization

userToken
AuthorizationBearer <token>

Chave de acesso que aparece no cadastro do usuário, no ssOtica. Envie como Authorization: Bearer {chave}.

In: header

Query Parameters

cnpj?string

CNPJ (ou CPF) da loja, com ou sem máscara. Informe cnpj ou empresa.

empresa?string

Código da Licença da loja (chave de contrato). Informe cnpj ou empresa.

inicio_periodo*string

Data inicial, no formato AAAA-MM-DD. O intervalo até fim_periodo pode ter no máximo 180 dias (ex.: 2025-07-01 a 2025-12-28 é aceito; 2025-07-01 a 2025-12-31, com 183 dias, é recusado).

fim_periodo*string

Data final, no formato AAAA-MM-DD. O dia informado é considerado por completo. Deve estar a no máximo 180 dias de inicio_periodo.

tipo_periodo?string

Data da parcela utilizada no filtro: vencimento (padrão), vencimento da parcela; pagamento, data do pagamento; lancamento, data em que o título foi registrado; cancelamento, data do cancelamento; renegociacao, data da renegociação. Outros valores retornam erro 400. Para comparação com a consulta de vendas, utilize lancamento nesta consulta e dataLancamento nas vendas.

id?integer

ID da parcela. Quando informado, retorna somente essa parcela, e o período, o tipo_periodo e o numero_documento deixam de ser aplicados como filtro. Ainda assim, inicio_periodo e fim_periodo permanecem obrigatórios e são validados (na ausência deles, retorna PERIODO_OBRIGATORIO).

numero_documento?string

Número do documento do título (ex.: número do carnê ou do boleto). Desconsiderado quando id é informado.

page?integer

Número da página, a partir de 1 (padrão 1). As páginas devem ser consultadas até o valor de totalPages informado na resposta.

perPage?integer

Itens por página, de 1 a 100 (padrão 10; recomenda-se perPage=100). O nome deve ser escrito exatamente como perPage; outras grafias, como per_page, são desconsideradas sem aviso.

Response Body

application/json

application/json

text/html

curl -X GET "https://example.com/integracoes/financeiro/contas-a-receber/periodo?inicio_periodo=2026-06-01&fim_periodo=2026-06-30"
{  "currentPage": 1,  "totalPages": 1,  "totalItems": 1,  "perPage": 100,  "data": [    {      "id": 15,      "numero_parcela": 1,      "vencimento": "2022-05-13",      "forma_pagamento": "Carnê",      "situacao": "Pago",      "valor_original": 51.8,      "juros": 0,      "multa": 0,      "desconto": 0,      "valor_reajustado": 51.8,      "valor_pago": 51.8,      "baixado_por": "Ana Caixa",      "baixado_em": "2023-11-14 12:22",      "estornado_por": null,      "estornado_em": null,      "motivo_estorno": null,      "cancelado_por": null,      "cancelado_em": null,      "motivo_cancelamento": null,      "titulo": {        "id": 3,        "numero_documento": "85",        "descricao": "Venda Crediário",        "qtd_parcelas": 10,        "cliente": {          "id": 2799763,          "nome": "Carlos Oliveira",          "documento": "123.456.789-09",          "rg": null,          "telefone_principal": "(11) 9999-9000",          "email_principal": null        },        "plano_conta": "Recebimento Crediário",        "tipo_documento": "Carnê",        "forma_pagamento": "Carnê",        "venda": {          "id": 217,          "numero_venda": 85,          "funcionario": "Maria Operadora",          "data": "12/04/2022"        }      },      "boleto": [],      "renegociacao": [],      "dependente": null    }  ]}

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

"Unauthorized."