README

Booklog api 库

仓库订单

要提交仓库订单，请使用以下实现

$apiKey = "test-key";
$booklogStoreApiClient = new BooklogStore($apiKey);

由 $booklogStoreApiClient 变量包含的配置是用于api通信的。

要提交一个订单，请按照以下步骤操作

$orderId = 321; // az api-t meghívó rendszerben lévő rendelés száma 

$booklogStoreApiClient->createStoreOrder([
     "ordertype" => BooklogStore::SALES_ORDER, // Bevételezéshez BooklogStore::PURCHASE_ORDER
     "orderid" => $orderId, // az api-t meghívó rendszerben lévő rendelés száma
     "items" => [
         [
             "barcode" => "123456789",
             "qty" => 1,
             "name" => "Dummy product",
             "listprice" => 500
         ]
     ], // a rendelésben szereplő tételek
     "shippingmethod" => BooklogStore::SHIPPING_METHOD_FURGEFUTAR, // SHIPPING_METHOD_NONE ...
     "locationid" => 1,
     "location" => "Partner címe",
     "locationzip" => 1191,
     "locationcity" => "Budapest",
     "locationaddress" => "Lehel utca 15",
]);

如果我们要向订单中添加文档（例如，一张发票或一份送货单），则需要使用以下代码

$booklogStoreApiClient->addDocument($orderId, "/tmp/document.pdf");

如果我们想添加快递标签，可以这样操作

$booklogStoreApiClient->addLabel($orderId, "/tmp/label.pdf");

可以在Booklog系统中按以下方式记录产品

$booklogStoreApiClient->createProduct([
  "barcode" => "123456789", // a termék vonalkodója az azonosításhoz
  "name" => "Dummy product", // a termék megnevezése
  "listprice" => 500 // a termék lista ára
]);

如果我们要删除一个订单

$booklogStoreApiClient->deleteStoreOrder(["orderid" => $orderId]);

注意！已调用的仓库订单无法删除或修改！

在未调用的订单中，我们可以修改一个或多个产品的数量

$booklogStoreApiClient->updateItems([
    "orderid" => $orderId,
    "items" => [
        [
            "barcode" => "123456789",
            "name" => "Dummy product",
            "listprice" => 500,
            "qty" => 10
        ]
    ]
]);

如果我们要最终确认一个仓库订单，即接受仓库完成的项

$booklogStoreApiClient->closeStoreOrder(["orderid" => $orderId]);

如果我们想了解单个产品的库存情况，可以这样操作

$booklogStoreApiClient->checkStock([
    "orderid" => $orderId,
    "items" => [
        [
            "barcode" => "123456789"
        ]
    ]
]);

运输订单

通过api获取运输

$apiKey = "test-key";
$booklogShippingApiClient = new BooklogShipping($apiKey);

通过api创建运输

$booklogShippingApiClient->createOrder([
    "orderid" => $orderId,  // Ha a szállításhoz tartozik booklog-os kiszedés akkor azt itt meglehet adni,
                            //más esetben null, vagy nem kötelező megadni.
    "origin" => "Raktár", // Felvétel hely neve
    "origin_address" => [
        [
            "country" => 348, // Magyarország
            "postcode" => "2220",
            "city" => "Vecsés",
            "address" => "Raktár címe"
        ]
    ],
    "destination" => "Cimzett", // Kiszállítás helyének neve
    "destination_address" => [
        [
            "country" => 348, // Magyarország
            "postcode" => "1191",
            "city" => "Budapest",
            "address" => "Lehel utca 15"
        ]
    ],
]);