Order
Get Orders
GET
https://api.zortout.com/api.aspx
Get list of orders.
Query Parameters
Name | Type | Description |
---|---|---|
method* | String | “GETORDERS” |
warehousecode | String | Warehouse Code |
topaymentamount | Double | Maximum payment amount |
frompaymentamount | Double | Minimum payment amount |
toamount | Double | Maximum amount |
fromamount | Double | Minimum amount |
updatedatetimebefore | String | Updated Datetime Before ..... (yyyy-MM-dd HH:mm) |
updatedatetimeafter | String | Updated Datetime After ..... (yyyy-MM-dd HH:mm) |
createdatetimebefore | String | Created Datetime Before ..... (yyyy-MM-dd HH:mm) |
createdatetimeafter | String | Created Datetime After ..... (yyyy-MM-dd HH:mm) |
paymentbefore | String | Paid Date Before ..... (yyyy-MM-dd) |
paymentafter | String | Paid Date After ..... (yyyy-MM-dd) |
updatedbefore | String | Updated Date Before ..... (yyyy-MM-dd) |
updatedafter | String | Updated Date After ..... (yyyy-MM-dd) |
createdbefore | String | Created Date Before ..... (yyyy-MM-dd) |
createdafter | String | Created Date After ..... (yyyy-MM-dd) |
orderdatebefore | String | Order Date Before ..... (yyyy-MM-dd) |
orderdateafter | String | Order Date After ..... (yyyy-MM-dd) |
version* | String | 3 |
format | String | json (Default), xml |
saleschannel | String | Sales channel |
expirylot | Int | Show expiry lot status 0 - No (Default) 1 - Yes |
serialno | Int | Show serial no status 0 - No (Default) 1 - Yes |
paymentstatus | String | Payment status 0 - Pending 1 - Paid 2 - Voided 3 - Partial 4 - Overpaid Ex. "0,1,3,4" |
status | String | Status 0 - Pending 1 - Success 2 - Voided 3 - Waiting Ex. "0,1,3,4" |
createusername | String | Created by (Username) |
limit | Int | Limit per page (Max = 2000) |
page | Int | Page (Default = 1) |
keyword | String | Keyword to search |
Headers
Name | Type | Description |
---|---|---|
storename* | String | Store Name |
numberlist | String | List Of Order Number Ex. “SO-001,SO-002,SO-003” |
orderidlist | String | List Of Order ID Ex. “123,124,125” |
apisecret* | String | API Secret |
apikey* | String | API Key |
Parameter | Type | Description/Example |
---|---|---|
res | Response | Response Code 200- Success |
list | Order (Array) | Order List (Array) |
count | Int | Total order number by filter |
Order (Array) | Type | Description/Example |
---|---|---|
id | Int | Order ID |
number | String | Order Number |
customerid | Int | Customer ID |
customercode | String | Customer Code |
customername | String | Customer Name |
customeridnumber | String | Customer ID Number/Tax ID |
customeremail | String | Customer Email |
customerphone | String | Customer Phone |
customeraddress | String | Customer Address |
customerbranchname | String | Customer Branch Name |
customerbranchno | String | Customer Branch No |
status | String | Status (Pending, Waiting, Packed, Shipping, Success, Partial Transfer, Voided) |
paymentstatus | String | Payment Status (Pending, Paid, Partial Payment, Excess Payment) |
amount | Double | Net Amount |
vatamount | Double | Vat Amount |
shippingchannel | String | Shipping Channel |
shippingamount | Double | Shipping Amount |
shippingvat | Int | Shipping Vat Status 0 - No Shipping Vat 1 - Have Shipping Vat |
shippingdate | Date | Shipping Date |
shippingdateString | String | Shipping Date Text (yyyy-MM-dd) |
shippingname | String | Shipping Name |
shippingaddress | String | Shipping Address |
shippingphone | String | Shipping Phone |
shippingemail | String | Shipping Email |
trackingno | String | Tracking No |
orderdate | Date | Order Date |
orderdateString | String | Order Date Text (yyyy-MM-dd) |
paymentamount | Double | Payment Amount |
reference | String | Reference |
description | String | Description |
discount | String | Discount. Discount includes sellerdiscount and platformdiscount. Ex.5.00, 10% |
sellerdiscount | Double | Seller Discount |
platformdiscount | Double | Platform Discount. This discount is subsidized from Marketplace for buyer. (Ex. Lazada, Shopee, JDCentral) |
voucheramount | Double | Subsidized Amount from Marketplace for seller. |
discountamount | Double | Total summary of order discount. (Include discount and voucheramount). discountamount = discount - voucheramount discountamount = sellerdiscount + platformdiscount - voucheramount |
vattype | Int | Vat Type 1 – No Vat (Default) 2 – Exclude VAT 3 – Include VAT |
saleschannel | String | Sales Channel |
warehousecode | String | Warehouse Code |
list | OrderProduct (Array) | Product List |
totalproductamount | Double | Total Product Price of Product List |
payments | Payment (Array) | Payment List |
tag | String (Array) | Tag List (Array) |
createdatetime | Datetime | Created Datetime |
createdatetimeString | String | Created Datetime Text (yyyy-MM-dd HH:mm) |
updatedatetime | Datetime | Updated Datetime |
updatedatetimeString | String | Updated Datetime Text (yyyy-MM-dd HH:mm) |
expiredate | Date | Expired Date |
expiredateString | String | Expired Date Text (yyyy-MM-dd) |
createuserid | Int | Created User ID |
createusername | String | Created User (Username) |
createdby | String | Created User (Display name) |
isCOD | Boolean | COD Status |
integrationName | String | Integration Channel Name (Only Order from Integrated Channel.) |
integrationShop | String | Integration Shop Name (Only Order from Integrated Channel.) |
agent | Agent | Agent Detail |
uniquenumber | String | Unique Number |
properties | Property (Array) | Custom Properties List |
OrderProduct (Array) | Type | Description/Example |
---|---|---|
productid | Int | Product ID |
sku | String | Product Sku |
name | String | Product Name |
number | Double | Product Quantity |
unittext | String | Unit |
pricepernumber | Double | Product Price/Quantity |
discount | String | Discount Per Unit |
discountamount | Double | Total discount of product line. |
totalprice | Double | Total Price |
bundleid | Int (Nullable) | Bundle ID |
bundleitemid | Int (Nullable) | ID of bundle group in product line. |
bundlenumber | Double (Nullable) | Bundle Quantity |
bundleCode | String | Bundle Code/Sku |
bundleName | String | Bundle Name |
integrationItemId | String | Item Id of Integration. |
integrationVariantId | String | Variant Id of Integration. |
serialnolist | SerialNo (Array) | Serial no List |
expirylotlist | ExpiryLot (Array) | Expiry lot List |
Payment (Array) | Type | Description/Example |
---|---|---|
id | Int | Payment ID |
name | String | Payment Method Name |
amount | Double | Payment Amount |
paymentdatetime | Datetime | Payment Datetime |
paymentdatetimeString | String | Payment Datetime Text (yyyy-MM-dd HH:mm) |
SerialNo (Array) | Type | Description/Example |
---|---|---|
id | Int | Serial no ID |
name | String | Serial no Name |
ExpiryLot (Array) | Type | Description/Example |
---|---|---|
id | Int | Expiry lot ID |
name | String | Expiry lot Name |
number | Double | Expiry lot Quantity |
expiryDate | Date | Expired Date |
Agent | Type | Description/Example |
---|---|---|
id | Int | Agent ID |
name | String | Agent Name |
phone | String | Agent Phone |
String | Agent Email | |
address | String | Agent Address |
Property (Array) | Type | Description/Example |
---|---|---|
id | Int | Property ID |
name | String | Property Name |
value | String | Property Value |
Get Order Detail
GET
https://api.zortout.com/api.aspx
Get order detail.
Query Parameters
Name | Type | Description |
---|---|---|
method* | String | “GETORDERDETAIL” |
version* | String | 3 |
format | String | json (Default), xml |
id* | Int | Order ID |
Headers
Name | Type | Description |
---|---|---|
storename* | String | Store Name |
apisecret* | String | API Secret |
apikey* | String | API Key |
Parameter | Type | Description/Example |
---|---|---|
id | Int | Order ID |
number | String | Order Number |
customerid | Int | Customer ID |
customercode | String | Customer Code |
customername | String | Customer Name |
customeridnumber | String | Customer ID Number/Tax ID |
customeremail | String | Customer Email |
customerphone | String | Customer Phone |
customeraddress | String | Customer Address |
customerbranchname | String | Customer Branch Name |
customerbranchno | String | Customer Branch No |
status | String | Status (Pending, Waiting, Packed, Shipping, Success, Partial Transfer, Voided) |
paymentstatus | String | Payment Status (Pending, Paid, Partial Payment, Excess Payment) |
amount | Double | Net Amount |
vatamount | Double | Vat Amount |
shippingchannel | String | Shipping Channel |
shippingamount | Double | Shipping Amount |
shippingvat | Int | Shipping Vat Status 0 - No Shipping Vat 1 - Have Shipping Vat |
shippingdate | Date | Shipping Date |
shippingdateString | String | Shipping Date Text (yyyy-MM-dd) |
shippingname | String | Shipping Name |
shippingaddress | String | Shipping Address |
shippingphone | String | Shipping Phone |
shippingemail | String | Shipping Email |
trackingno | String | Tracking No |
orderdate | Date | Order Date |
orderdateString | String | Order Date Text (yyyy-MM-dd) |
paymentamount | Double | Payment Amount |
reference | String | Reference |
description | String | Description |
discount | String | Discount. Discount includes sellerdiscount and platformdiscount. Ex.5.00, 10% |
sellerdiscount | Double | Seller Discount |
platformdiscount | Double | Platform Discount. This discount is subsidized from Marketplace for buyer. (Ex. Lazada, Shopee, JDCentral) |
voucheramount | Double | Subsidized Amount from Marketplace for seller. |
discountamount | Double | Total summary of order discount. (Include discount and voucheramount). discountamount = discount - voucheramount discountamount = sellerdiscount + platformdiscount - voucheramount |
vattype | Int | Vat Type 1 – No Vat (Default) 2 – Exclude Vat 3 – Include Vat |
saleschannel | String | Sales Channel |
warehousecode | String | Warehouse Code |
list | OrderProduct (Array) | Product List |
totalproductamount | Double | Total Product Price of Product List |
payments | Payment (Array) | Payment List |
tag | String (Array) | Tag List (Array) |
createdatetime | Datetime | Created Datetime |
createdatetimeString | String | Created Datetime Text (yyyy-MM-dd HH:mm) |
updatedatetime | Datetime | Updated Datetime |
updatedatetimeString | String | Updated Datetime Text (yyyy-MM-dd HH:mm) |
expiredate | Date | Expired Date |
expiredateString | String | Expired Date Text (yyyy-MM-dd) |
createuserid | Int | Created User ID |
createusername | String | Created User (Username) |
createdby | String | Created User (Display name) |
isCOD | Boolean | COD Status |
integrationName | String | Integration Channel Name (Only Order from Integrated Channel.) |
integrationShop | String | Integration Shop Name (Only Order from Integrated Channel.) |
agent | Agent | Agent Detail |
uniquenumber | String | Unique Number |
properties | Property (Array) | Custom Properties List |
OrderProduct (Array) | Type | Description/Example |
---|---|---|
productid | Int | Product ID |
sku | String | Product Sku |
name | String | Product Name |
number | Double | Product Quantity |
unittext | String | Unit |
pricepernumber | Double | Product Price/Quantity |
discount | String | Discount Per Unit |
discountamount | Double | Total discount of product line. |
totalprice | Double | Total Price |
bundleid | Int (Nullable) | Bundle ID |
bundleitemid | Int (Nullable) | ID of bundle group in product line. |
bundlenumber | Double (Nullable) | Bundle Quantity |
bundleCode | String | Bundle Code/Sku |
bundleName | String | Bundle Name |
integrationItemId | String | Item Id of Integration. |
integrationVariantId | String | Variant Id of Integration. |
serialnolist | SerialNo (Array) | Serial no List |
expirylotlist | ExpiryLot (Array) | Expiry lot List |
Payment (Array) | Type | Description/Example |
---|---|---|
id | Int | Payment ID |
name | String | Payment Method Name |
amount | Double | Payment Amount |
paymentdatetime | Datetime | Payment Datetime |
paymentdatetimeString | String | Payment Datetime Text (yyyy-MM-dd HH:mm) |
SerialNo (Array) | Type | Description/Example |
---|---|---|
id | Int | Serial no ID |
name | String | Serial no Name |
ExpiryLot (Array) | Type | Description/Example |
---|---|---|
id | Int | Expiry lot ID |
name | String | Expiry lot Name |
number | Double | Expiry lot Quantity |
expiryDate | Date | Expired Date |
Agent | Type | Description/Example |
---|---|---|
id | Int | Agent ID |
name | String | Agent Name |
phone | String | Agent Phone |
String | Agent Email | |
address | String | Agent Address |
Property (Array) | Type | Description/Example |
---|---|---|
id | Int | Property ID |
name | String | Property Name |
value | String | Property Value |
Get Voucher Detail
GET
https://api.zortout.com/api.aspx
Get list of voucher subsidized by Marketplace.
Query Parameters
Name | Type | Description |
---|---|---|
method* | String | “GETVOUCHERDETAIL” |
id* | Int | Order ID |
version* | String | 3 |
format | String | json (Default), xml |
Headers
Name | Type | Description |
---|---|---|
apisecret* | String | API Secret |
storename* | String | Store Name |
apikey* | String | API Key |
Voucher (Array) | Type | Description/Example |
---|---|---|
id | Int | ID |
name | String | Voucher Name |
amount | Double | Amount |
Get Expense Order Detail
GET
https://api.zortout.com/api.aspx
Get list of expenses of order.
Query Parameters
Name | Type | Description |
---|---|---|
method* | String | “GETEXPENSEORDERDETAIL” |
id* | Int | Order ID |
version* | String | 3 |
format | String | json (Default), xml |
Headers
Name | Type | Description |
---|---|---|
apisecret* | String | API Secret |
storename* | String | Store Name |
apikey* | String | API Key |
Expense (Array) | Type | Description/Example |
---|---|---|
id | Int | ID |
name | String | Expense Name |
amount | Double | Amount |
paymentname | String | Payment Method Name |
paymentdatetime | Datetime | Payment Datetime |
paymentdatetimeString | String | Payment Datetime Text (yyyy-MM-dd HH:mm) |
isvat | Int | Vat Status 0 - No Vat 1 - Include Vat |
Get Movement Order Detail
GET
https://api.zortout.com/api.aspx
Get movement list of products according to each order.
Query Parameters
Name | Type | Description |
---|---|---|
method* | String | ““GETMOVEMENTORDERDETAIL” |
id* | Int | Order ID |
version* | String | 3 |
format | String | json (Default), xml |
Headers
Name | Type | Description |
---|---|---|
apisecret* | String | API Secret |
storename* | String | Store Name |
apikey* | String | API Key |
MovementOrder (Array) | Type | Description/Example |
---|---|---|
id | Int | ID |
list | OrderProduct (Array) | Movement List |
actionDate | Date (Array) | List of action date |
actionDateString | String (Array) | List of action date text (yyyy-MM-dd) |
orderid | Int | Order ID |
OrderProduct (Array) | Type | Description/Example |
---|---|---|
productid | Int | Product ID |
sku | String | Product Sku |
name | String | Product Name |
number | Double | Product Quantity |
unittext | String | Unit |
pricepernumber | Double | Product Price/Quantity |
discount | String | Discount Per Unit |
totalprice | Double | Total Price |
Get Movement Orders
GET
https://api.zortout.com/api.aspx
Get movement list of products for orders.
Query Parameters
Name | Type | Description |
---|---|---|
method* | String | “GETMOVEMENTORDERS” |
limit | Int | Limit per page (Max = 2000) |
page | Int | Page (Default = 1) |
warehousecode | String | Warehouse Code |
datebefore* | String | Date Before ..... (yyyy-MM-dd) |
dateafter* | String | Date After ..... (yyyy-MM-dd) |
version* | String | 3 |
format | String | json (Default), xml |
Headers
Name | Type | Description |
---|---|---|
apisecret* | String | API Secret |
storename* | String | Store Name |
apikey* | String | API Key |
Parameter | Type | Description/Example |
---|---|---|
res | Response | Response Code 200- Success |
list | MovementOrder (Array) | Movement Order List (Array) |
count | Int | Total movement order number by filter |
MovementOrder (Array) | Type | Description/Example |
---|---|---|
id | Int | ID |
list | OrderProduct (Array) | Movement List |
actionDate | Date (Array) | List of action date |
actionDateString | String (Array) | List of action date text (yyyy-MM-dd) |
orderid | Int | Order ID |
OrderProduct (Array) | Type | Description/Example |
---|---|---|
productid | Int | Product ID |
sku | String | Product Sku |
name | String | Product Name |
number | Double | Product Quantity |
unittext | String | Unit |
pricepernumber | Double | Product Price/Quantity |
discount | String | Discount Per Unit |
totalprice | Double | Total Price |
Get Shipment Labels
GET
https://api.zortout.com/api.aspx
Get shipment label list of orders.
Query Parameters
Name | Type | Description |
---|---|---|
method* | String | "GETSHIPMENTLABELS" |
version* | String | 3 |
format | String | json (Default), xml |
Headers
Name | Type | Description |
---|---|---|
storename* | String | Store Name |
orderidlist | String | List Of Order ID Ex. “123,124,125” |
apisecret* | String | API Secret |
apikey* | String | API Key |
numberlist | String | List Of Order Number Ex. “SO-001,SO-002,SO-003” |
ShipmentLabel (Array) | Type | Description/Example |
---|---|---|
linkurl | String | Url of Shipment Label |
type | String | Type of Shipment Label. Ex. "general, lazada, shopee, jdcentral, tiktok, flashexpress, jtexpress, kerry, shopeeexpress" |
list | Int (Array) | List Of Order ID |
Add Order
POST
https://api.zortout.com/api.aspx
Add order.
Query Parameters
Name | Type | Description |
---|---|---|
method* | String | “ADDORDER” |
link | Int | Link to generate. 0 – None (Default) 1 – Share link |
uniquenumber | String | Unique Number. This value is unique and used to prevent duplicate transaction. |
version* | String | 3 |
format | String | json (Default), xml |
Headers
Name | Type | Description |
---|---|---|
storename* | String | Store Name |
apikey* | String | API Key |
apisecret* | String | API Secret |
Request Body
Name | Type | Description |
---|---|---|
number* | String | Order Number |
vatamount | Double | Vat Amount |
amount* | Double | Net Amount |
status | String | Status (Pending,Success) Default - Pending |
reference | String | Reference |
customeraddress | String | Customer Address |
customerphone | String | Customer Phone |
customeremail | String | Customer Email |
customeridnumber | String | Customer ID Number/Tax ID |
customername | String | Customer Name |
shippingaddress | String | Shipping Address |
shippingname | String | Shipping Name |
shippingdate | String | Shipping Date Ex. “2021-09-15” |
shippingvat | Int | Shipping Vat Status 0 - No Shipping Vat (Default) 1 – Have Shipping Vat |
shippingamount | Double | Shipping Amount |
shippingchannel | String | Shipping Channel |
trackingno | String | Tracking No |
shippingemail | String | Shipping Email |
shippingphone | String | Shipping Phone |
paymentamount | Double | Payment Amount ("paymentmethod" must be required.) |
paymentmethod | String | Payment Method |
orderdate | String | Order Date Ex. "2021-09-15" |
∟ sku* | String | Product Sku |
list | OrderProduct (Array) | Product List |
warehousecode | String | Warehouse Code |
saleschannel | String | Sales Channel |
discount | String | Discount Ex. 5.00, 10% |
description | String | Description |
paymentdate | String | Payment Datetime Ex. “2021-09-15 21:05” |
∟ totalprice* | Double | Total Price |
∟ discount | String | Discount Per Unit |
∟ pricepernumber* | Double | Product Price/Quantity |
∟ name* | String | Product Name |
∟ number* | Double | Product Quantity |
tag | String (Array) | Tag List (Array) |
vattype | Int | Vat Type 1 – No Vat 2 – Exclude Vat 3 – Include Vat If vattype is not defined, the system will use vatamount to calculate and define automatically. If vattype = 1, 2 or 3, the system will ignore vatamount and calculate vatamount value automatically. |
isCOD | Boolean | COD Status |
customerbranchname | String | Customer Branch Name |
customerbranchno | String | Customer Branch No |
customercode | String | Customer Code |
agent | Agent | Agent Detail |
∟ name | String | Agent Name |
∟ phone | String | Agent Phone |
String | Agent Email | |
∟ address | String | Agent Address |
expiredate | String | Expired Date Ex. "2021-09-15" |
properties | Property (Array) | Custom Properties List |
∟ id | Int | Property ID *Must have either id or name |
∟ value | String | Property Value |
∟ name | String | Property Name Require if id = 0 or null *Must have either id or name |
Parameter | Type | Description/Example |
---|---|---|
resCode | String | Response Code 200- Success |
resDesc | String | Response Description |
Update Order Status
POST
https://api.zortout.com/api.aspx
Update status of order.
Query Parameters
Name | Type | Description |
---|---|---|
method* | String | “UPDATEORDERSTATUS” |
status | Int | 1 = Success (Default) 3 = Waiting 6 = Shipping |
warehousecode | String | Warehouse Code |
number | String | Order Number Require if id = 0 or null *Must have either id or number |
id | Int | Order ID *Must have either id or number |
version* | String | 3 |
format | String | json (Default), xml |
Headers
Name | Type | Description |
---|---|---|
apisecret* | String | API Secret |
storename* | String | Store Name |
apikey* | String | API Key |
Parameter | Type | Description/Example |
---|---|---|
resCode | String | Response Code 200- Success |
resDesc | String | Response Description |
Update Order Payment
POST
https://api.zortout.com/api.aspx
Update payment of order.
Query Parameters
Name | Type | Description |
---|---|---|
method* | String | “UPDATEORDERPAYMENT” |
verifyslipid | Int | Verify Slip ID |
paymentdate | String | Payment Datetime Ex. “2021-09-15 21:05” |
paymentamount* | Double | Payment Amount |
paymentmethod* | String | Payment Method |
number | String | Order Number Require if id = 0 or null *Must have either id or number |
id | Int | Order ID *Must have either id or number |
version* | String | 3 |
format | String | json (Default), xml |
Headers
Name | Type | Description |
---|---|---|
apisecret* | String | API Secret |
storename* | String | Store Name |
apikey* | String | API Key |
Parameter | Type | Description/Example |
---|---|---|
resCode | String | Response Code 200- Success |
resDesc | String | Response Description |
Verify Slip
POST
https://api.zortout.com/api.aspx
Verify slip of order.
Path Parameters
Name | Type | Description |
---|---|---|
method* | String | “VERIFYORDERSLIP” |
id | Int | Order ID *Must have either id or number |
version* | String | 3 |
format | String | json (Default), xml |
filename* | String | File Name |
number | String | Order Number Require if id = 0 or null *Must have either id or number |
Query Parameters
Name | Type | Description |
---|---|---|
method* | String | “VERIFYORDERSLIP” |
filename* | String | File Name |
number | String | Order Number Require if id = 0 or null *Must have either id or number |
id | Int | Order ID *Must have either id or number |
version* | String | 3 |
format | String | json (Default), xml |
Headers
Name | Type | Description |
---|---|---|
storename* | String | Store Name |
apisecret* | String | API Secret |
apikey* | String | API Key |
Request Body
Name | Type | Description |
---|---|---|
file* | File | File Binary Data |
Parameter | Type | Description/Example |
---|---|---|
resCode | String | Response Code 200- Success |
resDesc | String | Response Description |
Update Partial Order
POST
https://api.zortout.com/api.aspx
Update partial product of order.
Query Parameters
Name | Type | Description |
---|---|---|
method* | String | "UPDATEPARTIALORDER" |
number | String | Order Number Require if id = 0 or null *Must have either id or number |
id | Int | Order ID *Must have either id or number |
version* | String | 3 |
format | String | json (Default), xml |
Headers
Name | Type | Description |
---|---|---|
storename* | String | Store Name |
apikey* | String | API Key |
apisecret* | String | API Secret |
Request Body
Name | Type | Description |
---|---|---|
OrderProduct (Array) | Product List | |
∟ productid | Int | Product ID *Must have either productid or sku |
∟ sku | String | Product Sku Require if productid = 0 or null *Must have either productid or sku |
∟ number* | Double | Product Quantity |
Parameter | Type | Description/Example |
---|---|---|
resCode | String | Response Code 200- Success |
resDesc | String | Response Description |
Edit Order Info
POST
https://api.zortout.com/api.aspx
Edit order info.
Query Parameters
Name | Type | Description |
---|---|---|
method* | String | “EDITORDERINFO” |
number | String | Order Number Require if id = 0 or null *Must have either id or number |
id | Int | Order ID *Must have either id or number |
version* | String | 3 |
format | String | json (Default), xml |
Headers
Name | Type | Description |
---|---|---|
apisecret* | String | API Secret |
storename* | String | Store Name |
apikey* | String | API Key |
Request Body
Name | Type | Description |
---|---|---|
number | String | Order Number |
trackingno | String | Tracking No |
shippingemail | String | Shipping Email |
shippingphone | String | Shipping Phone |
shippingaddress | String | Shipping Address |
shippingname | String | Shipping Name |
shippingdate | String | Shipping Date Ex. “2021-09-15” |
shippingchannel | String | Shipping Channel |
customeraddress | String | Customer Address |
customerphone | String | Customer Phone |
customeremail | String | Customer Email |
customeridnumber | String | Customer ID Number/Tax ID |
customername | String | Customer Name |
orderdate | String | Order Date Ex. “2021-09-15” |
tag | String (Array) | Tag List (Array) |
saleschannel | String | Sales Channel |
description | String | Description |
customercode | String | Customer Code |
customerbranchno | String | Customer Branch No |
customerbranchname | String | Customer Branch Name |
agent | Agent | Agent Detail |
String | Agent Email | |
∟ phone | String | Agent Phone |
∟ name | String | Agent Name |
∟ address | String | Agent Address |
expiredate | String | Expired Date Ex. “2021-09-15” |
reference | String | Reference |
Parameter | Type | Description/Example |
---|---|---|
resCode | String | Response Code 200- Success |
resDesc | String | Response Description |
Edit Order
POST
https://api.zortout.com/api.aspx
Edit order.
Query Parameters
Name | Type | Description |
---|---|---|
method* | String | “EDITORDER” |
number | String | Order Number Require if id = 0 or null *Must have either id or number |
id | Int | Order ID *Must have either id or number |
version* | String | 3 |
format | String | json (Default), xml |
Headers
Name | Type | Description |
---|---|---|
storename* | String | Store Name |
apisecret* | String | API Secret |
apikey* | String | API Key |
Request Body
Name | Type | Description |
---|---|---|
number | String | Order Number |
shippingname | String | Shipping Name |
shippingdate | String | Shipping Date Ex. “2021-09-15” |
shippingchannel | String | Shipping Channel |
customerbranchno | String | Customer Branch No |
customerbranchname | String | Customer Branch Name |
customeraddress | String | Customer Address |
customerphone | String | Customer Phone |
customeremail | String | Customer Email |
customeridnumber | String | Customer ID Number/Tax ID |
customername | String | Customer Name |
customercode | String | Customer Code |
saleschannel | String | Sales Channel |
description | String | Description |
reference | String | Reference |
expiredate | String | Expired Date Ex. “2021-09-15” |
orderdate | String | Order Date Ex. “2021-09-15” |
trackingno | String | Tracking No |
shippingemail | String | Shipping Email |
shippingphone | String | Shipping Phone |
shippingaddress | String | Shipping Address |
∟ address | String | Agent Address |
String | Agent Email | |
∟ phone | String | Agent Phone |
∟ name | String | Agent Name |
agent | Agent | Agent Detail |
tag | String (Array) | Tag List (Array) |
discount | String | Discount Ex. 5.00, 10% |
shippingvat | Int | Shipping Vat Status 0 - No Shipping Vat (Default) 1 – Have Shipping Vat |
shippingamount | Double | Shipping Amount |
vattype | Int | Vat Type 1 – No Vat 2 – Exclude Vat 3 – Include Vat If vattype is not defined, the system will use vatamount to calculate and define automatically. If vattype = 1, 2 or 3, the system will ignore vatamount and calculate vatamount value automatically. |
vatamount | Double | Vat Amount |
amount* | Double | Net Amount |
∟ number* | Double | Product Quantity |
∟ name* | String | Product Name |
∟ sku* | String | Product Sku |
list | OrderProduct (Array) | Product List |
∟ totalprice* | Double | Total Price |
∟ discount | String | Discount Per Unit |
∟ pricepernumber* | Double | Product Price/Quantity |
Parameter | Type | Description/Example |
---|---|---|
resCode | String | Response Code 200- Success |
resDesc | String | Response Description |
Void Order
POST
https://api.zortout.com/api.aspx
Void order.
Query Parameters
Name | Type | Description |
---|---|---|
method* | String | “VOIDORDER” |
number | String | Order Number Require if id = 0 or null *Must have either id or number |
id | Int | Order ID *Must have either id or number |
version* | String | 3 |
format | String | json (Default), xml |
Headers
Name | Type | Description |
---|---|---|
apisecret* | String | API Secret |
storename* | String | Store Name |
apikey* | String | API Key |
Parameter | Type | Description/Example |
---|---|---|
resCode | String | Response Code 200- Success |
resDesc | String | Response Description |
Void Order Payment
POST
https://api.zortout.com/api.aspx
Delete payment in order.
Query Parameters
Name | Type | Description |
---|---|---|
method* | String | “VOIDORDERPAYMENT” |
paymentid* | Int | Payment ID |
number | String | Order Number Require if id = 0 or null *Must have either id or number |
id | Int | Order ID *Must have either id or number |
version* | String | 3 |
format | String | json (Default), xml |
Headers
Name | Type | Description |
---|---|---|
storename* | String | Store Name |
apikey* | String | API Key |
apisecret* | String | API Secret |
Parameter | Type | Description/Example |
---|---|---|
resCode | String | Response Code 200- Success |
resDesc | String | Response Description |
Ready To Ship
POST
https://api.zortout.com/api.aspx
Ready to ship. The status will be changed to “Waiting”. If the order is from marketplace, the system will try to update order in marketplace to “Ready to ship”.
Query Parameters
Name | Type | Description |
---|---|---|
method* | String | “READYTOSHIP” |
booking | Int | Booking Request Status 0 - None (Default) 1 - Call shipment provider. The available shipment is “flashexpress” (Flash Express), “jtexpress” (J&T) and “kerry” (Kerry). Support only non-marketplace order. |
pickuptime | String | Shopee pickup datetime keyword for pickup. Not Required for Shopee Pickup. If this is blank, the system will choose earliest time. Ex. 18-06-2020 |
address | String | Pickup location keyword for pickup. Required if the shipment is Shopee Pickup. Ex. "10420" - Postcode of pickup location. |
trackingno | String | Tracking No. Not require if shipment by marketplace. |
shipment* | String | Shipment provider. This is shipping channel, if the order is non-marketplace. If this order is from marketplace, please specify marketplace shipment. Ex. Shopee - "pickup" or "dropoff" Lazada - "lex" or default shipping channel of order. If in order doesn't have shipping channel please use "lex". Tiktok Shop- "pickup" or "dropoff" |
warehousecode | String | Warehouse Code |
number | String | Order Number Require if id = 0 or null *Must have either id or number |
id | Int | Order ID *Must have either id or number |
version* | String | 3 |
format | String | json (Default), xml |
Headers
Name | Type | Description |
---|---|---|
apisecret* | String | API Secret |
storename* | String | Store Name |
apikey* | String | API Key |
Parameter | Type | Description/Example |
---|---|---|
resCode | String | Response Code 200- Success |
resDesc | String | Response Description |
detail | Detail | Response detail |
Parameter (Detail) | Type | Description/Example |
---|---|---|
id | Int | Order ID |
number | String | Order Number |
shippingchannel | String | Shipping Channel |
trackingno | String | Tracking No |
link | String | Shipping Label Link |
Book Order Shipment
POST
https://api.zortout.com/api.aspx
Call shipment provider. The available shipment is “flashexpress” (Flash Express), “jtexpress” (J&T) and “kerry” (Kerry). The status will be changed to “Waiting”. Support only non- marketplace order.
Query Parameters
Name | Type | Description |
---|---|---|
method* | String | “BOOKORDERSHIPMENT” |
shipment* | String | Shipment provider. flashexpress – Flash Express jtexpress – J&T kerry – Kerry shopeeexpress – Shopee Express |
number | String | Order Number Require if id = 0 or null *Must have either id or number |
id | Int | Order ID *Must have either id or number |
version* | String | 3 |
format | String | json (Default), xml |
Headers
Name | Type | Description |
---|---|---|
apisecret* | String | API Secret |
storename* | String | Store Name |
apikey* | String | API Key |
Parameter | Type | Description/Example |
---|---|---|
resCode | String | Response Code 200- Success |
resDesc | String | Response Description |
detail | Detail | Response detail |
Parameter (Detail) | Type | Description/Example |
---|---|---|
id | Int | Order ID |
number | String | Order Number |
shippingchannel | String | Shipping Channel |
trackingno | String | Tracking No |
link | String | Shipping Label Link |
Update Order Serial No
POST
https://api.zortout.com/api.aspx
Update serial number of order.
Query Parameters
Name | Type | Description |
---|---|---|
method* | String | “UPDATEORDERSERIALNO” |
serialno* | String | Serial Number |
sku | String | Product Sku Require if productid = 0 or null *Must have either productid or sku |
productid | Int | Product ID *Must have either productid or sku |
number | String | Order Number Require if id = 0 or null *Must have either id or number |
id | Int | Order ID *Must have either id or number |
version* | String | 3 |
format | String | json (Default), xml |
Headers
Name | Type | Description |
---|---|---|
apisecret* | String | API Secret |
storename* | String | Store Name |
apikey* | String | API Key |
Parameter | Type | Description/Example |
---|---|---|
resCode | String | Response Code 200- Success |
resDesc | String | Response Description |
Update Order Expiry/Lot
POST
https://api.zortout.com/api.aspx
Update expiry/lot of order.
Query Parameters
Name | Type | Description |
---|---|---|
method* | String | “UPDATEORDEREXPIRYLOT” |
lotnumber* | Double | Lot Number |
lot* | String | Lot Name |
sku | String | Product Sku Require if productid = 0 or null *Must have either productid or sku |
productid | Int | Product ID *Must have either productid or sku |
number | String | Order Number Require if id = 0 or null *Must have either id or number |
id | Int | Order ID *Must have either id or number |
version* | String | 3 |
format | String | json (Default), xml |
Headers
Name | Type | Description |
---|---|---|
storename* | String | Store Name |
apikey* | String | API Key |
apisecret* | String | API Secret |
Parameter | Type | Description/Example |
---|---|---|
resCode | String | Response Code 200- Success |
resDesc | String | Response Description |
Add Expense Order
POST
https://api.zortout.com/api.aspx
Add expense to order.
Query Parameters
Name | Type | Description |
---|---|---|
method* | String | “ADDEXPENSEWITHORDER” |
id* | Int | Order ID |
version* | String | 3 |
format | String | json (Default), xml |
Headers
Name | Type | Description |
---|---|---|
storename | String | Store Name |
apikey | String | API Key |
apisecret | String | API Secret |
Request Body
Name | Type | Description |
---|---|---|
name* | String | Expense Name |
paymentname* | String | Payment Method |
amount* | Double | Amount |
isvat | Int | Vat Status 0 - No Vat (Default) 1 - Include Vat |
Parameter | Type | Description/Example |
---|---|---|
resCode | String | Response Code 200- Success |
resDesc | String | Response Description |
Add Order Tag
POST
https://api.zortout.com/api.aspx
Add tag to order.
Query Parameters
Name | Type | Description |
---|---|---|
method* | String | “ADDORDERTAG” |
tag* | String | Tag |
number | String | Order Number Require if id = 0 or null *Must have either id or number |
id | Int | Order ID *Must have either id or number |
version* | String | 3 |
format | String | json (Default), xml |
Headers
Name | Type | Description |
---|---|---|
apisecret* | String | API Secret |
storename* | String | Store Name |
apikey* | String | API Key |
Parameter | Type | Description/Example |
---|---|---|
resCode | String | Response Code 200- Success |
resDesc | String | Response Description |
Last updated