> 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/upload-an-order.md).

# Upload an Order

Upload purchase orders in any file layout — Mo maps the columns to your suppliers and items, previews every order it creates, and waits for your confirmation.

{% hint style="info" %}
**Quick Answer:** Go to **Orders**, click **Create Order**, and select **Upload Orders**. Attach your file in whatever layout it comes in — Mo maps the columns to your suppliers and items, groups line items into orders, and shows you the full plan before writing anything.
{% endhint %}

**Time Required:** 2–5 minutes

### What Mo Does With Your File

You don't need to reformat your file to match Moselle's fields first. Mo reads the file as it is and:

* Matches suppliers and items against your catalog
* Groups line items into individual purchase orders (e.g., by a "PO Number" column)
* Shows you every order it's about to create — supplier, items, quantities, and costs
* Creates nothing until you confirm the plan

### Steps

1. **Navigate to Orders** → Click **Create Order** → Select **Upload Orders** → **Continue**
2. **Attach your file**
   1. Click the paperclip icon and select a CSV or Excel file
   2. Describe what's in the file (e.g., how orders are grouped) so Mo can parse it correctly
3. **Review Mo's plan**
   1. Mo presents every order it would create for your review
   2. Check that suppliers, items, quantities, and costs look right
4. **Confirm**
   1. Approve the plan and Mo creates the draft purchase orders
   2. Find them on the Orders page

### Tips for a Clean Upload

* **Use exact names.** Supplier names and SKUs should match what's on file in Moselle — ask Mo "What suppliers do I have on file?" if you're not sure.
* **Describe the grouping.** If your file has one row per line item, tell Mo which column separates orders (e.g., "grouped by the 'PO Number' column") so it creates the right number of orders.
* **Any layout works.** You don't need specific column headers or a template — Mo maps whatever columns your file has.
* **Fix mismatches before confirming.** If a SKU or supplier can't be matched, Mo flags it in the preview so you can correct your file or catalog first.

### Troubleshooting

| Issue                          | Common Cause                                                | Solution                                                                                    |
| ------------------------------ | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| A SKU isn't recognized         | The SKU in your file doesn't match any item in your catalog | Check for typos or extra spaces, or add the item to your catalog first                      |
| A supplier isn't recognized    | The supplier name doesn't match any supplier in Moselle     | Go to **Operations → Suppliers**, add the supplier, then re-upload                          |
| Orders are grouped incorrectly | Mo wasn't told how orders are separated in the file         | Describe the grouping column in **What is in this file?** (e.g., "one order per PO Number") |
| Dates look wrong               | Mixed or ambiguous date formats in the file                 | Use a consistent format (e.g., `2025-06-30`) throughout the file                            |

## Related Guides

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

{% content-ref url="/pages/WU5tXVfWs5RgoFKK72Pr" %}
[Receive a Purchase Order](/planning-and-execution/orders/receive-a-purchase-order.md)
{% endcontent-ref %}

{% content-ref url="/pages/HgnZ9cwAvJDGVDj6jEcy" %}
[Orders with Mo](/mo/key-capabilities/orders-with-mo.md)
{% endcontent-ref %}