EEcont:

  1. Model
  2. EEcont
  3. Nomenclatures

http://ee.econt.com/services/Nomenclatures

Data types:

Country (Class)

Country. Required fields for valid country - ID or code (code2 or code3)
Name Type Multiplicity Description
id int [0..1]
code2 string [0..1]
ISO 3166-1 alpha-2 code (e.g. BG, GB, GR)
code3 string [0..1]
ISO 3166-1 alpha-3 code (e.g. BGR ,GBR, GRC)
name string [0..1]
The bulgarian name of the country
nameEn string [0..1]
The international name of the country
isEU boolean [0..1]
True if country is a member of the EU

Address (Class)

Address. Required fields for valid address - city, street and street number (or quarter and other). Use respective fields or all joined together in the field <fullAddress>
Name Type Multiplicity Description
id int [0..1]
city City [0..1]
The city where the address is located
fullAddress string [0..1]
The whole address
fullAddressEn string [0..1]
The whole address in English
quarter string [0..1]
Quarter name
street string [0..1]
Street name
num string [0..1]
Street number
other string [0..1]
Block number, entrance number, floor, apartment number and other additional information
location GeoLocation [0..1]
Geo coordinates
zip string [0..1]
ZIP code
hezid string [0..1]

City (Class)

City served by Econt Express. Required fields for valid city - ID or name + post code (if the City is outside Bulgaria, country is required)
Name Type Multiplicity Description
id int [0..1]
country Country [0..1]
The country where the city is located
postCode string [0..1]
Post code
name string [0..1]
Bulgarian name
nameEn string [0..1]
International name
regionName string [0..1]
Bulgarian name of the region
regionNameEn string [0..1]
International name of the region
phoneCode string [0..1]
The phone prefix code for the city
location GeoLocation [0..1]
Geo location
expressCityDeliveries boolean [0..1]
Indicates if express city deliveries are available
monday boolean [0..1]
Indicates if the city is serviced on Monday
tuesday boolean [0..1]
Indicates if the city is serviced on Tuesday
wednesday boolean [0..1]
Indicates if the city is serviced on Wednesday
thursday boolean [0..1]
Indicates if the city is serviced on Thursday
friday boolean [0..1]
Indicates if the city is serviced on Friday
saturday boolean [0..1]
Indicates if the city is serviced on Saturday
sunday boolean [0..1]
Indicates if the city is serviced on Sunday
serviceDays int [0..1]
Number of days needed to deliver to this city.
zoneId int [0..1]
Id of the zone in which the city is located.
zoneName string [0..1]
Name of the zone in which the city is located.
zoneNameEn string [0..1]
International name of the zone in which the city is located.
servingOffices ServingOfficeElement [0..n]
Offices and types of shipments they serve

Office (Class)

Office of Econt Express. Required fields for identifying an office - code or ID
Name Type Multiplicity Description
id int [0..1]
code string [0..1]
A code identifying the office
isMPS boolean [0..1]
True if the office is a mobile post station
isAPS boolean [0..1]
True if the office is an automatic post station
name string [0..1]
The bulgarian name of the office
nameEn string [0..1]
The international name of the office
phones string [0..n]
A list of phone numbers for the office
emails string [0..n]
A list of email addresses for the office
address Address [0..1]
The address where the office is located
info string [0..1]
Additional information
currency string [0..1]
The currency the office works with
language string [0..1]
The language the office works with
normalBusinessHoursFrom time [0..1]
Business hours for parcel pickup and delivery from/to an address on weekdays
normalBusinessHoursTo time [0..1]
Business hours for parcel pickup and delivery from/to an address on weekdays
halfDayBusinessHoursFrom time [0..1]
Business hours for parcel pickup and delivery from/to an address on saturdays
halfDayBusinessHoursTo time [0..1]
Business hours for parcel pickup and delivery from/to an address on saturdays
shipmentTypes ShipmentType [0..n]
Types of shipments which can be sent/collected to/from the office
partnerCode string [0..1]
Partner code
hubCode string [0..1]
Code of the distribution center associated with the office
hubName string [0..1]
Name of the distribution center associated with the office
hubNameEn string [0..1]
International name of the distribution center associated with the office
isDrive boolean [0..1]
True if the office is a Econt Drive

Quarter (Class)

Quarter of the city
Name Type Multiplicity Description
id int [0..1]
cityID int [0..1]
ID of the city
name string [0..1]
Bulgarian name of the quarter
nameEn string [0..1]
International name of the quarter

GeoLocation (Class)

A geographic location
Name Type Multiplicity Description
latitude double [0..1]
Geographic coordinate that specifies the north–south position of a point on the Earth's surface
longitude double [0..1]
Geographic coordinate that specifies the east-west position of a point on the Earth's surface
confidence int [0..1]
The expected accuracy of the location: 0-none, there are either no coordinates or the coordinates do not represent the location; 1-low; 2-medium; 3-high;

Street (Class)

Street in the city
Name Type Multiplicity Description
id int [0..1]
cityID int [0..1]
ID of the city
name string [0..1]
Bulgarian name of the street
nameEn string [0..1]
International name of the street

WorkingTime (Class)

Working hours span
Name Type Multiplicity Description
start string [0..1]
end string [0..1]

WorkingDateTime (Class)

Working date and hours span
Name Type Multiplicity Description
dayType dayType [0..1]
day string [0..1]
start string [0..1]
end string [0..1]

dayType (Enumeration)

