For the complete documentation index, see llms.txt. This page is also available as Markdown.

Order Item

Get integration mapping types for the order item

get

Get integration mapping types for the order item

Authorizations
AuthorizationstringRequired
Responses
200

Integration mapping types successfully retrieved

application/json

Type of integration mapping

itemsstring · enumOptional

Type of integration mapping

Example: webPossible values:
get/api/v1/order_items/get_integration_mapping_types/

Get mappings for the order item

get

Get mappings for the order item with the specified ID

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Responses
200

Order item mappings successfully retrieved

application/json
created_datestring · date-timeRead-onlyOptional

The date and time when the object was created.

modified_datestring · date-timeOptional

The date and time when the object was last modified.

pkintegerRead-onlyOptional
content_typeintegerOptional

Associated content type id

object_idintegerOptional

Associated content type's object id value

content_objectobject · nullableOptional

Generic foreign key, handled dynamically

integration_typestring · enum · max: 20OptionalPossible values:
codestring · max: 499Optional

Code value of integration mapping

get/api/v1/order_items/{id}/get_mappings/

Get remote ID of an order item

get

Retrieve the remote ID of an order item with the specified ID

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Responses
200

Remote ID found successfully

application/json
order_idintegerOptionalExample: 123456
remote_idstringOptionalExample: 123456789
get/api/v1/order_items/{id}/get_remote_id/

Retrieve Order Item

get

Retrieve a specific Order Item by ID

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Responses
200

Order Item retrieved successfully

application/json
created_datestring · date-timeRead-onlyOptional

The date and time when the object was created.

modified_datestring · date-timeOptional

The date and time when the object was last modified.

attributesobjectOptional

A JSON object to store various attributes of the entity.

Example: {"key1":"value1","key2":"value2"}
attributes_kwargsobjectOptional

A JSON object to store additional attribute keyword arguments.

Example: {"key1":"value1","key2":"value2"}
localized_attributesobjectOptional

A JSON object to store localized attributes.

Example: {"name":{"en":"English","es":"Spanish"}}
localized_attributes_kwargsobjectOptional

A JSON object to store localized attributes keyword arguments.

Example: {"key":{"key1":"value1","key2":"value2"}}
pkinteger · int64Read-onlyRequired

Order Item ID

orderintegerRequired

Related order ID

Example: 1
productintegerRequired

Related product ID

Example: 1
price_listintegerOptional

Related price list ID

Example: 1
stock_listintegerOptional

Related stock list ID

Example: 1
statusstring · enumRequired

Status of the order item

Example: waitingPossible values:
price_currencystring · enumRequired

Currency type for the price list.

Example: tryPossible values:
pricenumber · decimalRequired

Price of the item

Example: 100
tax_ratenumber · decimalRequired

Tax rate of the item

Example: 18
shipping_companystring · enum · nullableOptional

Shipping company options

Example: yurticiPossible values:
shipment_codestring · nullableOptional

Shipment code for the item

cancel_statusstring · enum · nullableOptional

Cancellation status of the order item

Example: waitingPossible values:
is_tradablebooleanRead-onlyOptional

Indicates if the item is tradable

installment_interest_amountnumber · decimal · nullableOptional

Installment interest amount

datasourceinteger · nullableOptional

Related data source ID

cancellation_reconciliationinteger · nullableOptional

Related cancellation reconciliation ID

reconciliationinteger · nullableOptional

Related reconciliation ID

forced_refundboolean · nullableOptional

Indicates if refund is forced

original_stockinteger · nullableOptional

Original stock ID

shipping_option_groupinteger · nullableOptional

Related shipping option group ID

extra_fieldobject · nullableOptional

Extra field for additional data

get/api/v1/order_items/{id}/

Update Order Item

put

Update a specific Order Item by ID.

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Body
created_datestring · date-timeRead-onlyOptional

The date and time when the object was created.

modified_datestring · date-timeOptional

The date and time when the object was last modified.

attributesobjectOptional

A JSON object to store various attributes of the entity.

Example: {"key1":"value1","key2":"value2"}
attributes_kwargsobjectOptional

A JSON object to store additional attribute keyword arguments.

Example: {"key1":"value1","key2":"value2"}
localized_attributesobjectOptional

A JSON object to store localized attributes.

Example: {"name":{"en":"English","es":"Spanish"}}
localized_attributes_kwargsobjectOptional

A JSON object to store localized attributes keyword arguments.

Example: {"key":{"key1":"value1","key2":"value2"}}
pkinteger · int64Read-onlyRequired

Order Item ID

orderintegerRequired

Related order ID

Example: 1
productintegerRequired

Related product ID

Example: 1
price_listintegerOptional

Related price list ID

Example: 1
stock_listintegerOptional

Related stock list ID

Example: 1
statusstring · enumRequired

Status of the order item

Example: waitingPossible values:
price_currencystring · enumRequired

Currency type for the price list.

Example: tryPossible values:
pricenumber · decimalRequired

Price of the item

Example: 100
tax_ratenumber · decimalRequired

Tax rate of the item

Example: 18
shipping_companystring · enum · nullableOptional

Shipping company options

Example: yurticiPossible values:
shipment_codestring · nullableOptional

Shipment code for the item

cancel_statusstring · enum · nullableOptional

Cancellation status of the order item

Example: waitingPossible values:
is_tradablebooleanRead-onlyOptional

Indicates if the item is tradable

installment_interest_amountnumber · decimal · nullableOptional

Installment interest amount

datasourceinteger · nullableOptional

Related data source ID

cancellation_reconciliationinteger · nullableOptional

Related cancellation reconciliation ID

reconciliationinteger · nullableOptional

Related reconciliation ID

forced_refundboolean · nullableOptional

Indicates if refund is forced

original_stockinteger · nullableOptional

Original stock ID

shipping_option_groupinteger · nullableOptional

Related shipping option group ID

extra_fieldobject · nullableOptional

Extra field for additional data

Responses
200

Order Item updated

application/json
created_datestring · date-timeRead-onlyOptional

The date and time when the object was created.

modified_datestring · date-timeOptional

The date and time when the object was last modified.

attributesobjectOptional

A JSON object to store various attributes of the entity.

Example: {"key1":"value1","key2":"value2"}
attributes_kwargsobjectOptional

A JSON object to store additional attribute keyword arguments.

Example: {"key1":"value1","key2":"value2"}
localized_attributesobjectOptional

A JSON object to store localized attributes.

Example: {"name":{"en":"English","es":"Spanish"}}
localized_attributes_kwargsobjectOptional

A JSON object to store localized attributes keyword arguments.

Example: {"key":{"key1":"value1","key2":"value2"}}
pkinteger · int64Read-onlyRequired

Order Item ID

orderintegerRequired

Related order ID

Example: 1
productintegerRequired

Related product ID

Example: 1
price_listintegerOptional

Related price list ID

Example: 1
stock_listintegerOptional

Related stock list ID

Example: 1
statusstring · enumRequired

Status of the order item

Example: waitingPossible values:
price_currencystring · enumRequired

Currency type for the price list.

Example: tryPossible values:
pricenumber · decimalRequired

Price of the item

Example: 100
tax_ratenumber · decimalRequired

Tax rate of the item

Example: 18
shipping_companystring · enum · nullableOptional

Shipping company options

Example: yurticiPossible values:
shipment_codestring · nullableOptional

Shipment code for the item

cancel_statusstring · enum · nullableOptional

Cancellation status of the order item

Example: waitingPossible values:
is_tradablebooleanRead-onlyOptional

Indicates if the item is tradable

installment_interest_amountnumber · decimal · nullableOptional

Installment interest amount

datasourceinteger · nullableOptional

Related data source ID

cancellation_reconciliationinteger · nullableOptional

Related cancellation reconciliation ID

reconciliationinteger · nullableOptional

Related reconciliation ID

forced_refundboolean · nullableOptional

Indicates if refund is forced

original_stockinteger · nullableOptional

Original stock ID

shipping_option_groupinteger · nullableOptional

Related shipping option group ID

extra_fieldobject · nullableOptional

Extra field for additional data

put/api/v1/order_items/{id}/

Partial Update Order Item

patch

Partial update a specific Order Item by ID

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Body
created_datestring · date-timeRead-onlyOptional

The date and time when the object was created.

modified_datestring · date-timeOptional

