Update an Internal Order
This job also allows updates to Internal Orders, orders created directly in DJUST’s via checkout, using the CSV import job.
✅ Prerequisites
To update an Internal Order, the following elements must already exist in DJUST:
- The Internal Order must already exist
- The Order Line must exist if you want to update or delete it
- The client must first export the Internal Order from DJUST to retrieve its references (Order Reference, Order Line Id, etc.) needed for the update
- The update is only permitted if the Order Logistic is in a status that supports modification:
For detailed rules regarding what can be updated based on the current status of the Order Logistic, refer to the Update Rules Based on Order Logistic Status section.
⚙️ How It Works
Each row in the CSV represents one Order Line.
You may:
- Identify the Order by either Order External Id or Order Reference
- Identify the Order Line by Order Line External Id or Order Line Id
- Modify editable fields (e.g., Quantity, Gross Unit Price, Order Status, Shipping Address, etc.)
- Mark the line for deletion using the Mark Order Line For Deletion column
- Update multiple Order Lines from the same or different orders in one file
📋 Fields
Required fields
Field name | Required | Editable | Default Value |
---|---|---|---|
Order External Id | ☑️ (unless | ☑️ (only if the value is not yet set for Internal Orders) | — |
Order Reference | ☑️ (unless | — | |
Order Line External Id | ☑️ (required for Order Line creation) (required for updates unless "Order Line Id" is provided) | ☑️ (only if the value is not yet set for Internal Orders) | — |
Order Line Id | ☑️ (unless | — | |
Account External Id | ✅ | — | — |
Supplier External Id | ✅ | — | — |
Net Unit Price | ☑️ (unless | — | — |
Order Line Quantity | ✅ | ✔️ | — |
Offer Price External Id | ☑️ (unless | — | — |
Variant External Id | ☑️ (unless | — | — |
Order Status | — | ✔️ |
|
Gross Unit Price | — | ✔️ | — |
Classification External Id | — | ✔️ | — |
Customer External Id | — | — | The first Customer User associated with the Account |
Tax Amount | — | ✔️ | — |
Variant Name | — | ✔️ | — |
Variant Description | — | ✔️ | — |
Shipping Address Full Name | — | ✔️ | The first Shipping Address associated with the Account |
Shipping Address Country | — | ✔️ | The first Shipping Address associated with the Account |
Shipping Address Street Name | — | ✔️ | The first Shipping Address associated with the Account |
Shipping Address City | — | ✔️ | The first Shipping Address associated with the Account |
Shipping Address Zip Code | — | ✔️ | The first Shipping Address associated with the Account |
Shipping Address State | — | ✔️ | The first Shipping Address associated with the Account |
Shipping Address (Additional) | — | ✔️ | The first Shipping Address associated with the Account |
Mark Order Line For Deletion | — | ✔️ |
|
✅ Required ☑️ Conditionally required
Required Custom FieldsAny custom fields configured as required in DJUST must also be included in the CSV.
Optional fields
Field name | Required | Editable | Default Value |
---|---|---|---|
Order Status | — | — | ORDER_DRAFT_ON_HOLD |
Gross Unit Price | — | ✔️ | — |
Classification External Id | — | ✔️ | — |
Customer External Id | — | — | The first Customer User associated with the Account |
Tax Amount | — | ✔️ | — |
Variant Name | — | ✔️ | — |
Variant Description | — | ✔️ | — |
Shipping Address Full Name | ☑️ Required if any shipping field is filled¹ | ✔️ | The first Shipping Address associated with the Account |
Shipping Address Country | ☑️ Required if any shipping field is filled¹ | ✔️ | The first Shipping Address associated with the Account |
Shipping Address Street Name | ☑️ Required if any shipping field is filled¹ | ✔️ | The first Shipping Address associated with the Account |
Shipping Address City | ☑️ Required if any shipping field is filled¹ | ✔️ | The first Shipping Address associated with the Account |
Shipping Address Zip Code | ☑️ Required if any shipping field is filled¹ | ✔️ | The first Shipping Address associated with the Account |
Shipping Address State | — | ✔️ | The first Shipping Address associated with the Account |
Shipping Address (Additional) | — | ✔️ | The first Shipping Address associated with the Account |
Mark Order Line For Deletion | — | ✔️ | False |
¹ These fields become required if at least one of them is provided. This rule does not apply to Shipping Address State or Shipping Address Additional.
📌 Key Business Rules
- If both Offer Price External Id and Variant External Id are provided:
- The variant must exist in DJUST.
- It must be linked to the provided offer.
- Each CSV row represents one order line.
- You may create multiple lines for the same order in the same file
Updated 17 days ago