有赞新零售社区

发帖
API使用问题»有赞寄件api

[API文档问题] 有赞寄件api

山水之间 3 天前 375 浏览 3 评论 | 只看楼主 [打印]
问题一:ig
java.lang.String

有赞订单号,E开头+年月日时分秒
+随机数,长度24位字母和数字组合

外部订单怎么获取订单号,是否需要自己生成一个,或者无需填写

问题二:
apply_id
java.lang.String
取号id,幂等键。
76b8559b31a2d24548d158203817e
8agy

这里的ID如何获取,是什么意思

问题三:
gw err resp":i
trace id":"y27-0a350a46-1744822373462-761763"'err_msg":"非法的请求凭证”err code": 4201

电子面单批量区号这里的,这里的返回是什么意思
用手机打开
收藏 ··· 回复
    尊敬的有赞用户 您好,我们已收到您的问题,并已安排相关技术支持正在处理中,请耐心等待。您可以关注之前预留的邮箱570475011@****** 注意问题解决进度提醒邮件。     请不要在帖子中暴露含有手机号、姓名、secret等敏感信息,如有必要帖子发布时候设置成回复仅发帖人可见。

      至尊   有赞云团队   3 天前 | 只看该作者
      问题一:外部订单只能走电子面单的流程
      https://doc.youzanyun.com/resource/doc/7629/7629
      在取号的时候用  https://doc.youzanyun.com/detail/API/0/4244 ,yz_order 字段为false 即可
      问题二:apply_id是接口幂等性控制参数,需调用方自行生成全局唯一ID(推荐UUID格式)。该ID用于防止重复请求,同一个apply_id在24小时内只能成功执行一次。
      问题三:错误码4201表示请求凭证异常,可能原因:
      1. access_token未传或格式错误
      2. token已过期(有效期7天需刷新)
      3. 应用权限不足
      解决方法:
      检查access_token传递是否正确
      通过https://doc.youzanyun.com/resource/doc/3904获取新token
      确认应用是否开通相关接口权限

      给的traceid查不到任何信息,如以上未解决,麻烦给下最新调用的traceid哈
      • 山水之间 3 天前
        url:https://open.youzanyun.com/api/youzan.logistics.waybill.get/1.0.0?access_token=c259db4e426e0bac664e7d6ef343e80

        参数:
        {
          "sender": {
            "address": {
                "address":"有赞",
                "county":"西湖区",
                "city":"杭州市",
                "province":"浙江省"
            },
            "name":"张三",
            "mobile":"19999999999"
          },
          "payment_type":0,
          "express_id":1,
          "trade_order_info_list":{
              "recipient":{
                "address": {
                    "county":"西湖区",
                    "address":"有赞",
                    "city":"杭州市",
                    "province":"浙江省"
                },
                "name":"张三",
                "mobile":"19999999999"
              },
              "package_info":{
                  "height":1,
                  "volume":10,
                  "weight":1,
                  "length":1,
                  "width":1,
                  "items":{
                      "name":"苹果",
                      "count":2
                  }
                },
                "yz_order":false,
                "template_url":"https://cloudprint.cainiao.com/template/standard/201/223",
                "order_kdt_id":"179776519",
                "apply_id":"55acc182-55f5-4303-cff7-299870d80696"
          }
        }


        {
            "gw_err_resp": {
                "trace_id": "yz7-0a350a46-1744875191931-423710",
                "err_msg": "系统异常",
                "err_code": 5001
            }
        }
        需要了解一下这里的请求参数和返回值,系统异常是什么意思
      • 至尊 回复 山水之间 3 天前
        您好,异常原因如下
        校验失败信息: waybill_get_request.type参数校验失败,参数必填,不能为空
        但目前该接口已经不对外开放了,是无法正常使用的
      • 山水之间 回复 至尊 3 天前
        请问哪个接口不对外开放了,取号接口已经不能对外开放了吗,我后台申请权限,显示申请权限成功了的

      山水之间 青铜   3 天前 | 只看该作者
      你好,电子面单批量取号 有没有java 的demo
      url:https://open.youzanyun.com/api/youzan.logistics.waybill.get/1.0.0?access_token=c259db4e426e0bac664e7d6ef343e80

      参数:
      {
        "sender": {
          "address": {
              "address":"有赞",
              "county":"西湖区",
              "city":"杭州市",
              "province":"浙江省"
          },
          "name":"张三",
          "mobile":"19999999999"
        },
        "payment_type":0,
        "express_id":1,
        "trade_order_info_list":{
            "recipient":{
              "address": {
                  "county":"西湖区",
                  "address":"有赞",
                  "city":"杭州市",
                  "province":"浙江省"
              },
              "name":"张三",
              "mobile":"19999999999"
            },
            "package_info":{
                "height":1,
                "volume":10,
                "weight":1,
                "length":1,
                "width":1,
                "items":{
                    "name":"苹果",
                    "count":2
                }
              },
              "yz_order":false,
              "template_url":"https://cloudprint.cainiao.com/template/standard/201/223",
              "order_kdt_id":"179776519",
              "apply_id":"55acc182-55f5-4303-cff7-299870d80696"
        }
      }


      {
          "gw_err_resp": {
              "trace_id": "yz7-0a350a46-1744875191931-423710",
              "err_msg": "系统异常",
              "err_code": 5001
          }
      }
      这是我测试这个电子面单批量取号接口传的参数和调用的链接,返回系统异常是什么情况,你回复的 waybill_get_request.type 文档没有让填这个参数
      • 至尊 3 天前
        您好,您这边是调用错接口了吧
        目前电子面单批量取号的接口是这个哈:https://doc.youzanyun.com/detail/API/0/4244

        您调用的那个如上所说已经不对外开放了
      • 山水之间 回复 至尊 3 天前
        是的我从下面示例复制的url 没太注意,这个接口是传json 吧
        url:https://open.youzanyun.com/api/youzan.logistics.waybill.apply/1.0.0
        {
          "access_token":"02c5ec82881f638ed1916f985b30fa5",
          "sender": {
            "address": {
                "address":"有赞",
                "county":"西湖区",
                "city":"杭州市",
                "province":"浙江省"
            },
            "name":"张三",
            "mobile":"19999999999"
          },
          "payment_type":0,
          "express_id":1,
          "trade_order_info_list":{
              "recipient":{
                "address": {
                    "county":"西湖区",
                    "address":"有赞",
                    "city":"杭州市",
                    "province":"浙江省"
                },
                "name":"张三",
                "mobile":"19999999999"
              },
              "package_info":{
                  "height":1,
                  "volume":10,
                  "weight":1,
                  "length":1,
                  "width":1,
                  "items":{
                      "name":"苹果",
                      "count":2
                  }
                },
                "yz_order":false,
                "template_url":"https://cloudprint.cainiao.com/template/standard/201/223",
                "order_kdt_id":"179776519",
                "apply_id":"55acc182-55f5-4303-cff7-299870d80696"
          }
        }

        返回值:
        {
            "gw_err_resp": {
                "trace_id": "yz7-0ae85bde-1744882835001-893612",
                "err_msg": "非法的请求凭证",
                "err_code": 4201
            }
        }

        上面是url 和参数返回非法凭证, 我检查了这个接口是开通的,token 也是刚获取的在别的接口上是可以使用
      • 至尊 回复 山水之间 3 天前
        参考该文档:https://doc.youzanyun.com/resource/doc/4363/4363
        是否把access_token作为入参传入了,access_token需要拼接在API后面,不能作为入参传入
      • 山水之间 回复 至尊 3 天前
        {
            "trace_id": "yz7-0a350a42-1744887513412-425459",
            "code": 200,
            "data": [
                {
                    "code": 120000102,
                    "success": false,
                    "apply_id": "55acc18255f54303cff7299870d80696",
                    "message": "请求参数缺失 orderNo不能为空"
                }
            ],
            "success": true,
            "message": "请求成功"
        }这个接口没有让传orderNo参数
      • 至尊 回复 山水之间 3 天前
        您好,这个对应的是 trade_order_info_list[].tid参数。
        参数必填,不能为空哈!
      • 山水之间 回复 至尊 3 天前
        上面您说yz_order 字段为false 即可,yz_order 字段我传了false,tid也要传是吧,
        这个tid 是我按规则随机生成一个吗
      • 至尊 回复 山水之间 3 天前
        tid是:有赞订单号,E开头+年月日时分秒+随机数,长度24位字母和数字组合
        麻烦遵照对应api文档里填写哈
      • 山水之间 回复 至尊 3 天前
        有添加有赞商家地址库地址的接口吗
      • 山水之间 回复 至尊 3 天前
        添加地址返回{
            "trace_id": "yz7-0a350020-1744897097500-785344",
            "code": 160810206,
            "success": false,
            "message": "请选择一个地址类型"
        }什么情况
      • 至尊 回复 山水之间 2 天前
        您好,校验失败信息: province参数校验失败,参数必填,不能为空
        请您这边严格按照文档中必填字段来入参
      • 山水之间 回复 至尊 2 天前
        请求的url: https://open.youzanyun.com/api/youzan.shop.address.create/3.0.0?access_token=011a93c63690ecbefe77cde3a9d8182
        参数: {
                "province":"浙江省",
            "region_id":"330106",
            "city":"杭州市",
            "address":"黄龙万科中心G3座",
                "contact_name":"张三",
            "area":"西湖区",
                "mobile":"12565567898"
        }

        返回值:
        {
            "trace_id": "yz7-0ae85be8-1744943904754-193599",
            "code": 160810206,
            "success": false,
            "message": "请选择一个地址类型"
        }

        如果直接复制你们下面的示例提示参数有误
      • 至尊 回复 山水之间 2 天前
        因为你入参的层级错了
        例如:request": {"body": " {\n\t\"province\":\"浙江省\",\n    \"region_id\":\"330106\",\n    \"city\":\"杭州市\"}
        你需要改成
        request:{
            province: xxx,
             region_id:xxx
        }
      • 山水之间 回复 至尊 2 天前
        我是postman测试的,你们文档参数都是一个层级的包括示例都是一个层级的这个是新增店铺地址库地址的接口
        curl -X POST -H 'content-type: application/json'  -d '{"area":"西湖区","contact_name":"张三9","address":"黄龙万科中心G3座","city":"杭州市","area_code":"333","region_id":"330106","mobile":"3333333333333","telephone":"1222233333333","is_invoice_default":"1","is_return":"1","province":"浙江省","is_invoice":"1","is_return_default":"0"}'  "https://open.youzanyun.com/api/youzan.shop.address.create/3.0.0?access_token=YOUR_TOKEN"
        这是文档示例的curl
      加载更多

      1跳至
      您需要登录后才可以回帖 登录 | 立即注册

      本版积分规则

      复制链接
      新浪微博
      QQ空间
      微信扫码
      • 回复

      • 评分

      客服工作时间是9:00-18:00,客服妹子当前不在线,若不能及时回复请谅解。试试右上角的搜索吧,论坛有丰富的经验贴、公告贴,相信一定能够帮到您~

      复制成功