Información General
Los endpoints de empresas permiten gestionar la información de las empresas registradas en el sistema, incluyendo la carga de logos y el cambio de empresa activa para usuarios administradores. Todas las operaciones requieren autenticación mediante token Bearer.Listar Empresas
Obtiene la lista completa de empresas registradas en el sistema, ordenadas por ID descendente.Respuesta
Obtener Empresa
Obtiene los detalles de una empresa específica.Parámetros de Ruta
Respuesta
Errores
Actualizar Empresa
Actualiza los datos de una empresa, incluyendo la posibilidad de subir un nuevo logo.Parámetros de Ruta
Parámetros del Body (FormData)
Ejemplo de Solicitud
Respuesta Exitosa
Validación
Eliminar Logo
Elimina el logo de una empresa del sistema de archivos y de la base de datos.Parámetros de Ruta
Respuesta
Cambiar Empresa Activa
Cambia el contexto de empresa activa para el usuario autenticado. Todas las consultas posteriores se realizarán en el contexto de la nueva empresa.Parámetros del Body
Ejemplo de Solicitud
Respuesta Exitosa
Errores
Consultas con Scope de Empresa
Ejemplo de Query Scope
Modelo de Datos
Tabla: empresas
| Campo | Tipo | Descripción |
|---|---|---|
| id_empresa | INT | Primary key |
| ruc | VARCHAR(11) | RUC único de la empresa |
| razon_social | VARCHAR(245) | Razón social |
| comercial | VARCHAR(245) | Nombre comercial |
| direccion | VARCHAR(245) | Dirección fiscal |
| VARCHAR(145) | Email de contacto | |
| telefono | VARCHAR(30) | Teléfono principal |
| telefono2 | VARCHAR(30) | Teléfono secundario |
| telefono3 | VARCHAR(30) | Teléfono terciario |
| ubigeo | VARCHAR(6) | Código de ubigeo SUNAT |
| distrito | VARCHAR(45) | Distrito |
| provincia | VARCHAR(45) | Provincia |
| departamento | VARCHAR(45) | Departamento |
| user_sol | VARCHAR(45) | Usuario SOL SUNAT |
| clave_sol | VARCHAR(45) | Clave SOL SUNAT |
| logo | VARCHAR(255) | Ruta del archivo de logo |
| igv | DECIMAL(3,2) | Tasa de IGV (0.18) |
| modo | ENUM | production, test |
| estado | CHAR(1) | 1=Activo, 0=Inactivo |
| created_at | TIMESTAMP | Fecha de creación |
| updated_at | TIMESTAMP | Fecha de actualización |
Configuración SUNAT
Ambiente de Pruebas (Beta)
Para pruebas, SUNAT proporciona credenciales genéricas:- RUC: 20000000001
- Usuario SOL: MODDATOS
- Clave SOL: moddatos