Cómo entender por qué los encabezados de fax usan UTC con el parámetro send_time en la API de Fax.Plus

Al enviar un fax mediante la API de Fax.Plus, es posible que observe que la marca de tiempo impresa en el encabezado del fax aparece en UTC, incluso cuando incluye un desfase de zona horaria (por ejemplo, +0900 para JST) en el campo send_time.

Cómo entender el parámetro send_time

• El campo send_time es opcional.
• Si se omite, el fax se envía de inmediato, y la marca de tiempo del encabezado del fax se genera usando UTC, que es la zona horaria estándar que utilizamos.
• Si se proporciona, send_time le permite programar un fax para una fecha y hora específicas, incluyendo un desfase de zona horaria.
• Formato admitido: 
  YYYY-MM-DD HH:mm:ss +HHMM
  Ejemplo:
  "send_time": "2025-12-19 09:00:05 +0900"

Comportamiento importante a tener en cuenta

Si el valor de send_time está en el pasado en el momento en que se recibe la solicitud a la API, aunque sea por un segundo, el sistema hará lo siguiente:

• Ignorar el valor de send_time proporcionado
• Enviar el fax de inmediato
• Establecer la marca de tiempo del encabezado del fax en UTC

Este comportamiento garantiza un procesamiento fiable de los envíos inmediatos y evita trabajos fallidos o retrasados debido a horarios de programación no válidos.

Por qué esto puede parecer incoherente

Puede observar un comportamiento diferente según el origen de su solicitud a la API:

• Los entornos locales pueden enviar la solicitud con la rapidez suficiente como para que send_time siga estando en el futuro.
• Los entornos en la cloud pueden introducir pequeños retrasos, provocando que send_time se interprete como ya transcurrido.

En estos casos, el fax se procesa como un envío inmediato, y la marca de tiempo del encabezado se establece por defecto en UTC.

Cómo garantizar que se preserve su zona horaria

Para garantizar que se respete la zona horaria especificada en send_time:

✅ Programe siempre el fax un poco en el futuro
Le recomendamos establecer send_time con al menos 1-2 segundos de antelación respecto a la hora actual.

Ejemplo de buena práctica:

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

Esto garantiza que la solicitud se trate como un fax programado y que el desfase de zona horaria se preserve en el encabezado del fax.

Puntos clave

• send_time es opcional
• Los encabezados de fax usan UTC por defecto para los envíos inmediatos
• Si send_time está en el pasado, se ignora
• Programarlo con solo unos segundos de antelación evita el uso predeterminado de UTC

Si tiene más preguntas o necesita ayuda para solucionar problemas con su integración de la API, no dude en ponerse en contacto con nuestro equipo de soporte.