The date and time when the object was last modified.

attributesobjectOptional

A JSON object to store various attributes of the entity.

Example: {"key1":"value1","key2":"value2"}
attributes_kwargsobjectOptional

A JSON object to store additional attribute keyword arguments.

Example: {"key1":"value1","key2":"value2"}
localized_attributesobjectOptional

A JSON object to store localized attributes.

Example: {"name":{"en":"English","es":"Spanish"}}
localized_attributes_kwargsobjectOptional

A JSON object to store localized attributes keyword arguments.

Example: {"key":{"key1":"value1","key2":"value2"}}
pkinteger · int64Read-onlyRequired

Order Item ID

orderintegerRequired

Related order ID

Example: 1
productintegerRequired

Related product ID

Example: 1
price_listintegerOptional

Related price list ID

Example: 1
stock_listintegerOptional

Related stock list ID

Example: 1
statusstring · enumRequired

Status of the order item

Example: waitingPossible values:
price_currencystring · enumRequired

Currency type for the price list.

Example: tryPossible values:
pricenumber · decimalRequired

Price of the item

Example: 100
tax_ratenumber · decimalRequired

Tax rate of the item

Example: 18
shipping_companystring · enum · nullableOptional

Shipping company options

Example: yurticiPossible values:
shipment_codestring · nullableOptional

Shipment code for the item

cancel_statusstring · enum · nullableOptional

Cancellation status of the order item

Example: waitingPossible values:
is_tradablebooleanRead-onlyOptional

Indicates if the item is tradable

installment_interest_amountnumber · decimal · nullableOptional

Installment interest amount

datasourceinteger · nullableOptional

Related data source ID

cancellation_reconciliationinteger · nullableOptional

Related cancellation reconciliation ID

reconciliationinteger · nullableOptional

Related reconciliation ID

forced_refundboolean · nullableOptional

Indicates if refund is forced

original_stockinteger · nullableOptional

Original stock ID

shipping_option_groupinteger · nullableOptional

Related shipping option group ID

extra_fieldobject · nullableOptional

Extra field for additional data

Responses
200

Order Item updated

application/json
created_datestring · date-timeRead-onlyOptional

The date and time when the object was created.

modified_datestring · date-timeOptional

The date and time when the object was last modified.

attributesobjectOptional

A JSON object to store various attributes of the entity.

Example: {"key1":"value1","key2":"value2"}
attributes_kwargsobjectOptional

A JSON object to store additional attribute keyword arguments.

Example: {"key1":"value1","key2":"value2"}
localized_attributesobjectOptional

A JSON object to store localized attributes.

Example: {"name":{"en":"English","es":"Spanish"}}
localized_attributes_kwargsobjectOptional

A JSON object to store localized attributes keyword arguments.

Example: {"key":{"key1":"value1","key2":"value2"}}
pkinteger · int64Read-onlyRequired

Order Item ID

orderintegerRequired

Related order ID

Example: 1
productintegerRequired

Related product ID

Example: 1
price_listintegerOptional

Related price list ID

Example: 1
stock_listintegerOptional

Related stock list ID

Example: 1
statusstring · enumRequired

Status of the order item

Example: waitingPossible values:
price_currencystring · enumRequired

Currency type for the price list.

Example: tryPossible values:
pricenumber · decimalRequired

Price of the item

Example: 100
tax_ratenumber · decimalRequired

Tax rate of the item

Example: 18
shipping_companystring · enum · nullableOptional

Shipping company options

Example: yurticiPossible values:
shipment_codestring · nullableOptional

Shipment code for the item

cancel_statusstring · enum · nullableOptional

Cancellation status of the order item

Example: waitingPossible values:
is_tradablebooleanRead-onlyOptional

Indicates if the item is tradable

installment_interest_amountnumber · decimal · nullableOptional

Installment interest amount

datasourceinteger · nullableOptional

Related data source ID

cancellation_reconciliationinteger · nullableOptional

Related cancellation reconciliation ID

reconciliationinteger · nullableOptional

Related reconciliation ID

forced_refundboolean · nullableOptional

Indicates if refund is forced

original_stockinteger · nullableOptional

Original stock ID

shipping_option_groupinteger · nullableOptional

Related shipping option group ID

extra_fieldobject · nullableOptional

Extra field for additional data

patch/api/v1/order_items/{id}/

Retrieve Order Item with details

get

Retrieve a specific Order Item by ID with details

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Responses
200

Order Item retrieved successfully with details

application/json
created_datestring · date-timeRead-onlyOptional

The date and time when the object was created.

modified_datestring · date-timeOptional

The date and time when the object was last modified.

attributesobjectOptional

A JSON object to store various attributes of the entity.

Example: {"key1":"value1","key2":"value2"}
attributes_kwargsobjectOptional

A JSON object to store additional attribute keyword arguments.

Example: {"key1":"value1","key2":"value2"}
localized_attributesobjectOptional

A JSON object to store localized attributes.

Example: {"name":{"en":"English","es":"Spanish"}}
localized_attributes_kwargsobjectOptional

A JSON object to store localized attributes keyword arguments.

Example: {"key":{"key1":"value1","key2":"value2"}}
pkinteger · int64Read-onlyOptional

Order Item ID

statusstring · enumOptional

Status of the order item

Example: waitingPossible values:
price_currencystring · enumOptional

Currency type for the price list.

Example: tryPossible values:
pricenumber · decimalOptional

Price of the item

Example: 100
tax_ratenumber · decimalOptional

Tax rate of the item

Example: 18
shipping_companystring · enum · nullableOptional

Shipping company options

Example: yurticiPossible values:
shipment_codestring · nullableOptional

Shipment code for the item

cancel_statusstring · enum · nullableOptional

Cancellation status of the order item

Example: waitingPossible values:
is_tradablebooleanRead-onlyOptional

Indicates if the item is tradable

installment_interest_amountnumber · decimal · nullableOptional

Installment interest amount

tracking_urlstring · uriRead-onlyOptional

Tracking URL for the item

forced_refundboolean · nullableOptional

Indicates if refund is forced

extra_fieldobject · nullableOptional

Extra field for additional data

get/api/v1/order_items/{id}/detailed/

Retrieve Order Item with details and integration mapping data

get

Retrieve a specific Order Item by ID with details and integration mapping data

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Responses
200

Order Item retrieved successfully with details and integration mapping data

application/json
created_datestring · date-timeRead-onlyOptional

The date and time when the object was created.

modified_datestring · date-timeOptional

The date and time when the object was last modified.

attributesobjectOptional

A JSON object to store various attributes of the entity.

Example: {"key1":"value1","key2":"value2"}
attributes_kwargsobjectOptional

A JSON object to store additional attribute keyword arguments.

Example: {"key1":"value1","key2":"value2"}
localized_attributesobjectOptional

A JSON object to store localized attributes.

Example: {"name":{"en":"English","es":"Spanish"}}
localized_attributes_kwargsobjectOptional

A JSON object to store localized attributes keyword arguments.

Example: {"key":{"key1":"value1","key2":"value2"}}
pkinteger · int64Read-onlyOptional

Order Item ID

statusstring · enumOptional

Status of the order item

Example: waitingPossible values:
price_currencystring · enumOptional

Currency type for the price list.

Example: tryPossible values:
pricenumber · decimalOptional

Price of the item

Example: 100
tax_ratenumber · decimalOptional

Tax rate of the item

Example: 18
shipping_companystring · enum · nullableOptional

Shipping company options

Example: yurticiPossible values:
shipment_codestring · nullableOptional

Shipment code for the item

cancel_statusstring · enum · nullableOptional

Cancellation status of the order item

Example: waitingPossible values:
is_tradablebooleanRead-onlyOptional

Indicates if the item is tradable

installment_interest_amountnumber · decimal · nullableOptional

Installment interest amount

tracking_urlstring · uriRead-onlyOptional

Tracking URL for the item

forced_refundboolean · nullableOptional

Indicates if refund is forced

extra_fieldobject · nullableOptional

Extra field for additional data

get/api/v1/order_items/{id}/detailed_integration/

Replace Product of Order Item

post

Replace Product of Order Item

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Body
new_product_skustringRequired

The sku of the new product to replace the current one.

Responses
200

Replaced Product of Order Item

application/json
created_datestring · date-timeRead-onlyOptional

The date and time when the object was created.

