Cambiar a otra empresa (multiusuario)
POST /api/multi-users/change-client
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Devuelve el token y los datos del usuario vinculado en la empresa elegida. Después usa ese api_token y el dominio fqdn como base_url.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
Formato de respuesta: heredado {success, message?, data?} sin paginación. Ante reglas de negocio puede responder HTTP 200 con success: false: revisa siempre success.
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
multi_user_id |
integer | Sí | id de la fila elegida en Empresas vinculadas. |
is_destination |
boolean | Sí | is_destination de esa fila. |
fqdn |
string | Sí | fqdn de esa fila; debe coincidir con la empresa del vínculo. |
Errores:
- Validación:
422con{success: false, message: {campo: [mensajes]}}. - Si el
fqdnno coincide o el vínculo no existe responde HTTP 500 consuccess: falsey el motivo enmessage. - Si el usuario destino no tiene token: HTTP 200 con
success: false.
Cuerpo
Content-Type: application/json
{
"multi_user_id": "1",
"is_destination": true,
"fqdn": "norte.dominio"
}
Respuestas
200 — Datos de la empresa destino
{
"success": true,
"user_name": "Ventas Norte",
"user_email": "ventas@norte.pe",
"establishment_id": 1,
"api_token": "Xy9kL2mN4pQ7rS1tU3vW5xY8zA0bC6dE",
"ruc": "20987654321",
"app_logo": "logo_20987654321.png",
"company": {
"name": "SUCURSAL NORTE S.A.C.",
"address": "LIMA, LIMA, LIMA, AV. NORTE 100",
"phone": "014445566",
"email": "ventas@norte.pe"
},
"app_configuration": {
"id": 1,
"show_image_item": true,
"print_format_pdf": "ticket",
"theme_color": "blue",
"card_color": "unicolor",
"header_waves": true,
"app_mode": "default",
"direct_print": false,
"has_igv_31556": false,
"igv_31556_percentage": 0.1,
"direct_send_documents_whatsapp": false,
"primary_color": "#020F3C"
}
}
500 — fqdn distinto
{
"success": false,
"message": "El fqdn actual es diferente al obtenido para iniciar sesión: otro.dominio - norte.dominio"
}
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.