ChinaDivision Order Fulfillment API Integration

Services Introduction:

This document describes the integration points available to clients via the www.chinadivision.com API, which makes shipping data available for syncing the client system with the www.chinadivision.com system.

Interface Address:

https://api.chinadivision.com/sku-create-v2

Request Method:

POST

Request Parameters (header):

Parameter Name	Types	Required	Parameter Location	Description	Defaults
apikey	string	yes	header	API Key	your apikey

Request Parameters (bodyParam):

Parameter Name	Types	Required	Parameter Location	Description
sku	string	yes	bodyParam	sku code
sn	string	yes	bodyParam	sn code
product_name	string	yes	bodyParam	product name
name_en	string	yes	bodyParam	product english name
name_cn	string	yes	bodyParam	product chinese name
price	float	yes	bodyParam	product price
size	string	yes	bodyParam	product size
color	string	yes	bodyParam	product color
brand	string	yes	bodyParam	product brand
material	string	no	bodyParam	product english material
material_cn	string	no	bodyParam	product chinese material
application	string	no	bodyParam	product english english
application_cn	string	no	bodyParam	product chinese application
hs_code	string	no	bodyParam	HS code

Request Example:

<?php
$url = 'https://api.chinadivision.com/sku-create-v2';
$header = [
    'Content-Type:application/json',
    'apikey: your apikey',
];
$post_data = [
    'sku' => '350000001042',
    'sn' => '350000001042',
    'product_name' => 'Juniper Material Handbook',
    'name_en' => 'Juniper Material Handbook',
    'name_cn' => '手册',
    'price' => 5,
    'size' => '30*20*5',
    'color' => 'red',
    'brand' => 'Juniper',
    'material' => 'paper',
    'material_cn' => '纸',
    'application' => 'instructions',
    'application_cn' => '指南',
    'hs_code' => '611100000111'
];

$ch = curl_init();

curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);

// Add apikey to header
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
// Add post_data to bodyParam
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($post_data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

// HTTP request

curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);

curl_setopt($ch, CURLOPT_URL, $url);
$res = curl_exec($ch);

var_dump(json_decode($res, true));

JSON Returns Example:

Remark

Repeat create SKU, execute update SKU information operation.

Error Messages:

Error Code	Error Code Returns	Description
0	success	success
1	Apikey can not be empty	apikey can not be empty
2	Apikey does not exist	apikey does not exist
3	Post data can not be empty	Post data can not be empty
4	Info data can not be empty	Info data can not be empty
5	Tracking Number and Package Number two must have a not null	Tracking Number and Package Number two must have a not null
6	service is temporarily unavailable	service is temporarily unavailable
91	Sku already exists
92	Sn already is Used
101	Sku can not be empty
102	Sku can contain only numbers, letters, and hyphens (-)
103	Sn can not be empty
104	Sn can contain only numbers, letters, and hyphens (-)
105	Product name can not be empty
106	product chinese name can not be empty
107	product english name can not be empty
108	The price must be greater than 0
109	Size can not be empty
110	Color can not be empty
111	Brand can not be empty

Services Introduction:

This document describes the integration points available to clients via the www.chinadivision.com API, which makes shipping data available for syncing the client system with the www.chinadivision.com system.

Interface Address:

https://api.chinadivision.com/sku-info

Request Method:

GET

Request Parameters (header):

Parameter Name	Types	Required	Parameter Location	Description	Defaults
apikey	string	yes	header	API Key	your apikey

Request Example:

<?php
        $ch = curl_init();

        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);

        $url = 'https://api.chinadivision.com/sku-info?package_number=CNSTORM-20150301-00001&tracking_number=NO100001&shipping_method=SF';
        $header = array(
                'apikey: your apikey',
        );
        // Add apikey to header
        curl_setopt($ch, CURLOPT_HTTPHEADER  , $header);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        // HTTP request
        curl_setopt($ch , CURLOPT_URL , $url);
        $res = curl_exec($ch);

        var_dump(json_decode($res));
    ?>

JSON Returns Example:

