oTMS-openapi
  1. oTMS API
oTMS-openapi
  • oTMS API
    • 订单导入
      PUT
    • 订单导出/追踪
      POST
    • 提送货点导入
      PUT
    • 提送货点删除
      DELETE
    • 卡车和司机导入
      PUT
    • 订单分配司机
      POST
    • 运输单导入
      PUT
    • 运输单删除
      PUT
    • 订单外部追踪
      POST
    • 订单召回
      POST
    • 订单分享链接
      PUT
    • 承运商导出
      POST
    • h5链接
      PUT
    • 订单更新
      PUT
    • 订单费用更新
      POST
    • 订单分配
      POST
    • 车辆信息
      POST
    • 订单撤销
      PUT
    • 运输单分配司机
      PUT
    • 订单评分
      POST
    • 订单交接创建
      PUT
    • 订单自定义文本字段更新
      POST
    • 订单快速交接
      POST
    • 价格文件匹配
      POST
    • 收货方/发货方导出
      POST
    • 运输单导出/追踪
      POST
    • 运输单召回
      PUT
    • 文件上传
      POST
    • 订单事件推送
      PUT
    • 运输单事件推送
      PUT
    • 拒收导出
      POST
    • 收货码查询
      POST
    • 便携式设备导入
      POST
  1. oTMS API

提送货点删除

DELETE
https://login.otms.cn/ws/shipPointImport

提送货点删除#

通过提送货点删除接口,可以将之前从外部系统导入的提送货点数据进行批量的删除。
版本号文档说明
0.1当前版本文档

配置说明#

oTMS同时在生产环境和测试环境中提供Web Service接口,其中测试环境用于集成测试。两种环境下都需要由oTMS系统管理员分配API帐号密码后方可使用。
注意: 请合理地调用公共接口。如果发现存在异常调用或者对我们系统性能造成影响等情况,会对API账号的调用进行限制,甚至停用。
目前对该接口的调用限制为每个公司每秒最多3个请求(如需增加可选购增值服务)

接口说明#

公共参数#

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

请求参数#

字段名位置是否必填描述Schema
bodybody是提送货点删除请求ShipPointRemoveRequest
Authorizationheader否Basic Authorization。如果不为空,则优先使用该值作身份认证。否则使用请求报文中的用户名与密码string

错误码解释#

全局反馈代码#

反馈代码说明
0客户验证失败。
1不支持的请求版本。
2请求中的提送货点数据过多。

单个请求反馈代码#

反馈代码说明
1000客户代码未找到。
1001无效的数据类型。
1002备用。
1009发货方外部代码重复。
1010收货方外部代码重复。
1013发货方oTMS邮政编码匹配到乡镇。
1014发货方oTMS邮政编码只与6位邮政编码匹配。
1015发货方oTMS邮政编码不匹配。
1016发货方oTMS邮政编码与6位和乡镇的都匹配。
1017收货方oTMS邮政编码只与乡镇匹配。
1018收货方邮政编码只与6位邮政编码匹配。
1019收货方oTMS邮政编码不匹配。
1020收货方oTMS邮政编码与6位和乡镇匹配。
1030自定义字段不能识别;公司设置已关闭自定义字段,或自定义字段设置错误。
1040地区不存在。
1043分公司未识别,或用户权限不匹配。
1045没有匹配的提送货点。
1046集散点外部代码重复。
1047集散点上仍存在系统中维护的员工,无法删除。
1048集散点上仍存在未处理完成的订单,无法删除。
1050不支持XTT——公司设置已关闭XTT选项。
1051选择XTT支持但未提供Email地址。
1055不支持短信通知——公司设置已关闭短信通知选项。
1056选择短信通知但未提供手机号码。
1060已禁用分公司——忽略分公司设置。
1100其他错误。

请求参数

Body 参数application/xml

示例
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<shipPointRemoveRequest version="0.1" login="username" password="password">
    <shipPoints>
        <shipPoint sequence="1">
            <clientReferenceNumber>sh00105001</clientReferenceNumber>
            <type>0</type>
            <externalId>11223344</externalId>
        </shipPoint>
        <shipPoint sequence="2">
            <clientReferenceNumber>sh00105002</clientReferenceNumber>
            <type>1</type>
            <externalId>22334455</externalId>
        </shipPoint>
    </shipPoints>
</shipPointRemoveRequest>

返回响应

🟢200成功
application/xml
successful operation
Body

示例
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<shipPointRemoveResponse version="0.1">
    <responseCode></responseCode>
    <processedShipPoints>2</processedShipPoints>
    <shipPoints>
        <shipPoint>
            <clientReferenceNumber>sh00105001</clientReferenceNumber>
            <importStatus>REMOVED</importStatus>
            <responseCodes/>
        </shipPoint>
        <shipPoint>
            <clientReferenceNumber>sh00105002</clientReferenceNumber>
            <importStatus>REMOVED</importStatus>
            <responseCodes/>
        </shipPoint>
    </shipPoints>
</shipPointRemoveResponse>
上一页
提送货点导入
下一页
卡车和司机导入
Built with