Saltar al contenido
Facturador

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.