Organizations

Organizations are the platform's tenants. Each organization is a business that uses Automatic Billing to charge its own customers.

Organization Fields

Field	Description
External ID	Unique identifier for external integrations
Name	Organization name
Document type	CPF or CNPJ
Document number	CPF or CNPJ (normalized, digits only)
Email	Primary contact email
Phone	Contact phone number
Addresses	List of addresses
Status	active (default)

Automatic Bootstrap

When creating an organization, the system automatically:

1. Creates the default company with the same registration data
2. Creates the default dashboard roles (owner, admin, viewer)
3. Creates the owner user with the organization's email

Lifecycle

• Create: Provide registration data, receive a ready organization with company and users
• Update: Name, contact, and addresses are editable
• Delete: Soft delete (only if there are no active billing accounts)

Data Model

The organization uses a Person (Person with type=organization) to store registration data. This allows organizations and customers to share the same flexible data model.