---
title: "Create New CMR"
method: POST
path: "/cmrs"
tags: ["Customs Integration"]
---

# Create New CMR

`POST /cmrs`

This method allows users to create a new CMR document in the EuroGate system with sender, recipient, carrier, vehicle, and Manifest information.

## Request body

- object
  - `partnerNumber` string, nullable — Unique partner CMR number generated in the partner system. If absent, the parameter does not need to be transferred.
  - `senderCompanyTin` string, required — Sender company TIN code agreed upon with the integration manager.
  - `senderDivisionId` integer, required — Sender division identifier agreed upon with the integration manager.
  - `senderCompanyName` string, nullable — Name of the sender organization. Fill this field if `senderCompanyTin == null` or the value is not found in the directory.
  - `senderAddress` string, nullable — Loading address. Fill this field if `senderDivisionId == null` or the value is not found in the directory.
  - `senderCompanyLegalAddress` string, nullable — Registered address of the sender legal entity. Fill this field if `senderCompanyTin == null` or the value is not found in the directory.
  - `senderCountry` string, nullable — Sender country code according to the Alpha-2 standard. Fill this field if `senderDivisionId == null` or the value is not found in the directory.
  - `recipientCompanyTin` string, required — Recipient company TIN code agreed upon with the integration manager.
  - `recipientDivisionId` integer, required — Recipient division identifier agreed upon with the integration manager.
  - `recipientCompanyName` string, nullable — Name of the recipient organization. Fill this field if `recipientCompanyTin == null` or the value is not found in the directory.
  - `recipientAddress` string, nullable — Unloading address. Fill this field if `recipientDivisionId == null` or the value is not found in the directory.
  - `recipientCompanyLegalAddress` string, nullable — Registered address of the recipient legal entity. Fill this field if `recipientCompanyTin == null` or the value is not found in the directory.
  - `recipientCountry` string, nullable — Recipient country code according to the Alpha-2 standard. Fill this field if `recipientDivisionId == null` or the value is not found in the directory.
  - `loadingDateTime` string, date-time, nullable, required — Date and time of vehicle loading. If the vehicle is not loaded yet at the moment of CMR creation, `null` must be transferred and updated later.
  - `customsRecipient` string, required — Recipient customs details agreed upon with the integration manager.
  - `carrierTin` string, required — Carrier company TIN code agreed upon with the integration manager.
  - `carrierName` string, nullable — Name of the freight carrier. Fill this field if `carrierTin == null` or the value is not found in the directory.
  - `vehicleNumber` string, required — Vehicle number. Letters must be entered in Latin only.
  - `trailerNumber` string, nullable, required — Trailer number. Letters must be entered in Latin only. If there is no trailer, the value `null` must be transferred.
  - `sealNumber` string, nullable, required — Seal number. If the seal number is not yet known at the moment of creation, `null` must be transferred and updated later.
  - `dateOfSealing` string, date-time, nullable, required — Date and time of vehicle sealing. If sealing information is not yet known at the moment of creation, `null` must be transferred and updated later.
  - `documents` object[], required — Array of pre-created manifests.
    - `number` string, required — Manifest number. The parameter may contain either: - partner manifest number (`partnerNumber`) - unique manifest number in the EuroGate system (`number`)
    - `type` 'Manifest', required — Document type. The parameter must contain the value `Manifest`.
  - `numberMrn` string, nullable, required — MRN T1 number. If shipments are transported under CarnetTIR, the value `null` must be transferred.
  - `carnetTir` string, nullable, required — CarnetTIR number. If shipments are transported under T1, the value `null` must be transferred.
  - `externalNumber` string, nullable — Optional external number. This parameter is not required for current integration scenarios.
  - `senderNote` string, nullable — Optional sender note. This parameter is not required for current integration scenarios.
  - `recipientNote` string, nullable — Optional recipient note. This parameter is not required for current integration scenarios.
  - `carrierNote` string, nullable — Optional carrier note. This parameter is not required for current integration scenarios.

## Response `200`

Response to a successful request.

