mzubkov / goods-api-php-library
Goods.ru: 合作伙伴 API PHP 库
dev-master
2019-01-14 04:20 UTC
Requires
- ext-curl: ^7.51
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(); //Получение номера отправления