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.

Shipping can work in one of following ways:

Option 1: You provide the ship_by_date (Innovation Line will determine the shipping_carrier and shipping_service); recommended approach
Option 2: You provide the shipping_carrier, but not the shipping_service (Innovation Line will determine the shipping_service and ship_by_date)
Option 3: You provide both shipping_carrier and the shipping_service (Innovation Line will determine the ship_by_date)
Option 4: You don't provide any shipping information (Innovation Line will set the ship_by_date to 2 or 3 days depending on shipping agreement)

Authorizations:

apiKey

Request Body schema: application/json
required

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.

ship_by_date

string <date-time>

The date the order should be shipped by. Please use UTC.
Note: If the date is a Saturday or Sunday, it will be shipped the following Monday.

shipping_carrier

string

Enum: "usps" "ups" "fedex"

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
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	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	65
UPS	ups	UPS SurePost Less than 1lb	92
UPS	ups	UPS SurePost 1 lb or Greater	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

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 packing list that is to be included in a package.

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

{"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",
"ship_by_date": "2019-08-24T14:15:22Z",
"shipping_carrier": "usps",
"shipping_service": "string",
"order_line_items": [{"order_line_item_id": 0,
"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"
}
],
"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": "shipment.created",
"timestamp": "2019-08-24T14:15:22Z",
"data": {"id": 0,
"title": "string",
"shipping_service": "string",
"combine_packages": false,
"shipment_fulfillments": [{"id": 0,
"fulfillment": 0,
"tracking_number": "string",
"tracking_url": "http://example.com"
}
],
"order_id": 0,
"order_status": "processing"
},
"event": "shipment.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

{"id": 0,
"order_number": "string",
"order_date": "2019-08-24T14:15:22Z",
"provider": "string",
"order_status": "processing",
"biller": {"id": 0,
"name": "string",
"title": "string"
},
"timings": [{"id": 0,
"timing_type": "proceed-after",
"datetime": "2019-08-24T14:15:22Z"
}
],
"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-product"
}
]
}
],
"package": "string",
"fulfillment_status": "ready",
"ship_by_date": "2019-08-24T14:15:22Z",
"ship_by_date_2": "2019-08-24T14:15:22Z",
"price": 0.1
}
],
"shipments": [{"id": 0,
"title": "string",
"shipping_service": "string",
"combine_packages": false,
"shipment_fulfillments": [{"id": 0,
"fulfillment": 0,
"tracking_number": "string",
"tracking_url": "http://example.com"
}
]
}
]
}
],
"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",
"ship_by_date": "2019-08-24T14:15:22Z",
"shipping_carrier": "usps",
"shipping_service": "string",
"order_line_items": [{"order_line_item_id": 0,
"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"
}
],
"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

{"id": 0,
"order_number": "string",
"order_date": "2019-08-24T14:15:22Z",
"provider": "string",
"order_status": "processing",
"biller": {"id": 0,
"name": "string",
"title": "string"
},
"timings": [{"id": 0,
"timing_type": "proceed-after",
"datetime": "2019-08-24T14:15:22Z"
}
],
"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-product"
}
]
}
],
"package": "string",
"fulfillment_status": "ready",
"ship_by_date": "2019-08-24T14:15:22Z",
"ship_by_date_2": "2019-08-24T14:15:22Z",
"price": 0.1
}
],
"shipments": [{"id": 0,
"title": "string",
"shipping_service": "string",
"combine_packages": false,
"shipment_fulfillments": [{"id": 0,
"fulfillment": 0,
"tracking_number": "string",
"tracking_url": "http://example.com"
}
]
}
]
}
],
"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",
"ship_by_date": "2019-08-24T14:15:22Z",
"shipping_carrier": "usps",
"shipping_service": "string",
"order_line_items": [{"order_line_item_id": 0,
"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"
}
],
"location": "teale"
}

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

User

Get a User

Authorizations:

Responses

Response samples

Request Body schema: application/json
required

Request Body schema: application/json
required