{
        "code": 0,
        "msg": "success",
        "data": {
            "package_number": "CNSTORM-20150301-00001",
            "tracking_number": "NO100001",
            "shipping_method": "SF",
            "quantity": "8",
            "info": "[
            {\"sku\":\"sku-iv-1\",\"product_name\":\"shirt\",\"product_url\":\"https:\\/\\/item.taobao.com\\/item.htm?spm=a1z10.1-c.w5003-10229753858.1.9rA5ew&id=524430044755&scene=taobao_shop\",\"color\":\"Red Pansy\",\"size\":\"XS\",\"price\":10,\"supplier\":\"taobao\",\"quantity\":1},
            {\"sku\":\"sku-iv-2\",\"product_name\":\"shirt\",\"product_url\":\"https:\\/\\/item.taobao.com\\/item.htm?spm=a1z10.33-c.w4002-12426177414.14.bqhm4D&id=39906160111\",\"color\":\"Pansy\",\"size\":\"XS\",\"price\":180,\"supplier\":\"taobao\",\"quantity\":2},
            {\"sku\":\"sku-iv-3\",\"product_name\":\"shirt\",\"product_url\":\"https:\\/\\/item.taobao.com\\/item.htm?spm=a1z10.33-c.w4002-12426177414.14.bqhm4D&id=39906160111\",\"color\":\"Green Pansy\",\"size\":\"XS\",\"price\":190,\"supplier\":\"whoolala\",\"quantity\":5}
            ]",
            "remark": "",
            "date_added": "2016-02-18 19:40:56",
            "date_modified": "0000-00-00 00:00:00",
            "package_status": "0",
            "shelf_number": ""
        }
    }

Remark:

package_status: current package's state
0: Processing, Packages are being processed;
1: Received, Packages have been received by ChinaDivision;
2: Problem, Packages-received don't match the packing list information which was offered by the customer or by the supplier;

Error Messages:

Error Code	Error Code Returns	Description
0	success	success
1	Apikey can not be empty	apikey can not be empty
2	Apikey does not exist	apikey does not exist
3	Package Number can not be empty	package number can not be empty
4	Tracking Number does not exist	tracking number does not exist
5	Shipping Method does not exist	Shipping Method does not exist
6	Packing List does not exist	Packing List does not exist

Services Introduction:

This document describes the integration points available to clients via the www.chinadivision.com API, which makes shipping data available for syncing the client system with the www.chinadivision.com system.

Interface Address:

https://api.chinadivision.com/sku-cancel

Request Method:

POST

Request Parameters (header):

Parameter Name	Types	Required	Parameter Location	Description	Defaults
apikey	string	yes	header	API Key	your apikey

Request Parameters (bodyParam):

Parameter Name	Types	Required	Parameter Location	Description	Defaults
remark	string	no	bodyParam	remark

Request Example:

<?php
        $ch = curl_init();

    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);

        $url = 'https://api.chinadivision.com/sku-cancel';
        $header = array(
                'Content-Type:application/x-www-form-urlencoded',
                'apikey: your apikey',
        );
        $post_data = array(
                'package_number' => 'CNSTORM-20150301-00001',
                'tracking_number' => 'NO100001',
                'shipping_method' => 'SF',
                'remark' => 'test'
        );
        // Add apikey to header
        curl_setopt($ch, CURLOPT_HTTPHEADER  , $header);
        // Add post_data to bodyParam
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($post_data));
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        // HTTP request
        curl_setopt($ch , CURLOPT_URL , $url);
        $res = curl_exec($ch);

        var_dump(json_decode($res));
    ?>

JSON Returns Example:

Remark:

The cancel API call to cancel any orders before shipment.

Error Messages:

Error Code	Error Code Returns	Description
0	success	success
1	Apikey can not be empty	apikey can not be empty
2	Apikey does not exist	apikey does not exist
3	Tracking Number and Package Number two must have a not null	Tracking Number and Package Number two must have a not null
4	Post data can not be empty	Post data can not be empty
5	service is temporarily unavailable	service is temporarily unavailable

Services Introduction:

This document describes the integration points available to clients via the www.chinadivision.com API, which makes shipping data available for syncing the client system with the www.chinadivision.com system.

Interface Address:

https://api.chinadivision.com/order-create

Request Method:

POST

Request Parameters (header):

Parameter Name	Types	Required	Parameter Location	Description	Defaults
apikey	string	yes	header	API Key	your apikey

Request Parameters (bodyParam):

Parameter Name	Types	Required	Parameter Location	Description	Defaults
order_id	string	yes	bodyParam	order id
first_name	string	yes	bodyParam	first name
last_name	string	yes	bodyParam	last name
ship_address1	string	yes	bodyParam	ship address1
ship_address2	string	no	bodyParam	ship address2
ship_city	string	yes	bodyParam	ship city
ship_state	string	yes	bodyParam	ship state
ship_zip	string	yes	bodyParam	ship zip
ship_country	string	yes	bodyParam	ship country
ship_phone	string	yes	bodyParam	ship phone
ship_email	string	no	bodyParam	ship email
quantity	int	yes	bodyParam	Total quantity
info	array	yes	bodyParam	Multiple parcels SKU information
shipping_method	string	no	bodyParam	Specify a shipping out method
vat	string	no	bodyParam	vat
inspection	int	yes	bodyParam	inspection status code 0:no need inspection,1:need inspection	0
remark	string	no	bodyParam	remark
business_type	int	yes	bodyParam	business type	1

Request Example:

