> ## Documentation Index
> Fetch the complete documentation index at: https://enterprise-docs.bglobale.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Order Dispatch V2

> This section describes the manifest shipping requirements sent by Merchants to Global‑e via API.

<Note>
  Part of the [Dispatch Notifications via API](/dispatch-notifications-via-api) integration guide — see it for when and how to use this endpoint.
</Note>


## OpenAPI

````yaml api-reference/specs/updateorderdispatch.yaml POST /Order/UpdateOrderDispatchV2
openapi: 3.0.3
info:
  title: UpdateOrderDispatchV2
  version: 1.0.0
  description: >-
    This section describes the manifest shipping requirements sent by Merchants
    to Global‑e via API.
servers:
  - url: https://{globale_api_domain}
    variables:
      globale_api_domain:
        default: globale_api_domain
        description: Global-e API host, supplied to the merchant by Global-e.
security: []
tags:
  - name: UpdateOrderDispatchV2
    x-page-title: Update Order Dispatch V2
  - name: 'Direction: Merchant → Global-e'
  - name: 'Domain: Fulfillment'
paths:
  /Order/UpdateOrderDispatchV2:
    post:
      tags:
        - UpdateOrderDispatchV2
      summary: Update Order Dispatch V2
      description: >-
        This section describes the manifest shipping requirements sent by
        Merchants to Global‑e via API.
      operationId: updateOrderDispatchV2
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateOrderDispatchRequest'
            example:
              OrderId: GE123874638GB
              MerchantOrderId: '100018322'
              DeliveryReferenceNumber: '123756483'
              IsCompleted: false
              Parcels:
                - ParcelCode: '123454321'
                  Products:
                    - DeliveryQuantity: 1
                      CartItemId: '12365'
                      ProductCode: '121212'
                    - DeliveryQuantity: 2
                      CartItemId: '12376'
                      ProductCode: '131313'
              Exceptions:
                - CartItemId: '12366'
                  ProductCode: '121213'
                  ExceptionType: 1
                  Quantity: 1
                - CartItemId: '12367'
                  ProductCode: '121214'
                  ExceptionType: 2
                  ExpectedFulfilmentDate: '2018-01-18'
      responses:
        '200':
          description: >-
            Success or object-processing failure. Check the `Success` field to
            distinguish. A `true` value confirms receipt and first-level
            validation; processing of nested attributes is asynchronous.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseInfo'
              examples:
                success:
                  summary: Success response
                  value:
                    Success: true
                    Reason: Operation description
                objectProcessingError:
                  summary: Object processing error
                  value:
                    Success: false
                    Reason: Processing error detail
        default:
          description: General API error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorInfo'
              example:
                Code: error code
                Error: error message
                Description: error description
components:
  schemas:
    UpdateOrderDispatchRequest:
      type: object
      title: UpdateOrderDispatchRequest
      properties:
        OrderId:
          type: string
          description: >-
            Global‑e Order ID (starting with "GE"). One of `OrderId` or
            `MerchantOrderId` is required.
        MerchantOrderId:
          type: string
          description: >-
            Merchant order ID as recorded in the ecommerce platform. One of
            `OrderId` or `MerchantOrderId` is required.
        DeliveryReferenceNumber:
          type: string
          description: Additional informative dispatch reference (optional).
        IsCompleted:
          type: boolean
          description: >-
            When `true`, all items not already declared as part of a parcel will
            be cancelled and refunded. Until `true`, consolidation of parcels is
            expected if no backorders are present. If backorder exceptions are
            specified, not required — allows dispatch of existing parcels
            without delay.
        Parcels:
          type: array
          description: List of parcels being dispatched. May be an empty array.
          items:
            $ref: '#/components/schemas/Parcel'
        Exceptions:
          type: array
          nullable: true
          description: >-
            List of item exceptions (out-of-stock, backorder, or cancellation).
            May be an empty array or null.
          items:
            $ref: '#/components/schemas/DispatchException'
    ResponseInfo:
      type: object
      title: ResponseInfo
      description: >-
        Response returned for both successful and object-processing-error
        outcomes.
      properties:
        Success:
          type: boolean
          description: >-
            `true` if the request was received and first-level validation
            passed. `false` if an object-processing error occurred.
        Reason:
          type: string
          description: Optional operation description or processing error detail.
    ErrorInfo:
      type: object
      title: ErrorInfo
      description: General API error response.
      properties:
        Code:
          type: string
          description: Error code.
        Error:
          type: string
          description: Error message.
        Description:
          type: string
          description: Error description.
    Parcel:
      type: object
      title: Parcel
      required:
        - ParcelCode
        - Products
      properties:
        ParcelCode:
          type: string
          maxLength: 20
          description: >-
            Merchant unique identifier for each parcel (box). Can be freely
            generated in any range as long as it is unique.
        Products:
          type: array
          description: Products included in this parcel.
          items:
            $ref: '#/components/schemas/DispatchProduct'
        TrackingDetails:
          allOf:
            - $ref: '#/components/schemas/TrackingDetails'
          nullable: true
          description: >-
            Tracking information for WYOL — when AWB has been generated through
            other means outside Global‑e.
    DispatchException:
      type: object
      title: DispatchException
      properties:
        CartItemId:
          type: string
          description: >-
            Cart Item/Line Identifier of the excepted item. One of `CartItemId`
            or `ProductCode` is required.
        ProductCode:
          type: string
          description: >-
            Product Code/SKU of the excepted item. One of `CartItemId` or
            `ProductCode` is required.
        ExceptionType:
          type: integer
          description: >-
            Exception type code: `1` = Out-of-Stock / explicit item line
            cancellation (also implicit when `IsCompleted` is `true` and items
            were not assigned to a parcel); `2` = Backorder/Pre-order/Customized
            Item (deferred shipping).
        Quantity:
          type: integer
          description: Quantity of items affected by the exception (optional).
        ExpectedFulfilmentDate:
          type: string
          format: date
          description: >-
            Tentative target date for fulfilment of backordered items, in
            `YYYY-MM-DD` format (optional).
    DispatchProduct:
      type: object
      title: DispatchProduct
      properties:
        DeliveryQuantity:
          type: integer
          description: Quantity of this product dispatched in this parcel.
        ProductCode:
          type: string
          description: >-
            Product Code/SKU. One of `ProductCode` or `CartItemId` is required;
            should match cart information fields exchanged at checkout time.
        CartItemId:
          type: string
          description: >-
            Cart Item/Line Identifier. One of `ProductCode` or `CartItemId` is
            required; should match cart information fields exchanged at checkout
            time.
    TrackingDetails:
      type: object
      title: TrackingDetails
      properties:
        TrackingNumber:
          type: string
          description: Parcel tracking number.
        TrackingURL:
          type: string
          description: Tracking URL for the shipment.
        ShipperName:
          type: string
          description: Name of the carrier.

````