Versions Compared

Key

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

...

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
nextAction

Describes what the client should do next:

  • STOP : stop sending more requests for this UUID to the service
  • REPEAT : send a new request with this UUID to get updated information

STOP

1
status

Describes the current status of the unit.

Processing statesResult statesError states

QUEUED

COMPLETED

 

REJECTED_BUSY

INPROGRESS

COMPLETED_PARTIAL

 

FAILED
 

COMPLETED_RESENT

 

INVALID_UUID
  EXCEEDED_MAX_PROCESSING_TIME

Terminal statuses are all result states and error states.
They have the nextAction field set to STOP, which means that the clien client should stop sending requests to the service with that UUID.

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 shuld provide reasonable min, max and default values for the delay.

1201
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
skipRouteCheckWhether the route check was performed or not for the customer addreses in the unit.false1
requireExactMatchWhether an exact match on a customer address was required to mark it as supported.false1
transportDateThe transport date used by the system to obtain the address coverage results. Format is yyyy-mm-dd.2015-12-211
deliveryDateThe delivery date used by the system to obtain the address coverage results. Format is yyyy-mm-dd.2015-12-211
addressCoverage

Describes a customer, whether his/her address is supported, and gives transport information if supported.
See detailed description of the addressCoverage entity below.

Whether there are zero or more address coverage items depends on the nextAction field.
If it is STOP there will be as many items as received when the batch was submitted through SubmitAddressCheckV1.
If it is REPEAT there will be zero  address coverage items.

 0 - 10'000

...

Field
Description
Example
Count
customerId

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

 

1
supportedByCarrier

Whether the customer address is covered by carrier.

true

1
authorityThe source system that made the decision about the customer address being supported by carrier or not.

DI

1
companyName of the qualifying distribution company.

MANU

0 - 1
transportWhat is this precieslyprecisely?85000 - 1
rotueNoRoute number of the covering route.5234430 - 1
routeName

Name of covering route.

Keskusta 201 0 - 1
addrSeqAddress sequence defining sorting on the associated route.510 - 1
locationWhat is this precieslyprecisely?Patamäenkatu 90 - 1

 

The field supportedByCarrier determines whether the fields with count 0 - 1 will be present (true) or not.