Saltar al contenido
Facturador

Crear usuario

POST /api/users

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Registra un usuario.

Quién puede usarlo: solo usuarios de tipo administrador (type = admin). Con el token de un vendedor responde 403.

Campo Tipo Obligatorio Descripción / valores permitidos
name string Sí Nombre visible del usuario (máx. 255).
email string Sí Correo de ingreso. Único en la empresa.
type string Sí admin (administrador) o seller (vendedor).
password string Sí al crear Mínimo 6 caracteres. Si la empresa exige contraseña segura: al menos una minúscula, una mayúscula, un número y un símbolo (@.$!%*#?&-).
password_confirmation string Sí si envías password Debe ser igual a password.
establishment_id integer Sí Establecimiento del usuario.
document_id string No Tipo de comprobante por defecto (01, 03, 80...).
series_id integer No Serie por defecto (id de serie).
default_document_types array No Series por defecto por tipo de documento: [{document_type_id, series_id}]. Si se envía, reemplaza las anteriores.
multiple_default_document_types boolean No true para usar varias series por defecto (default_document_types).
identity_document_type_id string No Tipo de documento de identidad del usuario: 1 DNI, 4 carné de extranjería, 6 RUC, 7 pasaporte.
number numeric No Número del documento de identidad.
names string No Nombres.
last_names string No Apellidos.
address string No Dirección.
position string No Cargo.
personal_email string No Correo personal (formato correo).
corporate_email string No Correo corporativo (formato correo).
personal_cell_phone string No Celular personal (máx. 30).
corporate_cell_phone string No Celular corporativo (máx. 30).
date_of_birth date No Fecha de nacimiento YYYY-MM-DD.
contract_date date No Fecha de contrato YYYY-MM-DD.
restaurant_pin string No PIN para el módulo de restaurante (máx. 20).
modules array No Ids de los módulos de la plataforma a los que tendrá acceso. Solo se asignan los que la empresa tiene contratados. Pide los ids al administrador de la plataforma o cópialos de GET /api/users/{id} de un usuario existente.
levels array No Ids de los submódulos (niveles). Misma regla que modules.
app_modules array No Ids de los módulos visibles en la app móvil.
create_payment boolean No Permiso para registrar pagos.
delete_payment boolean No Permiso para eliminar pagos.
edit_purchase boolean No Permiso para editar compras (necesario para Editar compra).
annular_purchase boolean No Permiso para anular compras (necesario para Anular compra).
delete_purchase boolean No Permiso para eliminar compras (necesario para Eliminar compra).
permission_edit_cpe boolean No Permiso para editar comprobantes.
recreate_documents boolean No Permiso para regenerar comprobantes.
permission_force_send_by_summary boolean No Permiso para forzar el envío por resumen.
permission_edit_item_prices boolean No Permiso para cambiar precios de productos al vender.
bot_enabled boolean No Habilita el asistente para el usuario.

Errores:

  • 422 si falta un campo obligatorio, el correo ya existe, la contraseña no cumple las reglas o no coincide con la confirmación.
  • 409 si se alcanzó el límite de usuarios del plan.

Cuerpo

Content-Type: application/json

{
  "name": "JUAN PEREZ",
  "email": "jperez@empresa.com",
  "type": "seller",
  "password": "Secreta123",
  "password_confirmation": "Secreta123",
  "establishment_id": 1,
  "document_id": "01",
  "series_id": 1,
  "multiple_default_document_types": true,
  "default_document_types": [
    {
      "document_type_id": "01",
      "series_id": 1
    },
    {
      "document_type_id": "03",
      "series_id": 2
    }
  ],
  "identity_document_type_id": "1",
  "number": "45678912",
  "names": "JUAN",
  "last_names": "PEREZ GOMEZ",
  "address": "JR. LAS FLORES 123",
  "position": "Vendedor",
  "personal_email": "juan.perez@gmail.com",
  "corporate_email": "jperez@empresa.com",
  "personal_cell_phone": "987654321",
  "corporate_cell_phone": "912345678",
  "date_of_birth": "1990-05-20",
  "contract_date": "2026-01-15",
  "restaurant_pin": "1234",
  "modules": [
    1,
    2,
    5
  ],
  "levels": [
    3,
    4
  ],
  "app_modules": [
    1,
    2
  ],
  "create_payment": true,
  "delete_payment": false,
  "edit_purchase": false,
  "annular_purchase": false,
  "delete_purchase": false,
  "permission_edit_cpe": false,
  "recreate_documents": false,
  "permission_force_send_by_summary": false,
  "permission_edit_item_prices": true,
  "bot_enabled": false
}

Respuestas

201 — Creado

{
  "success": true,
  "data": {
    "id": 5,
    "name": "JUAN PEREZ",
    "email": "jperez@empresa.com",
    "type": "seller",
    "active": true,
    "locked": false,
    "establishment_id": 1,
    "establishment_description": "Oficina Principal",
    "document_id": "01",
    "series_id": 1,
    "identity_document_type_id": "1",
    "number": "45678912",
    "names": "JUAN",
    "last_names": "PEREZ GOMEZ",
    "personal_email": "juan.perez@gmail.com",
    "corporate_email": "jperez@empresa.com",
    "personal_cell_phone": "987654321",
    "corporate_cell_phone": "912345678",
    "position": "Vendedor",
    "photo": null,
    "address": "JR. LAS FLORES 123",
    "date_of_birth": "1990-05-20",
    "contract_date": "2026-01-15",
    "bot_enabled": false,
    "recreate_documents": false,
    "permission_edit_cpe": false,
    "create_payment": true,
    "delete_payment": false,
    "edit_purchase": false,
    "annular_purchase": false,
    "delete_purchase": false,
    "permission_force_send_by_summary": false,
    "permission_edit_item_prices": true,
    "multiple_default_document_types": true,
    "default_document_types": [
      {
        "document_type_id": "01",
        "series_id": 1
      },
      {
        "document_type_id": "03",
        "series_id": 2
      }
    ],
    "modules": [
      1,
      2,
      5
    ],
    "levels": [
      3,
      4
    ],
    "app_modules": [
      1,
      2
    ]
  },
  "message": "Usuario registrado"
}

422 — Correo repetido y sin contraseña

{
  "success": false,
  "message": {
    "email": [
      "correo electrónico ya ha sido registrado."
    ],
    "password": [
      "El campo contraseña es obligatorio."
    ]
  }
}

409 — Límite de usuarios

{
  "success": false,
  "message": "Ha superado el límite permitido para crear/activar usuarios."
}

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.