Create a simple saved order

POST

/api/v5/orders/create-simple

• Production

Creates a lightweight saved order from minimal fields (order_id, buyer and delivery details, goods summary). Returns the existing order if one already matches “order_id”; otherwise creates a new pending order and returns 201. Requires an API key.

Request Body

object

order_id

External order reference from the source platform; required.

string

nullable >= 1 characters

delivery_client_name

Delivery recipient name.

string

"" nullable

delivery_client_email

Delivery recipient email.

string

"" nullable

delivery_client_phone

Delivery recipient phone number.

string

"" nullable

delivery_client_address

Delivery recipient full address.

string

"" nullable

buyer_name

Name of the buyer who placed the order.

string

"" nullable

buyer_email

Email of the buyer who placed the order.

string

"" nullable

goods_summary

Short summary of the goods purchased.

string

"" nullable

imported_from

Source of the order import (e.g. “csv”, “shopify”); defaults to csv.

string

default: csv nullable

sale_price

Order sale price in AUD.

number

0 nullable

courier_price

Shipping price charged to the buyer, in AUD.

number

0 nullable

Responses

200

Existing saved order

object

id

required

Order record identifier.

number

transdirect_order_id

required

Linked Transdirect order id, if any.

number

nullable

transdirect_member_id

required

Member who owns the order.

number

transdirect_order_status

required

Current order status (e.g. “new”, “processing”, “completed”).

string

nullable

order_id

required

External order reference from the source platform.

string

nullable

goods_summary

required

Short summary of the goods purchased.

string

nullable

goods_dump

required

Raw serialised goods/line-item data from the source platform.

string

nullable

imported_from

required

Source of the order import (e.g. “shopify”, “csv”).

string

nullable

imported_time

required

Timestamp the order was imported (ISO 8601).

string

nullable

purchased_time

required

Timestamp the order was purchased (ISO 8601).

string

nullable

sale_price

required

Any of:

number

number

string

string

unknown

nullable

selected_courier

required

Courier string_id selected for the order.

string

nullable

courier_price

required

Any of:

number

number

string

string

unknown

nullable

paid_time

required

Timestamp the order was paid (ISO 8601).

string

nullable

buyer_name

required

Name of the buyer who placed the order.

string

nullable

buyer_email

required

Email of the buyer who placed the order.

string

nullable

delivery

required

Delivery recipient details for the order.

object

name

required

Delivery recipient name.

string

nullable

email

required

Delivery recipient email.

string

nullable

phone

required

Delivery recipient phone number.

string

nullable

address

required

Delivery recipient full address.

string

nullable

last_updated

required

Timestamp the order was last updated (ISO 8601).

string

nullable

201

Created simple saved order

object

id

required

Order record identifier.

number

transdirect_order_id

required

Linked Transdirect order id, if any.

number

nullable

transdirect_member_id

required

Member who owns the order.

number

transdirect_order_status

required

Current order status (e.g. “new”, “processing”, “completed”).

string

nullable

order_id

required

External order reference from the source platform.

string

nullable

goods_summary

required

Short summary of the goods purchased.

string

nullable

goods_dump

required

Raw serialised goods/line-item data from the source platform.

string

nullable

imported_from

required

Source of the order import (e.g. “shopify”, “csv”).

string

nullable

imported_time

required

Timestamp the order was imported (ISO 8601).

string

nullable

purchased_time

required

Timestamp the order was purchased (ISO 8601).

string

nullable

sale_price

required

Any of:

number

number

string

string

unknown

nullable

selected_courier

required

Courier string_id selected for the order.

string

nullable

courier_price

required

Any of:

number

number

string

string

unknown

nullable

paid_time

required

Timestamp the order was paid (ISO 8601).

string

nullable

buyer_name

required

Name of the buyer who placed the order.

string

nullable

buyer_email

required

Email of the buyer who placed the order.

string

nullable

delivery

required

Delivery recipient details for the order.

object

name

required

Delivery recipient name.

string

nullable

email

required

Delivery recipient email.

string

nullable

phone

required

Delivery recipient phone number.

string

nullable

address

required

Delivery recipient full address.

string

nullable

last_updated

required

Timestamp the order was last updated (ISO 8601).

string

nullable

400

Invalid simple order body

object

error

required

Human-readable error message describing why the order request failed.

string

401

Missing or invalid API key

500

Order create failed

object

error

required

Human-readable error message describing why the order request failed.

string