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

Mail categories

Mail classes

Mail subclasses

Conveyance types

Product types

Receptacle content formats

Receptacle types

Conditions

Postal statuses

Service indicators

Event types

State indicators

Currencies

Countries

Postal operators

Airlines

IMPCs

Locations

Location types

Location statuses

Own offices

Accounting agreement types

Accounting agreements in place with partner operators

Accounting stream types

Accounting periods

Accounting action types

Operator groups for accounting

Allowed partnerships for document capture

Verification note reasons

Verification note reason categories

Accounting rates

EDI data

Terminal dues rates (letters and EMS)

Calculated IPKs

Parcel bill rates

Internal Air Conveyance charges

A decouvert groups and charges

Closed transit charges

Mail items, receptacles, dispatches, consignments:

EDI information from EMSEVT

EDI information from PREDES/RESDES

EDI information from PRECON/RESCON/CARDIT/RESDIT

EDI addresses

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

ClosedResponse 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

ClosedResponse 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

ClosedResponse 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

ClosedResponse 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

ClosedResponse 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

ClosedResponse 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

ClosedResponse 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

ClosedResponse 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

ClosedResponse 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

ClosedResponse 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

ClosedResponse 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

ClosedResponse 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

ClosedResponse 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

ClosedResponse 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

ClosedResponse

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

ClosedResponse 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

ClosedResponse 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

ClosedResponse 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

ClosedResponse

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

ClosedResponse 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

ClosedResponse 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

ClosedResponse 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

ClosedResponse 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

ClosedResponse 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

ClosedResponse 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

ClosedResponse 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

ClosedResponse 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

ClosedResponse 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

ClosedResponse 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

ClosedResponse 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

ClosedResponse 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

ClosedResponse 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

ClosedResponse 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

ClosedResponse 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

ClosedResponse 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

ClosedResponse

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

ClosedResponse 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

ClosedResponse 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

ClosedResponse 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

ClosedResponse

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

ClosedResponse 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

ClosedResponse

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

ClosedResponse 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

ClosedResponse

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

ClosedResponse 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

ClosedResponse

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

ClosedResponse 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.