1. NCTS Declarations
  • Introduction
  • Getting Started
  • Authentication
  • Error Handling
  • Contact Support
  • Modaltrans API
    • Get Auth Token
      • Get Bearer Token
    • Accounting
      • Invoices
        • Retrieve an Invoice
        • List all Invoices
      • Invoice Items
        • List all Invoice Items
        • Deleted Invoice Items
      • Financials
        • Retrieve Financial Information
    • Customs
      • NCTS Declarations
        • List all NCTS Declarations
          GET
        • Retrieve an NCTS Declaration
          GET
        • Create an NCTS Declaration with XML Data
          POST
        • Update an NCTS Declaration
          PATCH
        • Download an NCTS Declaration
          GET
        • List Timelines of NCTS Declaration
          GET
        • List Messages of NCTS Decalaration
          GET
      • Customs Declarations
        • List all Customs Declarations
        • Retrieve a Custom Declaration
        • Create a Customs Declaration
        • Update a Custom Declaration
        • Delete a Custom Declaration
        • Retrieve a Declaration History
        • Retrieve an MRN Status of Declaration
      • Declaration Requests
        • List all Declaration Orders
        • Retrieve a Declaration Request
        • Create a Declaration Request
        • Update a Declaration Request
        • Delete a Declaration Request
      • Ens Declarations
        • Create an Ens Declaration
        • Download an Ens Declaration
    • Logistics
      • Bookings
        • Retrieve a Booking
        • List all Bookings
        • Create a Booking
        • Update a Booking
      • Locations
        • List all Locations
        • Retrieve a Location
      • Positions
        • Update a Transport
        • Get All Positions
      • Tracking
        • Available Shipping Lines
        • Retrieve a Tracking Data
        • Subscribe to Tracking
      • Shipments
        • Retrieve a Shipment
        • List All Shipments
        • Retrieve Financials of Shipment
        • List Contacts of the Shipment
        • Create a Shipment
        • Update a Shipment
    • Depot
      • Orders
        • Retrieve an Order
        • List all Orders
        • Create an Order
        • Update an Order
      • Products
        • Retrieve a Product
        • List all Products
        • Create a Product
        • Update a Product
        • List Product Stocks
      • Inventories
        • List all Inventories
    • Fleet Management
      • Drivers
        • Retrieve a Driver
        • Retrieve a Driver's Vehicle
        • List Driver Positions
        • Update a Driver
      • Vehicles
        • Retrieve a Vehicle
        • Update a Vehicle
      • Gps Service Controller
        • Create Gps Responses
      • Service Logs
        • List all Service Logs
        • Retrieve a Service Log
        • Create a Service Log
        • Delete a Service Log
        • Update a Service Log
      • Periodic Documents
        • Retrieve a Periodic Document
        • Update a Periodic Document
        • Create a Periodic Document
    • CRM
      • Companies
        • List all Companies
        • Retrieve a Company
        • Create a Company
        • Update a Company
        • Delete a Company
        • List Company Credit Limits
    • Timelines
      • Retrieve a Timeline
      • List Timelines
      • Create a Timeline
    • S3 Files
      • List all S3Files
      • Create an S3File
      • Delete an S3File
    • Notifications
      • List all Notifications
      • Update a Notification Status
    • User Details
      • List User Details
      • Update User Details
  1. NCTS Declarations

Create an NCTS Declaration with XML Data

Testing Env
https://demo.modaltrans.com
Testing Env
https://demo.modaltrans.com
POST
/api/v1/ncts_declarations
Creates a NCTS Declaration with XML.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json