modified_datestring · date-timeOptional

The date and time when the object was last modified.

attributesobjectOptional

A JSON object to store various attributes of the entity.

Example: {"key1":"value1","key2":"value2"}
attributes_kwargsobjectOptional

A JSON object to store additional attribute keyword arguments.

Example: {"key1":"value1","key2":"value2"}
localized_attributesobjectOptional

A JSON object to store localized attributes.

Example: {"name":{"en":"English","es":"Spanish"}}
localized_attributes_kwargsobjectOptional

A JSON object to store localized attributes keyword arguments.

Example: {"key":{"key1":"value1","key2":"value2"}}
pkinteger · int64Read-onlyRequired

Order Item ID

orderintegerRequired

Related order ID

Example: 1
productintegerRequired

Related product ID

Example: 1
price_listintegerOptional

Related price list ID

Example: 1
stock_listintegerOptional

Related stock list ID

Example: 1
statusstring · enumRequired

Status of the order item

Example: waitingPossible values:
price_currencystring · enumRequired

Currency type for the price list.

Example: tryPossible values:
pricenumber · decimalRequired

Price of the item

Example: 100
tax_ratenumber · decimalRequired

Tax rate of the item

Example: 18
shipping_companystring · enum · nullableOptional

Shipping company options

Example: yurticiPossible values:
shipment_codestring · nullableOptional

Shipment code for the item

cancel_statusstring · enum · nullableOptional

Cancellation status of the order item

Example: waitingPossible values:
is_tradablebooleanRead-onlyOptional

Indicates if the item is tradable

installment_interest_amountnumber · decimal · nullableOptional

Installment interest amount

datasourceinteger · nullableOptional

Related data source ID

cancellation_reconciliationinteger · nullableOptional

Related cancellation reconciliation ID

reconciliationinteger · nullableOptional

Related reconciliation ID

forced_refundboolean · nullableOptional

Indicates if refund is forced

original_stockinteger · nullableOptional

Original stock ID

shipping_option_groupinteger · nullableOptional

Related shipping option group ID

extra_fieldobject · nullableOptional

Extra field for additional data

post/api/v1/order_items/{id}/replace_product/

Update order item send stock

post

Update order item send stock

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Responses
200

Updated order item send stock

application/json
created_datestring · date-timeRead-onlyOptional

The date and time when the object was created.

modified_datestring · date-timeOptional

The date and time when the object was last modified.

attributesobjectOptional

A JSON object to store various attributes of the entity.

Example: {"key1":"value1","key2":"value2"}
attributes_kwargsobjectOptional

A JSON object to store additional attribute keyword arguments.

Example: {"key1":"value1","key2":"value2"}
localized_attributesobjectOptional

A JSON object to store localized attributes.

Example: {"name":{"en":"English","es":"Spanish"}}
localized_attributes_kwargsobjectOptional

A JSON object to store localized attributes keyword arguments.

Example: {"key":{"key1":"value1","key2":"value2"}}
pkinteger · int64Read-onlyRequired

Order Item ID

orderintegerRequired

Related order ID

Example: 1
productintegerRequired

Related product ID

Example: 1
price_listintegerOptional

Related price list ID

Example: 1
stock_listintegerOptional

Related stock list ID

Example: 1
statusstring · enumRequired

Status of the order item

Example: waitingPossible values:
price_currencystring · enumRequired

Currency type for the price list.

Example: tryPossible values:
pricenumber · decimalRequired

Price of the item

Example: 100
tax_ratenumber · decimalRequired

Tax rate of the item

Example: 18
shipping_companystring · enum · nullableOptional

Shipping company options

Example: yurticiPossible values:
shipment_codestring · nullableOptional

Shipment code for the item

cancel_statusstring · enum · nullableOptional

Cancellation status of the order item

Example: waitingPossible values:
is_tradablebooleanRead-onlyOptional

Indicates if the item is tradable

installment_interest_amountnumber · decimal · nullableOptional

Installment interest amount

datasourceinteger · nullableOptional

Related data source ID

cancellation_reconciliationinteger · nullableOptional

Related cancellation reconciliation ID

reconciliationinteger · nullableOptional

Related reconciliation ID

forced_refundboolean · nullableOptional

Indicates if refund is forced

original_stockinteger · nullableOptional

Original stock ID

shipping_option_groupinteger · nullableOptional

Related shipping option group ID

extra_fieldobject · nullableOptional

Extra field for additional data

post/api/v1/order_items/{id}/update_order_item_send_stock/

Get tags of an Order Item

get

Retrieve tags associated with a specific Order Item by ID

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Responses
200

Tags retrieved successfully

application/json
string[]OptionalExample: tag1
get/api/v1/order_items/{id}/get_tags/

Add tags to an Order Item

post

Add tags to a specific Order Item by ID

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Body
keystringRequired

Tag key to add to the object.

Responses
200

Tags added successfully

No content

post/api/v1/order_items/{id}/add_tag/

No content

Add multiple tags to an Order Item

post

Add multiple tags to a specific Order Item by ID

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Body
keysstring[]Required

List of tag keys to add to the objects.

Responses
200

Tags added successfully

No content

post/api/v1/order_items/{id}/bulk_add_tag/

No content

Remove tags to an Order Item

post

Remove tags to a specific Order Item by ID

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Body
keystringRequired

Tag key to add to the object.

Responses
200

Tags removed successfully

No content

post/api/v1/order_items/{id}/remove_tag/

No content

Remove multiple tags to an Order Item

post

Remove multiple tags to a specific Order Item by ID

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Body
keysstring[]Required

List of tag keys to add to the objects.

Responses
200

Tags removed successfully

No content

post/api/v1/order_items/{id}/bulk_remove_tags/

No content

List order items with tag filtering

get

List all order items with the ability to filter by tags and other parameters. 'key' parameter is required in query param or body.

Authorizations
AuthorizationstringRequired
Query parameters
pageinteger · min: 1Optional

Specifies the page number of the current dataset

Default: 1
limitinteger · min: 1Optional

Indicates the number of rows on the current page.

Default: 10
idintegerOptional

Filters by id

created_datestring · date-timeOptional

Filter by creation date using supported lookup expressions (e.g., gt, gte, lt, lte, date__gt, etc.).

Example: created_date__gt=2024-01-01T00:00:00Z
modified_datestring · date-timeOptional

Filter by modification date using supported lookup expressions (e.g., gt, gte, lt, lte, date__gt, etc.).

Example: modified_date__lt=2024-01-01T00:00:00Z
attributesstringOptional

Filter by order item attributes

Example: attributes__color=blue
attributes_kwargsstringOptional

Filter by attributes using additional keyword arguments.

Example: attributes_kwargs__color=blue
localized_attributesstringOptional

Filter by localized attributes in JSON format.

Example: localized_attributes__locale=en-US
localized_attributes_kwargsstringOptional

Filter by localized attributes with additional keywords.

Example: localized_attributes_kwargs__locale=en-GB
ordernumberOptional

Filter by order ID.

Example: 123
productinteger · int64Optional

Filter by Product ID.

Example: 123
statusstring · enumOptional

Enum meanings:

  • 50 - Cancellation Waiting
  • 100 - Cancelled
  • 200 - Waiting
  • 300 - Payment Waiting
  • 350 - Confirmation Waiting
  • 400 - Approved
  • 450 - Preparing
  • 500 - Shipped
  • 510 - Shipped and Informed
  • 520 - Ready for Pickup
  • 540 - Attempted to Delivery
  • 544 - Review Started
  • 545 - Review Waiting
  • 546 - Waiting for Payment
  • 547 - Paid
  • 550 - Delivered
  • 600 - Refunded
Possible values:
price_currencystring · enumOptional

Currency type for the price list.

Example: tryPossible values:
pricenumber · decimalOptional

Filter by the product price.

Example: 120
tax_ratenumber · decimalOptional

Filter by Tax Rate.

Example: 18
invoice_numberstringOptional

Invoice number associated with the cancellation plan

Example: INV-123456
invoice_datestring · dateOptional

Date of the invoice associated with the cancellation plan

Example: 2024-01-01T00:00:00Z
e_archive_urlstringOptional

Filter by e-archive URL.

tracking_numberstringOptional

Tracking number (case-insensitive)

defined_tracking_urlstringOptional

Defined tracking URL (case-insensitive)

shipping_companystring · enumOptional