<?php
        $ch = curl_init();

        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);

        $url = 'https://api.chinadivision.com/order-create';
        $header = array(
                'Content-Type:application/x-www-form-urlencoded',
                'apikey: your apikey',
        );
        $post_data = array(
                'order_id' => '100001',
                'first_name' => 'wang',
                'last_name' => 'xiao hong',
                'ship_address1' => '8888 Parkland',
                'ship_address2' => '',
                'ship_city' => 'Calgary',
                'ship_state' => 'AB',
                'ship_zip' => 'T2J3Y2',
                'ship_country' => 'Canada',
                'ship_phone' => '8888888888',
                'ship_email' => 'gzq@cnstorm.com',
                'quantity' => 8,
                'info' => array(
                    array(
                        'sku' => 'sku-iv-1',
                        'product_name' => 'shirt',
                        'product_url' => 'https://item.taobao.com/item.htm?spm=a1z10.1-c.w5003-10229753858.1.9rA5ew&id=524430044755&scene=taobao_shop',
                        'color' => 'Red Pansy',
                        'size' => 'XS',
                        'category' => 'Fragile',
                        'supplier' => 'taobao',
                        'quantity' => 4,
                        'package_number' => 'N10001',
                        'tracking_number' => '888888888',
                        'shipping_method' => 'SF',
						'declared_price' => '1.0', // declared price
                    ),
                    array(
                        'sku' => 'sku-iv-2',
                        'product_name' => 'shirt',
                        'product_url' => 'https://item.taobao.com/item.htm?spm=a1z10.33-c.w4002-12426177414.14.bqhm4D&id=39906160111',
                        'color' => 'Pansy',
                        'size' => 'XS',
                        'category' => 'Fragile',
                        'supplier' => 'taobao',
                        'quantity' => 1,
                        'package_number' => 'N10001',
                        'tracking_number' => '888888888',
                        'shipping_method' => 'SF',
						'declared_price' => '1.0', // declared price
                    ),
                    array(
                        'sku' => 'sku-iv-3',
                        'product_name' => 'shirt',
                        'product_url' => 'https://item.taobao.com/item.htm?spm=a1z10.33-c.w4002-12426177414.14.bqhm4D&id=39906160111',
                        'color' => 'Green Pansy',
                        'size' => 'XS',
                        'category' => 'Fragile',
                        'supplier' => 'whoolala',
                        'quantity' => 3,
                        'package_number' => 'N10002',
                        'tracking_number' => '999999999',
                        'shipping_method' => 'SF',
						'declared_price' => '1.0', // declared price
                    ),
                ),
                'shipping_method' => 'DHL',
                'vat' => '',
                'inspection' => 0,
                'remark' => 'test',
                'business_type' => 1
        );
        // Add apikey to header
        curl_setopt($ch, CURLOPT_HTTPHEADER  , $header);
        // Add post_data to bodyParam
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($post_data));
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        // HTTP request
        curl_setopt($ch , CURLOPT_URL , $url);
        $res = curl_exec($ch);

        var_dump(json_decode($res));
    ?>

JSON Returns Example:

Remark:

Repeat create order, execute update order information operation.

Error Messages:

Error Code	Error Code Returns	Description
0	success	success
1	Apikey can not be empty	apikey can not be empty
2	Apikey does not exist	apikey does not exist
3	Post data can not be empty	Post data can not be empty
4	Info data can not be empty	Info data can not be empty
5	service is temporarily unavailable	service is temporarily unavailable
6	Order has been shipped	Order has been shipped

Services Introduction:

This document describes the integration points available to clients via the www.chinadivision.com API, which makes shipping data available for syncing the client system with the www.chinadivision.com system.

Interface Address:

https://api.chinadivision.com/order-info

Request Method:

GET

Request Parameters (header):

Parameter Name	Types	Required	Parameter Location	Description	Defaults
apikey	string	yes	header	API Key	your apikey

Request Parameters (urlParam):

Parameter Name	Types	Required	Parameter Location	Description	Defaults
order_id	string	yes	urlParam	order id

Request Example:

<?php
        $ch = curl_init();

        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);

        $url = 'https://api.chinadivision.com/order-info?order_id=888888';
        $header = array(
                'apikey: your apikey',
        );
        // Add apikey to header
        curl_setopt($ch, CURLOPT_HTTPHEADER  , $header);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        // HTTP request
        curl_setopt($ch , CURLOPT_URL , $url);
        $res = curl_exec($ch);

        var_dump(json_decode($res));
    ?>

JSON Returns Example:

{
        "code": 0,
        "msg": "success",
        "data": {
            "order_id": "888888",
            "first_name": "Wan",
            "last_name": "XiaoEr",
            "ship_address1": "8888 Parkland",
            "ship_address2": "",
            "ship_city": "BEEVILLE",
            "ship_state": "TX",
            "ship_zip": "8888",
            "ship_country": "United States",
            "ship_phone": "8888888888",
            "ship_email": "gzq@cnstorm.com",
            "code": "1234,5678,9123",
            "quantity": "3",
            "remark": "test",
            "date_added": "2015-07-16 11:51:38",
            "info":[
                {"sku":"sku-001","sku_code":"12345601","quantity":"1","tracking_number":"LN00001","shipping_method":"SF","package_number":"N10001","product_name":"shirt","product_url":"https:\/\/item.taobao.com\/item.htm?spm=a1z10.33-c.w4002-12426177414.14.bqhm4D&id=39906160111","color":"Pansy","size":"XS","category":"Fragile","supplier":"taobao"},
                {"sku":"sku-002","sku_code":"12345602","quantity":"2","tracking_number":"LN00002","shipping_method":"SF","package_number":"N10002","product_name":"shirt","product_url":"https:\/\/item.taobao.com\/item.htm?spm=a1z10.33-c.w4002-12426177414.14.bqhm4D&id=39906160111","color":"Green Pansy","size":"XS","category":"Fragile","supplier":"taobao"}
            ],
            "freight": "100.00",
            "tracking_number": "8888888888",
            "shipping_method": "DHL",
            "order_status": "1",
            "carrier":"DHL",
            "status": 10,
            "status_name": "Approved",
            "track_status": 101,
            "track_status_name": "In Transit"
        }
    }

