# Ship The Package Command

## <mark style="color:red;">Actors</mark>​ <a href="#actors" id="actors"></a>

* Akinon Order Management System (OMS)
* Omnitron

## <mark style="color:red;">Domain Objects​</mark> <a href="#domain-objects" id="domain-objects"></a>

* Advanced Shipment Order
* OMS Command (Shipment Order Command)

### <mark style="color:red;">Process</mark>​ <a href="#process" id="process"></a>

1. The OMS application copies orders from the Akinon Omnitron Application to itself to prepare delivery/distribution plans, generate packaging orders and transfer them to operation points.
2. The products in the order are distributed to the Packaging Orders by running the rules in the distribution scenarios designated by the brand.
3. Packaging Orders are transferred to the Akinon Instore App or the brand’s integrated software. (Packaging Orders Webhooks)
4. Packaging orders assigned to the Store/Warehouse commence in the Waiting status.
5. When the packaging is made physically ready for distribution in one or more steps, the transition to the Packed status is made by using the screens in the Akinon Instore application or when a piece of software integrated into the OMS application runs the OMS commands (see: OMS Commands API).
6. This command is run to used to move packages from the Packed to Shipped status. This command does not notify the shipping company; it only records the provided information in the system and synchronizes the order data with Omnitron. If the Notify Invoice Information (remote\_invoice\_call) setting was entered, an invoice notification request is sent to the address specified with this setting.

### <mark style="color:red;">Command Parameters and Prerequisites​</mark> <a href="#command-parameters-and-prerequisites" id="command-parameters-and-prerequisites"></a>

For each packaging order:

* Packaging Order ID (integer – dynamic for each order)
* Command Transition ID (integer prepared and reported during OMS installation)
* slug (string - unique for each state transition - Either slug or Command Transition ID is required)

If this command is run before a packaging order is moved to the Packed status, a validation error will be triggered.

***

### <mark style="color:red;">`POST`</mark> <mark style="color:red;">Ship The Package​</mark> <a href="#post-ship-the-package" id="post-ship-the-package"></a>

**Path:** `https://{customer_api_url}-oms.akinon.net/api/v1/oms/packages/{package_id}/command/`

* ***Package ID***: XXX
* ***Transition ID***: NNN (set after OMS installation)
* ***Slug***: SSS (Unique Slug Value)

**Request Body​**

```
    {
        "transition": NNN,
        "slug": SSS,
        "package": XXX
    }
```

**Successful Response​**

**Status Code:** `204 No Content`


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.akinon.com/technical-guides/oms/commands/shipment/ship-the-package-command.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.