Crear vehículo
POST /api/transports
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Registra un vehículo.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
plate_number |
string | Sí | Placa (sin guion, p. ej. ABC123). Única. |
brand |
string | Sí | Marca. |
model |
string | Sí | Modelo. |
tuc |
string | No | Tarjeta única de circulación / certificado de habilitación vehicular. |
is_default |
boolean | No | Predeterminado al emitir guías. |
is_active |
boolean | No | Activo (por defecto true). |
Solo un registro puede tener is_default: true: al marcar uno como predeterminado, los demás se desmarcan.
Errores: 422 si falta un campo obligatorio, no cumple el formato o el número/placa ya existe.
Cuerpo
Content-Type: application/json
{
"plate_number": "ABC123",
"brand": "ISUZU",
"model": "NPR",
"tuc": "15M21028954E",
"is_default": true,
"is_active": true
}
Respuestas
201 — Creado
{
"success": true,
"data": {
"id": 2,
"plate_number": "ABC123",
"model": "NPR",
"brand": "ISUZU",
"tuc": "15M21028954E",
"is_default": true,
"is_active": true
},
"message": "Vehículo registrado con éxito"
}
422 — Validación
{
"success": false,
"message": {
"plate_number": [
"El campo plate number es obligatorio."
]
}
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.