Instructions for deliveries from and to Greece via Econt API

  1. Introduction

    All requests should be sent as HTTP request type POST.

    Authentication using SSL client certificates is currently not supported, but you can use an SSL connection. For the XML API you have to authorize in the request body. For the JSON/SOAP API, your credentials should be provided as BASIC authentication header in the HTTP request.

    There are test(demo) and production environments. You can create your own account and use the same credentials for the API auth.
    Registration for test environment: https://login-demo.econt.com/register/
    Registration for prod environment: https://login.econt.com/register/

    URL endpoints for services differ only by the base domain URL. In the examples below you should replace BASE_URL with the corresponding from the list below.

    Base URL for JSON/SOAP API environment:
    Test: https://demo.econt.com/ee/services
    Prod: https://ee.econt.com/services

    Base URL for the XML API environment:
    Test: https://demo.econt.com/e-econt
    Prod: https://econt.com/e-econt

    Additional information and fields descriptions are available in the official API documentation.
    JSON/SOAP: https://ee.econt.com/services/
    XML: https://econt.com/e-econt/doc_templates/XML_manual_engl.pdf

    In this guide we will be using JSON and XML examples. If you want to implement SOAP you can check the official documentation at the link above.


  2. Extracting countries data

    This data is not mandatory and may be omitted.
    Using JSON 
    Request @ BASE_URL/Nomenclatures/NomenclaturesService.getCountries.json
					{
	"GetCountriesRequest":""
}
    Response
					{
	"countries": [
		...
		{
			"id": null,
			"code2": "GR",
			"code3": "GRC",
			"name": "Гърция",
			"nameEn": "Greece",
			"isEU": true
		},
		...
	]
}


    Using XML 
    Request @ BASE_URL/xml_service_tool.php
					<?xml version="1.0" ?>
<request>
	<client>
		<username>****</username>
		<password>****</password>
	</client>
	<request_type>countries</request_type>
</request>
    Response
					<?xml version="1.0" encoding="UTF-8"?>
<response>
	...
	<e>
		<id>1084</id>
		<country_name>Гърция</country_name>
		<country_name_en>Greece</country_name_en>
		<id_zone>51</id_zone>
		<zone_name>Зона I Централна Гърция, Пелопонос, Евия</zone_name>
		<zone_name_en>Зона I Централна Гърция, Пелопонос, Евия</zone_name_en>
	</e>
	...
</response>

  3. Extracting cities data

    Important: When creating shipments you have to provide from this service either: (id) OR (post code and name) for JSON and (post code and name) for XML APIs.

    Using JSON 
    Request @ BASE_URL/Nomenclatures/NomenclaturesService.getCities.json
					{
	"countryCode":"GRC"
}
    Response
					{
	"cities": [
		...
		{
			"id": 55978,
			"country": {
				"id": null,
				"code2": "GR",
				"code3": "GRC",
				"name": "Гърция",
				"nameEn": "Greece",
				"isEU": true
			},
			"postCode": "10431",
			"name": "ΑΘΗΝΑ",
			"nameEn": "ATHINA",
			"regionName": "ΑΤΤΙΚΗΣ",
			"regionNameEn": "ATTIKIS",
			"phoneCode": "0",
			"location": null,
			"expressCityDeliveries": false
		},
		{
			"id": 55980,
			"country": {
				"id": null,
				"code2": "GR",
				"code3": "GRC",
				"name": "Гърция",
				"nameEn": "Greece",
				"isEU": true
			},
			"postCode": "54248",
			"name": "ΘΕΣΣΑΛΟΝΙΚΗ",
			"nameEn": "THESSALONIKI",
			"regionName": "ΘΕΣΣΑΛΟΝΙΚΗΣ",
			"regionNameEn": "THESSALONIKIS",
			"phoneCode": "0",
			"location": null,
			"expressCityDeliveries": false
		},
		...
	]
}


    Using XML 
    Request @ BASE_URL/xml_service_tool.php
					<?xml version="1.0" ?>
<request>
	<client>
		<username>****</username>
		<password>****</password>
	</client>
	<request_type>cities</request_type>
	<cities>
		<country_code>GRC</country_code>
	</cities>
</request>
    Response
					<?xml version="1.0" encoding="UTF-8"?>
