---
title: "Creates a parcel"
method: POST
path: "/api/v{version}/parcels"
tags: ["orders"]
---

# Creates a parcel

`POST /api/v{version}/parcels`

Creates a parcel with products. The `StockType` parameter indicates the type of stock and accepts 'local' or 'warehouse'. Defaults to 'local' if not specified. the 'DeliveryType' parameter indicates the type of delivery and accepts 'home' or 'pickup-point'. Permissions requises : SupplierAdminRole, SupplierParcelsManagerRole.

## Path parameters

- `version` string, required

## Headers

- `X-Tenant` string, required

## Request body

- CreateParcelRequest
  - `customer` ParcelCustomerDto
    - `customerId` string, uuid
    - `name` string, nullable
    - `phone` PhoneDto
      - `number1` string, nullable
      - `number2` string, nullable
      - `number3` string, nullable
  - `deliveryAddress` DeliveryAddressInputDto
    - `cityTerritoryId` string, uuid
    - `districtTerritoryId` string, uuid
    - `street` string, nullable
  - `hubId` string, uuid, nullable
  - `orderedProducts` OrderedProductDto[], nullable
    - `productId` string, uuid
    - `productName` string, nullable
    - `productSku` string, nullable
    - `unitPrice` number, double
    - `quantity` integer
    - `length` number, double
    - `width` number, double
    - `height` number, double
    - `weight` number, double, nullable
    - `stockType` string, nullable
  - `deliveryType` string, nullable
  - `description` string, nullable
  - `stateId` string, uuid, nullable
  - `amount` number, double
  - `weight` ParcelWeightDto
    - `weight` number, double
    - `dimensionalWeight` number, double, nullable
  - `externalId` string, nullable
  - `hubStockId` string, uuid, nullable

## Response `201`

Created

- CreateParcelResponse
  - `id` string, uuid

---

[API](https://skmtc.net/zrexpress/apis/zrexpress-api.md) · [All operations](https://skmtc.net/zrexpress/apis/zrexpress-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zrexpress/zrexpress-api/versions/99b075e0b641/schema)