Crear conductor
POST /api/drivers
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Registra un conductor.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
identity_document_type_id |
string | Sí | Tipo de documento (catálogo SUNAT 06): 1 DNI, 4 carné de extranjería, 7 pasaporte. |
number |
string | Sí | Número de documento. Único. |
name |
string | Sí | Nombres y apellidos. |
license |
string | Sí | Número de licencia de conducir. |
telephone |
string | Sí | Teléfono. |
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
{
"identity_document_type_id": "1",
"number": "45678912",
"name": "PEDRO QUISPE MAMANI",
"license": "Q45678912",
"telephone": "987654321",
"is_default": true,
"is_active": true
}
Respuestas
201 — Creado
{
"success": true,
"data": {
"id": 3,
"identity_document_type_id": "1",
"number": "45678912",
"name": "PEDRO QUISPE MAMANI",
"license": "Q45678912",
"telephone": "987654321",
"is_default": true,
"is_active": true
},
"message": "Conductor registrado con éxito"
}
422 — Validación
{
"success": false,
"message": {
"identity_document_type_id": [
"El campo identity document type id 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.