API Documentation
Back to top  

DSoapServerClass

WSDL Path: Production system : https://system.dynamicexpress.eu/schema.wsdl

IMPORTANT! In each SOAP request, it is mandatory to submit parameter for identification.
Example:
$loginparam = new stdClass();
$loginparam->user = '*******';
$loginparam->pass = '*******';
IMPORTANT! SOAP account is different than the account for my.dynamicexpress.eu
IMPORTANT! If you make more than 60 requests per minute, your IP will be blocked for 30 minutes.
IMPORTANT! All required parameters are marked with !R!

main Methods:



For getting information about parameters in generating way-bills:

getMyObjectInfo ---> Company Object ---> Returns information about client's main "office" object
getMyObjects ---> Returns a list of customer sites
getServices ---> Returns a list of services
getSubServices ---> Returns a list of the execution time depending on selected service
getCountries ---> Returns a list of countries
getCityes ---> Returns a list of all sites for country. In case no country is specified, the method default returns cities in Bulgaria
getStreets ---> Returns a list of streets matching the search criteria.
checkCityFixChas ---> Checking for fixed delivery option
getOfficesCity ---> List of offices for a particular location (used for "on-demand
getOfficesCord ---> Get offices by given parameters for location


Creating Way-Bills:

create_order ---> Create a new way-bill
print_pdf ---> Returns bill of lading in PDF format
print_int_pdf ---> Returns international bill of lading in PDF format
requestCurier ---> Order confirmation and courier request
cancellTovaritelnica ---> Canceling Way-bill


Tracking, checking status, etc.:

track_order ---> Tracking of a shipment
track_order_ref ---> Tracking by ref number
track_order_array ---> Tracking for more than one way-bill
track_order_ref_array ---> Track by reference
getTovarInfo ---> Returns information for bill of lading
getTovarInfoTid ---> information by given ID, not way-bill
track_request ---> Tracking by order ID (not way-bill, but it's ID)
checkOrders ---> Checking whether delivered one (or more) bill of lading
checkOrdersStatus ---> Check delivered status for way-bills
getReturnRedirect ---> info about return/redirect


COD and financial information:

getTovarFinInfo ---> returns financial info about Way-bill
getRazhodOrderInfo ---> Returns information about cash on delivery order
getNPInfo ---> Return information for payed COD, based on given way-bill number
getRazhodOrderInfoPMT ---> Way-bills in COD payment document
getRazhodOrders ---> information about COD order documents information
getTovarCurrencyInfo ---> Returns information about the COD currency changes, for international parcels
getInvoices ---> check invoices information


Functional information, used mainly by users:

calculate ---> Verification the cost for the service
listSites ---> Returns a list of cities that meet the appropriate search filter.
setPrintSettings ---> This method is used for setting printing preferences


Others:

getSoapCouriers ---> Return list of couriers, used by some special cases Clients
updateParcelsWeight ---> update parcels weight


Google map tool for getting office

We offer tool for our clients, where they can show in theyr sites to their customers, a map with pins for all offices
Here is the link, which our client can use in theyr sites:
Link
Clients can provide at this url:
- mapheight - how much percent space can use the map on the current div html container
- lat - the lattitude of the point
- lng - the longitude of the point
- zoomlvl = how much zoomed map you need when loaded
- language = the language of the map
-- options for language: English - en, Bulgarian - bg Greek - gr, Romanian - ro, Russian - ru, German - de, Polish - pl, Czech - cs, Slovak - sk, Hungarian - hu. If no language is defined, the default is English

When loaded, the map shows pins with all the offices around the point
When a user pick a point. there is information for the selected pin about the office at that destination.
User can chose that office, and when he chose it, a callback function is setting an ID, which is used to select that same office, for sending the shipment.

package Default

 Methods

calculate - Client can check costs

calculate(object $loginparam, array $calculation) : array | \Exception

Verification the cost for the service (price of the bill of lading)

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******';

$client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $myPriceArray = array(); $myPriceArray['service']=1; // value is taken with getServices Method. Here 1 is -> -> "Бързи градски услуги" (fast urban services) $myPriceArray['subservice']=18; // value is taken with getSubServices Method. -> -> Here 18 is "48 часа икономична" (48h economical) $myPriceArray['fix_chas']=0; // 0(zero) or 1 (1 if there will be fixed delivery, 0 if not) $myPriceArray['return_receipt']=0; // 0(zero) or 1 (1 if there will be return reciept, 0 if not) $myPriceArray['return_doc']=0; // 0(zero) or 1 (1 if there will be return document, 0 if not) $myPriceArray['nal_platej']=50; // COD(cash on delivery). 0(zero) if there is no COD. -> -> USE "."(dot) for decimals! $myPriceArray['zastrahovka']=50; // Insurance Value. 0(zero) if there is no insurance. -> -> USE "."(dot) for decimals! $myPriceArray['teglo']=2.5; // Weigth in kg. CAN'T be 0(zero). Use "."(dot) for decimals. $myPriceArray['country_b']=100; // ID of the country(ISO standart). -> -> Required only for international delivery $client->calculate($loginparam,$myPriceArray);

Parameters

$loginparam

object

!R! Authentication parameter with username and password

$calculation

array

!R!

Array with the following indexes:

  • !R! service [INT32] ServiceID, it is obtained with the getServices Method
  • !R! subservice [INT32] SubserviceID, it is obtained with the getSubServices Method
  • !R! fix_chas [SMALLINT] 0 or 1 for Fixed hour service (1 means active)
  • !R! return_receipt [SMALLINT] 0 or 1 for Return receipt service (1 means active)
  • !R! return_doc [SMALLINT] 0 or 1 for Return documents service (1 means active)
  • !R! nal_platej [NUMERIC 8,2] COD (cash on delivery); Use dot "." for decimal symbol; 0(zero), if no COD
  • !R! zastrahovka [NUMERIC 8,2] Insurance ; Use dot "." for decimal symbol; 0(zero), if no Insurance
  • !R! teglo [NUMERIC 8,3] Weight; Use dot "." for decimal symbol; Can't be 0(zero)
  • count [INT32] Pack or pallet count
  • country_b [INT32] Country ID of the recipient; required only for international delivery

Returns

array\Exception

Array with the following indexes:
  • 'PERROR' - Message for exception, 0(zero) if all the data is correct.

  • 'fix_chas' - Fixed-hour commission value

  • 'return_receipt' - Return reciept commission value

  • 'return_doc' - Return documents commission value

  • 'nal_platej' - COD(cash on delivery) commission value

  • 'zastrahovka' - Insurance commission value

  • 'tax_usluga' - Value of the service

  • 'DDS' - VAT value

  • 'TOTAL' - Calculated total

cancellTovaritelnica - Canceling Way-bill

cancellTovaritelnica(object $loginparam, $tovaritelnica) : boolean | \Exception

Used to cancel submitted way-bill, that won't be used for a parcel and won't be sent for delivery

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $number = 12345678; //example for given number of way-bill $client->cancellTovaritelnica($loginparam,$number);

Parameters

$loginparam

object

!R! - Authentication parameter with username and password

$tovaritelnica

Returns

boolean\Exception

checkCityFixChas - Checking for fixed delivery option

checkCityFixChas(object $loginparam, string $siteid) : string | \Exception

Method used for checking if there is possibility for fixed hour delivery in a given siteID of a city

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $siteid = 68134; //example for siteid Sofia of receiver $client->checkCityFixChas($loginparam, $siteid);

Parameters

$loginparam

object

!R! - Authentication parameter with username and password

$siteid

string

!R! - siteid of the city, where the shipment would be delivered

Returns

string\Exception
Returns:
  • 1 - There is possibility for fixed delivery
  • 0 - There is no possibility for fixed delivery

checkOrders - Check delivery for given way-bill numbers

checkOrders(object $loginparam, array $nomera) : array | \Exception

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $myArr = [12345678, 87654321]; //array with numbers of way-bills $client->checkOrders($loginparam, $myArr);

Parameters

$loginparam

object

!R! - Authentication parameter with username and password

$nomera

array

!R! - array with numbers of way-bills

Returns

array\Exception
Returns associative array with $key => $value pairs which are:

  • [number of way-bill] => 'true' - when the waybill is delivered
  • [number of way-bill] => 'false' - when the waybill is not delivered
  • [number of way-bill] => 'N/A' - when the waybill is not created by this client

checkOrdersStatus - Check delivered status for way-bills

checkOrdersStatus(object $loginparam, array $nomera) : array | \Exception

Returns information about the current status for given array of way-bills

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $myArr = [12345678, 87654321]; //array with numbers of way-bills $client->checkOrdersStatus($loginparam, $myArr);

Parameters

$loginparam

object

!R! - Authentication parameter with username and password

$nomera

array

!R! - array with numbers of way-bills

Returns

array\Exception
Returns associative array with $key => $value pairs which are:

  • [number of way-bill] => string with information about status - when the waybill is delivered
  • [number of way-bill] => 'N/A' - when the waybill is not created by the client

create_order - Creating way-bill

create_order(object $loginparam, array $order_info) : array | \Exception

Creating way-bill.

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $order_info = array(); $order_info['service'] = 1; // [INT32] Here 1 is "Бързи градски услуги" (fast urban services) $order_info['subservice'] = 18; // [INT32] Here 18 is "48 часа икономична" (48h economical) $order_info['SENDOFFICE'] = 123456; // example for id for the senders's office from which -> -> the shipment would be sent $order_info['nal_platej'] = 22.30; // [NUMERIC 8,2] COD Value. 0(zero) if there is no COD. -> -> USE "."(dot) for decimals! $order_info['zastrahovka'] = 20; // [NUMERIC 8,2] Insurance value. -> 0(zero) if there is no insurance. USE "."(dot) for decimals! $order_info['CONTENT'] = 'резервни части'; // [VARCHAR 200] Text with information -> -> about the content $order_info['CHUPLIVO'] = 1; // [SMALLINT] - Fragile marker 0 or 1 (1 if content is fragile) $order_info['teglo'] = 3.5; // [NUMERIC 8,3] Weight in kg. -> -> CAN'T be 0(zero). Use "."(dot) for decimals. $order_info['RECEIVER'] = 'ФИРМА ООД'; // [VARCHAR 150] Receiver's name $order_info['COUNTRY_B'] = 100; // [INT32] Country ID of receiver(ISO standart). Bulgaria is 100 $order_info['CITY_B'] = 'СОФИЯ'; // [VARCHAR 50] City name of receiver $order_info['SITEID_B'] = 68134; // [INT32] City ID of receiver $order_info['PK_B'] = '1000'; // [VARCHAR 5] Post code of receiver $order_info['STREET_B'] = 'УЛ. ЧЕРКОВНА'; // [VARCHAR 50] Street name of receiver $order_info['STREETB_ID'] = 3268; // [INT32] Street ID of receiver $order_info['STREETB_TYPE'] = 1; // [INT32] Receiver's street type - 1 for street; -> -> 2 for quarter(Neighborhood) $order_info['STREET_NO_B'] = '33А'; // [VARCHAR 5] Receiver's street number - used if STREETB_TYPE is set to '1' $order_info['BLOCK_B'] = ''; // [VARCHAR 5] Receiver's block number - -> -> used if STREETB_TYPE is set to '2' $order_info['ENTRANCE_B'] = 'А'; // [VARCHAR 3] Receiver's entrance number $order_info['FLOOR_B'] = '4'; // [VARCHAR 10] Receiver's floor $order_info['APARTMENT_B'] = '45'; // [VARCHAR 3] Receiver's apartment number $order_info['ADDITIONAL_INFO_B'] = ''; // [VARCHAR 250] Receiver's additional -> -> information for delivery $order_info['PHONE_B'] = '35920000000'; // [VARCHAR 40] Receiver's phone $order_info['CPERSON_B'] = 'ИВАН ИВАНОВ'; // [VARCHAR 100] Contact person for receiver $order_info['fix_chas'] = 'ТОЧНО:14:30'; // [VARCHAR 40] fixed hour delivery service $order_info['return_receipt'] = 1; // [SMALLINT] Return receipt $order_info['return_doc'] = 0; // [SMALLINT] Return documents $order_info['PACK_COUNT'] = 1; // [SMALLINT] Pack or pallet count $order_info['SUBOTEN_RAZNOS'] = 0; // [SMALLINT] Saturday delivery. $order_info['CHECK_BEFORE_PAY'] = 0; // [SMALLINT] Check content on delivery, before pay. $order_info['CLIENT_REF1'] = '456454534'; //[VARCHAR 30] Client reference number. //UKRAINE example $order_info['UAFORM'][0][count] = 2; $order_info['UAFORM'][0][countryCode] = 'BG'; $order_info['UAFORM'][0][customCode] = 51021100; $order_info['UAFORM'][0][name] = 'dress'; $order_info['UAFORM'][0][nameUk] = 'плаття'; $order_info['UAFORM'][0][productEan] = '49122235564126'; $order_info['UAFORM'][0][productSize] = 'm'; $order_info['UAFORM'][0][value] = 50; $order_info['UAFORM'][0][weight] = 0.255;

return $client->create_order($loginparam,$order_info);

Parameters

$loginparam

object

!R! Authentication parameter with username and password

$order_info

array

!R!

Array with the following indexes:

  • !R! 'service' [INT32] - ServiceID, it is obtained with the getServices Method
  • !R! 'subservice' [INT32] - SubserviceID, it is obtained with the getSubServices Method
  • 'SENDOFFICE' [SMALLINT] - id for sender's office, if it would be different from the default office
  • 'nal_platej' [NUMERIC 8,2] - COD (cash on delivery); Use dot "." for decimal symbol; 0(zero), if no COD
  • 'zastrahovka [NUMERIC 8,2] - Insurance ; Use dot "." for decimal symbol; 0(zero), if no Insurance
  • !R! 'CONTENT' [VARCHAR 200] - Contents
  • 'CHUPLIVO' [SMALLINT] - Fragile marker. Set to '1' to mark that content of a parcel is fragile
  • !R! 'teglo' [NUMERIC 8,3] - Weight; Use dot "." for decimal symbol; Can't be 0(zero)
  • !R! 'RECEIVER' [VARCHAR 150] - Receiver's name
  • !R! 'COUNTRY_B' [INT32] - Country ID of receiver

    • !!! IF PARCEL IS FOR RECEIVER IN UKRAINE, THERE IS SEPARATE INDEX, WHICH HAVE TO BE GIVEN.
    !!! Another important thing is that here must be placed information about every item in the package (ITS CUSTOMS DEMAND)
  • !R! 'UAFORM' [array] - Array with arrays for every item in a package
  • !R! [UAFORM][0] - Array with info for an item in the package:
    - !R!'count' - count of that item
    - !R!'countryCode' - country code where the item is produced
    - !R!'customCode' - customs code of the item
    - !R!'name' - name of the item (it can be in English or Russian language)
    - !R!'nameUk' - name of the item in Ukrainian language
    - !R!'productEan' - EAN (bar code) code of the item
    - !R!'productSize' - size of the item (example: s,m,l,xl ...etc)
    - !R!'value' - value of the item in UAH currency
    - !R!'weight' - weight of the item

  • !R! 'CITY_B' [VARCHAR 50] - City name of receiver
  • !R! 'SITEID_B' [INT32] - City ID of receiver
  • !R! 'PK_B' [VARCHAR 5] - Post code of receiver
  • 'STREET_B' [VARCHAR 50] - Street name of receiver
  • 'STREETB_ID' [INT32] - Street ID of receiver
  • 'STREETB_TYPE' [SMALLINT] - Receiver's street type - 1 for street; 2 for quarter(Neighborhood)
  • 'STREET_NO_B' [VARCHAR 5] - Receiver's street number - used if STREETB_TYPE is set to '1'
  • 'BLOCK_B' [VARCHAR 10] - Receiver's block number - used if STREETB_TYPE is set to '2'
  • 'ENTRANCE_B' [VARCHAR 6] - Receiver's entrance number
  • 'FLOOR_B' [VARCHAR 10] - Receiver's floor
  • 'APARTMENT_B' [VARCHAR 10] - Receiver's apartment number
  • 'ADDITIONAL_INFO_B' [VARCHAR 250] - Receiver's additional information for delivery
  • !R! 'PHONE_B' [VARCHAR 40] - Receiver's phone
  • 'CPERSON_B' [VARCHAR 100] - Contact person for receiver
  • 'fix_chas' [VARCHAR 40] -Fix hour delivery - This is a 3 part string - First is one of the words:
    - 'ПРЕДИ'(meaning 'Before'), 'ТОЧНО'(Exactly) or 'СЛЕД'(After). One of the chosen, followed by ':'.
    - Integer number from 10 to 17, followed by ':' (We use it for taking the hour for fix delivery)
    - Last is the minutes, here you have to chose between '00', '15', '30' or '45'
    Example:'ПРЕДИ:15:30'(Meaning delivery before 15:30).
    * First possible fixed delivery is 10:30. It cant be before that hour.
  • !R! 'return_receipt' [SMALLINT] - 0 or 1 for Return receipt service (1 means active)
  • !R! 'return_doc' [SMALLINT] - 0 or 1 for Return documents service (1 means active)
  • !R! 'PACK_COUNT' [SMALLINT] - Pack or pallet count
  • 'CLIENT_REF1' [VARCHAR 30] - Client reference number. Usually client put here unique number of order from site, or unique art.number of the content or invoice number. Helps for tracking and reporting
  • 'TAKEOFFICE' [VARCHAR 5] - ID of the office for "Delivery from office" service
  • 'CENOVA_LISTA' [SMALLINT] - Price list. Here there are 3 options:
    - CENOVA_LISTA = 0; - Default value. Price list of the payer
    - CENOVA_LISTA = 1; - Sender's price list
    - CENOVA_LISTA = 2; - Receiver's price list
  • 'REVERSE_ORDER' - Used to give opposite order in the system. It is used by some companies, who have many returns from customers and need to give orders from them. We strongly recommend to be used with separate account, only for those orders. Use 1 for setting this setting to 'Yes' state.
  • 'RETURNSHIPMENT' - Used to set shipment to be taken back, when the current is delivered. Use value 1 to set it to 'Yes' state. Default is 0 - No
  • 'ZASMETKA' [SMALLINT] - 0(zero) - Payer is the sender; 1 - Payer is the receiver
  • 'SUBOTEN_RAZNOS' [SMALLINT] - Saturday delivery. Set to 1 for Saturday delivery
  • 'CHECK_BEFORE_PAY' [SMALLINT] - Check content on delivery, before pay. 1 for 'yes' mark. Can be used only if there is COD.

Returns

array\Exception

Array with the following indexes:
  • 'ERROR' - Empty if everything is O.K. If there is error - you will see information here
  • 'TOVARITELNICA' - The number of the way-bill (Shipment number)
  • 'SUBCONTRACTOR' - The number of Subcontractor's shipment number
  • 'PDF' - PDF of the way-bill. Base64 encoded

getCityes - Returns a list of all sites for country.

getCityes(object $loginparam, integer $country = 100, string $start = 0, string $count = 0) : array | \Exception

In case no country is specified, the method default returns cities in Bulgaria

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $country = 100; // example for country Bulgaria $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $client->getCityes($loginparam,$country);

Parameters

$loginparam

object

!R! Authentication parameter with username and password

$country

integer

!R! Country ID (default:100 - Bulgaria)

$start

string
  • internal use

$count

string
  • internal use

Returns

array\Exception

Array with the following indexes:
  • 'NAME' - Name of the town/city
  • 'COUNTRYID_ISO' - ID of the country
  • 'SITEID' - ID of the town/city
  • 'OBLAST' - District of the town/city
  • 'OBSHTINA' - Municipality of the town/city
  • 'SITETYPE' - Type of the town/city (town, village, holiday village)
  • 'POSTCODE' - Post Code of the town/city
  • 'EKNM' - Unified Classifier of Settlements
  • 'DELIVERYWEEKDAYS' - returns service schedule for the current City
    from Monday to Sunday, the 1 indicate that this day the city is visited.
    First number is for Monday

getCountries - Lists of countries

getCountries(object $loginparam) : array | \Exception
Returns list of countries

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $client->getCountries($loginparam);

Parameters

$loginparam

object

!R! Authentication parameter with username and password

Returns

array\Exception

Array with the following indexes:
  • 'ID' - Country ID (ISO Standart)
  • 'NAME' - Country name

getInvoices - check invoices information

getInvoices(object $loginparam, string $start, string $end) : array | \Exception

Returns information about all invoices, created during given from the client period

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $start = '2018-07-01'; // date in Y-m-d H:i:s format $end = '2018-09-31'; // date in Y-m-d H:i:s format $client->getInvoices($loginparam, $start, $end);

Parameters

$loginparam

object

!R! - Authentication parameter with username and password

$start

string

!R! - the starting date in given format 'Y-m-d H:i:s'

$end

string

!R! - the end date in given format 'Y-m-d H:i:s'

Returns

array\Exception

Returns multidimensional array, each of which indexes is separate information about invoice, and contains array with the following indexes:

  • 'INVOICEID' - the number of the invoice
  • 'CREATED' - date, when the invoice is created
  • 'PAYTYPE' - 0 for cash invoice, 1 for bank invoice
  • 'TCOUNT' - the number of the way-bills in the invoice
  • 'TSUM' - sum without VAT
  • 'DDS' - the value of the VAT
  • 'TOTAL' - total sum of the invoice

getMyObjectInfo - Company Object

getMyObjectInfo(object $loginparam, boolean $sendoffice = 0) : array | \Exception
Returns information about client's main "office" object

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $client->getMyObjectInfo($loginparam);

Parameters

$loginparam

object

!R! Authentication parameter with username and password

$sendoffice

boolean
  • for internal use only

Returns

array\Exception

Array with the following indexes:
  • 'COMPANY' - Name of the client in the system
  • 'F_NAME' - Legal entity of the company in the system
  • 'F_MOL' - accountable person
  • 'F_BULSTAT' - company's number Bulstat
  • 'F_DANNOMER' - tax registry number
  • 'OFFICE' - info about the office in the system
  • 'OFFICENAME' - name of the office
  • 'CITY' - city of the company
  • 'POSTCODE' - Postcode
  • 'STREET' - Name of the street
  • 'STREET_NO' - Street number
  • 'BLOCK' - block number
  • 'ENTRANCE' - entrance
  • 'FLOOR' - floor
  • 'APARTMENT' - apartment
  • 'PHONE' - phone
  • 'ADDITIONAL_INFO' - additional information about the address
  • 'CONTACT_PERSON' - contact person at the address
  • 'SITEID' - id of the city in database
  • 'STREET_TYPE' - street type (street or neighborhood)

getMyObjects - Company Objects

getMyObjects(object $loginparam) : array | \Exception
Returns information about client's "office" objects

Same as getMyObjectInfo, but the returned information is for all the "offices" of the client

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $client->getMyObjects($loginparam);

Parameters

$loginparam

object

!R! Authentication parameter with username and password

Returns

array\Exception

Array with indexes, each of which contains arrays with the following indexes:
  • 'SOAP_OFFICE_ID' - ID of the client's office
  • 'COMPANY' - Name of the client in the system
  • 'F_NAME' - Legal entity of the company in the system
  • 'F_MOL' - accountable person
  • 'F_BULSTAT' - company's number Bulstat
  • 'F_DANNOMER' - tax registry number
  • 'OFFICE' - info about the office in the system
  • 'OFFICENAME' - name of the office
  • 'CITY' - city of the company
  • 'POSTCODE' - Postcode
  • 'STREET' - Name of the street
  • 'STREET_NO' - Street number
  • 'BLOCK' - block number
  • 'ENTRANCE' - entrance
  • 'FLOOR' - floor
  • 'APARTMENT' - apartment
  • 'PHONE' - phone
  • 'ADDITIONAL_INFO' - additional information about the address
  • 'CONTACT_PERSON' - contact person at the address
  • 'SITEID' - id of the city in database
  • 'STREET_TYPE' - street type (street or neighborhood)

getNPInfo - Get COD info

getNPInfo(object $loginparam, integer $tid) : array | \Exception
Return information for payed COD, based on given way-bill number

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $number = 12345678; //Number of way-bill $client->getNPInfo($loginparam,$number);

Parameters

$loginparam

object

!R! Authentication parameter with username and password

$tid

integer

!R! - Number of the way-bill

Returns

array\Exception
Array with the following indexes:
  • 'TOVARITELNICA' - number of the way-bill
  • 'SUMA' - Value of the COD
  • 'RECEIVER' [CITY] - Receiver name and city
  • 'IZPLATENODATA' - Date
  • 'COMPANY_ID' - Client number in Dynamicexpress system
  • 'RAZHODORDER' - Number of the document COD order number
  • 'CLIENT_REF1' - Reference number

Get offices in city

getOfficesCity(object $loginparam, integer $siteid) : array | \Exception

Returns offices in a city. Used for the "Delivery from office" service

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $client->getOfficesCity($loginparam,$SITEID);

Parameters

$loginparam

object

!R! Authentication parameter with username and password

$siteid

integer

!R! - City ID

Returns

array\Exception
Array with the following indexes:
  • 'DATA' - ID of the office
  • 'LABEL' - Name of the office

getOfficesCord - Get offices by given parameters for location

getOfficesCord(object $loginparam, integer $country_id = 0, float $lat = 0, float $lng = 0, integer $dist = 50) : array | \Exception

Returns information about all offices, based on given parameters about country, Latitude, Longitude and distance

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $country_id = 100; //example for Bulgaria $lat = 43.214753; //example for latitude = 43.214753 $lng = 27.714031; //example for longitude = 27.714031 //note: if you dont give $lat and $lng you will get all offices in that country; // if you set country 0 or false, the return is information, based on the given $lat and $lng $dist = 30; //example for distance from the given point = 30km //if you dont give us distance, default is zero

$client->getOfficesCord($loginparam, $country_id, $lat, $lng, $dist); //note: if you dont give $lat and $lng you will get all offices in that country;

Parameters

$loginparam

object

!R! - Authentication parameter with username and password

$country_id

integer

!R! - ID of the country

$lat

float
  • Latitude information

$lng

float
  • Longitude information

$dist

integer
  • desired distance in kilometers from the given point

Returns

array\Exception

Returns multidimensional array, each of which indexes is separate information about office, and contains array with the following indexes:

  • 'ID' - ID of the office
  • 'OFFICENAME' - Name of the office
  • 'RTYPE' - information, used internal in Dynamicexpress
  • 'SITEID' - the ID of the city
  • 'CITY' - City name
  • 'PK' - Post Code of the city
  • 'ADDRESS' - Address
  • 'LAT' - Latitude
  • 'LNG' - Longitude
  • 'PARCELPICKUP' - information, that customers can pick up parcels (1 for 'yes', 0 for 'no')
  • 'PARCELACCEPTANCE' - information, that customers drop off parcels (1 for 'yes', 0 for 'no')
  • 'MAXPARCELDIMENSIONS_W' - max width in cm for a parcel
  • 'MAXPARCELDIMENSIONS_H' - max height in cm for a parcel
  • 'MAXPARCELDIMENSIONS_L' - max length in cm for a parcel
  • 'MAXPARCELWEIGHT' - max weight in cm for a parcel
  • 'D1' - working time Monday
  • 'D2' - working time Tuesday
  • 'D3' - working time Wednesday
  • 'D4' - working time Thursday
  • 'D5' - working time Friday
  • 'D6' - working time Saturday
  • 'D7' - working time Sunday
  • 'INFO' - additional information about the office
  • 'DISTANCE' - distance from the given point
  • 'SUBCON_ID' - information, used internal in Dynamicexpress
  • 'COUNTRY_ID' - id of the country of the office

getRazhodOrderInfo - Get COD info by document order number

getRazhodOrderInfo(object $loginparam, integer $orderid) : array | \Exception
Return information for payed COD, for way-bills in a given document COD order number
Example:
$loginparam = new stdClass(); $loginparam->user = '\*\*\*\*\*\*\*'; $loginparam->pass = '\*\*\*\*\*\*\*'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $number = 123456; //number of the COD payment document $client->getRazhodOrderInfo($loginparam,$number);

Parameters

$loginparam

object

!R! Authentication parameter with username and password

$orderid

integer

!R! Document COD order number

Returns

array\Exception
Array with the following indexes:
  • 'TOVARITELNICA' - number of the way-bill
  • 'SUMA' - Value of the COD
  • 'RECEIVER [CITY]' - Receiver name and city
  • 'IZPLATENODATA' - Date
  • 'COMPANY_ID' - Client number in Dynamicexpress system
  • 'RAZHODORDER' - Number of the document COD order number
  • 'CLIENT_REF1' - Reference number

getRazhodOrderInfoPMT - Way-bills in COD payment document

getRazhodOrderInfoPMT(object $loginparam, string $orderid) : array | \Exception

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $orderid = 123456; //number of the COD payment document $client->getRazhodOrderInfoPMT($loginparam,$orderid);

Parameters

$loginparam

object

!R! - Authentication parameter with username and password

$orderid

string

!R! - number of the COD payment document

Returns

array\Exception
Multidimensional array, each index of which is array with the following 6 indexes:
  • 'TOVARITELNICA' [INT] - The number of the way-bill
  • 'PMT_RECEIPT' [STRING] - Value if there is Post Money Transfer check in the way-bill
  • 'SUMA' [STRING] - information about the value of the COD
  • 'RECEIVER' [STRING] - name of the receiver
  • 'IZPLATENODATA' [STRING] - information about the date when the payment is done
  • 'CLIENT_REF1' [STRING] - client ref.1

getRazhodOrders - information about COD order documents information

getRazhodOrders(object $loginparam, string $start, string $end) : array | \Exception

Returns information about all COD order documents, for a given period

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $start = '2018-03-20 00:00:00'; //start date in format 'Y-m-d H:i:s' $end = '2018-03-20 23:59:59'; //end date in format 'Y-m-d H:i:s'

$client->getRazhodOrders($loginparam, $start, $end);

Parameters

$loginparam

object

!R! - Authentication parameter with username and password

$start

string

!R! - string with the information about the start of the period. In format Y-m-d H:i:s

$end

string

!R! - string with the information about the end of the period. In format Y-m-d H:i:s

Returns

array\Exception

Multidimensional, each of which indexes are arrays with information about each COD order document. Each of this inside arrays have 5 indexes, which are:
  • 'RID' - number of the document
  • 'CREATED' - date, when it's created
  • 'PAYTYPE' - type of pay out; 1 is for bank, 0 is for cash
  • 'TCOUNT' - the count of the way-bills
  • 'TSUM' - sum of the COD order

getReturnRedirect - info about return/redirect

getReturnRedirect(object $loginparam, string $start, string $end) : array | \Exception

Returns information for returns/redirect for a given period of time

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); //for giving range from the 01 January 2018 to the end of the day on 02 January 2018 $start = '2018-01-01 00:00:00' // string with the information about the start of the period. -> -> In format Y-m-d H:i:s $end = '2018-01-02 23:59:59' // string with the information about the end of the period. -> -> In format Y-m-d H:i:s $client->getReturnRedirect($loginparam, $start, $end);

Parameters

$loginparam

object

!R! - Authentication parameter with username and password

$start

string

!R! - string with the information about the start of the period. In format Y-m-d H:i:s

$end

string

!R! - string with the information about the end of the period. In format Y-m-d H:i:s

Returns

array\Exception

Multidimensional, each of which indexes are arrays with information about each return/redirect. Each of this inside arrays have 9 indexes, which are:
  • 'CREATED' - date when way-bill is created
  • 'TOVARITELNICA' - number of the way-bill
  • 'CLIENT_REF1' - client reference number1
  • 'CLIENT_REF2' - client reference number2
  • 'SUBCONTRACTOR1' - the number of subcontractor's tracking number on the main way-bill
  • 'RTYPE' - the type of case (return/redirect)
  • 'CREATED_01' - date when the way-bill for return/redirect is created
  • 'TOVARITELNICA_01' - number of the way-bill for return/redirect
  • 'SUBCONTRACTOR2'- the number of subcontractor's tracking number on the return/redirect way-bill

getServices - Returns a list of services

getServices($loginparam, Boolean $lang = 0) : array | \Exception

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $client->getServices($loginparam);

Parameters

$loginparam

!R! Authentication parameter with username and password

$lang

Boolean

for internal use only

Returns

array\Exception

Array with the following indexes:
  • 'DATA' - ID of the service
  • 'LABEL' - service name

getStreets - Returns a list of streets matching the search criteria.

getStreets(object $loginparam, integer $siteid = 0, string $start = 0, string $count = 0) : array | \Exception

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $client->getStreets($loginparam,$siteid);

Parameters

$loginparam

object

!R! Authentication parameter with username and password

$siteid

integer

!R! ID of the City. Can be obtained with getCityes method

$start

string

Internal use only

$count

string

Internal use only

Returns

array\Exception

Array with the following indexes:
  • 'SITEID' - ID of the town/city
  • 'STREETID' - ID of the street/neighborhood
  • 'STREETTYPE' - type of that field in the database: street("ул.") or boulevard("бул.")
  • 'STREETTYPE2' - type of that field in the database: 1 is for Street, 2 is for neighborhood
  • 'STREETNAME' - Name of the street/neighborhood

getSubServices - Returns a list of the subservice depending on selected service

getSubServices(Object $loginparam, integer $serviceid, Boolean $lang = 0) : array | \Exception

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $client->getSubServices($loginparam,2);

Parameters

$loginparam

Object

!R! Authentication parameter with username and password

$serviceid

integer

!R! ID of service from getServices

$lang

Boolean

for internal use only

Returns

array\Exception

Array with the following indexes:
  • 'DATA' - ID of the subservice
  • 'LABEL' - subservice name

getTovarCurrencyInfo - Returns information about the COD currency changes, for international parcels

getTovarCurrencyInfo(object $loginparam, $tid) : array | \Exception

It can be used from clients who need to check the differences between bank exchange of currencies

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $tNumber = 12345678; //number of the way-bill $client->getTovarCurrencyInfo($loginparam, $tNumber);

Parameters

$loginparam

object

!R! - Authentication parameter with username and password

$tid

Returns

array\Exception

Array with the following indexes:
  • 'TOVARITELNICA' - number of the way-bill
  • 'CREATED' - date, when way-bill was created
  • 'CLIENT_REF1' - client reference
  • 'NP' - COD value at the moment of check
  • 'CDATE' - the date of the exchange
  • 'CURRENCY_VAL' - exchange rate
  • 'NP_VAL' - value of COD before exchange
  • 'NP_NEWVAL' - value after exchange

getTovarFinInfo - returns financial info about Way-bill

getTovarFinInfo(object $loginparam, $tid) : array | \Exception

Returns information about receiver, COD and the charge for the courier service in a Way-bill

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $tNumber = 12345678; //number of the way-bill $client->getTovarFinInfo($loginparam, $tNumber);

Parameters

$loginparam

object

!R! Authentication parameter with username and password

$tid

Returns

array\Exception

Array with the following indexes:
  • 'TOVARITELNICA' - The number of the way-bill
  • 'RECEIVER' - then name of the receiver
  • 'NP' - COD value
  • 'CENA' - courier service charge

getTovarInfo - Get Way-bill (shipment) info

getTovarInfo(object $loginparam, $tid) : array | \Exception

Returns information about the shipment

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $number = 12345678; //number of the way-bill $client->getTovarInfo($loginparam,$number);

Parameters

$loginparam

object

!R! Authentication parameter with username and password

$tid

Returns

array\Exception
Array with the following indexes:
  • 'TOVARITELNICA' - number of the way-bill
  • 'CREATED' - Date created
  • 'CLIENT_REF1' - Client reference number
  • 'NP' - COD value
  • 'TEGLO' - Weight
  • 'TAX_USLUGA' - Service value
  • 'TAX_FIXCH' - Fixed-hour commission value
  • 'TAX_RET_D' - Return documents commission value
  • 'TAX_RET_R' - Return reciept commission value
  • 'TAX_NP' - COD(cash on delivery) commission value
  • 'TAX_DDS' - VAT value
  • 'TAX_INS' - Insurance commission value
  • 'STOINOST' - Calculated total

getTovarInfoTid - information by given ID, not way-bill

getTovarInfoTid(object $loginparam, $tid) : array | \Exception

Returns the same informations as track_order Method, only input parameter is not way-bill number,
Example:
$loginparam = new stdClass(); $loginparam->user = '\*\*\*\*\*\*\*'; $loginparam->pass = '\*\*\*\*\*\*\*'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $number = 12345678; //id of the way-bill $client->getTovarInfoTid($loginparam,$number);

Parameters

$loginparam

object

!R! - Authentication parameter with username and password

$tid

Returns

array\Exception

Array with the following indexes:
  • 'TOVARITELNICA' - number of the way-bill
  • 'STATUS' - status of the way-bill
  • 'CREATED' - Date created
  • 'RECEIVER' - Name of the receiver
  • 'CITY_B' - city of the receiver
  • 'PLATEC' - name of the payer
  • 'COUNTRY_B' - country of the receiver
  • 'CREATED_BY' - name of the creator of the way-bill
  • 'SERVICE' - name of the main service
  • 'SUBSERVICE' - name of the subservice
  • 'CLIENT_REF1' - client reference number
  • 'NP' - COD value
  • 'TEGLO' - Weight of the parcel
  • 'TAX_USLUGA' - Service value
  • 'TAX_FIXCH' - Fixed-hour commission value
  • 'TAX_RET_D' - Return documents commission value
  • 'TAX_RET_R' - Return reciept commission value
  • 'TAX_NP' - COD(cash on delivery) commission value
  • 'TAX_DDS' - VAT value
  • 'TAX_INS' - Insurance commission value
  • 'STOINOST' - Calculated total
  • 'SUBCONT_REF'
  • 'RET_RED' - information if there is return/redirect

listSites - list of cities

listSites(object $loginparam, string $name, integer $country = 100) : array | \Exception

Returns a list of cities that meet the appropriate search filter.

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $name = 'соф'; // use this variable for dinamic input from user $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $client->listSites($loginparam,$name);

Parameters

$loginparam

object

!R! Authentication parameter with username and password

$name

string

!R! One or more letters of the name

$country

integer

for internal use only

Returns

array\Exception

Array with the following indexes:
  • 'ID' - ID in the database
  • 'SITEID' - ID of the town/city
  • 'NAME' - Name of the town/city
  • 'SITETYPE' - Type of the town/city (town, village, holyday village)
  • 'OBLAST' - District of the town/city
  • 'POSTCODE' - Post Code of the town/city

print_int_pdf - Print International way-bill

print_int_pdf(object $loginparam, integer $nomer) : string | \Exception

Returns international way-bill in base64 encoded PDF format.

Used only for international services.

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $client->print_int_pdf($loginparam,$number);

Parameters

$loginparam

object

!R! Authentication parameter with username and password

$nomer

integer

!R! - Number of the way-bill

Returns

string\Exception

Returns PDF with the way-bill, base64 encoded

print_pdf - Print PDF

print_pdf(object $loginparam, integer $nomer, \smallint $pdfformat = 0) : string | \Exception

Returns way-bill in base64 encoded PDF format.

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $client->print_pdf($loginparam,$number);

Parameters

$loginparam

object

!R! Authentication parameter with username and password

$nomer

integer

!R! - Number of the way-bill

$pdfformat

\smallint

for internal use only

Returns

string\Exception

Returns PDF with the way-bill, base64 encoded

requestCurier - Requesting courier at address

requestCurier(object $loginparam, integer $broi, float $teglo, string $readiness, integer $sendoffice = 0) : array | \Exception

Used for requesting courier with given information about

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $broi = 5; //example in case of 5 parcels $teglo = 35; //example for 35 kilos in total for all parcels $readiness = 'from 10:30 to 16:30'; //example for starting and ending period for courier pickup $sendoffice = 2; //example for the id of client's office; -> -> default is zero - the main office of the client $client->requestCurier($loginparam, $broi, $teglo, $readiness, $sendoffice);

Parameters

$loginparam

object

!R! - Authentication parameter with username and password

$broi

integer
  • number of the parcels, ready to be taken, not mandatory for the soap to work, but it is good

$teglo

float
  • summary of the weight of the parcels

$readiness

string
  • information about a period of time during the working day, when the courier can arrive

$sendoffice

integer
  • information from witch office will be the request. Default is 0 - the main office. If you have more than 1 office, you should send $sendoffice the appropriate index of that office

Returns

array\Exception

Array with the following indexes:
  • 'SUCCESS' - if everything is o.k. - True value, if not - False
  • 'ERRORMSG' - if everything is o.k. - empty string. If not - message with information
  • 'TID' - if everything is o.k. - ID of client's order for courier pickup

setPrintSettings - Print preferences

setPrintSettings(object $loginparam, array $settings) : boolean

This method is used for setting printing preferences

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $myPrintingSettings = array() $myPrintingSettings['auto'] = 1 // 0(zero) - auto print OFF, or 1 - auto print ON; default is 0 $myPrintingSettings['format'] = 1 // 1-A4, 2-label 10cm x 7cm (used when printing with Argox -> -> printer; Default is 0 $myPrintingSettings['printer'] = '' // If you want to print with Argox printer, assign 'printer' -> -> index to 'ARGOX'; Default is empty string $client->setPrintSettings($loginparam, $myPrintingSettings);

Parameters

$loginparam

object

!R! - Authentication parameter with username and password

$settings

array



Array with the following indexes:
  • 'auto' [SMALLINT] - 0(zero) - auto print OFF, or 1 - auto print ON; default is 0
  • 'format' [SMALLINT] - 1-A4, 2-label 10cm x 7cm (used when printing with Argox printer; Default is 0
  • 'printer' [STRING] - If you want to print with Argox printer, assign 'printer' index to 'ARGOX'; Default is empty string

Returns

boolean

track_order - Track Order (Track way-bill/shipment)

track_order(object $loginparam, integer $nomer) : array | \Exception

Tracking of the shipment

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $number - 12345678; //number of the way-bill $client->track_order($loginparam,$number);

Parameters

$loginparam

object

!R! - Authentication parameter with username and password

$nomer

integer

!R!

Returns

array\Exception

Array with the following indexes:
  • 'DATA' - Data and hour of event
  • 'STATUS' - Event
  • 'SUBSTATUS_CODE' - Event, usually returned for unsuccessfull delivery
  • 'PLACE' - Place(City, office) of the event
  • 'CONSIGNEE' - When the parcel is delivered, here is shown the name of the recepient

track_order_array - Tracking for more than one way-bill(shipment)

track_order_array(object $loginparam, array $tarray) : array | \Exception

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $myArray = array(12345678, 87654321); // example for numbers of Way-bills $client->track_order_array($loginparam, $myArray);

Parameters

$loginparam

object

!R! - Authentication parameter with username and password

$tarray

array

!R! - Array with values

Returns

array\Exception

Multidimensional array, with arrays for the tracking of each given number of way-bill:

Each returned status is separet array, with the following indexes:

  • 'DATA' - datetime of the status
  • 'STATUS_CODE' - the code of the status
  • 'SUBSTATUS_CODE' - secondary status with information, when there is unsuccessful delivery
  • 'STATUS' - name of the status
  • Optional: 'SIGNATURE' - when the parcel is delivered, there is string with link of the signature of receiver
  • 'PLACE' - the office place, where status has happened
  • 'CONSIGNEE' - When the parcel is delivered, here is shown the name of the recepient

Last index for each way-bill is the way-bill itself

track_order_ref - Track order by ref.Number

track_order_ref(object $loginparam, integer $nomer) : array | \Exception

Tracking of the shipment, by given referenced number

This is the number, which is set in create_order function. It is the $order_info[CLIENT_REF1] index value

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $client->track_order_ref($loginparam,$number);

Parameters

$loginparam

object

!R! Authentication parameter with username and password

$nomer

integer

!R! as $number ref number

Returns

array\Exception

Array with the following indexes:
  • 'DATA' - Data and hour of event
  • 'STATUS' - Event
  • 'SUBSTATUS_CODE' - Event, usually returned for unsuccessfull delivery
  • 'PLACE' - Place(City, office) of the event
  • 'CONSIGNEE' - When the parcel is delivered, here is shown the name of the recepient

track_order_ref_array - Track by reference

track_order_ref_array(object $loginparam, array $tarray) : array | \Exception

Tracking of the shipment, by given array with referenced numbers

Referenced numbers are the numbers, which are set in create_order function. It is the $order_info[CLIENT_REF1] index value

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $myArray = array(12345678, 87654321); // example for numbers of Way-bills $client->track_order_ref_array($loginparam, $myArray);

Parameters

$loginparam

object

!R! - Authentication parameter with username and password

$tarray

array

!R!

Returns

array\Exception

Multidimensional array which indexes for every given ref. number, which are arrays with the following indexes:
  • 'DATA' - Data and hour of event
  • 'STATUS' - Event
  • 'SUBSTATUS_CODE' - Event, usually returned for unsuccessfull delivery
  • 'PLACE' - Place(City, office) of the event
  • 'CONSIGNEE' - When the parcel is delivered, here is shown the name of the recepient

track_request - Tracking by order ID (not way-bill, but it's ID)

track_request(object $loginparam, integer $nomer) : array | \Exception

Returns the same informations as track_order Method, only input parameter is not way-bill number,
but it is the number of the request(ID)

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $nomer = 12345678; //example for given number of way-bill $client->track_request($loginparam,$number);

Parameters

$loginparam

object

!R! - Authentication parameter with username and password

$nomer

integer

!R! - number of way-bill

Returns

array\Exception

Array with the following indexes:
  • 'DATA' - Data and hour of event
  • 'STATUS' - Event
  • 'SUBSTATUS_CODE' - Event, usually returned for unsuccessfull delivery
  • 'PLACE' - Place(City, office) of the event
  • 'CONSIGNEE' - When the parcel is delivered, here is shown the name of the recepient

updateParcelsWeight - update parcels weight

updateParcelsWeight(object $loginparam, $tovaritelnica, array $parcelinfo) : boolean | \Exception

This method is used so client can give the system announced in advance information about the parcel parameters

Example:
$loginparam = new stdClass(); $loginparam->user = '*******'; $loginparam->pass = '*******'; $client = @new SoapClient('https://system.dynamicexpress.eu/schema.wsdl'); $number = 12345678; //example for given number of way-bill $parcelinfo = array(); //array with info about weight, width, height, depth of the parcel $parcelinfo['parcelId'] = 1234567801; // example for the second pack in the shipment $parcelinfo['weight'] = 3.15; $parcelinfo['width'] = 24.3; $parcelinfo['height'] = 15.35; $parcelinfo['depth'] = 45.35;

$client->updateParcelsWeight($loginparam,$number, $parcelinfo);

Parameters

$loginparam

object

!R! - Authentication parameter with username and password

$tovaritelnica

$parcelinfo

array

!R! - associative array with information about weight, width, height, depth of the way-bill
With the following indexes:

  • 'parcelId' - packID number, the number of first pack is exactly as the shipment (ex. 12345678),
    second is with 01 after the main number (ex. 1234567801), third is with 02(1234567802), etc.
  • 'weight' - weight of the parcel
  • 'width' - width of the parcel
  • 'height' - height of the parcel
  • 'depth' - depth of the parcel

Returns

boolean\Exception