Saltar al contenido
Facturador

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.