Compreender por que motivo os cabeçalhos de fax utilizam UTC com o parâmetro send_time na API Fax.Plus

Ao enviar um fax através da API Fax.Plus, poderá reparar que o registo de data e hora impresso no cabeçalho do fax aparece em UTC, mesmo quando inclui um desvio de fuso horário (por exemplo, +0900 para JST) no campo send_time.

Compreender o parâmetro send_time

• O campo send_time é opcional.
• Se for omitido, o fax é enviado imediatamente, e o registo de data e hora do cabeçalho do fax é gerado utilizando UTC, que é o fuso horário padrão que utilizamos.
• Se for fornecido, o send_time permite-lhe agendar um fax para uma data e hora específicas, incluindo um desvio de fuso horário.
• Formato suportado: 
  YYYY-MM-DD HH:mm:ss +HHMM
  Exemplo:
  "send_time": "2025-12-19 09:00:05 +0900"

Comportamento importante a ter em conta

Se o valor de send_time estiver no passado no momento em que o pedido à API é recebido - mesmo que seja apenas um segundo - o sistema irá:

• Ignorar o send_time fornecido
• Enviar o fax imediatamente
• Definir o registo de data e hora do cabeçalho do fax para UTC

Este comportamento garante o processamento fiável de transmissões imediatas e evita falhas ou atrasos nos trabalhos devido a horários de agendamento inválidos.

Por que motivo isto pode parecer inconsistente

Poderá observar comportamentos diferentes dependendo de onde o pedido à API tem origem:

• Ambientes locais podem enviar o pedido com rapidez suficiente para que o send_time ainda esteja no futuro.
• Ambientes cloud podem introduzir pequenos atrasos, fazendo com que o send_time seja interpretado como já decorrido.

Nestes casos, o fax é processado como um envio imediato, e o registo de data e hora do cabeçalho assume UTC por predefinição.

Como garantir que o seu fuso horário é preservado

Para garantir que o fuso horário especificado em send_time é respeitado:

✅ Agende sempre o fax um pouco no futuro
Recomendamos definir send_time pelo menos 1 a 2 segundos após a hora atual.

Exemplo de boa prática:

Hora atual: 09:00:00 +0900
send_time:    09:00:02 +0900

Isto garante que o pedido é tratado como um fax agendado e que o desvio de fuso horário é preservado no cabeçalho do fax.

Principais pontos a reter

• send_time é opcional
• Os cabeçalhos de fax assumem UTC por predefinição em envios imediatos
• Se send_time estiver no passado, é ignorado
• Agendar mesmo com alguns segundos de antecedência evita a utilização de UTC por predefinição

Se tiver questões adicionais ou precisar de ajuda para resolver problemas na integração com a API, não hesite em contactar a nossa equipa de suporte.