oTMS logo 开放平台
Documentation Help

订单更新

通过订单更新接口,可以将不同外部系统如ERP系统、WMS系统的大量订单进行批量的更新。单次更新最大订单数为100。

版本号 文档 说明
0.1 当前版本文档

配置说明

oTMS同时在生产环境和测试环境中提供Web Service接口,其中测试环境用于集成测试。两种环境下都需要由oTMS系统管理员分配API帐号密码后方可使用。

注意: 请合理地调用公共接口。如果发现存在异常调用或者对我们系统性能造成影响等情况,会对API账号的调用进行限制,甚至停用。

目前对该接口的调用限制为每个公司每秒最多20个请求

接口说明

公共参数

环境 HTTP请求方法 HTTPS请求地址 请求主体MIME类型 响应主体MIME类型
正式环境 PUT https://login.otms.cn/ws/orderUpdate application/xml application/xml
沙箱环境 PUT https://demo.otms.cn/ws/orderUpdate application/xml application/xml

请求参数

字段名 位置 是否必填 描述 Schema
body body 订单更新请求 OrderUpdateRequest
Authorization header Basic Authorization。如果不为空,则优先使用该值作身份认证。否则使用请求报文中的用户名与密码 string

响应参数

状态码 描述 响应模型
200 successful operation OrderUpdateResponse

详细描述

OrderImportResult

字段名 类型 是否必填 描述 示例
orderNumber string -
errorMsgs array[string] -
orderImportId string -
relatedIndexes array[integer] -
erpNumber string -

OrderUpdateRequest

字段名 类型 是否必填 描述 示例
version string 请求的版本号。当前版本号为0.1
login string 用户名。用于 API 调用者身份认证。如果请求头中的Authorization不为空,则该值会被忽略。
password string 密码。用于 API 调用者身份认证。如果请求头中的Authorization不为空,则该值会被忽略。
orders array[UpdatedOrder] 待更新的订单列表。一次请求最多可以更新100条订单

OrderUpdateResponse

字段名 类型 是否必填 描述 示例
version string 响应版本号
responseCode string 全局的反馈代码
processedOrders string 处理的订单数量
orders array[UpdateResult] 处理的订单列表

UpdateResult

字段名 类型 是否必填 描述 示例
sequence integer (int32) 序列数
erpNumber string 订单erp单号
orderNumber string oTMS订单号
updateStatus string DRAFT - 订单更新后为草稿状态
UPDATED - 订单正常更新
FAILED - 订单更新失败
NOT UPDATED - 订单无更新
strResponseCodes array[string] -
errorColumnName string 对应字段名称
strErrorMsgs array[string] -

UpdatedCargoDescription

字段名 类型 是否必填 描述 示例
productCode string 货物/产品的代码
productName string 货物/产品的名称
unitType string 货物/产品的数量单位。包括如下常量:
1 - 托盘
2 - 箱
3 - 袋
4 - 件
stackable string 已定义的货物/产品的堆叠限制。包括如下常量:
1 - 不可堆叠
2 - 2层
3 - 3层
4 - 4层
5 - 5层
6 - 6层
7 - 7层
8 - 8层
cargoCategory string 产品类别
unitLength number 单位长度
unitWidth number 单位宽度
unitHeight number 单位高度
unitWeight number 单位重量
unitInsurance number 单位投保价值。不能为负数

UpdatedCargoDetails

字段名 类型 是否必填 描述 示例
totalQuantity string 所有运输单位的数量,不能为负数,取值范围(0-10000000)
totalWeight string 所有运输货物的总重量,单位为公斤,取值范围(0-10000000),3位小数
totalVolume string 所有运输货物的总体积,单位为立方米,取值范围(0-10000000),6位小数
totalInsurance string 所有运输货物的总投保价值,取值范围(0-1000000000),2位小数
cargoType integer (int32) 货物类型,考虑到oTMS用户存在共识的运输订单交易的性质,包括如下常量:
1 - 普通货物
2 - 温控货物
3 - 危险品
4 - 危险品和温控货物
packageType string 包装类型,oTMS根据运输用途将货物外包装分为4种,考虑到oTMS用户存在共识的运输订单交易的性质,如果订单包括不同的包装类型请用最高的那个。包括如下常量:
A - 散箱,可堆叠,人工装卸货。已有的卡车容量可以被充分利用,运输提供商不需要特别的装货设备
B - 托盘或者木箱,可堆叠,需叉车装卸货。通常卡车利用率高,可以双重叠加托盘,运输提供商需要叉车装卸货
C - 托盘,木箱或不规则形状,不可堆叠,需叉车装卸货。卡车不能被充分利用,建议货物各方根据LDM而不是CBM/MT来协定零担价格
D - 不允许配货,包车运输。这些货主创建的只能整车收费 (根据卡车尺寸付款) 的订单无论大小都是整车装运