- object
  - `documents` object[] — Array of processed or generated documents associated with the CMR.
    - `id` integer — Unique identifier of the document.
    - `number` string — Unique manifest or document number in the system.
    - `type` string — Type of the document (e.g., Manifest).
    - `createdAt` string, date-time — Timestamp when the document was created.
    - `updatedAt` string, date-time — Timestamp when the document was last updated.
    - `deletedAt` string, date-time, nullable — Timestamp when the document was deleted, if applicable.
  - `number` string — Unique CMR number in the EuroGate system.
  - `partnerNumber` string — The unique partner CMR number generated in the partner system.
  - `status` string — Current operational status of the CMR (e.g., Created).
  - `senderCompanyTin` string — The sender's company TIN code.
  - `senderCompanyName` string — Full name of the shipper's organization.
  - `senderCompanyLegalAddress` string — The registered legal address of the sender.
  - `senderCompanyPhone` string, nullable — Contact phone number of the sender's company.
  - `senderCountryCode` string — Sender's country code (Alpha-2).
  - `senderCityCode` string — System or postal code for the sender's city.
  - `senderDivisionId` integer — Identifier of the sender's division.
  - `senderAddress` string — Full physical address or loading location for the sender.
  - `recipientCompanyTin` string — The recipient's company TIN code.
  - `recipientCompanyName` string — Full name of the consignee's organization.
  - `recipientCompanyLegalAddress` string — The registered legal address of the recipient.
  - `recipientCountryCode` string — Recipient's country code (Alpha-2).
  - `recipientCityCode` string — System or postal code for the recipient's city.
  - `recipientDivisionId` integer — Identifier of the recipient's division.
  - `recipientAddress` string — Full physical address or unloading location for the recipient.
  - `loadingDateTime` string, date-time — Date and time of vehicle loading.
  - `customsRecipient` string — Recipient customs details and office codes.
  - `carrierTin` string — TIN code of the carrier company.
  - `carrierName` string, nullable — Name of the freight carrier.
  - `vehicleNumber` string, nullable — Main vehicle registration number.
  - `trailerNumber` string, nullable — Trailer registration number.
  - `sealNumber` string, nullable — Number of the applied mechanical seal.
  - `dateOfSealing` string, date-time, nullable — Date and time when the vehicle was sealed.
  - `userCreate` string, uuid — Identifier (UUID) of the user who created the record.
  - `createdAt` string, date-time — Timestamp when the CMR record was created.
  - `updatedAt` string, date-time — Timestamp when the CMR record was last updated.
  - `deletedAt` string, date-time, nullable — Timestamp when the CMR record was deleted.
  - `externalNumber` string, nullable — Optional external reference number.
  - `numberMrn` string, nullable — MRN T1 declaration number.
  - `rampDestinationTime` string, date-time, nullable — Estimated or actual time of arrival at the loading ramp.
  - `rampDepartureTime` string, date-time, nullable — Estimated or actual time of departure from the loading ramp.
  - `unloadingRampDestinationTime` string, date-time, nullable — Estimated or actual time of arrival at the unloading ramp.
  - `unloadingRampDepartureTime` string, date-time, nullable — Estimated or actual time of departure from the unloading ramp.
  - `actualWeight` number — Total actual weight of the cargo in kilograms or grams.
  - `senderNote` string, nullable — Informational notes or comments provided by the sender.
  - `recipientNote` string, nullable — Informational notes or comments provided by the recipient.
  - `carrierNote` string, nullable — Informational notes or comments provided by the carrier.
  - `carnetTir` string, nullable — CarnetTIR transit document number.
  - `parcelsAmount` integer — Total number of parcels included in the CMR.
  - `shipmentAmount` integer — Total number of shipments combined in this document.
  - `transferOfCustomsData` string, nullable — Status or confirmation reference of customs data transmission.

---

[API](https://skmtc.net/novapost/apis/api-nova-post.md) · [All operations](https://skmtc.net/novapost/apis/api-nova-post/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/novapost/api-nova-post/revisions/60e380005037/schema)