WorldFirst DocsWorldFirst Docs

createDelivery需要签名验签

POST /amsin/api/v1/business/worldtrade/createDelivery

集成商可调用此接口进行订单发货。

在调用此接口之前,调用 uploadAttachment 接口以获取发货所需的 fileName fileKey 参数。

报文结构

万里汇接口的报文结构包括:请求头、请求体、响应头和响应体。该章节主要介绍请求体和响应体的结构。关于请求头和响应头的更多信息,参见:

入参

requestId String  REQUIRED

针对本次发货请求,由集成商指定的唯一请求号。

更多信息:

  • 此为幂等字段。
  • 最大长度:64 字符

tradeId String  REQUIRED

WorldTrade系统生成的订单ID。

更多信息:

  • 最大长度:64 字符

relateProductList Array<RelateProduct>  REQUIRED

本次发货关联的商品列表。

Show child parameters

logisticsVoucherType String  REQUIRED

物流凭证类型。可取值范围:

  • LOGISTICS_BILL 物流单
  • ENTRY_BILL 报关单
  • 当您订单的发货地为 MAINLAND 且订单金额大于 10000 USD时,此字段取值必须为 ENTRY_BILL
  • 您订单的发货地为 OVERSEAS 时,此字段取值必须为 LOGISTICS_BILL

logisticsTrackingNo String  CONDITIONAL

物流单号。

更多信息:

  • 字符长度范围:4 - 64 字符
  • 字母或数字不可完全重复

当 logisticsVoucherType 字段取值为 LOGISTICS_BILL 时,此字段为必传

logisticsWaybillList Array<File>  CONDITIONAL

物流面单附件。

logisticsVoucherType 字段取值为 LOGISTICS_BILL 时,此字段为必传

Show child parameters

fileList Array<File>  CONDITIONAL

其他附件。

logisticsVoucherType 字段取值为 ​LOGISTICS_BILL ​时,此字段可按需传入。

Show child parameters

entryOrderNo String  CONDITIONAL

报关单号。

更多信息:

  • 字符长度范围:4 - 64 字符

当 logisticsVoucherType 字段取值为 ENTRY_BILL 时,此字段为必传

entryOrderList Array<File>  CONDITIONAL

报关单附件。

当 logisticsVoucherType 字段取值为 ENTRY_BILL 时,此字段为必传

Show child parameters

superviseType String  CONDITIONAL

监管方式。可取值范围:

  • 9710 跨境电商B2B出口
  • 0110 一般贸易B2B出口

logisticsVoucherType 字段取值为 ENTRY_BILL 时,此字段为必传

carrierCode String  CONDITIONAL

承运商编码。

取值包括:KY479KY176等,完整取值详见:ProviderKey

logisticsVoucherType 字段取值为 ​LOGISTICS_BILL ​时,此字段为必传。

更多信息:

  • 最大长度:32 字符

carrierName String  CONDITIONAL

承运商名称。完整取值详见:ProviderKey

logisticsVoucherType 字段取值为 ​LOGISTICS_BILL​ 时,此字段为必传。

更多信息:

  • 最大长度:64 字符

出参

result Result  REQUIRED

代表 API 接口调用结果。

Show child parameters

requestId String  REQUIRED

针对本次发货请求,由集成商指定的唯一请求号。

更多信息:

  • 最大长度:64 字符

deliveryBatchId String  REQUIRED

发货批次单号。

更多信息:

  • 最大长度:64 字符
API Explorer

请求

URL
请求体

响应

响应体

响应处理

集成商调用接口后,万里汇返回集成商API调用结果。result.resultStatus 字段取值范围为:

result.resultStatus

描述

S

API请求成功。

F

API请求失败。

失败原因参见结果码(即 result.resultCode 和 result.resultMessage

U

API响应结果为UNKNOWN(未知)时,需重试API请求。

重试策略:

  • 重试次数上限:7次
  • 重试时间间隔:5分钟、10分钟、20分钟、40分钟、80分钟、160分钟、320分钟

如果问题依旧,请联系万里汇技术支持。

result.resultCode:系统结果码

结果码结果码信息行动建议
SUCCESSSSuccess
PROCESS_FAILFA general business failure occurred. Do Not retry.

需要人工介入,联系万里汇技术支持以解决此问题

PARAM_ILLEGALFIllegal parameters exist. For example, a non-numeric input, or an invalid date.

确认请求正确加签

INVALID_SIGNATUREFThe signature is invalid.

确认请求正确加签

REPEAT_REQ_INCONSISTENTFRepeated requests are inconsistent.

重试请求不一致,需保证所有请求参数均相同

UNKNOWN_EXCEPTIONUAPI failed due to unknown reason.

服务器错误,若稍后重试问题依旧,联系万里汇技术支持以解决问题

FILE_SIZE_EXCEED_LIMITFThe file size has exceeded the limit.

文件大小需在允许范围内

CONTRACT_CHECK_FAILFThe contract check has failed.

检查合约状态后重试

result.resultCode:业务结果码

结果码结果码信息行动建议
SYSTEM_EXCEPTIONFSystem exception.

需要人工介入,联系WorldTrade客户服务经理以解决此问题

PARAM_ILLEGALFIllegal parameters exist. For example, a non-numeric input, or an invalid date.

请检查参数后重试

OPERATION_PROHIBITEDFThe current order status does not allow operation of the shipment batch.

此订单无法发货。调用 queryTradeOrder 接口查询当前订单状态。

BATCH_EXCEED_LIMITFThe number of delivery batches exceeds limit.

需要人工介入,联系WorldTrade客户服务经理以解决此问题

PRODUCT_NOT_EXISTFThe product does not exist.

确认 relateProductList.productId 参数传值正确后重试

PRODUCT_TYPE_ERRORFThe product type is incorrect.

请检查参数后重试

INCORRECT_PRODUCT_QUANTITYFThe product quantity is incorrect.

修改relateProductList.productQuantity 参数中的关联商品数量,并使用新的requestId 重试

INCORRECT_VOUCHER_TYPEFThe voucher type is incorrect.

使用正确的logisticsVoucherType 参数后重试

SUPERVISE_TYPE_EMPTYFThe supervise type is empty.

传入superviseType 参数后重试

SUPERVISE_TYPE_ERRORFThe supervise type is incorrect.

修改superviseType 参数后重试

CARRIER_NAME_EMPTYFThe carrier name is empty.

使用有效的 carrierName 参数后重试

TRACKING_NUMBER_ERRORFThe logistics tracking number is incorrect.

使用正确的 logisticsTrackingNo 参数后重试

ORDER_NOT_EXISTFThe order does not exist.

修改 tradeId 参数后重试

USER_ERRORFThis order does not belong to the current user.

修改 tradeId 参数后重试