易仓TOMS
  1. 易仓物流系统API
易仓TOMS
  • 易仓物流系统API
    • 创建订单--createOrder
      POST
    • 获取跟踪号--getTrackNumber
      POST
    • 获取标签--getLabelUrl
      POST
    • 取消订单--cancelOrder
      POST
    • 获取轨迹--getCargoTrack
      POST
  1. 易仓物流系统API

创建订单--createOrder

POST
/default/svc/web-service
1.必填项并非固定
2.如无特殊说明,重量单位为kg,长度单位为cm
3.如果响应结果中的track_status为2,表示需要调用获取跟踪号接口异步获取跟踪号
4.请求参数里面如果包含>、&,需要转义成对应的实体>、&,或者paramsJson节点的内容使用<![CDATA[ ]]>标签忽略解析

请求参数

Body 参数application/xml

示例
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
    <SOAP-ENV:Body>
        <ns1:callService>
            <paramsJson>
                <![CDATA[
                    {
    "reference_no": "{{reference_no}}",
    "shipping_method": "{{shipping_method}}",
    "country_code": "CA",
    "extra_service": "",
    "order_weight": 18.51,
    "shipping_method_no": "",
    "order_pieces": 2,
    "insurance_value": "",
    "mail_cargo_type": 4,
    "cargo_type": "W",
    "is_COD": "N",
    "sales_amount": "",
    "sales_currency": "",
    "seller_id": "",
    "buyer_id": "",
    "payment_type": "",
    "invoice_fee": null,
    "other_fee": null,
    "reference_id": "",
    "shipment_id": "",
    "POANumber": "",
    "warehouse_code": "",
    "platform": "",
    "platform_number": "",
    "ioss": "",
    "Consignee": {
        "consignee_company": "consignee company",
        "consignee_province": "BC",
        "consignee_city": "RICHMOND",
        "consignee_street": "14967 Salt Lake Ave",
        "consignee_street2": "",
        "consignee_postcode": "V7C4V7",
        "consignee_name": "consignee name",
        "consignee_telephone": "+6584884901",
        "consignee_mobile": "+6584884901",
        "consignee_email": "test@qq.com",
        "buyer_id": ""
    },
    "ItemArr": [
        {
            "box_number":"U001",
			"invoice_enname": "3D printer filament",
            "invoice_cnname": "3D打印线材",
            "invoice_weight": 1.390,
            "invoice_quantity": 1,
            "unit_code": "PCE",
            "invoice_unitcharge": 15.99,
            "invoice_currencycode": "USD",
            "deal_price": 14.0000,
            "deal_currencycode": "USD",
            "hs_code": "39169090",
            "invoice_note": "",
            "invoice_url": "",
            "sku": "A01-W2-1.75-1000-SPL",
            "shop_sku": "",
            "box_number": "",
            "material": "",
            "material_enture": "",
            "product_id": "",
            "transaction_id": "",
            "use": "",
            "invoice_brand": "",
            "invoice_brand_type": "",
            "invoice_category": "",
            "invoice_model": "",
            "is_magnetoelectric": "N",
            "country_of_origin": "CN",
            "note": "",
            "note2": ""
        },
        {
            "box_number":"U002",
			"invoice_enname": "3D printer filament",
            "invoice_cnname": "3D打印线材",
            "invoice_weight": 1.394,
            "invoice_quantity": "1",
            "unit_code": "PCE",
            "invoice_unitcharge": 15.99,
            "invoice_currencycode": "USD",
            "deal_price": 14.0000,
            "deal_currencycode": "USD",
            "hs_code": "39169090",
            "invoice_note": "",
            "invoice_url": "",
            "sku": "A00-D0-1.75-1000-spl",
            "shop_sku": "",
            "box_number": "",
            "material": "",
            "material_enture": "",
            "product_id": "",
            "transaction_id": "",
            "use": "",
            "invoice_brand": "",
            "invoice_brand_type": "",
            "invoice_category": "",
            "invoice_model": "",
            "is_magnetoelectric": "N",
            "country_of_origin": "CN",
            "note": "",
            "note2": ""
        }
    ],
    "Shipper": {
        "shipper_countrycode": "JP",
        "shipper_province": "",
        "shipper_city": "Tokyo",
        "shipper_street": "10 FedEx Parkway",
        "shipper_doorplate": "5/F",
        "shipper_telephone": "13800138000",
        "shipper_name": "shipper name",
        "shipper_company": "shipper company",
        "shipper_postcode": "1690051",
        "shipper_email": "test@gmail.com"
    },
    "Volume": [
        {
            "box_number":"U001",
			"length": 50,
            "width": 37,
            "height": 23,
            "weight": 14.01
        },
        {
            "box_number":"U002",
			"length": 25,
            "width": 25,
            "height": 23,
            "weight": 4.5
        }
    ]
}
                ]]>
            
            </paramsJson>
            <appToken>{{appToken}}</appToken>
            <appKey>{{appKey}}</appKey>
            <service>createOrder</service>
        </ns1:callService>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://8.129.234.2:8085/default/svc/web-service' \
