Report IM completion

General

This event is emitted when a salvor has completed his IM order.

Specification

TEST

Open-api specification: https://berger.test.assistanceonline.nl/api/assignments-external/v2/swagger/v1/swagger.json

Swagger-ui: https://berger.test.assistanceonline.nl/api/assignments-external/v2/swagger/

PROD

Open-api specification: https://berger.assistanceonline.nl/api/assignments-external/v2/swagger/v1/swagger.json

Swagger-ui: https://berger.assistanceonline.nl/api/assignments-external/v2/swagger/

XSD

Example messages

Models

ImCompletionReportRequest

General set of fields, describing the general IM completion characteristics.

Element

Description

Type

Mandatory

Example

Element

Description

Type

Mandatory

Example

Receiver

Identifier of the sender (customer) of the original order (in case of chartering)

Name of the debtor of the order (in case of IM-order)

String

Yes

Van Eijck

Sender

Unique identifier for the towing company

String

Yes

tenant-1

SalvorCode

Unique identifier for the towing company

String

No

2050

District

The district in which the incident location is located

String

No

O77

RoadType

The roadtype of the incident location

Enumeration

No

Unknown = 0,
Primary = 1,
Secondary = 2

Solution

The given solution for the vehicle which has been filled by the executing salvor

String

No

Changed battery

OrderNumber

Number of the order given by the salvor. Used to identify the correct order in the feedback message

String

No

O-00001

CommentsToCustomer

Additional comments for the customer

string

No

 

TimeRegistrations

See TimeRegistrations

Array of TimeRegistrations

No

 

Locations

See Locations

Array of Locations

No

 

Route

See Route

Array of Legs

No

 

FinalResult

See FinalResult

Final Result

No

 

ConsignmentNotes

See ConsignmentNotes

Array of ConsignmentNotes

No

 

Vehicle

See Vehicle

Vehicle object

No

 

DriverDetails

See DriverDetails

DriverDetails object

No

 

InsuranceDetails

See InsuranceDetails

InsuranceDetails object

No

 

ImReferenceDetails

See ImReferenceDetails

ImReferenceDetails object

No

 

EntryDate

The datetime of when incident was reported.

Date

No

2024-06-06T10:25:55.620Z

TimeRegistrations

A list of time registrations for each action the executing salvor has performed.

Element

Description

Type

Mandatory

Example

Element

Description

Type

Mandatory

Example

Type

The performed action

Enumeration

No

None = 0,
AssignmentAccepted = 1,
Assigned = 2,
EnrouteToLocation = 3,
Arrived = 4,
Started = 5,
Loaded = 6,
Unloaded = 7

Timestamp

The datetime of when the action was performed

Date

No

2021-12-06T10:23:35.520Z

LocationIndex

Index corresponding with the From/To of the Leg

Integer

No

1

ReasonForLateArrival

Reason for why the executing salvor was too late on the given incident location. This is a list with fixed values.

String

No

Traffic jam

LegId

Unique identifier of the leg

Guid

No

 

Locations

List of key value pairs consisting of a GUID and the Location. Describes the location and the role it takes in the assignment. This could be a public road or an address.

Element

Description

Type

Mandatory

Example

Element

Description

Type

Mandatory

Example

LocationRole

Describes the role which the location has in the assignment. If the assignment does not require transportation, 1 location (load) will be sufficient

Enumeration

Yes

Load = 0,
Destination = 1,
LayoverLocation = 2,
PersonDestination = 3,
LuggageDestination = 4

LocationType

Describes if the location is a mainRoad or an address. Based on this choice the fields below the yellow lines (below) must be provided

Enumeration

Yes

Unknown = 0,
MainRoad = 1,
Coordinates = 2,
Address = 3

Remark

Remark for the provided location 

String

No

On crossroads with Central street 

Name

Optional name of the location

String

No

Makro Zwolle

MainRoad (if locationType == mainRoad)

Hmp

Hectometre post

Number

Yes

17.1

Direction

Direction sign

Enumeration

Yes

Unknown = 0,
Li = 1,
Re = 2

Roadname

Main road name (Highway)

String

Yes

A35

HmpAddition

Hectometre post addition

String

 

l

CountryIso2

