Data Stream Endpoints
From the ¶¶ÒõCloud Portal, define endpoints where external data is published. For example, define endpoints for accounting and labor scheduling data for consumption by external partners.
Create Data Stream Endpoint
→ →
To create a data stream endpoint:
From the Data Stream Endpoints page, select New Endpoint.
From the upper-right of the screen, select Save.
Define General Settings for an Endpoint
→ →
There are two types of endpoints:
HTTP
SQS
To define settings for an HTTP endpoint:
From the menu pane on the left of the data stream endpoint record, select General.
In the Name field, type the name of the endpoint.
In the Description field, type a description of the endpoint.
From the Type dropdown, select HTTP.
In the Target endpoint field, type/paste the URL where endpoint data is sent.
In the Access Token field, type the value used for authorization for the target HTTP endpoint (if required).
To validate the endpoint connection values, select Validate Connection.
To define settings for an SQS queue endpoint:
From the menu pane on the left of the data stream endpoint record, select General.
In the Name field, type the name of the endpoint.
In the Description field, type a description of the endpoint.
From the Type dropdown, select SQS.
In the Target endpoint field, type/paste the URL where endpoint data is sent.
Define Availability Settings for an Endpoint
→ →
To define the availability of a data stream endpoint:
From the menu pane on the left, select Availability.
Toggle Active to Yes if the data stream endpoint is currently active and available.
Multi-site users: To the right of the field, select the globe icon to define values for each site.
Enable Orders for an Endpoint
→ →
To send POS orders to a data stream endpoint:
From the menu pane on the left, select Orders.
Toggle Enable to Yes.
Toggle Send Net/Gross Sales to Yes to send Net and Gross Sales data to the endpoint.
This setting is intended to accommodate external consumers who prefer receiving precalculated Net and Gross Sales data within the order payload.
From the Relevance Key dropdown, select the preferred order field combination. The selected combination of fields is used to identify outdated versions of an order and prevent delivery to the target address.
Order ID + Last Modified
Order ID + State + Closure Time
Toggle Filter Data to Yes to define order state and order type filters.
When this toggle is enabled, the following sections are displayed:
Add Order State Filters
To add order state filters:
Locate the Order States section.
Select Add Filters.
From the Add Order States window, select the order states to send to the endpoint.
Select Add Item(s).
To remove an order state from the list, select the X on the row of the order state.
Add Order Type Filters
To add order type filters:
Locate the Order Types section.
Select Add Filters.
From the Add Order Types window, select the order types to send to the endpoint.
Select Add Item(s).
To remove an order type from the list, select the X on the row of the order type.
Enable Drawer Events for an Endpoint
→ →
To send POS drawer events to the endpoint:
From the menu pane on the left, select Drawers.
Toggle Enable to Yes.
Toggle Filter Data to Yes to define drawer event type filters. When toggled on, the Drawer Event Types section is displayed.
Add Drawer Event Type Filters
To add drawer event type filters:
Locate the Drawer Event Types section.
Select Add Filters.
From the Add Drawer Event Types window, select the drawer event types to send to the endpoint.
Select Add Item(s).
To remove an event type from the list, select the X on the row of the event type.
Enable Deposits for an Endpoint
→ →
To send deposit data to the endpoint:
From the menu pane on the left, select Deposits.
Toggle Enable to Yes.
Toggle Filter Data to Yes to define deposit status filters.
When this toggle is enabled, the Deposit Statuses section is displayed. Add deposit status filters in this section.
Add Deposit Status Filters
To add deposit status filters:
Locate the Deposit StatusesÌý²õ±ð³¦³Ù¾±´Ç²Ô.
³§±ð±ô±ð³¦³ÙÌýAdd Filters.
From the Add Drawer Event Types window, select the drawer event types to send to the endpoint.
³§±ð±ô±ð³¦³ÙÌýAdd Item(s).
To remove a deposit status from the list, select the X on the row of the deposit status.
Enable Employee Time Punches for an Endpoint
→ →
To send employee time punches to the endpoint:
From the menu pane on the left, select Punches.
Toggle Enable to Yes.
Enable EOD Notifications for an Endpoint
→ →
To send End of Day (EOD) notifications to the endpoint:
From the menu pane on the left, select EOD.
Toggle Send Site EOD to Yes to enable site-level EOD notifications.
Toggle Send Terminals EOD to Yes to enable terminal-specific EOD notifications.
Enable Workflow for an Endpoint
→ →
To send workflow details to the endpoint:
From the menu pane on the left, select Workflow.
Toggle Enable to Yes.
Resend Data to Data Stream Endpoint
→ →
To resend transactional data to a data stream endpoint:
From the Data Stream Endpoints page, locate the endpoint.
From the right of the endpoint, select the 3-dots menu.
From the 3-dots menu, select Resend Data.
From the Resend Data window, specify the data to resend:
From the lower-right of the Resend Data window, select Send.
Resend Deposit Data
From the Resend Data window, define the following:
Field | Description |
|---|---|
Entity | From the dropdown, select Deposits. |
Site | From the dropdown, select the site. |
Business Date | Select the calendar icon to specify the business date to resend. |
Deposit Statuses | Select the deposit statuses to resend. To use the filters defined for the endpoint, leave this field blank. |
Deposit IDs | Specify the deposit IDs to resend.
Example: "23c2cb1d-e01a-46e8-8bf7-2ca374daa665", "257dafeb-ec2d-4869-8da9-11b132c53364" |
Resend Drawer Data
From the Resend Data window, define the following:
Field | Description |
|---|---|
Entity | From the dropdown, select Orders. |
Site | From the dropdown, select the site. |
Business Date | Select the calendar icon to specify the business date to resend. |
Drawer Event Types | Select the drawer event types to resend. To use the filters defined for the endpoint, leave this field blank. |
Drawer IDs | Specify the Drawer IDs to resend.
Example: "10025", "10026" |
Drawer Event IDs | Specify the Drawer Event IDs to resend.
Example: "11002", "21056" |
Resend Order Data
From the Resend Data window, define the following:
Field | Description |
|---|---|
Entity | From the dropdown, select Orders. |
Site | From the dropdown, select the site. |
Business Date | Select the calendar icon to specify the business date to resend. |
Order Numbers | Specify the order numbers to resend.
Example: "10025", "10026" |
Order IDs | Specify the order IDs to resend.
Example: "1-1002", "2-1056" |
Order States | Select the order states to resend. To use the filters defined for the endpoint, leave this field blank. |
Order Types | Select the order types to resend. To use the filters defined for the endpoint, leave this field blank. |