# OR04 - Patch update orders

Update orders information field by field: unspecified fields will not be updated. To remove the value for a field, send it with the 'null' value (not allowed for the required fields).You cannot use API OR04 to update customer-related information if the customer has been anonymized via API AN01.A maximum of 100 orders can be sent at once.Call FrequencyRecommended usage: At each information update of one or multiple orders (for example: to modify the billing address)Maximum usage: Once per minute, 100 orders per callRead MoreMore context

Endpoint: PUT /api/orders

## Query parameters:

  - `shop_id` (integer)
    Use this parameter when your user has access to several shops. If not specified, the shop_id from your default shop will be used.

## Request fields (application/json):

  - `orders` (array, required)
    Orders to be updated, maximum number of orders per call: 100

  - `orders.order_id` (string, required)
    Order identifier

  - `orders.order_lines` (array)
    Order lines to be updated

  - `orders.order_lines.eco_contributions` (array)
    Eco-contributions to add or update on the order line - only available if the operator setting Activate data collection related to circular economy regulations has been enabled.

  - `orders.order_lines.eco_contributions.epr_category_code` (string, required)
    Extended Producer Responsibility category

  - `orders.order_lines.eco_contributions.producer_id` (string, required)
    Producer identifier of the eco-contribution

  - `orders.order_lines.eco_contributions.unit_amount` (number)
    Unit amount of the eco-contribution

  - `orders.order_lines.order_line_id` (string, required)
    Order line's identifier

  - `orders.references` (object)
    Order references

  - `orders.references.order_reference_for_seller` (string)
    Order reference for seller. May not be blank.

## Response 200 fields (application/json):

  - `updated_orders` (array)
    A list of updated orders and orders in error objects

  - `updated_orders.errors` (array)
    List of errors encountered when updating order

  - `updated_orders.errors.code` (string, required)
    Error code

  - `updated_orders.errors.field` (string, required)
    Name of the field on the input object. Can be composed, e.g.: address.zip_code

  - `updated_orders.errors.message` (string, required)
    Error message

  - `updated_orders.order_id` (string)
    Order identifier

  - `updated_orders.updated` (object)
    Details of the modified order

  - `updated_orders.updated.order_lines` (array)
    Details of the modified order line

  - `updated_orders.updated.order_lines.cancelations` (array)
    List of the cancelations

  - `updated_orders.updated.order_lines.cancelations.cancelation_id` (string)
    Cancelation identifier

  - `updated_orders.updated.order_lines.cancelations.eco_contributions` (array)
    List of eco-contribution amounts and corresponding producer identifiers, if applicable

  - `updated_orders.updated.order_lines.cancelations.eco_contributions.epr_category_code` (string)
    Extended Producer Responsibility category

  - `updated_orders.updated.order_lines.cancelations.eco_contributions.producer_id` (string)
    Producer identifier of the eco-contribution.Not present if the producer identifier belongs to the operator.

  - `updated_orders.updated.order_lines.cancelations.eco_contributions.producer_id_owner` (string)
    Owner of the producerId

  - `updated_orders.updated.order_lines.cancelations.eco_contributions.total_amount` (number)
    Total amount of the eco-contribution

  - `updated_orders.updated.order_lines.cancelations.eco_contributions.unit_amount` (number)
    Unit amount of the eco-contribution

  - `updated_orders.updated.order_lines.order_line_id` (string)
    Order line's identifier

  - `updated_orders.updated.order_lines.refunds` (array)
    List of the refunds

  - `updated_orders.updated.order_lines.refunds.refund_id` (string)
    Refund identifier

  - `updated_orders.updated.references` (object)
    Order references

  - `updated_orders.updated.references.order_reference_for_seller` (string)
    Order reference for seller