Remark:

order_status: current order's state(Deprecated in future versions)
0: Processing, the parcel is being prepared.
1: Collected, the parcel has been collected by the courier company and the tracking number has been provided.

status_name: Order status name
status: New order status
0 Approving
10 Approved
11 Uploaded
8 Picking
9 Packing
5 Packaged
2 Awaiting Shipping
3 Shipped
4 Special event
24 Processing
19 Reviewing
21 Processing
23 Canceled

track_status_name: Track status name
track_status: Track status
0 To be updated track
101 In Transit
111 Pick Up
112 Out For Delivery
121 Delivered
131 Alert
132 Expired
order_deduction_status: Order Deduction Status
0 No deduction
1 Deduction

Error Messages:

Error Code	Error Code Returns	Description
0	success	success
1	Apikey can not be empty	apikey can not be empty
2	Apikey does not exist	apikey does not exist
3	Order ID can not be empty	order id can not be empty
4	Order does not exist	order does not exist

Services Introduction:

This document describes the integration points available to clients via the www.chinadivision.com API, which makes shipping data available for syncing the client system with the www.chinadivision.com system.

Interface Address:

https://api.chinadivision.com/orders-info

Request Method:

GET

Request Parameters (header):

Parameter Name	Types	Required	Parameter Location	Description	Defaults
apikey	string	yes	header	API Key	your apikey

Request Parameters (urlParam):

Parameter Name	Types	Required	Parameter Location	Description
page	int	yes	urlParam	page
page_size	int	yes	urlParam	page size range 1-1000
start	string	yes	urlParam	Start time, query the start time of the order creation time range.
end	string	yes	urlParam	End time, query the end time of the order creation time range

Request Example:

<?php
        $ch = curl_init();

        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);

        $url = 'https://api.chinadivision.com/orders-info?page=1&page_size=250&start=2019-01-01&end=2019-01-31';
        $header = array(
                'apikey: your apikey',
        );
        // Add apikey to header
        curl_setopt($ch, CURLOPT_HTTPHEADER  , $header);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        // HTTP request
        curl_setopt($ch , CURLOPT_URL , $url);
        $res = curl_exec($ch);

        var_dump(json_decode($res));
    ?>

JSON Returns Example:

{
        "code": 0,
        "msg": "success",
        "data": {
            "page": "1",
            "page_size": 250,
            "page_count": 12,
            "order_count": "2966",
            "order_infos": [{
                "order_id": "#1010",
                "first_name": "cn",
                "last_name": "lei",
                "ship_address1": "8888 Parkland",
                "ship_address2": "",
                "ship_city": "BEEVILLE",
                "ship_state": "TX",
                "ship_zip": "8888",
                "ship_country": "United States",
                "ship_phone": "8888888888",
                "ship_email": "test@cnstorm.com",
                "quantity": "2",
                "remark": "",
                "date_added": "2019-01-28 09:32:57",
                "info":[
                        {"sku":"sku-001","sku_code":"12345601","quantity":"1","tracking_number":"LN00001","shipping_method":"SF","package_number":"N10001","product_name":"shirt","product_url":"https:\/\/item.taobao.com\/item.htm?spm=a1z10.33-c.w4002-12426177414.14.bqhm4D&id=39906160111","color":"Pansy","size":"XS","category":"Fragile","supplier":"taobao"},
                        {"sku":"sku-002","sku_code":"12345602","quantity":"2","tracking_number":"LN00002","shipping_method":"SF","package_number":"N10002","product_name":"shirt","product_url":"https:\/\/item.taobao.com\/item.htm?spm=a1z10.33-c.w4002-12426177414.14.bqhm4D&id=39906160111","color":"Green Pansy","size":"XS","category":"Fragile","supplier":"taobao"}
                    ]
                "freight": "10.00",
                "tracking_number": "dhl432564",
                "shipping_method": "DHL-EXPRESS",
                "order_status": "3",
                "carrier": "DHL",
                "status": 10,
                "status_name": "Approved",
                "track_status": 101,
                "track_status_name": "In Transit"
            }, {
                "order_id": "#1011",
                "first_name": "Yumi",
                "last_name": "Lin",
                "ship_address1": "tiezailu",
                "ship_address2": "",
                "ship_city": "sz",
                "ship_state": "Guangdong",
                "ship_zip": "518000",
                "ship_country": "China",
                "ship_phone": "13631120555",
                "ship_email": "test@chinadivision.com",
                "quantity": "2",
                "remark": "",
                "date_added": "2019-01-29 15:17:17",
                "info":[
                        {"sku":"sku-001","sku_code":"12345601","quantity":"1","tracking_number":"LN00001","shipping_method":"SF","package_number":"N10001","product_name":"shirt","product_url":"https:\/\/item.taobao.com\/item.htm?spm=a1z10.33-c.w4002-12426177414.14.bqhm4D&id=39906160111","color":"Pansy","size":"XS","category":"Fragile","supplier":"taobao"},
                        {"sku":"sku-002","sku_code":"12345602","quantity":"2","tracking_number":"LN00002","shipping_method":"SF","package_number":"N10002","product_name":"shirt","product_url":"https:\/\/item.taobao.com\/item.htm?spm=a1z10.33-c.w4002-12426177414.14.bqhm4D&id=39906160111","color":"Green Pansy","size":"XS","category":"Fragile","supplier":"taobao"}
                    ]
                "freight": "10.00",
                "tracking_number": "ems516546",
                "shipping_method": "EMS-EXPRESS",
                "order_status": "3",
                "carrier": "EMS",
                "status": 10,
                "status_name": "Approved",
                "track_status": 101,
                "track_status_name": "In Transit"

}]
        }
    }

