Custom Integration

  • Home
  • Custom Integration

Custom API

Our system is designed to seamlessly integrate with your order data, no matter the format. Through our flexible API, we can accept any type of order data and map it to our internal workflow for efficient processing.

Once your orders are received and processed, we provide real-time updates by posting shipping and tracking information back to your system via webhooks. This ensures a smooth and automated data exchange, keeping you informed at every step of the fulfillment process.

Whether you have a custom data structure or specific integration requirements, our team can help configure the API to meet your needs. Reach out to us to learn more about how we can streamline your order management!

Why Integrate with Us?

✅ Flexible Order Data Handling – We accept any order format and map it to our system.
✅ Automated Tracking Updates – Stay informed with real-time shipping notifications.
✅ Seamless Workflow Integration – Orders are processed efficiently with minimal manual intervention.

Need help setting up your Order Desk integration? Contact us today to get started!

Contact Us

Create Order JSON Format

				
					{
  "resellerName": "KidsMerch",
  "resellerEmailAddress": "info@kidsmerch.co.uk",
  "resellerOrderNumber": "#KM14477",
  "customerName": "Joe Blogs",
  "customerAddressLineOne": "123 My Street",
  "customerAddressTown": "My Town",
  "customerAddressCounty": "ENG",
  "customerAddressPostcode": "My Postcode",
  "customerAddressCountry": "GB",
  "customerPhoneNumber": "+4407000000000",
  "customerEmailAddress": "",
  "shippingTo": "Joe Blogs",
  "shippingCompanyName": "",
  "shippingAddressLineOne": "123 My Street",
  "shippingAddressLineTwo": "",
  "shippingAddressTown": "My Town",
  "shippingAddressCounty": "ENG",
  "shippingAddressPostcode": "My Postcode",
  "shippingAddressCountryCode": "GB",
  "shippingPhoneNumber": "",
  "shippingEmailAddress": "",
  "shippingMethodAlias": "Express",
  "items": [
    {
      "productSku": "UK-1342",
      "quantity": 1,
      "customerProductReference": "TAWUL_LFC6CUPS_180",
      "customerProductName": "Liverpool Six Cups Personalised Beach Towel",
      "itemAssetDetails": [
        {
          "itemAssetUrl": "https://printess-prod.s3.eu-central-1.amazonaws.com/output/8cb58c9e97ba41b3336cbb3be42e20202da601b7_20250120T200544477_8aa2c9b1-9e9d-40d4-8534-fa38103490fd_1.pdf"
        }
      ]
    },
    {
      "productSku": "UK-2709",
      "quantity": 1,
      "customerProductReference": "FC-25I-TOTW-XL",
      "customerProductName": "Personalised FC25 ICON Football Card - Extra Large (58cm x 40cm)",
      "itemAssetDetails": [
        {
          "itemAssetUrl": "https://printess-prod.s3.eu-central-1.amazonaws.com/output/8cb58c9e97ba41b3336cbb3be42e20202da601b7_20250120T200544477_8aa2c9b1-9e9d-40d4-8534-fa38103490fd_1.pdf"
        }
      ]
    }
  ]
}

Responce JSON Format

				
					{
    "id": 1021,
    "sourceIntegrationOrderNumber": "38795",
    "resellerOrderNumber": "{sanitized}",
    "orderNumber": "{sanitized}",
    "status": "HELD",
    "carrier": "ROYAL_MAIL",
    "consignmentId": "SHP8547",
    "trackingUrl": "a tracking url for SHP8547",
    "trackingUrls": [ "a tracking url for SHP8547" ]
    "utcReceivedDateTime": 123456789,
    "utcCompletedDateTime": 123456789,
    "friendlyReadableCompletedDateTime": "12/34/56 12:34:56",
    "packages": [{
        "consignmentId": "PKG12156",
        "trackingUrl": "a tracking url for PKG12156"
    },{
        "consignmentId": "PKG12157",
        "trackingUrl": "a tracking url for PKG12157"
    }],
    "items": [{
        "id": 32102,
        "sourceIntegrationItemNumber": "57328",
        "status": "SENT"
    },{
        "id": 32103,
        "sourceIntegrationItemNumber": "57329",
        "status": "SENT"
    },{
        "id": 32104,
        "sourceIntegrationItemNumber": "57330",
        "status": "HELD",
        "statusComment": "optional status comment/explanation"
    }]
}

Custom Integration

We provide a variety of options to seamlessly connect to our system. If you require a custom integration tailored to your specific needs, please don’t hesitate to reach out to us. Our team is happy to assist you in finding the best solution for your requirements.

Contact Us