Crear transportista
POST /api/dispatchers
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Registra un transportista.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
identity_document_type_id |
string | Sí | Solo 6 (RUC). |
number |
string | Sí | RUC de 11 dígitos que empiece con 10, 15, 16, 17 o 20. Único. |
name |
string | Sí | Razón social (mín. 2 caracteres, al menos una letra). |
address |
string | Sí | Dirección fiscal (mín. 3 caracteres, al menos una letra). |
number_mtc |
string | No | Registro MTC: solo letras y números, máx. 12. |
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": "6",
"number": "20512345678",
"name": "TRANSPORTES RAPIDOS S.A.C.",
"address": "AV. ARGENTINA 2450, CALLAO",
"number_mtc": "1512345CNG",
"is_default": true,
"is_active": true
}
Respuestas
201 — Creado
{
"success": true,
"data": {
"id": 1,
"identity_document_type_id": "6",
"number": "20512345678",
"name": "TRANSPORTES RAPIDOS S.A.C.",
"address": "AV. ARGENTINA 2450, CALLAO",
"number_mtc": "1512345CNG",
"is_default": true,
"is_active": true
},
"message": "Transportista 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.