订单自定义文本字段更新

通过订单自定义文本字段更新接口，可以将不同外部系统如ERP系统、WMS系统的大量订单进行批量的自定义文本字段更新。

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

配置说明

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

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

目前对该接口的调用限制为每个公司每秒最多3个请求（如需增加可选购增值服务）。

接口说明

公共参数

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

请求参数

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

错误码解释

全局反馈代码

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

单个请求反馈代码

反馈代码	说明
7000	客户代码未找到。
7001	无效的数据类型。
7003	订单匹配结果不唯一。
7004	用户地区权限不匹配。
7006	订单不属于该公司。
7008	已入账单的订单不允许更新。
7009	订单不存在。
7043	自定义字段不能识别——可能公司已经取消了自定义字段。订单不能更新。
7044	未定义的自定义字段枚举值。订单不能更新。
7045	未启用自定义字段，将忽略更新订单中的自定义字段。
7046	订单缺少必填的自定义字段。订单不能更新。
7051	承运商账户通过erpNumber更新订单时必须提供clientCode。
7054	订单优化进行中，更新被拒绝。
7100	其他错误。

请求参数

Body 参数application/xml

示例

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<orderCustomUpdateRequest version="0.1" login="username" password="password">
    <orders>
        <order sequence="1">
            <erpNumber>250321005</erpNumber>
            <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>
            </customFields>
        </order>
    </orders>
</orderCustomUpdateRequest>

返回响应

🟢200成功

application/xml

successful operation

Body

示例

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<orderUpdateResponse version="0.1">
    <responseCode></responseCode>
    <processedOrders>1</processedOrders>
    <orders>
        <order sequence="1">
            <erpNumber>250321005</erpNumber>
            <orderNumber>DYZZWDNW004662</orderNumber>
            <updateStatus>UPDATED</updateStatus>
            <responseCodes/>
            <errorColumnName></errorColumnName>
        </order>
    </orders>
</orderUpdateResponse>

订单自定义文本字段更新

订单自定义文本字段更新#

配置说明#

接口说明#

公共参数#

请求参数#

错误码解释#

全局反馈代码#

单个请求反馈代码#

请求参数

返回响应

订单自定义文本字段更新

配置说明

接口说明

公共参数

请求参数

错误码解释

全局反馈代码

单个请求反馈代码