文档
测试

创建订单

POST
https://jk.qingguan.wang/Api/v1

接口描述

创建订单 (测试登录账号:test 登录密码:test 上线时联系业务员获取正式账号) 。请求参数组合成JSON后传输到body,组合格式请看下面的请求参数示例。

请求参数

application/json
参数名
类型
描述
必填
appcode
string
平台编码,固定传CHENGHAI
必填
useraccount
string
用户账号。注册系统的登录账号
必填
requesttype
string
固定传2001
必填
requestdata
string
请求报文,报文为JSON字符串。最终需将JSON字符串url编码。具体示例请看下面的请求示例
必填
渠道
string
渠道名称。可通过【获取渠道】接口查看,取获取渠道接口中的【渠道】字段
必填
订单号
string
客户订单号。
必填
收件人
JObject
收件人详细信息
必填
收件人姓名
string
收件人姓名
必填
收件人电话
string
收件人电话
必填
收件人身份证号
string
收件人身份证号
必填
收件人省份
string
收件人省份
必填
收件人城市
string
收件人城市
必填
收件人区
string
收件人区
必填
收件人详细地址
string
收件人详细地址
必填
收件人邮编
string
可选
发件人
JObject
发件人详细信息
必填
发件人姓名
string
发件人姓名
必填
发件人电话
string
发件人电话
必填
发件人国家
string
发件人国家
必填
发件人省份
string
发件人省份(发件人州)
必填
发件人城市
string
发件人城市(启运城市)
必填
发件人区
string
发件人区
可选
发件人详细地址
string
发件人详细地址
必填
商品信息
JArray
商品信息JArray数组
必填
商品名称
string
商品名称
必填
英文品名
string
英文品名
必填
规格
string
规格
必填
单位
string
单位
必填
数量
int
数量
必填
单价
decimal
单价
必填
净重
float
净重
必填
毛重
float
毛重
必填
原产国
string
原产国
必填
税号
string
税号
必填
sign
string
签名。签名方法请看签名规则
必填

响应参数

application/json
参数名
类型
描述
必填
state
string
1-成功 0-失败
必填
pkval
string
客户订单号。操作成功时有返回
可选
message
string
操作结果描述,失败时有返回
可选

说明 / 示例

请求参数示例: { "appcode":"CHENGHAI", "useraccount":"test", "sign":"MTU4NTI0NWNmNDg2MzRjMGJhNDQwZmQ2NGM4ZjdkNTc=", "requesttype":"2001", "requestdata":"%7B%22%E6%B8%A0%E9%..." //此处为下面请求报文url编码之后的值 } requestdata 原文格式 { "渠道": "系统默认", "订单号": "TEST00013", "收件人信息": { "收件人姓名": "张三", "收件人电话": "13800000000", "收件人身份证号": "", "收件人省份": "广东省", "收件人城市": "广州市", "收件人区": "花都区", "收件人详细地址": "安和大厦", "收件人邮编": "510000" }, "发件人信息": { "发件人姓名": "lisa", "发件人电话": "014574512", "发件人国家": "美国", "发件人省份": "纽约", "发件人城市": "A", "发件人区": "", "发件人详细地址": "ST 85TH" }, "商品信息": [{ "商品名称": "Vc", "英文品名": "VC", "规格": "50粒/瓶", "单位": "瓶", "数量": 2, "单价": "50.09", "净重": 0.36, "毛重": 1.2, "原产国": "美国", "税号": "1243252" }, { "商品名称": "运动鞋", "英文品名": "shoes", "规格": "36", "单位": "双", "数量": 1, "单价": "578.09", "净重": 0.36, "毛重": 1.2, "原产国": "美国", "税号": "124325266" }] }