Shipping company options

Example: yurticiPossible values:
defined_shipping_companystringOptional

Filter by defined shipping company (case-insensitive).

retail_pricenumber · decimalOptional

Filter by Retail Price.

Example: 100
imagestringOptional

Filter by image.

parentintegerOptional

Filter by parent order item ID.

delivered_datestringOptional

Filter by delivered date.

Example: 2024-01-01
estimated_delivery_datestringOptional

Filter by estimated delivery date.

Example: 2024-01-01
shipped_datestringOptional

Filter by shipped date.

Example: 2024-01-01
price_listinteger · int64Optional

Filter by Price List ID.

Example: 2
stock_listinteger · int64Optional

Filter by Stock List ID.

Example: 2
external_statusintegerOptional

Filter by order external status ID

shipping_option_groupinteger · int64Optional

Filter by Shipping Option Group ID.

Example: 1
carrier_shipping_codestringOptional

Filter by carrier shipping code.

transactionsintegerOptional

Filter by Transaction ID.

Example: 1
funds_transactionsintegerOptional

Filter by Funds Transaction ID.

Example: 1
payondelivery_transactionsintegerOptional

Filter by Pay On Delivery Transaction ID.

Example: 1
b2b_transactionsintegerOptional

Filter by B2B Transaction ID.

Example: 1
loyalty_transactionsintegerOptional

Filter by Loyalty Transaction ID.

Example: 1
cashregister_transactionsintegerOptional

Filter by Cash Register Transaction ID.

Example: 1
reconciliationintegerOptional

Filter by Reconciliation ID.

Example: 1
cancellation_reconciliationintegerOptional

Filter by Cancellation Reconciliation ID.

Example: 1
cancel_statusstring · enumOptional

Filter by cancel status

Possible values:
forced_refundbooleanOptional

Filter by whether the order item has a forced refund.

Example: true
installment_interest_amountnumber · floatOptional

Filter by installment interest amount.

discount_amountnumber · decimalOptional

Filter by discount amount

datasourceintegerOptional

Filter by data source IDs.

original_stockintegerOptional

Filter by the original stock ID associated with the order item.

Example: 1
pkintegerOptional

Filters by primary key

pk__gtstringOptional

Filter by primary key greater than a specific value.

pk__gteintegerOptional

Filters by primary key greater than or equal to the given value

pk__ltintegerOptional

Filters by primary key less than the given value

pk__lteintegerOptional

Filters by primary key less than or equal to the given value

mappingintegerOptional

Filters by mapping id

transaction_idintegerOptional

Filter(exact) by transaction ID

Example: 0
order_idintegerOptional

Order ID

tagstringOptional

Filter by tag name.

tag__excludestringOptional

Exclude by tag name.

keystringOptional

Filter by key.

Body
keystringOptional

Tag to filter order items by.

Responses
200

Order items successfully listed

application/json
countintegerOptional

Total number of results.

nextstring · uri · nullableOptional

URL of the next page of results.

previousstring · uri · nullableOptional

URL of the previous page of results.

get/api/v1/order_items/filter_by_tag/

List order items with tag exclusion filtering

get

List all order items with the ability to exclude by tags and other parameters. 'key' parameter is required in query param or body.

Authorizations
AuthorizationstringRequired
Query parameters
pageinteger · min: 1Optional

Specifies the page number of the current dataset

Default: 1
limitinteger · min: 1Optional

Indicates the number of rows on the current page.

Default: 10
idintegerOptional

Filters by id

created_datestring · date-timeOptional

Filter by creation date using supported lookup expressions (e.g., gt, gte, lt, lte, date__gt, etc.).

Example: created_date__gt=2024-01-01T00:00:00Z
modified_datestring · date-timeOptional

Filter by modification date using supported lookup expressions (e.g., gt, gte, lt, lte, date__gt, etc.).

Example: modified_date__lt=2024-01-01T00:00:00Z
attributesstringOptional

Filter by order item attributes

Example: attributes__color=blue
attributes_kwargsstringOptional

Filter by attributes using additional keyword arguments.

Example: attributes_kwargs__color=blue
localized_attributesstringOptional

Filter by localized attributes in JSON format.

Example: localized_attributes__locale=en-US
localized_attributes_kwargsstringOptional

Filter by localized attributes with additional keywords.

Example: localized_attributes_kwargs__locale=en-GB
ordernumberOptional

Filter by order ID.

Example: 123
productinteger · int64Optional

Filter by Product ID.

Example: 123
statusstring · enumOptional

Enum meanings:

  • 50 - Cancellation Waiting
  • 100 - Cancelled
  • 200 - Waiting
  • 300 - Payment Waiting
  • 350 - Confirmation Waiting
  • 400 - Approved
  • 450 - Preparing
  • 500 - Shipped
  • 510 - Shipped and Informed
  • 520 - Ready for Pickup
  • 540 - Attempted to Delivery
  • 544 - Review Started
  • 545 - Review Waiting
  • 546 - Waiting for Payment
  • 547 - Paid
  • 550 - Delivered
  • 600 - Refunded
Possible values:
price_currencystring · enumOptional

Currency type for the price list.

Example: tryPossible values:
pricenumber · decimalOptional

Filter by the product price.

Example: 120
tax_ratenumber · decimalOptional

Filter by Tax Rate.

Example: 18
invoice_numberstringOptional

Invoice number associated with the cancellation plan

Example: INV-123456
invoice_datestring · dateOptional

Date of the invoice associated with the cancellation plan

Example: 2024-01-01T00:00:00Z
e_archive_urlstringOptional

Filter by e-archive URL.

tracking_numberstringOptional

Tracking number (case-insensitive)

defined_tracking_urlstringOptional

Defined tracking URL (case-insensitive)

shipping_companystring · enumOptional

Shipping company options

Example: yurticiPossible values:
defined_shipping_companystringOptional

Filter by defined shipping company (case-insensitive).

retail_pricenumber · decimalOptional

Filter by Retail Price.

Example: 100
imagestringOptional

Filter by image.

parentintegerOptional

Filter by parent order item ID.

delivered_datestringOptional

Filter by delivered date.

Example: 2024-01-01
estimated_delivery_datestringOptional

Filter by estimated delivery date.

Example: 2024-01-01
shipped_datestringOptional

Filter by shipped date.

Example: 2024-01-01
price_listinteger · int64Optional

Filter by Price List ID.

Example: 2
stock_listinteger · int64Optional

Filter by Stock List ID.

Example: 2
external_statusintegerOptional

Filter by order external status ID

shipping_option_groupinteger · int64Optional

Filter by Shipping Option Group ID.

Example: 1
carrier_shipping_codestringOptional

Filter by carrier shipping code.

transactionsintegerOptional

Filter by Transaction ID.

Example: 1
funds_transactionsintegerOptional

Filter by Funds Transaction ID.

Example: 1
payondelivery_transactionsintegerOptional

Filter by Pay On Delivery Transaction ID.

Example: 1
b2b_transactionsintegerOptional

Filter by B2B Transaction ID.

Example: 1
loyalty_transactionsintegerOptional

Filter by Loyalty Transaction ID.

Example: 1
cashregister_transactionsintegerOptional

Filter by Cash Register Transaction ID.

Example: 1
reconciliationintegerOptional

Filter by Reconciliation ID.

Example: 1
cancellation_reconciliationintegerOptional

Filter by Cancellation Reconciliation ID.

Example: 1
cancel_statusstring · enumOptional

Filter by cancel status

Possible values:
forced_refundbooleanOptional

Filter by whether the order item has a forced refund.

Example: true
installment_interest_amountnumber · floatOptional

Filter by installment interest amount.

discount_amountnumber · decimalOptional

Filter by discount amount

datasourceintegerOptional

Filter by data source IDs.

original_stockintegerOptional

Filter by the original stock ID associated with the order item.

Example: 1
pkintegerOptional

Filters by primary key

pk__gtstringOptional

Filter by primary key greater than a specific value.

pk__gteintegerOptional

Filters by primary key greater than or equal to the given value

pk__ltintegerOptional

Filters by primary key less than the given value

pk__lteintegerOptional

Filters by primary key less than or equal to the given value

mappingintegerOptional

Filters by mapping id

transaction_idintegerOptional

Filter(exact) by transaction ID

Example: 0
order_idintegerOptional

Order ID

