Pular para o conteúdo
Última atualização

Conversão de Fuso Horário

Onde se aplica

EndpointCampos com horário
GET /v1/merchant - Get information of a Merchantservices.serviceHours, availabilities
POST /v1/merchantUpdate/{merchantId} - New Merchant Update Notificationservices.serviceHours, availabilities
GET /v1/merchant/{id}/status - Get Merchant Status and Service Hoursservices.serviceHours

Regras

  1. Todo horário trafega em UTC+0. Converta o horário local da loja antes de enviar.
  2. Dentro de timePeriods, sempre endTime > startTime.
  3. Se, após a conversão, o intervalo atravessar a meia-noite UTC, divida em dois registros.
  4. 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).

Exemplos com horário de Brasília (UTC-3)

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" } }
]