---
title: "Create transport order."
method: POST
path: "/order/create_transport"
tags: ["Orders|Order"]
---

# Create transport order.

`POST /order/create_transport`

This endpoint allows you to create a transport order. In addition to an order object you need to provide a
`pickupLocation` and a `deliveryLocation`. The locations can be an existing project, referred by an id, or a
`customProject` provided in this request.

In the geoCapture system, transport orders are specific types of orders focused on the movement of maschines from
one location to another. Unlike regular orders which might encompass a wide range of tasks like installations,
maintenance, or inspections, transport orders are specifically tailored for logistics services.

For example, a transport order in geoCapture could involve delivering an excavator from the depot to the
construction site.

## Request body

- StandardOrderCreateTransportRequest
  - `order` OrderCreateTransportRequestOrderItem
    - `id` integer — The internal id of the order
    - `reference` string — The internal reference for the order (max. 64 characters)
    - `orderType` string — The order type. This parameter is optional. The allowed value and default is 'ORDER'
    - `externalReference` string — The customer order number (max. 64 characters)
    - `status` string — The order state | Value | | ------------------------ | | ARRIVAL | | ASSIGNED | | CREATED | | DEPARTURE | | FINISHED | | NEAREST_POSITION | | OPENED_BY_USER | | READ | | REJECTED | | SIGNED | | STARTED |
    - `subject` string — Order subject (max. 255 characters)
    - `text` string — Order description
    - `orderDate` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx
    - `duration` integer — The order duration
    - `priority` string — order priority | Value | | ------------------------ | | LOW | | NORMAL | | HIGH |
    - `targetDate` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx
    - `externalAddressId` string — The external customer id.
    - `name` string — The name1 address addition. (max. 255 characters)
    - `name2` string — The name2 address addition. (max. 255 characters)
    - `name3` string — The name3 address addition. (max. 255 characters)
    - `street` string — The street (max. 255 characters)
    - `zipCode` string — The zip code
    - `city` string — The city
    - `countryCode` string — The country code
    - `latLng` number[] — Represents a geo coordinate. An array of two double values, representing the latitude and longitude.
    - `contactPersonName` string — The contact person name (max. 255 characters)
    - `contactPersonEmail` string — The contact person email (max. 255 characters)
    - `contactPersonPhoneNumber` string — The contact person phone number (max. 64 characters)
    - `contactPersonMobileNumber` string — The contact person mobile phone number (max. 64 characters)
    - `customerOrderReference` string — The customer order reference (max. 64 characters)
    - `offerReference` string — The offer reference (max. 255 characters)
    - `category` integer — The id of the order category. You need to provide this Parameter or the categoryExternalId.
    - `categoryExternalId` string — The external id of the order category (Used if category not provided).
    - `type` string — | Values | | -------------- | | PROJECT | | CUSTOM_PROJECT |
    - `project` integer — The id of the project.
    - `projectReferenceSign` string — The reference sign of the project (Used if project not provided).
    - `createdAt` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx
  - `pickupLocation` OrderCreateTransportRequestTransportOrderAddressDataItem
    - `type` string — The address type (depending on this either the attribute project or customProject has to be set). | Value | | -------------- | | PROJECT | | CUSTOM_PROJECT |
    - `customProject` ComponentGeocodingAddressInterface — Represents an address
      - `latLng` number[] — Represents a geo coordinate. An array of two double values, representing the latitude and longitude.
      - `name` string — The address name.
      - `street` string — The complete street.
      - `streetName` string — The street name.
      - `streetNumber` string — The house number.
      - `zipCode` string — The postcode.
      - `city` string — The city.
      - `countryCode` string — The two digit country abbreviation. (ISO-3166 ALPHA-2)
      - `fullAddress` string — The complete address.
    - `externalAddressId` string — An external id for the address.
    - `project` integer — The project id.
  - `deliveryLocation` OrderCreateTransportRequestTransportOrderAddressDataItem
    - `type` string — The address type (depending on this either the attribute project or customProject has to be set). | Value | | -------------- | | PROJECT | | CUSTOM_PROJECT |
    - `customProject` ComponentGeocodingAddressInterface — Represents an address
      - `latLng` number[] — Represents a geo coordinate. An array of two double values, representing the latitude and longitude.
      - `name` string — The address name.
      - `street` string — The complete street.
      - `streetName` string — The street name.
      - `streetNumber` string — The house number.
      - `zipCode` string — The postcode.
      - `city` string — The city.
      - `countryCode` string — The two digit country abbreviation. (ISO-3166 ALPHA-2)
      - `fullAddress` string — The complete address.
    - `externalAddressId` string — An external id for the address.
    - `project` integer — The project id.

## Response `200`

Success Response:

- StandardOrderCreateTransportResponse
  - `data` object[] — The created orders.
    - `id` integer — The internal id of the order
    - `reference` string — The internal reference for the order (max. 64 characters)
    - `orderType` string — The order type. This parameter is optional. The allowed value and default is 'ORDER'
    - `externalReference` string — The customer order number (max. 64 characters)
    - `status` string — The order state | Value | | ------------------------ | | ARRIVAL | | ASSIGNED | | CREATED | | DEPARTURE | | FINISHED | | NEAREST_POSITION | | OPENED_BY_USER | | READ | | REJECTED | | SIGNED | | STARTED |
    - `subject` string — Order subject (max. 255 characters)
    - `text` string — Order description
    - `orderDate` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx
    - `duration` integer — The order duration
    - `priority` string — order priority | Value | | ------------------------ | | LOW | | NORMAL | | HIGH |
    - `targetDate` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx
    - `externalAddressId` string — The external customer id.
    - `name` string — The name1 address addition. (max. 255 characters)
    - `name2` string — The name2 address addition. (max. 255 characters)
    - `name3` string — The name3 address addition. (max. 255 characters)
    - `street` string — The street (max. 255 characters)
    - `zipCode` string — The zip code
    - `city` string — The city
    - `countryCode` string — The country code
    - `latLng` number[] — Represents a geo coordinate. An array of two double values, representing the latitude and longitude.
    - `contactPersonName` string — The contact person name (max. 255 characters)
    - `contactPersonEmail` string — The contact person email (max. 255 characters)
    - `contactPersonPhoneNumber` string — The contact person phone number (max. 64 characters)
    - `contactPersonMobileNumber` string — The contact person mobile phone number (max. 64 characters)
    - `customerOrderReference` string — The customer order reference (max. 64 characters)
    - `offerReference` string — The offer reference (max. 255 characters)
    - `category` integer — The id of the order category. You need to provide this Parameter or the categoryExternalId.
    - `categoryExternalId` string — The external id of the order category (Used if category not provided).
    - `type` string — | Values | | -------------- | | PROJECT | | CUSTOM_PROJECT |
    - `project` integer — The id of the project.
    - `projectReferenceSign` string — The reference sign of the project (Used if project not provided).
    - `createdAt` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx

---

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