inventory-transfer.md

Inventory Transfer

Represents the transfer of a quantity of product inventory at a particular time from one location to another.

Structure

Inventory Transfer

Fields

Name	Type	Tags	Description
id	str	Optional	A unique ID generated by Square for the InventoryTransfer. Constraints: Maximum Length: 100
reference_id	str	Optional	An optional ID provided by the application to tie the InventoryTransfer to an external system. Constraints: Maximum Length: 255
state	str (Inventory State)	Optional	Indicates the state of a tracked item quantity in the lifecycle of goods.
from_location_id	str	Optional	The Square-generated ID of the Location where the related quantity of items was tracked before the transfer. Constraints: Maximum Length: 100
to_location_id	str	Optional	The Square-generated ID of the Location where the related quantity of items was tracked after the transfer. Constraints: Maximum Length: 100
catalog_object_id	str	Optional	The Square-generated ID of the CatalogObject being tracked. Constraints: Maximum Length: 100
catalog_object_type	str	Optional	The type of the CatalogObject being tracked. The Inventory API supports setting and reading the "catalog_object_type": "ITEM_VARIATION" field value. In addition, it can also read the "catalog_object_type": "ITEM" field value that is set by the Square Restaurants app. Constraints: Maximum Length: 14
quantity	str	Optional	The number of items affected by the transfer as a decimal string. Can support up to 5 digits after the decimal point. Constraints: Maximum Length: 26
occurred_at	str	Optional	A client-generated RFC 3339-formatted timestamp that indicates when the transfer took place. For write actions, the occurred_at timestamp cannot be older than 24 hours or in the future relative to the time of the request. Constraints: Maximum Length: 34
created_at	str	Optional	An RFC 3339-formatted timestamp that indicates when Square received the transfer request. Constraints: Maximum Length: 34
source	Source Application	Optional	Represents information about the application used to generate a change.
employee_id	str	Optional	The Square-generated ID of the Employee responsible for the inventory transfer. Constraints: Maximum Length: 100
team_member_id	str	Optional	The Square-generated ID of the Team Member responsible for the inventory transfer. Constraints: Maximum Length: 100

Example (as JSON)

{
  "id": "id8",
  "reference_id": "reference_id4",
  "state": "ORDERED_FROM_VENDOR",
  "from_location_id": "from_location_id0",
  "to_location_id": "to_location_id0"
}