# Update an existing customer order. **PUT /customer-orders/{orderId}** Sample request: PUT /customer-orders/CDE0000000001 ## Servers - https://soget-api-integration.azure-api.net/customer-orders/v1: https://soget-api-integration.azure-api.net/customer-orders/v1 () ## Authentication methods - Bearer token & Api key ## Parameters ### Headers - **If-Match** (string) ETag value to determine resource version. ### Path parameters - **orderId** (string) Customer order identifier ### Body: application/json (object) Information of customer order - **containers** (array[object]) Container - **date** (string(date-time) | null) Date of the customer order. ISO 8601 Extended Format - **sender** (string | null) Name of the person who created the order. - **clientReference** (string | null) Importer/Exporter reference. - **customsFlag** (string) Type of flows:

Import: Import flow.
Export: Export flow.
Transfer: Transfer flow.

- **priceInformation** (string | null) Comment about pricing. - **instructionsInformation** (string | null) Instructions for the driver. - **contractTermsInformation** (string | null) Information about the contract terms. - **comment** (string | null) General comments about the transport order. - **voyage** (object) Voyage information. ## Responses ### 200 Successful operation. ### 400 Bad request. #### Body: application/json (object) - **timestamp** (string(date-time)) Time information. ISO 8601 Extended Format - **code** (string) Error that could be returned by the system.

ACTOR_NOT_FOUND: Actor indicated in order doesn't exist in MouvONE.
ALREADY_JOINED_GROUP: User has already joined a group
CANNOT_CANCEL_NOT_MASTER_ORDER: You can only cancel an order if type of the order is Master. It's not allowed to cancel an Elementary or Segment order.
CANNOT_CANCEL_ORDER_WITH_ASSOCIATED_CONTAINER: Order cannot be cancelled because the container has been associated with a booking.
CANNOT_CHANGE_NUMBER_OF_CONTAINERS: You can't change the number of containers when updating an order.
CANNOT_UPDATE_VALID_ORDER_TO_DRAFT: Cannot update order status from VALID to DRAFT.
CARRIER_EMAIL_REQUIRED: If carrier in the given order is unknown by GEDMOUV, then the carrier email is required.
CONFLICT: This error can happens if you try to update an order but it has been updated by another user so your version has been out-dated. You have to update your local version with the latest one before you can make any changes.
CONTRACTOR_UNAUTHORIZED_BY_GEDMOUV: A contractor unknown by GEDMOUV is not allowed to create new transport order.
CUSTOMER_ORDER_NOT_FOUND: Order doesn't exist in MouvONE.
CUSTOMS_FLAG_NOT_BE_MODIFIED: You can't modify customs flag of an order.
EVENT_LOCATION_FIELDS_REQUIRED: The fields of event location is required.
EVENT_START_DATE_REQUIRED: Start date of event is required.
EXISTS_ORDER_WITH_HANDLING_UNIT_SPI: Exists order with the given handling unit spi.
HANDLING_UNIT_REFERENCE_INVALID: Reference of handling unit is invalid.
LIMIT_NONPOSITIVE: The LIMIT parameter must be greater than 0 when searching order.
NOT_SUPPORTED_ORDER_TYPE: The type of order is not supported for requested action.
OFFSET_NEGATIVE: The OFFSET parameter cannot be negative when searching order.
ORDER_ALREADY_CANCELED: The order has already been cancelled.
ORDER_DUPLICATED: You cannot create order if an order with the same characteristics already exists.
ORGANIZATION_ACTOR_CODE_INVALID: An organization must be verified by a SOGET administrator before its members can create and manage orders. Let's contact SOGET if you encounter this error.
ORGANIZATION_NOT_FOUND: A user must belong to an organization to be able to create and manage orders.
R0005: Cannot update information of containers and events.
R0006: Cannot update order if it is in certain status.
R0007: Cannot update container references.
R0008: Cannot cancel the order due to the status is Submitted or InProgress.
R0009: Cannot cancel the order that at least one of its segment is delivered.
SEARCH_DATE_ERROR: Date parameters is invalid when searching order.
UNKNOWN_LOCATION: Location is unknown by MouvONE.
USER_ID_INVALID: User ID is invalid.
WRONG_EVENT_DATE_ORDER: Dates of events must be in chronological order. For Import order: LadingImport -> DeliveryImport -> EmptyReleaseImport -> EmptyReturnImport. For Export order: EmptyReleaseExport -> PositioningExport -> LadingExport -> DeliveryExport.
WRONG_FORMAT: Order identifier is in wrong format.