UpdatedContactPerson

字段名 类型 是否必填 描述 示例
name string 联系人的姓名
phone string 固定电话,正则表达式: \d{6,10}(-[0-9]{1,5})?
phoneAreaCode string 区号,正则表达式: \d{1,4}
mobile string 手机号码,正则表达式: \d{11}
email string 邮箱,必须是符合网络标准的有效邮箱

UpdatedCustomFields

字段名 类型 是否必填 描述 示例
customText1 string 自定义文本字段1
customText2 string 自定义文本字段2
customText3 string 自定义文本字段3
customText4 string 自定义文本字段4
customText5 string 自定义文本字段5
customText6 string 自定义文本字段6
customText7 string 自定义文本字段7
customText8 string 自定义文本字段8
customText9 string 自定义文本字段9
customText10 string 自定义文本字段10
customText11 string 自定义文本字段11
customText12 string 自定义文本字段12
customText13 string 自定义文本字段13
customText14 string 自定义文本字段14
customText15 string 自定义文本字段15
customText16 string 自定义文本字段16
customText17 string 自定义文本字段17
customText18 string 自定义文本字段18
customText19 string 自定义文本字段19
customText20 string 自定义文本字段20
customText21 string 自定义文本字段21
customText22 string 自定义文本字段22
customText23 string 自定义文本字段23
customText24 string 自定义文本字段24
customText25 string 自定义文本字段25
customText26 string 自定义文本字段26
customText27 string 自定义文本字段27
customText28 string 自定义文本字段28
customText29 string 自定义文本字段29
customText30 string 自定义文本字段30
customText31 string 自定义文本字段31
customText32 string 自定义文本字段32
customText33 string 自定义文本字段33
customText34 string 自定义文本字段34
customText35 string 自定义文本字段35
customText36 string 自定义文本字段36
customText37 string 自定义文本字段37
customText38 string 自定义文本字段38
customText39 string 自定义文本字段39
customText40 string 自定义文本字段40
customText41 string 自定义文本字段41
customText42 string 自定义文本字段42
customText43 string 自定义文本字段43
customText44 string 自定义文本字段44
customText45 string 自定义文本字段45
customText46 string 自定义文本字段46
customText47 string 自定义文本字段47
customText48 string 自定义文本字段48
customText49 string 自定义文本字段49
customText50 string 自定义文本字段50
customText51 string 自定义文本字段51
customText52 string 自定义文本字段52
customText53 string 自定义文本字段53
customText54 string 自定义文本字段54
customText55 string 自定义文本字段55
customText56 string 自定义文本字段56
customText57 string 自定义文本字段57
customText58 string 自定义文本字段58
customText59 string 自定义文本字段59
customText60 string 自定义文本字段60
customText61 string 自定义文本字段61
customText62 string 自定义文本字段62
customText63 string 自定义文本字段63
customText64 string 自定义文本字段64
customText65 string 自定义文本字段65
customText66 string 自定义文本字段66
customText67 string 自定义文本字段67
customText68 string 自定义文本字段68
customText69 string 自定义文本字段69
customText70 string 自定义文本字段70
customText71 string 自定义文本字段71
customText72 string 自定义文本字段72
customText73 string 自定义文本字段73
customText74 string 自定义文本字段74
customText75 string 自定义文本字段75
customText76 string 自定义文本字段76
customText77 string 自定义文本字段77
customText78 string 自定义文本字段78
customText79 string 自定义文本字段79
customText80 string 自定义文本字段80
customNum1 string 自定义小数字段1 -- 精确到18位数、6位小数
customNum2 string 自定义小数字段2 -- 精确到18位数、6位小数
customNum3 string 自定义小数字段3 -- 精确到18位数、6位小数
customNum4 string 自定义小数字段4 -- 精确到18位数、6位小数
customNum5 string 自定义小数字段5 -- 精确到18位数、6位小数
customNum6 string 自定义小数字段6 -- 精确到18位数、6位小数
customNum7 string 自定义小数字段7 -- 精确到18位数、6位小数
customNum8 string 自定义小数字段8 -- 精确到18位数、6位小数
customNum9 string 自定义小数字段9 -- 精确到18位数、6位小数
customNum10 string 自定义小数字段10 -- 精确到18位数、6位小数
customEnum1 string 自定义字段中定义并激活的枚举变量1的逻辑名
customEnum2 string 自定义字段中定义并激活的枚举变量2的逻辑名
customEnum3 string 自定义字段中定义并激活的枚举变量3的逻辑名
customEnum4 string 自定义字段中定义并激活的枚举变量4的逻辑名
customEnum5 string 自定义字段中定义并激活的枚举变量5的逻辑名
customEnum6 string 自定义字段中定义并激活的枚举变量6的逻辑名
customEnum7 string 自定义字段中定义并激活的枚举变量7的逻辑名
customEnum8 string 自定义字段中定义并激活的枚举变量8的逻辑名
customEnum9 string 自定义字段中定义并激活的枚举变量9的逻辑名
customEnum10 string 自定义字段中定义并激活的枚举变量10的逻辑名
sendMq boolean -
customNum1WithBigDecimal number -
customNum2WithBigDecimal number -
customNum3WithBigDecimal number -
customNum4WithBigDecimal number -
customNum5WithBigDecimal number -
customNum6WithBigDecimal number -
customNum7WithBigDecimal number -
customNum8WithBigDecimal number -
customNum9WithBigDecimal number -
customNum10WithBigDecimal number -
customEnum1WithLogicName string -
customEnum2WithLogicName string -
customEnum3WithLogicName string -
customEnum4WithLogicName string -
customEnum5WithLogicName string -
customEnum6WithLogicName string -
customEnum7WithLogicName string -
customEnum8WithLogicName string -
customEnum9WithLogicName string -
customEnum10WithLogicName string -
customEnums array[string] -

