| Endpoint | Campos com horário |
|---|---|
| GET /v1/merchant - Get information of a Merchant | services.serviceHours, availabilities |
| POST /v1/merchantUpdate/{merchantId} - New Merchant Update Notification | services.serviceHours, availabilities |
| GET /v1/merchant/{id}/status - Get Merchant Status and Service Hours | services.serviceHours |
- Todo horário trafega em UTC+0. Converta o horário local da loja antes de enviar.
- Dentro de
timePeriods, sempreendTime > startTime. - Se, após a conversão, o intervalo atravessar a meia-noite UTC, divida em dois registros.
- O fim do dia (24:00) é enviado como
23:59:00.000Z.
Formato de hora: HH:mm:ss.SSSZ (ex.: 11:00:00.000Z). Formato de data: YYYY-MM-DD. Dias da semana em inglês, maiúsculas (MONDAY … SUNDAY).
Para converter de UTC-3 para UTC+0, some 3 horas ao horário local.
a) Por data, sem virar o dia — loja abre em 07/04/2026, das 08:00 às 20:00 (local):
[
{ "date": "2026-04-07", "timePeriods": { "startTime": "11:00:00.000Z", "endTime": "23:00:00.000Z" } }
]b) Por data, virando o dia — 07/04/2026, das 10:00 às 22:00 (local). Em UTC fica 13:00 → 01:00 do dia seguinte, então divide:
[
{ "date": "2026-04-07", "timePeriods": { "startTime": "13:00:00.000Z", "endTime": "23:59:00.000Z" } },
{ "date": "2026-04-08", "timePeriods": { "startTime": "00:00:00.000Z", "endTime": "01:00:00.000Z" } }
]c) Por dia da semana, sem virar o dia — segunda e terça, 08:00–20:00 (local):
[
{ "dayOfWeek": ["MONDAY", "TUESDAY"], "timePeriods": { "startTime": "11:00:00.000Z", "endTime": "23:00:00.000Z" } }
]d) Por dia da semana, virando o dia — segunda e terça, 10:00–22:00 (local). Primeiro divida cada dia; depois agrupe os blocos com horários idênticos:
[
{ "dayOfWeek": ["MONDAY", "TUESDAY"], "timePeriods": { "startTime": "13:00:00.000Z", "endTime": "23:59:00.000Z" } },
{ "dayOfWeek": ["TUESDAY", "WEDNESDAY"], "timePeriods": { "startTime": "00:00:00.000Z", "endTime": "01:00:00.000Z" } }
]