Remark:

order_status: current order's state(Deprecated in future versions)
0: Processing, the parcel is being prepared.
1: Collected, the parcel has been collected by the courier company and the tracking number has been provided.

status_name: Order status name
status: New order status
0 Approving
10 Approved
11 Uploaded
8 Picking
9 Packing
5 Packaged
2 Awaiting Shipping
3 Shipped
4 Special event
24 Processing
19 Reviewing
21 Processing
23 Canceled

track_status_name: Track status name
track_status: Track status
0 To be updated track
101 In Transit
111 Pick Up
112 Out For Delivery
121 Delivered
131 Alert
132 Expired
order_deduction_status: Order Deduction Status
0 No deduction
1 Deduction

Error Messages:

Error Code	Error Code Returns	Description
0	success	success
1	Apikey can not be empty	apikey can not be empty
2	Apikey does not exist	apikey does not exist
4	page can not be empty	page can not be empty
5	start can not be empty	start can not be empty
6	end can not be empty	end can not be empty
7	Order does not exist	order does not exist

Services Introduction:

This document describes the integration points available to clients via the www.chinadivision.com API, which makes shipping data available for syncing the client system with the www.chinadivision.com system.

Interface Address:

https://api.chinadivision.com/order-cancel

Request Method:

POST

Request Parameters (header):

Parameter Name	Types	Required	Parameter Location	Description	Defaults
apikey	string	yes	header	API Key	your apikey

Request Parameters (bodyParam):

Parameter Name	Types	Required	Parameter Location	Description	Defaults
order_id	string	yes	bodyParam	order id
remark	string	no	bodyParam	remark

Request Example:

<?php
        $ch = curl_init();

        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);

        $url = 'https://api.chinadivision.com/order-cancel';
        $header = array(
                'Content-Type:application/json',
                'apikey: your apikey',
        );
        $post_data = array(
                'order_id' => '100001',
                'remark' => 'test'
        );
        // Add apikey to header
        curl_setopt($ch, CURLOPT_HTTPHEADER  , $header);
        // Add post_data to bodyParam
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($post_data));
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        // HTTP request
        curl_setopt($ch , CURLOPT_URL , $url);
        $res = curl_exec($ch);

        var_dump(json_decode($res));
    ?>

JSON Returns Example:

Remark:

The cancel API call to cancel any orders before shipment.

Error Messages:

Error Code	Error Code Returns	Description
0	The order was successfully cancelled	success
1	Apikey can not be empty	apikey can not be empty
2	Apikey does not exist	apikey does not exist
3	Order ID can not be empty	Order ID can not be empty
4	Post data can not be empty	Post data can not be empty
5	service is temporarily unavailable	service is temporarily unavailable
6	The order is processing,please contact your account manager for cancellation
11	Order has been cancelled,no need to cancel again

Services Introduction:

This document describes the integration points available to clients via the www.chinadivision.com API, which makes shipping data available for syncing the client system with the www.chinadivision.com system.

Interface Address:

https://api.chinadivision.com/order-track-list

Request Method:

GET

Request Parameters (header):

Parameter Name	Types	Required	Parameter Location	Description	Defaults
apikey	string	yes	header	API Key	your apikey

Request Parameters (bodyParam):

Parameter Name	Types	Required	Parameter Location	Description	Defaults
order_ids	string	yes	bodyParam	customer order id,Multiple comma-delimited

Request Example:

<?php
$url = 'http://api.chinadivision.com/order-track-list?order_ids='.urlencode('#1000101,#1000102');
$header = [
    'Content-Type:application/json',
    'apikey:da8ae24ea4d2b6f3513cea5fc24e4305',
    'User-Agent: Mozilla/5.0 (compatible; MSIE 5.01; Windows NT 5.0)'
];

