POD Super System Endpoints (1.0.0)

Download OpenAPI specification:

Authentication

Preflight options

Authorizations:

apiKeybearerAuth

Responses

Response samples

default

Content type

application/json

{"error": "Refresh Token expired. Please log in to start a new session.",
"error_code": "refresh_token_expired",
"devmessage": {"class": "string",
"code": 0,
"message": "string",
"location": "string",
"line": 0
}
}

Get the current user

Get the user from the current session.

Authorizations:

apiKeybearerAuth

Responses

Response samples

200
default

Content type

application/json

{"id": 42,
"name": "sebi",
"loggedIn": true
}

Login User

Authenticates the user.

Authorizations:

apiKeybasicAuth

Request Body schema: multipart/form-data

username	string
password	string <password>

Responses

Response samples

200
default

Content type

application/json

{"username": "sebi",
"refresh_token": "string"
}

Logout User

Logs the user out and terminates their current session.

Authorizations:

apiKeybearerAuth

Responses

Response samples

200
default

Content type

application/json

{"success": true
}

Preflight options

Authorizations:

apiKeybearerRefreshAuth

Responses

Response samples

default

Content type

application/json

{"error": "Refresh Token expired. Please log in to start a new session.",
"error_code": "refresh_token_expired",
"devmessage": {"class": "string",
"code": 0,
"message": "string",
"location": "string",
"line": 0
}
}

Renew access token. Only possible if the auth-type is Double JWT

Authorizations:

apiKeybearerRefreshAuth

Responses

Response samples

200
default

Content type

application/json

{"refresh_token": "string",
"access_token": "string"
}

Order

Create an Order

Creates a new order with shipping details and order line items.

Case 1: You do not provide the shipping label, therefore shipping is required.
Case 2: You do provide the shipping label (in order_meta_assets), therefore shipping is not required / can be ignored (although still recommended).

Authorizations:

apiKey

Request Body schema: application/json
required

One of

test

boolean

Default: false

Set to true if testing API integration. Set to false if this is a real order.

pickup

boolean

Default: false

For advanced integrations only that allow for non-shippable orders. Will automatically be set to false if your integration doesn't support this feature.

required

object (Shipping)

Where the order is to be shipped / the address of the end-customer.

provider_order_id

required

string

The Order ID / Order Number in your system.
Example: 123456
Example: ABC-123456

provider_order_date

required

string <date-time>

The date of the original customer order. Please use UTC.

provider_order_callback_url

required

string <uri>

The URL to send the order status updates to. This is a webhook URL.

provider_sales_channel

string

The name of the marketplace / sales channel the order originates from.
Example: Amazon
Example: Temu

shipping_carrier

string

Enum: "usps" "ups" "fedex" "dhl" "passportglobal" "gofo-express" "uniuni"

shipping_service

string

Shipping Carriers and Shipping Services Table

