Harmony Integration with DotApparel

Supported features

The following features are currently supported by DotApparel Core

• Products

• Inventory

• Orders

• Fulfillments

• Marketplace

• Images (via S3/Cloudinary. No native image integration from Harmony)

• Customers

Coming soon

• Gift Cards

• Refunds

Connection

A keyword should be configured along with URL, username and password. These should be available in the reference sheet, otherwise can be retrieved from merchant/FBS team.

Products

Harmony price fields settings are used to determine which field should we use for original/markdown price from Harmony response.

Orders

Freight options

• Carrier code: Determines which carrier the order should be shipped with (i.e. Aus Post, StarTrack, etc.)

• Freight stock item namekey: This is configured in Harmony by FBS & merchant and is required as part of the order payload. This should be available in Reference sheet or can otherwise be retrieve from FBS/merchant.

Click & Collect orders:

Current implementation also enable C&C order posting. If merchant enables new pick up location it they need to inform us to update the settings:

However, Harmony requires shipping address field to be populated in order payload so we also need to add a dummy value for this via order mapping.

Example mapping (only for address1 but can update for other fields if required)

Harmony specific values

These are constant values that should be readily configured for each brand, and are required as part of order payload. These should be available in reference sheet or can otherwise be retrieved from FBS.

Fulfillment warehouse will be overridden for click and collect order (Local pickup), which will use the warehouse namekey that’s configured in the settings

Marketplace order can also override these fixed values, specifically:

• Agent zone

• Originated warehouse

• Payment merchant ID

• Payment card type

• Shop debtor

These make sure that order placed via marketplace can be processed against different payment information and fulfilled by different warehouse within Harmony.

Mappings

Most of the mappings are similar to what’s currently available to Apparel21. However there are a few areas that are specific to Harmony:

Orders

• By default, Harmony uses capitalisation for all order information (names, addresses, etc.)

• altOrderNumber: alternative order number mapping, only used for marketplace order.