Pancake POSNhà phát triển
/
llms.txt
VIEN
Sản phẩm & kho

Kiểm hàng

4 endpoint · https://pos.pages.fm/api/v1

Xem Markdown
Endpoint
GET/shops/{SHOP_ID}/stocktakingsDanh sách kiểm hàngPOST/shops/{SHOP_ID}/stocktakingsTạo phiếu kiểm hàngGET/shops/{SHOP_ID}/stocktakings/{STOCKTAKING_ID}Lấy thông tin 1 phiếu kiểm hàngPUT/shops/{SHOP_ID}/stocktakings/{STOCKTAKING_ID}Cập nhật kiểm hàng

Danh sách kiểm hàng

GET/shops/{SHOP_ID}/stocktakings

Lấy danh sách kiểm hàng

Tham số đường dẫn

SHOP_IDintegerbắt buộc

Mã shop

Ví dụ: 4

Tham số truy vấn

pageinteger

Số trang

Mặc định: 1 · Ví dụ: 1
page_sizeinteger

Kích thước trang

Mặc định: 30 · Ví dụ: 30
statusinteger

Trạng thái

Giá trị-2Tất cả trạng thái-1Đang tạo0Đang kiểm hàng1Đã kiểm hàng2Đã hủy
Mặc định: -2 · Ví dụ: -2

Phản hồi

object
dataarray<Stocktaking>

Danh sách kiểm hàng

page_numberinteger

Số trang

page_sizeinteger

Kích thước trang

successboolean

Trạng thái thành công

total_entriesinteger

Tổng số bản ghi

total_pagesinteger

Tổng số trang

Yêu cầu
curl "https://pos.pages.fm/api/v1/shops/{SHOP_ID}/stocktakings?api_key=API_KEY"
Phản hồi 200
{
  "success": true,
  "data": [
    {
      "id": "4d0f479d-feab-489b-bc82-4a656902a20b",
      "display_id": null,
      "status": 0,
      "warehouse_id": "c52e67ad-d9d0-4276-abe4-e0c9f1f7d2da",
      "stocktaking_by": "category_ids",
      "stocktaking_by_value": [
        "1315"
      ],
      "stocktaking_at": "2023-10-11T08:24:56Z",
      "progress": 0,
      "note": "Kiểm hàng tồn",
      "items": [
        {
          "id": "cb244b25-100e-4eaa-8b8f-0e72c5642631",
          "variation_id": "27b3f94b-c945-4560-b694-a59526cae9a5",
          "changed_quantity": 12,
          "current_quantity": 0,
          "note": null,
          "variation": {
            "id": "27b3f94b-c945-4560-b694-a59526cae9a5",
            "display_id": "1",
            "barcode": "12ml-6291107458328",
            "product_id": "61894c4f-d759-45b7-acf7-ff5e88082016",
            "retail_price": 240000,
            "last_imported_price": 20000,
            "weight": 1000,
            "fields": [],
            "images": [
              "https://statics.pancake.vn/user-content.pancake.vn/2023/4/12/05138842c6f772cde332fd8e1be1bff58245f19e.png"
            ],
            "product": {
              "display_id": "12ml-6291107458328",
              "name": "12ml Badee Al Oud",
              "image": null,
              "note_product": ""
            }
          },
          "inserted_at": "2024-12-02T10:42:39Z",
          "updated_at": "2024-12-02T10:42:39Z"
        }
      ],
      "shop_id": 20,
      "creator_id": "cee3c05e-5f85-43c4-b27e-889b99c50097",
      "inserted_at": "2023-10-11T08:25:18Z",
      "updated_at": "2023-10-11T09:03:03Z",
      "updated_status_at": "2023-10-11T08:25:18Z"
    }
  ]
}

Tạo phiếu kiểm hàng

POST/shops/{SHOP_ID}/stocktakings

Tham số đường dẫn

SHOP_IDintegerbắt buộc

Mã shop

Ví dụ: 4

Nội dung yêu cầu

Thông tin yêu cầu chứa thông tin kiểm kê cần tạo

object
stocktakingobjectbắt buộc

Phản hồi

object
successboolean

Trạng thái thành công

