Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

SubmitAddressCheckRequest

Field
Description
Example
Count
productProduct name for the unit.

AFM

1
customerSystemName of the customer system for the unit.

AFT

1
batchIdClient-side identifier for the unit (may be empty).
 

1
skipRouteCheck

Whether the route check shall be skipped for the customer addreses in the unit.

Setting this to true means that supportedByCarrier will only tell if there was a match on the address. 

false1
requireExactMatchWhether an exact match on a customer address was required to mark it as supported.false1
transportDate

The transport date used by the system to obtain the address coverage results. Format is yyyy-mm-dd.

This information is quality-enhancing data and is optional.

If unspecified the nearest Wednesday will be used.

2015-12-210 - 1
deliveryDate

The delivery date used by the system to obtain the address coverage results. Format is yyyy-mm-dd.

This information is quality-enhancing data and is optional.

If unspecified the nearest Wednesday will be used.

2015-12-220 - 1
customerAddress

Describes a customer address to be checked for coveage.
See detailed description of the addressCoverage entity below.

 


1 - 10'000

CustomerAddress

Field
Description
Example
Count
delivererMask

A mask that gives processing instructions to the service

.Specified

. The two mechanisms used are to tell that the address shall not be supported, and to tell the system that only specific distribution companies are qualified.

The mappings between a letter and a distribution company are specified per customer system.

 

AD

(letter A + letter D)

1
customerId

Customer identifier.

 


1
customerName

Customer name.

 


1
countryCodeThe country of the address.

FI

1
postalNameCity / place of the address.

Helsinki

1
zipCodeZip code of the address.001001
address

Customer address.

This can include street, house number, entrance and appartment number.

Esplanadi 5 A 51
co

CO address of the customer, if any.

 

0 - 1

SubmitAddressCheckResponse

Field
Description
Example
Count
uuid

Unique identifier for the processing unit, obtained in the response for the SUBMIT (SubmitAddressCheckV1) action.

388f70cd-3e0c-4be6-a51a-35f32e7e96d9

1
status

Describes the current status of the unit.

Processing states
Error states

QUEUED

REJECTED_BUSY

INPROGRESS

 


See more detailed descriptions of the states below.

INPROGRESS

1
secondsDelay

A hint from the server that may be provided if the server known when the status of the unit is likely to change. Defaults to two minutes.

The client should provide reasonable min, max and default values for the delay.

1201

Status codes

The service will return one of the below status codes.

...