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:
422si falta un campo obligatorio, el correo ya existe, la contraseña no cumple las reglas o no coincide con la confirmación.409si 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.