Description

Swan Retail System (SRS) is an all-in-one solution encompassing customer ordering, stock management and an accounting system that's uniquely capable of handling both big and small ticket items.

API documentation

API documentation should be obtained via your Swan Retail account manager.

Authentication

When adding connector instances for Swan Retail System (SRS), the following authentication methods are supported:

• No auth

No auth

When a user chooses to add a connector instance for this connector, no authentication details are requested. This is because the Swan Retail System is typically hosted on a company's own hardware, so authentication is handled internally.

Required Additional setup

Having installed the Swan Retail System connector and created required instances, some additional setup is required for use in process flows.

Please see the Swan Retail Systems response script page for details.

Introduction

Where required, Swan Retail System endpoints are paginated based on the amended date for items, so subsequent queries start from the amended date of the last item returned.

For this to work as required, we use a response script to add 5 milliseconds to the time stamp for last items. To implement this you must:

• Install the Swan Pagination Update Timestamp response script from the Patchworks marketplace.

• Apply this script to any process flow connector shapes where the Swan Retail System connector is used with a paginated endpoint.

Paginated endpoints

Having installed the Swan Retail System connector from the Patchworks marketplace, you'll find that two endpoints are configured for pagination:

• Get web updates

• Get web stock

Installing the Swan Pagination Update Timestamp script

Step 1 Log into your Patchworks dashboard and navigate to the marketplace.

Step 2 Select the scripts tab and locate the Swan Pagination Update Timestamp script (use the search field to find it quickly):

Step 3 Install the script:

The script is installed and ready for use when called from a connector shape in process flows.

Applying the Swan Pagination Update Timestamp script

If a process flow includes a connector shape configured to use the Swan Retail System connector with a paginated endpoint, you must apply the Swan Pagination Update Timestamp script to connector settings. To do this, follow the steps below.

Step 1 Click the settings icon associated with the connector shape:

Step 2 Scroll down to the response handling section and click on the response script field:

Step 3 Select the Swan Pagination Update Timestamp script:

Step 4 Select the latest version available:

Step 5 Save changes. Now whenever this process flow runs, this script is applied to responses.