返傭商品

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

導入商品

每次調用支持批量導入不超過 1000 條的商品信息。每分鐘單個商戶全局調用次數不得超過 200 次。每天調用次數不得超過 100 萬次。每次請求包大小不超過 2M。

<?php

$data = [
    [
        'pid' => 'pid001',
        'image_info' => [
            'main_image_list' => [
                [
                    'url' => 'http://www.google.com/a.jpg',
                ],
                [
                    'url' => 'http://www.google.com/b.jpg',
                ],
            ],
        ],

        // ...
    ],

    // ...
];

$result = $officialAccount->goods->add($data);

/* $result:
{
    "errcode": 0,
    "errmsg": "ok",
    "status_ticket": "115141102647330200"
}
*/

status_ticket 用于獲取此次導入的詳細結果。

更新商品

更新時，字段不填代表不更新該字段（此處的字段不填，代表無此字段，而不是把字段的值設為空，設為空即代表更新該字段為空）。

對于字符串類型的選填字段，如副標題，若清空不展示，則可設置為空；對于數字類型的選填字段，如原價，若清空不展示，則需設置為 0。

基本字段更新中 pid 為必填字段，且無法修改。

<?php

$data = [
    [
        'pid' => 'pid001',
        'image_info' => [
            'main_image_list' => [
                [
                    'url' => 'http://www.baidu.com/c.jpg',
                ],
                [
                    'url' => 'http://www.baidu.com/d.jpg',
                ],
            ],
        ],
        // ...
    ],
    // ...
];

$result = $officialAccount->goods->update($data);

/* $result:
{
    "errcode": 0,
    "errmsg": "ok",
    "status_ticket": "115141102647330200"
}
*/

說明：導入商品和更新商品使用的是同一個接口。

查詢導入/更新商品狀態

用于查詢導入或更新商品的結果，當導入或更新商品失敗時，若為系統錯誤可進行重試；若為其他錯誤，請排查解決后進行重試。

<?php

$status_ticket = '115141102647330200';

$result = $officialAccount->goods->status($status_ticket);

/* $result:
{
    "errcode": 0,
    "errmsg": "ok",
    "result": {
        "succ_cnt": 2,
        "fail_cnt": 0,
        "total_cnt": 2,
        "progress": "100.00%",
        "statuses": [
            {
                "pid": "pid001",
                "ret": 0,
                "err_msg": "success",
                "err_msg_zh_cn": "成功"
            },
            {
                "pid": "pid002",
                "ret": 0,
                "err_msg": "success",
                "err_msg_zh_cn": "成功"
            }
        ]
    }
}
*/

獲取單個商品信息

使用該接口獲取已導入的商品信息，供驗證信息及抽查導入情況使用。

<?php

$pid = 'pid001';

$officialAccount->goods->get($pid);

返回結果中的 product 字段內容與 導入商品接口 字段一致，導入時未設置的值有可能獲取時仍會返回，但顯示為空。

分頁獲取商品信息

使用該接口可獲取已導入的全量商品信息，供全量驗證信息使用。

<?php

// $page 為 1 時傳空即可。當 $page 大于 1 時必填，填入上一次訪問本接口返回的 page_context。
$context = '';  
$page = 1; // 頁碼
$size = 10; // 每頁數據大小，目前限制為 100 以內，注意一次全量驗證過程中該參數的值需保持不變

$officialAccount->goods->list($context, $page, $size);