Transactions

Inventory transactions: Stock In, Stock Out, Move Stock, and Adjust Stock.

Each transaction is immutable except via update or delete with a matching revision.

ออบเจ็กต์ LocationTransaction

An inventory transaction with its full line-item detail. Branch on type to narrow the variant (e.g. tx.type === 'move' makes tx.from_location available).

one of

An inventory transaction with its full line-item detail. Branch on type to narrow the variant (e.g. tx.type === 'move' makes tx.from_location available).

อย่างใดอย่างหนึ่งต่อไปนี้

LocationTransactionIn

idintegerminimum 0, maximum 2147483647จำเป็น

Transaction id.

to_locationEntityจำเป็น

Reference to a related entity (location, partner, or user) embedded in a transaction. The snapshot is captured at transaction time and does not update if the source entity is later renamed or removed.

แสดงพร็อพเพอร์ตี

idintegerminimum 0, maximum 2147483647จำเป็น

Id of the referenced entity.

namestringจำเป็น

Display name of the entity at the time the transaction was recorded.

deletedbooleanจำเป็น

true when the underlying entity has since been deleted. The embedded snapshot is preserved so historical transactions remain readable.

transaction_timestringdate-timeจำเป็น

Effective time of the transaction. Defaults to the creation time if tx_time is omitted on create; change it later by passing tx_time on update.

created_atstringdate-timeจำเป็น

Server-side creation timestamp.

created_byEntityจำเป็น

แสดงพร็อพเพอร์ตี

idintegerminimum 0, maximum 2147483647จำเป็น

Id of the referenced entity.

namestringจำเป็น

Display name of the entity at the time the transaction was recorded.

deletedbooleanจำเป็น

true when the underlying entity has since been deleted. The embedded snapshot is preserved so historical transactions remain readable.

count_of_itemsintegerminimum -9007199254740991, maximum 9007199254740991จำเป็น

Number of distinct items in the transaction.

total_quantitynumberจำเป็น

Signed sum of quantity across every item in the transaction. For Move Stock, the sum of the quantities moved to the destination.

urlstringuriจำเป็น

Web URL to view this transaction in the BoxHero app.

memostringจำเป็น

Free-text memo. Empty string when not set.

revisionintegerminimum -9007199254740991, maximum 9007199254740991จำเป็น

Optimistic-concurrency version. Increments on every update. Pass the current value to update/delete to detect concurrent edits — the operation returns 403 (/errors/invalid-request with code: tx-modify-revision-mismatch) if the value does not match the server.

typestringจำเป็น

ค่าที่เป็นไปได้in

partnerEntitynullable

Supplier on this Stock In transaction. null or absent when no partner was recorded.

แสดงพร็อพเพอร์ตี

idintegerminimum 0, maximum 2147483647จำเป็น

Id of the referenced entity.

namestringจำเป็น

Display name of the entity at the time the transaction was recorded.

deletedbooleanจำเป็น

true when the underlying entity has since been deleted. The embedded snapshot is preserved so historical transactions remain readable.

itemsarray of LocationTransactionItemจำเป็น

Line items recorded by this transaction.

แสดงพร็อพเพอร์ตี

idintegerminimum 0, maximum 2147483647จำเป็น

Item id. Deprecated — prefer item.id.

namestringจำเป็น

Item display name at the time of the transaction (snapshot). Deprecated — prefer item.name.

skustringจำเป็น

Item SKU. Empty string when unset. Deprecated — prefer item.sku.

barcodestringจำเป็น

Item barcode. Empty string when unset. Deprecated — prefer item.barcode.

deletedbooleanจำเป็น

true when the item itself has since been deleted. Deprecated — prefer item.deleted.

itemExtendedItemEntityจำเป็น

Reference to an item or bundle embedded in order, return, transaction, and bundle component responses.

แสดงพร็อพเพอร์ตี

idintegerminimum 0, maximum 2147483647จำเป็น

Item or bundle id.

namestringจำเป็น

Display name.

skustringจำเป็น

SKU. Empty string when unset.

barcodestringจำเป็น

Barcode. Empty string when unset.

deletedbooleanจำเป็น

Whether the underlying item or bundle is deleted.

quantitynumberจำเป็น

