Overview
The K2 Base integration connects Eturnity Expert with K2 Base for professional mounting system dimensioning. This workflow allows you to design PV systems in Expert, perform detailed structural planning in K2 Base, and import accurate bills of materials back to Expert—all with automated data transfer.
Value: K2 Base provides structural validation (wind/snow loads) and generates precise component lists with all rails, clamps, hooks, and mounting hardware needed for installation.
Step 1: Link Your Accounts
Connect your Eturnity Expert and K2 Base accounts using an authentication token. This is a one-time setup per user.
Generate Token in Eturnity Expert
Navigate to Settings > Integrations > K2 Base (in the new Settings navigation: Other > K2 Base)
Click Generate Token
Click Copy to copy your unique authentication token
Save Token in K2 Base
Log in to your K2 Base account
Click your user name (top right) and select Settings
Paste your token in the Eturnity Authentication Token field
Click Save
Your accounts are now linked
Step 2: Prepare and Export Your Project
After planning your PV project in Expert, make it available to K2 Base.
Requirements for Transfer
These conditions must be met:
Uses 3D layout (2D layouts cannot be transferred)
Uses K2 mounting systems exclusively
All module fields on the same roof use the same K2 mounting system type
Contains at least one roof with modules
Every panel field with panels has an offset of 0% (panel field sidebar in the 3D Panel layout)
You are the project manager of the project and have your own token (Step 1)
Export Process
Open your project and click K2 Base in the left project menu
Select the project variant you want to transfer
Click Transfer Project Data to K2
Wait for the success confirmation
Click Open K2 Base to launch K2 Base
Step 3: Import and Plan in K2 Base
Import your project into K2 Base to perform detailed mounting system planning and structural validation.
In K2 Base, click Open Project from K2+ on the dashboard
Select Eturnity from the integration options
Choose your project from the list. It only shows variants that were made available with Transfer project data to K2 and have not yet been opened in K2 Base, and only if the current project manager's token is saved in your K2 Base account. If a variant has stopped meeting a condition in the meantime, it is missing from the list.
Click Create Project to import
Complete the planning in K2 Base
Important: The exact module arrangement (row and column spacing) is not transferred 1:1 from Expert to K2 Base. K2 deliberately does not allow this: only this way can K2 ensure that row and column spacing, thermal gaps, and the entire mounting system design comply with applicable standards. K2 Base therefore recalculates the module layout itself based on the roof area you transferred.
Step 4: Export Bill of Materials to Expert
After completing your K2 planning, export the detailed bill of materials back to Eturnity Expert.
In K2 Base, navigate to the Summary step
Click K2+ Eturnity Export on the left sidebar
Select Eturnity
Expert opens the bill of materials of the transferred variant, makes it the active variant and shows the Your bill of materials window. This only works if you are logged in to Expert as the user who transferred the variant; for other users, the window closes after loading without a message.
Configure Import Settings
The bill of materials is divided into two sections:
New Components (top section): Components that your library does not hold as an active Other component for photovoltaics under exactly this name
Define Purchase Discount (percentage off K2 list price)
Define Margin (your markup percentage)
Set Exchange Rate if needed (K2 prices are in EUR)
Click Apply to All Positions
Existing Components (bottom section): Components that your library holds as an active Other component for photovoltaics under exactly this name
Prices are taken from your library settings
Quantities are updated based on K2 planning
Review all components and pricing
Click Import
Choose Import to project variant only or Import to library and project variant; the second option only appears if the bill of materials contains new components
Click Apply
If you chose Import to library and project variant, the Your components have been created successfully window lists the new components with their article number. Check their price breaks in the library, because the prices come from the current project. Clicking a component in this window opens it in a new tab.
Step 5: Understanding the Collective Position
The imported K2 bill of materials appears as a collective position named K2 Systems, with the date and time, in your project BOM.
This collective position contains all mounting system components from K2 Base. You can:
Choose whether to display sub-positions in detail on customer proposals
View individual components and quantities within the collective position
Manually adjust prices if needed
Layout Synchronization: Since K2 Base recalculates the module layout itself to comply with applicable standards (see above), the resulting module count may differ from your Expert layout—this is expected. After importing, verify that the module count still matches your expectations. If it differs, adjust your 3D layout or set the number of panels: in the panel field sidebar under Overwrite properties › Number of panels with the Enter manually switch (older sidebar: Overwrite number of panels manually). Do not change the mounting system while doing so, otherwise the K2 collective position may be removed from the bill of materials.
Why Can't I Transfer My Project?
If your project variant appears greyed out on the K2 Base page, check these common causes:
"You cannot transfer project variants that do not exclusively use K2 mounting systems"
→ Verify all module fields use K2 mounting systems only"You cannot transfer project variants without roofs and panel fields created"
→ Create a 3D layout with at least one roof and module field"You cannot transfer project variants that contain roofs that do not use the same type of K2 mounting system"
→ Ensure all module fields on each roof use the same K2 mounting system type"You cannot transfer project variants which are not using the 3D layout"
→ Create a 3D variant instead of 2D"You cannot transfer a project variant that does not have an offset value of 0%. Please update the offset value in the panel layout."
→ In the 3D Panel layout, set the offset to 0% in the sidebar of every panel field
What happens after the transfer
Transfer project data to K2 does not send any data yet. The variant is then ready to be opened in K2 Base, and the K2 Base page shows: “The project variant has been successfully transferred. To enable further transfers, import the variant using K2 Base.”
K2 Base only reads the variant when it is opened, in its state at that time. Until then, you can still change the layout. If the variant then no longer meets a condition, it is missing from the list in K2 Base; Expert does not point this out.
K2 Base can open each transfer exactly once. After that, Transfer project data to K2 is available again; reload the K2 Base page for this. For a new planning, transfer the variant again.
Do not change the project manager while the variant is ready to be opened in K2 Base: the new project manager cannot open it in K2 Base, and in Expert it stays blocked for a new transfer. In this case, enter the previous project manager again, open the variant with their K2 Base account and only change the project manager afterwards. In Expert, the bill of materials is imported by the user who transferred.
Tip: If you have transferred a variant several times, export the bill of materials from the latest planning in K2 Base. Every import replaces all previous collective positions for mounting systems in this variant, including those of another manufacturer.
Need Help?
If you encounter issues with the K2 Base integration:
Eturnity Support: Contact support@eturnity.com or via chat in the Help Center in Eturnity Expert for data transfer, authentication, or Expert interface issues
K2 Support: Contact K2 directly for K2 Base functionality, structural calculations, or component selection issues