Organizations

Understanding organizational structure and multi-tenancy in the c.technology platform.

Organizations represent any entity that manages vehicles, users, and data within the c.technology platform. This includes vehicle manufacturers (OEMs), dealerships, fleet operators, and service providers, among others.

Organization structure

Organizations are structured as given below.

Organizations are the only entity within the c.technology platform that do not use UUIDs / TypeIDs as identifiers. Instead, they use reverse domain names (e.g. com.demoCompany).

{
    "id": "com.demoCompany",  // Unique organization ID, as a reverse domain name.
    "primary_vehicle_type": "BOAT",
    "organization_type": "OEM",  // Type of organization: OEM, PROFESSIONAL.
    "name": "Demo Company",
    "email": "[e-mail]",
    "support_email": null,
    "email_new_message": true,
    "telephone": "0041234567890",
    "website": "www.ctechnology.io",
    "addr_street": "Tessinerplatz 07",
    "addr_city": "Zürich",
    "addr_zip": "8004",
    "addr_country": "Switzerland",
    "longitude": 8.532224063229377,
    "latitude": 47.36412910278374,
    "preferred_contact_via": "EMAIL",
    "general_theme": {  // General branding and theming settings for web and mobile apps.
        "webapp": "https://app.ctechnology.io",
        "appName": "ctechnology",
        "website": "https://ctechnology.io",
        "textColor": "#ffffff",
        "primaryColor": "#001f3f",
        "secondaryColor": "#F9413C",
        "primaryColorTransparent": "rgba(0, 178, 178, 0.2)",
        "secondaryColorTransparent": "rgb(0, 179, 184, 0.2)"
    },
    "vehicle_theme": null,
    "auto_invoice": false,
    "developer_access": true,  // Whether the organization has developer access to APIs and API keys.
    "logo_url": "...",
    "logo_square_url": "...",
    "favicon_url": "...",
    "dashboard_background_url": "...",
    "managed": true  // Whether the organization is managed by another organization or independent.
}

Organization members

Organization members are represented as a stripped-down user object with additional role and permission information.

{
    "user": {
        "id": "usr_01jnk61cv5ev1a1ty1136gfwh6",
        "email": "[e-mail]",
        "first_name": "Demo",
        "last_name": "User",
        "profile_picture_url": "/static/img/dude.png"
    },
    "role": "USER_ORG_ADMIN",
    "permissions": []
}

Organization vehicles

When retrieveing vehicles, the format corresponds to the format explained in the vehicle section.

Organization partners

Partner organizations are organizations that have a professional relationship with your organization. For example, as a vehicle manufacturer, you may have partnerships with dealerships, service providers, or mechanics.

As such, they are represented with the same structure as organizations above, potentially with restricted access to individual fields.

Multi-tenancy on the c.technology platform

The c.technology platform is designed as a multi-tenant system where multiple organizations can operate independently while sharing the same underlying infrastructure. For example, you as a vehicle manufacturer may have your own organization, running on the same platform as a fleet operator or dealership, but with separation according to strict access rules.

Please contact [e-mail] or your customer representative if you have questions or additional requirements regarding multi-tenancy and organizational structure.

Billing and subscriptions

Organization-level billing includes subscription management with plans and features at the organization level, usage-based pricing with charges based on vehicle count, multi-tier pricing with different pricing for different organization types, and volume discounts with reduced pricing for large-scale deployments. Upon creating an organization, you will receive a monthly invoice based on your subscription plan and vehicle count.