Move stock between locations | Distru Documentation

Moves quantity of batch-tracked or product-tracked products from one of your locations to another, completed at once (a stock transfer).

Inputs

Every tool also takes the common inputs.

Field	Type	Required	Description
fromLocationId	string	Yes	Resolve via distru-search-locations.
toLocationId	string	Yes	Must differ from fromLocationId. Resolve via distru-search-locations.
items	object[]	Yes
items[].batchId	string	No	Send exactly one of batchId or productId. A batch of a batch-tracked product. Resolve via distru-search-batches.
items[].productId	string	No	A product-tracked product. Resolve via distru-search-products.
items[].quantity	string or number	Yes	Greater than 0, in the product's unit type; at most the stock at fromLocationId, read with includeActiveQuantitiesByLocation on distru-get-batch (batchId) or distru-get-product (productId).
description	string	No
transferDatetime	string	No	The date the transfer shows. Defaults to now; the stock moves now either way. ISO 8601 with a UTC offset, e.g. "2026-09-01T00:00:00-07:00"; the company timezone is on distru-get-me.
customFields	object[]	No	Only the fields listed change. Required custom fields must be set, on update too, while still blank.
customFields[].customFieldId	string	Yes	Resolve via distru-search-custom-fields (entityType STOCK_TRANSFER).
customFields[].value	string or string[]	Yes	TEXT: the text. DROPDOWN: the option name. CHECKBOX: an array of option names. DATE: YYYY-MM-DD, company timezone. "" or [] clears the field.

Output

Presence on a nested field assumes its parent exists.

Field	Type	Presence
stockTransfer	object	Always
stockTransfer.id	string	Always
stockTransfer.stockTransferNumber	string	Always
stockTransfer.status	enum `CANCELEDCOMPLETEDTRANSIT`	Always
stockTransfer.transferDatetime	string	Can be null
stockTransfer.completedAt	string	Can be null
stockTransfer.description	string	Can be null
stockTransfer.customFields	object[]	Always
stockTransfer.customFields[].customField	object	Always
stockTransfer.customFields[].customField.id	string	Always
stockTransfer.customFields[].customField.name	string	Always
stockTransfer.customFields[].customField.fieldType	enum `CHECKBOXDATEDROPDOWNTEXT`	Always
stockTransfer.customFields[].value	string	Can be null
stockTransfer.fromLocation	object	Can be null
stockTransfer.fromLocation.id	string	Always
stockTransfer.fromLocation.name	string	Always
stockTransfer.toLocation	object	Can be null
stockTransfer.toLocation.id	string	Always
stockTransfer.toLocation.name	string	Always
stockTransfer.items	object[]	Always
stockTransfer.items[].quantity	string	Can be null
stockTransfer.items[].product	object	Always
stockTransfer.items[].product.id	string	Always
stockTransfer.items[].product.name	string	Always
stockTransfer.items[].batch	object	Can be null
stockTransfer.items[].batch.id	string	Always
stockTransfer.items[].batch.name	string	Always
stockTransfer.items[].package	object	Can be null
stockTransfer.items[].package.id	string	Always
stockTransfer.items[].package.metrcLabel	string	Always

What the AI reads

Moves quantity of batch-tracked or product-tracked products from one of your locations to another, completed at once (a stock transfer). Package-tracked products move as whole packages with distru-move-packages. Not idempotent: each call moves the stock again. Distru inventory only; nothing is sent to Metrc. Returns the stock transfer with its lines, as distru-search-stock-transfers does; batch is null on product-tracked lines.