Takeat
Versão da documentação
Takeat
Fiscal

Nova API V1.0 · Referência

Listar NF-e recebidas

OAuth exige nfe-received:read; também aceita sessão autenticada de restaurante. Somente notas autorizada e sem cancelamento local, por emissão crescente e id. Intervalo máximo de 92 dias. Array completo, sem paginação; divida intervalos muito grandes. Não inclui transferências de estoque nem solicita manifestação. Valores locais podem diferir da consulta atual do detalhe.

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

OAuth exige nfe-received:read; também aceita sessão autenticada de restaurante. Somente notas autorizada e sem cancelamento local, por emissão crescente e id. Intervalo máximo de 92 dias. Array completo, sem paginação; divida intervalos muito grandes. Não inclui transferências de estoque nem solicita manifestação. Valores locais podem diferir da consulta atual do detalhe.

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

Data/hora ISO com segundos. Sem offset é UTC; aceita Z ou offset explícito. Limites inclusivos, sem expansão para início/fim do dia.

end_date*string

Data/hora ISO com segundos. Sem offset é UTC; aceita Z ou offset explícito. Limites inclusivos, sem expansão para início/fim do dia.

pendente?boolean

true inclui manifestação null, ciencia ou desconhecimento. false (padrão) inclui somente confirmacao. Aceita apenas true/false.

brand_id?integer

Uma marca não excluída do restaurante. Ausente: marca padrão ou primeira por id. Seleção da padrão inclui notas sem marca. Se não há marcas e o parâmetro é omitido, não filtra marca. Marca inválida/estrangeira retorna 404, sem fallback.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

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.

Listar marcas do restaurante GET

OAuth exige brands:read; também aceita sessão autenticada de restaurante. Retorna marcas não excluídas, ativas ou inativas, ordenadas por padrão primeiro, nome e id. Não expõe credenciais fiscais nem cursor de distribuição.