UpdatedLocation

字段名 类型 是否必填 描述 示例
companyName string 地区名称
postcode string 完整的中国邮政编码,精确到6个字符
province string 中文省份名称
town string 中文城市名称
county string 中文区县名称
address string 地址
loading boolean 发货点中的装货标志,收货点中的卸货标志
xttSupport boolean 外部订单追踪支持的标志,默认为false
contact UpdatedContactPerson 地区的联系人详细资料
locationRemarks string 发货点/收货点的订单级别的备注
customFields UpdatedCustomFields 自定义字段。这适用于启用并且正确配置了自定义字段的公司。
notifyRadius string 通知半径 (进圈距离) ,收发货点收到短信通知的范围

UpdatedOrder

字段名 类型 是否必填 描述 示例
sequence integer (int32) 序列数
clientCode string oTMS线下客户公司代码 (承运商帐户适用)
clientReferenceNumber string 调用的系统订单标识符
importId string -
index integer (int32) -
branch string 地区设置中的地区名称
erpNumber string 外部系统的唯一的订单号
orderNumber string oTMS订单号。如果已提供erpNumber,oTMS订单号视为无效。
orderRemarks string 附加的订单备注
policyNumber string 保单号
shipFrom UpdatedLocation 发货点详细信息。这个节点与shipFromExternalId可以二选一。shipFromExternalId节点是字符串类型,表示发货点外部ID,定义在 oTMS 基础数据 (针对货主帐户) 或合作伙伴 (针对承运商帐户) 中
shipTo UpdatedLocation 收货点详细信息。这个节点与shipToExternalId可以二选一。shipFromExternalId节点是字符串类型,表示收货点外部ID,定义在 oTMS 基础数据 (针对货主帐户) 或合作伙伴 (针对承运商帐户) 中
timeSchedule UpdatedTimeSchedule 订单中的提货/送货时间限制
orderLines array[UpdatedOrderLine] 货物/产品明细列表,可能会被隐藏, 若存在订单行更新,需要提供该订单的所有订单行信息
concealOrderLines boolean 是否需对承运商隐藏货物/产品明细,true隐藏,false显示
rejectDraft boolean 是否启用严格验证模式。被系统判定内容不完整/不一致的订单,当此设置为true时拒绝订单,false 时订单进入草稿箱
cargoDetails UpdatedCargoDetails 包括订单中的尺寸等货物具体参数
transportMode UpdatedTransportMode 包括订单中的货运信息
revenue UpdatedRevenue 收入
cost UpdatedRevenue 成本
tempThreshold UpdatedTemperature 温度报警阈值。仅适用于货物类型为2 (温控货物) 或4 (危险品和温控货物) 的订单
customFields UpdatedCustomFields 自定义字段。这适用于启用并且正确配置了自定义字段的公司。
requireEpod boolean 要求电子回单。当标记为 true 时必须电子回单,false 时电子回单是可选择的。
businessType string 订单类型
result OrderImportResult -

