---
title: "Get inventory transfers"
method: GET
path: "/pos/inventory_transfers"
tags: ["Inventory Transfers"]
---

# Get inventory transfers

`GET /pos/inventory_transfers`

Get inventory transfers<br>取得調撥單

## Query parameters

- `page` integer
- `per_page` integer
- `sort_by` 'asc' | 'desc'
- `statuses[]` string[]
- `arrival_statuses[]` string[]
- `origin_id` string
- `destination_id` string
- `origin_warehouse_id` string
- `destination_warehouse_id` string
- `start_date` string
- `end_date` string
- `updated_after` string
- `number` string
- `type` 'normal' | 'request'
- `previous_id` string

## Response `200`

OK

- InventoryTransfers
  - `pagination` Paginatable
    - `current_page` integer — The current page number<br>當前分頁
    - `per_page` integer — Number of result per page<br>每頁顯示 n 筆資料<br>(Default: 24)
    - `total_count` integer — Number of result in total<br>資料總量
    - `total_pages` integer — Number of pages in total<br>總頁數量
  - `items` InventoryTransfer[]
    - `id` string — Inventory transfer ID<br>調撥單 ID
    - `number` string — Inventory transfer number<br>調撥單號
    - `status` 'pending' | 'transferring' | 'completed' | 'cancelled' | 'removed' — Status<br>調撥單狀態
    - `arrival_status` 'pending' | 'partial_received' | 'received' | 'unknown' — Arrival status<br>到貨狀態
    - `delivery_date` string, date — Delivery date<br>調撥日期
    - `merchant_id` string — Merchant ID<br>商家 ID
    - `note` string — Note<br>備註
    - `type` 'normal' | 'request' — Type<br>類型
    - `items` InventoryTransferItem[]
      - `id` string — Inventory transfer item ID<br>調撥單品項 ID
      - `product_id` string — Product ID<br>商品 ID
      - `variation_id` string — Variation ID<br>款式 ID
      - `product_name` object — Product name translations<br>商品名稱
      - `variation_titles` object[] — Variation field titles<br>款式欄位名稱
      - `variation_name` object — Variation value translations<br>款式名稱
      - `image_url` string — Product image url<br>商品圖片連結
      - `sku` string — SKU<br>SKU
      - `gtin` string — GTIN<br>GTIN
      - `quantity` integer — Quantity<br>調撥數量
      - `quantity_received` integer — Quantity received<br>已點收數量
      - `product_removed` boolean — Whether product is removed<br>商品是否被移除
    - `origin` PosChannel
      - `id` string
      - `name` object
      - `warehouse_id` string
    - `destination` PosChannel
      - `id` string
      - `name` object
      - `warehouse_id` string
    - `origin_warehouse` PosWarehouse
      - `id` string — Warehouse’s id<br>倉庫 id
      - `name` string — Warehouse’s name<br>倉庫名稱
    - `destination_warehouse` PosWarehouse
      - `id` string — Warehouse’s id<br>倉庫 id
      - `name` string — Warehouse’s name<br>倉庫名稱
    - `issuer` union — Issuer<br>調出人員
      - PosStaff
        - `id` string
        - `name` string
        - `email` string
        - `phone` string
        - `status` string
        - `merchant_id` string
        - `alias_name` string
        - `channel_ids` string[]
        - `type` string
        - `pin_code` string
        - `is_working` boolean
        - `working_hour` number
      - PosAgent
        - `id` string — Id of the agent<br>員工ID
        - `email` string — Email of the agent<br>員工電郵
        - `name` string — Name of the agent<br>員工名稱
        - `phone` string — Phone of the agent<br>員工電話號碼
        - `merchant_id` string — Merchant ID of the agent<br>員工商家ID
        - `status` string — Status of the agent<br>員工狀態
        - `alias_name` string — Alias name of the agent<br>員工別名
        - `channel_ids` string[] — Staff's store IDs<br>員工所有的門市
        - `type` string — Type of the agent<br>員工類型
        - `pin_code` string — Pin code of the agent<br>員工密碼
    - `receiver` union — Receiver<br>調入人員
      - PosStaff
        - `id` string
        - `name` string
        - `email` string
        - `phone` string
        - `status` string
        - `merchant_id` string
        - `alias_name` string
        - `channel_ids` string[]
        - `type` string
        - `pin_code` string
        - `is_working` boolean
        - `working_hour` number
      - PosAgent
        - `id` string — Id of the agent<br>員工ID
        - `email` string — Email of the agent<br>員工電郵
        - `name` string — Name of the agent<br>員工名稱
        - `phone` string — Phone of the agent<br>員工電話號碼
        - `merchant_id` string — Merchant ID of the agent<br>員工商家ID
        - `status` string — Status of the agent<br>員工狀態
        - `alias_name` string — Alias name of the agent<br>員工別名
        - `channel_ids` string[] — Staff's store IDs<br>員工所有的門市
        - `type` string — Type of the agent<br>員工類型
        - `pin_code` string — Pin code of the agent<br>員工密碼
    - `has_removed_items` boolean — Has removed items<br>是否包含被移除的商品
    - `created_at` string — Created at<br>建立時間
    - `updated_at` string — Updated at<br>更新時間
  - `removed_item_ids` string[] — Removed inventory transfer IDs<br>被移除的調撥單 ID

## Other responses

- `403` — Forbidden
- `422` — Forbidden
- `500` — Server error

---

[API](https://skmtc.net/shoplineapp/apis/shopline-open-api.md) · [All operations](https://skmtc.net/shoplineapp/apis/shopline-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shoplineapp/shopline-open-api/revisions/1675ac12cde7/schema)