Lançamentos Futuros
Esta rota retorna uma visão consolidada dos valores de recebíveis futuros, agrupados por datas e períodos (7, 15, 30 dias e meses), permitindo ao parceiro projetar o fluxo de caixa com base nos lançamentos já previstos no sistema Paytime.
Obs: A palavra urlServidor deve ser substituída pela url do servidor.
Parâmetros da Requisição
Headers
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
integration-key | string | Sim | Chave de integração. |
x-token | string | Sim | Token de autenticação. Pode ser encontrado em nosso portal na guia de integração. |
Authorization | Auth Type Bearer Token | Sim | Inserir o Bearer Token, gerado na rota Auth |
establishment_id | string | Sim | ID do estabelecimento ao qual os lançamentos estão vinculados. |
Exemplo de header da requisição
curl--request GET \
--location '/v1/marketplace/transactions/future\_releases\_daily' \
--header 'integration-key: your_integration_key' \
--header 'x-token: your_x_token' \
--header 'Authorization: Bearer {{bearer_token}}' \
--header 'establishment_id: your_establishment_id' \📎 Query Parameters
| Nome | Tipo | Descrição |
|---|---|---|
filters | string | JSON com filtros (opcional). Campos filtráveis: gateway_authorization, expected_on. |
Exemplo de Response de sucesso.
{
"calendar": [
{
"amount": 100000,
"date": "2025-07-01"
}
],
"sevenDays": {
"amount": 300000
},
"fifteenDays": {
"amount": 500000
},
"thirtyDays": {
"amount": 800000
},
"months": [
{
"amount": 2000000,
"year": 2025,
"month": 7
}
],
"total": {
"amount": 5000000
}
}
📑 Tabela de Campos do Response
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
calendar | array | Sim | Lista de valores previstos por data. Cada item detalha o valor total previsto em determinada data. |
calendar[].amount | number | Sim | Valor previsto em centavos para a data especificada. |
calendar[].date | string | Sim | Data prevista para o lançamento (formato YYYY-MM-DD). |
sevenDays | object | Sim | Total consolidado de valores previstos para os próximos 7 dias. |
sevenDays.amount | number | Sim | Valor total (em centavos) previsto para os próximos 7 dias. |
fifteenDays | object | Sim | Total consolidado de valores previstos para os próximos 15 dias. |
fifteenDays.amount | number | Sim | Valor total (em centavos) previsto para os próximos 15 dias. |
thirtyDays | object | Sim | Total consolidado de valores previstos para os próximos 30 dias. |
thirtyDays.amount | number | Sim | Valor total (em centavos) previsto para os próximos 30 dias. |
months | array | Sim | Lista de valores agrupados por mês/ano. |
months[].amount | number | Sim | Valor total (em centavos) previsto para o mês especificado. |
months[].year | number | Sim | Ano do agrupamento. |
months[].month | number | Sim | Mês do agrupamento (1 a 12). |
total | object | Sim | Valor total global previsto considerando todos os lançamentos futuros cadastrados. |
total.amount | number | Sim | Valor total previsto em centavos. |
Códigos de Resposta
Consulte a página com os status: Status de respostas
Para mais detalhes sobre os parâmetros e funcionamento da API, acesse a documentação oficial da Paytime.
Updated 6 months ago
Did this page help you?