Horários de Serviço

Configuração de Horários e Tempo de Serviço

Este endpoint é utilizado para definir os horários de funcionamento da loja para cada dia da semana e configurar os tempos de serviço críticos que serão exibidos ao cliente (tempo de preparo e tempo de entrega). Além de definir se a loja aceita Entrega e/ou Retirada

O payload espera um objeto que detalha os dias da semana (working_hours) e as configurações gerais de serviço (service).

PUT

/store/{store_id}/hour

Payload Configuração de Entrega

{
  "working_hours": [
    {
      "weekday": 1,
      "status": false,
      "hours": [
        {
          "start": "07:00",
          "end": "18:55"
        }
      ]
    },
    {
      "weekday": 2,
      "status": false,
      "hours": [
        {
          "start": "08:00",
          "end": "18:55"
        }
      ]
    },
    {
      "weekday": 3,
      "status": false,
      "hours": [
        {
          "start": "08:00",
          "end": "18:55"
        }
      ]
    },
    {
      "weekday": 4,
      "status": false,
      "hours": [
        {
          "start": "08:00",
          "end": "10:00"
        }
      ]
    },
    {
      "weekday": 5,
      "status": true,
      "hours": [
        {
          "start": "08:00",
          "end": "18:55"
        }
      ]
    },
    {
      "weekday": 6,
      "status": false,
      "hours": [
        {
          "start": "08:00",
          "end": "18:55"
        }
      ]
    },
    {
      "weekday": 7,
      "status": false,
      "hours": [
        {
          "start": "08:00",
          "end": "18:55"
        }
      ]
    }
  ],
  "service": {
    "type_delivery": true,
    "type_pickup": true,
    "delivery_time": "40 - 60",
    "preparation_time": 15
  }
}

Detalhamento do Payload

1. Objeto working_hours (Horários de Funcionamento)

Campo	Obrigatório	Descrição
working_hours	✅	Array principal contendo a definição de horários para todos os dias da semana.
working_hours[].weekday	✅	Dia da semana: 1 (Segunda-feira) a 7 (Domingo). Regra: Todos os 7 dias devem ser mapeados.
working_hours[].status	✅	Indica se a loja está aberta (true) ou fechada (false) naquele dia.
working_hours[].hours	✅	Array de objetos com os intervalos de tempo de funcionamento da loja.
working_hours[].hours[].start	✅	Hora de início do expediente no formato HH:MM.
working_hours[].hours[].end	✅	Hora de fim do expediente no formato HH:MM.

2. Objeto service (Configurações de Serviço)

Este bloco define os tempo de preparo e as modalidades de entrega/retirada da loja.

Campo	Obrigatório	Descrição
service	❌	Objeto contendo as configurações de tempo de serviço e modalidades.
service.type_delivery	❌	Indica se a loja oferece o serviço de entrega (Delivery). Valores: true ou false.
service.type_pickup	❌	Indica se a loja oferece o serviço de retirada no local (Pickup). Valores: true ou false.
service.preparation_time	❌	Tempo de Preparação (em minutos). Valores Permitidos: 10, 20, 30, 40, 50, 60.
service.delivery_time	❌	Tempo Estimado de Entrega (em minutos). O tempo total que o cliente verá no app. Valores Permitidos (como string de intervalo): "15 - 30", "20 - 40", "40 - 60", "60 - 90", "90 - 120".

Configuração do Horário de funcionamento da loja

Este endpoint é utilizado para definir os horários e o status operacional (aberto/fechado) da loja para um ou mais dias da semana.

POST

/store/{store_id}/working-hours

Observação Importante
Este endpoint substitui os horários existentes para os dias da semana que são enviados no payload.

Payload Configuração do Horário de funcionamento da loja

{
  "working_hours": [
    {
      "week_day_number": "1",
      "week_day_name": "segunda",
      "status": "1",
      "hours": {
        "first_period": "08:00 - 12:00",
        "second_period": "13:00 - 19:00"
      }
    }
  ]
}

