- Introduction
- Getting Started
- Authentication
- Error Handling
- Contact Support
- Modaltrans API
- Get Auth Token
- Accounting
- Customs
- NCTS Declarations
- Customs Declarations
- Declaration Requests
- Logistics
- Depot
- Fleet Management
- CRM
- Timelines
- S3 Files
- Notifications
- User Details
Create an NCTS Declaration with XML Data
Testing Env
https://demo.modaltrans.com
Testing Env
https://demo.modaltrans.com
POST
/api/v1/ncts_declarations
Request
Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.Example:
Authorization: Bearer ********************
Body Params application/json
manifesto
object
required
ncts_data
string
required
Example
{
"manifesto": {
"ncts_data": "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"no\"?><ie:BG015C xmlns:ie=\"http://ncts.dgtaxud.ec\"><messageSender>TRA.APP</messageSender><messageSenderCode>ITTR0000000000153</messageSenderCode><messageRecipient>NTA.BG</messageRecipient><messageRecipientCode>BG005804</messageRecipientCode><preparationDateAndTime>2024-05-30T11:23:03</preparationDateAndTime><messageIdentification>BG015C</messageIdentification><messageType>BG015C</messageType><TransitOperation><LRN>GBR2131334</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>DE828088257899835</identificationNumber><name>ZOLLMAX TRANSIT LOGISTIK GMBH.</name><Address><streetAndNumber>Berliner Allee 59</streetAndNumber><postcode>40212</postcode><city>DUSSELDORF</city><country>DE</country></Address><ContactPerson><name>Selçuk YILMAZ</name><phoneNumber>905322666994</phoneNumber><eMailAddress>selcuk.yilmaz@oregon.com.tr</eMailAddress></ContactPerson></HolderOfTheTransitProcedure><Guarantee><sequenceNumber>1</sequenceNumber><guaranteeType>1</guaranteeType><GuaranteeReference><sequenceNumber>1</sequenceNumber><GRN>21DE0000000081910</GRN><accessCode>OTPL</accessCode><amountToBeCovered>52205</amountToBeCovered><currency>BGN</currency></GuaranteeReference></Guarantee><Consignment><countryOfDestination>TR</countryOfDestination><containerIndicator>0</containerIndicator><inlandModeOfTransport>3</inlandModeOfTransport><modeOfTransportAtTheBorder>3</modeOfTransportAtTheBorder><grossMass>11777.000</grossMass><Carrier><identificationNumber>BGKTR0340362638Z2</identificationNumber></Carrier><Consignor><name>YUMCO COMMERCE DOO</name><Address><streetAndNumber>VRANJE</streetAndNumber><postcode>01111</postcode><city>VRANJE</city><country>RS</country></Address></Consignor><Consignee><name>ASR TRANS LOJISTIK VE DIS TICARET L</name><Address><streetAndNumber>ISTANBUL</streetAndNumber><postcode>34850</postcode><city>ISTANBUL</city><country>TR</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>16BCB723/16APM317</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 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 '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>TRA.APP</messageSender><messageSenderCode>ITTR0000000000153</messageSenderCode><messageRecipient>NTA.BG</messageRecipient><messageRecipientCode>BG005804</messageRecipientCode><preparationDateAndTime>2024-05-30T11:23:03</preparationDateAndTime><messageIdentification>BG015C</messageIdentification><messageType>BG015C</messageType><TransitOperation><LRN>GBR2131334</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>DE828088257899835</identificationNumber><name>ZOLLMAX TRANSIT LOGISTIK GMBH.</name><Address><streetAndNumber>Berliner Allee 59</streetAndNumber><postcode>40212</postcode><city>DUSSELDORF</city><country>DE</country></Address><ContactPerson><name>Selçuk YILMAZ</name><phoneNumber>905322666994</phoneNumber><eMailAddress>selcuk.yilmaz@oregon.com.tr</eMailAddress></ContactPerson></HolderOfTheTransitProcedure><Guarantee><sequenceNumber>1</sequenceNumber><guaranteeType>1</guaranteeType><GuaranteeReference><sequenceNumber>1</sequenceNumber><GRN>21DE0000000081910</GRN><accessCode>OTPL</accessCode><amountToBeCovered>52205</amountToBeCovered><currency>BGN</currency></GuaranteeReference></Guarantee><Consignment><countryOfDestination>TR</countryOfDestination><containerIndicator>0</containerIndicator><inlandModeOfTransport>3</inlandModeOfTransport><modeOfTransportAtTheBorder>3</modeOfTransportAtTheBorder><grossMass>11777.000</grossMass><Carrier><identificationNumber>BGKTR0340362638Z2</identificationNumber></Carrier><Consignor><name>YUMCO COMMERCE DOO</name><Address><streetAndNumber>VRANJE</streetAndNumber><postcode>01111</postcode><city>VRANJE</city><country>RS</country></Address></Consignor><Consignee><name>ASR TRANS LOJISTIK VE DIS TICARET L</name><Address><streetAndNumber>ISTANBUL</streetAndNumber><postcode>34850</postcode><city>ISTANBUL</city><country>TR</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>16BCB723/16APM317</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
array of:
transaction_id
integer
required
reference
string
required
doc_type
string
required
doc_date
string <date>
required
vehicle_code
string
required
vehicle_coun
string
required
trailer_code
string
required
trailer_coun
string
required
border_cross_vehicle
string
required
container
string
required
seal_info
string
required
security
boolean
required
tanker
boolean
required
is_aeo
boolean
required
aeo_location
string
required
transit_date
string <date>
required
departure_custom_code
string
required
dispatch_country_id
string
required
load_place
string
required
goods_location
string
required
arrival_custom_code
string
required
destination_country_id
string
required
unload_place
string
required
border_custom_code
string
required
transit_customs_codes
string
required
transit_countries_codes
string
required
carrier_name
string
required
carrier_address
string
required
carrier_postcode
string
required
carrier_city
string
required
carrier_country_id
string
required
carrier_taxno
string
required
carrier_eori_code
string
required
custom_line
string
required
custom_staff_name
string
required
trans_method
string
required
roro_operator_code
string
required
guarantee_price
number
required
guarantee_curr
string
required
status
string
required
lrn_no
string
required
lrn
string
required
mrn
string
required
mrn_no
string
required
lrn_url
string
required
manifesto_price
number
required
manifesto_curr
string
required
position_no
string
required
remote_ref
string
required
notes
string
required
letter_grn
string
required
guarantor_name
string
required
guarantor_city
string
required
guarantor_taxno
string
required
guarantor_address
string
required
guarantor_postcode
string
required
guarantor_eori_code
string
required
guarantor_country_id
string
required
mrn_date
string <date-time>
required
stamp_duty
string
required
ncts5_checker
boolean
required
released_at
string <date-time>
required
goods_attributes
array [object {30}]
optional
line_no
integer
required
gtip_code
string
required
commodity
string
required
brut_wg
number
required
net_wg
number
required
invoice_amount
number
required
invoice_curr
string
required
exp_customs_type
string
required
exp_customs_partial
boolean
required
exp_customs_no
string
required
manifesto_type
string
required
dep_country_id
string
required
arv_country_id
string
required
sender_taxno
string
required
sender_name
string
required
sender_address
string
required
sender_postcode
string
required
sender_city
string
required
sender_country_id
string
required
sender_eori_code
string
required
consignee_taxno
string
required
consignee_name
string
required
consignee_address
string
required
consignee_postcode
string
required
consignee_city
string
required
consignee_country_id
string
required
consignee_eori_code
string
required
packs_attributes
array [object {3}]
required
documents_attributes
array [object {3}]
required
produced_documents_attributes
array [object {5}]
required
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:22Z",
"stamp_duty": "string",
"ncts5_checker": true,
"released_at": "2019-08-24T14:15:22Z",
"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-03-25 10:48:13