Shipping Carrier Title	Shipping Carrier Code	Shipping Service Title	Shipping Service Code
USPS	usps	USPS FIRST CLASS	FIRST CLASS
USPS	usps	USPS PRIORITY	PRIORITY
USPS	usps	USPS PRIORITY COMMERCIAL	PRIORITY COMMERCIAL
USPS	usps	USPS EXPRESS	EXPRESS
USPS	usps	USPS EXPRESS COMMERCIAL	EXPRESS COMMERCIAL
USPS	usps	USPS EXPRESS SH	EXPRESS SH
USPS	usps	USPS EXPRESS SH COMMERCIAL	EXPRESS SH COMMERCIAL
USPS	usps	USPS EXPRESS HFP	EXPRESS HFP
USPS	usps	USPS COMMERCIAL	COMMERCIAL
USPS	usps	USPS BPM	BPM
USPS	usps	USPS PARCEL	PARCEL
USPS	usps	USPS MEDIA	MEDIA
USPS	usps	USPS LIBRARY	LIBRARY
USPS	usps	USPS ALL	ALL
USPS	usps	USPS ONLINE	ONLINE
USPS	usps	USPS Ground Advantage	US-GA
USPS	usps	USPS First Class Mail International
USPS	usps	USPS First Class Package International Service
USPS	usps	USPS Priority Mail International
USPS	usps	USPS Express Mail International
UPS	ups	UPS Next Day Air	01
UPS	ups	UPS Second Day Air	02
UPS	ups	UPS Ground	03
UPS	ups	UPS Worldwide Express	07
UPS	ups	UPS Worldwide Expedited	08
UPS	ups	UPS Standard	11
UPS	ups	UPS Three-Day Select	12
UPS	ups	UPS Next Day Air Saver	13
UPS	ups	UPS Next Day Air Early AM	14
UPS	ups	UPS Worldwide Express Plus	54
UPS	ups	UPS Second Day Air AM	59
UPS	ups	UPS Saver (UPS Worldwide Express Saver)	65
UPS	ups	UPS SurePost Less than 1lb	92
UPS	ups	UPS SurePost 1 lb or Greater (aka UPS Ground Saver)	93
UPS	ups	UPS SurePost BPM	94
UPS	ups	UPS SurePost Media	95
UPS	ups	UPS First-Class Mail	M2
UPS	ups	UPS Priority Mail	M3
UPS	ups	UPS Expedited Mail Innovations	M4
UPS	ups	UPS Priority Mail Innovations	M5
UPS	ups	UPS Economy Mail Innovations	M6
FedEx	fedex	FedEx Europe First International Priority	EUROPE_FIRST_INTERNATIONAL_PRIORITY
FedEx	fedex	FedEx 1Day Freight	FEDEX_1_DAY_FREIGHT
FedEx	fedex	FedEx 2Day	FEDEX_2_DAY
FedEx	fedex	FedEx 2Day A.M.	FEDEX_2_DAY_AM
FedEx	fedex	FedEx 2Day Freight	FEDEX_2_DAY_FREIGHT
FedEx	fedex	FedEx 3Day Freight	FEDEX_3_DAY_FREIGHT
FedEx	fedex	FedEx Express Saver	FEDEX_EXPRESS_SAVER
FedEx	fedex	FedEx First Freight	FEDEX_FIRST_FREIGHT
FedEx	fedex	FedEx Freight Economy	FEDEX_FREIGHT_ECONOMY
FedEx	fedex	FedEx Freight	FEDEX_FREIGHT
FedEx	fedex	FedEx National Freight	FEDEX_NATIONAL_FREIGHT
FedEx	fedex	FedEx Freight Priority	FEDEX_FREIGHT_PRIORITY
FedEx	fedex	FedEx Ground	FEDEX_GROUND
FedEx	fedex	FedEx First Overnight	FIRST_OVERNIGHT
FedEx	fedex	FedEx Home Delivery	GROUND_HOME_DELIVERY
FedEx	fedex	FedEx International Economy	INTERNATIONAL_ECONOMY
FedEx	fedex	FedEx International Economy Freight	INTERNATIONAL_ECONOMY_FREIGHT
FedEx	fedex	FedEx International First	INTERNATIONAL_FIRST
FedEx	fedex	FedEx International Priority	INTERNATIONAL_PRIORITY
FedEx	fedex	FedEx International Priority Freight	INTERNATIONAL_PRIORITY_FREIGHT
FedEx	fedex	FedEx Priority Overnight	PRIORITY_OVERNIGHT
FedEx	fedex	FedEx Ground Economy AKA SmartPost	SMART_POST
FedEx	fedex	FedEx Standard Overnight	STANDARD_OVERNIGHT
PassportGlobal	passportglobal	Passport PriorityDdpDelcon
PassportGlobal	passportglobal	Passport Priority DDP
PassportGlobal	passportglobal	Passport ePacket DDP
PassportGlobal	passportglobal	Passport Express DDP
PassportGlobal	passportglobal	Passport Priority DDU Delcon
PassportGlobal	passportglobal	Passport Priority DDU

required

Array of objects (OrderLineItemRequest)

Items in the order. Each item must have a unique order_line_item_id.

Array of objects (OrderMetaAssetRequest)

Additional files associated with this order. For example, a pre-made shipping label used to ship the fulfillment package, a packing list that is to be included in a fulfillment package, etc.

location

string

Default: "teale"

Enum: "teale" "penn"

Teale is West Coast of USA; Penn is East Coast of USA
Setting the location on the order level assigns all order line items to the same location (no order splitting). For advanced integrations only.

Responses

Callbacks

Request samples

Payload

Content type

application/json

Example

case 1

{"test": false,
"pickup": false,
"shipping": {"full_name": "Jason Smith",
"first_name": "Jason",
"last_name": "Smith",
"company_name": "ABC Corp.",
"street": "123 Main St.",
"street_2": "string",
"street_3": "string",
"city": "Los Angeles",
"state": "CA",
"postcode": "90001",
"country": "US",
"email": "jsmith@example.com",
"phone": "3105551212"
},
"provider_order_id": "1",
"provider_order_date": "2019-08-24T14:15:22Z",
"provider_order_callback_url": "http://example.com",
"provider_sales_channel": "string",
"shipping_carrier": "usps",
"shipping_service": "string",
"order_line_items": [{"order_line_item_id": "string",
"product_title": "string",
"quantity": 0,
"sku": "string",
"item_spec": "string",
"preview_urls": "string",
"location": "teale",
"order_line_item_assets": [{"asset_type": "artwork",
"url": "http://example.com",
"ppi": 0
}
]
}
],
"order_meta_assets": [{"asset_type": "packing-list",
"url": "http://example.com",
"reference_id": "string"
}
],
"location": "teale"
}

