返佣商品

微信文档：https://mp.weixin.qq.com/cgi-bin/announce?action=getannouncement&key=11533749572M9ODP&version=1&lang=zh_CN&platform=2

导入商品

每次调用支持批量导入不超过1000条的商品信息。每分钟单个商户全局调用次数不得超过200次。每天调用次数不得超过100万次。每次请求包大小不超过2M。

  1. $data = [
  2.     [
  3.         'pid' => 'pid001',
  4.         'image_info' => [
  5.             'main_image_list' => [
  6.                 [
  7.                     'url' => 'http://www.google.com/a.jpg',
  8.                 ],
  9.                 [
  10.                     'url' => 'http://www.google.com/b.jpg',
  11.                 ],
  12.             ],
  13.         ],
  15.         //...
  16.     ],
  18.     //...
  19. ];
  21. $result = $app->goods->add($data);
  23. // $result:
  24. //{
  25. //    "errcode": 0,
  26. //    "errmsg": "ok",
  27. //    "status_ticket": "115141102647330200"
  28. //}

status_ticket 用于获取此次导入的详细结果。

更新商品

更新时，字段不填代表不更新该字段（此处的字段不填，代表无此字段，而不是把字段的值设为空，设为空即代表更新该字段为空）。

对于字符串类型的选填字段，如副标题，若清空不展示，则可设置为空；对于数字类型的选填字段，如原价，若清空不展示，则需设置为0。

基本字段更新中 pid 为必填字段，且无法修改

  1. $data = [
  2.     [
  3.         'pid' => 'pid001',
  4.         'image_info' => [
  5.             'main_image_list' => [
  6.                 [
  7.                     'url' => 'http://www.baidu.com/c.jpg',
  8.                 ],
  9.                 [
  10.                     'url' => 'http://www.baidu.com/d.jpg',
  11.                 ],
  12.             ],
  13.         ],
  15.         //...
  16.     ],
  18.     //...
  19. ];
  21. $result = $app->goods->update($data);
  23. // $result:
  24. //{
  25. //    "errcode": 0,
  26. //    "errmsg": "ok",
  27. //    "status_ticket": "115141102647330200"
  28. //}

说明：导入商品和更新商品使用的是同一个接口。

查询导入/更新商品状态

用于查询导入或更新商品的结果，当导入或更新商品失败时，若为系统错误可进行重试；若为其他错误，请排查解决后进行重试。

  1. $status_ticket = '115141102647330200';
  3. $result = $app->goods->status($status_ticket);
  5. // $result:
  6. //{
  7. //    "errcode": 0,
  8. //    "errmsg": "ok",
  9. //    "result": {
  10. //        "succ_cnt": 2,
  11. //        "fail_cnt": 0,
  12. //        "total_cnt": 2,
  13. //        "progress": "100.00%",
  14. //        "statuses": [
  15. //            {
  16. //                "pid": "pid001",
  17. //                "ret": 0,
  18. //                "err_msg": "success",
  19. //                "err_msg_zh_cn": "成功"
  20. //            },
  21. //            {
  22. //                "pid": "pid002",
  23. //                "ret": 0,
  24. //                "err_msg": "success",
  25. //                "err_msg_zh_cn": "成功"
  26. //            }
  27. //        ]
  28. //    }
  29. //}

获取单个商品信息

使用该接口获取已导入的商品信息，供验证信息及抽查导入情况使用。

  1. $pid = 'pid001';
  3. $app->goods->get($pid);

返回结果中的 product 字段内容与 导入商品接口 字段一致，导入时未设置的值有可能获取时仍会返回，但显示为空

分页获取商品信息

使用该接口可获取已导入的全量商品信息，供全量验证信息使用。

  1. $context = '';  // page 为 1 时传空即可。当 page 大于 1 时必填，填入上一次访问本接口返回的 page_context。
  2. $page = 1;      // 页码
  3. $size = 10;     // 每页数据大小，目前限制为100以内，注意一次全量验证过程中该参数的值需保持不变
  5. $app->goods->list($context, $page, $size);

返回结果中的 product 字段内容与 导入商品接口 字段一致，导入时未设置的值有可能获取时仍会返回，但显示为空。 page_context 字段用于获取下一页数据时使用。