--header 'Content-Type: application/xml' \
--data-raw '<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
    <SOAP-ENV:Body>
        <ns1:callService>
            <paramsJson>
                <![CDATA[
                    {
    "reference_no": "{{$string.alphanumeric}}",
    "shipping_method": "PK0231",
    "country_code": "CA",
    "extra_service": "",
    "order_weight": 18.51,
    "shipping_method_no": "",
    "order_pieces": 2,
    "insurance_value": "",
    "mail_cargo_type": 4,
    "cargo_type": "W",
    "is_COD": "N",
    "sales_amount": "",
    "sales_currency": "",
    "seller_id": "",
    "buyer_id": "",
    "payment_type": "",
    "invoice_fee": null,
    "other_fee": null,
    "reference_id": "",
    "shipment_id": "",
    "POANumber": "",
    "warehouse_code": "",
    "platform": "",
    "platform_number": "",
    "ioss": "",
    "Consignee": {
        "consignee_company": "consignee company",
        "consignee_province": "BC",
        "consignee_city": "RICHMOND",
        "consignee_street": "14967 Salt Lake Ave",
        "consignee_street2": "",
        "consignee_postcode": "V7C4V7",
        "consignee_name": "consignee name",
        "consignee_telephone": "+6584884901",
        "consignee_mobile": "+6584884901",
        "consignee_email": "test@qq.com",
        "buyer_id": ""
    },
    "ItemArr": [
        {
            "box_number":"U001",
			"invoice_enname": "3D printer filament",
            "invoice_cnname": "3D打印线材",
            "invoice_weight": 1.390,
            "invoice_quantity": 1,
            "unit_code": "PCE",
            "invoice_unitcharge": 15.99,
            "invoice_currencycode": "USD",
            "deal_price": 14.0000,
            "deal_currencycode": "USD",
            "hs_code": "39169090",
            "invoice_note": "",
            "invoice_url": "",
            "sku": "A01-W2-1.75-1000-SPL",
            "shop_sku": "",
            "box_number": "",
            "material": "",
            "material_enture": "",
            "product_id": "",
            "transaction_id": "",
            "use": "",
            "invoice_brand": "",
            "invoice_brand_type": "",
            "invoice_category": "",
            "invoice_model": "",
            "is_magnetoelectric": "N",
            "country_of_origin": "CN",
            "note": "",
            "note2": ""
        },
        {
            "box_number":"U002",
			"invoice_enname": "3D printer filament",
            "invoice_cnname": "3D打印线材",
            "invoice_weight": 1.394,
            "invoice_quantity": "1",
            "unit_code": "PCE",
            "invoice_unitcharge": 15.99,
            "invoice_currencycode": "USD",
            "deal_price": 14.0000,
            "deal_currencycode": "USD",
            "hs_code": "39169090",
            "invoice_note": "",
            "invoice_url": "",
            "sku": "A00-D0-1.75-1000-spl",
            "shop_sku": "",
            "box_number": "",
            "material": "",
            "material_enture": "",
            "product_id": "",
            "transaction_id": "",
            "use": "",
            "invoice_brand": "",
            "invoice_brand_type": "",
            "invoice_category": "",
            "invoice_model": "",
            "is_magnetoelectric": "N",
            "country_of_origin": "CN",
            "note": "",
            "note2": ""
        }
    ],
    "Shipper": {
        "shipper_countrycode": "JP",
        "shipper_province": "",
        "shipper_city": "Tokyo",
        "shipper_street": "10 FedEx Parkway",
        "shipper_doorplate": "5/F",
        "shipper_telephone": "13800138000",
        "shipper_name": "shipper name",
        "shipper_company": "shipper company",
        "shipper_postcode": "1690051",
        "shipper_email": "test@gmail.com"
    },
    "Volume": [
        {
            "box_number":"U001",
			"length": 50,
            "width": 37,
            "height": 23,
            "weight": 14.01
        },
        {
            "box_number":"U002",
			"length": 25,
            "width": 25,
            "height": 23,
            "weight": 4.5
        }
    ]
}
                ]]>
            
            </paramsJson>
            <appToken>a106eb7a118d78f92cabbc91586caa84</appToken>
            <appKey>a106eb7a118d78f92cabbc91586caa8401ac591bb285b42966f035d8d49a7b5c</appKey>
            <service>createOrder</service>
        </ns1:callService>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>'

返回响应

🟢200成功
application/xml
Body

示例
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/"><SOAP-ENV:Body><ns1:callServiceResponse><response>{"ask":"Success","message":"Success","reference_no":"e9W0ftAdbpEkTe2zZDn7","shipping_method_no":"794813650212","order_code":"CR36600006","track_status":1,"sender_info_status":0,"ODA":null,"agent_number":"","system_number":null,"tracking_number_list":{"U001":"794813650212","U002":"794813650223"},"time_cost(s)":11.210399866104}</response></ns1:callServiceResponse></SOAP-ENV:Body></SOAP-ENV:Envelope>
🟢200失败
修改于 2025-01-02 03:13:00
下一页
获取跟踪号--getTrackNumber
Built with