礼品代发商城接口、圆通顺丰申通发货API
商城接口包含：更新商品信息、更新仓库列表、获取商品列表、获取商品信息、创建订单、提交支付、获取包裹列表、订单查询、取消发货、获取用户余额更新商品信息接口地址： http://api.vv-tool.com/shop/updates/update-product-list接口介绍: 更新礼品信息请求方式： POST传参方式： JSON返回格式： JSON接口收费： 开通一次，即可使用所有接口频率限制： 10 次/秒请求头参数参数类型必选值示例Authorizationstring是授权 access_token1798c6aadec33d1bc2f5b707f1049aefexxxx请求参数无请求参数请求示例无请求示例请求代码示例cURL请求代码示例PHP请求代码示例JAVA请求代码示例响应参数参数类型描述codeint返回状态码msgstring状态码描述msecint执行时间timeint结果返回时间dataobject返回结果信息返回数据{ "code": 0, "msg": "成功", "msec": 6741, "time": 1603442101, "data": []}更新仓库列表接口地址： http://api.vv-tool.com/shop/updates/update-warehouse-list接口介绍: 更新发货仓库及发货快递信息请求方式： POST传参方式： JSON返回格式： JSON接口收费： 开通一次，即可使用所有接口频率限制： 10 次/秒请求头参数参数类型必选值示例Authorizationstring是授权 access_token1798c6aadec33d1bc2f5b707f1049aefexxxx请求参数无请求参数请求示例无请求示例请求代码示例cURL请求代码示例PHP请求代码示例JAVA请求代码示例响应参数参数类型描述codeint返回状态码msgstring状态码描述msecint执行时间timeint结果返回时间dataobject返回结果信息返回数据{ "code": 0, "msg": "成功", "msec": 6741, "time": 1603442101, "data": []}获取商品列表接口地址： http://api.vv-tool.com/shop/apis/get-product-list接口介绍: 获取所有商品信息请求方式： POST传参方式： JSON返回格式： JSON接口收费： 开通一次，即可使用所有接口频率限制： 10 次/秒请求头参数参数类型必选值示例Authorizationstring是授权 access_token1798c6aadec33d1bc2f5b707f1049aefexxxx请求参数参数类型必选描述rangeint是页码请求示例{ "range":1,}请求代码示例cURL请求代码示例PHP请求代码示例JAVA请求代码示例响应参数参数类型描述codeint返回状态码msgstring状态码描述msecint执行时间timeint结果返回时间dataobject返回结果数据listobject结果集合statusstring商品状态sale_priceint售价warehouse_namestring仓库名称shipping_feeint运费idstring商品 idothumbstring商品缩略图product_namestring商品名字warehouse_idint仓库 idsite_priceint价格weightint重量stockint库存salesint销量totalint数据总数返回数据{ "code": 0, "msg": "成功", "msec": 343, "time": 1604479557, "data": { "list": [ { "status": "1", "sale_price": 0.38, "warehouse_name": "申通广州仓", "shipping_fee": "135", "id": "49367", "weight": "26", "othumb": null, "product_name": "洁厕宝", "warehouse_id": "31", "stock": "100000", "sales": "0" } ], "total": "17" }}获取商品信息接口地址： http://api.vv-tool.com/shop/apis/get-shop-info接口介绍: 获取每个商品详细信息请求方式： POST传参方式： JSON返回格式： JSON接口收费： 开通一次，即可使用所有接口频率限制： 10 次/秒请求头参数参数类型必选值示例Authorizationstring是授权 access_token1798c6aadec33d1bc2f5b707f1049aefexxxx请求参数参数类型必选描述idint是商品 id请求示例{ "id":49066}请求代码示例cURL请求代码示例PHP请求代码示例JAVA请求代码示例响应参数参数类型描述codeint返回状态码msgstring状态码描述msecint执行时间timeint结果返回时间dataobject返回结果数据idstring商品 idnamestring商品名称sale_priceint售价weightstring重量salesstring销量othumbstring商品缩略图create_timestring创建时间statusstring状态ext_warehouse_idstring仓库 idalias_namestring仓库别名返回数据{ "code": 0, "msg": "成功", "msec": 337, "time": 1604479977, "data": { "id": "49357", "name": "礼品自提件（菜鸟专用）", "sale_price": 0.08, "weight": "0", "sales": "0", "othumb": null, "create_time": "2020-10-20 09:58:32", "status": "1", "ext_warehouse_id": "29", "alias_name": "圆通泉州自提仓" }}创建订单接口地址： http://api.vv-tool.com/shop/apis/order-create接口介绍: 选择礼品、发货仓库、发货快递、收货人等信息创建礼品订单请求方式： POST传参方式： JSON返回格式： JSON接口收费： 开通一次，即可使用所有接口频率限制： 10 次/秒请求头参数参数类型必选值示例Authorizationstring是授权 access_token1798c6aadec33d1bc2f5b707f1049aefexxxx请求参数参数类型必选描述product_idnumber是礼品 IDwarehouse_idnumber是仓库 IDproduct_numbernumber是下单数量remarkstring是备注consigneesobject是收货人信息consigneestring是收货人mobilestring是手机号provincestring是省份citystring是市districtstring是区addressstring是具体地址platform_order_snstring是第三方平台订单号sourcestring是来源请求示例{ "product_id":11, "warehouse_id":23, "product_number":2, "remark": "测试", "consignees": [ { "consignee": "马云", "mobile": "15568822288", "province": "浙江", "city": "杭州", "district": "余杭区", "address": "梦想小镇", "platform_order_sn": "8980809890809809" } ], "source": "tmall"}请求代码示例cURL请求代码示例PHP请求代码示例JAVA请求代码示例响应参数参数类型描述codeint返回状态码msgstring状态码描述msecint执行时间timeint结果返回时间dataobject结果返回信息productobject商品信息product_namestring商品名称product_numberint商品数量product_pricestring商品价格product_weightint商品重量total_priceint每个包裹商品总价orderobject订单信息order_idint订单 idtotal_countint总数量total_freight_numberint总件数total_freight_priceint总包裹费用total_product_priceint总商品费用total_priceint总计费用返回数据{ "code": 0, "msg": "成功", "msec": 697, "time": 1604036515, "data": { "product": { "product_name": "双齿梳", "product_number": 11, "product_price": "10", "product_weight": 10, "total_price": 110 }, "order": { "order_id": 375, "total_count": 22, "total_freight_number": 2, "total_freight_price": 200, "total_product_price": 220, "total_price": 420 } }}提交支付接口地址： http://api.vv-tool.com/shop/apis/submit-payment接口介绍: 创建订单提交支付请求方式： POST传参方式： JSON返回格式： JSON接口收费： 开通一次，即可使用所有接口频率限制： 10 次/秒请求头参数参数类型必选值示例Authorizationstring是授权 access_token1798c6aadec33d1bc2f5b707f1049aefexxxx请求参数参数类型必选描述order_idint是订单 id请求示例order_id:262请求代码示例cURL请求代码示例PHP请求代码示例JAVA请求代码示例响应参数参数类型描述codeint返回状态码msgstring状态码描述msecint执行时间timeint结果返回时间dataobject返回结果信息返回数据{ "code": 0, "msg": "支付成功", "msec": 924, "time": 1603709388, "data": []}订单查询接口地址： http://api.vv-tool.com/shop/apis/get-order-list接口介绍: 查询礼品订单信息请求方式： POST传参方式： JSON返回格式： JSON接口收费： 开通一次，即可使用所有接口频率限制： 10 次/秒请求头参数参数类型必选值示例Authorizationstring是授权 access_token1798c6aadec33d1bc2f5b707f1049aefexxxx请求参数参数类型必选描述rangeint是页码filterobject是筛选条件create_timestring否创建日期order_snstring否订单编号请求示例{ "filter": { "order_sn":"202010231510481946975" }, "range": 1}请求代码示例cURL请求代码示例PHP请求代码示例JAVA请求代码示例响应参数参数类型描述codeint返回状态码msgstring状态码描述msecint执行时间timeint结果返回时间dataobject结果数据alias_namestring仓库别名idintidorder_snstring订单编号page_numberint包裹数sourcestring来源remarkstring备注create_timestring创建时间namestring商品名称total_pricestring总价statusstring状态 1:代付款 2:待发货 3:已发货 4:取消发货totalstring总数量返回数据{ "code": 0, "msg": "成功", "msec": 106, "time": 1604473515, "data": { "list": [ { "alias_name": "邮政黄山仓", "id": "466", "order_sn": "202011041511461997011", "page_number": "1", "source": "taobao", "remark": "222", "create_time": "2020-11-04 15:04:46", "name": "钢丝球", "total_price": "216", "status": "1" } ], "total": "1" }}获取包裹列表接口地址： http://api.vv-tool.com/shop/apis/get-package-list接口介绍: 获取订单对应的多个收货人包裹及快递等信息请求方式： POST传参方式： JSON返回格式： JSON接口收费： 开通一次，即可使用所有接口频率限制： 10 次/秒请求头参数参数类型必选值示例Authorizationstring是授权 access_token1798c6aadec33d1bc2f5b707f1049aefexxxx请求参数参数类型必选描述filterobject是筛选条件mobileint否手机号码order_snstring否订单编号statusstring否状态 n：开启 f：关闭rangeint是页码请求示例{ "filter": { }, "range":1}请求代码示例cURL请求代码示例PHP请求代码示例JAVA请求代码示例响应参数参数类型描述codeint返回状态码msgstring状态码描述msecint执行时间timeint结果返回时间dataobject结果返回数据listobject结果集合idint包裹 idproduct_namestring商品名称product_weightint商品重量order_id订单 idpackage_total_pricecreate_timestring创建时间update_timestring更新时间shipping_feeint运费product_numberstring商品数量consigneestring是mobilestring是provincestring是citystring是districtstring是addressstring是ext_platform_order_snstirng第三方订单编号additionalstring额外信息statusstring包裹状态:1:代付款 2:待发货 3:已发货 4:取消发货order_snstring订单编号sale_pricestring售价express_nostring快递单号express_company_namestring物流公司total_priceint总价（不含运费）返回数据{ "code": 0, "msg": "成功", "msec": 287, "time": 1604571036, "data": { "list": [ { "id": "10", "product_weight": "5", "product_name": "丝滑纸巾", "order_id": "8", "package_total_price": "195", "create_time": "2020-11-05 18:10:03", "update_time": null, "shipping_fee": "135", "product_number": "1", "consignee": "张三1", "mobile": "15568821111", "province": "浙江", "city": "杭州", "district": "余杭", "address": "余杭街道", "ext_platform_order_sn": "111111", "additional": null, "status": "2", "order_sn": "202011051811030069452", "sale_price": "60", "express_no": null, "express_company_name": null }, { "id": "9", "product_weight": "5", "product_name": "丝滑纸巾", "order_id": "7", "package_total_price": "255", "create_time": "2020-11-05 17:46:28", "update_time": null, "shipping_fee": "135", "product_number": "2", "consignee": "张三1", "mobile": "15568821111", "province": "浙江", "city": "杭州", "district": "余杭", "address": "余杭街道", "ext_platform_order_sn": "111111", "additional": null, "status": "4", "order_sn": "202011051711280065645", "sale_price": "60", "express_no": null, "express_company_name": null } ], "total": "10" }}取消发货接口地址： http://api.vv-tool.com/shop/apis/get-package-cancel接口介绍: 根据包裹进行取消发货请求方式： POST传参方式： JSON返回格式： JSON接口收费： 开通一次，即可使用所有接口频率限制： 10 次/秒请求头参数参数类型必选值示例Authorizationstring是授权 access_token1798c6aadec33d1bc2f5b707f1049aefexxxx请求参数参数类型必选描述package_idint是包裹 id请求示例{ "package_id":243}请求代码示例cURL请求代码示例PHP请求代码示例JAVA请求代码示例响应参数参数类型描述codeint返回状态码msgstring状态码描述msecint执行时间timeint结果返回时间dataobject任务执行结果返回数据{ "code": 0, "msg": "成功", "msec": 694, "time": 1604567398, "data": []}获取用户余额接口地址： http://api.vv-tool.com/shop/apis/get-user-balance接口介绍: 获取您帐户的可用余额信息请求方式： POST传参方式： JSON返回格式： JSON接口收费： 开通一次，即可使用所有接口频率限制： 10 次/秒请求头参数参数类型必选值示例Authorizationstring是授权 access_token1798c6aadec33d1bc2f5b707f1049aefexxxx请求参数无请求参数请求示例无请求示例请求代码示例cURL请求代码示例PHP请求代码示例JAVA请求代码示例响应参数参数类型描述codeint返回状态码msgstring状态码描述msecint执行时间timeint结果返回时间dataobject返回结果信息balanceint余额返回数据{ "code": 0, "msg": "成功", "msec": 1732, "time": 1603415692, "data": { "balance": 99420 }}响应状态码返回代码返回码描述解决办法0成功100请求参数错误检查您的参数是否为空或者格式是否正确101请求超时，请重试检查您的网络状况是否良好102调用接口不成功检查您的接口代码或者联系客服解决200系统错误，请联系客服联系客服解决204请求异常检查接口 url 或者参数205缺少必要参数检查您的请求参数是否填写208参数类型错误检查您的参数类型是否填写正确401身份凭证无效重新获取 token10402当前产品不存在检查您的商品 id 是否正常10403当前仓库不存在检查您的仓库 id 是否正确10406当前订单不存在检查您的订单号是否正确10407当前订单状态不是待付款状态检查您的订单编号是否正确10408当前订单下没有包裹待付款包裹检查您所需要支付的订单 id 是否正确10409订单创建失败检查您的接口内容是否正确10410订单付款失败检查您的参数填写是否正确或者联系客服解决10411当前包裹不存在检查您的包裹 id 填写是否正确10412当前包裹不能取消检查您的包裹 id 填写是否正确10413当前包裹取消失败检查您的包裹 id 填写是否正确10416支付超时请重新下单