1. Home
  3. API Guide

API Guide

Workflow API & Integrations

Connect your ecommerce, MIS/ERP, or internal systems to automate pricing, send orders, and track production.

  • Automate order submission
  • Get live product pricing
  • Retrieve job status & tracking

Authentication

All API operations use HTTP Basic Authentication with your Key and Secret.

Authorization Header

Authorization: Basic {Base64(key:secret)}

Base URL

https://orders.ukprintingcompany.co.uk/{Order Path}

Create Order (API)

Endpoint

POST https://orders.ukprintingcompany.co.uk/{Order Path}

Required Headers

Content-Type: application/json
Authorization: Basic {Base64 encoded key:secret}
Main Order Fields
Field Description Format
sourceIntegrationOrderNumber Your integration order number Alphanumeric
resellerName Your business name Alphanumeric
resellerOrderNumber Your order number Alphanumeric
customerName Customer full name Alphanumeric
shippingMethodAlias Postal method Alphanumeric
items Array of product line items Array
Item Fields
Field Description Format
productSku Our SKU Alphanumeric
customerProductName Your product name Alphanumeric
quantity Qty of this item Number
itemAssetDetails Images / printing data Array

Example Payload

{
  "sourceIntegrationOrderNumber": "12345",
  "resellerName": "A Shop Name",
  "resellerOrderNumber": "777",
  "customerName": "Mr J Doe",
  "shippingMethodAlias": "First Class",
  "items": [
  {
    "productSku": "GF-SKU-1",
    "quantity": 1,
    "itemAssetDetails": [
      {
        "itemAssetUrl": "http://ukpcl.co.uk/teeinblue/your-first-file.pdf"
      }
    ]
  },
  {
    "productSku": "GF-SKU-2",
    "quantity": 1,
    "itemAssetDetails": [
      {
        "itemAssetUrl": "http://ukpcl.co.uk/teeinblue/your-second-file.pdf"
      }
    ]
  }
]

}

FTP Integration

Two Methods

  • Pull — we fetch from your FTP
  • Push — you upload to ours (contact support)

FTP orders are CSV-based. Each row represents an item. Orders with the same resellerOrderNumber merge automatically.

FTP CSV Fields
Field Description Format
resellerName Your business name Alphanumeric
resellerOrderNumber Your order number Alphanumeric
customerName Customer full name Alphanumeric
productSku Our product SKU Alphanumeric
quantity Qty ordered Number
imageCode Image code from Upload API Alphanumeric
itemAssetUrl Link to print-ready image URL

Example CSV

resellerName,resellerOrderNumber,customerName,productSku,quantity,imageCode,itemAssetUrl
My Shop,1001,John Doe,GF-SKU-1,1,ABC123,https://example.com/image.png

Webhooks

Webhooks notify you when statuses change — for example:

  • Order received
  • Order in production
  • Order shipped

Your Requirements

  • Provide a stable HTTPS endpoint
  • Accept JSON payloads
  • Respond with 200 OK

Support

If you need help, contact our support team.