> ## Documentation Index > Fetch the complete documentation index at: https://www.commercengine.io/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create a replacement shipment > Creates a replacement shipment against an existing shipment. Use the `manual` payload to dispatch outside an integrated carrier, or the `auto` payload to fulfill through an integrated carrier with system-managed packing and rates. ## OpenAPI ````yaml https://openapi.commercengine.io/ce-pos.json post /pos/shipping/shipments/{reference_number}/replacement openapi: 3.1.0 info: title: CE POS APIs description: >- The consolidated Point of Sale surface. Every operation is served under the storefront base URL; operations tagged POSAdmin are proxied to the admin service by the POS backend. version: '1.0' servers: - url: https://staging.api.commercengine.io/api/v1/{store_id}/storefront description: Staging Server variables: store_id: description: Store ID default: store_id x-speakeasy-server-id: staging - url: https://prod.api.commercengine.io/api/v1/{store_id}/storefront description: Prod Server variables: store_id: description: Store ID default: store_id x-speakeasy-server-id: prod security: - Authorization: [] tags: - name: POS description: Operations backed by the storefront service - name: POSAdmin description: Operations proxied to the admin service paths: /pos/shipping/shipments/{reference_number}/replacement: post: tags: - POSAdmin summary: Create a replacement shipment description: >- Creates a replacement shipment against an existing shipment. Use the `manual` payload to dispatch outside an integrated carrier, or the `auto` payload to fulfill through an integrated carrier with system-managed packing and rates. operationId: pos-create-replacement-shipment parameters: - name: reference_number in: path description: Reference number of the original shipment being replaced. required: true schema: type: string requestBody: required: true content: application/json: schema: oneOf: - $ref: >- #/components/schemas/CreateReplacementShipmentWithManualMethod - $ref: '#/components/schemas/CreateReplacementShipmentWithAutoMethod' - $ref: >- #/components/schemas/CreateReplacementShipmentForCollectInStore responses: '200': description: OK content: application/json: schema: type: object properties: message: type: string success: type: boolean security: - Authorization: [] components: schemas: CreateReplacementShipmentWithManualMethod: title: CreateReplacementShipmentWithManualMethod description: >- Replacement shipment payload when fulfilling through a manual courier (no carrier integration). type: object required: - warehouse_id - shipment_items - shipping_option - shipping_provider_id - packing_option - total_weight - expected_delivery_date - tracking_link - manual_shipping_charges properties: fulfillment_type: description: Set to `delivery` when the replacement is shipped to the customer. type: string const: delivery warehouse_id: description: The warehouse from which the replacement items will be shipped. type: string shipment_items: type: array items: $ref: '#/components/schemas/AdminShipmentItem' shipping_option: description: >- Set to `manual` to dispatch the shipment outside of an integrated carrier. enum: - manual shipping_provider_id: description: The manual shipping provider used to fulfill the replacement. type: string packing_option: description: The packing option for the replacement shipment. enum: - manual - auto boxes: description: The boxes for the replacement shipment. type: array items: $ref: '#/components/schemas/ShipmentBox' total_weight: description: >- Total shipment weight in kilograms, used for rate calculation by the carrier. type: number expected_delivery_date: description: The expected delivery date communicated to the customer. type: - string - 'null' format: date tracking_link: description: Optional tracking URL shared with the customer. type: - string - 'null' manual_shipping_charges: description: Shipping charges incurred for the manual dispatch. type: - number - 'null' reason: description: The reason for the replacement shipment. type: string x-tags: - Shipping CreateReplacementShipmentWithAutoMethod: title: CreateReplacementShipmentWithAutoMethod description: >- Replacement shipment payload when fulfilling through an integrated carrier. type: object required: - warehouse_id - shipment_items - shipping_option - shipping_provider_id - packing_option - total_weight - reason properties: fulfillment_type: description: Set to `delivery` when the replacement is shipped to the customer. type: string const: delivery warehouse_id: description: The warehouse from which the replacement items will be shipped. type: string shipment_items: type: array items: $ref: '#/components/schemas/AdminShipmentItem' shipping_option: description: >- Set to `auto` to dispatch the shipment through an integrated carrier. enum: - auto shipping_provider_id: description: The integrated shipping provider used to fulfill the replacement. type: string packing_option: description: >- Use `manual` to specify boxes explicitly, or `auto` to let the system pack on your behalf. enum: - auto - manual boxes: description: >- Box-wise packing breakdown. Required when `packing_option` is `manual`. type: - array - 'null' items: $ref: '#/components/schemas/ShipmentBox' total_weight: description: >- Total shipment weight in kilograms, used for rate calculation by the carrier. type: number courier_company_id: description: >- Specific courier company to use. If omitted, the system selects the most suitable courier automatically. type: - string - 'null' reason: description: The reason for the replacement shipment. type: string x-tags: - Shipping CreateReplacementShipmentForCollectInStore: title: CreateReplacementShipmentForCollectInStore description: >- Replacement shipment payload when the customer collects the items from a store instead of having them delivered. type: object required: - warehouse_id - shipment_items - shipping_option - shipping_provider_id - packing_option - reason properties: fulfillment_type: description: >- Set to `collect-in-store` when the replacement is fulfilled via in-store pickup. type: string const: collect-in-store warehouse_id: description: The warehouse holding the replacement items for in-store pickup. type: string shipment_items: type: array items: $ref: '#/components/schemas/AdminShipmentItem' shipping_option: description: >- Set to `manual` since in-store pickup is handled outside of an integrated carrier. enum: - manual shipping_provider_id: description: >- The manual shipping provider associated with the in-store pickup flow. type: string packing_option: description: The packing option for the replacement shipment. enum: - manual - auto boxes: description: The boxes for the replacement shipment. type: array items: $ref: '#/components/schemas/ShipmentBox' reason: description: The reason for the replacement shipment. type: string x-tags: - Shipping AdminShipmentItem: title: ShipmentItem description: Shipment item model type: object required: - product_id - variant_id - quantity properties: product_id: type: string product_name: type: string readOnly: true variant_id: description: '`null` for products without variants.' type: - string - 'null' variant_name: type: - string - 'null' readOnly: true product_image_url: type: - string - 'null' readOnly: true sku: type: string readOnly: true quantity: type: integer free_quantity: type: integer is_free_item: type: boolean readOnly: true selling_price: type: number format: double selling_price_excluding_tax: type: number format: double readOnly: true ShipmentBox: title: ShipmentBox type: object properties: box_name: type: string box_length: type: number box_width: type: number box_height: type: number box_weight: type: number items_count: type: - integer - 'null' box_count: type: - integer - 'null' x-tags: - Shipping securitySchemes: Authorization: type: http description: Access token scheme: bearer ````