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

Chuyển kho

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

Xem Markdown
Endpoint
GET/shops/{SHOP_ID}/transfersDanh sách chuyển khoPOST/shops/{SHOP_ID}/transfers/multiTạo phiếu chuyển khoGET/shops/{SHOP_ID}/transfers/{TRANSFER_ID}Chi tiết phiếu chuyển khoPUT/shops/{SHOP_ID}/transfers/{TRANSFER_ID}Cập nhật phiếu chuyển khoGET/shops/{SHOP_ID}/transfers/get_status_history/{TRANSFER_ID}Lịch sử cập nhật trạng thái chuyển kho

Danh sách chuyển kho

GET/shops/{SHOP_ID}/transfers

Lấy danh sách chuyển kho

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ị0Chờ chuyển hàng1Đang chuyển hàng2Hoàn tất
Mặc định: 1 · Ví dụ: 1
startDateinteger

Ngày bắt đầu

Ví dụ: 0
endDateinteger

Ngày kết thúc

Ví dụ: 0

Phản hồi

object
dataarray<WarehouseTransfer>

Danh sách chuyển kho

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}/transfers?api_key=API_KEY"
Phản hồi 200
{
  "success": true,
  "data": [
    {
      "id": "5c9ef4a6-2411-4d5f-9a91-1bc22dbb7eb1",
      "display_id": 309,
      "status": 0,
      "from_warehouse_id": "c52e67ad-d9d0-4276-abe4-e0c9f1f7d2da",
      "from_warehouse_name": "Kho HCM",
      "to_warehouse_id": "229102e4-39c3-4523-bd57-4ed0a45a85ba",
      "to_warehouse_name": "Cho tao cơm",
      "total_quantity": 1,
      "shipping_fee": 30000,
      "note": "Chuyển kho bán hàng",
      "items": [
        {
          "id": "f80bdc16-a000-4bf1-a979-c3fd4033f551",
          "variation_id": "3b11fb7b-9081-42c0-9546-dfac62b9c9ca",
          "quantity": 3,
          "product_display_id": "áo nam",
          "product_name": "áo nam",
          "variation_display_id": "XANH-M",
          "variation_fields": [
            {
              "id": "beb75502-5a50-48d6-bed8-89ea8ddc9a66",
              "name": "màu",
              "value": "xanh dương",
              "keyValue": "xanh dương"
            },
            {
              "id": "8eee6f85-0a76-46da-9dd7-6668bc6d8729",
              "name": "size",
              "value": "M",
              "keyValue": "M"
            }
          ]
        }
      ],
      "images": [
        "https://content.pancake.vn/user-content-dev2.pancake.vn/2022/7/7/eb376f0bf90f47d25396d49e4d547700f182981b.jpg"
      ],
      "shop_id": 20,
      "creator_id": "cee3c05e-5f85-43c4-b27e-889b99c50097",
      "inserted_at": "2023-09-13T09:34:37Z",
      "updated_status_at": "2023-09-13T09:34:37Z"
    }
  ]
}

Tạo phiếu chuyển kho

POST/shops/{SHOP_ID}/transfers/multi

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 chuyển kho cần tạo

object
transferobjectbắ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}/transfers/multi?api_key=API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "transfer": {
    "from_warehouse_id": "c52e67ad-d9d0-4276-abe4-e0c9f1f7d2da",
    "to_warehouse_ids": [
      "229102e4-39c3-4523-bd57-4ed0a45a85ba"
    ],
    "shipping_fee": 20000,
    "items": [
      {
        "quantity": 1,
        "variation_id": "20e7d183-c70c-445e-8ce2-4d7e3a378e34"
      }
    ],
    "note": "đây là ghi chú",
    "images": [
      "https://content.pancake.vn/user-content-dev2.pancake.vn/2022/5/27/ee3be79d1574735ed35539ca48f7f6e9d7137706.jpg"
    ],
    "inserted_at": "2025-03-11T09:24:42"
  }
}'
Phản hồi 200
{
  "success": true
}

Chi tiết phiếu chuyển kho

GET/shops/{SHOP_ID}/transfers/{TRANSFER_ID}

Lấy một phiếu chuyển kho theo mã hoặc mã hiển thị, cùng dạng một phần tử của danh sách. Thấy phiếu khi người gọi được xem phiếu chuyển kho ở kho đi hoặc kho đến; nếu không thì trả về không tìm thấy.

Tham số đường dẫn

SHOP_IDintegerbắt buộc

Mã shop

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

Mã phiếu chuyển kho (UUID) hoặc mã hiển thị

Ví dụ: "b482ae3a-b89a-4d64-9859-ed6e3af5a476"