Signed quantity moved by this line. Positive for Stock In and Move Stock (the quantity arriving at the destination); negative for Stock Out; signed for Adjust Stock.

from_location_new_stock_levelnumber

Source-location stock level for this item after the transaction. Set only on Move Stock.

to_location_new_stock_levelnumberจำเป็น

Destination-location stock level for this item after the transaction.

new_stock_levelnumberจำเป็น

Total on-hand quantity for this item across all locations after the transaction.

LocationTransactionOut

idintegerminimum 0, maximum 2147483647จำเป็น

Transaction id.

to_locationEntityจำเป็น

แสดงพร็อพเพอร์ตี

idintegerminimum 0, maximum 2147483647จำเป็น

Id of the referenced entity.

namestringจำเป็น

Display name of the entity at the time the transaction was recorded.

deletedbooleanจำเป็น

true when the underlying entity has since been deleted. The embedded snapshot is preserved so historical transactions remain readable.

transaction_timestringdate-timeจำเป็น

Effective time of the transaction. Defaults to the creation time if tx_time is omitted on create; change it later by passing tx_time on update.

created_atstringdate-timeจำเป็น

Server-side creation timestamp.

created_byEntityจำเป็น

แสดงพร็อพเพอร์ตี

idintegerminimum 0, maximum 2147483647จำเป็น

Id of the referenced entity.

namestringจำเป็น

Display name of the entity at the time the transaction was recorded.

deletedbooleanจำเป็น

true when the underlying entity has since been deleted. The embedded snapshot is preserved so historical transactions remain readable.

count_of_itemsintegerminimum -9007199254740991, maximum 9007199254740991จำเป็น

Number of distinct items in the transaction.

total_quantitynumberจำเป็น

Signed sum of quantity across every item in the transaction. For Move Stock, the sum of the quantities moved to the destination.

urlstringuriจำเป็น

Web URL to view this transaction in the BoxHero app.

memostringจำเป็น

Free-text memo. Empty string when not set.

revisionintegerminimum -9007199254740991, maximum 9007199254740991จำเป็น

typestringจำเป็น

ค่าที่เป็นไปได้out

partnerEntitynullable

Customer on this Stock Out transaction. null or absent when no partner was recorded.

แสดงพร็อพเพอร์ตี

idintegerminimum 0, maximum 2147483647จำเป็น

Id of the referenced entity.

namestringจำเป็น

Display name of the entity at the time the transaction was recorded.

deletedbooleanจำเป็น

true when the underlying entity has since been deleted. The embedded snapshot is preserved so historical transactions remain readable.

itemsarray of LocationTransactionItemจำเป็น

Line items recorded by this transaction.

แสดงพร็อพเพอร์ตี

idintegerminimum 0, maximum 2147483647จำเป็น

Item id. Deprecated — prefer item.id.

namestringจำเป็น

Item display name at the time of the transaction (snapshot). Deprecated — prefer item.name.

skustringจำเป็น

Item SKU. Empty string when unset. Deprecated — prefer item.sku.

barcodestringจำเป็น

Item barcode. Empty string when unset. Deprecated — prefer item.barcode.

deletedbooleanจำเป็น

true when the item itself has since been deleted. Deprecated — prefer item.deleted.

itemExtendedItemEntityจำเป็น

Reference to an item or bundle embedded in order, return, transaction, and bundle component responses.

แสดงพร็อพเพอร์ตี

idintegerminimum 0, maximum 2147483647จำเป็น

Item or bundle id.

namestringจำเป็น

Display name.

skustringจำเป็น

SKU. Empty string when unset.

barcodestringจำเป็น

Barcode. Empty string when unset.

deletedbooleanจำเป็น

Whether the underlying item or bundle is deleted.

quantitynumberจำเป็น

Signed quantity moved by this line. Positive for Stock In and Move Stock (the quantity arriving at the destination); negative for Stock Out; signed for Adjust Stock.

from_location_new_stock_levelnumber

Source-location stock level for this item after the transaction. Set only on Move Stock.

to_location_new_stock_levelnumberจำเป็น

Destination-location stock level for this item after the transaction.

new_stock_levelnumberจำเป็น

Total on-hand quantity for this item across all locations after the transaction.

LocationTransactionMove