Response samples

201
default

Content type

application/json

{"id": 0
}

Callback payload samples

Callback

POST: Callback for order status updates

Content type

application/json

{"type": "shipments.created",
"timestamp": "2019-08-24T14:15:22Z",
"data": {"shipments": [{"id": 0,
"title": "string",
"shipping_carrier": "usps",
"shipping_service": "ups-next-day-air",
"combine_packages": false,
"shipment_fulfillments": [{"id": 0,
"tracking_number": "string",
"tracking_url": "http://example.com",
"fulfillment": {"id": 0,
"title": "string",
"fulfillment_line_items": [{"id": 0,
"order_line_item_id": "string",
"quantity": 0
}
]
}
}
],
"order_id": 0,
"order_status": "processing",
"provider_order_id": "1",
"provider_order_number": "1"
}
]
},
"event": "shipments.created"
}

Get an Order

Authorizations:

apiKey

path Parameters

id

required

integer <int64>

ID of the order to retrieve

Responses

Response samples

200
default

Content type

application/json

Example

case 1

{"id": 0,
"test": false,
"pickup": false,
"order_number": "string",
"order_date": "2019-08-24T14:15:22Z",
"operational_date": "2019-08-24T14:15:22Z",
"ship_by_date": "2019-08-24T14:15:22Z",
"provider": "string",
"order_status": "processing",
"biller": {"id": 0,
"name": "string",
"title": "string"
},
"provider_order_id": "1",
"provider_order_date": "2019-08-24T14:15:22Z",
"provider_order_callback_url": "http://example.com",
"provider_sales_channel": "string",
"shipping": {"full_name": "Jason Smith",
"first_name": "Jason",
"last_name": "Smith",
"company_name": "ABC Corp.",
"street": "123 Main St.",
"street_2": "string",
"street_3": "string",
"city": "Los Angeles",
"state": "CA",
"postcode": "90001",
"country": "US",
"email": "jsmith@example.com",
"phone": "3105551212"
},
"order_meta_assets": [{"id": 0,
"asset_type": "packing-list",
"url": "http://example.com",
"reference_id": "string"
}
],
"order_line_items": [{"id": 0,
"product": 0,
"order_line_item_id": "string",
"product_title": "string",
"quantity": 0,
"sku": "string",
"item_spec": "string",
"preview_urls": "string",
"location": "teale",
"order_line_item_assets": [{"asset_type": "artwork",
"url": "http://example.com",
"ppi": 0
}
]
}
],
"fulfillment_orders": [{"id": 0,
"location": "teale",
"fulfillment_order_line_items": [{"id": 0,
"order_line_item": 0,
"quantity": 0,
"fulfillable_quantity": 0
}
],
"fulfillments": [{"id": 0,
"title": "string",
"fulfillment_line_items": [{"id": 0,
"fulfillment_order_line_item": 0,
"fulfillment_line_item_error": "artwork-not-printable",
"cancel": false,
"fulfillment_line_item_jobs": [{"id": 0,
"fulfillment_line_item_job_qc_status": "pass",
"fulfillment_line_item_job_qc_fail_reason": "defective-artwork-transfer"
}
]
}
],
"package_type": "string",
"fulfillment_status": "pending",
"ship_by_date": "2019-08-24T14:15:22Z",
"price": 0.1
}
],
"shipments": [{"id": 0,
"title": "string",
"shipping_carrier": "usps",
"shipping_service": "ups-next-day-air",
"combine_packages": false,
"shipment_fulfillments": [{"id": 0,
"tracking_number": "string",
"tracking_url": "http://example.com",
"fulfillment": {"id": 0,
"title": "string",
"fulfillment_line_items": [{"id": null,
"order_line_item_id": null,
"quantity": null
}
]
}
}
],
"order_id": 0,
"order_status": "processing",
"provider_order_id": "1",
"provider_order_number": "1"
}
]
}
],
"shipping_carrier": "usps",
"shipping_service": "string",
"location": "teale"
}

Update an Order

Authorizations:

apiKey

path Parameters

id

required

integer <int64>

ID of the order to update

Request Body schema: application/json
required

order_status	string Value: "canceled"
	object (Shipping) Where the order is to be shipped / the address of the end-customer.

Responses

Request samples

Payload

Content type

application/json

{"order_status": "canceled",
"shipping": {"full_name": "Jason Smith",
"first_name": "Jason",
"last_name": "Smith",
"company_name": "ABC Corp.",
"street": "123 Main St.",
"street_2": "string",
"street_3": "string",
"city": "Los Angeles",
"state": "CA",
"postcode": "90001",
"country": "US",
"email": "jsmith@example.com",
"phone": "3105551212"
}
}