tagstringOptional

Filter by tag name.

tag__excludestringOptional

Exclude by tag name.

keystringOptional

Exclude by key.

Body
keystringOptional

Tag to filter order items by.

Responses
200

Order items successfully listed

application/json
countintegerOptional

Total number of results.

nextstring · uri · nullableOptional

URL of the next page of results.

previousstring · uri · nullableOptional

URL of the previous page of results.

get/api/v1/order_items/exclude_by_tag/

Bulk add tags to order items

post

Bulk add tags to order items.

Authorizations
AuthorizationstringRequired
Body
objsinteger[]Required

List of object IDs to which tags will be added.

keysstring[]Required

List of tag keys to add to the objects.

Responses
200

Successfully added tags to order items

No content

post/api/v1/order_items/bulk_add_tags/

No content

Bulk remove tags from order items

post

Bulk remove tags from order items.

Authorizations
AuthorizationstringRequired
Body
objsinteger[]Required

List of object IDs to which tags will be added.

keysstring[]Required

List of tag keys to add to the objects.

Responses
200

Successfully removed tags from order items

No content

post/api/v1/order_items/bulk_remove_tags_with_many_instances/

No content

Reduce weight of Order Item

post

Reduce weight of Order Item

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Body
new_weightnumber · decimalRequired

The new weight value for the order item.

Responses
200

Reduced weight of Order Item

application/json
created_datestring · date-timeRead-onlyOptional

The date and time when the object was created.

modified_datestring · date-timeOptional

The date and time when the object was last modified.

attributesobjectOptional

A JSON object to store various attributes of the entity.

Example: {"key1":"value1","key2":"value2"}
attributes_kwargsobjectOptional

A JSON object to store additional attribute keyword arguments.

Example: {"key1":"value1","key2":"value2"}
localized_attributesobjectOptional

A JSON object to store localized attributes.

Example: {"name":{"en":"English","es":"Spanish"}}
localized_attributes_kwargsobjectOptional

A JSON object to store localized attributes keyword arguments.

Example: {"key":{"key1":"value1","key2":"value2"}}
pkinteger · int64Read-onlyRequired

Order Item ID

orderintegerRequired

Related order ID

Example: 1
productintegerRequired

Related product ID

Example: 1
price_listintegerOptional

Related price list ID

Example: 1
stock_listintegerOptional

Related stock list ID

Example: 1
statusstring · enumRequired

Status of the order item

Example: waitingPossible values:
price_currencystring · enumRequired

Currency type for the price list.

Example: tryPossible values:
pricenumber · decimalRequired

Price of the item

Example: 100
tax_ratenumber · decimalRequired

Tax rate of the item

Example: 18
shipping_companystring · enum · nullableOptional

Shipping company options

Example: yurticiPossible values:
shipment_codestring · nullableOptional

Shipment code for the item

cancel_statusstring · enum · nullableOptional

Cancellation status of the order item

Example: waitingPossible values:
is_tradablebooleanRead-onlyOptional

Indicates if the item is tradable

installment_interest_amountnumber · decimal · nullableOptional

Installment interest amount

datasourceinteger · nullableOptional

Related data source ID

cancellation_reconciliationinteger · nullableOptional

Related cancellation reconciliation ID

reconciliationinteger · nullableOptional

Related reconciliation ID

forced_refundboolean · nullableOptional

Indicates if refund is forced

original_stockinteger · nullableOptional

Original stock ID

shipping_option_groupinteger · nullableOptional

Related shipping option group ID

extra_fieldobject · nullableOptional

Extra field for additional data

post/api/v1/order_items/{id}/reduce_weight/

List order items

get

List all order items

Authorizations
AuthorizationstringRequired
Query parameters
pageinteger · min: 1Optional

Specifies the page number of the current dataset

Default: 1
limitinteger · min: 1Optional

Indicates the number of rows on the current page.

Default: 10
idintegerOptional

Filters by id

created_datestring · date-timeOptional

Filter by creation date using supported lookup expressions (e.g., gt, gte, lt, lte, date__gt, etc.).

Example: created_date__gt=2024-01-01T00:00:00Z
modified_datestring · date-timeOptional

Filter by modification date using supported lookup expressions (e.g., gt, gte, lt, lte, date__gt, etc.).

Example: modified_date__lt=2024-01-01T00:00:00Z
attributesstringOptional

Filter by order item attributes

Example: attributes__color=blue
attributes_kwargsstringOptional

Filter by attributes using additional keyword arguments.

Example: attributes_kwargs__color=blue
localized_attributesstringOptional

Filter by localized attributes in JSON format.

Example: localized_attributes__locale=en-US
localized_attributes_kwargsstringOptional

Filter by localized attributes with additional keywords.

Example: localized_attributes_kwargs__locale=en-GB
ordernumberOptional

Filter by order ID.

Example: 123
productinteger · int64Optional

Filter by Product ID.

Example: 123
statusstring · enumOptional

Enum meanings:

  • 50 - Cancellation Waiting
  • 100 - Cancelled
  • 200 - Waiting
  • 300 - Payment Waiting
  • 350 - Confirmation Waiting
  • 400 - Approved
  • 450 - Preparing
  • 500 - Shipped
  • 510 - Shipped and Informed
  • 520 - Ready for Pickup
  • 540 - Attempted to Delivery
  • 544 - Review Started
  • 545 - Review Waiting
  • 546 - Waiting for Payment
  • 547 - Paid
  • 550 - Delivered
  • 600 - Refunded
Possible values:
price_currencystring · enumOptional

Currency type for the price list.

Example: tryPossible values:
pricenumber · decimalOptional

Filter by the product price.

Example: 120
tax_ratenumber · decimalOptional

Filter by Tax Rate.

Example: 18
invoice_numberstringOptional

Invoice number associated with the cancellation plan

Example: INV-123456
invoice_datestring · dateOptional

Date of the invoice associated with the cancellation plan

Example: 2024-01-01T00:00:00Z
e_archive_urlstringOptional

Filter by e-archive URL.

tracking_numberstringOptional

Tracking number (case-insensitive)

defined_tracking_urlstringOptional

Defined tracking URL (case-insensitive)

shipping_companystring · enumOptional

Shipping company options

Example: yurticiPossible values:
defined_shipping_companystringOptional

Filter by defined shipping company (case-insensitive).

retail_pricenumber · decimalOptional

Filter by Retail Price.

Example: 100
imagestringOptional

Filter by image.

parentintegerOptional

Filter by parent order item ID.

delivered_datestringOptional

Filter by delivered date.

Example: 2024-01-01
estimated_delivery_datestringOptional

Filter by estimated delivery date.

Example: 2024-01-01
shipped_datestringOptional

Filter by shipped date.

Example: 2024-01-01
price_listinteger · int64Optional

Filter by Price List ID.

Example: 2
stock_listinteger · int64Optional

Filter by Stock List ID.

Example: 2
external_statusintegerOptional

Filter by order external status ID

shipping_option_groupinteger · int64Optional

Filter by Shipping Option Group ID.

Example: 1
carrier_shipping_codestringOptional

Filter by carrier shipping code.

transactionsintegerOptional

Filter by Transaction ID.

Example: 1
funds_transactionsintegerOptional

Filter by Funds Transaction ID.

Example: 1
payondelivery_transactionsintegerOptional

Filter by Pay On Delivery Transaction ID.

Example: 1
b2b_transactionsintegerOptional

Filter by B2B Transaction ID.

Example: 1
loyalty_transactionsintegerOptional

Filter by Loyalty Transaction ID.

Example: 1
cashregister_transactionsintegerOptional

Filter by Cash Register Transaction ID.

Example: 1
reconciliationintegerOptional

Filter by Reconciliation ID.

Example: 1
cancellation_reconciliationintegerOptional

Filter by Cancellation Reconciliation ID.

Example: 1
cancel_statusstring · enumOptional

Filter by cancel status

Possible values:
forced_refundbooleanOptional

Filter by whether the order item has a forced refund.

Example: true
installment_interest_amountnumber · floatOptional

Filter by installment interest amount.

discount_amountnumber · decimalOptional

Filter by discount amount

datasourceintegerOptional

Filter by data source IDs.

original_stockintegerOptional

Filter by the original stock ID associated with the order item.

Example: 1
pkintegerOptional

Filters by primary key

pk__gtstringOptional