<response>
	<cities>
		<e>
			<id>55978</id>
			<post_code>10431</post_code>
			<country_code>GRC</country_code>
			<type>гр.</type>
			<id_zone>55</id_zone>
			<name>ΑΘΗΝΑ</name>
			<name_en>ATHINA</name_en>
			<region>ΑΤΤΙΚΗΣ</region>
			<region_en>ATTIKIS</region_en>
			<id_country>1084</id_country>
			<id_office>33969</id_office>
			<updated_time>2021-09-28 10:22:20</updated_time>
			<hub_code>500906</hub_code>
			<hub_name>ACS Greece</hub_name>
			<hub_name_en>ACS Greece</hub_name_en>
			<courier_request_begin_time>
				10:15:00
			</courier_request_begin_time>
			<courier_request_begin_time_saturday>
				10:15:00
			</courier_request_begin_time_saturday>
			<courier_request_end_time>
				17:45:00
			</courier_request_end_time>
			<courier_request_end_time_saturday>
				08:45:00
			</courier_request_end_time_saturday>
			<service_days>
				<day1>1</day1>
				<day2>1</day2>
				<day3>1</day3>
				<day4>1</day4>
				<day5>1</day5>
				<day6>1</day6>
				<day7>0</day7>
			</service_days>
			<attach_offices>
				<courier_shipments>
					<from_door>
						<office_code>500906</office_code>
						<office_code>500911</office_code>
						<office_code>500912</office_code>
					</from_door>
					<to_door>
						<office_code>500906</office_code>
						<office_code>500911</office_code>
						<office_code>500912</office_code>
					</to_door>
					<from_office>
						<office_code>11476</office_code>
						<office_code>15774</office_code>
						<office_code>17778</office_code>
						<office_code>71203</office_code>
						<office_code>500906</office_code>
					</from_office>
					<to_office>
						<office_code>11476</office_code>
						<office_code>15774</office_code>
						<office_code>17778</office_code>
						<office_code>71203</office_code>
						<office_code>500906</office_code>
					</to_office>
				</courier_shipments>
				<cargo_palet_shipments>
					<from_door>
						<office_code>50090</office_code>
						<office_code>500911</office_code>
						<office_code>500913</office_code>
						<office_code>500914</office_code>
					</from_door>
					<to_door>
						<office_code>50090</office_code>
						<office_code>500911</office_code>
						<office_code>500913</office_code>
						<office_code>500914</office_code>
					</to_door>
					<from_office/>
					<to_office/>
				</cargo_palet_shipments>
				<cargo_expres_shipments>
					<from_door/>
					<to_door/>
					<from_office/>
					<to_office/>
				</cargo_expres_shipments>
				<post_shipments>
					<from_door/>
					<to_door/>
					<from_office>
						<office_code>500906</office_code>
					</from_office>
					<to_office>
						<office_code>500906</office_code>
					</to_office>
				</post_shipments>
			</attach_offices>
		</e>
		...
	</cities>
</response>

  4. Extracting offices data

    Using JSON 
    Request @ BASE_URL/Nomenclatures/NomenclaturesService.getOffices.json
					{
	"countryCode":"GRC"
}
    Response
					{
	"offices": [
		...
		{
			"id": 34692,
			"code": "500913",
			"isMPS": false,
			"isAPS": false,
			"name": "Thessaloniki Sfageia",
			"nameEn": "Thessaloniki Sfageia",
			"phones": [
				"2310411544"
			],
			"emails": [
				"thessaloniki@econt.com"
			],
			"address": {
				"id": null,
				"city": {
					"id": 55980,
					"country": {
						"id": 1084,
						"code2": "GR",
						"code3": "GRC",
						"name": "Гърция",
						"nameEn": "Greece",
						"isEU": true
					},
					"postCode": "54248",
					"name": "ΘΕΣΣΑΛΟΝΙΚΗ",
					"nameEn": "THESSALONIKI",
					"regionName": null,
					"regionNameEn": null,
					"phoneCode": null,
					"location": null,
					"expressCityDeliveries": null
				},
				"fullAddress": " ΘΕΣΣΑΛΟΝΙΚΗ 26 october №150",
				"quarter": null,
				"street": "26 october",
				"num": "150",
				"other": "",
				"location": {
					"latitude": 40.649100802087,
					"longitude": 22.904096534805,
					"confidence": 3
				},
				"zip": null
			},
			"info": "",
			"currency": "EUR",
			"language": null,
			"normalBusinessHoursFrom": 1633672800000,
			"normalBusinessHoursTo": 1633705200000,
			"halfDayBusinessHoursFrom": 1633672800000,
			"halfDayBusinessHoursTo": 1633687200000,
			"shipmentTypes": [
				"courier",
				"pallet"
			],
			"partnerCode": "",
			"hubCode": "500913",
			"hubName": "Thessaloniki Sfageia",
			"hubNameEn": "Thessaloniki Sfageia"
		},
		...
	]
}


    Using XML 
    Request @ BASE_URL/xml_service_tool.php
					<?xml version="1.0" ?>
<request>
	<client>
		<username>****</username>
		<password>****</password>
	</client>
	<request_type>offices</request_type>
</request>
    Response
					<?xml version="1.0" encoding="UTF-8"?>
