---
title: "Bulk update of order shipments"
method: POST
path: "/orders/shipments/shipped"
tags: ["orders"]
---

# Bulk update of order shipments

`POST /orders/shipments/shipped`

## Request

- Base URL: `https://api.brandlovers.com/marketplace/v1`
- URL: `https://api.brandlovers.com/marketplace/v1/orders/shipments/shipped`
- Auth: none declared

Allows bulk updates of orders shippments.

## Request body

- OrdersShipments
  - `shipments` OrderShippment[]
    - `order` string: Order unique Id
    - `items` OrderItemReference[]
      - `skuSellerId` string, required: Unique Product Id (SKU) in the seller system. This is the key that defines witch product will be updated
      - `quantity` integer, required: Quantity of items
    - `status` string: Shipment status.
    - `occurredAt` string, date-time: Date that this shippment was shiped
    - `trackingUrl` string: Courier tracking URL
    - `number` string: Courier unique trackign Id associated with this shipment
    - `sellerShipmentId` string: Unique Seller shipment Id. This must be unique across all orders and shipments
    - `cte` string: Conhecimento de Transporte Eletôniconico
    - `courier` Courier
      - `name` string, required: Courier name
      - `taxID` string: Courier taxId information. For example CNPJ
    - `invoice` Invoice
      - `cnpj` string: CNPJ responsável pelo envio dos produtos. Pode ser diferente caso a empresa possua diversos Centros de Distribuição (CDs)
      - `number` string, required: Número da Nota Fiscal
      - `serie` string, required: Número de serie da Nota Fiscal
      - `issuedAt` string, date-time: Data de emissão da Nota Fiscal
      - `accessKey` string, required: Número da chave de acesso à nota fiscal. A chave possui 44 dígitos e contém todas as informações da DANFE
      - `linkXml` string: Url para consulta da NFE
      - `linkDanfe` string: Url para consulta da DANFE

## Response `200`

Success!

## Other responses

- `400`: Bad request.
- `401`: Access denied. You're not authenticated or token expired. Check your request header the `authorization` field is required.
- `403`: Server refused to process your request. Please check the API SLA and reduce number of requests per second.

## Changes

- **2016-06-13** (v1) `b73fe7ca6d89`: 2 info
  - api operation id `postOrdersshipmentsent` removed and replaced with ``
  - added the non-success response with the status `403`
- **2016-06-13** (v1) `a5b49b54d026`: 2 info
  - api operation id `postOrdersshipmentsent` was added
  - removed the non-success response with the status `403`

[Operation history](https://skmtc.dev/brandlovers/apis/brandlovers-marketplace-api-v1/changes/orders/shipments/shipped/post.md)

---

[API](https://skmtc.dev/brandlovers/apis/brandlovers-marketplace-api-v1.md) - [All operations](https://skmtc.dev/brandlovers/apis/brandlovers-marketplace-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/brandlovers/apis/brandlovers-marketplace-api-v1/revisions/cb3af6151ae4?raw)