Example
{
    "manifesto": {
        "ncts_data": "<?xml version="1.0" encoding="UTF-8" standalone="no"?><ie:BG015C xmlns:ie="http://ncts.dgtaxud.ec"><messageSender>*****</messageSender><messageSenderCode>*******</messageSenderCode><messageRecipient>NTA.BG</messageRecipient><messageRecipientCode>*****</messageRecipientCode><preparationDateAndTime>2024-05-30T11:23:03</preparationDateAndTime><messageIdentification>BG015C</messageIdentification><messageType>BG015C</messageType><TransitOperation><LRN>*********</LRN><declarationType>T1</declarationType><additionalDeclarationType>A</additionalDeclarationType><security>3</security><reducedDatasetIndicator>0</reducedDatasetIndicator><bindingItinerary>0</bindingItinerary></TransitOperation><CustomsOfficeOfDeparture><referenceNumber>BG005804</referenceNumber></CustomsOfficeOfDeparture><CustomsOfficeOfDestinationDeclared><referenceNumber>TR343100</referenceNumber></CustomsOfficeOfDestinationDeclared><CustomsOfficeOfTransitDeclared><sequenceNumber>1</sequenceNumber><referenceNumber>TR220200</referenceNumber><arrivalDateAndTimeEstimated>2024-06-14T00:00:00</arrivalDateAndTimeEstimated></CustomsOfficeOfTransitDeclared><HolderOfTheTransitProcedure><identificationNumber>*********</identificationNumber><name>*********</name><Address><streetAndNumber>*********</streetAndNumber><postcode>*********</postcode><city>*********</city><country>*********</country></Address><ContactPerson><name>*********</name><phoneNumber>*********</phoneNumber><eMailAddress>*********</eMailAddress></ContactPerson></HolderOfTheTransitProcedure><Guarantee><sequenceNumber>1</sequenceNumber><guaranteeType>1</guaranteeType><GuaranteeReference><sequenceNumber>1</sequenceNumber><GRN>****</GRN><accessCode>****</accessCode><amountToBeCovered>****</amountToBeCovered><currency>***</currency></GuaranteeReference></Guarantee><Consignment><countryOfDestination>TR</countryOfDestination><containerIndicator>0</containerIndicator><inlandModeOfTransport>3</inlandModeOfTransport><modeOfTransportAtTheBorder>3</modeOfTransportAtTheBorder><grossMass>11777.000</grossMass><Carrier><identificationNumber>*********</identificationNumber></Carrier><Consignor><name>*********</name><Address><streetAndNumber>*********</streetAndNumber><postcode>*********</postcode><city>*********</city><country>*********</country></Address></Consignor><Consignee><name>*********</name><Address><streetAndNumber>*********</streetAndNumber><postcode>*********</postcode><city>*********</city><country>*********</country></Address></Consignee><DepartureTransportMeans><sequenceNumber>1</sequenceNumber><typeOfIdentification>30</typeOfIdentification><identificationNumber>16BCB723/16APM317</identificationNumber><nationality>TR</nationality></DepartureTransportMeans><CountryOfRoutingOfConsignment><sequenceNumber>1</sequenceNumber><country>RS</country></CountryOfRoutingOfConsignment><CountryOfRoutingOfConsignment><sequenceNumber>2</sequenceNumber><country>BG</country></CountryOfRoutingOfConsignment><CountryOfRoutingOfConsignment><sequenceNumber>3</sequenceNumber><country>TR</country></CountryOfRoutingOfConsignment><ActiveBorderTransportMeans><sequenceNumber>1</sequenceNumber><customsOfficeAtBorderReferenceNumber>BG001015</customsOfficeAtBorderReferenceNumber><typeOfIdentification>30</typeOfIdentification><identificationNumber>*********/*********</identificationNumber><nationality>TR</nationality></ActiveBorderTransportMeans><PlaceOfLoading><country>BG</country><location>BG</location></PlaceOfLoading><PlaceOfUnloading><country>TR</country><location>TR</location></PlaceOfUnloading><TaxCalculation><totalSum>52205</totalSum><Tax><sequenceNumber>1</sequenceNumber><taxType>A00</taxType><taxSum>6558</taxSum></Tax><Tax><sequenceNumber>2</sequenceNumber><taxType>B00</taxType><taxSum>45647</taxSum></Tax></TaxCalculation><HouseConsignment><sequenceNumber>1</sequenceNumber><grossMass>11777.000</grossMass><ConsignmentItem><goodsItemNumber>1</goodsItemNumber><declarationGoodsItemNumber>1</declarationGoodsItemNumber><Commodity><descriptionOfGoods>Препарати за апретура или дообработка, Други От видовете, използвани при производството на текстил или в подобни производства</descriptionOfGoods><CommodityCode><harmonizedSystemSubHeadingCode>380991</harmonizedSystemSubHeadingCode></CommodityCode><GoodsMeasure><grossMass>1492.000</grossMass><netMass>1125.000</netMass></GoodsMeasure></Commodity><Packaging><sequenceNumber>1</sequenceNumber><typeOfPackages>PK</typeOfPackages><numberOfPackages>240</numberOfPackages><shippingMarks>NO MARKS</shippingMarks></Packaging><SupportingDocument><sequenceNumber>1</sequenceNumber><type>N380</type><referenceNumber>PR2401666</referenceNumber></SupportingDocument><TransportDocument><sequenceNumber>1</sequenceNumber><type>N730</type><referenceNumber>CMR</referenceNumber></TransportDocument></ConsignmentItem><ConsignmentItem><goodsItemNumber>2</goodsItemNumber><declarationGoodsItemNumber>2</declarationGoodsItemNumber><Commodity><descriptionOfGoods>Препарати за апретура или дообработка, Други От видовете, използвани при производството на текстил или в подобни производства</descriptionOfGoods><CommodityCode><harmonizedSystemSubHeadingCode>380991</harmonizedSystemSubHeadingCode></CommodityCode><GoodsMeasure><grossMass>5660.000</grossMass><netMass>5660.000</netMass></GoodsMeasure></Commodity><Packaging><sequenceNumber>1</sequenceNumber><typeOfPackages>PK</typeOfPackages><numberOfPackages>0</numberOfPackages><shippingMarks>NO MARKS</shippingMarks></Packaging><SupportingDocument><sequenceNumber>1</sequenceNumber><type>N380</type><referenceNumber>PR2401665</referenceNumber></SupportingDocument><TransportDocument><sequenceNumber>1</sequenceNumber><type>N730</type><referenceNumber>CMR</referenceNumber></TransportDocument></ConsignmentItem><ConsignmentItem><goodsItemNumber>3</goodsItemNumber><declarationGoodsItemNumber>3</declarationGoodsItemNumber><Commodity><descriptionOfGoods>Лепкави и сгъстяващи материали от рожкови, от семена от рожкови или от семена от гуар, дори модифицирани От семена от гуар</descriptionOfGoods><CommodityCode><harmonizedSystemSubHeadingCode>130232</harmonizedSystemSubHeadingCode></CommodityCode><GoodsMeasure><grossMass>4625.000</grossMass><netMass>4625.000</netMass></GoodsMeasure></Commodity><Packaging><sequenceNumber>1</sequenceNumber><typeOfPackages>PK</typeOfPackages><numberOfPackages>0</numberOfPackages><shippingMarks>NO MARKS</shippingMarks></Packaging><SupportingDocument><sequenceNumber>1</sequenceNumber><type>N380</type><referenceNumber>PR2401665</referenceNumber></SupportingDocument><TransportDocument><sequenceNumber>1</sequenceNumber><type>N730</type><referenceNumber>CMR</referenceNumber></TransportDocument></ConsignmentItem></HouseConsignment></Consignment></ie:BG015C>"
    }
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://demo.modaltrans.com/api/v1/ncts_declarations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "manifesto": {
        "ncts_data": "<?xml version="1.0" encoding="UTF-8" standalone="no"?><ie:BG015C xmlns:ie="http://ncts.dgtaxud.ec"><messageSender>*****</messageSender><messageSenderCode>*******</messageSenderCode><messageRecipient>NTA.BG</messageRecipient><messageRecipientCode>*****</messageRecipientCode><preparationDateAndTime>2024-05-30T11:23:03</preparationDateAndTime><messageIdentification>BG015C</messageIdentification><messageType>BG015C</messageType><TransitOperation><LRN>*********</LRN><declarationType>T1</declarationType><additionalDeclarationType>A</additionalDeclarationType><security>3</security><reducedDatasetIndicator>0</reducedDatasetIndicator><bindingItinerary>0</bindingItinerary></TransitOperation><CustomsOfficeOfDeparture><referenceNumber>BG005804</referenceNumber></CustomsOfficeOfDeparture><CustomsOfficeOfDestinationDeclared><referenceNumber>TR343100</referenceNumber></CustomsOfficeOfDestinationDeclared><CustomsOfficeOfTransitDeclared><sequenceNumber>1</sequenceNumber><referenceNumber>TR220200</referenceNumber><arrivalDateAndTimeEstimated>2024-06-14T00:00:00</arrivalDateAndTimeEstimated></CustomsOfficeOfTransitDeclared><HolderOfTheTransitProcedure><identificationNumber>*********</identificationNumber><name>*********</name><Address><streetAndNumber>*********</streetAndNumber><postcode>*********</postcode><city>*********</city><country>*********</country></Address><ContactPerson><name>*********</name><phoneNumber>*********</phoneNumber><eMailAddress>*********</eMailAddress></ContactPerson></HolderOfTheTransitProcedure><Guarantee><sequenceNumber>1</sequenceNumber><guaranteeType>1</guaranteeType><GuaranteeReference><sequenceNumber>1</sequenceNumber><GRN>****</GRN><accessCode>****</accessCode><amountToBeCovered>****</amountToBeCovered><currency>***</currency></GuaranteeReference></Guarantee><Consignment><countryOfDestination>TR</countryOfDestination><containerIndicator>0</containerIndicator><inlandModeOfTransport>3</inlandModeOfTransport><modeOfTransportAtTheBorder>3</modeOfTransportAtTheBorder><grossMass>11777.000</grossMass><Carrier><identificationNumber>*********</identificationNumber></Carrier><Consignor><name>*********</name><Address><streetAndNumber>*********</streetAndNumber><postcode>*********</postcode><city>*********</city><country>*********</country></Address></Consignor><Consignee><name>*********</name><Address><streetAndNumber>*********</streetAndNumber><postcode>*********</postcode><city>*********</city><country>*********</country></Address></Consignee><DepartureTransportMeans><sequenceNumber>1</sequenceNumber><typeOfIdentification>30</typeOfIdentification><identificationNumber>16BCB723/16APM317</identificationNumber><nationality>TR</nationality></DepartureTransportMeans><CountryOfRoutingOfConsignment><sequenceNumber>1</sequenceNumber><country>RS</country></CountryOfRoutingOfConsignment><CountryOfRoutingOfConsignment><sequenceNumber>2</sequenceNumber><country>BG</country></CountryOfRoutingOfConsignment><CountryOfRoutingOfConsignment><sequenceNumber>3</sequenceNumber><country>TR</country></CountryOfRoutingOfConsignment><ActiveBorderTransportMeans><sequenceNumber>1</sequenceNumber><customsOfficeAtBorderReferenceNumber>BG001015</customsOfficeAtBorderReferenceNumber><typeOfIdentification>30</typeOfIdentification><identificationNumber>*********/*********</identificationNumber><nationality>TR</nationality></ActiveBorderTransportMeans><PlaceOfLoading><country>BG</country><location>BG</location></PlaceOfLoading><PlaceOfUnloading><country>TR</country><location>TR</location></PlaceOfUnloading><TaxCalculation><totalSum>52205</totalSum><Tax><sequenceNumber>1</sequenceNumber><taxType>A00</taxType><taxSum>6558</taxSum></Tax><Tax><sequenceNumber>2</sequenceNumber><taxType>B00</taxType><taxSum>45647</taxSum></Tax></TaxCalculation><HouseConsignment><sequenceNumber>1</sequenceNumber><grossMass>11777.000</grossMass><ConsignmentItem><goodsItemNumber>1</goodsItemNumber><declarationGoodsItemNumber>1</declarationGoodsItemNumber><Commodity><descriptionOfGoods>Препарати за апретура или дообработка, Други От видовете, използвани при производството на текстил или в подобни производства</descriptionOfGoods><CommodityCode><harmonizedSystemSubHeadingCode>380991</harmonizedSystemSubHeadingCode></CommodityCode><GoodsMeasure><grossMass>1492.000</grossMass><netMass>1125.000</netMass></GoodsMeasure></Commodity><Packaging><sequenceNumber>1</sequenceNumber><typeOfPackages>PK</typeOfPackages><numberOfPackages>240</numberOfPackages><shippingMarks>NO MARKS</shippingMarks></Packaging><SupportingDocument><sequenceNumber>1</sequenceNumber><type>N380</type><referenceNumber>PR2401666</referenceNumber></SupportingDocument><TransportDocument><sequenceNumber>1</sequenceNumber><type>N730</type><referenceNumber>CMR</referenceNumber></TransportDocument></ConsignmentItem><ConsignmentItem><goodsItemNumber>2</goodsItemNumber><declarationGoodsItemNumber>2</declarationGoodsItemNumber><Commodity><descriptionOfGoods>Препарати за апретура или дообработка, Други От видовете, използвани при производството на текстил или в подобни производства</descriptionOfGoods><CommodityCode><harmonizedSystemSubHeadingCode>380991</harmonizedSystemSubHeadingCode></CommodityCode><GoodsMeasure><grossMass>5660.000</grossMass><netMass>5660.000</netMass></GoodsMeasure></Commodity><Packaging><sequenceNumber>1</sequenceNumber><typeOfPackages>PK</typeOfPackages><numberOfPackages>0</numberOfPackages><shippingMarks>NO MARKS</shippingMarks></Packaging><SupportingDocument><sequenceNumber>1</sequenceNumber><type>N380</type><referenceNumber>PR2401665</referenceNumber></SupportingDocument><TransportDocument><sequenceNumber>1</sequenceNumber><type>N730</type><referenceNumber>CMR</referenceNumber></TransportDocument></ConsignmentItem><ConsignmentItem><goodsItemNumber>3</goodsItemNumber><declarationGoodsItemNumber>3</declarationGoodsItemNumber><Commodity><descriptionOfGoods>Лепкави и сгъстяващи материали от рожкови, от семена от рожкови или от семена от гуар, дори модифицирани От семена от гуар</descriptionOfGoods><CommodityCode><harmonizedSystemSubHeadingCode>130232</harmonizedSystemSubHeadingCode></CommodityCode><GoodsMeasure><grossMass>4625.000</grossMass><netMass>4625.000</netMass></GoodsMeasure></Commodity><Packaging><sequenceNumber>1</sequenceNumber><typeOfPackages>PK</typeOfPackages><numberOfPackages>0</numberOfPackages><shippingMarks>NO MARKS</shippingMarks></Packaging><SupportingDocument><sequenceNumber>1</sequenceNumber><type>N380</type><referenceNumber>PR2401665</referenceNumber></SupportingDocument><TransportDocument><sequenceNumber>1</sequenceNumber><type>N730</type><referenceNumber>CMR</referenceNumber></TransportDocument></ConsignmentItem></HouseConsignment></Consignment></ie:BG015C>"
    }
}'

