---
title: "generateShipmentContentUpdatePreviews"
method: POST
path: "/inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}/contentUpdatePreviews"
tags: ["Fulfillment Inbound v2024-03-20"]
---

# generateShipmentContentUpdatePreviews

`POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}/contentUpdatePreviews`

Generate a shipment content update preview given a set of intended boxes and/or items for a shipment with a confirmed carrier. The shipment content update preview will be viewable with the updated costs and contents prior to confirmation.

## Path parameters

- `inboundPlanId` string, required
- `shipmentId` string, required

## Request body

- GenerateShipmentContentUpdatePreviewsRequest — The `GenerateShipmentContentUpdatePreviews` request.
  - `boxes` BoxUpdateInput[], required — A list of boxes that will be present in the shipment after the update.
    - `contentInformationSource` 'BOX_CONTENT_PROVIDED' | 'MANUAL_PROCESS' | 'BARCODE_2D', required — Indication of how box content is meant to be provided.
    - `dimensions` Dimensions, required — Physical dimensional measurements of a container.
      - `length` string, required — A decimal number with no loss of precision. Useful when precision loss is unacceptable, as with currencies. Follows RFC7159 for number representation. <br>**Pattern** : `^-?(0|([1-9]\d*))(\.\d+)?([eE][+-]?\d+)?$`.
      - `width` string, required — A decimal number with no loss of precision. Useful when precision loss is unacceptable, as with currencies. Follows RFC7159 for number representation. <br>**Pattern** : `^-?(0|([1-9]\d*))(\.\d+)?([eE][+-]?\d+)?$`.
      - `height` string, required — A decimal number with no loss of precision. Useful when precision loss is unacceptable, as with currencies. Follows RFC7159 for number representation. <br>**Pattern** : `^-?(0|([1-9]\d*))(\.\d+)?([eE][+-]?\d+)?$`.
      - `unitOfMeasure` 'In' | 'Ft' | 'Meter' | 'Yard', required — The unit of measure for dimensions.
    - `items` ItemInput[] — The items and their quantity in the box. This must be empty if the box `contentInformationSource` is `BARCODE_2D` or `MANUAL_PROCESS`.
      - `expiration` string — The expiration date of the MSKU. In [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) datetime format with pattern `YYYY-MM-DD`. Items with the same MSKU but different expiration dates cannot go into the same box.
      - `labelOwner` 'AMAZON' | 'SELLER' | 'NONE', required — Specifies who will label the items. Options include `AMAZON`, `SELLER` or `NONE`.
      - `manufacturingLotCode` string — The manufacturing lot code.
      - `msku` string, required — The merchant SKU, a merchant-supplied identifier of a specific SKU.
      - `prepOwner` 'AMAZON' | 'SELLER' | 'NONE', required — The owner of the preparations, if special preparations are required.
      - `quantity` integer, required — The number of units of the specified MSKU that will be shipped.
    - `packageId` string — Primary key to uniquely identify a Box Package. PackageId must be provided if the intent is to update an existing box. Adding a new box will not require providing this value. Any existing PackageIds not provided will be treated as to-be-removed
    - `quantity` integer, required — The number of containers where all other properties like weight or dimensions are identical.
    - `weight` Weight, required — The weight of the shipment.
      - `unitOfMeasure` 'G' | 'Kg' | 'Oz' | 'Lb', required — The unit of measurement.
      - `value` string, required — A decimal number with no loss of precision. Useful when precision loss is unacceptable, as with currencies. Follows RFC7159 for number representation. <br>**Pattern** : `^-?(0|([1-9]\d*))(\.\d+)?([eE][+-]?\d+)?$`.
  - `items` ItemInput[], required — A list of all items that will be present in the shipment after the update.
    - `expiration` string — The expiration date of the MSKU. In [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) datetime format with pattern `YYYY-MM-DD`. Items with the same MSKU but different expiration dates cannot go into the same box.
    - `labelOwner` 'AMAZON' | 'SELLER' | 'NONE', required — Specifies who will label the items. Options include `AMAZON`, `SELLER` or `NONE`.
    - `manufacturingLotCode` string — The manufacturing lot code.
    - `msku` string, required — The merchant SKU, a merchant-supplied identifier of a specific SKU.
    - `prepOwner` 'AMAZON' | 'SELLER' | 'NONE', required — The owner of the preparations, if special preparations are required.
    - `quantity` integer, required — The number of units of the specified MSKU that will be shipped.

## Response `202`

GenerateShipmentContentUpdatePreviews 202 response

- GenerateShipmentContentUpdatePreviewsResponse — The `GenerateShipmentContentUpdatePreviews` response.
  - `operationId` string, required — UUID for the given operation.

## Other responses

- `400` — Request has missing or invalid parameters and cannot be parsed.
- `403` — Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
- `404` — The resource specified does not exist.
- `413` — The request size exceeded the maximum accepted size.
- `415` — The request payload is in an unsupported format.
- `429` — The frequency of requests was greater than allowed.
- `500` — An unexpected condition occurred that prevented the server from fulfilling the request.
- `503` — Temporary overloading or maintenance of the server.

---

[API](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01.md) · [All operations](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws-samples/a-content-management-v2020-11-01/revisions/815a5b6dbaa6/schema)