Detalhamento do Payload

1. Objeto working_hours (Horários de Funcionamento)

Este é um array que contém objetos para cada dia da semana que se deseja configurar.

Campo	Obrigatório	Descrição
working_hours	✅	Array principal contendo as definições de horários.
working_hours[].week_day_number	✅	Número do dia da semana (em string). Regra: "1" (Segunda-feira) a "7" (Domingo).
working_hours[].week_day_name	✅	Nome do dia da semana (Ex: "segunda", "terça").
working_hours[].status	✅	Indica se a loja está aberta ou fechada para aquele dia. Valores: "1" (Aberto) ou "0" (Fechado).
working_hours[].hours	✅	Objeto contendo os períodos de funcionamento.
working_hours[].hours.first_period	✅	String que define o primeiro período de funcionamento do dia no formato "HH:MM - HH:MM". Regra: Se a loja estiver aberta (status: "1"), este campo é obrigatório.
working_hours[].hours.second_period	❌	String que define um segundo período de funcionamento do dia, se houver (split schedule). Formato "HH:MM - HH:MM".

Configuração Rápida de Tempo de Entrega

Este endpoint é utilizado para atualizar unicamente o tempo estimado de ENTREGA (delivery_time) da loja que é exibido para o cliente no aplicativo. Ele oferece um método rápido para alterar o intervalo de entrega sem a necessidade de enviar todo o payload de horários de funcionamento.

PUT

/store/{store_id}/delivery-time

Payload Configuração Rápida Tempo de Entrega

{
  "delivery_time": "90 - 120"
}

Detalhamento do Payload

Campo	Obrigatório	Descrição
delivery_time	✅	Tempo Estimado de Entrega (em minutos). O tempo total que o cliente verá no app. Valores Permitidos (como string de intervalo): "15 - 30", "20 - 40", "40 - 60", "60 - 90", "90 - 120".

Consulta dos horários de funcionamento da loja

Este endpoint é utilizado para consultar os horários de funcionamento e o status de operação (aberto/fechado) configurados para a loja em cada dia da semana.

GET

/store/{store_id}/working-hours

Payload Consulta dos horários de funcionamento da loja

{
  "data": [
    {
      "id": 319032,
      "store_id": 54044,
      "week_day_number": 1,
      "hours": "10:00 - 22:00",
      "status": 1
    },
    {
      "id": 319033,
      "store_id": 54044,
      "week_day_number": 2,
      "hours": "10:00 - 22:00",
      "status": 1
    },
    {
      "id": 319034,
      "store_id": 54044,
      "week_day_number": 3,
      "hours": "10:00 - 22:00",
      "status": 1
    },
    {
      "id": 319035,
      "store_id": 54044,
      "week_day_number": 4,
      "hours": "10:00 - 22:00",
      "status": 1
    },
    {
      "id": 319036,
      "store_id": 54044,
      "week_day_number": 5,
      "hours": "10:00 - 22:00",
      "status": 1
    },
    {
      "id": 319037,
      "store_id": 54044,
      "week_day_number": 6,
      "hours": "10:00 - 23:00",
      "status": 1
    },
    {
      "id": 319038,
      "store_id": 54044,
      "week_day_number": 7,
      "hours": "10:00 - 20:00",
      "status": 1
    }
  ]
}

Resposta de Sucesso (Status Code 200)

O retorno é um objeto contendo um array na chave data com a definição de horários para todos os dias da semana.

Campo	Descrição
data	Array principal contendo os objetos de horários configurados.
data[].id	ID único do registro de horário de funcionamento.
data[].store_id	ID da loja referente ao registro.
data[].week_day_number	Número do dia da semana: 1 (Segunda-feira) a 7 (Domingo).
data[].hours	String contendo os períodos de funcionamento. Regra: múltiplos períodos são separados pelo caractere pipe (|).
data[].status	Status de operação do dia: 1 (Aberto) ou 0 (Fechado).