For the complete documentation index, see llms.txt. This page is also available as Markdown.

Push an Order to Your OMS

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.

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.

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.

Prerequisites

Time Required: 30 seconds Difficulty: Beginner

Before you push, make sure:

Step-by-Step Instructions

1

Open the purchase order

Click Purchase Orders in the left sidebar and open the order you want to send.

2

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.

3

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 below.

4

Wait for confirmation

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

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

Review your OrderCreate an Order

Last updated