ChangeDeviceAddInRatePlan (...)

Introduction
Moves devices that are billed on a rate plan of a Device Add-In to another of its rate plans. The previous rate plan's billing ends and the target rate plan's billing starts. If the change fails for a device, it is put back on its previous rate plan where possible (RatePlanChangeFailed); otherwise RatePlanNotRestored is returned and support must fix it. A device enrolled in MyGeotab but not billed on the Add-In is reported as NotEnrolled; enroll it with EnrollDeviceFromAddIn instead. Only reseller users can call this method.
Parameters

accountId

The account that owns the devices. Accepts either the integer account id (e.g. 90) or the string ERP/reseller account code (e.g. "STAF01"); the API auto-detects which form was supplied.

apiKey

The API key (User ID) of the authenticated reseller.

databaseName

The database name where the devices are registered.

deviceSerialNumbers

The serial numbers of the enrolled devices to move.

sessionId

The session ID of the authenticated reseller.

solutionId

The Solution ID of the Add-In.

targetRatePlanId

The rate plan to move the devices to, from the GetAvailableRatePlansForAddIn response. A rate plan that is not available for the Add-In fails every device with InvalidRatePlan and nothing is changed.
Return value
ApiChangeDeviceAddInRatePlanResponse containing per-device success or failure results. Devices already on the target rate plan succeed without a billing change; devices not enrolled in the Add-In fail with NotEnrolled.
Code samples

Loading API Runner...