Filter by primary key greater than a specific value.

pk__gteintegerOptional

Filters by primary key greater than or equal to the given value

pk__ltintegerOptional

Filters by primary key less than the given value

pk__lteintegerOptional

Filters by primary key less than or equal to the given value

mappingintegerOptional

Filters by mapping id

transaction_idintegerOptional

Filter(exact) by transaction ID

Example: 0
order_idintegerOptional

Order ID

tagstringOptional

Filter by tag name.

tag__excludestringOptional

Exclude by tag name.

Responses
200

Order items successfully listed

application/json
countintegerOptional

Total number of results.

nextstring · uri · nullableOptional

URL of the next page of results.

previousstring · uri · nullableOptional

URL of the previous page of results.

get/api/v1/order_items/

Create Order Item

post

Create Order Item

Authorizations
AuthorizationstringRequired
Body
created_datestring · date-timeRead-onlyOptional

The date and time when the object was created.

modified_datestring · date-timeOptional

The date and time when the object was last modified.

attributesobjectOptional

A JSON object to store various attributes of the entity.

Example: {"key1":"value1","key2":"value2"}
attributes_kwargsobjectOptional

A JSON object to store additional attribute keyword arguments.

Example: {"key1":"value1","key2":"value2"}
localized_attributesobjectOptional

A JSON object to store localized attributes.

Example: {"name":{"en":"English","es":"Spanish"}}
localized_attributes_kwargsobjectOptional

A JSON object to store localized attributes keyword arguments.

Example: {"key":{"key1":"value1","key2":"value2"}}
pkinteger · int64Read-onlyRequired

Order Item ID

orderintegerRequired

Related order ID

Example: 1
productintegerRequired

Related product ID

Example: 1
price_listintegerOptional

Related price list ID

Example: 1
stock_listintegerOptional

Related stock list ID

Example: 1
statusstring · enumRequired

Status of the order item

Example: waitingPossible values:
price_currencystring · enumRequired

Currency type for the price list.

Example: tryPossible values:
pricenumber · decimalRequired

Price of the item

Example: 100
tax_ratenumber · decimalRequired

Tax rate of the item

Example: 18
shipping_companystring · enum · nullableOptional

Shipping company options

Example: yurticiPossible values:
shipment_codestring · nullableOptional

Shipment code for the item

cancel_statusstring · enum · nullableOptional

Cancellation status of the order item

Example: waitingPossible values:
is_tradablebooleanRead-onlyOptional

Indicates if the item is tradable

installment_interest_amountnumber · decimal · nullableOptional

Installment interest amount

datasourceinteger · nullableOptional

Related data source ID

cancellation_reconciliationinteger · nullableOptional

Related cancellation reconciliation ID

reconciliationinteger · nullableOptional

Related reconciliation ID

forced_refundboolean · nullableOptional

Indicates if refund is forced

original_stockinteger · nullableOptional

Original stock ID

shipping_option_groupinteger · nullableOptional

Related shipping option group ID

extra_fieldobject · nullableOptional

Extra field for additional data

Responses
201

Order Item Created

application/json
created_datestring · date-timeRead-onlyOptional

The date and time when the object was created.

modified_datestring · date-timeOptional

The date and time when the object was last modified.

attributesobjectOptional

A JSON object to store various attributes of the entity.

Example: {"key1":"value1","key2":"value2"}
attributes_kwargsobjectOptional

A JSON object to store additional attribute keyword arguments.

Example: {"key1":"value1","key2":"value2"}
localized_attributesobjectOptional

A JSON object to store localized attributes.

Example: {"name":{"en":"English","es":"Spanish"}}
localized_attributes_kwargsobjectOptional

A JSON object to store localized attributes keyword arguments.

Example: {"key":{"key1":"value1","key2":"value2"}}
pkinteger · int64Read-onlyRequired

Order Item ID

orderintegerRequired

Related order ID

Example: 1
productintegerRequired

Related product ID

Example: 1
price_listintegerOptional

Related price list ID

Example: 1
stock_listintegerOptional

Related stock list ID

Example: 1
statusstring · enumRequired

Status of the order item

Example: waitingPossible values:
price_currencystring · enumRequired

Currency type for the price list.

Example: tryPossible values:
pricenumber · decimalRequired

Price of the item

Example: 100
tax_ratenumber · decimalRequired

Tax rate of the item

Example: 18
shipping_companystring · enum · nullableOptional

Shipping company options

Example: yurticiPossible values:
shipment_codestring · nullableOptional

Shipment code for the item

cancel_statusstring · enum · nullableOptional

Cancellation status of the order item

Example: waitingPossible values:
is_tradablebooleanRead-onlyOptional

Indicates if the item is tradable

installment_interest_amountnumber · decimal · nullableOptional

Installment interest amount

datasourceinteger · nullableOptional

Related data source ID

cancellation_reconciliationinteger · nullableOptional

Related cancellation reconciliation ID

reconciliationinteger · nullableOptional

Related reconciliation ID

forced_refundboolean · nullableOptional

Indicates if refund is forced

original_stockinteger · nullableOptional

Original stock ID

shipping_option_groupinteger · nullableOptional

Related shipping option group ID

extra_fieldobject · nullableOptional

Extra field for additional data

post/api/v1/order_items/

List order items with details

get

List all order items with details

Authorizations
AuthorizationstringRequired
Query parameters
pageinteger · min: 1Optional

Specifies the page number of the current dataset

Default: 1
limitinteger · min: 1Optional

Indicates the number of rows on the current page.

Default: 10
idintegerOptional

Filters by id

created_datestring · date-timeOptional

Filter by creation date using supported lookup expressions (e.g., gt, gte, lt, lte, date__gt, etc.).

Example: created_date__gt=2024-01-01T00:00:00Z
modified_datestring · date-timeOptional

Filter by modification date using supported lookup expressions (e.g., gt, gte, lt, lte, date__gt, etc.).

Example: modified_date__lt=2024-01-01T00:00:00Z
attributesstringOptional

Filter by order item attributes

Example: attributes__color=blue
attributes_kwargsstringOptional

Filter by attributes using additional keyword arguments.

Example: attributes_kwargs__color=blue
localized_attributesstringOptional

Filter by localized attributes in JSON format.

Example: localized_attributes__locale=en-US
localized_attributes_kwargsstringOptional

Filter by localized attributes with additional keywords.

Example: localized_attributes_kwargs__locale=en-GB
ordernumberOptional

Filter by order ID.

Example: 123
productinteger · int64Optional

Filter by Product ID.

Example: 123
statusstring · enumOptional

Enum meanings:

  • 50 - Cancellation Waiting
  • 100 - Cancelled
  • 200 - Waiting
  • 300 - Payment Waiting
  • 350 - Confirmation Waiting
  • 400 - Approved
  • 450 - Preparing
  • 500 - Shipped
  • 510 - Shipped and Informed
  • 520 - Ready for Pickup
  • 540 - Attempted to Delivery
  • 544 - Review Started
  • 545 - Review Waiting
  • 546 - Waiting for Payment
  • 547 - Paid
  • 550 - Delivered
  • 600 - Refunded
Possible values:
price_currencystring · enumOptional

Currency type for the price list.

Example: tryPossible values:
pricenumber · decimalOptional

Filter by the product price.

Example: 120
tax_ratenumber · decimalOptional

Filter by Tax Rate.

Example: 18
invoice_numberstringOptional

Invoice number associated with the cancellation plan

Example: INV-123456
invoice_datestring · dateOptional

Date of the invoice associated with the cancellation plan

Example: 2024-01-01T00:00:00Z
e_archive_urlstringOptional

Filter by e-archive URL.

tracking_numberstringOptional

Tracking number (case-insensitive)

defined_tracking_urlstringOptional

Defined tracking URL (case-insensitive)

shipping_companystring · enumOptional

Shipping company options

Example: yurticiPossible values:
defined_shipping_companystringOptional

Filter by defined shipping company (case-insensitive).

retail_pricenumber · decimalOptional

Filter by Retail Price.

Example: 100
imagestringOptional

Filter by image.

parentintegerOptional

Filter by parent order item ID.

delivered_datestringOptional

Filter by delivered date.

Example: 2024-01-01
estimated_delivery_datestringOptional

Filter by estimated delivery date.

Example: 2024-01-01
shipped_datestringOptional