- **message** (string | null) Error message. ### 412 PreconditionFailed. #### Body: application/json (object) - **timestamp** (string(date-time)) Time information. ISO 8601 Extended Format - **code** (string) Error that could be returned by the system.

ACTOR_NOT_FOUND: Actor indicated in order doesn't exist in MouvONE.
ALREADY_JOINED_GROUP: User has already joined a group
CANNOT_CANCEL_NOT_MASTER_ORDER: You can only cancel an order if type of the order is Master. It's not allowed to cancel an Elementary or Segment order.
CANNOT_CANCEL_ORDER_WITH_ASSOCIATED_CONTAINER: Order cannot be cancelled because the container has been associated with a booking.
CANNOT_CHANGE_NUMBER_OF_CONTAINERS: You can't change the number of containers when updating an order.
CANNOT_UPDATE_VALID_ORDER_TO_DRAFT: Cannot update order status from VALID to DRAFT.
CARRIER_EMAIL_REQUIRED: If carrier in the given order is unknown by GEDMOUV, then the carrier email is required.
CONFLICT: This error can happens if you try to update an order but it has been updated by another user so your version has been out-dated. You have to update your local version with the latest one before you can make any changes.
CONTRACTOR_UNAUTHORIZED_BY_GEDMOUV: A contractor unknown by GEDMOUV is not allowed to create new transport order.
CUSTOMER_ORDER_NOT_FOUND: Order doesn't exist in MouvONE.
CUSTOMS_FLAG_NOT_BE_MODIFIED: You can't modify customs flag of an order.
EVENT_LOCATION_FIELDS_REQUIRED: The fields of event location is required.
EVENT_START_DATE_REQUIRED: Start date of event is required.
EXISTS_ORDER_WITH_HANDLING_UNIT_SPI: Exists order with the given handling unit spi.
HANDLING_UNIT_REFERENCE_INVALID: Reference of handling unit is invalid.
LIMIT_NONPOSITIVE: The LIMIT parameter must be greater than 0 when searching order.
NOT_SUPPORTED_ORDER_TYPE: The type of order is not supported for requested action.
OFFSET_NEGATIVE: The OFFSET parameter cannot be negative when searching order.
ORDER_ALREADY_CANCELED: The order has already been cancelled.
ORDER_DUPLICATED: You cannot create order if an order with the same characteristics already exists.
ORGANIZATION_ACTOR_CODE_INVALID: An organization must be verified by a SOGET administrator before its members can create and manage orders. Let's contact SOGET if you encounter this error.
ORGANIZATION_NOT_FOUND: A user must belong to an organization to be able to create and manage orders.
R0005: Cannot update information of containers and events.
R0006: Cannot update order if it is in certain status.
R0007: Cannot update container references.
R0008: Cannot cancel the order due to the status is Submitted or InProgress.
R0009: Cannot cancel the order that at least one of its segment is delivered.
SEARCH_DATE_ERROR: Date parameters is invalid when searching order.
UNKNOWN_LOCATION: Location is unknown by MouvONE.
USER_ID_INVALID: User ID is invalid.
WRONG_EVENT_DATE_ORDER: Dates of events must be in chronological order. For Import order: LadingImport -> DeliveryImport -> EmptyReleaseImport -> EmptyReturnImport. For Export order: EmptyReleaseExport -> PositioningExport -> LadingExport -> DeliveryExport.
WRONG_FORMAT: Order identifier is in wrong format.

- **message** (string | null) Error message. [Powered by Bump.sh](https://bump.sh)