G-Service

Transkript

G-Service

G-Service web service – documentation
Str. 1/53
G-Service
Web service description
DOCUMENT VERSION: 2.5
DATE:
6. 10. 2016
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
E-mail: [email protected]
Internet: www.geis.cz
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
UniCredit Bank Czech Republic, a.s.
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Společnost zapsána v obchodním
rejstříku vedeném Krajským soudem
v Plzni, oddíl C, číslo vložky 14475.
Pracujeme na základě našich
všeobecných obchodních
podmínek – aktuální stav.
Str. 2/53
About G-Service
G-Service is a web service designed for customers of Geis group, which allows customers to fully
automatically process transport entry in both Geis group products (cargo and parcel transport). The web
service allows entering shipments (expedition or orders in mode), status detection and other information
about shipments, ordering pick-up and detection additional services available for the customer.
The use of the web service enables full integration in the production process, storage systems or web shop
for the Geis group customers. Requirements for the web service and especially responses from the web
service are structured in XML format and allow further processing on the part of customers´ systems.
G-Service works on the principle of SOAP architecture (https://en.wikipedia.org/wiki/SOAP). The access is
allowed via secured HTTP protocol (HTTPS) only.
To test the web service, for example, the open source program SoapUI (http://www.soapui.org) – may be
used.
To access the web service it is necessary to have access data - customer code and password. These access
data are communicated on request from the assigned business manager from the Geis group.
Before moving to full operation it is always necessary to go through the first integration tests in the test
environment which are done by technical department of customer in cooperation with EDI department of Geis
group.
The web service is available for customers from the Czech Republic and Slovakia at the following
addresses:
•
•
https://gclient.geis.cz/GService/GService.svc- access to the production environment
https://gclient.geis.cz/GServiceTest/GService.svc –access to the test environment
The web service is available for customers of ET Logistik company from Poland at the following addresses:
•
•
https://gclient.etlogistik.com/GService/GService.svc - access to the production environment
https://gclient.etlogistik.com /GServiceTest/GService.svc – access to the test environment
The web service is available for customers of K-EX Sp. z. o.o. company from Poland at following addresses:
•
•
https://gclient.geis.pl/GService/GService.svc - access to the production environment
https://gclient.geis.pl/GServiceTest/GService.svc – access to the test environment
For the successful implementation of the web service in customer environment and understanding the
broader context it is recommended to study the Manual for system integration, which is available on the
technical support web site of the Geis group in the downloads section at:
•
•
www.baliky.cz/podpora or www.baliky.sk/podpora (Czech version)
www.etlogistik.com/support (English version)
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 3/53
Content
About G-Service .................................................................................................................................................. 2
ChangeLog........................................................................................................................................................... 5
Implementation steps on customer side ............................................................................................................ 7
Minimal test scenario ......................................................................................................................................... 7
Web service base classes .................................................................................................................................... 7
Request ........................................................................................................................................................... 8
RequestHeader ............................................................................................................................................... 8
Language ......................................................................................................................................................... 8
Currency .......................................................................................................................................................... 8
Response ......................................................................................................................................................... 8
ResponseStatus ............................................................................................................................................... 8
ZipCodes.......................................................................................................................................................... 9
Address ........................................................................................................................................................... 9
Contact ............................................................................................................................................................ 9
Error codes .......................................................................................................................................................... 9
Web service methods ................................................................................................................................... 10
ServiceList ..................................................................................................................................................... 10
AddServiceList ............................................................................................................................................... 12
StatusList ....................................................................................................................................................... 16
WrapList ........................................................................................................................................................ 18
DeliveryRouting ............................................................................................................................................ 20
ShipmentDetail ............................................................................................................................................. 22
RouteTable .................................................................................................................................................... 26
CreatePickUp ................................................................................................................................................ 28
InsertExport .................................................................................................................................................. 31
InsertOrder ................................................................................................................................................... 35
AssignRange .................................................................................................................................................. 38
IsHealthy ....................................................................................................................................................... 40
GetLabel ........................................................................................................................................................ 41
ListOfShipments ............................................................................................................................................ 43
ShipmentStatus ............................................................................................................................................. 46
GetPickupList ................................................................................................................................................ 49
DeleteShipment ............................................................................................................................................ 51
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 4/53
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 5/53
ChangeLog
Version
1.0
Date
2015-05-29
1.1
1.2
2015-08-03
1.3
2015-08-24
1.4
2015-08-27
1.5
2015-09-09
1.6
1.7
1.8
1.9
2.0
2015-09-21
2015-11-13
2015-12-02
2016-01-06
2016-02-10
2.1
2016-05-09
2.2
2016-06-06
Change
Service creation. Basic methods:
- ServiceList
- AddServiceList
- StatusList
- WrapList
- DeliveryRouting
- ShipmentDetail
- RouteTable
- CreatePickUp
- InsertExport
- InsertOrder
- AssignRange
Added list of possible currencies Currency
Changes in input:
- To ExportService added Parameter_5
- InsertOrder corrected parameter MergedOrder
- Edited mandatory parameters in InsertExport
- Language CS changed to CZ
- Password for logging extended to 20 characters
Changes in output:
- method ShipmentDetail – PackageRow added customer references
(Reference)
- method InserExport added list of numbers merged shipments
(MergedPackNumbers)
- method InsertOrder added list of numbers merged orders
(MergedPackNumbers)
Changes in input:
- InsertOrder: added parameter for entering merged orders (MergedOrders)
- InsertOrder: removed parameter CountItems
- InsertExport: added parameter for entering merged shipments
(MergedPackages)
- Corrected control of class Contact, now it is checking the format of Email
and Telephone number.
Changes in input:
- DeliveryRouting parameter CountryIn changed to optional for Parcel
Updating the obligations parameters.
Correction.
Supplementing dimensions parameters for order.
Changed description of parameters for method DeliveryRouting
Added web service description, implementation scenario
Error code list update
New method GetLabel. Update of method IsHealthy.
Update of response of method ShipmentDetail.
New methods ListOfShipments, ShipmentStatus, GetPickupList, DeleteShipment.
Added new parameter BurstId in methods Insertorder and InsertExport.
GDO service added to list of services (in part of method InsertExport)
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 6/53
2.3
2.4
2.5
2016-07-13
2016-08-23
2016-10-06
Modification of methods ListOfShipments, ShipmentDetail
Correction of parameter Range for AssignRange method (parameter is mandatory)
New web service addresses for K-EX customers
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 7/53
Implementation steps on customer side
For web service implementation, following steps are required on customer side:
Check the option of API requests and reply processing via HTTPS protocol in customer logistic
software
Understanding basic concepts in document Manual for system integration (product types,
shipment routing, additional shipment services, labels print and hand-over protocol) and this
documentation
Require access to API interface of test web service from Geis sales manager
Test basic methods and classes, response processing, return codes management
Create labels and hand-over protocol and send for validation to Geis sales manager
Agreement of schedule and go-live
Minimal test scenario
In terms of web service testing in test environment it is important to have used at least following
methods:
CreatePickup (collection create)
InsertExport (insert expedition shipment for each product, that is planned to be used by
customer - cargo / parcel) with use of supplemental methods AddServiceList, DeliveryRouting
and WrapList (only for cargo product)
InsertOrder (insert order shipment for each product, that is planned to be used by customer)
AssignRange (assign shipment number range) – only for parcel product
ShipmentDetail (getting shipment detail) with use of supplemental method StatusList
Note: before inserting expedition shipment it is necessary to create collection order for given day. In
collection order the maximum shipment quantity and approximate total weight for all shipments of
that day must be specified.
Web service base classes
The base classes are mentioned below. They are used in almost all methods of service.
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 8/53
Request
Name
Type
Header
RequestHeader
RequestObject Generic
Description
Header of request
Input object (specific for call method)
Mandatory
Y
Y
RequestHeader
Name
Type
Description
CustomerCode String
Customer code
Password
String
Password for login
Language
Language
Language for communication
*it does not have to be mandatory for all calls methods.
Mandatory
Y*
Y*
Y
Language
List of possible languages:
Value
CZ
SK
EN
DE
PL
Name/Description
Czech
Slovak
English
German
Polish
Currency
List of possible currencies:
Value
UND
CZK
EUR
CHF
USD
PLN
HUF
Name/Description
Undefined value currency
Czech crown
Euro
Swiss franc
American dollar
Polish Zloty
Hungarian forint
Response
Name
Request
Type
Request
ResponseObject
ErrorMessage
ErrorCode
Status
Generic
String
String
ResponseStatus
Description
Input for the called method (it is set only in the
case when it ends with an error).
Output object (specified for call method)
Error message.
Error code (List of error codes is here)
Status of method processing
ResponseStatus
Value
Name/Description
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 9/53
Inserted
Deleted
Updated
ErrorOccurred
AccesDenied
Processed
NoDataFound
Insert was successful.
Delete was successful.
Update was successful.
Error occurred during the processing.
Access denied (invalid combination of customer code and password)
Listing/Process in passed right.
No data found.
ZipCodes
Name
ZipCodeFrom
ZipCodeTo
Type
String
String
Length
10
10
Description
Zip code from
Zip code to
Address
Name
Name
Name2
Street
City
ZipCode
Country
Type
String
String
String
String
String
String
Length
50
50
50
50
10
2
Description
Name
Name supplement
Street
City
ZipCode
Country in ISO 3166-1 alpha-2 format
Contact
Contact information
Name
Email
FullName
Phone
Type
String
String
String
Length
50
50
20
Description
E-mail
Full name
Phone number in an international format
(e.g. +420 111 222 333)
Error codes
Code
1000
1001
2000
2001
2002
2003
2004
2005
2006
2007
2008
2009
Description
Access denied
Unauthorized access!
[#Name of parameter#] is a mandatory parameter!
Distribution channel must have value 1 or 2!
Value [#Value from list of values#] was not found!
No data found
Routing table for this day does not exist!
This type of transport service is not allowed for this pickup address!
Wrong range of data!
Type UM [#Typeunit#] is not allowed for this customer!
Enabled distribution channel [#distribution channel identifier#]!
Type of transport may have value 1- national / 2-international
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 10/53
2010
2011
Parcel number has already been used!
Parcel number does not belong to the numerical series assigned to the
customer!
2012
This kind of transport service is not allowed for this customer: [#name of
the transport service#]!
2013
Total weight and the weight of individual items do not match.
2015
Pick-up for the current day can be created only until [#TEXT#] clock.
2016
The specified service [#TEXT#] cannot be processed, because it does not
exist in the list of services. The service must be set up. Contact support.
2017
[#TEXT#] must be in international form (e.g. +420 111 222 333). Allowed
preferences are [#TEXT-1#].
2018
[#TEXT#] must be in correct form (e.g. [email protected])!
2019
[#TEXT#] is not a valid e-mail or phone![#TEXT-1#] [#TEXT-2#]*
2020
Order cannot be placed for this day.
2021
[#TEXT#] must be equal to or greater than [#TEXT-1#]!
2022
Entered code for pickup point is not valid!
2023
Entered pickup point code [#TEXT#] was not found.
2024
Contact person is required for shipments delivered to pickup point.
2025
Contact phone is required for shipments delivered to pickup point.
2026
This method is available only for parcel service
2027
You cannot send shipment to pickup point, this option is not active.
2028
Field country must be specified for cover address
2029
For customer [#TEXT#] individual COD account option is not active.
DistributionChannel [#TEXT-1#]
2030
For export item the dimensions must be specified.
3000
Error service GClientWS! [#Error message from the service GClientWS #]
9999
Unexpected Error!
*it contains a description of errors 2017 and 2018
Web service methods
ServiceList
It returns list of transportation services that are set in the primary system. It can return these values:
Value
10
11
20
21
Name/Description
Parcel expedition
Parcel orders
Cargo expedition
Cargo orders
Request
Name
Type
Header
RequestHeader
RequestObject ServiceRequest
Description
Header of request
Empty class
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Mandatory
Y
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 11/53
Response
Name
Request
Type
Request
ResponseObject
ErrorMessage
ErrorCode
Status
List<Service>
String
String
ResponseStatus
Description
Input data for the called method (it is set only in
the case when it ends with an error).
List of transport services
Error message.
Error code (list of error codes is here)
Service
Detail of transport service.
Name
Code
Name
Type
String
String
Length
3
30
Description
Transport service code
Transport service name
An example of ServiceList method
Request:
<?xml version="1.0" encoding="utf-16"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<ServiceList xmlns="http://tempuri.org/">
<Request>
<Header xmlns="http://schemas.datacontract.org/2004/07/GService.Manager">
<CustomerCode>22054861</CustomerCode>
<Language>EN</Language>
<Password>wspwd</Password>
</Header>
<RequestObject xmlns="http://schemas.datacontract.org/2004/07/GService.Manager" />
</Request>
</ServiceList>
</soap:Body>
</soap:Envelope>
Response:
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 12/53
<ServiceListResponse xmlns="http://tempuri.org/">
<ServiceListResult xmlns:a="http://schemas.datacontract.org/2004/07/GService.Manager"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:ErrorCode>0000</a:ErrorCode>
<a:ErrorMessage />
<a:Request i:nil="true" />
<a:ResponseObject>
<a:Service>
<a:Code>10</a:Code>
<a:Name>parcel dispatch</a:Name>
</a:Service>
<a:Service>
<a:Code>11</a:Code>
<a:Name>parcel orders</a:Name>
</a:Service>
<a:Service>
<a:Code>20</a:Code>
<a:Name>cargo dispatch</a:Name>
</a:Service>
<a:Service>
<a:Code>21</a:Code>
<a:Name>cargo orders</a:Name>
</a:Service>
</a:ResponseObject>
<a:Status>Processed</a:Status>
</ServiceListResult>
</ServiceListResponse>
</s:Body>
</s:Envelope>
AddServiceList
It returns the list of additional services that the customer has set up in the primary system. In these
service may be included for example COD –Cash on delivery, POJ – insurance etc.
Request
Name
Type
Header
RequestHeader
RequestObject AddServiceRequest
Description
Header of request
Instance of the class AddServiceRequest
AddServiceRequest
Name
Type
Service
String
Length
2
DeliveryCountry String
2
Mandatory
Y
Y
Description
Type of transport service (according to the
output ServiceList)
Country of recipient in ISO 3166-1 alpha-2
form
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Mandatory
Y
Y*
Str. 13/53
*Parameter is mandatory only for Cargo
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 14/53
Response
Name
Request
Type
Request
ResponseObject
ErrorMessage
ErrorCode
Status
List<AddService>
String
String
ResponseStatus
Description
the case when it ends with an error)
List of services which customer can use.
Error message.
Status of method processing.
AddService
Detail of service.
Name
Code
Abbreviation
Description
ZipCodeFrom
ZipCodeTo
Type
Int
String
String
String
String
Length
2
3
30
10
10
Description
Service Id
Service abbreviation
Service description.
Zip code from (if set)
Zip code to (if set)
An example of AddServiceList call method
Here is an example below in which we run method which returns what services are authorized for
customer for Parcel product. Moreover we are interested only in expedition.
Request:
<soap:Body>
<AddServiceList xmlns="http://tempuri.org/">
<Request>
</Headere
<RequestObject xmlns="http://schemas.datacontract.org/2004/07/GService.Manager">
<DeliveryCountry>CZ</DeliveryCountry>
<Service>10</Service>
</RequestObject>
</Request>
</AddServiceList>
</soap:Body>
</soap:Envelope>
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 15/53
Response:
We can see in the answer that customer has assigned services COD, POJ and D12. For service D12 we
can notice that another element ZipCodeList is given. This list identifies for which recipient´s Zip code it is
possible to use D12 service. In case that D12 service is used in InsertExport method and recipient Zip code is
not in the interval Zip code, the expedition won´t be processed and service will display an error message.
<s:Body>
<AddServiceListResponse xmlns="http://tempuri.org/">
<AddServiceListResult xmlns:a="http://schemas.datacontract.org/2004/07/GService.Manager"
<a:ErrorMessage />
<a:ResponseObject>
<a:AddService>
<a:Abbreviation>COD</a:Abbreviation>
<a:Code>2</a:Code>
<a:Description>Cash on delivery</a:Description>
<a:Service>10</a:Service>
<a:ZipCodesList i:nil="true" />
</a:AddService>
<a:AddService>
<a:Abbreviation>POJ</a:Abbreviation>
<a:Code>3</a:Code>
<a:Description>Add. insurance</a:Description>
<a:ZipCodesList i:nil="true" />
</a:AddService>
<a:AddService>
<a:Abbreviation>D12</a:Abbreviation>
<a:Code>6</a:Code>
<a:Description>Delivery within 12hrs</a:Description>
<a:ZipCodesList>
<a:ZipCodes>
<a:ZipCodeFrom>10000</a:ZipCodeFrom>
<a:ZipCodeTo>19900</a:ZipCodeTo>
</a:ZipCodes>
<a:ZipCodes>
</a:ZipCodes>
</a:ZipCodesList>
</a:AddService>
</a:ResponseObject>
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 16/53
</AddServiceListResult>
</AddServiceListResponse>
</s:Body>
</s:Envelope>
StatusList
It returns a list of the shipments statuses which are visible in Track & Trace.
Request
Name
Type
Header
RequestHeader
RequestObject StatusRequest
StatusRequest
Name
Type
DistributionChannel Int
Response
Name
Request
Type
Request
ResponseObject List<Status>
ErrorMessage
ErrorCode
Status
String
String
ResponseStatus
Description
Header of request
StatusRequest instance class
Mandatory
Y
Y
Description
Type of transport service (1 – Parcel, 2 –
Cargo)
Mandatory
Y
Description
case when it ends with an error)
List of statuses according to the transport
service
Error message
Status process method.
Status
Detail of status of the shipment.
Name
Code
Description
DistributionChannel
Type
String
String
Int
Length
3
20
1
Description
Status code
Service description
Type of transport service (1 – Parcel, 2 – Cargo)
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 17/53
An example of StatusList call method
Request:
<soap:Body>
<StatusList xmlns="http://tempuri.org/">
<Request>
</Header>
<DistributionChannel>1</DistributionChannel>
</RequestObject>
</Request>
</StatusList>
</soap:Body>
</soap:Envelope>
Response:
<s:Body>
<StatusListResponse xmlns="http://tempuri.org/">
<StatusListResult xmlns:a="http://schemas.datacontract.org/2004/07/GService.Manager"
<a:ErrorMessage />
<a:ResponseObject>
<a:Status>
<a:Code>10</a:Code>
<a:Description>Pick up of parcel</a:Description>
<a:DistributionChannel>1</a:DistributionChannel>
</a:Status>
<a:Status>
<a:Code>11</a:Code>
<a:Description>Cancelled</a:Description>
</a:Status>
<a:Status>
<a:Code>12</a:Code>
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 18/53
<a:Description>Pick up depot</a:Description>
</a:Status>
<a:Status>
<a:Code>20</a:Code>
<a:Description>received at depot</a:Description>
</a:Status>
</a:ResponseObject>
</StatusListResult>
</StatusListResponse>
</s:Body>
</s:Envelope>
WrapList
This returns a list of manipulation units allowed for the customer in the primary system.
Request
Name
Type
Header
RequestHeader
RequestObject WrapRequest
Response
Name
Request
Description
Header of request
Instance of the WrapRequest class (empty class)
Type
Request
Description
case it ends with an error)
List of manipulation units which are allowed for
the customer.
Error message
Status process method.
ResponseObject List<Wrap>
ErrorMessage
ErrorCode
Status
Mandatory
Y
Y
String
String
ResponseStatus
Wrap
Detail of the manipulation unit.
Name
Code
Description
Returnable
Type
String
String
Bool
Length
3
50
Description
Manipulation unit code
Manipulation unit description
Returnable package
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 19/53
An example of WrapList call method
Request:
<soap:Body>
<WrapList xmlns="http://tempuri.org/">
<Request>
</Header>
<RequestObject xmlns="http://schemas.datacontract.org/2004/07/GService.Manager" />
</Request>
</WrapList>
</soap:Body>
</soap:Envelope>
Response:
<s:Body>
<WrapListResponse xmlns="http://tempuri.org/">
<WrapListResult xmlns:a="http://schemas.datacontract.org/2004/07/GService.Manager"
<a:ErrorMessage />
<a:ResponseObject>
<a:Wrap>
<a:Code>FP</a:Code>
<a:Description>Europallet</a:Description>
<a:Returnable>true</a:Returnable>
</a:Wrap>
<a:Wrap>
<a:Code>KH</a:Code>
<a:Description>Half pallet</a:Description>
<a:Returnable>true</a:Returnable>
</a:Wrap>
</a:ResponseObject>
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 20/53
</WrapListResult>
</WrapListResponse>
</s:Body>
</s:Envelope>
DeliveryRouting
It returns country of the recipient, depot and direction. This information is important for compilation
of the label - see System integration manual for customers section 2.4. Specification for printing labels on the
page 22.
Request
Name
Type
Description
Header
RequestHeader
Header of request
RequestObject DeliveryRoutingRequest Instance of class DeliveryRoutingRequest
Mandatory
Y
Y
DeliveryRoutingRequest
Name
Type
DistributionChannel
Int
Mandatory
Y
Length
CountryIn
String
ZipCodeIn
String
CountryOut
String
ZipCodeOut
String
TemperatureMode
String
*Parameter is mandatory for Cargo
Response
Name
Request
Type
Request
ResponseObject
ErrorMessage
ErrorCode
Status
DeliveryRouting
String
String
ResponseStatus
DeliveryRouting
Name
Type
DeliveryRoute String
DepCode
String
2
10
2
10
Description
Cargo)
Sender´s country
Sender´s Zip code
Recipient ´s country
Recipient ´s Zip code
Temperature mode (not used)
Y
Y
Y*
Y
Description
Information about routing.
Error message
Length
4
3
Description
Delivery routes code
Depot code
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 21/53
An example of DeliveryRouting call method
Request:
<soap:Body>
<DeliveryRouting xmlns="http://tempuri.org/">
<Request>
</Header>
<CountryIn />
<CountryOut>CZ</CountryOut>
<TemperatureMode />
<ZipCodeIn>33843</ZipCodeIn>
<ZipCodeOut>60200</ZipCodeOut>
</RequestObject>
</Request>
</DeliveryRouting>
</soap:Body>
</soap:Envelope>
Response:
<s:Body>
<DeliveryRoutingResponse xmlns="http://tempuri.org/">
<DeliveryRoutingResult xmlns:a="http://schemas.datacontract.org/2004/07/GService.Manager"
<a:ErrorMessage />
<a:ResponseObject>
<a:DeliveryRoute>6010</a:DeliveryRoute>
<a:DepCode>60</a:DepCode>
</a:ResponseObject>
</DeliveryRoutingResult>
</DeliveryRoutingResponse>
</s:Body>
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 22/53
</s:Envelope>
ShipmentDetail
It returns information about shipment. If the information about customer is sent and shipment is
created, this method returns information about shipment services, recipient´s address and sender´s address. If
customer/payer does not create shipment, it will only display the statuses of the shipment.
Request
Name
Type
Header
RequestHeader
RequestObject ShipmentRequest
ShipmentRequest
Name
Type
ShipmentNumber
String
Response
Name
Request
Type
Request
ResponseObject
ErrorMessage
ErrorCode
Status
Shipment
String
String
ResponseStatus
Description
Header of request
Instance of the class ShipmentRequest
Mandatory
Y
Y
Length Description
Cargo)
11 /
Number of the shipment parcel / cargo
13
Mandatory
Y
Y
Description
Details about shipment
Error message
Status of method processing.
Shipment
Detail of the shipment. Channel: P = valid for parcel, C = valid for cargo
Name
ShipmentNumber
Type
String
Length
11 / 13
ShipmentNumberCust String
DelivPerson
String
50
50
Weight
CodVarCode
Decimal
String
(5,2)
10
CodValue
DelivDate
BorderDate
Decimal
DateTime
DateTime
(12,2)
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Description
Number of the shipment
parcel / cargo
Customer´s reference
Name of the shipment
recipient
Weight of the shipment
Payment identification code
for cash on delivery
Cash on delivery value
Date of delivery
Sending date (date of loading
to main run)
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Channel
PC
PC
PC
PC
PC
PC
PC
C
Str. 23/53
BorderDate
Volume
RecAddress
SendAddress
History
ColliHistory
DateTime
Decimal
(9,3)
Address
Address
List<PackageHistory>
List<ColliHistory>
Services
Rows
List<PackageService>
List<PackageRow>
Shipment creation date
Volume
Address of the recipient
Address of the sender
List of shipment statuses
List of statuses for individual
pieces of shipment
List of shipment services
List of shipment rows
P
C
PC
PC
PC
C
PC
C
PackageHistory
Detail of shipment status.
Name
StatusDate
StatusName
StatusCode
DepName
Description
Type
DateTime
String
String
String
String
Length
50
10
50
50
Description
Date of status
Name of status
Code of status
Depot of status
Note
ColliHistory
Item of the status piece of shipment
Name
StatusDate
StatusName
StatusCode
DepName
Description
ColliNumber
Type
DateTime
String
String
String
String
String
Length Description
Date of status
50
Name of status
10
Code of status
50
Depot of status
50
Note
25
Number of the piece
PackageService
Item of shipment service
Name
Name
Price
Currency
Type
String
Decimal
Currency
Length
30
(12,2)
Description
Name of service
Service price
Currency
Length
Description
Number of pieces
Package
Description
Weight
PackageRow
Item of the shipment row
Name
CountItems
PackingType
Description
Weight
Type
Int
String
String
Decimal
30
30
(9,2)
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 24/53
Reference
Volume
Dimension
String
Decimal
String
Error codes
Code
0
1
2
3
4
50
(9,3)
Shipment status
OK
OK
OK
STORNO
Není
Customer´s reference
Volume
Dimension (return empty value)
Description
Non-delivery, it has status
Delivery, it has status
Does not have status yet
Shipment was cancelled.
Shipment does not exist.
An example of ShipmentDetail call method
Request:
<soap:Body>
<ShipmentDetail xmlns="http://tempuri.org/">
<Request>
</Header>
<ShipmentNumber>02093000033</ShipmentNumber>
</RequestObject>
</Request>
</ShipmentDetail>
</soap:Body>
</soap:Envelope>
Response:
<s:Body>
<ShipmentDetailResponse xmlns="http://tempuri.org/">
<ShipmentDetailResult xmlns:a="http://schemas.datacontract.org/2004/07/GService.Manager"
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 25/53
<a:ErrorMessage>Shipment OK - undelivered, has statuses.</a:ErrorMessage>
<a:ResponseObject>
<a:BorderDate>0001-01-01T00:00:00</a:BorderDate>
<a:CodValue>1,00</a:CodValue>
<a:CodVarCode>123</a:CodVarCode>
<a:ColliHistory i:nil="true" />
<a:DelivDate>0001-01-01T00:00:00</a:DelivDate>
<a:DelivPerson i:nil="true" />
<a:History>
<a:PackageHistory>
<a:DepName />
<a:Description>Reference to shipment</a:Description>
<a:StatusCode>121</a:StatusCode>
<a:StatusDate>2015-09-07T08:23:03.763</a:StatusDate>
<a:StatusName>Customer reference</a:StatusName>
</a:PackageHistory>
<a:PackageHistory>
<a:DepName />
<a:Description />
<a:StatusCode>174</a:StatusCode>
<a:StatusDate>2015-09-07T08:23:03.83</a:StatusDate>
<a:StatusName>Recipient’s phone</a:StatusName>
</a:PackageHistory>
</a:History>
<a:RecAddress>
<a:City>Mirošov</a:City>
<a:Country>Česká republika</a:Country>
<a:Name>Test GService - test GService</a:Name>
<a:Name2 />
<a:Street>Prokopova XXX</a:Street>
<a:ZipCode>33843</a:ZipCode>
</a:RecAddress>
<a:Rows i:nil="true" />
<a:SendAddress>
<a:City>Ejpovice</a:City>
<a:Country>Česká republika</a:Country>
<a:Name>Test GService - svozová adresa</a:Name>
<a:Name2 />
<a:Street>Zemská 211/I</a:Street>
<a:ZipCode>33701</a:ZipCode>
</a:SendAddress>
<a:Services>
<a:PackageService>
<a:Currency>UND</a:Currency>
<a:Name>Mýto</a:Name>
<a:Price>0.0000</a:Price>
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 26/53
</a:PackageService>
<a:PackageService>
<a:Name>Diesel surcharge </a:Name>
</a:PackageService>
<a:PackageService>
<a:Name> Transport costs </a:Name>
</a:PackageService>
<a:PackageService>
<a:Name>Cash on delivery</a:Name>
</a:PackageService>
<a:PackageService>
<a:Name>Private address</a:Name>
</a:PackageService>
</a:Services>
<a:ShipmentNumber>02093000033</a:ShipmentNumber>
<a:ShipmentNumberCust>Reference of shipment</a:ShipmentNumberCust>
<a:Volume>0</a:Volume>
<a:Weight>4.00</a:Weight>
</a:ResponseObject>
</ShipmentDetailResult>
</ShipmentDetailResponse>
</s:Body>
</s:Envelope>
RouteTable
It returns route table. It is possible to return the table for 7 days in advance. This information is
important for creation of label see System integration manual for customers section 2.4.Specification for
printing labels on the page 22.
Request
Name
Type
Header
RequestHeader
RequestObject RouteTableRequest
RouteTableRequest
Name
Type
Description
Header of request
Instance of the class RouteTableRequest
Mandatory
Y
Y
Description
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Mandatory
Y
Str. 27/53
ValidDate
Response
Name
Request
DateTime
Type
Request
ResponseObject
ErrorMessage
ErrorCode
Status
List<RouteTable>
String
String
ResponseStatus
Validity date
Y
Description
List of items from routing table
Error message
RouteTable
Name
DistributionChannel
Country
Depot
Route
ZipCodes
ValidDate
Type
Int
String
String
String
ZipCodes
Datetime
Length
2
2
4
Description
Service
Country
epot code
Route
Zip code from/to
Validity
An example of RouteTable call method
Request:
<soap:Body>
<RouteTable xmlns="http://tempuri.org/">
<Request>
</Header>
<ValidDate>2015-09-21T00:00:00</ValidDate>
</RequestObject>
</Request>
</RouteTable>
</soap:Body>
</soap:Envelope>
Response:
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 28/53
<s:Body>
<RouteTableResponse xmlns="http://tempuri.org/">
<RouteTableResult xmlns:a="http://schemas.datacontract.org/2004/07/GService.Manager"
<a:ErrorMessage />
<a:ResponseObject>
<a:RouteTable>
<a:Country>CZ</a:Country>
<a:Depot>81</a:Depot>
<a:Route>8109</a:Route>
<a:ValidDate>2015-09-21T00:00:00</a:ValidDate>
<a:ZipCodes>
</a:ZipCodes>
</a:RouteTable>
<a:RouteTable>
<a:Country>CZ</a:Country>
<a:Depot>81</a:Depot>
<a:Route>8111</a:Route>
<a:ValidDate>2015-09-21T00:00:00</a:ValidDate>
<a:ZipCodes>
</a:ZipCodes>
</a:RouteTable>
</a:ResponseObject>
</RouteTableResult>
</RouteTableResponse>
</s:Body>
</s:Envelope>
CreatePickUp
It creates pick up that belongs to expedition. It is an advice that shipments have been picked up
according to the requirement. The pickup may be ordered on the same day when you create requirement, but
maximum until 10:00 o´clock. After that, the date of pick up must be set up according to the definition: current
day + 1, but it must be a working day.
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 29/53
Request
Name
Type
Header
RequestHeader
RequestObject PickUpRequest
Description
Header of request
Instance of class PickUpRequest
PickUpRequest
Name
Type
DateFrom
DateTo
Length
DateTime
DateTime?
CountItems
Int
TotalWeight
Decimal
Contact
Contact
Note
String
PickUpItems
List<PickUpItem>
TemperatureMode Int
*mandatory for Cargo pick up
** Assumes values 1, 2
(9,2)
50
Mandatory
Y
Y
Description
Type of transport service(1 –
Parcel, 2 – Cargo)
Date and time of pick up from
Date and time of pick up to (day
and month must be same as
DateFrom)
Number of pieces
Total weight (kg)
Contact information
Note
List of pick up items
Code of temperature mode **
Mandatory
Y
Y
Y
Y*
Y
PickUpItem
Detail of pick up item.
Name
CountItems
Weight
Type
Reference
Type
Int
Decimal
String
String
Length
(9,2)
3
50
Response
Název
Request
Type
Request
ResponseObject
ErrorMessage
ErrorCode
Status
PickUp
String
String
ResponseStatus
Description
Number of items
Weight (kg)
Type of manipulating item
Reference
Mandatory
Description
Empty class
Error message
Error code (List of error codes is here)
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 30/53
An example of CreatePickUp call method
Request:
<soap:Body>
<CreatePickUp xmlns="http://tempuri.org/">
<Request>
</Header>
<Contact>
<Email>[email protected]</Email>
<FullName />
<Phone>+420951277777</Phone>
</Contact>
<CountItems>5</CountItems>
<DateFrom>2015-09-22T00:00:00</DateFrom>
<Note>Note to pick up.</Note>
<PickUpItems>
<PickUpItem>
<Reference />
<Type />
</PickUpItem>
</PickUpItems>
</RequestObject>
</Request>
</CreatePickUp>
</soap:Body>
</soap:Envelope>
Response:
<s:Body>
<CreatePickUpResponse xmlns="http://tempuri.org/">
<CreatePickUpResult xmlns:a="http://schemas.datacontract.org/2004/07/GService.Manager"
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 31/53
<a:ErrorMessage> Pick up accepted and confirmed.</a:ErrorMessage>
<a:ResponseObject />
<a:Status>Inserted</a:Status>
</CreatePickUpResult>
</CreatePickUpResponse>
</s:Body>
</s:Envelope>
InsertExport
It creates type of shipment expedition for the product (Parcel, Cargo). Expedition can be created for
current day, but there must be pick up for this day, otherwise the method ends with an error. To complete the
expedition you may need to know several data such as list of services – common for Parcel and Cargo (method
AddServiceList), list of merged shipments – only for Parcel, list of transport items (manipulating items,
WrapList method) – only for Cargo. Object InsertExport consists of several objects which can be entered as
field of objects (e.g. List of services) see next table ExportRequest.
Request
Name
Type
Header
RequestHeader
RequestObject ExportRequest
Description
Header of request
Instance of class ExportRequest
Mandatory
Y
Y
ExportRequest
Name
Type
Mandatory
Y
ShipmentNumber
Length Description
Type of transport service (1 –
Parcel, 2 – Cargo)
String
11 /
Number of shipment (for Parcel,
13
according to output method
AssignRange, for Cargo shipment
number is assigned automatically)
DateTime
Date of pick up (pick up must be
created for this date)
String
50
Shipment references
String
50
Note for recipient
String
50
Note for driver
Bool
Merged shipment (only for
parcel)
Decimal
(9,2)
Weight (in kg) (only for parcel)
List<ExportItem>
Transport items
Address
Cover address
Address
Delivery address
Contact
Contact for the recipient
List<ExportService>
List of shipment services
Y*
PickUpDate
Reference
Note
NoteDriver
MergedShipment
Weight
ExportItems
CoverAddress
DeliveryAddress
DeliveryContact
ExportServices
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Y*
Y*
Y**
Y
Str. 32/53
MergedPackages
List of merged shipments
(mandatory when parameter
MergedShipment is entered as
„true“)
*it is mandatory for pick up Parcel, **it is mandatory for Cargo
ExportService
Name
Code
Parameter_1
Parameter_2
Parameter_3
Parameter_4
Parameter_5
List<MergedItem>
Type
String
String
String
String
String
String
Description
Service code
Parameter 1
Parameter 2
Parameter 3
Parameter 4
Parameter 5
Y*
Mandatory
Y
Services parameter
List of services with specific parameters (mandatory in bold).
Code
ADL
ADZ
Parameter_1
Parameter_2
Parameter_3
Parameter_4
E-mail
Phone number
or E-mail
AOZ Phone number
or E-mail
APZ
Phone number
or E-mail
B2C Phone number
COD Value of cash on Currency of cash Payment
IBAN
delivery
on delivery
identification code
POJ
Value of
Currency
insurance
TEL
Phone number
VM* Code VM in
form:
VM-[0000] or
[0000]
GDO Phone number
or E-mail
*In VM service it is necessary to enter contact person (Name and phone number)
ExportItem
Name
CountItems
Description
Type
Reference
Weight
Volume
Type
Int
String
String
String
Decimal
Decimal
Length
50
2
50
(9,2)
(9,3)
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Description
Number of items
Description
Type
References
Weight (kg)
Volume (v m^3)
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Parameter_5
BIC
Mandatory
Y
Y
Y
Str. 33/53
Height
Decimal
Width
Decimal
Length
Decimal
**It is mandatory in Poland
MergedItem
Name
PackNumber
Weight
Type
String
Decimal
(9,2)
(9,2)
(9,2)
Height (in meters)
Width (in meters)
Length (in meters)
Y**
Y**
Y**
Length
20
(9,2)
Description
Number of shipment
Weight (kg)
Mandatory
Response
Name
Request
Type
Request
ResponseObject
ErrorMessage
ErrorCode
Status
Export
String
String
ResponseStatus
Description
Empty class
Error message
An example of InsertExport call method
Request:
<soap:Body>
<InsertExport xmlns="http://tempuri.org/">
<Request>
</Header>
<CoverAddress xsi:nil="true" />
<DeliveryAddress>
<City>Ejpovice</City>
<Country>CZ</Country>
<Name>Josef Novák</Name>
<Name2 />
<Street>Zemská 211/I</Street>
<ZipCode>33701</ZipCode>
</DeliveryAddress>
<DeliveryContact>
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 34/53
<FullName> Josef Novák </FullName>
<Phone>+420951277777</Phone>
</DeliveryContact>
<ExportItems>
<ExportItem>
<Description />
<Dimensions />
<Reference />
<Type />
</ExportItem>
</ExportItems>
<ExportServices>
<ExportService>
<Code>2</Code>
<Parameter_1>10</Parameter_1>
<Parameter_2>CZK</Parameter_2>
<Parameter_3 />
<Parameter_4 />
<Parameter_5 />
</ExportService>
</ExportServices>
<MergedPackages>
<MergedItem>
<PackNumber />
</MergedItem>
</MergedPackages>
<Note>Note to shipment</Note>
<NoteDriver>Note to driver</NoteDriver>
<PartnerNumber />
<PickUpDate>2015-09-22T00:00:00</PickUpDate>
<Reference>Reference to shipment</Reference>
<ShipmentNumber>02093120001</ShipmentNumber>
<Weight>11.5</Weight>
</RequestObject>
</Request>
</InsertExport>
</soap:Body>
</soap:Envelope>
Response:
<s:Body>
<InsertExportResponse xmlns="http://tempuri.org/">
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 35/53
<InsertExportResult xmlns:a="http://schemas.datacontract.org/2004/07/GService.Manager"
<a:ErrorMessage />
<a:ResponseObject>
<a:MergedPackNumbers i:nil="true" xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays" />
<a:PackNumber>02093120001</a:PackNumber>
</a:ResponseObject>
</InsertExportResult>
</InsertExportResponse>
</s:Body>
</s:Envelope>
InsertOrder
It creates type of shipment order for the product (Parcel, Cargo). The order can be created first for the
next working day. To complete the order some data are required such as list of services – common for Parcel
and Cargo (method AddServiceList), list of merged shipment – only Parcel, list of transport pieces
(manipulating items, WrapList method) – only for Cargo.
Object InsertOrder is created from several objects that may be entered as field of objects (e.g. list of
services) see following table OrderRequest.
Request
Name
Type
Header
RequestHeader
RequestObject OrderRequest
Description
Header of request
Instance of class OrderRequest
OrderRequest
Name
Type
Length
PickUpDate
Reference
DateTime
String
Note
NoteDriver
Weight
Volume
MergedOrder
ExportItems
SenderAddress
SenderContact
DeliveryAddress
String
String
Decimal
Decimal
Bool
List<ExportItem>
Address
Contact
Address
50
50
50
(9,2)
(9,3)
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Mandatory
Y
Y
Description
Type of transport service
(1 – Parcel, 2 – Cargo)
Date of pick up
Customer´s reference of
shipment
Note to recipient
Note for driver
Weight (kg)
Volume (m^3)
Merged order
List of transport pieces
Sender´s address
Sender´s contact
Recipient´s address
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Mandatory
Y
Y
Y*
Y*
Y**
Y
Y
Str. 36/53
DeliveryContact
ExportServices
MergedOrders
Contact
List<ExportService>
List<MergedItem>
Recipient´s contact
List of services
List of merged
shipments (mandatory
for MergedOrder
parameter entered to
„true“)
Y**
*mandatory for Parcel pickup, ** mandatory for Cargo
Response
Name
Request
Type
Request
ResponseObject
ErrorMessage
ErrorCode
Status
Order
String
String
ResponseStatus
Description
Information about entered order
Error message
Error code (list of error code is here)
Order
Name
Type
PackNumber
String
MergedPackNumbers List<String>
Length
20
Description
Number of parcel
List of numbers merged orders
An example of InsertOrder call method
Request:
<soap:Body>
<InsertOrder xmlns="http://tempuri.org/">
<Request>
</Header>
<DeliveryAddress>
<City>Ejpovice</City>
<Name>Josef Novák</Name>
<Name2 />
<Street>Zemská 211/1</Street>
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 37/53
</DeliveryAddress>
<DeliveryContact>
<FullName />
<Phone>+420951277777</Phone>
</DeliveryContact>
<ExportItems>
<ExportItem>
<Description />
<Dimensions />
<Reference />
<Type />
</ExportItem>
</ExportItems>
<ExportServices>
<ExportService>
<Code>15</Code>
<Parameter_1 />
<Parameter_2 />
<Parameter_3 />
<Parameter_4 />
<Parameter_5 />
</ExportService>
</ExportServices>
<MergedOrder>true</MergedOrder>
<MergedOrders>
<MergedItem>
<PackNumber />
<Weight>6</Weight>
</MergedItem>
</MergedOrders>
<Note />
<NoteDriver />
<PickUpDate>2015-09-22T00:00:00</PickUpDate>
<Reference />
<SenderAddress>
<City>Říčany</City>
<Name>František Dobrota</Name>
<Name2 />
<Street>Modletice 128, AOS 2</Street>
</SenderAddress>
<SenderContact>
<FullName />
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 38/53
<Phone>+420951277777</Phone>
</SenderContact>
<Weight>5</Weight>
</RequestObject>
</Request>
</InsertOrder>
</soap:Body>
</soap:Envelope>
Response:
<s:Body>
<InsertOrderResponse xmlns="http://tempuri.org/">
<InsertOrderResult xmlns:a="http://schemas.datacontract.org/2004/07/GService.Manager"
<a:ErrorMessage />
<a:ResponseObject>
<a:MergedPackNumbers xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<b:string>01061224431</b:string>
</a:MergedPackNumbers>
<a:PackNumber>01061224430</a:PackNumber>
</a:ResponseObject>
</InsertOrderResult>
</InsertOrderResponse>
</s:Body>
</s:Envelope>
AssignRange
It allocates number series (used only for Parcel shipment). To each new customer the number series is
allocated according to the expected number of shipments. In case primary range is exhausted and a new
requirement is created, the method finds, how many shipments customer has already sent and according to
internal algorithm it assigns a new number series or displays a message that number series cannot be
assigned, because there are still enough free numbers of shipments.
Request
Name
Type
Header
RequestHeader
RequestObject RangeRequest
Description
Header of request
Instance of class RangeRequest
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Mandatory
Y
Y
Str. 39/53
RangeRequest
Name
Type
TransportType
String
Range
Int
Length Description
Cargo)
1
Type of transport (1- internal, 2international)
Range (Number of shipment)
Response
Name
Request
Type
Request
ResponseObject
ErrorMessage
ErrorCode
Status
Range
String
String
ResponseStatus
Description
Information about range
Error message
Error code (list of error code is here)
Range
Name
RangeLow
RangeHigh
Type
String
String
Description
Lower limit of range
Upper limit of range
Mandatory
Y
Y
Y
An example of AssignRange method call
Request:
<soap:Body>
<AssignRange xmlns="http://tempuri.org/">
<Request>
</Header>
<Range>5</Range>
<TransportType>1</TransportType>
</RequestObject>
</Request>
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 40/53
</AssignRange>
</soap:Body>
</soap:Envelope>
Response:
<s:Body>
<AssignRangeResponse xmlns="http://tempuri.org/">
<AssignRangeResult xmlns:a="http://schemas.datacontract.org/2004/07/GService.Manager"
<a:ErrorMessage>Rozsah přidělen.</a:ErrorMessage>
<a:ResponseObject>
<a:RangeHigh>02093000075</a:RangeHigh>
<a:RangeLow>02093000071</a:RangeLow>
</a:ResponseObject>
</AssignRangeResult>
</AssignRangeResponse>
</s:Body>
</s:Envelope>
IsHealthy
In case of successful call method, this service answers with the text “Healthy”. This method is used for simple
text in case that service is running.
Example of IsHealthy method call
Request:
<soap:Body>
<IsHealthy xmlns="http://tempuri.org/" />
</soap:Body>
</soap:Envelope>
Response:
<s:Body>
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 41/53
<IsHealthyResponse xmlns="http://tempuri.org/">
<IsHealthyResult>Healthy</IsHealthyResult>
</IsHealthyResponse>
</s:Body>
</s:Envelope>
GetLabel
This method allows to get labels for shipments in specified format. The shipment has to be created via
G-Service and must belong to the logged-on customer, otherwise it ends with error message.
Request
Name
Type
Header
RequestHeader
RequestObject LabelRequest
LabelRequest
Name
Description
Header of request
Instance of class LabelRequest
ShipmentNumbers
Type
List<LabelItem>
Format
Int
Resolution
Int
DistributionChannel
Int
Position
Int
Mandatory
Y
Y
Description
List of objects LabelItem. Objects LabelItem
contains attribute ShipmentNumber, this
attribute is filled with number of shipment
printed on the label.
Determines format of generated file.
Allowed values :
1 – PDF
2 – EPL
3 - ZPL
4 – BMP (BMP file is transformed from TIFF file.)
Resolution. Fill this field only in case EPL/ZPL
label.
Allowed values :
200 – 200 DPI etiketa
300 – 300 DPI etiketa
Mandatory
Y
Y
Y
Determines the position of label in PDF file (one
page A4 allows print 4 labels).
Allowed values : 1, 2, 3, 4.
As response the GService returns the object LabelResponse
LabelResponse
Name
Type
ShipmentNumbers List<LabelItem>
LabelData
LabelData
Description
List of objects LabelItem, which should be
generated.
In response are the data returned as array of
bytes.
Allowed formats :
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Mandatory
Y
Y
Str. 42/53
Format - 1 (PDF) - .pdf
Format – 2 (EPL) - .txt
Format – 3 (ZPL) - .txt
Format – 4 (BMP) - .bmp
An example of GetLabel method call
Request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:tem="http://tempuri.org/" xmlns:gser="http://schemas.datacontract.org/2004/07/GService.Manager">
<soapenv:Header/>
<soapenv:Body>
<tem:GetLabel>
<tem:Request>
<gser:Header>
<gser:CustomerCode>22054861</gser:CustomerCode>
<gser:Language>EN</gser:Language>
<gser:Password>wspwd</gser:Password>
</gser:Header>
<gser:RequestObject>
<gser:DistributionChannel>1</gser:DistributionChannel>
<gser:Format>1</gser:Format>
<gser:Position>1</gser:Position>
<gser:ShipmentNumbers>

<gser:LabelItem>
<gser:ShipmentNumber>02092425453</gser:ShipmentNumber>
</gser:LabelItem>
</gser:ShipmentNumbers>
</gser:RequestObject>
</tem:Request>
</tem:GetLabel>
</soapenv:Body>
</soapenv:Envelope>
Response:
<s:Body>
<GetLabelResponse xmlns="http://tempuri.org/">
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 43/53
<GetLabelResult xmlns:a="http://schemas.datacontract.org/2004/07/GService.Manager"
<a:ErrorMessage/>
<a:Request>
<a:Header>
<a:CustomerCode>22055482</a:CustomerCode>
<a:Language>CZ</a:Language>
<a:Password>wspass</a:Password>
</a:Header>
<a:RequestObject>
<a:Format>1</a:Format>
<a:Position>1</a:Position>
<a:Resolution>0</a:Resolution>
<a:ShipmentNumbers>
<a:LabelItem>
</a:LabelItem>
</a:ShipmentNumbers>
</a:RequestObject>
</a:Request>
<a:ResponseObject>
<a:LabelData>
<a:LabelItemData>
<a:Data>There will be the binary data</a:Data>
</a:LabelItemData>
</a:LabelData>
<a:ShipmentNumbers i:nil="true"/>
</a:ResponseObject>
</GetLabelResult>
</GetLabelResponse>
</s:Body>
</s:Envelope>
ListOfShipments
This method returns a list of shipments created for specific pickup date. Method has two input
parameters, first is date of pickup (mandatory), the second parameter is identifier of the shipments group
(BurstId - obligatory). Method returns list of shipments with an identifier of shipment type (order or
expedition). If parameter BurstId is used, the method returns only the shipments with same value of BurstId.
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 44/53
Name
Type
Header
RequestHeader
RequestObject ShipmentRequest
ShipmentRequest
Name
Type
DateExpOrOrder DateTime
Description
Header of request
Instance of class ShipmentRequest
Mandatory
Y
Y
Mandatory
Y
BurstId
String(50)
Description
Date of order or expedition
Identifier of shipments group
Created
DateTime
Date of creation of order or expedition
ShipmentResponse
Name
Type
ShipmentNumber String
IsOrder
Bool
Description
Number of shipment
Identifier is i tis order or expedition
Mandatory
Y
An example of ListOfShipment method call:
Request :
<soapenv:Header/>
<soapenv:Body>
<tem:ListOfShipments>
<tem:Request>
<gser:Header>
<gser:Password>*****</gser:Password>
</gser:Header>
<gser:BurstId>666</gser:BurstId>
<gser:DateExpOrOrder>2016-04-29</gser:DateExpOrOrder>
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 45/53
</tem:Request>
</tem:ListOfShipments>
</soapenv:Body>
</soapenv:Envelope>
Response :
<s:Body>
<ListOfShipmentsResponse xmlns="http://tempuri.org/">
<ListOfShipmentsResult xmlns:a="http://schemas.datacontract.org/2004/07/GService.Manager"
<a:ErrorMessage/>
<a:Request i:nil="true"/>
<a:ResponseObject>
<a:ShipmentResponse>
<a:IsOrder>false</a:IsOrder>
</a:ShipmentResponse>
</a:ResponseObject>
</ListOfShipmentsResult>
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 46/53
</ListOfShipmentsResponse>
</s:Body>
</s:Envelope>
ShipmentStatus
Method returns status of shipment / shipments based on request. Statuses are equal with statuses of
GClient in list of expeditions / orders. As input parameter method demands number / array numbers of
shipment.
Name
Type
Description
Header
RequestHeader
Header of request
RequestObject ShipmentStatusRequest Instance of class ShipmentStatusRequest
Mandatory
Y
Y
Seznam stavů:
Code
Name
In progress
ROZ
Delivered
DLV
Back to consignor
BCK
Collected
PCK
Not collected
NPC
Export to L-WIS
EGP
Changing date of collection
CPD
Processed in GCARGO
ZGC
Canceled in GCARGO
SGC
For printing
NTI
Printed
TIS
Processed
ZPR
Cancelled
STO
Deleted
SMA
Import from GPACK
IGP
Processed in GPACK
ZGP
Canceled in GPACK
SGP
ShipmentStatusRequest
Name
Type
ShipmentNumber
ShipmentStatusResponse
Name
Type
ShipmentNumber String
StatusCode
String
Description
List of object of type ShipmentStatusItem,
which includes array of ShipmentNumber
Mandatory
Y
Description
Number of shipment
Code of status
Mandatory
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 47/53
StatusName
String
Name of status
An example of ShipmentStatus method call
Request :
<soapenv:Header/>
<soapenv:Body>
<tem:ShipmentStatus>
<tem:Request>
<gser:Header>
</gser:Header>
<gser:ShipmentsNumbers>
<gser:ShipmentStatusItem>
</gser:ShipmentStatusItem>
<gser:ShipmentStatusItem>
</gser:ShipmentStatusItem>
</gser:ShipmentsNumbers>
</tem:Request>
</tem:ShipmentStatus>
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 48/53
</soapenv:Body>
</soapenv:Envelope>
Response :
<s:Body>
<ShipmentStatusResponse xmlns="http://tempuri.org/">
<ShipmentStatusResult xmlns:a="http://schemas.datacontract.org/2004/07/GService.Manager"
<a:ErrorMessage/>
<a:ResponseObject>
<a:ShipmentStatusResponse>
<a:StatusCode>PCK</a:StatusCode>
<a:StatusName>Collected</a:StatusName>
</a:ShipmentStatusResponse>
<a:ShipmentStatusResponse>
<a:StatusCode>ZGP</a:StatusCode>
<a:StatusName>Processed in GPACK</a:StatusName>
</a:ShipmentStatusResponse>
</a:ResponseObject>
</ShipmentStatusResult>
</ShipmentStatusResponse>
</s:Body>
</s:Envelope>
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 49/53
GetPickupList
Method creates handover protocol in PDF format. The PDF format is the same as in application
GClient. Shipments on handover protocol must not be real, that means the shipment must not have any
operating status. As input parameter method accepts date of pickup of shipments (mandatory), type of
transport (cargo x parcel - mandatory) and number / array of numbers of shipment (not mandatory). If there is
any shipment number, the method returns all shipments with specific date of pickup.
Name
Type
Header
RequestHeader
RequestObject PickupListRequest
PickupListRequest
Name
Description
Header of request
Instance of class PickupListRequest
Mandatory
Y
Y
Description
Date of pickup
Distribution channel (parcel =1, cargo = 2)
List of object of type PickupListShipmItem,
which includes the parameter
ShipmentNumber
* Mandatory is to provide pickup-date or list of shipments
ExpeditionCreateDate
DistributionChannel
ShipmentNumbers
Type
DateTime
Int
List
PickupListReponse
Name
Type
PickupListData
Byte []
Description
Array of bytes. Includes byte representation of
the PDF handover protocol
Mandatory
Y*
Y
Y*
Mandatory
An example of GetPickupList method call
Request :
<soapenv:Header/>
<soapenv:Body>
<tem:GetPickupList>

Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 50/53
<tem:Request>
<gser:Header>


</gser:Header>
<gser:ExpeditionCreateDate>2016-04-29T00:00:00</gser:ExpeditionCreateDate>
</tem:Request>
</tem:GetPickupList>
</soapenv:Body>
</soapenv:Envelope>
Response :
<s:Body>
<GetPickupListResponse xmlns="http://tempuri.org/">
<GetPickupListResult xmlns:a="http://schemas.datacontract.org/2004/07/GService.Manager"
<a:ErrorMessage/>
<a:ResponseObject>
<a:PickupListData> there will be binary data </a:PickupListData>
</a:ResponseObject>
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 51/53
</GetPickupListResult>
</GetPickupListResponse>
</s:Body>
</s:Envelope>
DeleteShipment
Method for deleting shipments. This method is able to delete shipment, but only in case, that the
shipments is not real (does not have any operating status) and belongs to the logged in customer. Last day for
deleting orders is the day before the pickup date (until 24:00). As input parameters method accepts number /
array of numbers of shipment and type of transport (DistributionChannel - cargo x parcel). Method returns list
of numbers of shipment and information if the shipment was deleted or not (true x false).
Name
Type
Description
Header
RequestHeader
Header of request
RequestObject DeleteShipmentRequest Instance of class DeleteShipmentRequest
Mandatory
Y
Y
DeleteShipmentRequest
Name
Type
ShipmentsNumbers List
Description
List of object of type DeleteShipmentItem
DelteShipmentItem
Name
Type
ShipmentNumber
String
Description
Number of shipment
Distribution channel
Mandatory
Y
Y
Description
Number of shipment
Information, if the shipment was deleted or
not
Distribution channel
Mandatory
DeleteShipmentResponse
Name
Type
ShipmentNumber
String
IsStorno
Bit
DistributionChannel
Int
Mandatory
An example of DeleteShipment method call
Request :
<soapenv:Header/>
<soapenv:Body>
<tem:DeleteShipment>
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 52/53
<tem:Request>
<gser:Header>
</gser:Header>
<gser:ShipmentsNumbers>
<gser:DeleteShipmentItem>
</gser:DeleteShipmentItem>
<gser:DeleteShipmentItem>
</gser:DeleteShipmentItem>
</gser:ShipmentsNumbers>
</tem:Request>
</tem:DeleteShipment>
</soapenv:Body>
</soapenv:Envelope>
Response :
<s:Body>
<DeleteShipmentResponse xmlns="http://tempuri.org/">
<DeleteShipmentResult xmlns:a="http://schemas.datacontract.org/2004/07/GService.Manager"
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP
Str. 53/53
<a:ErrorMessage/>
<a:ResponseObject>
<a:ShipmentsNumbers>
<a:DeleteShipmentItemResponse>
<a:IsStorno>true</a:IsStorno>
</a:DeleteShipmentItemResponse>
<a:DeleteShipmentItemResponse>
<a:IsStorno>false</a:IsStorno>
</a:DeleteShipmentItemResponse>
</a:ShipmentsNumbers>
</a:ResponseObject>
</DeleteShipmentResult>
</DeleteShipmentResponse>
</s:Body>
</s:Envelope>
Geis CZ s.r.o.
Zemská 211/I
337 01 Ejpovice
Czech Republic
IČO: 44567359
DIČ: CZ44567359
Telefon: +420 951 277 777
Telefax: +420 951 220 259
Bankovní spojení:
Č.ú.: 1545471501/2700 (CZK)
Č.ú.: 1545471560/2700 (EUR)
EUR IBAN:
CZ56 2700 0000 0015 45471560
CZK IBAN:
CZ97 2700 0000 0015 45471501
SWIFT: BACXCZPP

G-Service

Transkript

Podobné dokumenty

Geis EDI Validátor – návod pro použití Geis EDI Validátor (v1.2)

Nastavení Java pro aplikaci G

Dokumentace k API Balíkobot v1.75 2016-09-14

- Příručka programátora Webové služby

DatoveRozhrani_ISORRVD-EVAL_091210

Značkovací jazyky na platformě GeoWeb - Institut geoinformatiky

webová služba pro posílání dávek dat do DB NOR a

Standard elektronické fakturace