Saltar al contenido
Facturador

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: 422 con {success: false, message: {campo: [mensajes]}}.
  • Si el fqdn no coincide o el vínculo no existe responde HTTP 500 con success: false y el motivo en message.
  • 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.