mzubkov/goods-api-php-library

Goods.ru: 合作伙伴 API PHP 库

dev-master 2019-01-14 04:20 UTC

This package is not auto-updated.

Last update: 2024-09-29 06:06:03 UTC


README

https://packagist.org.cn/packages/mzubkov/goods-api-php-library

初始化

运行需要配置 .ini 文件。

基于从 Goods.ru 通过 POST order/new 获取的数据初始化订单

$goodsMarket = new GoodsMarket($token);
$json = file_get_contents("php://input"); //получение данных о новом заказе от Goods.ru
$goodsOrder = $goodsMarket->newOrder($json);

newOrder($json) - 返回 GoodsOrder 类对象

$json - 从 Goods.ru 获取的请求数据

按编号初始化订单

$goodsOrder = new GoodsOrder($token, $merchantId, $shipmentId, $orderCode);

$token - 令牌

$merchantId - 卖家标识符

$shipmentId - 订单编号

$orderCode - 卖家订单编号(可选参数)

确认订单

将指定的商品转为“已确认”状态。

    $itemsConfirm = [106449, 70992, 106449, 47940];
    $resultConfirm = $goodsOrder->orderConfirm($itemsConfirm);

返回数组类型

    ["success" => 1, "result" => "OK"]

$itemsConfirm - 待确认的任何顺序的 offerId 数组。未传入数组中的商品将被取消(发送 order/reject)

组装订单

将指定的商品转为“已组装”状态。

    $goodsOrder->setOrderCode("abc123"); //установка номера заказа (если не был задан на этапе инициализации)
    $itemsPacking = [array(106449, 47940), array(106449)];
    $resultPacking = $goodsOrder->orderPacking($itemsPacking);

返回数组类型

    ["success" => 1, "result" => "OK"]

$itemsPacking - 包含 offerId 的数组数组,用于组装(分配到货位),按任何顺序排列。未传入数组中的商品将被取消(发送 order/reject)

获取订单状态

    $result = goodsOrder->getOrderStatus();

返回数组类型

    ["success" => 1, "result" => $orderStatus]

其中 $orderStatus - 订单状态(NEW, CONFIRMED, PACKED, CANCELED, 正在处理订单)

获取订单信息

    $result = goodsOrder->getOrderInfo();

返回数组类型

    ["success" => 1, "result" => $orderInfo]

其中 $orderInfo - 包含订单详细信息的数组

获取标签

    $label = $goodsOrder->getLabel();

返回所有商品标签的 HTML 格式。如果订单之前未组装,则返回标签模板,不包含条形码

返回数组类型

    ["success" => 1, "result" => "label_in_html_format"]

额外方法

    $goodsOrder->setOrderCode($orderCode); //Установка номера заказа
    $orderCode = $goodsOrder->getOrderCode(); //Получение номера заказа
    $shipmentId = $goodsOrder->getShipmentId(); //Получение номера отправления