Get reference data
Retrieves reference data of the types listed in the table below, along with related data when applicable (such as translations). Each reference data type is retrieved by a different method.
General reference data | Accounting reference data |
---|---|
Accounting agreements in place with partner operators Operator groups for accounting |
|
Accounting rates |
EDI data |
Terminal dues rates (letters and EMS) Internal Air Conveyance charges |
Mail items, receptacles, dispatches, consignments: EDI information from PREDES/RESDES |
Mail categories
Retrieves all mail categories defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/RefDataService.svc/rest/mailcategories?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
Mail categories list |
|||||
1 |
mailCategoryCd |
string |
The mail category code |
a1 |
A |
1 |
mailCategoryNm |
string |
The mail category name |
an..64 |
Air |
1 |
validInd |
number |
0 – Official reference data (invalid) 1 - Official reference data (valid) 2 – Own reference data (invalid) 3 - Own reference data (valid) |
n1 |
1 |
Translations |
|||||
2 |
languageCD |
string |
The language code for the translation |
an..2 |
FR |
2 |
translation |
string |
The translated mail category name |
an..128 |
Aérien |
Mail classes
Retrieves all mail classes defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/refdataservice.svc/rest/mailclasses?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
Mail classes list |
|||||
1 |
mailClassCd |
string |
The mail class code |
a1 |
C |
1 |
mailClassNm |
string |
The mail class name |
an..64 |
PARCELS (CP) |
1 |
validInd |
number |
0 – Official reference data (invalid) 1 - Official reference data (valid) 2 – Own reference data (invalid) 3 - Own reference data (valid) |
n1 |
1 |
Translations |
|||||
2 |
languageCD |
string |
The language code for the translation |
an..2 |
FR |
2 |
translation |
string |
The translated mail class name |
an..128 |
COLIS (CP) |
Mail subclasses
Retrieves all mail subclasses defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/refdataservice.svc/rest/mailsubclasses?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
Mail subclasses list |
|||||
1 |
mailSubclassCd |
string |
The mail subclass code |
a2 |
UN |
1 |
mailSubclassNm |
string |
The mail subclass name |
an..64 |
LETTERS - LC/AO |
1 |
mailClassCd |
string |
The mail class code |
a1 |
U |
1 |
validInd |
number |
0 – Official reference data (invalid) 1 - Official reference data (valid) 2 – Own reference data (invalid) 3 - Own reference data (valid) |
n1 |
1 |
Translations |
|||||
2 |
languageCD |
string |
The language code for the translation |
an..2 |
FR |
2 |
translation |
string |
The translated mail subclass name |
an..128 |
LETTRES - LC/AO |
Conveyance types
Retrieves all conveyance types defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/refdataservice.svc/rest/conveyancetypes?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
Conveyance types list |
|||||
1 |
conveyanceTypeCd |
string |
The conveyance type code |
a1 |
P |
1 |
conveyanceTypeNm |
string |
The conveyance type name |
an..64 |
Priority mail |
1 |
validInd |
number |
0 – Official reference data (invalid) 1 - Official reference data (valid) 2 – Own reference data (invalid) 3 - Own reference data (valid) |
n1 |
1 |
Translations |
|||||
2 |
languageCD |
string |
The language code for the translation |
an..2 |
FR |
2 |
translation |
string |
The translated conveyance type name |
an..128 |
Courrier prioritaire |
Product types
Retrieves all product types defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/refdataservice.svc/rest/producttypes?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
Product types list |
|||||
1 |
productTypeCd |
string |
The product type code |
a2 |
P |
1 |
mailClassCd |
string |
The mail class code |
a1 |
C |
1 |
productTypeNm |
string |
The product type name |
|
EPG |
1 |
validInd |
number |
0 – Official reference data (invalid) 1 - Official reference data (valid) 2 – Own reference data (invalid) 3 - Own reference data (valid) |
n1 |
1 |
Translations |
|||||
2 |
languageCD |
string |
The language code for the translation |
an..2 |
FR |
2 |
translation |
string |
The translated product type name |
an..128 |
EPG |
Receptacle content formats
Retrieves all receptacle content formats defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/refdataservice.svc/rest/receptaclecontentformats?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
Receptacle content formats list |
|||||
1 |
receptacleContentFormatCd |
string |
The receptacle content format code |
a1 |
P |
1 |
receptacleContentFormatNm |
string |
The receptacle content format name |
an..64 |
Small |
1 |
validInd |
number |
0 – Official reference data (invalid) 1 - Official reference data (valid) 2 – Own reference data (invalid) 3 - Own reference data (valid) |
n1 |
1 |
Translations |
|||||
2 |
languageCD |
string |
The language code for the translation |
an..2 |
FR |
2 |
translation |
string |
The translated receptacle content format name |
an..128 |
Petit |
Receptacle types
Retrieves the receptacle types defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/refdataservice.svc/rest/receptaclesubtypes?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
Receptacle types list |
|||||
1 |
receptacleSubtypeCd |
string |
The receptacle type code |
a2 |
BG |
1 |
receptacleSubtypeNm |
string |
The receptacle type name |
an..64 |
Bag |
1 |
receptacleTypeMaxWeight |
number |
The maximum allowed full weight for the receptacle type |
n5.3 |
12345.123 |
1 |
receptacleSubTypeWeight |
number |
The tare weight for the receptacle type |
n5.3 |
12345.123 |
1 |
parentRecetacleTypeCd |
string |
The parent receptacle type code |
a2 |
|
1 |
validInd |
number |
0 – Official reference data (invalid) 1 - Official reference data (valid) 2 – Own reference data (invalid) 3 - Own reference data (valid) |
n1 |
1 |
1 |
sampleRateCd |
string |
The sample rate code for the receptacle type |
a2 |
B1 |
1 |
tareMinWeight |
number |
The minimum expected tare weight for the receptacle type |
n5.3 |
12345.123 |
1 |
tareMaxWeight |
number |
The maximum expected tare weight for the receptacle type |
n5.3 |
12345.123 |
1 |
receptacleCategoryCd |
string |
The category of receptacle type: BG – Bag CN – Container PL – Pallet TR - Tray |
a2 |
BG |
Translations |
|||||
2 |
languageCD |
string |
The language code for the translation |
an..2 |
FR |
2 |
translation |
string |
The translated receptacle type name |
an..128 |
Sac |
Conditions
Retrieves the conditions defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/refdataservice.svc/rest/conditions?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
Conditions list |
|||||
1 |
conditionCd |
number |
The condition code |
0-255 |
20 |
1 |
conditionNm |
string |
The condition name |
an..64 |
Received here in good condition |
1 |
mailUnitTypeCd |
string |
The object type which the condition applies to. AC - Internal air conveyance AD - Accounting dispatch AF - Accounting form CL - Closed transit CS - Consignment CT - Container DC - Domestic consignment DD - Domestic dispatch DP - Dispatch DR - Domestic receptacle ER - External receptacle IB - Inner bag IK - IPK - Item Per Kilo LG - Leg MI - Mail item NP - New parcel bill rate OT - Open transit letters PC - International reply paid coupon PR - Parcel bill rate QY - Inquiry RC - Receptacle RS - Route schedule SL - Sampling rule SR - Sampled receptacle TD - Terminal due TI - Transport invoice TL - Transport line VN - Verification Note |
a2 |
MI |
1 |
validInd |
number |
0 – Official reference data (invalid) 1 - Official reference data (valid) 2 – Own reference data (invalid) 3 - Own reference data (valid) |
n1 |
1 |
Translations |
|||||
2 |
languageCD |
string |
The language code for the translation |
an..2 |
FR |
2 |
translation |
string |
The translated condition name |
an..128 |
Bon état |
Postal statuses
Retrieves the postal statuses defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/refdataservice.svc/rest/postalstatuses?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
Postal statuses list |
|||||
1 |
postalStatusCd |
number |
The postal status code |
0-255 |
0 |
1 |
postalStatusNm |
string |
The postal status name |
an..64 |
Normal |
1 |
mailUnitTypeCd |
string |
The object type which the postal status applies to. AC - Internal air conveyance AD - Accounting dispatch AF - Accounting form CL - Closed transit CS - Consignment CT - Container DC - Domestic consignment DD - Domestic dispatch DP - Dispatch DR - Domestic receptacle ER - External receptacle IB - Inner bag IK - IPK - Item Per Kilo LG - Leg MI - Mail item NP - New parcel bill rate OT - Open transit letters PC - International reply paid coupon PR - Parcel bill rate QY - Inquiry RC - Receptacle RS - Route schedule SL - Sampling rule SR - Sampled receptacle TD - Terminal due TI - Transport invoice TL - Transport line VN - Verification Note |
a2 |
MI |
1 |
postalStatusFCD |
string |
The postal status visible code |
an4 |
MINL |
1 |
validInd |
number |
0 – Official reference data (invalid) 1 - Official reference data (valid) 2 – Own reference data (invalid) 3 - Own reference data (valid) |
n1 |
1 |
Translations |
|||||
2 |
languageCD |
string |
The language code for the translation |
an..2 |
FR |
2 |
translation |
string |
The translated postal status name |
an..128 |
Normal |
Service indicators
Retrieves the service indicators defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/refdataservice.svc/rest/serviceindicators?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
Service indicators list |
|||||
1 |
serviceIndicatorMin |
string |
The start of the service indicator range |
a2 |
RA |
1 |
serviceIndicatorMax |
string |
The end of the service indicator range |
a2 |
RZ |
1 |
mailClassCd |
string |
The mail class which mail items with identifier falling with the service indicator range belong to |
a1 |
U |
1 |
mailItemCategoryCd |
string |
The handling class which mail items with identifier falling with the service indicator range belong to |
a2 |
RG |
1 |
conveyanceTypeCd |
string |
The conveyance type which mail items with identifier falling with the service indicator range have |
a1 |
P |
1 |
productTypeCd |
string |
The product type which mail items with identifier falling with the service indicator range belong to |
a..1 |
|
1 |
mailitemContentCd |
string |
The type of content of mail items with identifier falling with the service indicator range |
a..1 |
|
1 |
codIndicator |
number |
Whether or not mail items with identifier falling with the service indicator range are Cash on Delivery |
0-1 |
0 |
1 |
expressInd |
number |
Whether or not mail items with identifier falling with the service indicator range are Express (now called Tracked) |
0-1 |
0 |
Event types
Retrieves the event types defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/refdataservice.svc/rest/eventtypes?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
EventTypes |
|||||
1 |
eventTypeCd |
number |
The event type code |
0-65535 |
1 |
1 |
eventTypeNm |
string |
The event type name |
an..64 |
Receive item from customer (Otb) |
1 |
mailUnitTypeCd |
string |
The object type which the event type applies to. AC - Internal air conveyance AD - Accounting dispatch AF - Accounting form CL - Closed transit CS - Consignment CT - Container DC - Domestic consignment DD - Domestic dispatch DP - Dispatch DR - Domestic receptacle ER - External receptacle IB - Inner bag IK - IPK - Item Per Kilo LG - Leg MI - Mail item NP - New parcel bill rate OT - Open transit letters PC - International reply paid coupon PR - Parcel bill rate QY - Inquiry RC - Receptacle RS - Route schedule SL - Sampling rule SR - Sampled receptacle TD - Terminal due TI - Transport invoice TL - Transport line VN - Verification Note |
a2 |
MI |
1 |
inboundOutboundInd |
string |
The mail flow which the event type applies to I – Inbound O – Outbound N – Neutral |
a1 |
O |
1 |
resultStateIndCd |
number |
The object resulting state after the event occurs |
0-65535 |
0 |
1 |
validInd |
number |
0 – Official reference data (invalid) 1 - Official reference data (valid) 2 – Own reference data (invalid) 3 - Own reference data (valid) |
n1 |
1 |
AllowedInitialStates |
|||||
2 |
stateIndCd |
number |
The allowed initial states for the event to occur |
0-65535 |
3 |
Translations |
|||||
2 |
languageCD |
string |
The language code for the translation |
an..2 |
FR |
2 |
translation |
string |
The translated event type name |
an..128 |
Postage au bureau d'origine |
State indicators
Retrieves the state indicators defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/refdataservice.svc/rest/stateinds?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
State list |
|||||
1 |
stateIndCd |
number |
The state indicator code |
0-65535 |
0 |
1 |
stateIndNm |
string |
The state indicator name |
an..64 |
Unassigned (not in a bag) |
1 |
mailUnitTypeCd |
string |
The object type which the state indicator applies to. AC - Internal air conveyance AD - Accounting dispatch AF - Accounting form CL - Closed transit CS - Consignment CT - Container DC - Domestic consignment DD - Domestic dispatch DP - Dispatch DR - Domestic receptacle ER - External receptacle IB - Inner bag IK - IPK - Item Per Kilo LG - Leg MI - Mail item NP - New parcel bill rate OT - Open transit letters PC - International reply paid coupon PR - Parcel bill rate QY - Inquiry RC - Receptacle RS - Route schedule SL - Sampling rule SR - Sampled receptacle TD - Terminal due TI - Transport invoice TL - Transport line VN - Verification Note |
a2 |
MI |
1 |
validInd |
number |
0 – Official reference data (invalid) 1 - Official reference data (valid) 2 – Own reference data (invalid) 3 - Own reference data (valid) |
n1 |
1 |
Translations list |
|||||
2 |
languageCD |
string |
The language code for the translation |
an..2 |
FR |
2 |
translation |
string |
The translated state indicator name |
an..128 |
Non assigné (pas dans un sac) |
Currencies
Retrieves the currencies defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/refdataservice.svc/rest/currencies?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
Currencies list |
|||||
1 |
currencyCd |
string |
The currency code |
an3 |
AED |
1 |
currencyNm |
string |
The currency name |
an..64 |
UAE Dirham |
1 |
validInd |
number |
0 – Official reference data (invalid) 1 - Official reference data (valid) 2 – Own reference data (invalid) 3 - Own reference data (valid) |
n1 |
1 |
Translations list |
|||||
2 |
languageCD |
string |
The language code for the translation |
an..2 |
FR |
2 |
translation |
string |
The translated currency name |
an..128 |
Dirham des émirats arabes unis |
Countries
Retrieves the countries defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/refdataservice.svc/rest/countries?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
Countries list |
|||||
1 |
countryCd |
string |
The country code |
an3 |
AM |
1 |
countryNm |
string |
The country name |
an..64 |
ARMENIA |
1 |
validInd |
number |
0 – Official reference data (invalid) 1 - Official reference data (valid) 2 – Own reference data (invalid) 3 - Own reference data (valid) |
n1 |
1 |
1 |
latitude |
number |
The country latitude |
signed integer or empty |
-4000 |
1 |
longitude |
number |
The country longitude |
signed integer or empty |
4500 |
1 |
euEntranceDt |
string |
The date of country entry in the EU |
YYYY-MM-DD or empty |
|
Translations list |
|||||
2 |
languageCD |
string |
The language code for the translation |
an..2 |
FR |
2 |
translation |
string |
The translated country name |
an..128 |
ARMENIE |
Example
Response
See the example JSON response body here.
Postal operators
Retrieves the postal operators defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/refdataservice.svc/rest/operators?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
Operators list |
|||||
1 |
operatorCd |
string |
The operator code |
an3 |
AMA |
1 |
operatorLongNm |
string |
The operator long name |
an..64 |
Societe anonyme Haypost Armenia |
1 |
operatorShortNm |
string |
The operator short name |
an..64 |
Haypost AM |
1 |
validInd |
number |
0 – Official reference data (invalid) 1 - Official reference data (valid) 2 – Own reference data (invalid) 3 - Own reference data (valid) |
n1 |
1 |
1 |
paymentMethodCd |
string |
The pauyment method for the accounting with the operator DR - UP - |
an2 |
DR |
1 |
emailAddress |
string |
The general email address for the operator |
an..64 |
|
1 |
postalAddress |
string |
The general postal address for the operator |
an..250 |
|
1 |
etoeSeparateInd |
string |
TBC |
an1 |
N |
1 |
numberSamplingDays |
number |
TBC |
positive integer |
|
Countries list |
|||||
2 |
countryCD |
string |
The code of the country where the operator operates |
an2 |
AM |
Airlines
Retrieves the airlines defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/refdataservice.svc/rest/airlines?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
Airlines list |
|||||
1 |
airlineCd |
string |
The airline code |
an..3 |
LX |
1 |
airlineNm |
string |
The airline name |
an..64 |
SWISS International Air Lines Ltd |
1 |
validInd |
number |
0 – Official reference data (invalid) 1 - Official reference data (valid) 2 – Own reference data (invalid) 3 - Own reference data (valid) |
n1 |
1 |
IMPCs
Retrieves the IMPCs defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/refdataservice.svc/rest/impcs?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
Offices |
|||||
1 |
officeFcd |
string |
The office code |
an6 |
CAYTOA |
1 |
officeLongNm |
string |
The office long name |
an..64 |
TORONTO-A |
1 |
officeShortNm |
string |
The office short name |
an..64 |
TORONTO-A |
1 |
countryCd |
string |
The country where the office is located |
a2 |
CA |
1 |
operatorCd |
string |
The postal operator which the office belongs to |
a3 |
CAA |
1 |
validInd |
number |
0 – Official reference data (invalid) 1 - Official reference data (valid) 2 – Own reference data (invalid) 3 - Own reference data (valid) |
n1 |
1 |
1 |
emailAddress |
string |
The general email address for the office |
an..64 |
|
1 |
postalAddress |
string |
The general postal address for the office |
an..250 |
|
1 |
restrictions |
string |
Free text restrictions for the office as defined in UPU Code List 108 |
an..512 |
|
1 |
validFrom |
string |
The date of validity start of the office |
YYYY-MM-DD |
2003-10-04 |
1 |
validTo |
string |
The date of validity end of the office |
YYYY-MM-DD or empty |
|
1 |
dispatchesRoutedVia |
string |
Office from which consignments containing receptacles originating from the office are sent |
an6 or empty |
|
1 |
specialType |
string |
Special use of the office <empty> - no special use E – ETOE M – Military mail facility |
a1 or empty |
|
1 |
bilateralAgreementRequired |
number |
Whether or not a bilateral agreement is required for sending mail to this office |
0-1 |
0 |
MailFlows |
|||||
2 |
mailFlowCd |
string |
The mail flow supported by the office I – Inbound O – Outbound T – Transit |
a1 |
I |
MailCategoriesInbound |
|||||
2 |
mailCategoryCd |
string |
Mail category accepted by the office in inbound |
a1 |
A |
MailClassesInbound |
|||||
2 |
mailClassCd |
string |
Mail class accepted by the office in inbound |
a1 |
U |
MailCategoriesOutbound |
|||||
2 |
mailCategoryCd |
string |
Mail category accepted by the office in outbound |
a1 |
A |
MailClassesOutbound |
|||||
2 |
mailClassCd |
string |
Mail class accepted by the office in outbound |
a1 |
U |
OfficeTypes |
|||||
2 |
officeTypeCd |
string |
Type of office AMF - Air Mail Facility CUS - Customs office MPF - Mail Processing Facility OOE - Office of Exchange PCD - Postcode POD - Point of Delivery POL - Point of Lodging |
an3 |
OOE |
Example
Response
See the example JSON response body here.
Locations
Retrieves the locations defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/refdataservice.svc/rest/locations?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
locations |
|||||
1 |
locationFcd |
string |
The location code (country code + location code) |
an5 |
CAYTO |
1 |
countryCd |
string |
The country where the location is located |
a2 |
CA |
1 |
locationCd |
string |
The location code (without country code) |
a3 |
YTO |
1 |
locationNm |
string |
The location name |
an..64 |
Metropolitan Area Apt/Toronto |
1 |
locationStatusCd |
string |
The status of location |
a2 |
AI |
1 |
suspendedInd |
number |
Whether the location is temporarily suspended |
0-1 |
0 |
1 |
validInd |
number |
0 – Official reference data (invalid) 1 - Official reference data (valid) 2 – Own reference data (invalid) 3 - Own reference data (valid) |
n1 |
1 |
1 |
iataInd |
number |
|
|
|
1 |
latitude |
number |
The location latitude |
signed integer or empty |
|
1 |
longitude |
number |
The location longitude |
signed integer or empty |
|
1 |
cutoffAtOrigin |
number |
Number of minutes to load mail into a transport at this location |
|
|
1 |
cutoffAtDestination |
number |
Number of minutes to offload mail from a transport at this location |
|
|
1 |
minimumTransitTime |
number |
Number of minutes required to move mail from a transport to another at this location |
|
|
locationTypes |
|||||
2 |
locationTypeCd |
string |
Type of location |
a1 |
0 |
Location types
Retrieves the location types defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/refdataservice.svc/rest/locationtypes?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
locationTypes |
|||||
1 |
locationTypeCd |
string |
The location type code |
a1 |
4 |
1 |
locationTypeNm |
string |
The location type name |
an..64 |
Airport |
1 |
validInd |
number |
0 – Official reference data (invalid) 1 - Official reference data (valid) 2 – Own reference data (invalid) 3 - Own reference data (valid) |
n1 |
1 |
Translations |
|||||
2 |
languageCD |
string |
The language code for the translation |
an..2 |
FR |
2 |
translation |
string |
The translated location type name |
an..128 |
Aéroport |
Location statuses
Retrieves the location statuses defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/refdataservice.svc/rest/locationstatuses?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
locationStatus |
|||||
1 |
locationStatusCd |
string |
The location status code |
a1 |
AA |
1 |
locationStatusNm |
string |
The location status name |
an..64 |
Approved by government |
1 |
validInd |
number |
0 – Official reference data (invalid) 1 - Official reference data (valid) 2 – Own reference data (invalid) 3 - Own reference data (valid) |
n1 |
1 |
Translations |
|||||
2 |
languageCD |
string |
The language code for the translation |
an..2 |
FR |
2 |
translation |
string |
The translated location status name |
an..128 |
Approuvé par le gouvernement |
Own offices
Retrieves the own offices defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/refdataservice.svc/rest/ownoffices?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
ownOffices |
|||||
1 |
ownOfficeCd |
number |
The office internal identifier |
0-65535 |
0 |
1 |
ownOfficeFcd |
string |
The office code |
an..25 |
CAYTOA |
1 |
ownOfficeNm |
string |
The office name |
an..64 |
TORONTO-A |
1 |
dbServerNm |
string |
The IPS databsase server where data for this office is located (in case of distributed IPS architecture) |
an..32 or empty |
|
1 |
validInd |
number |
0 – Official reference data (invalid) 1 - Official reference data (valid) 2 – Own reference data (invalid) 3 - Own reference data (valid) |
n1 |
1 |
1 |
phoneNo |
string |
The phone number of the office |
an..64 |
|
1 |
comments |
string |
Free text comments |
an..256 |
|
1 |
houseNumber |
string |
The house number of the office address |
an..30 |
|
1 |
addressLine1 |
string |
Office address – line 1 |
an..105 |
|
1 |
addressLine2 |
string |
Office address – line 2 |
an..105 |
|
1 |
postcode |
string |
Office postcode |
an..17 |
|
1 |
city |
string |
Office city |
an..32 |
|
1 |
customsOfficeCd |
string |
The customs office associated to the office |
an..25 |
|
1 |
customsOfficeTypeCd |
string |
The type of customs office which the office is associated to
OE - At the office of exchange; default value R - Remote Customs, i.e. Customs in the domestic network, no return to the Inward OE ROE - Remote to the OE with return to the OE for injection into the domestic network |
a..3 |
|
locations |
|||||
2 |
locationFcd |
string |
The locations which the office is linked to |
a5 |
CAYTO |
mailSubClasses |
|||||
2 |
mailSubclassCd |
string |
Mail subclass supported by the office |
a2 |
UN |
officeTypes |
|||||
2 |
officeTypeCd |
string |
Type of office AMF - Air Mail Facility CUS - Customs office MPF - Mail Processing Facility OOE - Office of Exchange PCD - Postcode POD - Point of Delivery POL - Point of Lodging |
an3 |
OOE |
Accounting agreement types
Retrieves the accounting agreement types defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/accountingrateservice.svc/rest/accountingagreementtypes?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
accountingAgreementTypes |
|||||
1 |
AccountingAgreementTypeCd |
string |
The accounting agreement type code |
an..5 |
LETR |
1 |
AccountingAgreementTypeNm |
string |
The accounting agreement type name |
an..64 |
Letters |
1 |
DefaultInd |
number |
Default indicator |
n1 |
1 |
1 |
MailClassCd |
string |
The mail class which the agreement type applies to |
a1 |
U |
1 |
ProductTypeCd |
string |
The product type which the agreement type applies to |
a1 |
NULL |
1 |
ValidInd |
number |
Validity indicator |
n1 |
1 |
Translations |
|||||
2 |
languageCD |
string |
The language code for the translation |
an..2 |
FR |
2 |
translation |
string |
The translated agreement type name |
an..128 |
Lettres |
Accounting agreements
Retrieves the accounting agreements in place with partner operators in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/accountingrateservice.svc/rest/accountingagreements?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
AccountingAgreements |
|||||
1 |
OperatorCd |
|
|
|
|
1 |
AccountingAgreementTypeCd |
string |
The accounting agreement type code |
an..5 |
LETR |
1 |
ValidYearFrom |
number |
The validity start year for the agreement |
n4 |
2020 |
1 |
ValidYearTo |
number |
The validity end year for the agreement |
n4 |
2021 |
1 |
CurrencyCd |
string |
The currency used in accounting forms under this agreement |
a3 |
XDR |
1 |
RatesSdrInd |
number |
Whether rates used under this agreement are in XDR or in the same currency as the accounting forms |
n1 |
1 |
1 |
EMailAddress |
string |
The email address used to communicate with the operator under this agreement |
an..64 |
|
1 |
PostalAddress |
string |
The postal address used to communicate with the operator under this agreement |
an..250 |
|
1 |
AccStageTypeCd |
string |
The accounting stage of the operator |
an..3 |
1.1 |
1 |
QosParticipation |
number |
Whether there is Quality Of Service participation for this operator |
n1 |
0 |
1 |
QosCompulsory |
number |
Percentage of the compulsory QoS participation |
n3.n3 |
0.500 |
1 |
QosBonus |
number |
Percentage of the bonus QoS participation |
n3.n3 |
0.500 |
1 |
WeightConfig |
string |
Bit map to define the use or net or gross weight for the REIMS letter accounting with this operator |
an..255 |
NULL |
1 |
BulkyIbrsStatus |
number |
Operator status in relation to Bulky IBRS (REIMS only) |
n1 |
0 |
1 |
PredesAutoValidation |
number |
Whether PREDES 2.1 messages from this operator will be used to create validate accounting dispatch entries |
n1 |
1 |
1 |
IbrsReimsMethodB |
number |
Whether IBRS mail is included or excluded from CN55/CN56/e55 for this operator |
n1 |
0 |
1 |
BulkMailExcludedFromIacSent |
number |
Whether bulk mail is included or excluded from CN66/CN51 sent to this operator |
n1 |
0 |
1 |
BulkMailExcludedFromIacReceived |
number |
Whether bulk mail is included or excluded from CN66/CN51 received from this operator |
n1 |
0 |
1 |
ExcludeURandUXMailFromSampling |
number |
Exclude UR and UX dispatches sent by this operator from sampling |
n1 |
0 |
1 |
DefaultCP94EcommerceRateStep |
number |
Default weight braket rate to be used in CP94 E-commerce for this operator |
n1 |
0 |
1 |
SlitContentFormatInbound |
number |
Whether content format separation applies to dispatches received from this operator |
n1 |
0 |
1 |
SplitContentFormatOutbound |
number |
Whether content format separation applies to dispatches sent to this operator |
n1 |
0 |
1 |
PerformanceValueThreshold |
number |
EMS PfP threshold value (in %) |
n3.n3 |
0.500 |
1 |
PerformanceValuePenalty |
number |
EMS PfP penalty value (in %) |
n3.n3 |
0.500 |
1 |
DirectParcelsCurrencyCd |
string |
Currency for Interconnect accounting forms for direct parcels |
a3 |
XDR |
1 |
ReturnedParcelsCurrencyCd |
string |
Currency for Interconnect accounting forms for returned parcels |
a3 |
XDR |
1 |
TransitParcelsCurrencyCd |
string |
Currency for Interconnect accounting forms for transit parcels |
a3 |
XDR |
Accounting stream types
Retrieves the accounting stream types defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/accountingrateservice.svc/rest/accountingstreamtypes?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
AccountingStreamTypes |
|||||
1 |
AccountingStreamTypeID |
number |
The stream identifier |
n..3 |
11 |
1 |
AccountingStreamTypeNm |
string |
The stream name |
an..64 |
Letters: LCAO |
1 |
AccountingAgreementTypeCd |
string |
The accounting agreement type which the stream refers to |
an..5 |
LETR |
1 |
MailSubclassFCD |
string |
The mail subclass which the stream refers to |
n2 |
NULL |
1 |
ReceptacleSubTypeCd |
string |
The receptacle type which the stream refers to |
an..5 |
NULL |
1 |
ReceptacleContentFormatCd |
string |
The content format which the stream refers to |
a1 |
NULL |
1 |
MailItemCategoryCd |
string |
The mail item category which the stream refers to |
a2 |
NULL |
1 |
MailCharacCd |
string |
The mail characteristics which the stream refers to |
TBC |
NULL |
1 |
RateConfig |
string |
The rate configuration for the stream |
an..32 |
0#0#1#1#1# |
1 |
ValidInd |
number |
Valid indicator |
n1 |
1 |
Accounting periods
Retrieves the accounting peridos defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/accountingrateservice.svc/rest/accountingperiods?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
AccountingPeriods |
|||||
1 |
AccountingPeriodCd |
string |
The accounting period code |
a1 |
M |
1 |
AccountingPeriodNm |
string |
The accounting period name |
an..32 |
Monthly |
Translations |
|||||
2 |
languageCD |
string |
The language code for the translation |
an..2 |
FR |
2 |
translation |
string |
The translated accounting period name |
an..128 |
Mensuel |
Accounting action types
Retrieves the accounting action types defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/accountingrateservice.svc/rest/accountingactiontypes?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
AccountingActionTypes |
|||||
1 |
AccountingActionTypeCd |
string |
The accounting action type code |
a1 |
1 |
1 |
AccountingActionTypNm |
string |
The accounting action type name |
an..32 |
Letters: quarter (CN55+CN56) |
1 |
ValidInd |
number |
Valid indicator |
n1 |
3 |
1 |
MailFlow |
string |
The mail flow which the accounting action type refers to |
a1 |
I |
1 |
MailCategoryCd |
string |
The mail category which the accounting action type refers to |
a1 |
NULL |
1 |
PeriodCd |
string |
The period type which the accounting action type refers to |
a1 |
Q |
1 |
AccountingTypeCd |
string |
The accounting type which the accounting action type refers to |
n3 |
1 |
1 |
MailClassCd |
string |
The mail class which the accounting action type refers to |
a1 |
U |
1 |
ProductTypeCd |
string |
The product type which the accounting action type refers to |
a1 |
NULL |
1 |
SupplementaryInd |
number |
Whether the accounting action supports supplementary forms generation |
a1 |
1 |
Translations |
|||||
2 |
languageCD |
string |
The language code for the translation |
an..2 |
FR |
2 |
translation |
string |
The translated accounting action type name |
an..128 |
Lettres: trimestre (CN55+CN56) |
AccountingForms |
|||||
2 |
AccountingFormTypeCd |
string |
The accounting form type associated to the accounting action |
an..20 |
CN55 |
2 |
FormOrder |
number |
The execution order of the form type within the action |
1-255 |
2 |
2 |
HasAdditionalCosts |
string |
Whether the form types allows manually specifying additional costs |
a1 |
NULL |
2 |
DoUpuClearing |
string |
Whether the form allows export to UPU clearing |
a1 |
NULL |
Accounting operator groups
Retrieves the accounting operator groups defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/accountingrateservice.svc/rest/accountingoperatorgroups?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
AccountingOperatorGroups |
|||||
1 |
AccountingOperatorGroupCd |
string |
The accounting operator group code |
an…6 |
EU |
1 |
AccountingOperatorGroupNm |
string |
The accounting operator group name |
an..64 |
European Union operators |
Operators |
|||||
2 |
OperatorCd |
string |
The code of the operator member of the group |
an..3 |
FRA |
Allowed partnerships for document capture
Retrieves the allowed partnerships for document capture defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/accountingrateservice.svc/rest/documentpartnerships?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
DocumentPartnerships |
|||||
1 |
MailCategoryCd |
string |
The mail category of the dispatches allowed under this document capture partnership |
a1 |
A |
1 |
OriginOfficeFcd |
string |
The origin office of the dispatches allowed under this document capture partnership |
a6 |
ITLINA |
1 |
DestOfficeFcd |
string |
The destination office of the dispatches allowed under this document capture partnership |
a6 |
CAYTOA |
1 |
MailClassCd |
string |
The mail class of the dispatches allowed under this document capture partnership |
a1 |
U |
1 |
MailSubclassCd |
string |
The mail subclass of the dispatches allowed under this document capture partnership |
a2 |
UN |
1 |
ValidFrom |
string |
The validity start date for the partnership |
YYYY-MM-DD |
2020-01-01 |
1 |
ValidTo |
string |
The validity end date for the partnership |
YYYY-MM-DD |
2020-12-31 |
1 |
ScanRecInd |
number |
Whether receptacles in dispatches under this partnership contain barcoded labels |
a1 |
1 |
1 |
EtaHours |
number |
TBC |
|
|
Verification note reasons
Retrieves the verification note reasons defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/accountingratesservice.svc/rest/vnreasons?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
VnReasons |
|||||
1 |
VNReasonCd |
string |
The reason code |
an2 |
20 |
1 |
VNReasonNm |
string |
The reason name |
an..128 |
Good condition |
1 |
VNReasonCategoryCd |
string |
The reason category code |
a1 |
R |
1 |
ValidInd |
number |
Valid indicator |
n1 |
1 |
1 |
DisplayAsOtherIrregularityOnCN43 |
string |
Whether the reason shall be displayed as part of the Other irregularities on CN43 forms |
a1 |
0 |
1 |
DisplayAsOtherIrregularityOnCP78 |
string |
Whether the reason shall be displayed as part of the Other irregularities on CP78 forms |
a1 |
0 |
1 |
DisplayAsOtherIrregularityOnE2 |
string |
Whether the reason shall be displayed as part of the Other irregularities on E2 forms |
a1 |
0 |
Translations |
|||||
2 |
languageCD |
string |
The language code for the translation |
an..2 |
FR |
2 |
translation |
string |
The translated reason name |
an..128 |
Bon état |
Verification note reason categories
Retrieves the verification note reason categories defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/accountingratesservice.svc/rest/vnreasoncagtegories?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
ReasonCategories |
|||||
1 |
VNReasonCategoryCd |
string |
The reason category code |
a1 |
R |
1 |
VnReasonCategoryNm |
string |
The reason category name |
an..64 |
Receptacle irregularities |
Translations |
|||||
2 |
languageCD |
string |
The language code for the translation |
an..2 |
FR |
2 |
translation |
string |
The translated category name |
an..128 |
Irrégularités de réceptacle |
Terminal dues rates
Retrieves the terminal dues rates defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/accountingrateservice.svc/rest/terminaldues?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
validOn
|
N | Retrieves only rates valid on the specified date |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
TerminalDues |
|||||
1 |
AccountingStreamId |
string |
The accounting stream type which the rate applies to |
n..3 |
11 |
1 |
OperatorCd |
string |
The operator which the rate applies to |
an3 |
FRA |
1 |
PartnerOfficeFcd |
string |
The partner office which the rate applies to |
an6 |
FRCGDA |
1 |
OwnOfficeFcd |
string |
The own office which the rate applies to |
an6 |
CAYTOA |
1 |
ConveyanceTypeCd |
string |
The conveyance type which the rate applies to |
a1 |
N |
1 |
MailFlow |
string |
The mail flow which the rate applies to |
a1 |
I |
1 |
ValidFrom |
string |
The validity start date of the rate |
YYYY-MM-DD |
2020-01-01 |
1 |
ValidTo |
string |
The validity end date of the rate |
YYYY-MM-DD |
2020-12-31 |
1 |
MailCategoryCd |
string |
The mail category which the rate applies to |
a1 |
A |
1 |
ProductTypeCd |
String |
TBC |
|
|
1 |
RateCriteriaCd |
String |
TBC |
|
|
1 |
MultirateCriteriaPid |
string |
TBC |
|
|
1 |
RateRevised |
number |
TBC |
|
|
1 |
RateKg |
number |
The rate per kilogram |
n..3.n4 |
1.2345 |
1 |
RateItem |
number |
The rate per item |
n..3.n4 |
1.2345 |
1 |
LastModifiedDate |
string |
The date of last modification of the rate |
YYYY-MM-DD |
2020-12-31 |
History |
|||||
2 |
AccountingStreamId |
string |
The accounting stream type which the rate applies to |
n..3 |
11 |
2 |
OperatorCd |
string |
The operator which the rate applies to |
an3 |
FRA |
2 |
PartnerOfficeFcd |
string |
The partner office which the rate applies to |
an6 |
FRCGDA |
2 |
OwnOfficeFcd |
string |
The own office which the rate applies to |
an6 |
CAYTOA |
2 |
ConveyanceTypeCd |
string |
The conveyance type which the rate applies to |
a1 |
N |
2 |
ValidFrom |
string |
The validity start date of the rate |
YYYY-MM-DD |
2020-01-01 |
2 |
ValidTo |
string |
The validity end date of the rate |
YYYY-MM-DD |
2020-12-31 |
2 |
MailCategoryCd |
string |
The mail category which the rate applies to |
a1 |
A |
2 |
ProductTypeCd |
String |
TBC |
|
|
2 |
RateCriteriaCd |
String |
TBC |
|
|
2 |
MultirateCriteriaPid |
string |
TBC |
|
|
2 |
RateRevised |
number |
TBC |
|
|
2 |
RateKg |
number |
The rate per kilogram |
n..3.n4 |
1.2345 |
2 |
RateItem |
number |
The rate per item |
n..3.n4 |
1.2345 |
2 |
LastModifiedDate |
string |
The date of last modification of the rate |
YYYY-MM-DDTHH:MM:SS.ms |
2020-12-31T15:35:21:123 |
2 |
Action |
string |
The type of action taken on the rate |
Update or Delete |
Update |
2 |
ActionDate |
string |
The date the action was taken |
YYYY-MM-DDTHH:MM:SS.ms |
2020-12-31T15:35:21:123 |
Calculated IPKs
Retrieves the calculated IPKs defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/accountingrateservice.svc/rest/calculatedipks?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
validOn
|
N | Retrieves only rates valid on the specified date |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
CalculatedIpks |
|||||
1 |
OperatorCd |
string |
The operator which the IPK applies to |
an3 |
FRA |
1 |
MailFlow |
string |
The mail flow which the IPK applies to |
a1 |
I |
1 |
Year |
number |
The year which the IPK applies to |
n4 |
2020 |
1 |
Period |
string |
The period (month, quarter, semester) which the IPK applies to |
1-12 |
2 |
1 |
PeriodCd |
string |
The period type which the IPK applies to |
a1 |
Q |
1 |
MailCategoryCd |
string |
The mail category which the IPK applies to |
a1 |
A |
1 |
MailSubclassCd |
string |
The mail subclass which the IPK applies to |
a2 |
UN |
1 |
ReceptacleContentFormatCd |
string |
The content format which the IPK applies to |
a1 |
P |
1 |
ProductTypeCd |
string |
The product type which the IPK applies to |
a1 |
NULL |
1 |
OwnOfficeFcd |
string |
The own office which the IPK applies to |
an6 |
CAYTOA |
1 |
PartnerOfficeFcd |
string |
The partner office which the IPK applies to |
an6 |
FRCGDA |
1 |
ReceptacleSubTypeCd |
string |
The receptacle type which the IPK applies to |
a2 |
BG |
1 |
AdjustmentNetGross |
number |
The gross-net adjustment |
0.00001-1 |
0.12345 |
1 |
SampleNet |
number |
The net weight sampled in the period which the IPS applies to |
n12 (max 3 decimals) |
123456789.123 |
1 |
SampleGross |
number |
The gross weight sampled in the period which the IPS applies to |
n12 (max 3 decimals) |
123456789.123 |
1 |
PProportion |
number |
The proportion of P format mail in X format mail |
0.00001-100.00000 |
30.00000 |
1 |
GProportion |
number |
The proportion of G format mail in X format mail |
0.00001-100.00000 |
30.00000 |
1 |
EProportion |
number |
The proportion of E format mail in X format mail |
0.00001-100.00000 |
30.00000 |
1 |
Ipk |
number |
The IPK value |
n11 (max 5 decimals) |
12.223 |
1 |
PIpk |
number |
The IPK value for P format mail |
n11 (max 5 decimals) |
12.223 |
1 |
GIpk |
number |
The IPK value for G format mail |
n11 (max 5 decimals) |
12.223 |
1 |
EIpk |
number |
The IPK value for E format mail |
n11 (max 5 decimals) |
12.223 |
1 |
ValidFrom |
string |
The validity start date of the IPK |
YYYY-MM-DD |
2020-01-01 |
1 |
ValidTo |
string |
The validity end date of the IPK |
YYYY-MM-DD |
2020-12-31 |
1 |
Comments |
string |
Free text comments |
an..256 |
|
History |
|||||
2 |
OperatorCd |
string |
The operator which the IPK applies to |
an3 |
FRA |
2 |
MailFlow |
string |
The mail flow which the IPK applies to |
a1 |
I |
2 |
Year |
number |
The year which the IPK applies to |
n4 |
2020 |
2 |
Period |
string |
The period (month, quarter, semester) which the IPK applies to |
1-12 |
2 |
2 |
PeriodCd |
string |
The period type which the IPK applies to |
a1 |
Q |
2 |
MailCategoryCd |
string |
The mail category which the IPK applies to |
a1 |
A |
2 |
MailSubclassCd |
string |
The mail subclass which the IPK applies to |
a2 |
UN |
2 |
ReceptacleContentFormatCd |
string |
The content format which the IPK applies to |
a1 |
P |
2 |
ProductTypeCd |
string |
The product type which the IPK applies to |
a1 |
NULL |
2 |
OwnOfficeFcd |
string |
The own office which the IPK applies to |
an6 |
CAYTOA |
2 |
PartnerOfficeFcd |
string |
The partner office which the IPK applies to |
an6 |
FRCGDA |
2 |
ReceptacleSubTypeCd |
string |
The receptacle type which the IPK applies to |
a2 |
BG |
2 |
AdjustmentNetGross |
number |
The gross-net adjustment |
0.00001-1 |
0.12345 |
2 |
SampleNet |
number |
The net weight sampled in the period which the IPS applies to |
n12 (max 3 decimals) |
123456789.123 |
2 |
SampleGross |
number |
The gross weight sampled in the period which the IPS applies to |
n12 (max 3 decimals) |
123456789.123 |
2 |
PProportion |
number |
The proportion of P format mail in X format mail |
0.00001-100.00000 |
30.00000 |
2 |
GProportion |
number |
The proportion of G format mail in X format mail |
0.00001-100.00000 |
30.00000 |
2 |
EProportion |
number |
The proportion of E format mail in X format mail |
0.00001-100.00000 |
30.00000 |
2 |
Ipk |
number |
The IPK value |
n11 (max 5 decimals) |
12.223 |
2 |
PIpk |
number |
The IPK value for P format mail |
n11 (max 5 decimals) |
12.223 |
2 |
GIpk |
number |
The IPK value for G format mail |
n11 (max 5 decimals) |
12.223 |
2 |
EIpk |
number |
The IPK value for E format mail |
n11 (max 5 decimals) |
12.223 |
2 |
ValidFrom |
string |
The validity start date of the IPK |
YYYY-MM-DD |
2020-01-01 |
2 |
ValidTo |
string |
The validity end date of the IPK |
YYYY-MM-DD |
2020-12-31 |
2 |
Comments |
string |
Free text comments |
an..256 |
|
2 |
LastModifiedDate |
string |
The date of last modification of the IPK |
YYYY-MM-DDTHH:MM:SS.ms |
2020-12-31T15:35:21:123 |
2 |
Action |
string |
The type of action taken on the IPK |
Update or Delete |
Update |
2 |
ActionDate |
string |
The date the action was taken |
YYYY-MM-DDTHH:MM:SS.ms |
2020-12-31T15:35:21:123 |
Parcel bill rates
Retrieves the parcel bill rates defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/accountingratesservice.svc/rest/parcelbillrates?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
validOn
|
N | Retrieves only rates valid on the specified date |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
ParcelBillRates |
|||||
1 |
OperatorCd |
string |
The operator which the rate applies to |
an3 |
FRA |
1 |
CountryCd |
string |
The country which the rate applies to |
an2 |
FR |
1 |
MailCategoryCd |
string |
The mail category which the rate applies to |
a1 |
A |
1 |
ProductTypeCd |
string |
The product type which the rate applies to |
a1 |
P |
1 |
ValidFrom |
string |
The validity start date of the rate |
YYYY-MM-DD |
2020-01-01 |
1 |
ValidTo |
string |
The validity end date of the rate |
YYYY-MM-DD |
2020-12-31 |
1 |
Office |
string |
The office which the rate applies to |
an6 |
FRCDGA |
1 |
MailFlow |
string |
The mail flow which the rate applies to |
a1 |
I |
1 |
Returned |
number |
Whether the rate only applies to returned parcels |
n1 |
0 |
1 |
RateParcel |
number |
The inward land rate per parcel |
n7 (max 4 decimals) |
123.4567 |
1 |
RateKg |
number |
The inward land rate per kilogram |
n7 (max 4 decimals) |
123.4567 |
1 |
RateParcelBracket1 |
number |
The inward land rate per parcel in bracket 1 (E-commercel parcels only) |
n7 (max 4 decimals) |
123.4567 |
1 |
RateKg Bracket1 |
number |
The inward land rate per kilogram in bracket 1 (E-commercel parcels only) |
n7 (max 4 decimals) |
123.4567 |
1 |
RateParcelBracket2 |
number |
The inward land rate per parcel in bracket 2 (E-commercel parcels only) |
n7 (max 4 decimals) |
123.4567 |
1 |
RateKg Bracket2 |
number |
The inward land rate per kilogram in bracket 2 (E-commercel parcels only) |
n7 (max 4 decimals) |
123.4567 |
1 |
RateParcelBracket3 |
number |
The inward land rate per parcel in bracket 3 (E-commercel parcels only) |
n7 (max 4 decimals) |
123.4567 |
1 |
RateKg Bracket3 |
number |
The inward land rate per kilogram in bracket 3 (E-commercel parcels only) |
n7 (max 4 decimals) |
123.4567 |
1 |
TransitParcel |
number |
The transit rate per parcel |
n7 (max 4 decimals) |
123.4567 |
1 |
TransitKg |
number |
The transit rate per kilogram |
n7 (max 4 decimals) |
123.4567 |
1 |
Due1 |
number |
The air conveyance charge (per half kilogram) |
n7 (max 4 decimals) |
123.4567 |
1 |
CustomsParcel |
number |
The customs rate per parcel |
n7 (max 4 decimals) |
123.4567 |
1 |
Observations |
string |
Free text comments |
an..256 |
|
History |
|||||
2 |
OperatorCd |
string |
The operator which the rate applies to |
an3 |
FRA |
2 |
CountryCd |
string |
The country which the rate applies to |
an2 |
FR |
2 |
MailCategoryCd |
string |
The mail category which the rate applies to |
a1 |
A |
2 |
ProductTypeCd |
string |
The product type which the rate applies to |
a1 |
P |
2 |
ValidFrom |
string |
The validity start date of the rate |
YYYY-MM-DD |
2020-01-01 |
2 |
ValidTo |
string |
The validity end date of the rate |
YYYY-MM-DD |
2020-12-31 |
2 |
Office |
string |
The office which the rate applies to |
an6 |
FRCDGA |
2 |
MailFlow |
string |
The mail flow which the rate applies to |
a1 |
I |
2 |
Returned |
number |
Whether the rate only applies to returned parcels |
n1 |
0 |
2 |
RateParcel |
number |
The inward land rate per parcel |
n7 (max 4 decimals) |
123.4567 |
2 |
RateKg |
number |
The inward land rate per kilogram |
n7 (max 4 decimals) |
123.4567 |
2 |
RateParcelBracket1 |
number |
The inward land rate per parcel in bracket 1 (E-commercel parcels only) |
n7 (max 4 decimals) |
123.4567 |
2 |
RateKg Bracket1 |
number |
The inward land rate per kilogram in bracket 1 (E-commercel parcels only) |
n7 (max 4 decimals) |
123.4567 |
2 |
RateParcelBracket2 |
number |
The inward land rate per parcel in bracket 2 (E-commercel parcels only) |
n7 (max 4 decimals) |
123.4567 |
2 |
RateKg Bracket2 |
number |
The inward land rate per kilogram in bracket 2 (E-commercel parcels only) |
n7 (max 4 decimals) |
123.4567 |
2 |
RateParcelBracket3 |
number |
The inward land rate per parcel in bracket 3 (E-commercel parcels only) |
n7 (max 4 decimals) |
123.4567 |
2 |
RateKg Bracket3 |
number |
The inward land rate per kilogram in bracket 3 (E-commercel parcels only) |
n7 (max 4 decimals) |
123.4567 |
2 |
TransitParcel |
number |
The transit rate per parcel |
n7 (max 4 decimals) |
123.4567 |
2 |
TransitKg |
number |
The transit rate per kilogram |
n7 (max 4 decimals) |
123.4567 |
2 |
Due1 |
number |
The air conveyance charge (per half kilogram) |
n7 (max 4 decimals) |
123.4567 |
2 |
CustomsParcel |
number |
The customs rate per parcel |
n7 (max 4 decimals) |
123.4567 |
2 |
Observations |
string |
Free text comments |
an..256 |
|
2 |
LastModifiedDate |
string |
The date of last modification of the rate |
YYYY-MM-DDTHH:MM:SS.ms |
2020-12-31T15:35:21:123 |
2 |
Action |
string |
The type of action taken on the rate |
Update or Delete |
Update |
2 |
ActionDate |
string |
The date the action was taken |
YYYY-MM-DDTHH:MM:SS.ms |
2020-12-31T15:35:21:123 |
Example
Response
See the example JSON response body here.
Air conveyance charges
Retrieves the air conveyance charges defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/accountingratesservice.svc/rest/iacrates?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
validOn
|
N | Retrieves only rates valid on the specified date |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
IacRates |
|||||
1 |
OperatorCd |
string |
The operator which the rate applies to |
an3 |
FRA |
1 |
OriginOfficeFcd |
string |
The origin office which the rate applies to |
an6 |
FRCGDA |
1 |
DestinationOfficeFcd |
string |
The destination office which the rate applies to |
an6 |
CAYTOA |
1 |
AccountingAgreementCd |
string |
The accounting agreement type which the rate applies to |
an..5 |
LETR |
1 |
ProductTypeCd |
string |
The product type which the rate applies to |
a1 |
P |
1 |
MailDirection |
string |
The mail flow which the rate applies to |
a1 |
I |
1 |
ValidFrom |
string |
The validity start date of the rate |
YYYY-MM-DD |
2020-01-01 |
1 |
ValidTo |
string |
The validity end date of the rate |
YYYY-MM-DD |
2020-12-31 |
1 |
RateKg |
number |
The rate per kilogram |
n7 (max 4 decimals) |
123.4567 |
History |
|||||
2 |
OperatorCd |
string |
The operator which the rate applies to |
an3 |
FRA |
2 |
OriginOfficeFcd |
string |
The origin office which the rate applies to |
an6 |
FRCGDA |
2 |
DestinationOfficeFcd |
string |
The destination office which the rate applies to |
an6 |
CAYTOA |
2 |
AccountingAgreementCd |
string |
The accounting agreement type which the rate applies to |
an..5 |
LETR |
2 |
ProductTypeCd |
string |
The product type which the rate applies to |
a1 |
P |
2 |
MailDirection |
string |
The mail flow which the rate applies to |
a1 |
I |
2 |
ValidFrom |
string |
The validity start date of the rate |
YYYY-MM-DD |
2020-01-01 |
2 |
ValidTo |
string |
The validity end date of the rate |
YYYY-MM-DD |
2020-12-31 |
2 |
RateKg |
number |
The rate per kilogram |
n7 (max 4 decimals) |
123.4567 |
2 |
Action |
string |
The type of action taken on the rate |
Update or Delete |
Update |
2 |
ActionDate |
string |
The date the action was taken |
YYYY-MM-DDTHH:MM:SS.ms |
2020-12-31T15:35:21:123 |
A decouvert groups and charges
Retrieves the a decouvert groups and charges defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/accountingratesservice.svc/rest/adecouvertrates?token={token}&validOn={YYYY-MM-DD}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
validOn
|
N | Retrieves only rates valid on the specified date |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
AdecouvertRates |
|||||
1 |
TransitCountryCd |
string |
The transit operator which the rates and groups are defined for |
an2 |
FR |
1 |
MailCategoryCd |
string |
The mail category which the rates and groups apply to |
a1 |
A |
Groups |
|||||
2 |
GroupId |
number |
The group number |
1-10 |
1 |
Countries |
|||||
3 |
CountryCd |
string |
Code of the country in the group |
an2 |
IT |
Charges |
|||||
3 |
GroupNm |
string |
The name of the group charge |
an..32 |
FR_G1 |
3 |
ValidFrom |
string |
The validity start date of the rate |
YYYY-MM-DD |
2020-01-01 |
3 |
ValidTo |
string |
The validity end date of the rate |
YYYY-MM-DD |
2020-12-31 |
3 |
RateKg |
number |
The rate per kilogram |
n7 (max 4 decimals) |
123.4567 |
History |
|||||
4 |
GroupNm |
string |
The name of the group charge |
|
|
4 |
ValidFrom |
string |
The validity start date of the rate |
YYYY-MM-DD |
2020-01-01 |
4 |
ValidTo |
string |
The validity end date of the rate |
YYYY-MM-DD |
2020-12-31 |
4 |
RateKg |
number |
The rate per kilogram |
n7 (max 4 decimals) |
123.4567 |
4 |
Action |
string |
The type of action taken on the rate |
Update or Delete |
Update |
4 |
ActionDate |
string |
The date the action was taken |
YYYY-MM-DDTHH:MM:SS.ms |
2020-12-31T15:35:21:123 |
Closed transit charges
Retrieves the closed transit charges defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/accountingratesservice.svc/rest/closedtransitcharges?token={token}&validOn={YY-MM_DDDD}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
validOn
|
N | Retrieves only rates valid on the specified date |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
ClosedTransitCharges |
|||||
1 |
TransitCountryCd |
string |
The transit operator which the rate applies to |
an2 |
FR |
1 |
DestCountryCd |
string |
The destination country which the rate applies to |
an2 |
IT |
1 |
MailClassCd |
string |
The mail class which the rate applies to |
a1 |
U |
1 |
AccTypeCd |
string |
|
|
|
1 |
OfficeFcd |
string |
The office which the rate applies to |
an6 |
FRCGDA |
1 |
ValidFrom |
string |
The validity start date of the rate |
YYYY-MM-DD |
2020-01-01 |
1 |
RateKg |
number |
The rate per kilogram |
n7 (max 4 decimals) |
123.4567 |
1 |
RateItem |
number |
The rate per item |
n7 (max 4 decimals) |
123.4567 |
1 |
LastModifDate |
string |
The last modification date of the rate |
YYYY-MM-DDTHH:MM:SS.ms |
2020-12-31T15:35:21:123 |
1 |
ProductCd |
string |
The product type which the rate applies to |
a1 |
P |
1 |
TransitLocationFcd |
string |
The transit location which the rate applies to |
an5 |
FRCDG |
1 |
DestLocationFcd |
string |
The destination location which the rate applies to |
an5 |
ITLIN |
1 |
OriginOperatorCd |
string |
The origin operator which the rate applies to |
an2 |
CA |
1 |
CurrencyCd |
string |
The currency which the rate is defined in |
an3 |
XDR |
History |
|||||
2 |
TransitCountryCd |
string |
The transit operator which the rate applies to |
an2 |
FR |
2 |
DestCountryCd |
string |
The destination country which the rate applies to |
an2 |
IT |
2 |
MailClassCd |
string |
The mail class which the rate applies to |
a1 |
U |
2 |
AccTypeCd |
string |
|
|
|
2 |
OfficeFcd |
string |
The office which the rate applies to |
an6 |
FRCGDA |
2 |
ValidFrom |
string |
The validity start date of the rate |
YYYY-MM-DD |
2020-01-01 |
2 |
RateKg |
number |
The rate per kilogram |
n7 (max 4 decimals) |
123.4567 |
2 |
RateItem |
number |
The rate per item |
n7 (max 4 decimals) |
123.4567 |
2 |
LastModifDate |
string |
The last modification date of the rate |
YYYY-MM-DDTHH:MM:SS.ms |
2020-12-31T15:35:21:123 |
2 |
ProductCd |
string |
The product type which the rate applies to |
a1 |
P |
2 |
TransitLocationFcd |
string |
The transit location which the rate applies to |
an5 |
FRCDG |
2 |
DestLocationFcd |
string |
The destination location which the rate applies to |
an5 |
ITLIN |
2 |
OriginOperatorCd |
string |
The origin operator which the rate applies to |
an2 |
CA |
2 |
CurrencyCd |
string |
The currency which the rate is defined in |
an3 |
XDR |
2 |
Action |
string |
The type of action taken on the rate |
Update or Delete |
Update |
2 |
ActionDate |
string |
The date the action was taken |
YYYY-MM-DDTHH:MM:SS.ms |
2020-12-31T15:35:21:123 |
Example
Response
See the example JSON response body here.
EDI information from EMSEVT
Retrieves the EDI mail item details imported into IPS via EMSEVT.
You can use the API method in one of two ways.
Retrieve by mail item ID
If only a mail item ID is specified, all mail items with this ID will be returned. All events for the given mail item are returned (no matter when they were received)
Retrieve by mail item characteristics
Specify the origin country, destination country, from GMT date-time, to GMT date-time. Only the from GMT date-time parameter is mandatory.
For each mail item with an event captured within the specified time interval, the mail item will be returned in the response. Only events for the mail item which were captured within the time interval will be included.
If the country parameters are specified then the results will be filtered to only return data where the mail item matches the specified parameters.
If the combination of supplied parameters, or their values, is incorrect, then HTTP response 400 (Bad Request) is returned.
HTTP request
GET http://[host:port]/IPSAPIService/edidataservice.svc/rest/edimailitems?token={token}&{additional parameters}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Additional parameters | ||
fromGmtDateTime
|
Y (only if no mailitemId is specified) | Date time from in GMT, format YYYY-MM-DDTHH:MM:SS.ms. Example: fromGmtDateTime=2021-01-01T00:00:00 . |
toGmtDateTime
|
N | Date time to in GMT, in format YYYY-MM-DDTHH:MM:SS.ms |
originCountry |
N | |
destinationCountry
|
N | |
mailitemId
|
Y (only if no other additional parameters are specified) | Either this parameter or a combination of the other additional parameters is allowed |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
EdiMailitems |
|||||
1 |
MailitemFid |
string |
Mail item identifier |
an..35 |
CP012374226FR |
1 |
MailitemCategoryCd |
string |
The priority by which the item should be processed, i.e. priority or non-priority; value from UPU code list 196. |
a1 |
A |
1 |
MailSubclassFcd |
string |
The mail sub-class that classifies the item, e.g. ED: EMS documents, EM: EMS merchandise, CN: ordinary parcel; value from UPU code list 117 relevant to items. |
an2 |
UL |
1 |
DestinationCountryCd |
string |
Mail item destination country |
an2 |
CN |
1 |
OriginCountryCd |
string |
Mail item origin country |
an2 |
FR |
1 |
Weight |
string |
Mail item weight |
n8 (max 3 decimals) |
|
1 |
InsuredSdrValue |
string |
Mail item insured value |
n6.n2 |
|
1 |
DestinationId |
string |
An optional 2nd item ID provided on the item in addition to the mandatory item-identification. This second ID follows the format used by the destination operator in his delivery network. |
an..35 |
21200015891152 |
1 |
HandlingClass |
string |
The handling class of the item, e.g. R-Registered, VInsured; values from code list 107 other than N - Normal. |
a1 |
V |
1 |
OriginOperator |
string |
The operator who has injected the item in the network. |
an..35 |
COLIPOSTE |
1 |
ReceptacleFid |
string |
Receptacle identifier |
an29 |
|
1 |
AssociatedServiceCd |
string |
Mail item associated services |
|
|
EdiMailitemEvents string |
|||||
2 |
EventTypeCd |
string |
Event code |
|
|
2 |
SenderId |
string |
The EDI address of the message sender |
an5 |
FR001 |
2 |
LocationId |
string |
Event location identifier |
an..32 |
|
2 |
EventLocalDate |
string |
Event local timestamp |
|
|
2 |
CaptureGmtDate |
string |
Event capture timestamp (GMT) |
|
|
2 |
ConditionCd |
string |
Mail item condition code |
0-255 |
30 |
2 |
RetentionReasonCd |
string |
The reason why the item is retained by Customs, e.g. invoice missing; value from UPU code list 111. |
n2 |
50 |
2 |
NonDeliveryReasonCd |
string |
The reason why the item could not be delivered to the recipient, e.g. addressee moved; value from UPU code list 112. |
n2 |
28 |
2 |
NonDeliveryMeasureCd |
string |
The action taken upon failure to physically deliver the item, e.g. item forwarded/redirected; value from UPU code list 113. |
a1 |
F |
2 |
SignatoryNm |
string |
The name of the recipient who accepted the item. |
an..35 |
|
2 |
DeliveryLocation |
string |
The location where the item was delivered; location name, location code or postcode, as appropriate. |
an..35 |
|
2 |
AccountNumber |
string |
The account used for invoicing the postage. |
an..17 |
|
2 |
SenderPostcode |
string |
The postcode of origin of the item. |
an..17 |
75100 |
2 |
RecipientPostcode |
string |
The postcode of destination of the item. |
an..17 |
75100 |
2 |
PlaceOfOriginOfficeCd |
string |
The office of origin of the item. |
an..35 |
|
2 |
PlaceOfDestinationOfficeCd |
string |
The office of destination of the item. |
an..35 |
|
2 |
DispatchNumber |
string |
The number of the despatch in which the item was sent from the origin operator.
|
an..35 |
|
2 |
DispatchOfficeCd |
string |
The code of the office of exchange of destination of the despatch to which the item is exported; value from UPU code list 108. |
an6 |
|
2 |
FlightNo |
string |
The flight number which the item is transported in (removed in EMSEVT v3) |
an..20 |
|
2 |
FlightDate |
string |
The flight date (removed in EMSEVT v3) |
|
|
2 |
DutiableInd |
string |
The customs classification assigned to the item, e.g. dutiable, non-dutiable, low value, high value, medium value; value from UPU code list 202. |
an..3 |
D |
2 |
CollectionPostcode |
string |
The postcode of the place where the item was collected from the customer or the postcode of the posting office that accepted the item from the customer. |
an..17 |
75100 |
2 |
DeliveryTypeCd |
string |
The additional service requested for the delivery, e.g. with signature; value from code list 208 |
an..3 |
|
2 |
MailSourceCd |
string |
An indication on how the item will be injected in the delivery network, e.g. direct injection at destination sorting centre; value from UPU code list 198. |
an..3 |
301 |
2 |
CustomsOfficeId |
string |
The ID of the customs office where the item is being presented or held |
an..35 |
|
2 |
CustomsOfficeTypeCd |
string |
The situation of the customs office relative to the office of exchange: local or remote; value from UPU code list 200. |
an..3 |
R |
2 |
CustomsOfficerReleaseStatusCd |
string |
The status of the item as released by Customs, e.g. export refused; export refused, prohibited articles; value from UPU code list 201. |
an..3 |
ER |
2 |
AddresseeEmailAddress |
string |
The email address of the addressee. name2@domain2 |
an..50 |
|
2 |
AddresseeLanguage |
string |
The ISO 639–2 alpha-3 language code to use for communication with the addressee. |
a3 |
ENG |
2 |
AddresseeName |
string |
The name of the addressee. |
an..35 |
|
2 |
AddresseePhoneNo |
string |
The telephone number of the addressee. |
an..35 |
|
2 |
AddresseeAlternativeDeliveryAddressCityTown |
string |
The name of the city/town of the alternative address for delivery. |
an..35 |
EUPEN |
2 |
AddresseeAlternativeDeliveryAddresshouseId |
string |
The house number, entrance or the building name of the alternative address for delivery. |
an..30 |
87 |
2 |
AddresseeAlternativeDeliveryAddressLine1 |
string |
The first line of the alternative address for delivery. |
an..100 |
CHAMPS ELYSEES |
2 |
AddresseeAlternativeDeliveryAddressLine2 |
string |
The second line of the alternative address for delivery. |
an..100 |
ALICIA ZONE-Q45 |
2 |
AddresseeAlternativeDeliveryAddressPostcode |
string |
The postcode of the alternative address for delivery. |
an..17 |
75100 |
2 |
CodBic |
string |
The BIC code of the bank of the sender. May be provided only if COD-amount is provided and upon bilateral agreement; otherwise not used. |
an..11 |
|
2 |
CodCurrency |
string |
The currency in which the COD amount is expressed. Mandatory if COD-amount is present otherwise not used. Use alpha-3 codes from ISO 4217 list. |
an3 |
EUR |
2 |
CodIban |
string |
The IBAN number of the sender. May be provided only if COD-amount is provided and upon bilateral agreement; otherwise not used. |
an..34 |
|
2 |
CodAmount |
string |
The COD (Cash on Delivery) amount to be charged to the recipient. |
n9.n3 |
|
2 |
ConsumerRegNumber |
string |
The registration number of the customer; required for, e.g. delivery at pack stations |
an..35 |
ERC-458-23 |
2 |
CustomerChargingArrangementCd |
string |
The duty and tax payment method as it applies to the item; value from UPU code list 197. |
a3 |
DDP |
2 |
DeliveryPointAddressLine1 |
string |
The first line of the delivery address. |
an..100 |
CHAMPS ELYSEES |
2 |
DeliveryPointAddressLine2 |
string |
The second line of the delivery address. |
an..100 |
ALICIA ZONE-Q45 |
2 |
DeliveryPointHouseId |
string |
The house number, entrance or the building name of the delivery point. |
an..30 |
87 |
2 |
ArrivalStatusCd |
string |
An indication of the status of the item upon arrival at office of exchange, e.g. received damaged; value from UPU code list 205 |
an..3 |
200 |
2 |
Exportflow |
string |
An indication that the item is despatched in open transit. |
a1 |
T |
2 |
DeliveryServiceTypeCd |
string |
The additional service requested for the delivery, e.g. with signature; value from code list 208 |
an..3 |
|
2 |
LodgementModeCd |
string |
An indication on how the item entered the network, e.g. pick-up from private address, street collection box; value from UPU code list 195. |
an..3 |
3 |
2 |
NetworkEntryLocationTypeCd |
string |
The type of office where the item was accepted, e.g. a post office, a parcel processing facility, an outward office of exchange, sorting centre; value from UPU code list 194. |
an..3 |
1 |
2 |
NextPointId |
string |
The ID of the next processing point in the delivery journey. |
an..35 |
|
2 |
Postcode |
string |
Postcode of the processing point |
an..17 |
|
2 |
PickupPointId |
string |
The ID of the location at destination where to drop the item for pick-up by the customer. |
an..35 |
54PFJ-56732 |
2 |
DeliveryMode |
string |
The relationship between the addressee and the person who accepted the item, e.g. to addressee; neighbour of the addressee; company reception; value from UPU code list 199. |
an..3 |
1 |
2 |
ReceptacleFid |
string |
Receptacle identifier |
an29 |
|
2 |
SenderEmailAddress |
string |
The email address of the sender. name1@domain1 |
an..50 |
|
2 |
SenderPhoneNo |
string |
The telephone number of the sender. |
an..35 |
|
2 |
TransitDirectionCd |
string |
An indication if the item arrived at the transit office of exchange in open transit or if the item was misrouted at the origin or transit exchange office; value from UPU code list 204. |
an..3 |
101 |
2 |
AttemptedDeliveryLocation |
string |
The location where the operator attempted to deliver the item; location name, location code or postcode, as appropriate. |
an..35 |
|
2 |
MailitmWeight |
string |
The gross weight of the item, in KG. |
n4.n3 |
|
2 |
TransitOfficeCd |
string |
The transit office code |
an6 |
|
2 |
MrsStatusCd |
string |
Merchandise Return Service: status of the item |
a1 |
|
2 |
MrsExpirationdate |
string |
Merchandise Return Service: expiration date for the return |
|
|
2 |
MrsOriginalId |
string |
Merchandise Return Service: original item identifier |
an..35 |
|
Example
Response
See the example JSON response body here.
EDI information from PREDES/RESDES
Retrieves the EDI mail dispatch, receptacle and mail item details imported into IPS via PREDES and RESDES messages.
Retrieves the EDI mail item details imported into IPS via EMSEVT.
You can use the API method in one of two ways.
Retrieve by dispatch ID
If only a dispatch ID is specified, messages for all dispatches with this ID will be returned (no matter when they were received).
Retrieve by dispatch characteristics
Specify the operator, mail flow, from GMT date-time, to GMT date-time. Only the from GMT date-time parameter is mandatory.
- All pre-advised dispatch data (for the specified operator and mail flow) received in the specified time interval will be returned.
- If the partner operator is specified and the mailflow is I, the API searches for EDI messages relating to inbound dispatches. The operator of the origin office must equal the specified parameter.
- If the partner operator is specified and mailflow is O, the API searches for EDI messages relating to outbound dispatches. The operator of the destination office must equal the specified parameter.
- If the mailflow is I with no partner operator specified, the API returns all inbound dispatches. The operator of the destination office is your own operator.
- If mailflow is O with no partner operator specified, the API returns all outbound dispatches. The operator of the origin office is your own operator.
- If the partner operator is specified with no mailflow the API returns all dispatches exchanged with the specified partner. The operator of the destination office is your own operator or the operator of the origin office is your own operator.
If the combination of specified parameters, or their values, is incorrect, then HTTP response 400 (Bad Request) is returned with error code 2.
Parameter CreateEDIDupOthers
affects the storage of EDI dispatches and EDI receptacles. The default for this parameter is false
. Multiple PREDES messages for the same dispatch will be stored in the same EDI dispatch (with multiple events).
HTTP request
GET http://[host:port]/IPSAPIService/edidataservice.svc/rest/edidespatches?token={token}&{additional parameters}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Additional parameters | ||
fromGmtDateTime
|
Y (only if no dispatchId is specified) | Date time from in GMT, format YYYY-MM-DDTHH:MM:SS.ms, for example fromGmtDateTime=2021-01-01T00:00:00 |
toGmtDateTime
|
N | Date time to in GMT, in format YYYY-MM-DDTHH:MM:SS.ms |
operator
|
N | |
mailflow
|
N | |
dispatchId
|
Y (only if no other additional parameters are specified) | Either this parameter or a combination of the other additional parameters is allowed |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
EdiDespatches |
|||||
1 |
DespatchFid |
string |
Dispatch identifier |
an..20 |
DKCPHACHZRHBCUN10047 |
1 |
DespatchClosingDate |
string |
Dispatch closure date |
YYYY-MM-DD hh:mm:ss |
2021-03-05 04:33:00 |
EdiDespatchEvents |
|||||
2 |
EventTypeCd |
string |
Event code |
n..3 |
204 |
2 |
EventLocalDate |
string |
Event local date |
YYYY-MM-DD hh:mm:ss |
2021-03-05 16:30:00 |
2 |
CaptureGmtDate |
string |
Event capture date |
YYYY-MM-DD hh:mm:ss.sss |
2021-03-12 11:11:03.207 |
2 |
DespatchDate |
string |
Dispatch date |
YYYY-MM-DD hh:mm:ss |
2021-03-05 16:30:00 |
2 |
DespatchArrivalTime |
string |
Dispatch arrival date and time |
YYYY-MM-DD hh:mm:ss |
2021-03-06 09:00:00 |
EdiFlights |
|||||
3 |
FlightFid |
string |
Transport company and number |
an..34 |
SK 0609 |
3 |
OrigPortCd |
string |
Origin location |
an..5 |
CPH |
3 |
DestPortCd |
string |
Destination location |
an..5 |
ZRH |
3 |
FlightDepartureTime |
string |
Departure time |
YYYY-MM-DD hh:mm:ss |
2021-03-05 17:55:00 |
3 |
FlightArrivalTime |
string |
Arrival time |
YYYY-MM-DD hh:mm:ss |
2021-03-05 19:35:00 |
3 |
FlightOrderNo |
numeric |
Sequence number of the transport |
0-255 |
0 |
3 |
CarrierCd |
string |
Transport company code |
an..20 |
SK |
3 |
CarrierNo |
string |
Transport number |
an..64 |
0609 |
3 |
TransportTypeCd |
string |
Type of transport |
a2 |
PL |
EdiReceptacles |
|||||
2 |
ReceptacleFid |
string |
Receptacle identifier |
an29 |
DKCPHPCHZRHUACN10066003000080 |
2 |
MailSubclass |
string |
Receptacle mail subclass |
a2 |
CN |
2 |
ReceptacleContentFormatCd |
string |
Receptacle content format |
a1 |
NULL |
2 |
ReceptacleMailitemsNo |
number |
Number of contained items |
|
2 |
2 |
ReceptacleWeight |
number |
Receptacle weight |
12.3 |
8.000 |
2 |
ReceptacleSubType |
string |
Receptacle type |
an..5 |
BG |
2 |
NetWeightInd |
string |
Whether weight is gross or net |
a1 |
0 |
2 |
ExemptInd |
string |
Whether receptacle is exempt or not |
a1 |
0 |
2 |
OtherCharacs |
number |
Receptacle additional characteristics |
0-255 |
NULL |
EdiReceptacleEvents |
|||||
3 |
EventTypeCd |
string |
Event code |
n..3 |
107 |
3 |
EventLocalDate |
string |
Event local date |
YYYY-MM-DD hh:mm:ss |
2021-03-05 16:30:00 |
3 |
CaptureGmtDate |
string |
Event capture date |
YYYY-MM-DD hh:mm:ss.sss |
2021-03-12 11:11:03.207 |
3 |
ConditionCd |
number |
The receptacle condition |
0-255 |
NULL |
3 |
ReceptacleWeight |
number |
Receptacle weight |
12.3 |
8.000 |
3 |
MailSubclass |
string |
Receptacle subclass |
a2 |
CN |
3 |
ReceptacleContentFormatCd |
string |
Receptacle content format |
a1 |
NULL |
3 |
ReceptacleSubTypeCd |
string |
Receptacle type |
an..5 |
BG |
EdiMailitems |
|||||
3 |
MailitemFid |
string |
Mail item identifier |
an..35 |
CP012374226FR |
3 |
MailSubclassFcd |
string |
The mail sub-class that classifies the item, e.g. ED: EMS documents, EM: EMS merchandise, CN: ordinary parcel; value from UPU code list 117 relevant to items. |
an2 |
UL |
3 |
DestinationCountryCd |
string |
Mail item destination country |
an2 |
CN |
3 |
Weight |
string |
Mail item weight |
n..8 (max 3 decimals) |
2.000 |
3 |
InsuredSdrValue |
string |
Mail item insured value |
n6.n2 |
12.65 |
3 |
HandlingClass |
string |
The handling class of the item, e.g. R-Registered, VInsured; values from code list 107 other than N - Normal. |
a1 |
V |
EdiMailitemEvents |
|||||
4 |
EventTypeCd |
string |
Event code |
0-255 |
12 |
4 |
SenderId |
string |
The EDI address of the message sender |
an5 |
FR001 |
4 |
LocationId |
string |
Event location identifier |
an..32 |
FRCGD |
4 |
EventLocalDate |
string |
Event local timestamp |
YYYY-MM-DD hh:mm:ss |
2021-03-05 16:30:00 |
4 |
CaptureGmtDate |
string |
Event capture timestamp (GMT) |
YYYY-MM-DD hh:mm:ss.sss |
2021-03-12 11:11:03.207 |
4 |
ConditionCd |
string |
Mail item condition code |
0-255 |
30 |
4 |
NonDeliveryReasonCd |
string |
The reason why the item could not be delivered to the recipient, e.g. addressee moved; value from UPU code list 112. |
n2 |
28 |
4 |
NonDeliveryMeasureCd |
string |
The action taken upon failure to physically deliver the item, e.g. item forwarded/redirected; value from UPU code list 113. |
a1 |
F |
4 |
MailitmWeight |
string |
The gross weight of the item, in KG. |
n4.n3 |
2.000 |
Example
Response
See the example JSON response body here.
EDI information from PRECON/RESCON/CARDIT/RESDIT
Retrieves the EDI consignment, dispatch and receptacle details imported into IPS via PRECON, RESCON, CARDIT and RESDIT messages.
You can use the API method in one of two ways.
Retrieve by consignment ID
If only a consignment ID is specified, messages for all consignments with this ID will be returned (no matter when they were received).
Retrieve by consignment characteristics
Specify the operator, mail flow, from GMT date-time, to GMT date-time. Only the from GMT date-time parameter is mandatory.
- All pre-advised consignment data (for the specified operator and mail flow) received in the specified time interval will be returned.
- If the partner operator and mailflow are specified, the API filters the results to only return data matching the specified parameters.
- If the partner operator is specified and the mailflow is I, the API searches for EDI messages relating to outbound consignments. The operator of the destination office must equal the specified parameter.
- If the partner operator is specified and the mailflow is O, the API searches for EDI messages relating to outbound consignments. The operator of the destination office must equal the specified parameter.
- If the partner operator is specified and mailflow is O, the API searches for EDI messages relating to outbound dispatches. The operator of the destination office must equal the specified parameter.
- If the mailflow is I with no partner operator specified, the API returns all inbound consignments. The operator of the destination office is your own operator.
- If mailflow is O with no partner operator specified, the API returns all outbound consignments. The operator of the origin office is your own operator.
- If the partner operator is specified with no mailflow the API returns all consignments exchanged with the specified partner. The operator of the destination office is your own operator or the operator of the origin office is your own operator.
If the combination of specified parameters, or their values, is incorrect, then HTTP response 400 (Bad Request) is returned with error code 2.
Parameter CreateEDIDupOthers
affects the storage of EDI consignments and EDI receptacles. The default for this parameter is false
. Multiple PRECON messages for the same dispatch will be stored in the same EDI dispatch (with multiple events).
HTTP request
GET http://[host:port]/IPSAPIService/edidataservice.svc/rest/ediconsignments?token={token}&{additional parameters}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Additional parameters | ||
consignmentId
|
N | Either this parameter or a combination of the others is allowed. |
operator
|
N | |
mailflow
|
N | |
fromGmtDateTime
|
Y (only if no consignmentId is specified) | Format YYYY-MM-DDTHH:MM:SS.ms |
toGmtDateTime
|
N | Format YYYY-MM-DDTHH:MM:SS.ms |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
EdiConsignments |
|||||
1 |
ConsignmentFid |
string |
Consignment identifier |
an..20 |
DKCPHP00001 |
1 |
MailCategoryCd |
string |
Mail category |
a1 |
A |
1 |
ConsignmentClosingDate |
string |
Closing date |
YYYY-MM-DD hh:mm:ss |
2021-03-05 17:55:00 |
1 |
SenderId |
string |
EDI address of the message sender |
an..5 |
DK001 |
EdiConsignmentEvents |
|||||
2 |
EventTypeCd |
string |
Event code |
n..3 |
303 |
2 |
EventLocalDate |
string |
Event local timestamp |
YYYY-MM-DD hh:mm:ss |
2021-03-05 17:55:00 |
2 |
CaptureGmtDate |
string |
Event capture timestamp (GMT) |
YYYY-MM-DD hh:mm:ss.sss |
2021-03-12 11:11:03.207 |
2 |
CarrierEventCd |
number |
The RESDIT event code |
n2 |
74 |
2 |
CarrierEventReasonCd |
string |
For future use |
an...3 |
NULL |
2 |
ConsignmentArrivalTime |
string |
Arrival time |
YYYY-MM-DD hh:mm:ss |
2021-03-05 17:55:00 |
2 |
CarrierAddress |
string |
The carrier EDI address |
an..35 |
LX001 |
2 |
ConsignmentResponse |
number |
In relation to the CARDIT message on this consignment, indication of the type of response provided: 1 = ALL (CARDIT was received and this message reports all receptacles that were in CARDIT) 3 = PART (CARDIT was received; this message only reports part of the receptacles that were in CARDIT, not all of them) 11 = no CARDIT was received |
n2 |
1 |
2 |
WayBillNumber |
string |
Postal Air Way Bill number |
an..40 |
|
EdiFlights |
|||||
3 |
FlightFid |
string |
Transport company and number |
an..34 |
SK 0609 |
3 |
OrigPortCd |
string |
Origin location |
an..5 |
CPH |
3 |
DestPortCd |
string |
Destination location |
an..5 |
ZRH |
3 |
FlightDepartureTime |
string |
Departure time |
YYYY-MM-DD hh:mm:ss |
2021-03-05 17:55:00 |
3 |
FlightArrivalTime |
string |
Arrival time |
YYYY-MM-DD hh:mm:ss |
2021-03-05 19:35:00 |
3 |
FlightOrderNo |
numeric |
Sequence number of the transport |
0-255 |
0 |
3 |
CarrierCd |
string |
Transport company code |
an..20 |
SK |
3 |
CarrierNo |
string |
Transport number |
an..64 |
0609 |
3 |
TransportTypeCd |
string |
Type of transport |
a2 |
PL |
EdiReceptacles |
|||||
2 |
ReceptacleFid |
string |
Receptacle identifier |
an29 |
DKCPHPCHZRHUACN10066003000080 |
2 |
MailSubclass |
string |
Receptacle mail subclass |
a2 |
CN |
2 |
ReceptacleContentFormatCd |
string |
Receptacle content format |
a1 |
NULL |
2 |
ReceptacleMailitemsNo |
number |
Number of contained items |
|
2 |
2 |
ReceptacleWeight |
number |
Receptacle weight |
12.3 |
8.000 |
2 |
ReceptacleSubType |
string |
Receptacle type |
an..5 |
BG |
2 |
NetWeightInd |
string |
Whether weight is gross or net |
a1 |
0 |
2 |
ExemptInd |
string |
Whether receptacle is exempt or not |
a1 |
0 |
2 |
OtherCharacs |
number |
Receptacle additional characteristics |
0-255 |
NULL |
EdiReceptacleEvents |
|||||
3 |
EventTypeCd |
string |
Event code |
n..3 |
108 |
3 |
EventLocalDate |
string |
Event local timestamp |
YYYY-MM-DD hh:mm:ss |
2021-03-05 16:30:00 |
3 |
CaptureGmtDate |
string |
Event capture timestamp (GMT) |
YYYY-MM-DD hh:mm:ss.sss |
2021-03-12 11:11:03.207 |
3 |
ConditionCd |
number |
The receptacle condition |
0-255 |
NULL |
3 |
CarrierEventCd |
number |
The RESDIT event code |
n2 |
74 |
3 |
ReceptacleWeight |
number |
Receptacle weight |
12.3 |
8.000 |
3 |
MailSubclass |
string |
Receptacle subclass |
a2 |
CN |
3 |
ReceptacleContentFormatCd |
string |
Receptacle content format |
a1 |
NULL |
3 |
ReceptacleSubTypeCd |
string |
Receptacle type |
an..5 |
BG |
3 |
HandoverLocationCd |
string |
Handover location code |
an..25 |
CPH |
3 |
HandoverLocationName |
string |
Handover location name |
an..70 |
Copenhagen |
EdiContainers |
|||||
2 |
ContainerFid |
string |
|
an..35 |
|
2 |
ContainerSealNumber |
string |
|
an..25 |
|
2 |
ContainerWeight |
number |
|
12.3 |
|
2 |
ContainerTypeCd |
string |
|
an..5 |
|
2 |
JourneyId |
string |
|
an..32 |
|
EdiContainerEvents |
|||||
3 |
EventTypeCd |
string |
Event code |
n..3 |
108 |
3 |
EventLocalDate |
string |
Event local timestamp |
YYYY-MM-DD hh:mm:ss |
2021-03-05 16:30:00 |
3 |
CaptureGmtDate |
string |
Event capture timestamp (GMT) |
YYYY-MM-DD hh:mm:ss.sss |
2021-03-12 11:11:03.207 |
3 |
ConditionCd |
number |
The receptacle condition |
0-255 |
NULL |
Example
Response
See the example JSON response body here.
EDI addresses
Retrieves EDI addresses defined in IPS.
HTTP request
GET http://[host:port]/IPSAPIService/edidataservice.svc/rest/EDIAddresses?token={token}
Parameters
Parameter | Mandatory? | Description |
---|---|---|
token
|
Y | GUID for authorization |
Response body format
The body format for a 200 response is as follows:
Level |
Field |
Format |
Description |
Allowed values |
Example |
---|---|---|---|---|---|
EDI addresses |
|||||
1 |
MessageType | string | The type of EDI message exchanged sent to / received from this address | a6 | PREDES |
1 |
CountryCd | string | The country which the address applies to | a2 | AE |
1 |
AirlineCd | string | The transport company or ground handler which the address belongs to | a3 | Null |
1 | OperatorCd | string | The operator which the address belongs to | a3 | Null |
1 | OfficeFcd | string | The IMPC which the address applies to | a6 | Null |
1 | LocationFcd | string | The location which the address applies to | a5 | Null |
1 | MailClassCd | string | The mail class which the address applies to | a1 | C |
1 | MailCategoryCd | string | The mail category which the address applies to | a1 | Null |
1 | MessageVersion | numeric | The message version which the address applies to | n2 (max one decimal) | 2.1 |
1 | EdiAddress | string | The EDI address itself | an..35 | AE101 |
1 | CapeInd | numeric | EDI network where the address is registered (0: PostNet, 1: GXS) | n1 | 0 |
1 | ValidInd | numeric | Valid indicator | n1 | 1 |
1 | ProductTypeCd | string | The product type which the address applies to | a1 | Null |
Example
Response
See the example JSON response body here.