# Order changes and line statuses

This is an usage note explaining how to deal with order changes and the respective line statuses. 

1. ### New Order

A new order message contains the initial order from the buyer. The buyer expects that the seller will send an OrderResponse message to confirm the order. 

Order: OrderType = ‘New’ 

Order line: LineStatusCode 

| Buyer: **Order**    | Seller: **OrderResponse** | **Remark**                                                                                                                                                                                                                                        |
| ------------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| (empty) or left out | accepted                  | <p>Agreement <br><strong>Note:</strong> The seller might have changed the order line (delivery date or delivery lines, quantity or price) in the OrderResponse and does not expect a confirmation from the buyer </p>                             |
|                     | rejected                  | No agreement                                                                                                                                                                                                                                      |
|                     | revised                   | <p>No agreement <br>The seller sends a revised order line (delivery date or delivery lines, quantity or price) in the OrderResponse and expects a confirmation from the buyer. In fact, it becomes the Change by Seller scenario (see below) </p> |

&#x20;

**Note:** partial order confirmations are allowed. The seller might not be able to confirm the entire order yet and send an OrderResponse message that contains only the order lines that are confirmed. At a later moment, the seller sends another OrderResponse message as confirmation for the remaining order lines. Subsequent OrderResponse messages can contain the remaining order lines or all of the order lines (with the same LineStatusCode as before). It is recommended that the seller sends as many possible confirmed order lines in the OrderResponse message.&#x20;

&#x20;

### 2. Change by Buyer&#x20;

The buyer wants to make changes to an existing, confirmed order. The buyer expects that the seller will send a response to the requested changes.&#x20;

Change is when a confirmation for the order was received.&#x20;

Order: OrderType = ‘Changed’&#x20;

An Order message must always contain all order lines. LineStatusCode = (empty) / left out for the unchanged order lines.&#x20;

&#x20;

1. #### Change an order line

Buyer wants to change a line (or a sub line) in an existing, confirmed order. Possible changes: delivery date (scheme), price or quantity&#x20;

Order line: LineStatusCode&#x20;

| Buyer: **Order** | Seller: **OrderResponse** | **Remark**                                                                                                                                                                                                                                   |
| ---------------- | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| revised          | accepted                  | <p>New agreement for the order line <br><strong>Note:</strong> The seller might have changed the order line (delivery date or delivery lines, quantity or price) in the OrderResponse and does not expect a confirmation from the buyer </p> |
|                  | rejected                  | No new agreement, old agreement is still in place                                                                                                                                                                                            |
|                  | revised                   | <p>No new agreement, old agreement is still in place <br>The seller sends a revised order line (delivery date or delivery lines, quantity or price) in the OrderResponse and expects a confirmation from the buyer </p>                      |

&#x20;

2. #### Add an order line

Buyer wants to add a line (or a sub line) to an existing, confirmed order.&#x20;

Order line: LineStatusCode&#x20;

| Buyer: **Order** | Seller: **OrderResponse** | **Remark**                                                                                                                                                                                                                               |
| ---------------- | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| added            | accepted                  | <p>Agreement for the added line <br><strong>Note:</strong> The seller might have changed the order line (delivery date or delivery lines, quantity or price) in the OrderResponse and does not expect a confirmation from the buyer </p> |
|                  | rejected                  | No agreement for adding the requested order line, old agreement is still in place                                                                                                                                                        |
|                  | revised                   | <p>No agreement (yet) for the added order line <br>The seller sends a revised order line (delivery date or delivery lines, quantity or price) in the OrderResponse and expects a confirmation (Order message) from the buyer </p>        |

&#x20;

3. #### Cancel an order line

Buyer wants to cancel a line (or a sub line) from a confirmed order&#x20;

&#x20;

Order line: LineStatusCode&#x20;

| Buyer: **Order** | Seller: **OrderResponse** | **Remark**                                 |
| ---------------- | ------------------------- | ------------------------------------------ |
| cancelled        | accepted                  | Agreement for cancelling the order line    |
|                  | rejected                  | No agreement for cancelling the order line |

&#x20;

&#x20;

3. ### Change by Seller

The seller wants to make changes to an existing, confirmed order. For example, the seller cannot make the confirmed delivery date and sends an updated delivery date for the order line.&#x20;

As a response, the buyer can send a confirmation to the changes from the seller. This response is an Order message and it’s optional to send this response. This response Order message must contain all order lines.&#x20;

&#x20;

1. #### Change an order line

Seller wants to change a line (or a sub line) in an existing, confirmed order. Possible changes: delivery date (scheme), price or quantity&#x20;

Order line: LineStatusCode&#x20;

| Seller: **OrderResponse** | Buyer: **Order** (optional) | **Remark**                       |
| ------------------------- | --------------------------- | -------------------------------- |
| revised                   | accepted                    | New agreement for the order line |
|                           | disputed                    | Disputed                         |

&#x20;

2. #### Add an order line

Seller wants to add a line (or a sub line) to an existing, confirmed order.&#x20;

Order line: LineStatusCode&#x20;

| Seller: **OrderResponse** | Buyer: **Order** (optional) | **Remark**                   |
| ------------------------- | --------------------------- | ---------------------------- |
| added                     | accepted                    | Agreement for the added line |
|                           | disputed                    | Disputed                     |

&#x20;

3. #### Cancel an order line

Seller wants to cancel a line (or a sub line) from a confirmed order&#x20;

&#x20;

Order line: LineStatusCode&#x20;

| Seller: **OrderResponse** | Buyer: **Order** (optional) | **Remark**                              |
| ------------------------- | --------------------------- | --------------------------------------- |
| cancelled                 | accepted                    | Agreement for cancelling the order line |
|                           | disputed                    | Disputed                                |

&#x20;

&#x20;