Time Zones

Overview: The time zones used for Order Broker include the following:

system time zone: Set to UTC (Coordinated Universal Time). This time zone is used for dates and times in the database and web service responses.
retailer’s time: The Time Zone specified at the Tenant (retailer information) screen. This time zone is displayed on most Order Broker, Store Connect, and Vendor Portal screens and in generated email notifications. It is used for scheduling imports, exports, and report generation, and to calculate the number of orders for Maximum Daily Orders.
user’s time: The time zone on the user’s personal computer or specified in the user’s browser. In most cases, the times displayed on screens and indicated in emails are in the retailer’s time rather than the user’s time.

Example: system time zone = UTC retailer’s time zone = UTC - 5:00 (for example, U.S. Eastern Time) user’s time zone = UTC - 8:00 (for example, U.S. Pacific Time)

Event	Time Used or Displayed
order created	SubmitOrder response, database update, log entries: 2:00 (system time) Displayed on screens in Order Broker and Store Connect, such as order history: 7:00 (retailer’s time) Note: When using a screen to search by date, such as searching based on order date, the retailer’s time is used. For example, if an order was created at 01:00 (01:00 a.m.) June 29 system time, and 20:00 (10:00 p.m.) June 28 retailer’s time, searching based on an order date of June 28 displays the order, while a creation date of June 29 does not.
imports scheduled and executed	Schedule Jobs screen: 13:00 (1:00 p.m.) (retailer’s time) Database entry: 18:00 (6:00 p.m.) (system time) Confirmation email: 13:00 (1:00 p.m.) (retailer’s time)
setting up probability locations	The From Date and To Date at the Probability Location screen: no time is displayed, but date is calculated based on retailer’s time.

Event

Time Used or Displayed

order created

SubmitOrder response, database update, log entries: 2:00 (system time)

Displayed on screens in Order Broker and Store Connect, such as order history: 7:00 (retailer’s time)

Note: When using a screen to search by date, such as searching based on order date, the retailer’s time is used. For example, if an order was created at 01:00 (01:00 a.m.) June 29 system time, and 20:00 (10:00 p.m.) June 28 retailer’s time, searching based on an order date of June 28 displays the order, while a creation date of June 29 does not.

imports scheduled and executed

Schedule Jobs screen: 13:00 (1:00 p.m.) (retailer’s time)

Database entry: 18:00 (6:00 p.m.) (system time)

Confirmation email: 13:00 (1:00 p.m.) (retailer’s time)

setting up probability locations

The From Date and To Date at the Probability Location screen: no time is displayed, but date is calculated based on retailer’s time.

Changing the time zone: Whenever the Time Zone is changed at the Tenant screen, it is necessary to update all schedules, including imports, exports, report generation, polling, and notifications.

Exceptions: Screens that use the user’s time rather than the retailer’s time:

Vendor Portal:
- landing page: dates for calculation of updates and graphs
- Purchase Order Shipping: default shipment date
- Invoice: default invoice date

Also, the user’s time applies when prompting on a calendar entry.