Saltar al contenido
Facturador

Editar usuario

PUT /api/users/{user_id}

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

Edita un usuario. Acepta PUT o PATCH; la edición es parcial: name, email, type y establishment_id se completan con el valor actual si no se envían; el resto solo cambia si se envía.

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

Campos: los mismos de Crear usuario. password es opcional al editar (si la envías, también password_confirmation); el cambio de contraseña por API solo se aplica si la plataforma tiene habilitado el cambio de contraseña, de lo contrario se ignora sin error. modules/levels no se aplican al usuario principal de la empresa.

Errores:

  • 409 si intentas quitarte a ti mismo el tipo administrador, o si se excede el límite de usuarios del plan.
  • 422 por validación (correo repetido, etc.); 404 si no existe.

Parámetros

Parámetro Dónde Obligatorio Ejemplo Descripción
user_id ruta sí 2

Cuerpo

Content-Type: application/json

{
  "names": "JUAN CARLOS",
  "position": "Supervisor de ventas",
  "type": "seller",
  "edit_purchase": true
}

Respuestas

200 — Editado

{
  "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 CARLOS",
    "last_names": "PEREZ GOMEZ",
    "personal_email": "juan.perez@gmail.com",
    "corporate_email": "jperez@empresa.com",
    "personal_cell_phone": "987654321",
    "corporate_cell_phone": "912345678",
    "position": "Supervisor de ventas",
    "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": true,
    "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 actualizado"
}

409 — Quitarse admin

{
  "success": false,
  "message": "No puedes quitarte el tipo administrador a ti mismo."
}

404 — No existe

{
  "success": false,
  "message": "Registro no encontrado."
}

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.