Zopping
Get a token

Set up Unicommerce

Connect Unicommerce (Uniware) to Zopping to push orders for fulfillment. Orders placed in Zopping are created in Uniware on ORDER_CREATE and completed in one shot on ORDER_DISPATCH (invoice + shipping provider + AWB + dispatch). Zopping also pulls stock from Uniware. This is a built-in connector.

Prerequisite: the ThirdPartyIntegration extension must be enabled for the organization.

1. Configure credentials

Add your Unicommerce details to the organization's integration config under the UNICOMMERCE key:

{
  "partnerIntegration": {
    "partnerCredentials": {
      "UNICOMMERCE": {
        "tenant": "mycompany",
        "username": "<api-username>",
        "password": "<api-password>",
        "shippingProviderCode": "SELFSHIP",
        "defaultTaxPercentage": "12",
        "email": "ops@example.com"
      }
    }
  }
}
FieldRequiredNotes
tenantyesSubdomain of the Unicommerce account (e.g. mycompany for mycompany.unicommerce.com).
username / passwordyesUniware API user credentials (used with the my-trusted-client OAuth password grant per request).
shippingProviderCodenoConfigured Uniware shipping provider code used when dispatching (defaults to SELFSHIP). Map it to shipping method STD in Uniware.
defaultTaxPercentagenoFallback GST rate used at invoicing when the item carries no tax and the SKU has no GST type in Uniware. Split into CGST+SGST (intra-state) or IGST (inter-state).
emailnoContact email for integration notifications.

2. Supported events

Direction: PUSH = Zopping → Unicommerce; PULL = Zopping pulls from Unicommerce.

DirectionEvents
PUSHORDER_CREATE, ORDER_DISPATCH, ORDER_PACK, ORDER_HOLD, ORDER_UNHOLD
PULLPRODUCT_INVENTORY_CHANGE

Enable delivery per event via event integrations.

Mapping notes

  • Unicommerce facility codes map to Zopping store clientId (sent as the Facility header and the item facilityCode).
  • Unicommerce SKU codes map to Zopping product clientItemId.
  • The Zopping order referenceNumber is sent as the Uniware sale order code, and stored back on the Zopping order as clientId.
  • The order item must be FULFILLABLE in Uniware (inventory allocated at the facility) before dispatch.

Going further