---
updatedAt: 2026-08-03T17:41:30.000Z
---

# Update Shipment Quantities

 <div class="amber-callout" aria-label="Migration notice"><p><strong>Migrate to Global APIs:</strong> New sellers and approved Solution Providers should use Global APIs. Existing users must migrate to avoid disruption and access new capabilities coming to your market. Explore <a href ="https://developer.walmart.com/global-marketplace/docs/global-marketplace-apis" style="text-decoration: underline !important; font-weight: 700;">Global Marketplace migration resources</a>.</p></div><br>Seller can modify the shipment quantity before the Shipment arrives at the WFS FCs. Seller cannot modify the shipment quantity when Shipment Status = Receiving in Progress, Closed, and Cancelled.  Seller will need to provide new quantities for each SKU to update. Seller will only be able to add up to 6 units per SKU but can reduce to 0 units to remove any SKU from a shipment. Seller cannot change all SKUs’ quantity to 0 – they must cancel the entire Inbound Order.

[block:html]
{
  "html": "<a\n  href=\"https://god.gw.postman.com/run-collection/34477505-10224b02-e652-43c8-a5e4-de67b515b24d?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D34477505-10224b02-e652-43c8-a5e4-de67b515b24d%26entityType%3Dcollection%26workspaceId%3Da421c203-4534-46c7-ac4a-8ac70723c2fc\"\n  target=\"_blank\"\n  style=\"text-decoration: none\"\n>\n  <button>\n    <img\n      src=\"https://run.pstmn.io/button.svg\"\n      alt=\"Run In Postman\"\n      style=\"width: 128px; height: 32px\"\n    />\n  </button>\n</a>"
}
[/block]

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "version": "1.0",
    "title": "Fulfillment Management",
    "description": "With Walmart Fulfillment Services, you can focus on sales while we expertly take care of fast shipping, seamless returns, and customer service. Simply send your inventory to Walmart fulfillment centers, where we will store your products securely and prepare them swiftly for shipping when an order is placed."
  },
  "x-readme": {
    "samples-languages": [
      "shell"
    ],
    "proxy-enabled": false,
    "explorer-enabled": true
  },
  "servers": [
    {
      "url": "https://marketplace.walmartapis.com",
      "description": "Production URL"
    }
  ],
  "paths": {
    "/v3/ca/fulfillment/shipment-quantities": {
      "put": {
        "tags": [
          "Fulfillment"
        ],
        "summary": "Update Shipment Quantities",
        "description": " <div class=\"amber-callout\" aria-label=\"Migration notice\"><p><strong>Migrate to Global APIs:</strong> New sellers and approved Solution Providers should use Global APIs. Existing users must migrate to avoid disruption and access new capabilities coming to your market. Explore <a href =\"https://developer.walmart.com/global-marketplace/docs/global-marketplace-apis\" style=\"text-decoration: underline !important; font-weight: 700;\">Global Marketplace migration resources</a>.</p></div><br>Seller can modify the shipment quantity before the Shipment arrives at the WFS FCs. Seller cannot modify the shipment quantity when Shipment Status = Receiving in Progress, Closed, and Cancelled.  Seller will need to provide new quantities for each SKU to update. Seller will only be able to add up to 6 units per SKU but can reduce to 0 units to remove any SKU from a shipment. Seller cannot change all SKUs’ quantity to 0 – they must cancel the entire Inbound Order.",
        "externalDocs": {
          "description": "View Guide",
          "url": "/doc/ca/ca-mp/ca-mp-fulfillment/#17926"
        },
        "operationId": "updateShipmentQuantity",
        "parameters": [
          {
            "in": "header",
            "name": "WM_CONSUMER.CHANNEL.TYPE",
            "description": "A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "WM_QOS.CORRELATION_ID",
            "description": "A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "b3261d2d-028a-4ef7-8602-633c23200af6"
          },
          {
            "in": "header",
            "name": "WM_SVC.NAME",
            "description": "Walmart Service Name",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "Walmart Service Name"
          },
          {
            "name": "WM_SEC.TIMESTAMP",
            "in": "header",
            "description": "The Epoch timestamp",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "1443748249449"
          },
          {
            "name": "WM_SEC.AUTH_SIGNATURE",
            "in": "header",
            "description": "The vendor's digital signature, generated by running the JAR file or custom generation code",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "9fg3TPeRt0WSGbXNGGj4kSQ9L6PMBX.....9Zj5aDyg="
          },
          {
            "name": "WM_CONSUMER.ID",
            "in": "header",
            "description": "A unique ID required to access the API",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "Get the Consumer ID from Developer Center after logging in"
          },
          {
            "name": "Accept",
            "in": "header",
            "description": "Accept Header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "application/json"
          }
        ],
        "requestBody": {
          "description": "Request fields",
          "content": {
            "application/json": {
              "schema": {
                "required": [
                  "payload"
                ],
                "type": "object",
                "properties": {
                  "payload": {
                    "required": [
                      "inboundOrderId",
                      "shipmentId"
                    ],
                    "type": "object",
                    "properties": {
                      "inboundOrderId": {
                        "type": "string",
                        "description": "Unique ID identifying inbound shipment request"
                      },
                      "shipmentId": {
                        "type": "string",
                        "description": "Unique ID identifying inbound shipment"
                      },
                      "orderItems": {
                        "maxItems": 5000,
                        "minItems": 1,
                        "type": "array",
                        "description": "update shipment qty line items",
                        "xml": {
                          "wrapped": true
                        },
                        "items": {
                          "required": [
                            "sku",
                            "updatedShipmentQty"
                          ],
                          "type": "object",
                          "properties": {
                            "sku": {
                              "type": "string",
                              "description": "Seller Item ID"
                            },
                            "updatedShipmentQty": {
                              "minimum": 0,
                              "type": "integer",
                              "description": "updated quantity",
                              "format": "int32"
                            }
                          },
                          "description": "update shipment qty line items"
                        }
                      }
                    },
                    "description": "Request Payload"
                  }
                }
              },
              "example": {
                "payload": {
                  "shipmentId": "0042841GDM",
                  "inboundOrderId": "2024AKSMAR06",
                  "orderItems": [
                    {
                      "sku": "sku_fr_ca_07960540548628",
                      "updatedShipmentQty": 24
                    }
                  ]
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Operation",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "status"
                  ],
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "enum": [
                        "OK",
                        "CREATED",
                        "ACCEPTED",
                        "NO_CONTENT",
                        "PARTIAL",
                        "MOVED_PERMANENT",
                        "FOUND",
                        "SEE_OTHER",
                        "NOT_MODIFIED",
                        "TEMPORARY_REDIRECT",
                        "BAD_REQUEST",
                        "UNAUTHORIZED",
                        "FORBIDDEN",
                        "NOT_FOUND",
                        "METHOD_NOT_ALLOWED",
                        "NOT_ACCEPTABLE",
                        "REQUEST_TIMEOUT",
                        "CONFLICT",
                        "REQUEST_ENTITY_TOO_LARGE",
                        "UNSUPPORTED_MEDIA_TYPE",
                        "UNPROCESSABLE_ENTITY",
                        "TOO_MANY_REQUESTS",
                        "FAIL",
                        "BAD_GATEWAY",
                        "SERVICE_UNAVAILABLE",
                        "GATEWAY_TIMEOUT"
                      ]
                    },
                    "header": {
                      "type": "object",
                      "properties": {
                        "headerAttributes": {
                          "type": "object",
                          "additionalProperties": {
                            "type": "object"
                          }
                        }
                      },
                      "xml": {
                        "name": "ServiceHeader"
                      }
                    },
                    "errors": {
                      "type": "array",
                      "xml": {
                        "wrapped": true
                      },
                      "items": {
                        "required": [
                          "code"
                        ],
                        "type": "object",
                        "properties": {
                          "code": {
                            "type": "string"
                          },
                          "field": {
                            "type": "string"
                          },
                          "description": {
                            "type": "string"
                          },
                          "info": {
                            "type": "string"
                          },
                          "severity": {
                            "type": "string",
                            "enum": [
                              "INFO",
                              "WARN",
                              "ERROR"
                            ]
                          },
                          "category": {
                            "type": "string",
                            "enum": [
                              "APPLICATION",
                              "SYSTEM",
                              "REQUEST",
                              "DATA"
                            ]
                          },
                          "causes": {
                            "type": "array",
                            "xml": {
                              "wrapped": true
                            },
                            "items": {
                              "type": "object",
                              "properties": {
                                "code": {
                                  "type": "string"
                                },
                                "field": {
                                  "type": "string"
                                },
                                "type": {
                                  "type": "string"
                                },
                                "description": {
                                  "type": "string"
                                }
                              },
                              "xml": {
                                "name": "Cause"
                              }
                            }
                          }
                        },
                        "xml": {
                          "name": "Error"
                        }
                      }
                    },
                    "payload": {
                      "type": "object"
                    }
                  },
                  "xml": {
                    "name": "ServiceResponse"
                  }
                },
                "example": {
                  "status": "OK"
                }
              }
            }
          }
        }
      }
    }
  }
}
```