Responses

🟢201Created
application/json
Body

Example
[
    {
        "transaction_id": 0,
        "reference": "string",
        "doc_type": "string",
        "doc_date": "2019-08-24",
        "vehicle_code": "string",
        "vehicle_coun": "string",
        "trailer_code": "string",
        "trailer_coun": "string",
        "border_cross_vehicle": "string",
        "container": "string",
        "seal_info": "string",
        "security": true,
        "tanker": true,
        "is_aeo": true,
        "aeo_location": "string",
        "transit_date": "2019-08-24",
        "departure_custom_code": "string",
        "dispatch_country_id": "string",
        "load_place": "string",
        "goods_location": "string",
        "arrival_custom_code": "string",
        "destination_country_id": "string",
        "unload_place": "string",
        "border_custom_code": "string",
        "transit_customs_codes": "string",
        "transit_countries_codes": "string",
        "carrier_name": "string",
        "carrier_address": "string",
        "carrier_postcode": "string",
        "carrier_city": "string",
        "carrier_country_id": "string",
        "carrier_taxno": "string",
        "carrier_eori_code": "string",
        "custom_line": "string",
        "custom_staff_name": "string",
        "trans_method": "string",
        "roro_operator_code": "string",
        "guarantee_price": 0,
        "guarantee_curr": "string",
        "status": "string",
        "lrn_no": "string",
        "lrn": "string",
        "mrn": "string",
        "mrn_no": "string",
        "lrn_url": "string",
        "manifesto_price": 0,
        "manifesto_curr": "string",
        "position_no": "string",
        "remote_ref": "string",
        "notes": "string",
        "letter_grn": "string",
        "guarantor_name": "string",
        "guarantor_city": "string",
        "guarantor_taxno": "string",
        "guarantor_address": "string",
        "guarantor_postcode": "string",
        "guarantor_eori_code": "string",
        "guarantor_country_id": "string",
        "mrn_date": "2019-08-24T14:15:22.123Z",
        "stamp_duty": "string",
        "ncts5_checker": true,
        "released_at": "2019-08-24T14:15:22.123Z",
        "goods_attributes": [
            {
                "line_no": 0,
                "gtip_code": "string",
                "commodity": "string",
                "brut_wg": 0,
                "net_wg": 0,
                "invoice_amount": 0,
                "invoice_curr": "string",
                "exp_customs_type": "string",
                "exp_customs_partial": true,
                "exp_customs_no": "string",
                "manifesto_type": "string",
                "dep_country_id": "string",
                "arv_country_id": "string",
                "sender_taxno": "string",
                "sender_name": "string",
                "sender_address": "string",
                "sender_postcode": "string",
                "sender_city": "string",
                "sender_country_id": "string",
                "sender_eori_code": "string",
                "consignee_taxno": "string",
                "consignee_name": "string",
                "consignee_address": "string",
                "consignee_postcode": "string",
                "consignee_city": "string",
                "consignee_country_id": "string",
                "consignee_eori_code": "string",
                "packs_attributes": [
                    {
                        "pack_type": "AE",
                        "pack_count": 0,
                        "notes": "string"
                    }
                ],
                "documents_attributes": [
                    {
                        "doc_type": "T1",
                        "doc_no": "string",
                        "pre_post": "string"
                    }
                ],
                "produced_documents_attributes": [
                    {
                        "code": "string",
                        "reference": "string",
                        "status": "string",
                        "reason": "string",
                        "quantity": 0
                    }
                ]
            }
        ]
    }
]
🟠400Bad Request
🟠403Forbidden
🟠404Record Not Found
🟠422Unprocessable Entity
Modified at 2025-09-09 15:11:49
Previous
Retrieve an NCTS Declaration
Next
Update an NCTS Declaration
Built with