Skip to main content

Move Order

(Version 1.0)

Updated over 7 months ago

What is a Move Order?

The Move Orders module in OrderGrid facilitates the transfer of inventory between different locations within your organization. It enables you to manage the movement of goods from one warehouse or storage area to another.


​Move Orders are categorized into two types:

  1. Consumption Move Orders: These orders are used to transfer items to consumption bins for immediate use.

  2. Storage Move Orders: These orders are used to move items from storage locations to picking paths or other non-storage areas.

To access the Move Order page:

☰ > Sales > Move Orders

Create Move Orders

In the OrderGrid app, you can create a move order using the app interface or create one programmatically via Open API:


Using the app interface:

Using the Open API:

  • Create Move Orders via API: This option allows you to automate the process by creating move orders via an API call from an external system.

Before creating a standard move order, navigate to Warehouse > Bins and ensure that you have an available Consumption bin to set as the Final Destination for the move order.

Creating Move Orders via Manual Entry

To create a new Move Order, follow the steps below🪜:

  1. On the Sales > Move Order page, click +New Move Order.

  2. Select Warehouse: From the drop-down menu, choose the warehouse initiating the move.

  3. Set Delivery Date/Time: Specify when the move order should be fulfilled.

  4. Allow Partials (Optional):

    • Enable or disable partial quantities for the move order.

    • "No Partials" ensures the move will proceed only if the full quantity of each item is available.

  5. Storage Move Order vs. Consumption Move Order:

    • Storage Move Order:

      • Staging and Final Destination fields are not required. The Final Destination field is disabled because the picker will assign the destination during the move process.

    • Consumption Move Order:

      • Staging Destination (Not Required): Temporary holding area for items before their final placement.

      • Final Destination (Required): The ultimate bin or location for the inventory. The format for the bin should be 00-00-00-00-00.

  6. Search Inventory Items:
    Use the "Type to search" field or input the SKU for faster results. Once the items appear, click + Add Item.

  7. Adjustable Fields Once Items Are Added:

    • Quantity (QTY): The number of units to move.

    • Price: Adjust if necessary.

    • Unit of Measure (UOM): Select the desired unit for the transfer.

    • Min Shelf Life: Input the minimum shelf life required for the item, if applicable.

  8. Create Move Order:
    Once all details are entered, click Create Move Order.

Creating Move Orders via API Call

If you're managing move orders through external platforms, OrderGrid offers an API-based solution for creating move orders directly from your third-party systems. This method streamlines the process and eliminates manual entry by directly sending move order data into the OrderGrid platform.

Test Move Order Creation via API

To test how move orders are created using the OrderGrid API on SwaggerHub, follow these steps:

  1. Access the API Documentation

  2. Locate the Move Order Section

    • Scroll to the Move Orders section in the API documentation to find the relevant endpoints for creating move orders.

  3. Authenticate Using Your API Key

    • Obtain your API key from Settings > API Keys within the OrderGrid app.

    • Use this key in the x-og-access-token field to authenticate your API requests.

  4. Initiate a POST Request to /move-order Endpoint

    • Find the POST /move-order endpoint under the Move Orders section.

    • Click Try it out to open the API request form.

  5. Input the Move Order Data

    • Structure your move order data using the example provided in the API documentation.

    • Replace the example values with your specific move order details, such as the warehouse, delivery date/time, destination, and items.

  6. Execute the Request

    • Click Execute to send the request and create the move order.

  7. Monitor the Server Response

    • Review the server's response to confirm if the move order was successfully created.

  8. Verify the Move Order

    • Navigate to Sales > Move Orders in OrderGrid to confirm that the created move order appears correctly in the system.

For further assistance, refer to the API documentation or contact support.

Sample Payload for API Import

{
  "orderId": 12113,
  "warehouseCode": "WH1",
  "allowPartials": false,
  "deliveryDateTime": "2023-05-10T18:13:09",
  "destination": {
    "stagingDestination": "01-01-11-11-11",
    "finalDestination": "05-01-01-01-12"
  },
  "items": [
    {
      "itemId": "5001601",
      "isMaterial": false,
      "minShelfLife": 4,
      "allowPartials": true,
      "UOM": "gal",
      "quantity": 1
    }
  ]
}

⚠️ Note: To add multiple line items to a move order, simply add additional objects within the items array with the same fields as the sample.

Move Order Statuses

Once created, the Move Order will have one of the following statuses:

  • Queued: The order is waiting to be picked up by staff.

  • Processing: The order is being actively picked or worked on.

  • Partially Fulfilled: The move order was processed, but the full required quantity wasn’t shipped. This occurs when "Allow Partials" was enabled, and the quantity moved was less than expected (e.g., 99 EA instead of 100 EA).

  • Shipped: The move has been completed and closed with the full requested quantity shipped (e.g., 100/100 EA).

  • Voided: If a Move Order needs to be voided, this status is triggered by an API call to void the order. Once voided, the order is no longer valid and will not be processed further.

To void a Move Order via the API, use the PUT request to the /move-order/{orderId}/void endpoint. You can test it out on our API Documentation and if you require further assistance, contact OrderGrid's Support Team.

Once the Move Order is Created

After creating the move order, depending on the delivery time, the order will be moved to the warehouse for fulfillment on the Warehouse > Move Orders page.

🎉 Congratulations! You have successfully created a Move Order within OrderGrid.

Did this answer your question?