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 Order Reference is provided)

☑️ (only if the value is not yet set for Internal Orders)

Order Reference

☑️ (unless Order External Id is provided)

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 Order Line External Id is provided)

Account External Id

Supplier External Id

Net Unit Price

☑️ (unless Offer Price External Id is provided)

Order Line Quantity

✔️

Offer Price External Id

☑️ (unless Variant External Id and/or Net Unit Price are provided)

Variant External Id

☑️ (unless Offer Price External Id is provided)

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

✔️

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

✔️

False

Required ☑️ Conditionally required

⚠️

Required Custom Fields

Any custom fields configured as required in DJUST must also be included in the CSV.


Optional fields

Field nameRequiredEditableDefault Value
Order StatusORDER_DRAFT_ON_HOLD
Gross Unit Price✔️
Classification External Id✔️
Customer External IdThe 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