Response samples

200
default

Content type

application/json

Example

case 1

{"id": 0,
"test": false,
"pickup": false,
"order_number": "string",
"order_date": "2019-08-24T14:15:22Z",
"operational_date": "2019-08-24T14:15:22Z",
"ship_by_date": "2019-08-24T14:15:22Z",
"provider": "string",
"order_status": "processing",
"biller": {"id": 0,
"name": "string",
"title": "string"
},
"provider_order_id": "1",
"provider_order_date": "2019-08-24T14:15:22Z",
"provider_order_callback_url": "http://example.com",
"provider_sales_channel": "string",
"shipping": {"full_name": "Jason Smith",
"first_name": "Jason",
"last_name": "Smith",
"company_name": "ABC Corp.",
"street": "123 Main St.",
"street_2": "string",
"street_3": "string",
"city": "Los Angeles",
"state": "CA",
"postcode": "90001",
"country": "US",
"email": "jsmith@example.com",
"phone": "3105551212"
},
"order_meta_assets": [{"id": 0,
"asset_type": "packing-list",
"url": "http://example.com",
"reference_id": "string"
}
],
"order_line_items": [{"id": 0,
"product": 0,
"order_line_item_id": "string",
"product_title": "string",
"quantity": 0,
"sku": "string",
"item_spec": "string",
"preview_urls": "string",
"location": "teale",
"order_line_item_assets": [{"asset_type": "artwork",
"url": "http://example.com",
"ppi": 0
}
]
}
],
"fulfillment_orders": [{"id": 0,
"location": "teale",
"fulfillment_order_line_items": [{"id": 0,
"order_line_item": 0,
"quantity": 0,
"fulfillable_quantity": 0
}
],
"fulfillments": [{"id": 0,
"title": "string",
"fulfillment_line_items": [{"id": 0,
"fulfillment_order_line_item": 0,
"fulfillment_line_item_error": "artwork-not-printable",
"cancel": false,
"fulfillment_line_item_jobs": [{"id": 0,
"fulfillment_line_item_job_qc_status": "pass",
"fulfillment_line_item_job_qc_fail_reason": "defective-artwork-transfer"
}
]
}
],
"package_type": "string",
"fulfillment_status": "pending",
"ship_by_date": "2019-08-24T14:15:22Z",
"price": 0.1
}
],
"shipments": [{"id": 0,
"title": "string",
"shipping_carrier": "usps",
"shipping_service": "ups-next-day-air",
"combine_packages": false,
"shipment_fulfillments": [{"id": 0,
"tracking_number": "string",
"tracking_url": "http://example.com",
"fulfillment": {"id": 0,
"title": "string",
"fulfillment_line_items": [{"id": null,
"order_line_item_id": null,
"quantity": null
}
]
}
}
],
"order_id": 0,
"order_status": "processing",
"provider_order_id": "1",
"provider_order_number": "1"
}
]
}
],
"shipping_carrier": "usps",
"shipping_service": "string",
"location": "teale"
}

Get Order Statuses (Bulk)

Get the status of multiple orders at once by providing an array of order IDs.

Authorizations:

apiKey

Request Body schema: application/json
required

order_ids

required

Array of integers <int64> [ items <int64 > ]

Array of order IDs to retrieve statuses for

Responses

Request samples

Payload

Content type

application/json

{"order_ids": [12345,
12346,
12347
]
}

Response samples

200
default

Content type

application/json

{"data": [{"id": 0,
"order_status": "string"
}
],
"meta": {"requested": 0,
"found": 0,
"not_found": [0
]
}
}

User

Get a User

Authorizations:

apiKey

Responses

Response samples

default

Content type

application/json

{"error": "Refresh Token expired. Please log in to start a new session.",
"error_code": "refresh_token_expired",
"devmessage": {"class": "string",
"code": 0,
"message": "string",
"location": "string",
"line": 0
}
}

POD Super System Endpoints (1.0.0)

Authentication

Preflight options

Authorizations:

Responses

Response samples

Get the current user

Authorizations:

Responses

Response samples

Login User

Authorizations:

Request Body schema: multipart/form-data

Responses

Response samples

Logout User

Authorizations:

Responses

Response samples

Preflight options

Authorizations:

Responses

Response samples

Renew access token. Only possible if the auth-type is Double JWT

Authorizations:

Responses

Response samples

Order

Create an Order

Authorizations:

Request Body schema: application/jsonrequired

Responses

Callbacks

Request samples

Response samples

Callback payload samples

Get an Order

Authorizations:

path Parameters

Responses

Response samples

Update an Order

Authorizations:

path Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Get Order Statuses (Bulk)

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

User

Get a User

Authorizations:

Responses

Response samples

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required