Transfer Order
The Transfer Order transaction is used to move inventory between locations when the Multi-Location Inventory (MLI) feature is enabled. Existing integrations with external warehouse management systems can leverage this transaction to manage data about inventory movement between locations.
Transfer orders can initialize item fulfillment and item receipt transactions. See Item Fulfillment and Item Receipt for details about these transactions.
The transfer order record is defined in the tranInvt (inventory) XSD.
Supported Operations
The following operations can be used to modify transfer order records:
add | addList | attach / detach | delete | deleteList | get | getDeleted | getList | getSavedSearch | getSelectValue | initialize / initializeList | search | update | updateList | upsert | upsertList
You can also use the asynchronous equivalents of SOAP web services list operations. For information about asynchronous operations, see SOAP Web Services Asynchronous Operations. For more information about request processing, see Synchronous Versus Asynchronous Request Processing.
Field Definitions
The SOAP Schema Browser includes definitions for all body fields, sublist fields, search filters, and search joins available to this record. For details, see the SOAP Schema Browser’s transfer order reference page.
For information about using the SOAP Schema Browser, see SOAP Schema Browser.
Usage Notes
Transfer Order Features and Preferences
The Transfer Order transaction is available when the Multi-Location Inventory feature is enabled. Note that the Pick, Pack and Ship feature can affect transfer order workflow.
The following accounting preferences, available at Setup > Accounting >Accounting Preferences, on the Order Management subtab, apply to transfer orders:
-
Default Transfer Order Status indicates whether transfer orders require approval by default.
-
Pending Approval means that by default the status of someone with permission must approve the order before it is processed.
-
Pending Fulfillment means that by default transfer orders are sent directly to the fulfillment queue without requiring further approval.
-
-
Use Item Cost as Transfer Cost affects how the Transfer Price from each transfer order is used on the related item receipt transaction.
-
When this option is enabled, the transfer price is used as a declared shipping value for reference only, such as for insurance or international shipping, and the item cost from the item record is used on the item receipt. Also, when this option is enabled and different items are fulfilled in different item fulfillments, you must receive the items separately. In this case, a separate item receipt is created for each item fulfillment.
-
When this option is disabled, the transfer price on the transfer order is used as the item cost on the item receipt. In this case, both the item fulfillment and the item receipt resulting from the transfer order have G/L impact. Also, when this option is disabled and different items are fulfilled in different item fulfillments, you can receive all items in the same item receipt.
-
Transfer Order Workflow
The following is a rough outline of transfer order workflow. For more details, see Inventory Transfer Orders.
-
A transfer order is entered to schedule the movement of items and its status is set to either Pending Approval or Pending Fulfillment.
A transfer order can be approved by setting the status to Pending Fulfillment.
Note:A transfer order initially can be saved without a source location value, for example, in a case where an item is needed at the destination location but the source location has not yet been identified. However, the source location value is required for an approved transfer order.
-
After its status is set to Pending fulfillment, the transfer order can be fulfilled from the source location.
-
An item fulfillment transaction is created.
-
Items are committed out of the source location's inventory.
-
The On Order quantity of items increases at the destination location.
-
Fulfilled items are removed from the On Hand count at the source location.
-
The value of items in transit are removed from the Inventory Asset account and added to the Inventory in Transit account for the source location.
-
The status of the transfer order is set to Pending Receipt, or if the Pick, Pack and Ship feature is enabled, to Shipped.
-
-
After the transfer order status has been set to Pending Receipt (or to Shipped),Transfer order items can be received at the destination location.
-
An item receipt transaction is created.
-
The items are added to the destination location's inventory and increase the On Hand count.
-
The items' value is added to the Inventory Asset account for the destination location.
-
The On Order quantity of the item in the destination location decreases.
-
Serialized and Lot Inventory Transfer Orders
Serial or lot numbered items can be included as transfer order line items. Note the following requirements:
-
Serial or lot numbers are limited to 3800 characters.
-
Supported separators for serial numbers are: space, comma, or line break.
-
A serial number is required for every serialized line item.
For example, if the quantity of a line item is 2, two serial numbers are required.
-
Lot numbers must use the following format: <Lot #>(<Quantity>)
For example, to indicate a quantity of 100 for an item with lot number AAA-3400, format would be: AAA-3400(100)
Accessing Serial/Lot or Bin Data for Line Items
As of the 2011.2 endpoint, code to access serial number, lot number, and bin number data varies according to whether the Advanced Bin Management / Numbered Inventory Management feature is enabled.
-
If this feature is enabled, you must use the 2011.2 endpoint or later to access the Inventory Detail subrecord and the most up-to-date bin and numbered inventory fields. You need to update any SOAP web services code from a previous endpoint that accesses these fields, to avoid errors or unexpected results.
-
If this feature is not enabled, you do not need to use the inventory detail record to access bin and numbered inventory fields and you do not need to update any related SOAP web services code from prior to 2011.2.
For more details, see Updating SOAP Web Services Code When Advanced Bin / Numbered Inventory Management is Enabled.