SquareConnect::InventoryAdjustment

July 10, 2019 ยท View on GitHub

Description

Represents a change in state or quantity of product inventory at a particular time and location.

Properties

NameTypeDescriptionNotes
idStringA unique ID generated by Square for the InventoryAdjustment.[optional]
reference_idStringAn optional ID provided by the application to tie the InventoryAdjustment to an external system.[optional]
from_stateStringThe InventoryState of the related quantity of items before the adjustment. See InventoryState for possible values[optional]
to_stateStringThe InventoryState of the related quantity of items after the adjustment. See InventoryState for possible values[optional]
location_idStringThe Square ID of the Location where the related quantity of items are being tracked.[optional]
catalog_object_idStringThe Square generated ID of the CatalogObject being tracked.[optional]
catalog_object_typeStringThe CatalogObjectType of the CatalogObject being tracked. Tracking is only supported for the `ITEM_VARIATION` type.[optional]
quantityStringThe number of items affected by the adjustment as a decimal string. Can support up to 5 digits after the decimal point. Important: The Point of Sale app and Dashboard do not currently support decimal quantities. If a Point of Sale app or Dashboard attempts to read a decimal quantity on inventory counts or adjustments, the quantity will be rounded down to the nearest integer. For example, `2.5` will become `2`, and `-2.5` will become `-3`. Read Decimal Quantities (BETA) for more information.[optional]
total_price_moneyMoneyThe read-only total price paid for goods associated with the adjustment. Present if and only if `to_state` is `SOLD`. Always non-negative.[optional]
occurred_atStringA client-generated timestamp in RFC 3339 format that indicates when the adjustment 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.[optional]
created_atStringA read-only timestamp in RFC 3339 format that indicates when Square received the adjustment.[optional]
sourceSourceApplicationRead-only information about the application that caused the inventory adjustment.[optional]
employee_idStringThe Square ID of the Employee responsible for the inventory adjustment.[optional]
transaction_idStringThe read-only Square ID of the [Transaction][#type-transaction] that caused the adjustment. Only relevant for payment-related state transitions.[optional]
refund_idStringThe read-only Square ID of the [Refund][#type-refund] that caused the adjustment. Only relevant for refund-related state transitions.[optional]
purchase_order_idStringThe read-only Square ID of the purchase order that caused the adjustment. Only relevant for state transitions from the Square for Retail app.[optional]
goods_receipt_idStringThe read-only Square ID of the Square goods receipt that caused the adjustment. Only relevant for state transitions from the Square for Retail app.[optional]