idintegerminimum 0, maximum 2147483647จำเป็น

Transaction id.

to_locationEntityจำเป็น

แสดงพร็อพเพอร์ตี

idintegerminimum 0, maximum 2147483647จำเป็น

Id of the referenced entity.

namestringจำเป็น

Display name of the entity at the time the transaction was recorded.

deletedbooleanจำเป็น

true when the underlying entity has since been deleted. The embedded snapshot is preserved so historical transactions remain readable.

transaction_timestringdate-timeจำเป็น

Effective time of the transaction. Defaults to the creation time if tx_time is omitted on create; change it later by passing tx_time on update.

created_atstringdate-timeจำเป็น

Server-side creation timestamp.

created_byEntityจำเป็น

แสดงพร็อพเพอร์ตี

idintegerminimum 0, maximum 2147483647จำเป็น

Id of the referenced entity.

namestringจำเป็น

Display name of the entity at the time the transaction was recorded.

deletedbooleanจำเป็น

true when the underlying entity has since been deleted. The embedded snapshot is preserved so historical transactions remain readable.

count_of_itemsintegerminimum -9007199254740991, maximum 9007199254740991จำเป็น

Number of distinct items in the transaction.

total_quantitynumberจำเป็น

Signed sum of quantity across every item in the transaction. For Move Stock, the sum of the quantities moved to the destination.

urlstringuriจำเป็น

Web URL to view this transaction in the BoxHero app.

memostringจำเป็น

Free-text memo. Empty string when not set.

revisionintegerminimum -9007199254740991, maximum 9007199254740991จำเป็น

typestringจำเป็น

ค่าที่เป็นไปได้move

from_locationEntityจำเป็น

แสดงพร็อพเพอร์ตี

idintegerminimum 0, maximum 2147483647จำเป็น

Id of the referenced entity.

namestringจำเป็น

Display name of the entity at the time the transaction was recorded.

deletedbooleanจำเป็น

true when the underlying entity has since been deleted. The embedded snapshot is preserved so historical transactions remain readable.

itemsarray of LocationTransactionItemจำเป็น

Line items recorded by this transaction.

แสดงพร็อพเพอร์ตี

idintegerminimum 0, maximum 2147483647จำเป็น

Item id. Deprecated — prefer item.id.

namestringจำเป็น

Item display name at the time of the transaction (snapshot). Deprecated — prefer item.name.

skustringจำเป็น

Item SKU. Empty string when unset. Deprecated — prefer item.sku.

barcodestringจำเป็น

Item barcode. Empty string when unset. Deprecated — prefer item.barcode.

deletedbooleanจำเป็น

true when the item itself has since been deleted. Deprecated — prefer item.deleted.

itemExtendedItemEntityจำเป็น

Reference to an item or bundle embedded in order, return, transaction, and bundle component responses.

แสดงพร็อพเพอร์ตี

idintegerminimum 0, maximum 2147483647จำเป็น

Item or bundle id.

namestringจำเป็น

Display name.

skustringจำเป็น

SKU. Empty string when unset.

barcodestringจำเป็น

Barcode. Empty string when unset.

deletedbooleanจำเป็น

Whether the underlying item or bundle is deleted.

quantitynumberจำเป็น

Signed quantity moved by this line. Positive for Stock In and Move Stock (the quantity arriving at the destination); negative for Stock Out; signed for Adjust Stock.

from_location_new_stock_levelnumber

Source-location stock level for this item after the transaction. Set only on Move Stock.

to_location_new_stock_levelnumberจำเป็น

Destination-location stock level for this item after the transaction.

new_stock_levelnumberจำเป็น

Total on-hand quantity for this item across all locations after the transaction.

LocationTransactionAdjust

idintegerminimum 0, maximum 2147483647จำเป็น

Transaction id.

to_locationEntityจำเป็น

แสดงพร็อพเพอร์ตี

idintegerminimum 0, maximum 2147483647จำเป็น

Id of the referenced entity.

namestringจำเป็น

Display name of the entity at the time the transaction was recorded.

deletedbooleanจำเป็น

true when the underlying entity has since been deleted. The embedded snapshot is preserved so historical transactions remain readable.

transaction_timestringdate-timeจำเป็น

