Apliiq Fulfillment URL: Complete Setup & Configuration Help

Fulfillment URL Webhook

Introduction

In order to complete the fulfillment workflow via API, you can setup an endpoint to receive tracking information when Apliiq ships your order.  You can setup your endpoint within your Apliiq account.  

How to setup your fulfillment URL

1. Go to the stores page in your Apliiq account.
2. Find the custom store store you are using for your API credentials 
3. Click the link icon:
4. Add your endpoint to the print on demand or warehouse fulfillment endpoint:



Header "x-apliiq-hmac" hmac-value

hmac-value is calculated as follow base64_encode(HMACSHA265([Base64_payload], Shared_SECRET)) 

You may use hmac-value as a way to validate the post is from Apliiq.  You can also include a validation mechanism in your URL if you wish to add further security measures to your end point.

Payload example  
  1. {
        "fulfillment": {
            "order_id": "1569438492",
            "status": "success",
            "tracking_company": "USPS",
            "tracking_numbers": [
                "9400111699000516881728"
            ],
            "tracking_urls": [],
            "line_items": [
                {
                    "id": "1511138222",
                    "quantity": 1,
                    "sku": "APQ-1998244S7A1",
                    "name": "cotton heritage polly pocket - M / denim"
                }
            ]
        }
    }