Filter by shipped date.

Example: 2024-01-01
price_listinteger · int64Optional

Filter by Price List ID.

Example: 2
stock_listinteger · int64Optional

Filter by Stock List ID.

Example: 2
external_statusintegerOptional

Filter by order external status ID

shipping_option_groupinteger · int64Optional

Filter by Shipping Option Group ID.

Example: 1
carrier_shipping_codestringOptional

Filter by carrier shipping code.

transactionsintegerOptional

Filter by Transaction ID.

Example: 1
funds_transactionsintegerOptional

Filter by Funds Transaction ID.

Example: 1
payondelivery_transactionsintegerOptional

Filter by Pay On Delivery Transaction ID.

Example: 1
b2b_transactionsintegerOptional

Filter by B2B Transaction ID.

Example: 1
loyalty_transactionsintegerOptional

Filter by Loyalty Transaction ID.

Example: 1
cashregister_transactionsintegerOptional

Filter by Cash Register Transaction ID.

Example: 1
reconciliationintegerOptional

Filter by Reconciliation ID.

Example: 1
cancellation_reconciliationintegerOptional

Filter by Cancellation Reconciliation ID.

Example: 1
cancel_statusstring · enumOptional

Filter by cancel status

Possible values:
forced_refundbooleanOptional

Filter by whether the order item has a forced refund.

Example: true
installment_interest_amountnumber · floatOptional

Filter by installment interest amount.

discount_amountnumber · decimalOptional

Filter by discount amount

datasourceintegerOptional

Filter by data source IDs.

original_stockintegerOptional

Filter by the original stock ID associated with the order item.

Example: 1
pkintegerOptional

Filters by primary key

pk__gtstringOptional

Filter by primary key greater than a specific value.

pk__gteintegerOptional

Filters by primary key greater than or equal to the given value

pk__ltintegerOptional

Filters by primary key less than the given value

pk__lteintegerOptional

Filters by primary key less than or equal to the given value

mappingintegerOptional

Filters by mapping id

transaction_idintegerOptional

Filter(exact) by transaction ID

Example: 0
order_idintegerOptional

Order ID

tagstringOptional

Filter by tag name.

tag__excludestringOptional

Exclude by tag name.

Responses
200

Order items successfully listed

application/json
countintegerOptional

Total number of results.

nextstring · uri · nullableOptional

URL of the next page of results.

previousstring · uri · nullableOptional

URL of the previous page of results.

get/api/v1/order_items/detailed/

List order items with details with integration mapping data

get

List all order items with details with integration mapping data

Authorizations
AuthorizationstringRequired
Query parameters
pageinteger · min: 1Optional

Specifies the page number of the current dataset

Default: 1
limitinteger · min: 1Optional

Indicates the number of rows on the current page.

Default: 10
idintegerOptional

Filters by id

created_datestring · date-timeOptional

Filter by creation date using supported lookup expressions (e.g., gt, gte, lt, lte, date__gt, etc.).

Example: created_date__gt=2024-01-01T00:00:00Z
modified_datestring · date-timeOptional

Filter by modification date using supported lookup expressions (e.g., gt, gte, lt, lte, date__gt, etc.).

Example: modified_date__lt=2024-01-01T00:00:00Z
attributesstringOptional

Filter by order item attributes

Example: attributes__color=blue
attributes_kwargsstringOptional

Filter by attributes using additional keyword arguments.

Example: attributes_kwargs__color=blue
localized_attributesstringOptional

Filter by localized attributes in JSON format.

Example: localized_attributes__locale=en-US
localized_attributes_kwargsstringOptional

Filter by localized attributes with additional keywords.

Example: localized_attributes_kwargs__locale=en-GB
ordernumberOptional

Filter by order ID.

Example: 123
productinteger · int64Optional

Filter by Product ID.

Example: 123
statusstring · enumOptional

Enum meanings:

  • 50 - Cancellation Waiting
  • 100 - Cancelled
  • 200 - Waiting
  • 300 - Payment Waiting
  • 350 - Confirmation Waiting
  • 400 - Approved
  • 450 - Preparing
  • 500 - Shipped
  • 510 - Shipped and Informed
  • 520 - Ready for Pickup
  • 540 - Attempted to Delivery
  • 544 - Review Started
  • 545 - Review Waiting
  • 546 - Waiting for Payment
  • 547 - Paid
  • 550 - Delivered
  • 600 - Refunded
Possible values:
price_currencystring · enumOptional

Currency type for the price list.

Example: tryPossible values:
pricenumber · decimalOptional

Filter by the product price.

Example: 120
tax_ratenumber · decimalOptional

Filter by Tax Rate.

Example: 18
invoice_numberstringOptional

Invoice number associated with the cancellation plan

Example: INV-123456
invoice_datestring · dateOptional

Date of the invoice associated with the cancellation plan

Example: 2024-01-01T00:00:00Z
e_archive_urlstringOptional

Filter by e-archive URL.

tracking_numberstringOptional

Tracking number (case-insensitive)

defined_tracking_urlstringOptional

Defined tracking URL (case-insensitive)

shipping_companystring · enumOptional

Shipping company options

Example: yurticiPossible values:
defined_shipping_companystringOptional

Filter by defined shipping company (case-insensitive).

retail_pricenumber · decimalOptional

Filter by Retail Price.

Example: 100
imagestringOptional

Filter by image.

parentintegerOptional

Filter by parent order item ID.

delivered_datestringOptional

Filter by delivered date.

Example: 2024-01-01
estimated_delivery_datestringOptional

Filter by estimated delivery date.

Example: 2024-01-01
shipped_datestringOptional

Filter by shipped date.

Example: 2024-01-01
price_listinteger · int64Optional

Filter by Price List ID.

Example: 2
stock_listinteger · int64Optional

Filter by Stock List ID.

Example: 2
external_statusintegerOptional

Filter by order external status ID

shipping_option_groupinteger · int64Optional

Filter by Shipping Option Group ID.

Example: 1
carrier_shipping_codestringOptional

Filter by carrier shipping code.

transactionsintegerOptional

Filter by Transaction ID.

Example: 1
funds_transactionsintegerOptional

Filter by Funds Transaction ID.

Example: 1
payondelivery_transactionsintegerOptional

Filter by Pay On Delivery Transaction ID.

Example: 1
b2b_transactionsintegerOptional

Filter by B2B Transaction ID.

Example: 1
loyalty_transactionsintegerOptional

Filter by Loyalty Transaction ID.

Example: 1
cashregister_transactionsintegerOptional

Filter by Cash Register Transaction ID.

Example: 1
reconciliationintegerOptional

Filter by Reconciliation ID.

Example: 1
cancellation_reconciliationintegerOptional

Filter by Cancellation Reconciliation ID.

Example: 1
cancel_statusstring · enumOptional

Filter by cancel status

Possible values:
forced_refundbooleanOptional

Filter by whether the order item has a forced refund.

Example: true
installment_interest_amountnumber · floatOptional

Filter by installment interest amount.

discount_amountnumber · decimalOptional

Filter by discount amount

datasourceintegerOptional

Filter by data source IDs.

original_stockintegerOptional

Filter by the original stock ID associated with the order item.

Example: 1
pkintegerOptional

Filters by primary key

pk__gtstringOptional

Filter by primary key greater than a specific value.

pk__gteintegerOptional

Filters by primary key greater than or equal to the given value

pk__ltintegerOptional

Filters by primary key less than the given value

pk__lteintegerOptional

Filters by primary key less than or equal to the given value

mappingintegerOptional

Filters by mapping id

transaction_idintegerOptional

Filter(exact) by transaction ID

Example: 0
order_idintegerOptional

Order ID

tagstringOptional

Filter by tag name.

tag__excludestringOptional

Exclude by tag name.

Responses
200

Order items successfully listed

application/json
countintegerOptional

Total number of results.

nextstring · uri · nullableOptional

URL of the next page of results.

previousstring · uri · nullableOptional

URL of the previous page of results.

get/api/v1/order_items/detailed_integration/

Create mapping object for the order item

post

Create a mapping object for the order item with the specified ID

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Body
created_datestring · date-timeRead-onlyOptional

The date and time when the object was created.

modified_datestring · date-timeOptional

The date and time when the object was last modified.

pkintegerRead-onlyOptional
content_typeintegerOptional

Associated content type id

