> For the complete documentation index, see [llms.txt](https://learn.moselle.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.moselle.io/planning-and-execution/orders/push-an-order-to-your-oms.md).

# Push an Order to Your OMS

Send a purchase order you built in Moselle straight to your OMS or ERP with Push to OMS — what has to be set first, and how to fix a push that is refused.

{% hint style="info" %}
**Quick Answer:** Open the purchase order, click the **gear (Page actions)** menu in the top right, and choose **Push to \[your system]** — for example **Push to ApparelMagic**. The order is sent as a new purchase order in that system, and the menu then shows the number it was given. Takes about 30 seconds.
{% endhint %}

## What Is Push to OMS?

**Push to OMS is** a one-click hand-off that sends a purchase order authored in Moselle to the system of record your warehouse and finance teams work in — so nobody retypes an order that already exists.

You plan and build the order in Moselle, where the demand and coverage numbers live. Your OMS or ERP still receives the goods and pays the invoice. Pushing keeps both sides holding the same order instead of two versions of it.

{% hint style="info" %}
**You'll only see this option if your system of record is connected and set up for outbound purchase orders.** Reading data from a system isn't the same as being able to write an order back into it, so Moselle hides the action rather than offering one that would fail. Contact Moselle Support if you'd like it enabled.
{% endhint %}

## Prerequisites

**Time Required:** 30 seconds\
**Difficulty:** Beginner

Before you push, make sure:

* [ ] Your system of record is connected **and** configured for outbound purchase orders
* [ ] The purchase order's **supplier** is linked to the matching vendor in that system
* [ ] A **receiving location** is set on the purchase order
* [ ] The order has at least one line, every line has an item, and quantities are whole numbers
* [ ] The order is a **draft** or **placed** order, and isn't archived

## Step-by-Step Instructions

{% stepper %}
{% step %}

### Open the purchase order

Click **Purchase Orders** in the left sidebar and open the order you want to send.
{% endstep %}

{% step %}

### Open the Page actions menu

Click the **gear** icon in the page header, to the right of the status controls.

**Expected Result:** The menu lists one **Push to …** item per connected system, above **Archive**. If you see no push option at all, your account has no system configured for outbound orders.
{% endstep %}

{% step %}

### Choose your system

Click **Push to \[your system]**.

If anything is missing, Moselle refuses immediately and tells you exactly what to fix — nothing is sent. See [What a refusal means](#what-a-refusal-means) below.
{% endstep %}

{% step %}

### Wait for confirmation

On success you'll see: **"Sending to \[your system]. This can take a moment."**

{% hint style="success" %}
Once the order lands, the menu item changes to **In \[your system] (\[order number])** and is greyed out — the number is your confirmation, and it stops the same order being sent twice.
{% endhint %}
{% endstep %}
{% endstepper %}

## What Happens After You Push

| Stage                | What you'll see                                                                                               |
| -------------------- | ------------------------------------------------------------------------------------------------------------- |
| Immediately          | A "sending" message. Checks that can be made instantly have already passed                                    |
| Within a few minutes | The order exists in your system of record with its own number                                                 |
| Next sync            | The order syncs back to Moselle and matches the purchase order you pushed, instead of arriving as a duplicate |

Pushing sends the order **once**. Edits you make in Moselle afterwards aren't pushed again, so review the order before you send it — or make later changes in your system of record.

## What a Refusal Means

Moselle checks everything it can before sending anything, so a refusal is a to-do list rather than a failure. Nothing is sent when a check fails, and each message names your system of record and the fix:

| Message                                                                | What to do                                                                            |
| ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| *Choose a receiving location before pushing.*                          | Set the delivery warehouse on the purchase order                                      |
| *\[Supplier] isn't linked to a vendor.*                                | Link the Moselle supplier to the matching vendor record in your system                |
| *Add a supplier before pushing.*                                       | The order has no supplier — add one                                                   |
| *Add at least one line before pushing.*                                | The order is empty — add line items                                                   |
| *\[N] lines have no item: …*                                           | Those lines are free text. Link each one to a catalog item                            |
| *Whole-number quantities are needed. Fix: …*                           | Round the listed lines to whole units                                                 |
| *Only draft and active purchase orders can be pushed.*                 | Received, cancelled, or otherwise closed orders can't be sent                         |
| *Archived purchase orders can't be pushed.*                            | Unarchive the order first                                                             |
| *This purchase order came from \[your system], so it's already there.* | The order was imported rather than authored in Moselle — there's nothing to send back |

## Frequently Asked Questions

### Why don't I see a Push option on my purchase orders?

**Answer:** The option appears only when your account has both a connected integration and an outbound purchase order configuration. If your team uses an OMS or ERP that should receive Moselle orders, contact Moselle Support.

### Can I push the same order twice?

**Answer:** No. Once an order exists in your system of record, the menu item is disabled and shows the number it was given, so a second copy can't be created by accident.

### Will my edits in Moselle keep syncing after the push?

**Answer:** No. The push is a one-time hand-off of the order. Make changes before pushing, or make them in your system of record afterwards.

### Can I push an order that came from my OMS in the first place?

**Answer:** No — it's already there. Orders imported by an integration are refused with that explanation.

## Troubleshooting Common Issues

| Problem                                                    | Solution                                                                                                          | Time to Fix |
| ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ----------- |
| The push is refused with a message about the supplier      | Open the supplier and confirm it's matched to the vendor record in your system of record                          | 5 minutes   |
| The push is refused over quantities                        | Fractional quantities aren't accepted — round the named lines to whole units                                      | 2 minutes   |
| "Couldn't reach the server. Try again."                    | A connection problem, not a rejection. Try the push again                                                         | 1 minute    |
| The order was sent but I can't see it in Moselle as pushed | Reload the purchase order page — the menu item shows **In \[your system] (\[number])** once the number comes back | 1 minute    |
| The order appears twice in Moselle after a sync            | Contact Moselle Support with both order numbers so the duplicate can be reconciled                                | —           |

## Related Guides

{% content-ref url="/pages/UJBeJZb1fZD3mCfSbojq" %}
[Review your Order](/planning-and-execution/orders/review-your-order.md)
{% endcontent-ref %}

{% content-ref url="/pages/RjoikPkwhOLfvtx8j6VZ" %}
[Create an Order](/planning-and-execution/orders/create-an-order.md)
{% endcontent-ref %}