<response>
	<offices>
		...
		<e>
			<id>34692</id>
			<name>Thessaloniki Sfageia</name>
			<name_en>Thessaloniki Sfageia</name_en>
			<office_code>500913</office_code>
			<is_mobile/>
			<is_machine/>
			<country_code>GRC</country_code>
			<id_city>55980</id_city>
			<post_code>54248</post_code>
			<city_name>ΘΕΣΣΑΛΟΝΙΚΗ</city_name>
			<city_name_en>THESSALONIKI</city_name_en>
			<address> ΘΕΣΣΑΛΟΝΙΚΗ 26 october №150</address>
			<address_en> THESSALONIKI 26 october №150</address_en>
			<latitude>40.6491008020868</latitude>
			<longitude>22.904096534805277</longitude>
			<address_details>
				<id_quarter></id_quarter>
				<quarter_name></quarter_name>
				<quarter_name_en></quarter_name_en>
				<id_street>168791</id_street>
				<street_name>26 october</street_name>
				<street_name_en>26 october</street_name_en>
				<num>150</num>
				<bl></bl>
				<vh></vh>
				<et></et>
				<ap></ap>
				<other></other>
			</address_details>
			<office_details>
				<courier>1</courier>
				<post>0</post>
				<cargo>1</cargo>
				<cargo_express>0</cargo_express>
			</office_details>
			<phone>2310411544</phone>
			<email>thessaloniki@econt.com</email>
			<work_begin>09:00:00</work_begin>
			<work_end>18:00:00</work_end>
			<work_begin_saturday>09:00:00</work_begin_saturday>
			<work_end_saturday>13:00:00</work_end_saturday>
			<time_priority></time_priority>
			<updated_time>2021-07-08 11:32:23</updated_time>
			<hub_code>500913</hub_code>
			<hub_name>Thessaloniki Sfageia</hub_name>
			<hub_name_en>Thessaloniki Sfageia</hub_name_en>
		</e>
		...
	</offices>
</response>

  5. Creating a shipment from Bulgaria to Greece

    Using JSON 
    Request @ BASE_URL/Shipments/LabelService.createLabel.json
					{
	"label": {
		"senderClient": {
			"name": "Фирма ЕООД",
			"nameEn": "Firma EOOD",
			"phones": [
				"0888888888"
			],
			"email": "info@firma.bg",
			"skypeAccounts": [],
			"clientNumber": "",
			"clientNumberEn": "",
			"juridicalEntity": "",
			"personalIDType": "",
			"personalIDNumber": "",
			"companyType": "",
			"ein": "123456789",
			"ddsEinPrefix": "BG",
			"ddsEin": "BG123456789",
			"registrationAddress": "",
			"molName": "Ivan Ivanov",
			"molEGN": "",
			"molIDNum": ""
		},
		"senderAgent": {
			"name": "Петър Петров",
			"nameEn": "Petar Petrov",
			"phones": [
				"0899999999"
			],
			"email": "petar@firma.bg"
		},
		"senderAddress": {
			"city": {
				"id": "",
				"country": {
					"code3": "BGR"
				},
				"postCode": "9000",
				"name": "Варна",
				"nameEn": "Varna"
			},
			"fullAddress": "",
			"quarter": "",
			"street": "ул. Иван Вазов",
			"num": "1",
			"other": ""
		},
		"senderOfficeCode": "",

		"receiverClient": {
			"name": "MARIA PANAGIOTIDI",
			"nameEn": "MARIA PANAGIOTIDI",
			"phones": [
				"6900000000"
			],
			"email": "maria@mail.gr"
		},
		"receiverAgent": "",
		"receiverAddress": {
			"city": {
				"id": "",
				"country": {
					"code3": "GRC"
				},
				"postCode": "26221",
				"name": "ΠΑΤΡΑ",
				"nameEn": "PATRA",
				"regionName": "ΑΧΑΪΑΣ",
				"regionNameEn": "ACHAIAS"
			},
			"fullAddress": "",
			"quarter": "",
			"street": "Athinon",
			"num": "147",
			"other": "",
			"zip": "26442" //it is recommended to provide ZIP code
			//which is different than the city post code
		},
		"receiverOfficeCode": "",

		"packCount": 1,
		"shipmentType": "PACK",
		"weight": 1.5,
		"shipmentDescription": "description of the contents",
		"orderNumber": "ORD-1234567",
		"sendDate": "",
		"holidayDeliveryDay": "workday",
		"paymentSenderMethod": "cash"
	},

	"requestCourierTimeFrom": "",
	"requestCourierTimeTo": "",
	"mode": "create"
}
    Response
					{
	"label": {
		"shipmentNumber": "3000000008980",
		"storageOfficeName": null,
		"storagePersonName": null,
		"createdTime": 1634824369000,
		"sendTime": null,
		"deliveryTime": null,
		"shipmentType": "pack",
		"packCount": 1,
		"shipmentDescription": "description of the contents",
		"weight": 1.5,
		"senderDeliveryType": null,
		"senderClient": null,
		"senderAgent": null,
		"senderOfficeCode": null,
		"senderAddress": null,
		"receiverDeliveryType": null,
		"receiverClient": null,
		"receiverAgent": null,
		"receiverOfficeCode": null,
		"receiverAddress": null,
		"cdCollectedAmount": 0,
		"cdCollectedCurrency": "",
		"cdCollectedTime": null,
		"cdPaidAmount": 0,
		"cdPaidCurrency": "",
		"cdPaidTime": null,
		"totalPrice": 15,
		"currency": "BGN",
		"discountPercent": 0,
		"discountAmount": -0,
		"discountDescription": "",
		"senderDueAmount": 15,
		"receiverDueAmount": 0,
		"otherDueAmount": 0,
		"deliveryAttemptCount": 0,
		"previousShipmentNumber": "",
		"services": [
			{
				"type": "C",
				"description": "Колетна пратка до зона Солун - до 2 кг",
				"count": 1,
				"paymentSide": "SENDER",
				"price": 15,
				"currency": "BGN"
			}
		],
		"nextShipments": [],
		"trackingEvents": [],
		"pdfURL": "http:\/\/demo.econt.com\/ee\/api_export.php?exportMethod=printLoading&loading_num=3000000008980&_key=d20169a26114f226bf0b312752e9f93f6613c688",
		"expectedDeliveryDate": 1635022800000,
		"returnShipmentURL": "https:\/\/delivery-demo.econt.com\/return_shipment.php?_key=a27db65fc37964249ac09c8dbfe1c64781d465e6&return_shipment_num=3000000008980"
	},
	"blockingPaymentURL": null
}


    Using XML 
    Request @ BASE_URL/xml_parcel_import2.php
					<?xml version="1.0"?>
