Saltar al contenido principal

Organizaciones

Las organizaciones son los tenants (inquilinos) de la plataforma. Cada organización es un negocio que usa Facturación Automática para cobrar a sus propios clientes.

Campos de la Organización

CampoDescripción
ID externoIdentificador único para integraciones externas
NombreNombre de la organización
Tipo de documentoCPF o CNPJ
Número del documentoCPF o CNPJ (normalizado, solo dígitos)
E-mailE-mail principal de contacto
TeléfonoTeléfono de contacto
DireccionesLista de direcciones
Statusactive (predeterminado)

Bootstrap Automático

Al crear una organización, el sistema automáticamente:

  1. Crea la empresa predeterminada con los mismos datos de registro
  2. Crea los roles de dashboard predeterminados (owner, admin, viewer)
  3. Crea el usuario propietario con el e-mail de la organización

Ciclo de Vida

  • Crear: Proporciona datos de registro, recibe organización lista con empresa y usuarios
  • Actualizar: Nombre, contacto y direcciones editables
  • Eliminar: Soft delete (solo si no hay cuentas de cobro activas)

Modelo de Datos

La organización utiliza una Persona (Person con type=organization) para almacenar los datos de registro. Esto permite que organizaciones y clientes compartan el mismo modelo flexible de datos.