Countrycode in ISO2. If empty than default = NL 

String

Yes

NL

 

Address (if locationType == address)

StreetName

Streetname

String

 

Dorpstraat

HouseNumber

Address number

String

Yes

18a

City

City

String

 

Zwolle

PostalCode

Zip code

String

Yes

8102XC

CountryIso2

Countrycode in ISO2. If empty then default = NL

String 

Yes

NL

 

Coordinates

Latitude

X coordinate in geodecimal formaat (DD)

Number

 

31.157845

Longitude

Y coordinate in geodecimal formaat (DD)

Number

 

5.15478

 

Restrictions

IsParkingGarage

Describes if the address provided is a parking garage.

Note: this field is not used at the moment.

Boolean

 

true

MinEuroclassification

Describes if the address is within a environmental zone

Note: this field is not used at the moment.

Number

 

5

 

OpeningHours (list)

DayOfWeek

Day of the week

Enumeration

 

Sunday = 0,
Monday = 1,
Tuesday = 2,
Wednesday = 3,
Thursday = 4,
Friday = 5,
Saturday = 6

From

Start opening time

String

 

08:00

To

Eind opening time

String

 

18:00

 

Contacts (list)

Name

Name of contact / department 

String

 

Jan Jansen

Phone

Telephone on which the contact could be reached 

String

 

0123-4567890

Role

Enumeration describing the relation of the contact and the location

Enumeration

Yes

Primary = 0,
Other = 1

Route

List of legs that the vehicle in need of service has been transported.

Element

Description

Type

Mandatory

Example

Element

Description

Type

Mandatory

Example

Id

Unique identifier of the leg 

Guid

No

 

From

The index of the location

Integer

No

0

To

The index of the location

Integer

No

1

FinalResult

The result of the order. Describing what was the cause of the incident and what the executing salvor did to solve this.

Element

Description

Type

Mandatory

Example

Element

Description

Type

Mandatory

Example

Type

The type of assignment

Enumeration

No

Breakdown = 0,
PlannableTransportation = 1,
Damage = 2,
ErrorParked = 3,
Seizure = 4,
LostCargo = 5,
AbandonedVehicle = 6,
Cleaning = 7,
Security = 8,
NonPlannableTransportation = 9,
None = 10

AssignmentResultType

The result of the assignment

Enumeration

No

None = 0,
BreakdownAssistanceOk = 1,
BreakdownAssistanceNotRepairedTransportToDepot = 2,
BreakdownAssistanceNotRepairedTransportToDestination = 3,
BreakdownAssistanceTransportWithoutRepairAttempt = 4,
OwnStrength = 5,
SalvageDepot = 6,
SalvageFinalDestination = 7,
EmptyRide = 8,
JobResultOk = 9,
SecondSalvor = 10

Cause

The cause of the incident

String

No

Battery

ConsignmentNotes

List of consignment notes which can be downloaded.

Element

Description

Type

Mandatory

Example

Element

Description

Type

Mandatory

Example

Id

Unique identifier of the consignment note

Guid

No

 

LegId

Note: This field is not used and always empty (0)

Integer

No

0

PdfUri

Public download URI which can be used to download the consignment note.

Note: this link is valid for 7 days

String

No

 

Vehicle

Description of the vehicle in need of service.

Element

Description

Type

Mandatory

Example

Element

Description

Type

Mandatory

Example

LicensePlate

License plate 

String

Yes

AB12AB

ChassisNumber

Chassis number

String

No

234234SD23FDSF

Mileage

Mileage at the point of service 

Number

No

123456

VehicleType

Description of the vehicle type

Enumeration

Yes

Car = 0,
Truck = 1,
Trailer = 2,
Boat = 3,
Bike = 4,
Other = 5

Remark

Remark of the vehicle

String

No

Burned down 

 

State

IsLocatedInWater

Vehicle is in the water

Boolean

No

True

MetersToQuay

Distance to quay

Number

No

18

IsRollable

Vehicle is rollable

Boolean

No

True

IsSteeringWheelLocked

Vehicle steering wheel is locked

Boolean

No

True

HasTrailer

Vehicle has trailer attached

Note: this field is not used at the moment.

Boolean

No

True

HasBikeCarrier

