API
查询派送方式
更新时间: 2024-06-07 10:19:12 访问次数:14998

接口说明

本接口可通过海外仓ID来查询该仓库对应的派送方式。

接口名称

queryDeliveryWay

请求说明

请求内容 说明
URL https://openapi.winit.com.cn/openapi/service
接口测试 https://sandboxopenapi.winit.com.cn/openapi/service
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,1000有需要可申请加大。

请求入参

名称 类型 必填 说明 示例
warehouseID String(10) Y 海外仓ID
由万邑通定义的仓库ID,每个仓库有唯一一个对应的ID。
通过接口queryWarehouse得到出参:warehouseID

请求示例

  1. {
  2. "action":"queryDeliveryWay",
  3. "app_key":"rebecca",
  4. "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5. "client_sign":"B022B0256BFFFCD6B6324B509227DEFE",
  6. "data":{
  7. "warehouseID":"1000008"
  8. },
  9. "format":"json",
  10. "language":"zh_CN",
  11. "platform":"OWNERERP",
  12. "sign":"EDDEADA930940E71E79005948944BFC1",
  13. "sign_method":"md5",
  14. "timestamp":"2015-06-16 00:19:26",
  15. "version":"1.0"
  16. }

返回出参

返回参数说明:正确的返回编码code:0及结果data,错误的返回错误码及错误信息msg。

名称 类型 必填 说明 示例
winitProductCode String(80) Y 派送方式代码
deliveryWay String(255) Y 派送方式名称
deliveryID String() Y 派送方式ID
deliveryType String() Y 派送类型:
MAIN:主派送方式
SUB:子派送方式

mainWinitProductCode String() O 主派送方式代码
当deliveryType为SUB时,必填

isMandoorplateNumbers String(1) O 派送方式是否门牌号必填
warehouseID String(10) Y 海外仓仓库ID
isCombinedService String(1) Y 是否组合服务(Y:是、N:否)
当返回“Y”此派送方式无法确定唯一的carrier(组合服务需按WINIT提供的平台派送商platformCarrier上传跟踪号)
当返回“N”此派送方式可以确定唯一的carrier
Y
VASList Array N 增值服务列表
serviceCode String() N 增值服务编码
serviceCodeType String() N 增值服务类型
DEFAULT:派送方式默认自带的增值服务
OPTIONAL:可供选择的增值服务(下单时需额外传增值服务编码)

VASList.attrList Array N 增值服务信息明细列表
attrUnit String() N 增值费用计费单位
minValue String() N 最小值
attrCode String() N 增值服务属性code
ISA:投保金额
投保金额ISA的最小值:0.01,最大是10000

maxValue String() N 最大值

返回示例

  1. {
  2. "code": "0",
  3. "msg": "操作成功",
  4. "data": [
  5. {
  6. "mainWinitProductCode": null,
  7. "deliveryID": 1000007765,
  8. "isMandoorplateNumbers": "N",
  9. "isCombinedService": "Y",
  10. "warehouseID": 1030045,
  11. "deliveryType": "MAIN",
  12. "deliveryWay": "Winit Fulfillment Plus-Standard (2-5 Business Days)-US",
  13. "winitProductCode": "OSF811007765",
  14. "warehouseCode": "USKY3"
  15. },
  16. {
  17. "mainWinitProductCode": null,
  18. "deliveryID": 1000368,
  19. "isMandoorplateNumbers": "N",
  20. "isCombinedService": "N",
  21. "warehouseID": 1000008,
  22. "deliveryType": "MAIN",
  23. "deliveryWay": "Test Last-mile Service(线下尾程派送服务)",
  24. "winitProductCode": "OSF820193"
  25. },
  26. {
  27. "mainWinitProductCode": null,
  28. "deliveryID": 202201458,
  29. "isMandoorplateNumbers": "N",
  30. "isCombinedService": "N",
  31. "warehouseID": 1000008,
  32. "deliveryType": "MAIN",
  33. "deliveryWay": "VAS-FedEx - Ground (Standard 1-5 Business Days)-USWC",
  34. "winitProductCode": "OSF811006458",
  35. "VASList": [
  36. {
  37. "serviceCodeType": "OPTIONAL",
  38. "serviceCode": "OSF777778",
  39. "attrList": [
  40. {
  41. "attrUnit": "CNY",
  42. "minValue": 1,
  43. "attrCode": "ISA",
  44. "maxValue": 10000
  45. }
  46. ]
  47. }
  48. ]
  49. },
  50. {
  51. "mainWinitProductCode": null,
  52. "deliveryID": 1000006517,
  53. "isMandoorplateNumbers": "N",
  54. "isCombinedService": "N",
  55. "warehouseID": 1000008,
  56. "deliveryType": "MAIN",
  57. "deliveryWay": "VAS - Self pick up service(palletzation)-FBA",
  58. "winitProductCode": "OSF821006517"
  59. },
  60. {
  61. "mainWinitProductCode": null,
  62. "deliveryID": 1000006628,
  63. "isMandoorplateNumbers": "N",
  64. "isCombinedService": "N",
  65. "warehouseID": 1000008,
  66. "deliveryType": "MAIN",
  67. "deliveryWay": "UPS - 3 Day Select Residential Sign (Express 3 Business Days)-USWC-测试",
  68. "winitProductCode": "OSF811006628",
  69. "VASList": [
  70. {
  71. "serviceCodeType": "OPTIONAL",
  72. "serviceCode": "OSF777778",
  73. "attrList": [
  74. {
  75. "attrUnit": "CNY",
  76. "minValue": 1,
  77. "attrCode": "ISA",
  78. "maxValue": 10000
  79. }
  80. ]
  81. }
  82. ]
  83. }
  84. ]
  85. }