UpdatedOrderLine

字段名 类型 是否必填 描述 示例
cargoDescription UpdatedCargoDescription 货物/产品详细描述。这个节点与externalId可以二选一。externalId节点是字符串类型,表示基础数据中预定义的货物/产品 ID
quantity integer (int32) 货物/产品的数量
weight number 总重量,单位公斤
volume number 总体积,单位立方米
insuranceValue number 总投保价值
remarks string 货物/产品信息的用户备注
customFields UpdatedCustomFields 自定义字段。这适用于启用并且正确配置了自定义字段的公司。

UpdatedRevenue

字段名 类型 是否必填 描述 示例
lineHaul string 基础费率,精确到12位,2位小数
revokeCompensation boolean -
revokeSpecial boolean -
baseRateDescription string 运输费用 (干线) 描述
other string 其他费用,精确到12位,2位小数
otherFeesDescription string 其他费用描述

UpdatedTemperature

字段名 类型 是否必填 描述 示例
minTemp string 当温度低于设定值时,系统会报警。单位为摄氏度,取值范围(-10000-10000),2位小数
maxTemp string 当温度高于设定值时,系统会报警。单位为摄氏度,取值范围(-10000-10000),2位小数
incubatorNumbers string 订单绑定的温控箱编号, 可以绑定多个编号, 用分号分割
null boolean -

UpdatedTimeSchedule

字段名 类型 是否必填 描述 示例
pickupDate string 提货日期 (仅日期不含时间,中国标准时区) , 形如:2017-09-30
pickupDateRemarks string 关于提货日期/时间的备注
deliveryDate string 送货日期 (仅日期不含时间,中国标准时区) , 形如:2017-09-30
deliveryDateRemarks string 关于送货日期/时间的备注
pickupTimeFrom string 提货开始时间, 形如:08:05:00
pickupTimeTo string 提货结束时间, 形如:20:45:00
deliveryTimeFrom string 送货开始时间, 形如:08:05:00
deliveryTimeTo string 送货结束时间, 形如:20:45:00

UpdatedTransportMode

字段名 类型 是否必填 描述 示例
transportType string 货物运输类型,包括如下常量:
FTL - 整车
LTL - 零担
AIR - 空运
EXPRESS - 快递
RAIL - 铁路
WATER - 水运
truckType string 必需的卡车类型,包括如下常量:
0 - 敞篷车
1 - 厢式车
2 - 任意
3 - 轿运车
4 - 油罐车
5 - 飞翼车
transportRemarks string 运输模式的备注
loadingMeter string 卡车的装载米数,取值范围 (0-1000)
truckLength string 车长。如果存在,必须从已经定义好的值中选择,按公司分别设置,取值范围 (0-100)
truckCbmCapacity string 卡车装载(立方米)。如果存在,必须从已经定义好的值中选择,按车长对应装载 (立方米) ,取值范围 (0-100)
truckMtCapacity string 卡车装载 (吨)。如果存在,必须从已经定义好的值中选择,按车长对应装载 (吨) ,取值范围 (0-1000)

