Cambiar el equipo del conductor

POST/app/v1/drivers/change-equipment/

Asigna el vehículo o remolque de uno o más conductores, por nombre de usuario y número de unidad. Si un conductor tiene copiloto, el cambio también se sincroniza con el copiloto.

Cada cambio se revisa por separado. La respuesta es 200 cuando todos salen bien, 207 cuando solo algunos (los correctos en results, los fallidos en errors) y 400 cuando ninguno. La unidad debe estar activa.

Autorización

X-API-KEYstring · encabezadoobligatorio

La clave de API de su empresa.

Cuerpo de la solicitud

application/json · obligatorio

updateslista de objectobligatorio

Una entrada por cambio. Al menos una.

Ver campos
usernamestringobligatorio

El nombre de usuario del conductor en DPB.

unit_nostringobligatorio

Número de unidad de un vehículo o remolque activo.

typeenumobligatorio

Si la unidad es el vehículo o el remolque del conductor.

Uno de: Vehicle Trailer

Respuesta

200El registro
resultslista de object

Cambios que salieron bien.

Ver campos
usernamestring
unit_nostring
typeenum

Uno de: Vehicle Trailer

statusenum

Uno de: success error

messagestring

Qué pasó con este cambio.

errorslista de object

Cambios que fallaron, con el motivo. Solo cuando algunos o todos fallaron.

Ver campos
usernamestring
unit_nostring
typeenum

Uno de: Vehicle Trailer

statusenum

Uno de: success error

messagestring

Qué pasó con este cambio.

Otras respuestas

207Algunos cambios salieron bien y otros fallaron.
{
  "results": [
    {
      "username": "driver1",
      "unit_no": "1001",
      "type": "Vehicle",
      "status": "success",
      "message": "Successfully updated default vehicle for driver1 to 1001"
    }
  ],
  "errors": [
    {
      "username": "driver2",
      "unit_no": "9999",
      "type": "Vehicle",
      "status": "error",
      "message": "Active equipment with unit_no '9999' and type 'Vehicle' not found."
    }
  ]
}
400Ningún cambio salió bien. Causas habituales: el nombre de usuario no existe en su empresa, o el número de unidad no es un vehículo o remolque activo de ese tipo.
{
  "results": [],
  "errors": [
    {
      "username": "nonexistent_driver",
      "unit_no": "1001",
      "type": "Vehicle",
      "status": "error",
      "message": "Driver with username 'nonexistent_driver' not found."
    }
  ]
}