Takeat
Versão da documentação
Takeat
Financeiro

Nova API V1.0 · Referência

Listar lançamentos financeiros

Replica os lançamentos da Área do Gestor, com pais e itens aninhados, totais do período e página fixa de 100. Com OAuth, exige `financial:read`; a sessão do restaurante também é aceita.

Console de requisiçõesConfigure os dados, envie e inspecione a resposta.
GETProxy seguro
RequisiçãoEdite os campos antes de enviar
GET
/v1/financial/cash-flows

Replica os lançamentos da Área do Gestor, com pais e itens aninhados, totais do período e página fixa de 100. Com OAuth, exige financial:read; a sessão do restaurante também é aceita.

Authorization

bearerAuth
AuthorizationBearer <token>

Access token OAuth obtido em POST /oauth/token ou sessão autenticada do restaurante emitida pelo login Takeat. Tokens OAuth exigem os escopos de cada operação. A sessão não usa escopos de integração e fica limitada ao restaurant_id assinado. Chaves tk_ não são aceitas.

In: header

Query Parameters

restaurant_id?integer

Omitido para sessões de restaurante, chaves de restaurante e parceiros ligados a um único restaurante. Obrigatório para parceiros multi-restaurante e validado contra os restaurantes autorizados para a credencial. Em uma sessão, um valor diferente do restaurant_id assinado responde 403.

start_date*string
end_date*string

Último dia, incluído por inteiro.

date_type?string
offset?integer
paid?boolean
is_earning?boolean
provider_id?integer
bank_account_id?integer
payment_method_id?integer
category_subcategory_id?integer

Response Body

application/json

application/json

application/json

application/json

Listar produtos intermediários GET

Registros não cancelados do restaurante, ordenados por nome e por ID em empates. Com OAuth exige `intermediaries:read`; aceita também a sessão do restaurante. Página fixa de 100 registros; não permite escrita. Quantidades mantêm o texto e os valores monetários têm duas casas decimais. Valores inválidos já armazenados preservam a string NaN do PostgreSQL.

Consultar detalhe de NF-e recebida GET

OAuth exige nfe-received:read; também aceita sessão autenticada de restaurante. Consulta a Focus no servidor usando a marca vinculada ou padrão quando a nota não possui marca. Não modifica a nota nem manifesta. Usa timeout de 15 segundos e resposta máxima de 5 MiB. Nota resumida pode retornar invoice/protocol null. Campos locais de correção, cancelamento e referências continuam sendo snapshots locais. Erros do provedor não são expostos.