Yêu cầu
curl -X POST "https://pos.pages.fm/api/v1/shops/{SHOP_ID}/stocktakings?api_key=API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "stocktaking": {
    "warehouse_id": "c52e67ad-d9d0-4276-abe4-e0c9f1f7d2da",
    "items": [
      {
        "variation_id": "20e7d183-c70c-445e-8ce2-4d7e3a378e34",
        "changed_quantity": -1
      }
    ],
    "note": "Kiểm hàng tồn",
    "status": 0,
    "inserted_at": "2025-04-04T10:42:40.100Z",
    "stocktaking_at": "2023-10-11T10:38:34.542Z",
    "stocktaking_by": "category_ids",
    "stocktaking_by_value": [
      "1315"
    ]
  }
}'
Phản hồi 200
{
  "success": true
}

Lấy thông tin 1 phiếu kiểm hàng

GET/shops/{SHOP_ID}/stocktakings/{STOCKTAKING_ID}

Tham số đường dẫn

SHOP_IDintegerbắt buộc

Mã shop

Ví dụ: 4
STOCKTAKING_IDstringbắt buộc

Mã phiếu kiểm

Ví dụ: "949f1396-f6fa-45d9-93b6-4c37503a9950"

Phản hồi

object
dataStocktaking

Thông tin kiểm hàng

successboolean

Trạng thái thành công

Yêu cầu
curl "https://pos.pages.fm/api/v1/shops/{SHOP_ID}/stocktakings/{STOCKTAKING_ID}?api_key=API_KEY"
Phản hồi 200
{
  "success": true,
  "data": {
    "id": "4d0f479d-feab-489b-bc82-4a656902a20b",
    "display_id": null,
    "status": 0,
    "warehouse_id": "c52e67ad-d9d0-4276-abe4-e0c9f1f7d2da",
    "stocktaking_by": "category_ids",
    "stocktaking_by_value": [
      "1315"
    ],
    "stocktaking_at": "2023-10-11T08:24:56Z",
    "progress": 0,
    "note": "Kiểm hàng tồn",
    "items": [
      {
        "id": "cb244b25-100e-4eaa-8b8f-0e72c5642631",
        "variation_id": "27b3f94b-c945-4560-b694-a59526cae9a5",
        "changed_quantity": 12,
        "current_quantity": 0,
        "note": null,
        "variation": {
          "id": "27b3f94b-c945-4560-b694-a59526cae9a5",
          "display_id": "1",
          "barcode": "12ml-6291107458328",
          "product_id": "61894c4f-d759-45b7-acf7-ff5e88082016",
          "retail_price": 240000,
          "last_imported_price": 20000,
          "weight": 1000,
          "fields": [],
          "images": [
            "https://statics.pancake.vn/user-content.pancake.vn/2023/4/12/05138842c6f772cde332fd8e1be1bff58245f19e.png"
          ],
          "product": {
            "display_id": "12ml-6291107458328",
            "name": "12ml Badee Al Oud",
            "image": null,
            "note_product": ""
          }
        },
        "inserted_at": "2024-12-02T10:42:39Z",
        "updated_at": "2024-12-02T10:42:39Z"
      }
    ],
    "shop_id": 20,
    "creator_id": "cee3c05e-5f85-43c4-b27e-889b99c50097",
    "inserted_at": "2023-10-11T08:25:18Z",
    "updated_at": "2023-10-11T09:03:03Z",
    "updated_status_at": "2023-10-11T08:25:18Z"
  }
}

Cập nhật kiểm hàng

PUT/shops/{SHOP_ID}/stocktakings/{STOCKTAKING_ID}

Tham số đường dẫn

SHOP_IDintegerbắt buộc

Mã shop

Ví dụ: 4
STOCKTAKING_IDstringbắt buộc

Mã phiếu kiểm

Ví dụ: "949f1396-f6fa-45d9-93b6-4c37503a9950"

Nội dung yêu cầu

Thông tin yêu cầu chứa thông tin kiểm kê cần cập nhật

object
stocktakingobjectbắt buộc

Phản hồi

object
successboolean

Trạng thái thành công

Yêu cầu
curl -X PUT "https://pos.pages.fm/api/v1/shops/{SHOP_ID}/stocktakings/{STOCKTAKING_ID}?api_key=API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "stocktaking": {
    "items": [
      {
        "id": "cb244b25-100e-4eaa-8b8f-0e72c5642631",
        "variation_id": "27b3f94b-c945-4560-b694-a59526cae9a5",
        "changed_quantity": 12,
        "note": null
      }
    ],
    "note": "Kiểm hàng tồn",
    "status": 0,
    "stocktaking_at": "2023-10-11T10:38:34",
    "stocktaking_by": "category_ids",
    "stocktaking_by_value": [
      "1315"
    ]
  }
}'
Phản hồi 200
{
  "success": true
}