---
title: "Imports parcels from an Excel file"
method: POST
path: "/api/v{version}/parcels/import-parcels"
tags: ["orders"]
---

# Imports parcels from an Excel file

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

Imports parcels using an Excel file. Supports two formats: 1) multipart/form-data with 'file' field (recommended, more efficient), 2) JSON body with 'excelFileBase64' (legacy). Optionally provide a dictionary of columns and their matching propertyNames.

## Path parameters

- `version` string, required

## Headers

- `X-Tenant` string, required

## Response `200`

OK

- ParcelImportResult
  - `succeededs` SucceededImportParcelResult[], nullable
    - `rowIndex` integer
    - `parcelId` string, uuid
  - `faileds` FailedImportParcelResult[], nullable
    - `rowIndex` integer
    - `reason` string, nullable

## Other responses

- `400` — Bad Request

---

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