报文示例

请求示例

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<orderUpdateRequest version="0.1" login="username" password="password">
    <orders>
        <order sequence="1">
            <clientReferenceNumber>B1612</clientReferenceNumber>
            <branch>TJ Transfers - MSS1</branch>
            <erpNumber>ERP-2017101702</erpNumber>
            <orderRemarks>B16122304</orderRemarks>
            <policyNumber>C16122304</policyNumber>
            <shipFrom>
                <companyName>company</companyName>
                <postcode>100010</postcode>
                <province>上海</province>
                <town>上海市</town>
                <county>浦东新区</county>
                <address>address</address>
                <loading>false</loading>
                <xttSupport>true</xttSupport>
                <contact>
                    <name>test</name>
                    <phone>88888888</phone>
                    <phoneAreaCode>132</phoneAreaCode>
                    <mobile>15025661622</mobile>
                    <email>lcs0816@163.com</email>
                </contact>
                <locationRemarks>remarks</locationRemarks>
                <customFields>
                    <customText1>2</customText1>
                    <customText2>2</customText2>
                    <customText3>3</customText3>
                    <customText4>4</customText4>
                    <customText5>5</customText5>
                    <customText6>6</customText6>
                    <customText7>7</customText7>
                    <customText8>8</customText8>
                    <customText9>9</customText9>
                    <customText10>10</customText10>
                    <customText11>11</customText11>
                    <customText12>12</customText12>
                    <customText13>13</customText13>
                    <customText14>14</customText14>
                    <customText15>15</customText15>
                    <customText16>16</customText16>
                    <customText17>17</customText17>
                    <customText18>18</customText18>
                    <customText19>19</customText19>
                    <customText20>20</customText20>
                    <customText21>21</customText21>
                    <customText22>22</customText22>
                    <customText23>23</customText23>
                    <customText24>24</customText24>
                    <customText25>25</customText25>
                    <customText26>26</customText26>
                    <customText27>27</customText27>
                    <customText28>28</customText28>
                    <customText29>29</customText29>
                    <customText30>36</customText30>
                    <customNum1>10</customNum1>
                    <customNum2>20</customNum2>
                    <customNum3>30</customNum3>
                    <customNum4>40</customNum4>
                    <customNum5>50</customNum5>
                    <customNum6>60</customNum6>
                    <customNum7>70</customNum7>
                    <customNum8>80</customNum8>
                    <customNum9>91</customNum9>
                    <customNum10>100.123456</customNum10>
                    <customEnum1>Inbound</customEnum1>
                    <customEnum2>STONE</customEnum2>
                    <customEnum3>JL</customEnum3>
                    <customEnum4>FOL</customEnum4>
                    <customEnum5>BJTJ</customEnum5>
                    <customEnum6>LOGISTIC</customEnum6>
                    <customEnum7>enum7</customEnum7>
                    <customEnum8>enum8</customEnum8>
                    <customEnum9>enum9</customEnum9>
                    <customEnum10>enum10</customEnum10>
                </customFields>
                <notifyRadius>10</notifyRadius>
            </shipFrom>
            <shipTo>
                <companyName>company</companyName>
                <postcode>100011</postcode>
                <province>上海</province>
                <town>上海市</town>
                <county>普陀区</county>
                <address>address</address>
                <loading>false</loading>
                <xttSupport>true</xttSupport>
                <contact>
                    <name>test</name>
                    <phone>88888888</phone>
                    <phoneAreaCode>132</phoneAreaCode>
                    <mobile>15025661622</mobile>
                    <email>lcs0816@163.com</email>
                </contact>
                <locationRemarks>remarks</locationRemarks>
                <customFields>
                    <customText1>2</customText1>
                    <customText2>2</customText2>
                    <customText3>3</customText3>
                    <customText4>4</customText4>
                    <customText5>5</customText5>
                    <customText6>6</customText6>
                    <customText7>7</customText7>
                    <customText8>8</customText8>
                    <customText9>9</customText9>
                    <customText10>10</customText10>
                    <customText11>11</customText11>
                    <customText12>12</customText12>
                    <customText13>13</customText13>
                    <customText14>14</customText14>
                    <customText15>15</customText15>
                    <customText16>16</customText16>
                    <customText17>17</customText17>
                    <customText18>18</customText18>
                    <customText19>19</customText19>
                    <customText20>20</customText20>
                    <customText21>21</customText21>
                    <customText22>22</customText22>
                    <customText23>23</customText23>
                    <customText24>24</customText24>
                    <customText25>25</customText25>
                    <customText26>26</customText26>
                    <customText27>27</customText27>
                    <customText28>28</customText28>
                    <customText29>29</customText29>
                    <customText30>36</customText30>
                    <customNum1>10</customNum1>
                    <customNum2>20</customNum2>
                    <customNum3>30</customNum3>
                    <customNum4>40</customNum4>
                    <customNum5>50</customNum5>
                    <customNum6>60</customNum6>
                    <customNum7>70</customNum7>
                    <customNum8>80</customNum8>
                    <customNum9>91</customNum9>
                    <customNum10>100.123456</customNum10>
                    <customEnum1>Inbound</customEnum1>
                    <customEnum2>STONE</customEnum2>
                    <customEnum3>JL</customEnum3>
                    <customEnum4>FOL</customEnum4>
                    <customEnum5>BJTJ</customEnum5>
                    <customEnum6>LOGISTIC</customEnum6>
                    <customEnum7>enum7</customEnum7>
                    <customEnum8>enum8</customEnum8>
                    <customEnum9>enum9</customEnum9>
                    <customEnum10>enum10</customEnum10>
                </customFields>
                <notifyRadius>10</notifyRadius>
            </shipTo>
            <timeSchedule>
                <pickupDate>2016-12-09</pickupDate>
                <pickupDateRemarks>remarks</pickupDateRemarks>
                <deliveryDate>2016-12-09</deliveryDate>
                <deliveryDateRemarks>remarks</deliveryDateRemarks>
                <pickupTimeFrom>00:00:00</pickupTimeFrom>
                <pickupTimeTo>23:59:59</pickupTimeTo>
                <deliveryTimeFrom>00:00:00</deliveryTimeFrom>
                <deliveryTimeTo>23:59:59</deliveryTimeTo>
            </timeSchedule>
            <orderLines>
                <orderLine>
                    <cargoDescription>
                        <productCode>0024916022900069</productCode>
                        <productName>trousers</productName>
                        <unitType>4</unitType>
                        <stackable>2</stackable>
                        <unitLength>1</unitLength>
                        <unitWidth>1</unitWidth>
                        <unitHeight>1</unitHeight>
                        <unitWeight>1</unitWeight>
                        <unitInsurance>5</unitInsurance>
                    </cargoDescription>
                    <quantity>100</quantity>
                    <weight>100</weight>
                    <volume>100</volume>
                    <insuranceValue>500</insuranceValue>
                    <remarks>500</remarks>
                    <customFields>
                        <customText1>2</customText1>
                        <customText2>2</customText2>
                        <customText3>3</customText3>
                        <customText4>4</customText4>
                        <customText5>5</customText5>
                        <customText6>6</customText6>
                        <customText7>7</customText7>
                        <customText8>8</customText8>
                        <customText9>9</customText9>
                        <customText10>10</customText10>
                        <customText11>11</customText11>
                        <customText12>12</customText12>
                        <customText13>13</customText13>
                        <customText14>14</customText14>
                        <customText15>15</customText15>
                        <customText16>16</customText16>
                        <customText17>17</customText17>
                        <customText18>18</customText18>
                        <customText19>19</customText19>
                        <customText20>20</customText20>
                        <customText21>21</customText21>
                        <customText22>22</customText22>
                        <customText23>23</customText23>
                        <customText24>24</customText24>
                        <customText25>25</customText25>
                        <customText26>26</customText26>
                        <customText27>27</customText27>
                        <customText28>28</customText28>
                        <customText29>29</customText29>
                        <customText30>36</customText30>
                        <customNum1>10</customNum1>
                        <customNum2>20</customNum2>
                        <customNum3>30</customNum3>
                        <customNum4>40</customNum4>
                        <customNum5>50</customNum5>
                        <customNum6>60</customNum6>
                        <customNum7>70</customNum7>
                        <customNum8>80</customNum8>
                        <customNum9>91</customNum9>
                        <customNum10>100.123456</customNum10>
                        <customEnum1>Inbound</customEnum1>
                        <customEnum2>STONE</customEnum2>
                        <customEnum3>JL</customEnum3>
                        <customEnum4>FOL</customEnum4>
                        <customEnum5>BJTJ</customEnum5>
                        <customEnum6>LOGISTIC</customEnum6>
                        <customEnum7>enum7</customEnum7>
                        <customEnum8>enum8</customEnum8>
                        <customEnum9>enum9</customEnum9>
                        <customEnum10>enum10</customEnum10>
                    </customFields>
                </orderLine>
            </orderLines>
            <concealOrderLines>false</concealOrderLines>
            <rejectDraft>true</rejectDraft>
            <cargoDetails>
                <totalQuantity>100</totalQuantity>
                <totalWeight>11</totalWeight>
                <totalVolume>100</totalVolume>
                <totalInsurance>100</totalInsurance>
                <cargoType>1</cargoType>
                <packageType>A</packageType>
            </cargoDetails>
            <transportMode>
                <transportType>LTL</transportType>
                <truckType>2</truckType>
                <transportRemarks>these are remarks</transportRemarks>
                <loadingMeter>20</loadingMeter>
                <truckLength>20</truckLength>
                <truckCbmCapacity>20</truckCbmCapacity>
                <truckMtCapacity>20</truckMtCapacity>
            </transportMode>
            <revenue>
                <lineHaul>11.11</lineHaul>
                <baseRateDescription>line revenue</baseRateDescription>
                <other>11.11</other>
                <otherFeesDescription>other revenue</otherFeesDescription>
            </revenue>
            <cost>
                <lineHaul>11.11</lineHaul>
                <baseRateDescription>line revenue</baseRateDescription>
                <other>11.11</other>
                <otherFeesDescription>other revenue</otherFeesDescription>
            </cost>
            <tempThreshold>
                <minTemp>1</minTemp>
                <maxTemp>2</maxTemp>
                <incubatorNumbers>w111</incubatorNumbers>
            </tempThreshold>
            <customFields>
                <customText1>2</customText1>
                <customText2>2</customText2>
                <customText3>3</customText3>
                <customText4>4</customText4>
                <customText5>5</customText5>
                <customText6>6</customText6>
                <customText7>7</customText7>
                <customText8>8</customText8>
                <customText9>9</customText9>
                <customText10>10</customText10>
                <customText11>11</customText11>
                <customText12>12</customText12>
                <customText13>13</customText13>
                <customText14>14</customText14>
                <customText15>15</customText15>
                <customText16>16</customText16>
                <customText17>17</customText17>
                <customText18>18</customText18>
                <customText19>19</customText19>
                <customText20>20</customText20>
                <customText21>21</customText21>
                <customText22>22</customText22>
                <customText23>23</customText23>
                <customText24>24</customText24>
                <customText25>25</customText25>
                <customText26>26</customText26>
                <customText27>27</customText27>
                <customText28>28</customText28>
                <customText29>29</customText29>
                <customText30>36</customText30>
                <customNum1>10</customNum1>
                <customNum2>20</customNum2>
                <customNum3>30</customNum3>
                <customNum4>40</customNum4>
                <customNum5>50</customNum5>
                <customNum6>60</customNum6>
                <customNum7>70</customNum7>
                <customNum8>80</customNum8>
                <customNum9>91</customNum9>
                <customNum10>100.123456</customNum10>
                <customEnum1>Inbound</customEnum1>
                <customEnum2>STONE</customEnum2>
                <customEnum3>JL</customEnum3>
                <customEnum4>FOL</customEnum4>
                <customEnum5>BJTJ</customEnum5>
                <customEnum6>LOGISTIC</customEnum6>
                <customEnum7>enum7</customEnum7>
                <customEnum8>enum8</customEnum8>
                <customEnum9>enum9</customEnum9>
                <customEnum10>enum10</customEnum10>
            </customFields>
            <requireEpod>true</requireEpod>
            <businessType>aaa</businessType>
        </order>
    </orders>
