# Create a new inventory transfer order

Creates a new inventory transfer order for the merchant.

Endpoint: POST /inventory_transfer_orders
Version: 2.0.0
Security: BearerAuth

## Request fields (application/json):

  - `destination_id` (integer, required)
    The ID of the destination warehouse

  - `items` (array, required)
    List of items for the inventory transfer order

  - `items.inventory_batch_id` (any)
    The ID of the inventory batch

  - `items.quantity` (integer, required)
    The quantity of this item to transfer

  - `items.sku_code` (string)
    The merchant's SKU identifier - required if sku_id is not provided

  - `items.sku_id` (integer)
    Hive's SKU identifier - required if sku_code is not provided

  - `order_notes` (string)
    Notes for the inventory transfer order

  - `origin_id` (integer, required)
    The ID of the origin warehouse

## Response 201 fields (application/json):

  - `completed_at` (string,null)
    When the inventory transfer order was completed

  - `created_at` (string, required)
    When the inventory transfer order was created

  - `destination_id` (integer, required)
    The ID of the destination warehouse

  - `documents` (array, required)
    List of documents associated with the inventory transfer order

  - `documents.id` (integer, required)
    Document ID

  - `documents.name` (string,null, required)
    Document name

  - `documents.url` (string, required)
    Document URL

  - `id` (integer, required)
    Hive's unique identifier for this inventory transfer order

  - `items` (array, required)
    List of items in the inventory transfer order

  - `items.id` (integer, required)
    Hive's unique identifier for this item

  - `items.inventory_batch` (object,null)

  - `items.inventory_batch.expiry_date` (string,null)
    Expiration date of the batch

  - `items.inventory_batch.id` (integer, required)
    Batch ID

  - `items.inventory_batch.name` (string, required)
    Batch name

  - `items.quantity` (integer, required)
    The quantity of this item to transfer

  - `items.sku_code` (string, required)
    The merchant's SKU identifier - required if sku_id is not provided

  - `items.sku_id` (integer, required)
    Hive's SKU identifier - required if sku_code is not provided

  - `order` (object,null, required)

  - `order.id` (integer,null)
    Order ID

  - `order.status` (string,null)
    Order status

  - `order_notes` (string,null)
    Notes for the inventory transfer order

  - `origin_id` (integer, required)
    The ID of the origin warehouse

  - `restocking_shipments` (array, required)
    List of restocking shipments associated with the inventory transfer order

  - `restocking_shipments.estimated_arrival_date` (string,null)
    Estimated arrival date

  - `restocking_shipments.id` (integer, required)
    Restocking shipment ID

  - `restocking_shipments.items` (array, required)
    Items in the restocking shipment

  - `restocking_shipments.items.announced_quantity` (integer)
    Quantity of this item in the shipment

  - `restocking_shipments.items.arrived_quantity` (integer, required)
    Arrived quantity of this item (after shipment is received)

  - `restocking_shipments.items.damaged_quantity` (integer, required)
    Damaged quantity of this item (after shipment is received)

  - `restocking_shipments.items.id` (integer)
    Hive's unique identifier

  - `restocking_shipments.items.missing_quantity` (integer, required)
    Missing quantity of this item (after shipment is received)

  - `restocking_shipments.items.remarks` (string,null)
    Free text for remarks

  - `restocking_shipments.items.sku_id` (integer, required)
    Hive SKU identifier - required if sku_code is not provided

  - `restocking_shipments.items.total_cost_in_cents` (integer,null)
    Cost in cents

  - `restocking_shipments.status` (string, required)
    Restocking shipment status

  - `restocking_shipments.tracking_code` (string,null)
    Tracking code

  - `restocking_shipments.tracking_url` (string,null)
    Tracking URL

  - `shipments` (array, required)
    List of shipments associated with the inventory transfer order

  - `shipments.id` (integer, required)
    Shipment ID

  - `shipments.issues` (array, required)
    Issues with the shipment

  - `shipments.items` (array, required)
    Items in the shipment

  - `shipments.items.id` (integer, required)
    Shipment item ID

  - `shipments.items.quantity` (integer, required)
    Quantity in the shipment

  - `shipments.items.sku_code` (string, required)
    The merchant's SKU code

  - `shipments.items.sku_id` (integer, required)
    The SKU ID

  - `shipments.restocking_shipment` (object)

  - `shipments.status` (string, required)
    Shipment status

  - `status` (string, required)
    Status of the inventory transfer order. Possible values:
- pending: Initial status when the transfer order is created
- created: The transfer order has been created and is ready for processing
- processing: The transfer order is currently being processed
- completed: The transfer order has been successfully completed
- cancelled: The transfer order has been cancelled
    Enum: "pending", "created", "processing", "completed", "cancelled"

  - `updated_at` (string, required)
    When the inventory transfer order was last updated

## Response 400 fields (application/json):

  - `errors` (any, required)
    Error information. Can be:
- Object with field names as keys and error arrays as values (for validation errors)
- Array of error objects with message, code, and optional metadata
- Array of strings (for simple error messages)

  - `success` (boolean)
    Indicates if the request was successful

  - `title` (string)
    A brief, human-readable message about the error

  - `status` (integer)
    HTTP status code

## Response 401 fields (application/json):

  - `errors` (any, required)
    Error information. Can be:
- Object with field names as keys and error arrays as values (for validation errors)
- Array of error objects with message, code, and optional metadata
- Array of strings (for simple error messages)

  - `success` (boolean)
    Indicates if the request was successful

  - `title` (string)
    A brief, human-readable message about the error

  - `status` (integer)
    HTTP status code

## Response 403 fields (application/json):

  - `errors` (any, required)
    Error information. Can be:
- Object with field names as keys and error arrays as values (for validation errors)
- Array of error objects with message, code, and optional metadata
- Array of strings (for simple error messages)

  - `success` (boolean)
    Indicates if the request was successful

  - `title` (string)
    A brief, human-readable message about the error

  - `status` (integer)
    HTTP status code

## Response 422 fields (application/json):

  - `errors` (any, required)
    Error information. Can be:
- Object with field names as keys and error arrays as values (for validation errors)
- Array of error objects with message, code, and optional metadata
- Array of strings (for simple error messages)

  - `success` (boolean)
    Indicates if the request was successful

  - `title` (string)
    A brief, human-readable message about the error

  - `status` (integer)
    HTTP status code

## Response 429 fields (application/json):

  - `errors` (any, required)
    Error information. Can be:
- Object with field names as keys and error arrays as values (for validation errors)
- Array of error objects with message, code, and optional metadata
- Array of strings (for simple error messages)

  - `success` (boolean)
    Indicates if the request was successful

  - `title` (string)
    A brief, human-readable message about the error

  - `status` (integer)
    HTTP status code