---
title: "submitShippingLabelRequest"
method: POST
path: "/vendor/directFulfillment/shipping/2021-12-28/shippingLabels"
tags: ["Vendor Direct Fulfillment Shipping v2021-12-28"]
---

# submitShippingLabelRequest

`POST /vendor/directFulfillment/shipping/2021-12-28/shippingLabels`

Creates a shipping label for a purchase order and returns a `transactionId` for reference.

**Usage Plan:**

| Rate (requests per second) | Burst |
| ---- | ---- |
| 10 | 10 |

The `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values then those shown here. For more information, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits).

## Request body

- SubmitShippingLabelsRequest — The request schema for the `submitShippingLabelRequest` operation.
  - `shippingLabelRequests` ShippingLabelRequest[] — An array of shipping label requests to be processed.
    - `purchaseOrderNumber` string, required — The purchase order number of the order for which to create a shipping label.
    - `sellingParty` PartyIdentification, required — Name/Address and tax details of the party.
      - `address` Address — Address of the party.
        - `name` string, required — The name of the person, business or institution at that address.
        - `addressLine1` string, required — First line of the address.
        - `addressLine2` string — Additional street address information, if required.
        - `addressLine3` string — Additional street address information, if required.
        - `city` string — The city where the person, business or institution is located.
        - `county` string — The county where person, business or institution is located.
        - `district` string — The district where person, business or institution is located.
        - `stateOrRegion` string — The state or region where person, business or institution is located.
        - `postalCode` string — The postal code of that address. It contains a series of letters or digits or both, sometimes including spaces or punctuation.
        - `countryCode` string, required — The two digit country code in ISO 3166-1 alpha-2 format.
        - `phone` string — The phone number of the person, business or institution located at that address.
      - `partyId` string, required — Assigned identification for the party.
      - `taxRegistrationDetails` TaxRegistrationDetails[] — Tax registration details of the entity.
        - `taxRegistrationType` 'VAT' | 'GST', required — Tax registration type for the entity.
        - `taxRegistrationNumber` string, required — Tax registration number for the entity. For example, VAT ID.
    - `shipFromParty` PartyIdentification, required — Name/Address and tax details of the party.
      - `address` Address — Address of the party.
        - `name` string, required — The name of the person, business or institution at that address.
        - `addressLine1` string, required — First line of the address.
        - `addressLine2` string — Additional street address information, if required.
        - `addressLine3` string — Additional street address information, if required.
        - `city` string — The city where the person, business or institution is located.
        - `county` string — The county where person, business or institution is located.
        - `district` string — The district where person, business or institution is located.
        - `stateOrRegion` string — The state or region where person, business or institution is located.
        - `postalCode` string — The postal code of that address. It contains a series of letters or digits or both, sometimes including spaces or punctuation.
        - `countryCode` string, required — The two digit country code in ISO 3166-1 alpha-2 format.
        - `phone` string — The phone number of the person, business or institution located at that address.
      - `partyId` string, required — Assigned identification for the party.
      - `taxRegistrationDetails` TaxRegistrationDetails[] — Tax registration details of the entity.
        - `taxRegistrationType` 'VAT' | 'GST', required — Tax registration type for the entity.
        - `taxRegistrationNumber` string, required — Tax registration number for the entity. For example, VAT ID.
    - `containers` Container[] — A list of the packages in this shipment.
      - `containerType` 'Carton' | 'Pallet', required — The type of container.
      - `containerIdentifier` string, required — The container identifier.
      - `trackingNumber` string — The tracking number.
      - `manifestId` string — The manifest identifier.
      - `manifestDate` string — The date of the manifest.
      - `shipMethod` string — The shipment method. This property is required when calling the `submitShipmentConfirmations` operation, and optional otherwise.
      - `scacCode` string — SCAC code required for NA VOC vendors only.
      - `carrier` string — Carrier required for EU VOC vendors only.
      - `containerSequenceNumber` integer — An integer that must be submitted for multi-box shipments only, where one item may come in separate packages.
      - `dimensions` Dimensions — 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.
      - `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+)?$`.
      - `packedItems` PackedItem[], required — A list of packed items.
        - `itemSequenceNumber` integer, required — The sequence number of the item. The number must be the same as the order number of the item.
        - `buyerProductIdentifier` string — The buyer's Amazon Standard Identification Number (ASIN) of an item. Either `buyerProductIdentifier` or `vendorProductIdentifier` is required.
        - `pieceNumber` integer — The piece number of the item in this container. This is required when the item is split across different containers.
        - `vendorProductIdentifier` string — An item's product identifier, which the vendor selects. This identifier should be the same as the identifier, such as a SKU, in the purchase order.
        - `packedQuantity` ItemQuantity, required — Details of item quantity.
          - `amount` integer, required — Amount of units shipped for a specific item at a shipment level. If the item is present only in certain cartons or pallets within the shipment, please provide this at the appropriate carton or pallet level.
          - `unitOfMeasure` 'Cases' | 'Eaches', required — Unit of measure for the shipped quantity.
          - `unitSize` integer — The case size, in the event that we ordered using cases. Otherwise, 1.
          - `totalWeight` TotalWeight — The total weight of units that are sold by weight in a shipment.
            - `unitOfMeasure` 'POUNDS' | 'OUNCES' | 'GRAMS' | 'KILOGRAMS', required — The unit of measure for the weight of items that are ordered by cases and support pricing by weight.
            - `amount` 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+)?$`.

## Response `202`

Success.

- TransactionReference — The response payload for the SubmitShipmentConfirmations operation.
  - `transactionId` string — GUID assigned by Buyer to identify this transaction. This value can be used with the Transaction Status API to return the status of this transaction.

## 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)