InventoryAdjustment

November 20, 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]
referenceIdStringAn optional ID provided by the application to tie the `InventoryAdjustment` to an external system.[optional]
fromStateStringThe `InventoryState` of the related quantity of items before the adjustment. See InventoryState for possible values[optional]
toStateStringThe `InventoryState` of the related quantity of items after the adjustment. See InventoryState for possible values[optional]
locationIdStringThe Square ID of the `Location` where the related quantity of items are being tracked.[optional]
catalogObjectIdStringThe Square generated ID of the `CatalogObject` being tracked.[optional]
catalogObjectTypeStringThe `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] [beta]
totalPriceMoneyMoneyThe read-only total price paid for goods associated with the adjustment. Present if and only if `to_state` is `SOLD`. Always non-negative.[optional]
occurredAtStringA 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]
createdAtStringA 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]
employeeIdStringThe Square ID of the `Employee` responsible for the inventory adjustment.[optional]
transactionIdStringThe read-only Square ID of the [Transaction][#type-transaction] that caused the adjustment. Only relevant for payment-related state transitions.[optional]
refundIdStringThe read-only Square ID of the [Refund][#type-refund] that caused the adjustment. Only relevant for refund-related state transitions.[optional]
purchaseOrderIdStringThe read-only Square ID of the purchase order that caused the adjustment. Only relevant for state transitions from the Square for Retail app.[optional]
goodsReceiptIdStringThe 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]