API开放文档

SERVICE SUPPORT

API开放文档

快件业务接口(C2C)

创建发货单

接口描述

客户通过调用此接口推送订单:

  1.接收订单信息后,根据订单信息生成对应的运单号码并返回;

  2.成功推送后,重复推送会提示,发货单已存在;

接入方式

1. HTTP接入

接口名称 创建发货单
接口方向 客户  →  海淘通
method createQuickOrder
接口测试地址 https://omstest.nbhtt.com/index.php/API/OrderInfoTest/createQuickOrder.html
接口生产地址 https://httapi.nbhtt.com:8017/api/createQuickOrder

2. 请求参数

参数 类型 必填 说明 备注
DealerShopCodevarchar(10)是对应店铺编码
SaleOrderCodevarchar(100)是订单号
BuyerAccountvarchar(100)是买家账号
BuyerNickNamevarchar(100)是买家昵称
Provincevarchar(50)是省
Cityvarchar(51)是市
Districtvarchar(52)是区
Addressvarchar(1000)是收货地址
ReceiverNamevarchar(50)是收件人
ReceiverPhonevarchar(50)是联系电话
ZipCodevarchar(10)是邮编
BuyerNamevarchar(50)是真实姓名
IdCardvarchar(50)是身份证号
OrderPaymentdecimal是订单金额(元)
PostFeedecimal是运费(元)
BuyerPaymentdecimal是实付金额(元)
InsuranceFeedecimal否保价费(元)
Currentvarchar(50)是币种(142=人民币,116=日元)
LogisticsNumbervarchar(50)否运单号
Weightdecimal(19,3)否称重/kg 哲盟转运系统使用
PaymentMethodvarchar(50)否支付方式编码
PaymentCodevarchar(100)否支付单号
PaymentOrderSeqvarchar(100)否支付订单号
CredentialUrlvarchar(100)否凭据链接地址
CredentialBase64varchar否凭据图片base64数据流(CredentialUrl字段不为空时,此字段数据不使用)
IdCardFrontUrlvarchar否身份证正面链接地址
IdCardFrontBase64varchar否身份证正面base64数据流(IdCardFrontUrl字段不为空时,此字段数据不使用)
IdCardBackUrlvarchar否身份证反面链接地址
IdCardBackBase64varchar否身份证反面base64数据流(IdCardBackUrl字段不为空时,此字段数据不使用)
SellerRemarkvarchar(1000)否卖家备注
BuyerRemarkvarchar(1000)否买家备注
CreateTimedatetime是下单时间(格式:yyyy-MM-dd HH:mm:ss)
PayTimedatetime否付款时间(格式:yyyy-MM-dd HH:mm:ss)
DistributionCodevarchar(100)否分销商代码
GrossWeightdecimal(19,3)否包裹毛重/kg
DedicatedLineCodevarchar(100)是专线代码
ImportExportFlagvarchar(100)是进出口标志(I/E)
QuasiTransportLogisticsCodevarchar(100)否转运快递公司编码(获取国际快递单号)
LogisticsCodevarchar(100)是快递公司编码(国内快递单号)
Details商品明细
Detail
ProductNumberCodevarchar(50)是货号
SaleGoodsNamevarchar(100)是商品名
SaleGoodsEngNamevarchar(100)是商品名(英)
SaleGoodsHsCodevarchar(100)否HS编码
CodeTsvarchar(100)是行邮税号
SaleGoodsPricedecimal是单价(元)
SaleNumberdecimal是数量
SaleSubTotaldecimal是金额(元)
Unitvarchar(100)是计量单位,参考海关文档,罐=122
NetWeightdecimal(19,3)是净重/kg
OriginCountryvarchar(100)是原产国代码,参考海关文档(日本=116)
Specvarchar(100)是规格
Currencyvarchar(100)是币制(142=人民币,116=日元)
Detail
Details
ServiceList增值服务
Service
Namevarchar(100)否服务编码,有增值服务需求时填写
Valuevarchar(100)否扩展字段、根据增值服务选填
Value1varchar(100)否扩展字段、根据增值服务选填
Value2varchar(100)否扩展字段、根据增值服务选填
Service
ServiceList

3. 返回值

参数 类型 必填 说明 备注
Result varchar(50) 是 返回结果 T:成功,F:失败
ResultMsg varchar(200) 否 返回信息
SaleOrderCode varchar(200) 否 订单号
LogisticsNumber varchar(200) 否 快递单号
LogisticsName varchar(200) 否 快递公司
QuasiTransportLogisticsNumber varchar(200) 否 转运快递单号(国际单号)
QuasiTransportLogisticsName varchar(200) 否 转运快递公司
MarkPlace varchar(200) 否 大头笔

4. 请求报文示例

postman测试接口传参样例

sign :md5里面 用各参数按md5(user_code Password xml 秘钥) 格式拼接加密(加密间隔不用加点),另外请用表单上传,不要用json

测试所需的账号,需要测试前,申请开通