object_idintegerOptional

Associated content type's object id value

content_objectobject · nullableOptional

Generic foreign key, handled dynamically

integration_typestring · enum · max: 20OptionalPossible values:
codestring · max: 499Optional

Code value of integration mapping

Responses
200

Order item mapping object successfully created

application/json
created_datestring · date-timeRead-onlyOptional

The date and time when the object was created.

modified_datestring · date-timeOptional

The date and time when the object was last modified.

pkintegerRead-onlyOptional
content_typeintegerOptional

Associated content type id

object_idintegerOptional

Associated content type's object id value

content_objectobject · nullableOptional

Generic foreign key, handled dynamically

integration_typestring · enum · max: 20OptionalPossible values:
codestring · max: 499Optional

Code value of integration mapping

post/api/v1/order_items/{id}/create_mapping/

Update Extra Field of Order Item

patch

Update Extra Field of Order Item

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Body
extra_fieldobjectRequired

A JSON object containing extra fields for the order item.

Responses
200

Updated Extra Field of Order Item

application/json
created_datestring · date-timeRead-onlyOptional

The date and time when the object was created.

modified_datestring · date-timeOptional

The date and time when the object was last modified.

attributesobjectOptional

A JSON object to store various attributes of the entity.

Example: {"key1":"value1","key2":"value2"}
attributes_kwargsobjectOptional

A JSON object to store additional attribute keyword arguments.

Example: {"key1":"value1","key2":"value2"}
localized_attributesobjectOptional

A JSON object to store localized attributes.

Example: {"name":{"en":"English","es":"Spanish"}}
localized_attributes_kwargsobjectOptional

A JSON object to store localized attributes keyword arguments.

Example: {"key":{"key1":"value1","key2":"value2"}}
pkinteger · int64Read-onlyRequired

Order Item ID

orderintegerRequired

Related order ID

Example: 1
productintegerRequired

Related product ID

Example: 1
price_listintegerOptional

Related price list ID

Example: 1
stock_listintegerOptional

Related stock list ID

Example: 1
statusstring · enumRequired

Status of the order item

Example: waitingPossible values:
price_currencystring · enumRequired

Currency type for the price list.

Example: tryPossible values:
pricenumber · decimalRequired

Price of the item

Example: 100
tax_ratenumber · decimalRequired

Tax rate of the item

Example: 18
shipping_companystring · enum · nullableOptional

Shipping company options

Example: yurticiPossible values:
shipment_codestring · nullableOptional

Shipment code for the item

cancel_statusstring · enum · nullableOptional

Cancellation status of the order item

Example: waitingPossible values:
is_tradablebooleanRead-onlyOptional

Indicates if the item is tradable

installment_interest_amountnumber · decimal · nullableOptional

Installment interest amount

datasourceinteger · nullableOptional

Related data source ID

cancellation_reconciliationinteger · nullableOptional

Related cancellation reconciliation ID

reconciliationinteger · nullableOptional

Related reconciliation ID

forced_refundboolean · nullableOptional

Indicates if refund is forced

original_stockinteger · nullableOptional

Original stock ID

shipping_option_groupinteger · nullableOptional

Related shipping option group ID

extra_fieldobject · nullableOptional

Extra field for additional data

patch/api/v1/order_items/{id}/update_extra_field/

Split Order Item

post

Split Order Item

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Body
waiting_quantityinteger · min: 1Required

The quantity of items waiting to be split. Must be at least 1.

Responses
200

Split Order Item

application/json
created_datestring · date-timeRead-onlyOptional

The date and time when the object was created.

modified_datestring · date-timeOptional

The date and time when the object was last modified.

attributesobjectOptional

A JSON object to store various attributes of the entity.

Example: {"key1":"value1","key2":"value2"}
attributes_kwargsobjectOptional

A JSON object to store additional attribute keyword arguments.

Example: {"key1":"value1","key2":"value2"}
localized_attributesobjectOptional

A JSON object to store localized attributes.

Example: {"name":{"en":"English","es":"Spanish"}}
localized_attributes_kwargsobjectOptional

A JSON object to store localized attributes keyword arguments.

Example: {"key":{"key1":"value1","key2":"value2"}}
pkinteger · int64Read-onlyRequired

Order Item ID

orderintegerRequired

Related order ID

Example: 1
productintegerRequired

Related product ID

Example: 1
price_listintegerOptional

Related price list ID

Example: 1
stock_listintegerOptional

Related stock list ID

Example: 1
statusstring · enumRequired

Status of the order item

Example: waitingPossible values:
price_currencystring · enumRequired

Currency type for the price list.

Example: tryPossible values:
pricenumber · decimalRequired

Price of the item

Example: 100
tax_ratenumber · decimalRequired

Tax rate of the item

Example: 18
shipping_companystring · enum · nullableOptional

Shipping company options

Example: yurticiPossible values:
shipment_codestring · nullableOptional

Shipment code for the item

cancel_statusstring · enum · nullableOptional

Cancellation status of the order item

Example: waitingPossible values:
is_tradablebooleanRead-onlyOptional

Indicates if the item is tradable

installment_interest_amountnumber · decimal · nullableOptional

Installment interest amount

datasourceinteger · nullableOptional

Related data source ID

cancellation_reconciliationinteger · nullableOptional

Related cancellation reconciliation ID

reconciliationinteger · nullableOptional

Related reconciliation ID

forced_refundboolean · nullableOptional

Indicates if refund is forced

original_stockinteger · nullableOptional

Original stock ID

shipping_option_groupinteger · nullableOptional

Related shipping option group ID

extra_fieldobject · nullableOptional

Extra field for additional data

post/api/v1/order_items/{id}/split/

Create Order Item Easy Return Location

post

Create Order Item Easy Return Location

Authorizations
AuthorizationstringRequired
Path parameters
idintegerRequired

Unique identifier of the resource

Example: 1
Body
sourcestringRequired

The name of the source.

origin_addressstring · nullableOptional

The original address information.

origin_address_idstring · nullableOptional

The ID of the original address.

package_numberstring · nullableOptional

The package number.

Responses
200

Created Order Item Easy Return Location

application/json
created_datestring · date-timeRead-onlyOptional

The date and time when the object was created.

modified_datestring · date-timeOptional

The date and time when the object was last modified.

attributesobjectOptional

A JSON object to store various attributes of the entity.

Example: {"key1":"value1","key2":"value2"}
attributes_kwargsobjectOptional

A JSON object to store additional attribute keyword arguments.

Example: {"key1":"value1","key2":"value2"}
localized_attributesobjectOptional

A JSON object to store localized attributes.

Example: {"name":{"en":"English","es":"Spanish"}}
localized_attributes_kwargsobjectOptional

A JSON object to store localized attributes keyword arguments.

Example: {"key":{"key1":"value1","key2":"value2"}}
pkinteger · int64Read-onlyRequired

Order Item ID

orderintegerRequired

Related order ID

Example: 1
productintegerRequired

Related product ID

Example: 1
price_listintegerOptional

Related price list ID

Example: 1
stock_listintegerOptional

Related stock list ID

Example: 1
statusstring · enumRequired

Status of the order item

Example: waitingPossible values:
price_currencystring · enumRequired

Currency type for the price list.

Example: tryPossible values:
pricenumber · decimalRequired

Price of the item

Example: 100
tax_ratenumber · decimalRequired

Tax rate of the item

Example: 18
shipping_companystring · enum · nullableOptional

Shipping company options

Example: yurticiPossible values:
shipment_codestring · nullableOptional

Shipment code for the item

cancel_statusstring · enum · nullableOptional

Cancellation status of the order item

Example: waitingPossible values:
is_tradablebooleanRead-onlyOptional

Indicates if the item is tradable

installment_interest_amountnumber · decimal · nullableOptional

Installment interest amount

datasourceinteger · nullableOptional

Related data source ID

cancellation_reconciliationinteger · nullableOptional

Related cancellation reconciliation ID

reconciliationinteger · nullableOptional

Related reconciliation ID

forced_refundboolean · nullableOptional

Indicates if refund is forced

original_stockinteger · nullableOptional

Original stock ID

shipping_option_groupinteger · nullableOptional

Related shipping option group ID

extra_fieldobject · nullableOptional

Extra field for additional data

post/api/v1/order_items/{id}/easy_return_location/

Last updated

Was this helpful?