Saltar al contenido
Facturador

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.