Phản hồi

object
dataWarehouseTransfer

Thông tin chuyển kho

successboolean

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

Yêu cầu
curl "https://pos.pages.fm/api/v1/shops/{SHOP_ID}/transfers/{TRANSFER_ID}?api_key=API_KEY"
Phản hồi 200
{
  "success": true,
  "data": {
    "id": "5c9ef4a6-2411-4d5f-9a91-1bc22dbb7eb1",
    "display_id": 309,
    "status": 0,
    "from_warehouse_id": "c52e67ad-d9d0-4276-abe4-e0c9f1f7d2da",
    "from_warehouse_name": "Kho HCM",
    "to_warehouse_id": "229102e4-39c3-4523-bd57-4ed0a45a85ba",
    "to_warehouse_name": "Cho tao cơm",
    "total_quantity": 1,
    "shipping_fee": 30000,
    "note": "Chuyển kho bán hàng",
    "items": [
      {
        "id": "f80bdc16-a000-4bf1-a979-c3fd4033f551",
        "variation_id": "3b11fb7b-9081-42c0-9546-dfac62b9c9ca",
        "quantity": 3,
        "product_display_id": "áo nam",
        "product_name": "áo nam",
        "variation_display_id": "XANH-M",
        "variation_fields": [
          {
            "id": "beb75502-5a50-48d6-bed8-89ea8ddc9a66",
            "name": "màu",
            "value": "xanh dương",
            "keyValue": "xanh dương"
          },
          {
            "id": "8eee6f85-0a76-46da-9dd7-6668bc6d8729",
            "name": "size",
            "value": "M",
            "keyValue": "M"
          }
        ]
      }
    ],
    "images": [
      "https://content.pancake.vn/user-content-dev2.pancake.vn/2022/7/7/eb376f0bf90f47d25396d49e4d547700f182981b.jpg"
    ],
    "shop_id": 20,
    "creator_id": "cee3c05e-5f85-43c4-b27e-889b99c50097",
    "inserted_at": "2023-09-13T09:34:37Z",
    "updated_status_at": "2023-09-13T09:34:37Z"
  }
}

Cập nhật phiếu chuyển kho

PUT/shops/{SHOP_ID}/transfers/{TRANSFER_ID}

Tham số đường dẫn

SHOP_IDintegerbắt buộc

Mã shop

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

Mã chuyển kho

Ví dụ: "b482ae3a-b89a-4d64-9859-ed6e3af5a476"

Nội dung yêu cầu

Thông tin yêu cầu chứa thông tin chuyển kho cần cập nhật

object
transferobjectbắ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}/transfers/{TRANSFER_ID}?api_key=API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "transfer": {
    "status": 1,
    "from_warehouse_id": "c52e67ad-d9d0-4276-abe4-e0c9f1f7d2da",
    "shipping_fee": 10000,
    "items": [
      {
        "variation_id": "51bb0bb7-77e9-407e-9f57-5072a0236cb4",
        "quantity": 1
      }
    ],
    "note": "Chuyển kho bán hàng",
    "images": [
      "https://content.pancake.vn/user-content-dev2.pancake.vn/2024/8/30/7886ccd76d3629808d21fa3e59849c8e79a28162.png"
    ],
    "inserted_at": "2025-03-11T09:24:42",
    "change_inserted_at": true
  }
}'
Phản hồi 200
{
  "success": true
}

Lịch sử cập nhật trạng thái chuyển kho

GET/shops/{SHOP_ID}/transfers/get_status_history/{TRANSFER_ID}

Lấy lịch sử cập nhật trạng thái chuyển kho

Tham số đường dẫn

SHOP_IDintegerbắt buộc

Mã shop

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

Mã chuyển kho

Ví dụ: "b482ae3a-b89a-4d64-9859-ed6e3af5a476"

Phản hồi

object
dataarray<object>

Danh sách lịch sử trạng thái

successboolean

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

Yêu cầu
curl "https://pos.pages.fm/api/v1/shops/{SHOP_ID}/transfers/get_status_history/{TRANSFER_ID}?api_key=API_KEY"
Phản hồi 200
{
  "success": true,
  "data": [
    {
      "id": "4c961f28-9a1c-11f0-9d68-0242ac1a000a",
      "old_status": 0,
      "status": 1,
      "transfer_id": "ed386c72-ba0c-4b2a-85dd-c8b1903badc2",
      "updated_at": "2025-09-25T14:31:18Z",
      "user_id": "cee3c05e-5f85-43c4-b27e-889b99c50097",
      "user": {
        "avatar_url": null,
        "fb_id": "377936050731194",
        "name": "Vũ Sơn"
      }
    }
  ]
}