Vehicle has bike carrier attached

Note: this field is not used at the moment.

Boolean

No

True

LocationKeys

Known location for keys

Note: this field is not used at the moment.

String

No

Under left wheel

LocationDocuments

Known location for papers

Note: this field is not used at the moment.

String 

No

Dashboard

 

Properties

Make

Make of the vehicle

String

No

Ford

Model

Type of the vehicle

String

No

Focus D1

Color

Color of the vehicle

String

No

Zwart

WeightKg

Weight of the empty vehicle

Number

No

1500

LengthCm

Length of the vehicle in cm 

Number

No

500

HeightCm

Height of the vehicle in cm

Number

No

180

WidthCm

Width of the vehicle in cm

Number

No

230

FuelType

Type of fuel system

Enumeration

No

Diesel = 0,
Gas = 1,
Benzine = 2,
Hybrid = 3,
Electric = 4,
Other = 5

IsManualGear

Manual gear 

Boolean

No

True

Is4x4

4x4

Boolean

No

False

IsForeign

Vehicle is not registered in the NL

Boolean

No

False

IsElectric

Vehicle is electric

Boolean

No

False

DriverDetails

Description of the driver of the vehicle in need of service.

Element

Description

Type

Mandatory

Example

Element

Description

Type

Mandatory

Example

Gender

The gender of the driver

Note: this field is not used at the moment.

Enumeration

No

Male= 0,
Female = 1

Initials

The initials of the driver

String

No

RCB

Prefixes

The prefixes of the driver 

String

No

Van der

FirstName

The first name of the driver

Note: this field is not used at the moment.

String

No

Ron

LastName

The name of the driver

String

No

Ron Jansen

Email

The email of the driver

String

No

ron.jansen@test.com

Phone

The phone number of the driver

String

No

0572-05721

CellPhone

The mobile phone number of the driver

String

No

06-12345678

LicenseNumber

The license number of the driver

Note: this field is not used at the moment.

String

No

123456789

LicenseExpires

The expire date of the license

DateTime

No

2025-01-01

 

Address 

StreetName

Streetname

String

 

Dorpstraat

HouseNumber

Address number

String

Yes

18a

City

City

String

 

Zwolle

PostalCode

Zip code

String

Yes

8102XC

CountryIso2

Countrycode in ISO2. If empty then default = NL

String 

Yes

NL

InsuranceDetails

Description of the policy holder of the vehicle in need of service.

Element

Description

Type

Mandatory

Example

Element

Description

Type

Mandatory

Example

Name

The name of the insurance company

String

No

Achmea

PolicyNumber

The policy number

String

No

123456789

ValidTillDate

The expiration date of the policy

DateTime

No

2025-01-01

TypeOfCoverage

Type of coverage of the vehicle

Enumeration

No

WA = 0,
WAplus = 1,
WACasco = 2,
NonInsured = 3

 

PolicyOwnerDetails

Gender

The gender of the driver

Note: this field is not used at the moment.

Enumeration

No

Male= 0,
Female = 1

Initials

The initials of the driver

String

No

RCB

Prefixes

The prefixes of the driver 

String

No

Van der

FirstName

The first name of the driver

Note: this field is not used at the moment.

String

No

Ron

LastName

The name of the driver

String

No

Ron Jansen

Email

The email of the driver

String

No

ron.jansen@test.com

Phone

The phone number of the driver

String

No

0572-05721

CellPhone

The mobile phone number of the driver

String

No

06-12345678

LicenseNumber

The license number of the driver

Note: this field is not used at the moment.

String

No

123456789

LicenseExpires

The expire date of the license

DateTime

No

2025-01-01

 

Address 

StreetName

Streetname

String

 

Dorpstraat

HouseNumber

Address number

String

Yes

18a

City

City

String

 

Zwolle

PostalCode

Zip code

String

Yes

8102XC

CountryIso2

Countrycode in ISO2. If empty then default = NL

String 

Yes

NL

ImReferenceDetails

Reference to the original ImOrder

Element

Description

Type

Mandatory

Example

Element

Description

Type

Mandatory

Example

CaseReference

CaseReference as given by SIMN

string

No

 

ExpenditureReference

ExpenditureReference as given by SIMN

string

No

Â