</orderUpdateRequest>

响应示例

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<orderUpdateResponse version="0.1">
    <responseCode/>
    <processedOrders>1</processedOrders>
    <orders>
        <order sequence="1">
            <erpNumber>ERP-2017101702</erpNumber>
            <orderNumber>BESTSELL935000</orderNumber>
            <updateStatus>UPDATED</updateStatus>
            <responseCodes>
                <responseCode>
                    <code>7022</code>
                </responseCode>
                <responseCode>
                    <code>7044</code>
                </responseCode>
                <responseCode>
                    <code>7032</code>
                </responseCode>
                <responseCode>
                    <code>7045</code>
                </responseCode>
                <responseCode>
                    <code>7037</code>
                </responseCode>
                <responseCode>
                    <code>7029</code>
                </responseCode>
            </responseCodes>
        </order>
    </orders>
</orderUpdateResponse>

错误码解释

全局反馈代码

反馈代码 说明
0客户验证失败
1不支持的请求版本
2请求中的更新订单过多

单个请求反馈代码

反馈代码 说明
7000客户代码未找到。
7001无效的数据类型。
7002分公司未识别,或用户权限不匹配。
7003订单匹配结果不唯一。
7004用户地区权限不匹配。
7005试图更新的订单不是由导入接口导入。更新被拒绝。
7006订单不属于该公司。
7007不允许更新拆量订单的数量、重量、体积以及投保价值。
7008已入账单的订单不允许更新。
7009订单不存在。
7010存在货差的订单不允许更新。
7011地区不存在。
7012提货时间数据无效。
7013送货时间数据无效。
7014shipFromExternalId发货方外部代码未找到。
7015shipToExternalId收货方外部代码未找到。
7016发货方订阅外部订单追踪,必须提供邮箱或手机号码。
7017收货方订阅外部订单追踪,必须提供邮箱或手机号码。
7018发货方外部代码重复。
7019收货方外部代码重复。
7020取货地址和送货地址相同。
7021运输信息不完整 (1.缺少运输模式,2.零担/整车运输模式时缺少卡车类型,3.整车运输模式时缺少车长) 。
7022truckType车辆类型不匹配。
7023truckType车辆类型匹配结果不唯一。
7024产品类别无效。
7025缺少货物/产品信息。订单明细中至少需提供externalId或cargoDescription之一。
7026externalId货物(产品)外部代码未找到。
7027货物(产品)外部代码重复。
7028温度报警的低温阈值不得超过高温阈值。
7029订单的货物类型不支持温度报警。
7030订单的包装类型不需要温控箱。
7031收货方oTMS邮政编码只与乡镇匹配。
7032收货方邮政编码只与6位邮政编码匹配。
7033收货方oTMS邮政编码不匹配。
7034收货方oTMS邮政编码与6位和乡镇匹配。
7035收货方oTMS邮政编码只与区县匹配。
7036发货方oTMS邮政编码匹配到乡镇。
7037发货方oTMS邮政编码只与6位邮政编码匹配。
7038发货方oTMS邮政编码不匹配。
7039发货方oTMS邮政编码与6位和乡镇的都匹配。
7040发货方oTMS邮政编码只与区县匹配。
7041订单的重量或体积超过公司限定。
7042无效的温控箱编号。
7043自定义字段不能识别——可能公司已经取消了自定义字段。订单不能更新。
7044未定义的自定义字段枚举值。订单不能更新。
7045未启用自定义字段,将忽略更新订单中的自定义字段。
7046订单缺少必填的自定义字段。订单不能更新。
7047拒绝草稿状态订单。rejectDraft为true时,不完整订单将被拒绝而非进入草稿箱。
7048订单明细缺少必填的自定义字段。订单不能更新。
7049无效的订单类型。
7050订单的货物信息不完整。
7051承运商账户通过erpNumber更新订单时必须提供clientCode。
7052订单价格文件不匹配。
7053订单信息不完整。
7054订单优化进行中,更新被拒绝。
7100其他错误。

API工具