文档

测试

创建订单

websocket测试

POST

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

接口描述

测试账号:test,密码 :test

请求参数

application/json

参数名

类型

描述

必填

appcode

string

平台编码，固定传TJY

必填

useraccount

string

用户账号。注册系统的登录账号

必填

requesttype

string

固定传2001

必填

requestdata

string

请求报文，报文为JSON字符串。最终需将JSON字符串url编码。具体示例请看下面的请求示例

必填

渠道

string

渠道名称。可通过【获取渠道】接口查看，取获取渠道接口中的【渠道】字段

必填

订单号

string

客户订单号。

必填

提单号

string

自定义的号码，用于区分一批订单的批次号

必填

重量（KG）

float

包裹重量

必填

收件人信息

JObject

收件人详细信息

必填

收件人姓名

string

收件人姓名

必填

收件人电话

string

收件人电话

必填

收件人省份

string

收件人省份

必填

收件人城市

string

收件人城市

必填

收件人区

string

收件人区

必填

收件人详细地址

string

收件人详细地址

必填

身份证号

string

收件人身份证号

必填

发件人信息

JObject

发件人详细信息

必填

发件人

string

发件人姓名

必填

电话

string

发件人电话

必填

省份

string

发件人省份(发件人州)，当传发件人完整地址时，此字段可直接传空字符串

必填

城市

string

发件人城市(启运城市)，当传发件人完整地址时，此字段可直接传空字符串

必填

区

string

发件人区，当传发件人完整地址时，此字段可直接传空字符串

必填

详细地址

string

发件人详细地址，当传发件人完整地址时，此字段可直接传空字符串

必填

地址

string

发件人完整地址（当传省份、城市、区、详细地址时，此字段可直接传空字符串）

必填

商品信息

JArray

商品信息JArray数组

必填

商品名称

string

商品名称

必填

数量

int

数量

必填

单价

decimal

单价

必填

商品重量

float

商品重量

必填

税号

string

税号

必填

sign

string

签名。签名方法请看签名规则

必填

响应参数

application/json

参数名

类型

描述

必填

state

string

1-成功 0-失败

必填

pkval

string

客户订单号。操作成功时有返回

可选

message

string

操作结果描述，失败时有返回

可选

说明 / 示例

请求参数示例： { "appcode":"TJY", "useraccount":"test", "sign":"MTU4NTI0NWNmNDg2MzRjMGJhNDQwZmQ2NGM4ZjdkNTc=", "requesttype":"2001", "requestdata":"%7B%22%E6%B8%A0%E9%..." //此处为下面请求报文url编码之后的值 } requestdata 原文格式 { "渠道": "E特快", "订单号": "TEST00013", "提单号": "20231101", "重量（KG）":1.23, "收件人信息": { "收件人姓名": "张三", "收件人电话": "13800000000", "收件人省份": "广东省", "收件人城市": "广州市", "收件人区": "花都区", "收件人详细地址": "安和大厦", "身份证号":"564564564565464" }, "发件人信息": { "发件人": "lisa", "电话": "014574512", "省份": "", "城市": "", "区": "", "详细地址": "", "地址":"纽约 A ST 85TH" }, "商品信息": [{ "商品名称": "Vc", "数量": 2, "单价": "50.09", "商品重量": 1.2, "税号": "1243252" }, { "商品名称": "运动鞋", "数量": 1, "单价": "578.09", "商品重量": 0.36, "税号": "124325266" }] }

上一篇获取渠道

nextDoc 取单号