Data Push

Set the Connection

To set up your Data Push app, you will need to first add the connection in your ItemPath site’s Settings.

In the Connections tab, click the “+” button to start a new connection and follow these steps:

  1. Give the connection a Name you choose.
  2. Set the Type to “API”.
  3. Enter the base Address of the API call. (The path will be configured later when creating an integration.)
  4. Choose an Authentication Type. In most cases this will be "BASIC".
  5. Enter a Username and Password to use to access the system.
 Data push 0 connections 2 1

Test the connection and check for a green checkmark confirmation.

Add an Integration

Now that the connection is set up, go to the Apps tab and click Data Push. There you'll see the list of integrations, and a button to add a "New Integration" in the top-right corner. Click to get started.

 Data push 1 integrations

Give the integration a name, ideally one that demonstrates what kind of data it will be used to send. Set the format to "JSON" and select the connection you set up in the first step.

Integration Settings

Once an integration is created, you can click on it to look at the details. In the Settings tab, you'll see these options:

  • URL Path: This is the extension of the connection base.
  • Headers: Add or remove headers that should be included, like authorization tokens.
  • Filters: Filter by history type(s).

You can also toggle the integration to "Inactive" at the top-right.

 Data push 2 settings

Integration Mappings

The Mappings tab allows you to customize data mapping using a flexible expression system. Select a mapping type to get started:

  • Column: Enter the name from your system, then choosing the corresponding PowerPick column.
  • Text: Add a line of text that will be consistent in all calls.
  • Grouping: This organizing tool is mainly used for subgrouping order lines.
 Data push 3 mappings

Integration Logs

See when the integration has run and what was returned using the Logs tab.

 Data push 4 logs

For checking for errors, we recommend adding a report per integration to check for an exportStateType of 5.

Pre-built templates of these reports can be downloaded from this list here. Look for Pick Confirmations with Errors and Pick Confirmations with Errors.

Then, connect each report to a workflow to get notified automatically.