If you are an affiliate please see the Affiliate Documentation instead.

Name	Orders Create
Description	Create an Order (or Purchase Order).
Type	POST
URL	/v9/orders
Credential Type	API\|User

Please review our information on placing Test Orders in our Sandbox environment.

If you are using the Sandbox and testing the Braintree credit card integration you might want to look at their documentation for testing credit cards.

Order Types

Ticket Evolution has 3 types of orders and they are described below.

Most users utilizing this documentation need to create Buy/Sell orders. If you are unsure please ask.

Buy/Sell Order

This is where you create an order in which your Office is selling tickets to one of your Clients. Additionally, if the tickets are owned by another Office the system will create the corresponding purchase order to purchase the tickets from the Office that owns them. This is the type of order most Partners and websites should be creating.

Buy Order

This is a purchase order where your Office is purchasing tickets from another Office and there is no corresponding sale to a Client or anyone else. You might create a Buy Order if you are simply looking to purchase tickets to add to your own inventory.

Sell Order

This is a sale of your own inventory to one of your own Clients. This is typically only done via Core POS. If you are building a website you do not need to worry about checking whether your office owns the inventory or not and choosing between a Buy/Sell order or a Sell order, just use a Buy/Sell order and the system will be smart enough to know that no corresponding purchase order is necessary.

Parameters

Name	Description	Type	Presence	Other

Name	Description	Type	Presence	Other
`orders`	Array of orders to create. An array must be used even if creating just a single order. If you wish to create multiple orders at once it is recommended to you submit multiple POSTs instead of a larger `orders` array.	Array	Required
`check_fraud`	If you utilize our fraud prevention service (currently Riskified) and wish to skip the fraud check on this order only then pass in `false`.	Boolean	Optional

Orders Object Parameters

Name	Description	Type	Presence	Other

Name	Description	Type	Presence	Other
`billing_address_id`	The ID of a Client Address which should be recorded as their billing address for this order.	Integer	Optional
`buyer_id`	If you are creating a Buy (Purchase) Order the `buyer_id` is the ID of your Office.	Integer	Required for Buy Order (Purchase Order)
`client_id`	ID of the Client that is buying the tickets from your Office in a Buy/Sell order.	Integer	Required for Buy/Sell orders
`created_by_ip_address`	IP address of the buyer.	String	Required if using Fraud Protection
`discount`	Additional amount subtracted from the order to be labeled as Discount. (Positive value, but will have a negative effect on the order total.)	Decimal	Optional	Maximum 2 decimal places
`internal_notes`	Internal Notes will only be visible to the Office that created them. Using an Array of strings will create multiple Internal Notes.	String\|Array	Optional
`payments`	Array of Payments which will be applied to the order. An array must be used even if creating a single payment.	Array	Required
`promo_code`	The name of a promo code applied to an order. Does not automatically apply the discount, this is simply for your own logging purposes.	String	Optional
`reference_number`	Reference will only be visible to the Office that created them and is recommended for storing something such as a PO or Invoice number from another system. You can search this in CORE Reference filters on your Orders Search Page.	String	Optional
`seller_id`	If you are creating a Buy/Sell Order or a Sell Order the `seller_id` is the ID of your Office. If you are creating a Buy Order (Purchase Order) or a the `seller_id` may be omitted.	Integer	Required for Buy/Sell or Sell Orders
`service_fee`	Additional amount added to the order to be labeled as a Service Fee	Decimal	Optional	Maximum 2 decimal places
`session_id`	Session ID of the buyer. This should be a unique session of the buyer.	String	Required if using Fraud Protection.
`shipped_items`	Array of Shipped Items	Array	Required
`shipping`	Additional amount added to the order to be labeled as Shipping Cost. Shipments / Suggestion will return the pricing you have configured for a shipment method.	Decimal	Optional	Maximum 2 decimal places
`tax`	Additional amount added to the order to be labeled as Tax. If you are using Tax Quotes / Create to calculate the retail tax amount you can pass the retail tax amount here for record keeping.	Decimal	Optional	Maximum 2 decimal places
`tax_signature`	Unique identifier generated by Tax Quotes / Create to ensure consistency between your quote and your order.	UUID	Optional

Shipped Items Parameters

shipped_items is an array of shipment objects that include the items to be delivered via that shipment. (Despite being named "shipment" this can refer to uploading etickets or other fulfillment methods as well.)

For the parameters for a shipment object please see Shipments / Create.

Items Parameters

Name	Description	Type	Presence	Other

Name	Description	Type	Presence	Other
`id`	The `id` of an item from an existing order. When creating/replacing a shipment for an existing order each array element should be an object with a single property, `id`, with that value being the same as the`order_item_id` from the corresponding object within the `items` array of the order containing the ticket groups to be included in this shipment. e.g.: `"items": [{"id": 26117}]`	Integer	Required only when creating or updating a shipment for an existing order
`low_seat`	Lowest seat sold from the ticket group	Integer	Optional*
`quantity`	Quantity sold from the ticket group	Integer	Required
`seat_order`	`consecutive` or `odd_even`	String	Optional	Required when creating a purchase order in Core
`ticket_group`	For purchase orders, creates new inventory in the system. See Ticket Groups / Create or Example of Posting Purchase Orders with Multiple Shipments.	Hash	Optional	Required for purchase orders in Core
`ticket_group_id`	ID of the ticket group being sold	Integer	Required
`ticket_hold_id`	The ID returned from a Hold or Take call. If supplied, `quantity`, `price` and `low_seat` from the Hold/Take will be used. You may override the Hold/Take `price` by supplying a `price` value.	Integer	Required only if the tickets are Held or Taken

Payments Parameters

See Payments / Create

Internal Use Only Parameters

Substitutions

If an order is rejected by a TEvo Seller, there is a configuration on the API buyer's account for Buy / Sell orders to auto-cancel the customers order or not. If not, the API will allow for a substitute ticket to be created as a new purchase order, associated to the original via the same Orders / Create endpoint.
The two order links, original and new, will share an order group id.
Here is a link to a page the shows the calls that could be made to create a substitution purchase order: HOW TO: Process a Substitution via the API

Examples

All order types use the same endpoint, and the response to a successful request will be the order that was created.

Request	Response

Request	Response
`POST /v9/orders`	See Orders / Index