$ch = curl_init();

curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);

// Add apikey to header
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
// HTTP request

curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);

curl_setopt($ch, CURLOPT_URL, $url);
$res = curl_exec($ch);
echo '<pre>';
var_dump(json_decode($res,true));

JSON Returns Example:

{
    "code": 0,
    "msg": "ok",
    "data": [
        {
            "sys_order_id": "S460977554888036690",
            "tracking_number": "S520220419144748515",
            "order_id": "#1000101",
            "track_list": [
                [
                    "2023-08-11 10:15:00",
                    "Mainland China, CN Shipment is in transit to next facility"
                ],
                [
                    "2023-08-10 09:27:56",
                    "Mainland China, CN Departed from sort facility"
                ],
                [
                    "2023-08-10 00:34:26",
                    "Mainland China, CN Arrived at origin facility"
                ],
                [
                    "2023-08-08 18:05:03",
                    "Shipment information received"
                ]
            ],
            "track_status": 121,
            "track_status_name": "Delivered",
            "error_code": 0,
            "error_msg": ""
        },
        {
            "sys_order_id": "S461495280538718762",
            "tracking_number": "S520220419144748515",
            "order_id": "#1000102",
            "track_list": [
                [
                    "2023-08-10 10:09:53",
                    "Shipment Packing"
                ],
                [
                    "2023-08-09 18:27:03",
                    "Shipment Picked Up"
                ],
                [
                    "2023-08-08 19:41:06",
                    "Ready The Shipment"
                ]
            ],
            "track_status": 101,
            "track_status_name": "In Transit",
            "error_code": 11,
            "error_msg": "Order has been cancelled"
        }
    ]
}

Remark

Get order track info data

track_status_name: Track status name
track_status: Track status
0 To be updated track
101 In Transit
111 Pick Up
112 Out For Delivery
121 Delivered
131 Alert
132 Expired
order_deduction_status: Order Deduction Status
0 No deduction
1 Deduction

error_msg：Error message
error_code: Error code
0 OK
11 Order has been cancelled

Error Messages:

Error Code	Error Code Returns	Description
0	success	success
1	Apikey can not be empty
2	Apikey does not exist
7001	invalid order id
7002	exceed 40 numbers
7003	error order ids
7004	not found order info
7005	get track info fail

Services Introduction:

This document describes the integration points available to clients via the www.chinadivision.com API, which makes shipping data available for syncing the client system with the www.chinadivision.com system.

Interface Address:

https://api.chinadivision.com/sku-inventory

Request Method:

GET

Request Parameters (header):

Parameter Name	Types	Required	Parameter Location	Description	Defaults
apikey	string	yes	header	API Key	your apikey

Request Parameters (urlParam):

Parameter Name	Types	Required	Parameter Location	Description	Defaults
sku	string	yes	urlParam	SKU

Request Example:

<?php
        $ch = curl_init();

    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);

        $url = 'https://api.chinadivision.com/sku-inventory?sku=XXXX';
        $header = array(
                'apikey: your apikey',
        );
        // Add apikey to header
        curl_setopt($ch, CURLOPT_HTTPHEADER  , $header);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        // HTTP request
        curl_setopt($ch , CURLOPT_URL , $url);
        $res = curl_exec($ch);

        var_dump(json_decode($res));
    ?>

JSON Returns Example:

Remark:

The SKU Inventory API: Get your product inventory

Error Messages:

Error Code	Error Code Returns	Description
0	success	success
1	Apikey can not be empty	apikey can not be empty
2	Apikey does not exist	apikey does not exist
3	SKU can not be empty	SKU can not be empty
4	SKU Inventory does not exist	SKU Inventory does not exist

Services Introduction:

This document describes the integration points available to clients via the www.chinadivision.com API, which makes shipping data available for syncing the client system with the www.chinadivision.com system.

Interface Address:

https://api.chinadivision.com/sku-inventory-all

Request Method:

GET

Request Parameters (header):

Parameter Name	Types	Required	Parameter Location	Description	Defaults
apikey	string	yes	header	API Key	your apikey

Request Parameters (urlParam):

Parameter Name	Types	Required	Parameter Location	Description	Defaults

Request Example:

<?php
        $ch = curl_init();

        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);

        $url = 'https://api.chinadivision.com/sku-inventory-all';
        $header = array(
                'apikey: your apikey',
        );
        // Add apikey to header
        curl_setopt($ch, CURLOPT_HTTPHEADER  , $header);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        // HTTP request
        curl_setopt($ch , CURLOPT_URL , $url);
        $res = curl_exec($ch);

        var_dump(json_decode($res));
    ?>

JSON Returns Example:

Remark:

The SKU Inventory API: Get your all product inventory

Error Messages:

Error Code	Error Code Returns	Description
0	success	success
1	Apikey can not be empty	apikey can not be empty
2	Apikey does not exist	apikey does not exist