Value Description
workday
halfday
holiday

ServingOfficeElement (Class)

Name Type Multiplicity Description
officeCode string [0..1]
Office code
servingType string [0..1]
The possible service types are as follows - from_door_courier ,to_door_courier, from_office_courier, to_office_courier, from_door_cargo, to_door_cargo, from_office_cargo, to_office_cargo, from_door_post, to_door_post, from_office_post, to_office_post, code1, from_door_cargo_expres, to_door_cargo_expres, from_office_cargo_expres, to_office_cargo_expres, to_door_trans_pallet, to_office_trans_pallet

AddressServiceInfo (Class)

Name Type Multiplicity Description
allowedPacksCourierRequest boolean [0..1]
Marker if this address can be serviced by courier to pick up a pack shipment
deliveryPacksExtraDelayDays int [0..1]
Indicates how many extra days are needed for a pack shipment to be delivered to the address
allowedCargoCourierRequest boolean [0..1]
Marker if this address can be serviced by courier to pick up a cargo shipment
deliveryCargoExtraDelayDays int [0..1]
Indicates how many extra days are needed for a cargo shipment to be delivered to the address
allowedPalletCourierRequest boolean [0..1]
Marker if this address can be serviced by courier to pick up a pallet shipment
deliveryPalletExtraDelayDays int [0..1]
Indicates how many extra days are needed for a pallet shipment to be delivered to the address

Services:

NomenclaturesService (Interface)

endpoints: soap json

getCountries (Method)

All countries where Econt Express operates (see SOAP example Request, Response) (see JSON example Request, Response)
Parameters
Name Type Multiplicity Description
Result
Name Type Multiplicity Description
countries Country [0..n]
Name of the country
Faults
Type Description
Error
Generic error
endpoints: soap json

getCities (Method)

Method for requesting the cities in a country (see SOAP example Request, Response) (see JSON example Request, Response)
Parameters
Name Type Multiplicity Description
countryCode string [0..1]
Three-letter ISO Alpha-3 code of the country (e.g. AUT, BGR, etc.)
Result
Name Type Multiplicity Description
cities City [0..n]
All cities in the requested country code(s)
Faults
Type Description
Error
Generic error
endpoints: soap json

getOffices (Method)

All offices of Econt Express in a country (see SOAP example Request, Response) (see JSON example Request, Response)
Parameters
Name Type Multiplicity Description
countryCode string [0..1]
Three-letter ISO Alpha-3 code of the country (e.g. AUT, BGR, etc.)
cityID int [0..1]
ID of the city (optional)
showCargoReceptions boolean [0..1]
Show cargo reception offices.
showLC boolean [0..1]
Show logistic center offices.
servingReceptions boolean [0..1]
Show offices witch serving the city from reception.
Result
Name Type Multiplicity Description
offices Office [0..n]
Information about offices (name, address, working hours, coordinates, etc.)
Faults
Type Description
Error
Generic error
endpoints: soap json

getStreets (Method)

Requests all streets in a city (see SOAP example Request, Response) (see JSON example Request, Response)
Parameters
Name Type Multiplicity Description
cityID int [0..1]
ID of the city (optional)
Result
Name Type Multiplicity Description
streets Street [0..n]
Street names
Faults
Type Description
Error
Generic error
endpoints: soap json

getQuarters (Method)

Request all quarters in a city (see SOAP example Request, Response) (see JSON example Request, Response)
Parameters
Name Type Multiplicity Description
cityID int [0..1]
ID of the city (optional)
Result
Name Type Multiplicity Description
quarters Quarter [0..n]
Name of the quarter
Faults
Type Description
Error
Generic error

AddressService (Interface)

endpoints: soap json

validateAddress (Method)

Validates address based on input parameters (see SOAP example Request, Response) (see JSON example Request, Response)
Parameters
Name Type Multiplicity Description
address Address [0..1]
Address (minimum required parameters: city name, street name and street number or quarter and other)
Result
Name Type Multiplicity Description
address Address [0..1]
Address details (country, location, etc.)
validationStatus string [0..1]
Normal, processed, invalid
serviceInfo AddressServiceInfo [0..1]
Faults
Type Description
Error
Generic error
endpoints: soap json

addressServiceTimes (Method)

Geolocates an address and provides service times for that address.
Parameters
Name Type Multiplicity Description
city int [0..1]
ID of the city - check getCities method.
address string [0..1]
Address to check for servicing
date date [0..1]
The date for which to check servicing
shipmentType ShipmentType [0..1]
Result
Name Type Multiplicity Description
serviceOffice Office [0..1]
serviceOfficeLatitude double [0..1]
Service office geo location latitude
serviceOfficeLongitude double [0..1]
Service office geo location longitude
serviceOfficeClientsWorkTimes WorkingTime [0..n]
List of time spans available for working with clients
serviceOfficeCourierWorkTimes WorkingTime [0..n]
List of time spans available for courier request
serviceOfficeTime WorkingDateTime [0..1]
Service time for the requested date
serviceOfficeNext30daysWorkTime WorkingDateTime [0..n]
List of working times for future dates.
Faults
Type Description
Error
Generic error
endpoints: soap json

getNearestOffices (Method)

Information service for offices near given address
Parameters
Name Type Multiplicity Description
address Address [0..1]
Аddress
shipmentType ShipmentType [0..1]
Shipment type
Result
Name Type Multiplicity Description
offices Office [0..n]
List of offices
Faults
Type Description
Error
Generic error