<parcels>
	<system>
		<response_type>XML</response_type>
		<only_calculate>0</only_calculate>
		<validate>0</validate>
	</system>
	<client>
		<username>****</username>
		<password>****</password>
	</client>
	<loadings>
		<!-- can contain multiple <row>'s -->
		<row>
			<sender>
				<country_code>BGR</country_code>
				<city>Варна</city>
				<post_code>9000</post_code>
				<office_code></office_code>
				<name>Фирма ЕООД</name>
				<name_person>Петър Петров</name_person>
				<email>petar@firma.bg</email>
				<quarter></quarter>
				<street>ул. Иван Вазов</street>
				<street_num>1</street_num>
				<street_bl></street_bl>
				<street_vh></street_vh>
				<street_et></street_et>
				<street_ap></street_ap>
				<street_other></street_other>
				<phone_num>0899999999</phone_num>
				<email_on_delivery></email_on_delivery>
			</sender>
			<receiver>
				<country_code>GRC</country_code>
				<city>ΠΑΤΡΑ</city>
				<post_code>26221</post_code>
				<!-- it is recommended to provide ZIP code below -->
				<address_zip>26442</address_zip>
				<office_code></office_code>
				<name>MARIA PANAGIOTIDI</name>
				<name_person></name_person>
				<email>maria@mail.gr</email>
				<quarter></quarter>
				<street>Athinon</street>
				<street_num>147</street_num>
				<street_bl></street_bl>
				<street_vh></street_vh>
				<street_et></street_et>
				<street_ap></street_ap>
				<street_other></street_other>
				<phone_num>6900000000</phone_num>
			</receiver>
			<payment>
				<side>sender</side>
				<method>cash</method>
			</payment>
			<shipment>
				<shipment_type>PACK</shipment_type>
				<description>description of the contents</description>
				<pack_count>1</pack_count>
				<shipment_pack_dimensions_l></shipment_pack_dimensions_l>
				<shipment_pack_dimensions_w></shipment_pack_dimensions_w>
				<shipment_pack_dimensions_h></shipment_pack_dimensions_h>
				<weight>1.5</weight>
				<tariff_sub_code>DOOR_DOOR</tariff_sub_code>
				<delivery_day>workday</delivery_day>
				<order_num>ORD-1234567</order_num>
			</shipment>
		</row>
	</loadings>
</parcels>

    Response
					<?xml version="1.0" encoding="UTF-8"?>