Services Introduction:

This document describes the integration points available to clients via the www.chinadivision.com API, which makes shipping data available for syncing the client system with the www.chinadivision.com system.

Interface Address:

https://api.chinadivision.com/inventory-log

Request Method:

GET

Request Parameters (header):

Parameter Name	Types	Required	Parameter Location	Description	Defaults
apikey	string	yes	header	API Key	your apikey

Request Parameters (urlParam):

Parameter Name	Types	Required	Parameter Location	Description
sku	string	yes	urlParam	sku
date_start	string	no	urlParam	Start time, query the start time of the log creation time range.
date_end	string	no	urlParam	End time, query the end time of the log creation time range
type	string	no	urlParam	Log category: 1 inbound,2 outbound
sub_type	int	no	urlParam	Log subcategory:1: "Incoming goods warehousing"; 2: "Order cancellation warehousing"; 3: "Returned items warehousing"; 4: "Inventory surplus warehousing"; 5: "Moved in of the warehouse"; 6: "Other warehousing"; 7: "Destruction warehousing"; 8: "Transfer Inbound"; 9: "Transfer Outbound"; 10: "Order outbound"; 11: "Inventory Shortage outbound"; 12: "Moved out of the warehouse"; 13: "Destroy outbound"; 14: "Miscellaneous outbound"
page	string	no	urlParam	page
limit	string	no	urlParam	limit range 1-1000.

Request Example:

<?php
        $ch = curl_init();

        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);

        $url = 'https://api.chinadivision.com/inventory-log?sku=XXXX&date_start=2016-08-29&date_end=2016-08-30&type=1&sub_type=1&page=1&limit=10';
        $header = array(
                'apikey: your apikey',
        );
        // Add apikey to header
        curl_setopt($ch, CURLOPT_HTTPHEADER  , $header);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        // HTTP request
        curl_setopt($ch , CURLOPT_URL , $url);
        $res = curl_exec($ch);

        var_dump(json_decode($res));
    ?>

JSON Returns Example:

Remark:

qty:Operation quantity
total_surplus_qty: Current inventory
create_date: Operation time
product_id: product id
business_no: Operation number
main_type_name: Operation type name
type_name: Operation sub type name

Error Messages:

Error Code	Error Code Returns	Description
0	success	success
1	Apikey can not be empty	apikey can not be empty
2	Apikey does not exist	apikey does not exist

Services Introduction:

This document describes the integration points available to clients via the www.chinadivision.com API, which makes shipping data available for syncing the client system with the www.chinadivision.com system.

Interface Address:

https://api.chinadivision.com/orders-log

Request Method:

GET

Request Parameters (header):

Parameter Name	Types	Required	Parameter Location	Description	Defaults
apikey	string	yes	header	API Key	your apikey

Request Parameters (urlParam):

Parameter Name	Types	Required	Parameter Location	Description
page	int	yes	urlParam	page
start	string	yes	urlParam	Start time, query the start time of the log creation time range.
end	string	yes	urlParam	End time, query the end time of the log creation time range
order_id	string	no	urlParam	order id.

Request Example:

<?php
        $ch = curl_init();

        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);

        $url = 'https://api.chinadivision.com/orders-log?page=1&start=2021-05-01&end=2021-05-14';
        $header = array(
                'apikey: your apikey',
        );
        // Add apikey to header
        curl_setopt($ch, CURLOPT_HTTPHEADER  , $header);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        // HTTP request
        curl_setopt($ch , CURLOPT_URL , $url);
        $res = curl_exec($ch);

        var_dump(json_decode($res));
    ?>

JSON Returns Example:

{
        "code":0,
        "msg":"success",
        "data":{
            "page":1,
            "page_size":100,
            "page_count":1,
            "log_count":"3",
            "log_infos":[
                {
                    "order_id":"HSN#2472",
                    "log_type":"1",
                    "content":"HSN#2472 tracking changed from 36789314191901 to 36789314191902",
                    "date_added":"2021-05-14 14:36:15"
                },
                {
                    "order_id":"HSN#2473",
                    "log_type":"1",
                    "content":"HSN#2473 tracking changed from 36789515715101 to 36789515715102",
                    "date_added":"2021-05-14 14:36:15"
                },
                {
                    "order_id":"HSN#2468",
                    "log_type":"1",
                    "content":"HSN#2468 tracking changed from 36789343027742 to 36789343027743",
                    "date_added":"2021-05-14 14:36:15"
                }
            ]
        }
    }

Remark:

log_type: Log type
1:tracking number is changed
2:order is reshipped
3:address information is changed

Error Messages:

Error Code	Error Code Returns	Description
0	success	success
1	Apikey can not be empty	apikey can not be empty
2	Apikey does not exist	apikey does not exist
3	start can not be empty	start can not be empty
4	end can not be empty	end can not be empty

Services Introduction:

The purpose of this document is to explain that after enabling the webhook hook and setting up the webhook URL, when there is a change in the order status or fee status in the ChinaDivision system, the order information will be pushed to the set webhook URL. The maximum number of push times for the message is 10 times. When pushing, a HTTP status code of 200 is returned within 5 seconds to represent successful receipt, otherwise it will be considered a failure, and the message will be re-pushed until 10 times, after which the pushing will stop.

Setting up Webhook URL

Enter the www.chinadivision.com system and log in to your account. Go to the back end and click on the "Webhook URL" in the top right corner "Settings button". Fill in your webhook URL in the pop-up window and select the specified update events. Save the settings and a test message will be pushed by the system, you can receive the pushed message at the webhook URL.

Request Method:

POST

Response Parameters (header)

Parameter Name	Types	Required	Parameter Location	Description	Defaults
apikey	string	yes	header	API Key	your apikey
chinadivision-topic	string	yes	header	webhook event, eg. order.updated \| order.deductionStatusUpdated

JSON Returns Example:

{
    "order_info": {
        "order_id": "888888",
        "first_name": "Wan",
        "last_name": "XiaoEr",
        "ship_address1": "8888 Parkland",
        "ship_address2": "",
        "ship_city": "BEEVILLE",
        "ship_state": "TX",
        "ship_zip": "8888",
        "ship_country": "United States",
        "ship_phone": "8888888888",
        "ship_email": "gzq@cnstorm.com",
        "code": "1234,5678,9123",
        "quantity": "3",
        "remark": "test",
        "date_added": "2015-07-16 11:51:38",
        "info":[
            {"sku":"sku-001","sku_code":"12345601","quantity":"1","tracking_number":"LN00001","shipping_method":"SF","package_number":"N10001","product_name":"shirt","product_url":"https:\/\/item.taobao.com\/item.htm?spm=a1z10.33-c.w4002-12426177414.14.bqhm4D&id=39906160111","color":"Pansy","size":"XS","category":"Fragile","supplier":"taobao"},
            {"sku":"sku-002","sku_code":"12345602","quantity":"2","tracking_number":"LN00002","shipping_method":"SF","package_number":"N10002","product_name":"shirt","product_url":"https:\/\/item.taobao.com\/item.htm?spm=a1z10.33-c.w4002-12426177414.14.bqhm4D&id=39906160111","color":"Green Pansy","size":"XS","category":"Fragile","supplier":"taobao"}
        ],
        "freight": "100.00",
        "tracking_number": "8888888888",
        "shipping_method": "DHL",
        "order_status": 1,
        "order_deduction_status": 0,
        "carrier":"DHL",
        "status": 10,
        "status_name": "Approved",
        "track_status": 101,
        "track_status_name": "In Transit"
    }
}

Remark:

order_status: current order's state(Deprecated in future versions)
0: Processing, the parcel is being prepared.
1: Collected, the parcel has been collected by the courier company and the tracking number has been provided.

status_name: Order status name
status: New order status
0 Approving
10 Approved
11 Uploaded
8 Picking
9 Packing
5 Packaged
2 Awaiting Shipping
3 Shipped
4 Special event
24 Processing
19 Reviewing
21 Processing
23 Canceled

track_status_name: Track status name
track_status: Track status
0 To be updated track
101 In Transit
111 Pick Up
112 Out For Delivery
121 Delivered
131 Alert
132 Expired
order_deduction_status: Order Deduction Status
0 No deduction
1 Deduction

Error Messages:

Error Code	Error Code Returns	Description
0	success	success
1	Apikey can not be empty	apikey can not be empty
2	Apikey does not exist	apikey does not exist
3	start can not be empty	start can not be empty
4	end can not be empty	end can not be empty

Power your website with our simple API

Services Introduction:

Interface Address:

Request Method:

Request Parameters (header):

Request Parameters (bodyParam):

Request Example:

php

JSON Returns Example:

JSON

Remark

Error Messages:

Services Introduction:

Interface Address:

Request Method:

Request Parameters (header):

Request Example:

php

JSON Returns Example:

JSON

Remark:

Error Messages:

Services Introduction:

Interface Address:

Request Method:

Request Parameters (header):

Request Parameters (bodyParam):

Request Example:

php

JSON Returns Example:

JSON

Remark:

Error Messages:

Services Introduction:

Interface Address:

Request Method:

Request Parameters (header):

Request Parameters (bodyParam):

Request Example:

php

JSON Returns Example:

JSON

Remark:

Error Messages:

Services Introduction:

Interface Address:

Request Method:

Request Parameters (header):

Request Parameters (urlParam):

Request Example:

php

JSON Returns Example:

JSON

Remark:

Error Messages:

Services Introduction:

Interface Address:

Request Method:

Request Parameters (header):

Request Parameters (urlParam):

Request Example:

php

JSON Returns Example:

JSON

Remark:

Error Messages:

Services Introduction:

Interface Address:

Request Method:

Request Parameters (header):

Request Parameters (bodyParam):

Request Example:

php

JSON Returns Example:

JSON

Remark:

Error Messages:

Services Introduction:

Interface Address:

Request Method: