Editar vehiculo

[ PUT ]

En esta ruta se podrá actualizar un recurso de tipo Vehículo. Es importante ver las diferentes opciones que las variables pueden tomar ya que estas serán utilizadas por el planeador de rutas para hacer ruteo por dimensiones.

https://sync.airbagtech.io/vehicle/{{VEHICLE_ID}}

Campos

Nombre	Tipo	Requerido	Descripción
VEHICLE_ID	String	Si	ID del vehículo que desea editar. Acepta el ID que tu empresa usó al crearlo o el airbagId. Este valor deberá ir en la ruta.
name	String	No	Nombre a mostrar en la aplicación móvil y web.
plate	String	No	Placas legales del vehículo.
vehicleType	String	No	Categoría del vehiculo. Este campo será utilizado para el ruteo por dimensiones. Debe ser uno de los valores válidos listados en la sección Vehiculos
brand	String	No	Marca del vehiculo. Debe ser uno de los valores válidos listados en la sección Vehiculos, por ejemplo Toyota. Envíala siempre (ver aviso).
model	String	No	Modelo del vehiculo (texto libre).
fuelType	String	No	Tipo de combustible del vehículo. Debe ser uno de los valores válidos listados en la sección Vehiculos
niv	String	No	Número identificador oficial del vehículo.
color	String	No	Color del vehiculo.
description	String	No	Descripción del vehiculo.
policyNumber	String	No	Número de póliza otorgado por el Carrier.
insuranceCarrier	String	No	Aseguradora que protege a dicho vehiculo. Debe ser uno de los valores válidos listados en la sección Vehiculos
insuranceExpiration	String	No	Fecha de expiración del seguro. Notificaremos a la empresa cuando sea cercana la fecha. Formato YYYY-MM-DD
height	Number	No	Altura del vehiculo en metros. Pasar en caso de escoger 'Otro' en vehicleType
length	Number	No	Longitud del vehículo en metros. Pasar en caso de escoger 'Otro' en vehicleType
width	Number	No	Ancho del vehiculo en metros. Pasar en caso de escoger 'Otro' en vehicleType.
driverId	String	No	ID del conductor que usará el vehículo. Acepta el ID que tu empresa usó al crear el conductor o el airbagId.

aviso

• Por ahora, si una edición no incluye brand, la marca guardada se reemplaza por Otro. Envía siempre la marca actual del vehículo junto con los campos que cambies. Se está corrigiendo.
• Por ahora insuranceExpiration y driverId se aceptan pero no se guardan. Se está corrigiendo; mientras tanto, captúralos desde la plataforma de Airbag.

Headers

Content-Type	Authorization
application/json	apikey {{API_KEY}}

Body

{
  "vehicle": {
    "plate": "string",
    "name": "string",
    "vehicleType": "string",
    "brand": "string",
    "model": "string",
    "fuelType": "string",
    "niv": "string",
    "color": "string",
    "description": "string",
    "policyNumber": "string",
    "insuranceCarrier": "string",
    "insuranceExpiration": "string",
    "height": 0,
    "length": 0,
    "width": 0,
    "driverId": "string"
  }
}

Ejemplo

curl --location -g --request PUT 'https://sync.airbagtech.io/vehicle/{{VEHICLE_ID}}' \
--header 'Content-Type: application/json' \
--header 'Authorization: apikey {{API_KEY}}' \
--data '{
    "vehicle": {
        "plate": "string",
        "name": "string",
        "vehicleType": "string",
        "brand": "string",
        "model": "string",
        "fuelType": "string",
        "niv": "string",
        "color": "string",
        "description": "string",
        "policyNumber": "string",
        "insuranceCarrier": "string",
        "insuranceExpiration": "string",
        "height": 0,
        "length": 0,
        "width": 0,
        "driverId": "string"
    }
}'

Respuestas

✅ Respuesta exitosa (200 OK)

Devuelve sólo los campos del vehículo que se modificaron, más airbagId y company. Los campos posibles son los de Consultar la info de un vehículo; por ejemplo, name se devuelve como uid, fuelType como fuel y brand normalizada (Toyota → toyota).

{
  "status": true,
  "vehicle": {
    "plate": "XYZ9876",
    "uid": "Unidad 1",
    "brand": "toyota",
    "airbagId": "8PJbFlQm3kZ2xT0aYc1d",
    "company": "Mi Empresa"
  }
}

❌ Respuesta con error (400 Bad Request)

Se devuelve cuando el VEHICLE_ID no corresponde a ningún vehículo de tu empresa, cuando un campo no es válido o cuando el cuerpo incluye campos no permitidos.

{
  "status": false,
  "message": "Error: Vehicle not found",
  "errorId": "sentry_error_id_123"
}