<response>
	<result>
		<e>
			<loading_id>2021100000015087</loading_id>
			<loading_num>3000000009024</loading_num>
			<courier_request_id></courier_request_id>
			<delivery_date>2021-10-28</delivery_date>
			<loading_price>
				<C>15</C>
				<total>15</total>
				<sender_total>15</sender_total>
				<receiver_total>0</receiver_total>
				<other_total>0</other_total>
				<currency>лв</currency>
				<currency_code>BGN</currency_code>
			</loading_price>
			<loading_discount>
				<amount>0</amount>
				<description/>
			</loading_discount>
			<error></error>
			<error_code></error_code>
			<pdf_url>http://demo.econt.com/ee/api_export.php?exportMethod=printLoading&amp;loading_num=3000000009024&amp;_key=920ed4546598176473047cc690c5c34d6eb1d325&amp;</pdf_url>
			<return_shipment_url>https://delivery-demo.econt.com/return_shipment.php?_key=ee997fad5369a560cd3bb30419b4bbe4e392848d&amp;return_shipment_num=3000000009024</return_shipment_url>
			<return_reason/>
			<prev_parcel_num/>
			<next_parcels/>
			<import_rc_code>50090</import_rc_code>
		</e>
	</result>
</response>

  6. Creating a shipment from Greece to Bulgaria

    Using JSON 
    Request @ BASE_URL/Shipments/LabelService.createLabel.json
					{
	"label": {
		"senderClient": {
			"name": "MARIA PANAGIOTIDI",
			"nameEn": "MARIA PANAGIOTIDI",
			"phones": [
				"6900000000"
			],
			"email": "maria@mail.gr"
		},
		"senderAgent": "",
		"senderAddress": {
			"city": {
				"id": "",
				"country": {
					"code3": "GRC"
				},
				"postCode": "26221",
				"name": "ΠΑΤΡΑ",
				"nameEn": "PATRA",
				"regionName": "ΑΧΑΪΑΣ",
				"regionNameEn": "ACHAIAS"
			},
			"fullAddress": "",
			"quarter": "",
			"street": "Athinon",
			"num": "147",
			"other": "",
			"zip": "26442"
		},
		"senderOfficeCode": "",

		"receiverClient": {
			"name": "Фирма ЕООД",
			"nameEn": "Firma EOOD",
			"phones": [
				"0888888888"
			],
			"email": "info@firma.bg",
			"skypeAccounts": [],
			"clientNumber": "",
			"clientNumberEn": "",
			"juridicalEntity": "",
			"personalIDType": "",
			"personalIDNumber": "",
			"companyType": "",
			"ein": "123456789",
			"ddsEinPrefix": "BG",
			"ddsEin": "BG123456789",
			"registrationAddress": "",
			"molName": "Ivan Ivanov",
			"molEGN": "",
			"molIDNum": ""
		},
		"receiverAgent": {
			"name": "Петър Петров",
			"nameEn": "Petar Petrov",
			"phones": [
				"0899999999"
			],
			"email": "petar@firma.bg"
		},
		"receiverAddress": {
			"city": {
				"id": "",
				"country": {
					"code3": "BGR"
				},
				"postCode": "9000",
				"name": "Варна",
				"nameEn": "Varna"
			},
			"fullAddress": "",
			"quarter": "",
			"street": "ул. Иван Вазов",
			"num": "1",
			"other": ""
		},
		"receiverOfficeCode": "",

		"packCount": 1,
		"shipmentType": "PACK",
		"weight": 1.5,
		"shipmentDescription": "description of the contents",
		"orderNumber": "ORD-1234567",
		"sendDate": "",
		"holidayDeliveryDay": "workday",
		"paymentSenderMethod": "cash"
	},

	"requestCourierTimeFrom": "",
	"requestCourierTimeTo": "",
	"mode": "create"
}
    Response
					{
	"label": {
		"shipmentNumber": "1051603058843",
		"storageOfficeName": null,
		"storagePersonName": null,
		"createdTime": 1635145800000,
		"sendTime": null,
		"deliveryTime": null,
		"shipmentType": "pack",
		"packCount": 1,
		"shipmentDescription": "description of the contents",
		"weight": 1.5,
		"senderDeliveryType": null,
		"senderClient": null,
		"senderAgent": null,
		"senderOfficeCode": null,
		"senderAddress": null,
		"receiverDeliveryType": null,
		"receiverClient": null,
		"receiverAgent": null,
		"receiverOfficeCode": null,
		"receiverAddress": null,
		"cdCollectedAmount": 0,
		"cdCollectedCurrency": "",
		"cdCollectedTime": null,
		"cdPaidAmount": 0,
		"cdPaidCurrency": "",
		"cdPaidTime": null,
		"totalPrice": 7.93,
		"currency": "EUR",
		"discountPercent": 0,
		"discountAmount": -0,
		"discountDescription": "",
		"senderDueAmount": 7.93,
		"receiverDueAmount": 0,
		"otherDueAmount": 0,
		"deliveryAttemptCount": 0,
		"previousShipmentNumber": "",
		"services": [
			{
				"type": "C",
				"description": "Колетна пратка от зона Солун - до 2 кг",
				"count": 1,
				"paymentSide": "SENDER",
				"price": 7.93,
				"currency": "EUR"
			}
		],
		"nextShipments": [],
		"trackingEvents": [],
		"pdfURL": "http:\/\/demo.econt.com\/ee\/api_export.php?exportMethod=printLoading&loading_num=1051603058843&_key=2aa7958979402bbd3dd2f652ca95254c5b6c6260",
		"expectedDeliveryDate": 1635368400000,
		"returnShipmentURL": "https:\/\/delivery-demo.econt.com\/return_shipment.php?_key=eb1eef9c264512cded558cac9d0991e3dae45d5f&return_shipment_num=1051603058843"
	},
	"blockingPaymentURL": null
}


    Using XML 
    Request @ BASE_URL/xml_parcel_import2.php
					<?xml version="1.0"?>
<parcels>
	<system>
		<response_type>XML</response_type>
		<only_calculate>0</only_calculate>
		<validate>0</validate>
	</system>
	<client>
		<username>demo</username>
		<password>demo</password>
	</client>
	<loadings>
		<!-- can contain multiple <row>'s -->
		<row>
			<sender>
				<country_code>GRC</country_code>
				<city>ΠΑΤΡΑ</city>
				<post_code>26221</post_code>
				<address_zip></address_zip>
				<office_code></office_code>
				<name>MARIA PANAGIOTIDI</name>
				<name_person></name_person>
				<email>maria@mail.gr</email>
				<quarter></quarter>
				<street>Athinon</street>
				<street_num>147</street_num>
				<street_bl></street_bl>
				<street_vh></street_vh>
				<street_et></street_et>
				<street_ap></street_ap>
				<street_other></street_other>
				<phone_num>6900000000</phone_num>
			</sender>
			<receiver>
				<country_code>BGR</country_code>
				<city>Варна</city>
				<post_code>9000</post_code>
				<office_code></office_code>
				<name>Фирма ЕООД</name>
				<name_person>Петър Петров</name_person>
				<email>petar@firma.bg</email>
				<quarter></quarter>
				<street>ул. Иван Вазов</street>
				<street_num>1</street_num>
				<street_bl></street_bl>
				<street_vh></street_vh>
				<street_et></street_et>
				<street_ap></street_ap>
				<street_other></street_other>
				<phone_num>0899999999</phone_num>
			</receiver>
			<payment>
				<side>sender</side>
				<method>cash</method>
			</payment>
			<shipment>
				<shipment_type>PACK</shipment_type>
				<description>description of the contents</description>
				<pack_count>1</pack_count>
				<shipment_pack_dimensions_l></shipment_pack_dimensions_l>
				<shipment_pack_dimensions_w></shipment_pack_dimensions_w>
				<shipment_pack_dimensions_h></shipment_pack_dimensions_h>
				<weight>1.5</weight>
				<tariff_sub_code>DOOR_DOOR</tariff_sub_code>
				<delivery_day>workday</delivery_day>
				<order_num>ORD-1234567</order_num>
			</shipment>
		</row>
	</loadings>
</parcels>

    Response
					<?xml version="1.0" encoding="UTF-8"?>
<response>
	<result>
		<e>
			<loading_id>2021100000015090</loading_id>
			<loading_num>1051603059062</loading_num>
			<courier_request_id></courier_request_id>
			<delivery_date>2021-10-28</delivery_date>
			<loading_price>
				<C>7.93</C>
				<total>7.93</total>
				<sender_total>7.93</sender_total>
				<receiver_total>0</receiver_total>
				<other_total>0</other_total>
				<currency>€</currency>
				<currency_code>EUR</currency_code>
			</loading_price>
			<loading_discount>
				<amount>0</amount>
				<description/>
			</loading_discount>
			<error></error>
			<error_code></error_code>
			<pdf_url>http://demo.econt.com/ee/api_export.php?exportMethod=printLoading&amp;loading_num=1051603059062&amp;_key=ab7878794eaa6e041907098c2e3ab72c02aae8a0&amp;</pdf_url>
			<return_shipment_url>https://delivery-demo.econt.com/return_shipment.php?_key=d2e703a05ba00251742d221a1b6ebe8016eff789&amp;return_shipment_num=1051603059062</return_shipment_url>
			<return_reason/>
			<prev_parcel_num/>
			<next_parcels/>
			<import_rc_code>9000</import_rc_code>
		</e>
	</result>
</response>

  7. Creating a shipment with additional services to Greece

    Using JSON 
    Request @ BASE_URL/Shipments/LabelService.createLabel.json
					{
	"label": {
		"senderClient": {
			"name": "Фирма ЕООД",
			"nameEn": "Firma EOOD",
			"phones": [
				"0888888888"
			],
			"email": "info@firma.bg",
			"skypeAccounts": [],
			"clientNumber": "",
			"clientNumberEn": "",
			"juridicalEntity": "",
			"personalIDType": "",
			"personalIDNumber": "",
			"companyType": "",
			"ein": "123456789",
			"ddsEinPrefix": "BG",
			"ddsEin": "BG123456789",
			"registrationAddress": "",
			"molName": "Ivan Ivanov",
			"molEGN": "",
			"molIDNum": ""
		},
		"senderAgent": {
			"name": "Петър Петров",
			"nameEn": "Petar Petrov",
			"phones": [
				"0899999999"
			],
			"email": "petar@firma.bg"
		},
		"senderAddress": {
			"city": {
				"id": "",
				"country": {
					"code3": "BGR"
				},
				"postCode": "9000",
				"name": "Варна",
				"nameEn": "Varna"
			},
			"fullAddress": "",
			"quarter": "",
			"street": "ул. Иван Вазов",
			"num": "1",
			"other": ""
		},
		"senderOfficeCode": "",
		"receiverClient": {
			"name": "MARIA PANAGIOTIDI",
			"nameEn": "MARIA PANAGIOTIDI",
			"phones": [
				"6900000000"
			],
			"email": "maria@mail.gr"
		},
		"receiverAgent": "",
		"receiverAddress": {
			"city": {
				"id": "",
				"country": {
					"code3": "GRC"
				},
				"postCode": "26221",
				"name": "ΠΑΤΡΑ",
				"nameEn": "PATRA",
				"regionName": "ΑΧΑΪΑΣ",
				"regionNameEn": "ACHAIAS"
			},
			"fullAddress": "",
			"quarter": "",
			"street": "Athinon",
			"num": "147",
			"other": "",
			"zip": "26442" //it is recommended to provide ZIP code
			//which is different than the city post code
		},
		"receiverOfficeCode": "",
		"packCount": 1,
		"shipmentType": "PACK",
		"weight": 1.5,
		"shipmentDescription": "description of the contents",
		"orderNumber": "ORD-1234567",
		"sendDate": "",
		"holidayDeliveryDay": "workday",
		"paymentReceiverMethod": "cash",
		"services": {
			"declaredValueAmount": 199.99,
			"declaredValueCurrency": "EUR",
			"cdAmount": 199.99,
			"cdType": "get",
			"cdCurrency": "EUR",
			"cdPayOptions": {
				"method": "office",
				"officeCode": 9005,
				"client": {
					"name": "Петър Петров",
					"nameEn": "Petar Petrov",
					"phones": [
						"0899999999"
					],
					"email": "petar@firma.bg"
				}
			}
		}
	},

	"requestCourierTimeFrom": "",
	"requestCourierTimeTo": "",
	"mode": "create"
}
    Response
					{
	"label": {
		"shipmentNumber": "3000000009000",
		"storageOfficeName": null,
		"storagePersonName": null,
		"createdTime": 1635154953000,
		"sendTime": null,
		"deliveryTime": null,
		"shipmentType": "pack",
		"packCount": 1,
		"shipmentDescription": "description of the contents",
		"weight": 1.5,
		"senderDeliveryType": null,
		"senderClient": null,
		"senderAgent": null,
		"senderOfficeCode": null,
		"senderAddress": null,
		"receiverDeliveryType": null,
		"receiverClient": null,
		"receiverAgent": null,
		"receiverOfficeCode": null,
		"receiverAddress": null,
		"cdCollectedAmount": 0,
		"cdCollectedCurrency": "",
		"cdCollectedTime": null,
		"cdPaidAmount": 0,
		"cdPaidCurrency": "",
		"cdPaidTime": null,
		"totalPrice": 18.85,
		"currency": "EUR",
		"discountPercent": 0,
		"discountAmount": 0,
		"discountDescription": "",
		"senderDueAmount": 0,
		"receiverDueAmount": 18.85,
		"otherDueAmount": 0,
		"deliveryAttemptCount": 0,
		"previousShipmentNumber": "",
		"services": [
			{
				"type": "C",
				"description": "Колетна пратка до зона Солун - до 2 кг",
				"count": 1,
				"paymentSide": "RECEIVER",
				"price": 7.93,
				"currency": "EUR"
			},
			{
				"type": "OC",
				"description": "Обявена стойност",
				"count": 199.99,
				"paymentSide": "RECEIVER",
				"price": 1,
				"currency": "EUR"
			},
			{
				"type": "CD",
				"description": "Наложен платеж",
				"count": 391.15,
				"paymentSide": "RECEIVER",
				"price": 9.92,
				"currency": "EUR"
			}
		],
		"nextShipments": [],
		"trackingEvents": [],
		"pdfURL": "http:\/\/demo.econt.com\/ee\/api_export.php?exportMethod=printLoading&loading_num=3000000009000&_key=db0622300dd4961c2c96df40450d62bb40a6605d",
		"expectedDeliveryDate": 1635368400000,
		"returnShipmentURL": "https:\/\/delivery-demo.econt.com\/return_shipment.php?_key=f0765ac9e4dfc22c26aea81eda7dcba290f92830&return_shipment_num=3000000009000"
	},
	"blockingPaymentURL": null
}


    Using XML 
    Request @ BASE_URL/xml_parcel_import2.php
					<?xml version="1.0"?>
<parcels>
	<system>
		<response_type>XML</response_type>
		<only_calculate>0</only_calculate>
		<validate>0</validate>
	</system>
	<client>
		<username>****</username>
		<password>****</password>
	</client>
	<loadings>
		<!-- can contain multiple <row>'s -->
		<row>
			<sender>
				<country_code>BGR</country_code>
				<city>Варна</city>
				<post_code>9000</post_code>
				<office_code></office_code>
				<name>Фирма ЕООД</name>
				<name_person>Петър Петров</name_person>
				<email>petar@firma.bg</email>
				<quarter></quarter>
				<street>ул. Иван Вазов</street>
				<street_num>1</street_num>
				<street_bl></street_bl>
				<street_vh></street_vh>
				<street_et></street_et>
				<street_ap></street_ap>
				<street_other></street_other>
				<phone_num>0899999999</phone_num>
				<email_on_delivery></email_on_delivery>
			</sender>
			<receiver>
				<country_code>GRC</country_code>
				<city>ΠΑΤΡΑ</city>
				<post_code>26221</post_code>
				<!-- it is recommended to provide ZIP code below -->
				<address_zip>26442</address_zip>
				<office_code></office_code>
				<name>MARIA PANAGIOTIDI</name>
				<name_person></name_person>
				<email>maria@mail.gr</email>
				<quarter></quarter>
				<street>Athinon</street>
				<street_num>147</street_num>
				<street_bl></street_bl>
				<street_vh></street_vh>
				<street_et></street_et>
				<street_ap></street_ap>
				<street_other></street_other>
				<phone_num>6900000000</phone_num>
			</receiver>
			<payment>
				<side>sender</side>
				<method>cash</method>
			</payment>
			<shipment>
				<shipment_type>PACK</shipment_type>
				<description>description of the contents</description>
				<pack_count>1</pack_count>
				<shipment_pack_dimensions_l></shipment_pack_dimensions_l>
				<shipment_pack_dimensions_w></shipment_pack_dimensions_w>
				<shipment_pack_dimensions_h></shipment_pack_dimensions_h>
				<weight>1.5</weight>
				<tariff_sub_code>DOOR_DOOR</tariff_sub_code>
				<delivery_day>workday</delivery_day>
				<order_num>ORD-1234567</order_num>
			</shipment>
			<services>
				<oc>199.99</oc>
				<oc_currency>EUR</oc_currency>
				<cd type="GET">199.99</cd>
				<cd_currency>EUR</cd_currency>
				<cd_pay_options>
					<name>Петър Петров</name>
					<phone>0899999999</phone>
					<email>petar@firma.bg</email>
					<method>office</method>
					<office_code>9005</office_code>
				</cd_pay_options>
			</services>
		</row>
	</loadings>
</parcels>

    Response
					<?xml version="1.0" encoding="UTF-8"?>
<response>
	<result>
		<e>
			<loading_id>2021100000015083</loading_id>
			<loading_num>3000000009017</loading_num>
			<courier_request_id></courier_request_id>
			<delivery_date>2021-10-28</delivery_date>
			<loading_price>
				<C>15</C>
				<OC>1.88</OC>
				<CD>18.78</CD>
				<total>35.66</total>
				<sender_total>35.66</sender_total>
				<receiver_total>0</receiver_total>
				<other_total>0</other_total>
				<currency>лв</currency>
				<currency_code>BGN</currency_code>
			</loading_price>
			<loading_discount>
				<amount>0.01</amount>
				<description/>
			</loading_discount>
			<CD_percent>4.8</CD_percent>
			<error></error>
			<error_code></error_code>
			<pdf_url>http://demo.econt.com/ee/api_export.php?exportMethod=printLoading&amp;loading_num=3000000009017&amp;_key=ea25aebab4ddcc09d08109278dde7203402f06ce&amp;</pdf_url>
			<return_shipment_url>https://delivery-demo.econt.com/return_shipment.php?_key=edf0df094af24ed670d727ab09b59237770daaf7&amp;return_shipment_num=3000000009017</return_shipment_url>
			<return_reason/>
			<prev_parcel_num/>
			<next_parcels/>
			<import_rc_code>50090</import_rc_code>
		</e>
	</result>
</response>
Econt Express Ltd. 2021 www.econt.com >