Consulta de dados da Loja
Este endpoint é utilizado para consultar as informações principais e o status operacional de uma loja específica. Ele retorna dados de identificação, tempos de serviço, comissão, termos de uso, avaliações e horários de funcionamento.
GET
/store/{store_id}/infoPayload Consulta dados da Loja
{
"data": {
"id": 54044,
"name": "Loja Aiqfome",
"corporate_name": "Loja Aiqfome",
"document_number": "09.186.786/0001-58",
"time_to_prepare_order": 10,
"time_to_deliver": "20 - 40",
"is_delivery_radius_active": false,
"virtual_avatar": {
"132": "https://test-aqf-painel.s3.amazonaws.com/restaurantes/avatar/29edae70-9663-4f29-8778-6737xeee7dc9/132_restaurante_20220801101729.png",
"160": "https://test-aqf-painel.s3.amazonaws.com/restaurantes/avatar/29edae70-9663-4f29-8778-6737xeee7dc9/160_restaurante_20220801101729.png",
"300": "https://test-aqf-painel.s3.amazonaws.com/restaurantes/avatar/29edae70-9663-4f29-8778-6737xeee7dc9/300_restaurante_20220801101729.png",
"500": "https://test-aqf-painel.s3.amazonaws.com/restaurantes/avatar/29edae70-9663-4f29-8778-6737xeee7dc9/500_restaurante_20220801101729.png",
"default": "https://test-aqf-painel.s3.amazonaws.com/restaurantes/avatar/29edae70-9663-4f29-8778-6737xeee7dc9/restaurante_20220801101729.png"
},
"virtual_cover": null,
"city_id": 6190,
"commission": "50.00",
"term_of_use": null,
"ratings": {
"average": 0,
"count": 0,
"details": {
"quality": 0,
"delivery": 0,
"accuracy": 0
},
"weekday": {
"sunday": 0,
"monday": 0,
"tuesday": 0,
"wednesday": 0,
"thursday": 0,
"friday": 0,
"saturday": 0
}
},
"working_hours": [
{
"week_day_number": 1,
"hours": "10:00 - 22:00",
"status": 1
},
{
"week_day_number": 2,
"hours": "10:00 - 22:00",
"status": 1
},
{
"week_day_number": 3,
"hours": "10:00 - 22:00",
"status": 1
},
{
"week_day_number": 4,
"hours": "10:00 - 22:00",
"status": 1
},
{
"week_day_number": 5,
"hours": "10:00 - 22:00",
"status": 1
},
{
"week_day_number": 6,
"hours": "10:00 - 23:00",
"status": 1
},
{
"week_day_number": 7,
"hours": "10:00 - 20:00",
"status": 1
}
]
}
}
Resposta de Sucesso (Status Code 200)
O retorno é um objeto na chave data contendo todos os detalhes da loja.
| Campo Principal | Descrição |
|---|---|
| id | ID único da loja. |
| name | Nome Fantasia da loja. |
| corporate_name | Razão Social da loja. |
| document_number | CNPJ da loja. |
| time_to_prepare_order | Tempo médio de preparo do pedido em minutos. |
| time_to_deliver | Intervalo de tempo de entrega exibido ao cliente (Ex: "40 - 60"). |
| is_delivery_radius_active | Indica se a loja está utilizando a precificação de frete baseada em raio (true ou false). |
| virtual_avatar | Objeto contendo as URLs para as imagens de avatar da loja em diferentes resoluções. |
| virtual_cover | URL da imagem de capa da loja (pode ser null). |
| city_id | ID da cidade onde a loja está localizada. |
| commission | Percentual de comissão da loja (em formato string, Ex: "20.00"). |
| term_of_use | Data e hora da última atualização e aceite dos termos de uso da loja. |
| ratings | Objeto contendo os dados de avaliação da loja (média, contagem, detalhe por critério). |
| working_hours | Array contendo a definição de horários de funcionamento da loja por dia. |
Detalhamento Adicional: Horários de Funcionamento (working_hours[])
Esta subseção detalha como os horários são retornados:
| Campo | Descrição |
|---|---|
| working_hours[].week_day_number | Número do dia da semana: 1 (Segunda-feira) a 7 (Domingo). |
| working_hours[].hours | String contendo os períodos de funcionamento (Ex: "08:00 - 12:00"). |
| working_hours[].status | Status de operação do dia: 1 (Aberto/Funciona) ou 0 (Fechado/Não Funciona). |
Listar Lojas
Na API V2, devido ao modelo de autenticação por loja, este endpoint retorna os dados específicos da unidade vinculada ao access_token utilizado. Ele é um complemento ao Store Info, pois traz informações do endereço da loja e outras informações adicionais.
GET
/storePayload Listar Lojas
{
"data": [
{
"id": 53184,
"name": "Paladinos Burguer",
"phones": "(44) 3268-5959",
"virtual_avatar": null,
"status": "OPEN",
"aiqentrega_active": false,
"aiqentrega_auto_call_motoboy": false,
"aiqentrega_max_orders_per_ride": 3,
"address": {
"street_name": "Avenida Brasil",
"number": "3080",
"city_name": "Maringá",
"state_uf": "PR"
}
}
]
}
Resposta de Sucesso (Status Code 200)
| Campo | Descriç ão |
|---|---|
id | ID único da loja na plataforma (Store ID). |
name | Nome fantasia do estabelecimento. |
phones | Telefone principal de contato da loja. |
virtual_avatar | URL da imagem de perfil/logo da loja. |
status | Status atual da loja (Ex: OPEN, CLOSED). |
aiqentrega_active | Indica se a loja possui o serviço de logística oficial aiqentrega ativo. |
aiqentrega_auto_call_motoboy | Indica se o entregador é chamado automaticamente após o aceite do pedido. |
aiqentrega_max_orders_per_ride | Quantidade máxima de pedidos que podem ser agrupados em uma única corrida. |
address | Objeto contendo o endereço físico (Rua, Número, Cidade e UF). |
Detalhamento do Objeto address
| Campo | Descrição |
|---|---|
street_name | Nome do logradouro (rua, avenida, praça, etc.) onde a loja está situada. |
number | Número do imóvel. Retornado como string para suportar números com letras ou complementos (ex: "123A"). |
city_name | Nome da cidade de operação da loja. |
state_uf | Sigla da Unidade Federativa (Estado) com dois caracteres. |