当前位置: API文档 > 订单类
vip_trade_modify.php(修改订单标记)
1.1 接口描述:修改旺店通erp内订单的订单标记 |
1.2 适用版本:客户端 V2.5.2.4及以上版本 |
2.1 其他 |
环境 | HTTP地址 |
---|---|
测试环境 | https://sandbox.wangdian.cn/openapi2/vip_trade_modify.php |
正式环境 | https://api.wangdian.cn/openapi2/vip_trade_modify.php |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
卖家账号 | sid | String | 是 | 购买ERP时由旺店通分配给ERP购买方,请从ERP购买方获取。 | |
接口账号 | appkey | String | 是 | 本开放平台“自助对接”功能模块内自助申请,获取方式点击这里 | |
时间戳 | timestamp | int | 是 | 北京时间1970-01-01 08:00:00起至现在的总秒数,10位int值,旺店通企业版API服务端允许请求最大时间误差为5min,date.timezone = Asia/Shanghai。 | |
签名 | sign | String | 是 | API输入参数签名结果,签名算法介绍单击这里 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
订单编号 | trade_no | varchar | 40 | 是 | 系统订单编号,默认为JY开头 |
发票编号 | invoice_no | varchar | 40 | 否 | 发票编号 |
标记名称 | flag_name | varchar | 40 | 否 | 标记名称 |
物流公司编号 | logistics_code | varchar | 40 | 否 | 物流公司编号,不支持电子单号物流回传,限定回传物流类型为“线下普通单号” |
物流单号 | logistics_no | varchar | 40 | 否 | 物流单号,该字段需与logistics_code字段结合使用,不支持单独请求 |
客服备注 | cs_remark | varchar | 255 | 否 | 客服备注 |
是否有手工标记 | remark_from | varchar | 255 | 否 | 是否有手工标记:0 无 1 有 默认为0(当传1时,则该客服备注不会被原始单备注更新,当传0时,该客服备注可被原始单备注更新替换) |
打印备注 | print_remark | varchar | 255 | 否 | 打印备注 |
是否覆盖原有标记 | flag_cover | varchar | 255 | 否 | 是否覆盖原有标记:0.不允许覆盖,1.允许覆盖,默认为0 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
错误码 | code | int | 11 | 是 | 状态码:0表示成功,其他表示失败 |
错误描述 | message | varchar | 255 | 是 | 错误描述 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 | <?php require_once ( "../WdtClient.php" ); $c = new WdtClient; $c ->sid = '' ; $c ->appkey = '' ; $c ->appsecret = '' ; $c ->gatewayUrl = 'http://sandbox.wangdian.cn/openapi2/vip_trade_modify.php' ; //添加查询参数 $c ->putApiParam( 'trade_no' , 'JY201902260005' ); $c ->putApiParam( 'invoice_no' , 'DZ201902270006' ); $c ->putApiParam( 'flag_name' , '小麦测试专用标' ); $c ->putApiParam( 'logistics_code' , 'JITXXX' ); $c ->putApiParam( 'logistics_no' , 'ceshi01' ); $c ->putApiParam( 'cs_remark' , 'ceshi01' ); $c ->putApiParam( 'print_remark' , 'ceshi01' ); $c ->putApiParam( 'flag_cover' , '1' ); $json = $c ->wdtOpenApi(); var_dump( $json ); ?> |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 | package com.wangdian.api.vip; import com.wangdian.api.WdtClient; import java.io.IOException; import java.util.HashMap; import java.util.Map; public class VipTradeModify { public static void main(String[] args) { WdtClient client = new WdtClient( "传入sid" , "传入appkey" , "传入appsecret" , "传入url" ); //测试环境sid、appkey、密钥请到旺店通开放平台-自助对接-申请测试环境内查看,测试环境url=https://sandbox.wangdian.cn/openapi2/ //调用正式环境时请将sid、appkey、appsecret切换为实际参数,参数在旺店通开放平台-自助对接-应用管理内应用状态为已上线的应用中查看,调用正式环境注意切换正式环境url=https://api.wangdian.cn/openapi2/ Map<String, String> params = new HashMap<String, String>(); params.put( "trade_no" , "JY201902260005" ); params.put( "invoice_no" , "DZ201902270006" ); params.put( "flag_name" , "小麦测试专用标" ); // params.put("logistics_code", "JITXXX"); // params.put("logistics_no", "ceshi01"); params.put( "cs_remark" , "ceshi01" ); params.put( "print_remark" , "ceshi01" ); params.put( "flag_cover" , "1" ); try { String response = client.execute( "vip_trade_modify.php" , params); System.out.println(response); } catch (IOException e) { e.printStackTrace(); } } } |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 | using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Threading.Tasks; using WdtSdk; namespace VipTradeModify { class VipTradeModify { static void Main( string [] args) { WdtClient client = new WdtClient(); client.sid = "" ; client.appkey = "" ; client.appsecret = "" ; client.gatewayUrl = "http://sandbox.wangdian.cn/openapi2/vip_trade_modify.php" ; client.putParams( "trade_no" , "JY201902260005" ); client.putParams( "invoice_no" , "DZ201902270006" ); client.putParams( "flag_name" , "小麦测试专用标" ); client.putParams( "logistics_code" , "JITXXX" ); client.putParams( "logistics_no" , "ceshi01" ); client.putParams( "cs_remark" , "ceshi01" ); client.putParams( "print_remark" , "ceshi01" ); client.putParams( "flag_cover" , "1" ); string result = client.wdtOpenapi(); Console.WriteLine(result); Console.ReadKey(); } } } |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 | import WdtClient t = WdtClient.WdtClient( 'appkey' , 'appsecret' , 'sid' , 'http://sandbox.wangdian.cn/openapi2/' ) params = {} params .update({ "trade_no" : '12345678' }) params .update({ "invoice_no" : '12345678' }) params .update({ "flag_name" : '测试商品' }) params .update({ "logistics_code" : '001' }) params .update({ "logistics_no" : '12345678' }) params .update({ "cs_remark" : '测试备注' }) params .update({ "remark_from" : '0' }) params .update({ "print_remark" : '测试打印备注' }) params .update({ "flag_cover" : '1' }) response = t.execute( "vip_trade_modify.php" , params ) print(response) |
6.响应示例
6.1 正常响应示例
1 2 3 4 | { "code" : 0, "message" : "OK" } |
6.2 异常响应示例
1 2 3 4 | { "code" : "LOGISTIC_ERROY" , "message" : "订单不是已审核状态不能修改物流公司和物流单号" } |