Effective time of the transaction. Defaults to the creation time if tx_time is omitted on create; change it later by passing tx_time on update.

created_atstringdate-timeจำเป็น

Server-side creation timestamp.

created_byEntityจำเป็น

แสดงพร็อพเพอร์ตี

idintegerminimum 0, maximum 2147483647จำเป็น

Id of the referenced entity.

namestringจำเป็น

Display name of the entity at the time the transaction was recorded.

deletedbooleanจำเป็น

true when the underlying entity has since been deleted. The embedded snapshot is preserved so historical transactions remain readable.

count_of_itemsintegerminimum -9007199254740991, maximum 9007199254740991จำเป็น

Number of distinct items in the transaction.

total_quantitynumberจำเป็น

Signed sum of quantity across every item in the transaction. For Move Stock, the sum of the quantities moved to the destination.

urlstringuriจำเป็น

Web URL to view this transaction in the BoxHero app.

memostringจำเป็น

Free-text memo. Empty string when not set.

revisionintegerminimum -9007199254740991, maximum 9007199254740991จำเป็น

typestringจำเป็น

ค่าที่เป็นไปได้adjust

itemsarray of LocationTransactionItemจำเป็น

Line items recorded by this transaction.

แสดงพร็อพเพอร์ตี

idintegerminimum 0, maximum 2147483647จำเป็น

Item id. Deprecated — prefer item.id.

namestringจำเป็น

Item display name at the time of the transaction (snapshot). Deprecated — prefer item.name.

skustringจำเป็น

Item SKU. Empty string when unset. Deprecated — prefer item.sku.

barcodestringจำเป็น

Item barcode. Empty string when unset. Deprecated — prefer item.barcode.

deletedbooleanจำเป็น

true when the item itself has since been deleted. Deprecated — prefer item.deleted.

itemExtendedItemEntityจำเป็น

Reference to an item or bundle embedded in order, return, transaction, and bundle component responses.

แสดงพร็อพเพอร์ตี

idintegerminimum 0, maximum 2147483647จำเป็น

Item or bundle id.

namestringจำเป็น

Display name.

skustringจำเป็น

SKU. Empty string when unset.

barcodestringจำเป็น

Barcode. Empty string when unset.

deletedbooleanจำเป็น

Whether the underlying item or bundle is deleted.

quantitynumberจำเป็น

Signed quantity moved by this line. Positive for Stock In and Move Stock (the quantity arriving at the destination); negative for Stock Out; signed for Adjust Stock.

from_location_new_stock_levelnumber

Source-location stock level for this item after the transaction. Set only on Move Stock.

to_location_new_stock_levelnumberจำเป็น

Destination-location stock level for this item after the transaction.

new_stock_levelnumberจำเป็น

Total on-hand quantity for this item across all locations after the transaction.

ตัวอย่าง

{
  "id": 14012345,
  "type": "in",
  "to_location": {
    "id": 47041,
    "name": "Warehouse",
    "deleted": false
  },
  "transaction_time": "2026-01-16T11:00:00.000Z",
  "created_at": "2026-01-16T11:00:00.000Z",
  "created_by": {
    "id": 1001,
    "name": "John Smith",
    "deleted": false
  },
  "count_of_items": 1,
  "total_quantity": 100,
  "url": "https://app.boxhero-app.com/transactions/14012345",
  "memo": "",
  "revision": 1,
  "partner": {
    "id": 431485,
    "name": "Acme Supply Co.",
    "deleted": false
  },
  "items": [
    {
      "id": 14290445,
      "name": "Finish Setting Powder",
      "sku": "SKU-12345678",
      "barcode": "2097678335587",
      "deleted": false,
      "item": {
        "id": 14290445,
        "name": "Finish Setting Powder",
        "sku": "SKU-12345678",
        "barcode": "2097678335587",
        "deleted": false
      },
      "quantity": 100,
      "from_location_new_stock_level": null,
      "to_location_new_stock_level": 220,
      "new_stock_level": 220
    }
  ]
}

เอนด์พอยต์

List transactions GET /v1/transactions
Create a transaction POST /v1/transactions
Get a transaction GET /v1/transactions/{tx_id}
Update a transaction PUT /v1/transactions/{tx_id}
Delete a transaction DELETE /v1/transactions/{tx_id}