Introduction
To onboard your BESS into the TWAICE platform, we require a set of technical documents that describe your system’s hierarchy, configuration, and data structures.
These documents will be used to accurately build your system in the TWAICE data model, configure analytics, and ensure reliable monitoring from day one.
🧾 Onboarding Documents
Documents should be provided for each asset that will be onboarded to TWAICE.
Importance | Document |
Required | Electrical Single-Line Diagram (SLD) |
Required | BESS Product Manual OR Rack Datasheet |
Required | Tag List / Modbus Map |
Required | BESS Onboarding Questionnaire |
Highly Recommended | Site Layout |
Recommended | Cell Datasheet |
Recommended | Rack Operation Manual |
Recommended | PCS Datasheet |
Recommended | PCS Operation Manual |
Recommended | Equipment Alarm Setpoints |
Recommended | Warranty Contracts /LTSAs |
✅ Required Documents
The following documents are required for us to set up your system correctly in TWAICE.
1. Electrical Single Line Diagram (SLD)
An electrical one-line diagram showing the topology of your system (how components in your system are electrically connected). Used to define the system hierarchy in the TWAICE data model.
What to look for:
Site-level and block-level diagrams (may span multiple files))
Shows components like BESS containers, PCS/inverters, transformers, meters, switchgear
Typically created by the EPC or system integrator
2. BESS Product Manual / Rack Datasheet
OEM or integrator documentation describing the full battery system architecture. Typically provides information on the DC-side of the system. Used by TWAICE to configure the hierarchy and parameterize the DC portion of the system.
👉🏻 Note: For AC-block systems, the product manual often covers the AC side as well.
What to look for:
System architecture from the enclosure level down to the cell level
Includes electrical specifications (nominal voltages and capacities, voltage and current limits, string/rack/module configuration)
May be distributed across multiple documents
Common names: Battery System Specification, Technical Datasheet, Rack Datasheet
3. Tag List
A complete list defining all tags that can be exposed to TWAICE. Used to configure data ingestion and tag mapping in TWAICE.
What to look for:
Table with signal names, descriptions, register addresses, data types, and engineering units
Covers BMS, PCS, and other levels
May be provided by your data historian / data provider
👉🏻 Note: In addition to the tag list, the Modbus map is highly recommended if it is available. This tells us which tags could be made available in the future.
Common names: Points List, Modbus Map, Register Map, Signal Map, Interface Specification
4. BESS Onboarding Questionnaire
Please complete and return the TWAICE BESS Onboarding Questionnaire. The questionnaire collects the system metadata TWAICE needs to configure the platform and set the correct reference values for KPI calculations and ensure all insights on the platform can be accurately interpreted.
⬇️ Please find the BESS Onboarding Questionnaire document for download at the bottom of the page!
👉🏻 Note: Completing the questionnaire in as much detail as possible in the course of the onboarding process significantly speeds up the setup process.
⭐ Recommended Documents
Providing the following documents is not mandatory, but strongly improves setup quality and reduces back-and-forth during onboarding.
1. Site Layout Drawings (Highly Recommended)
General Arrangement (GA) or layout drawing showing the physical placement of equipment (containers, PCS, substation, etc.) on site. Provides spatial context for system configuration.
2. Rack Operation Manual
OEM documentation describing rack-level operation, fault handling, and error code definitions. Used to validate alert configurations and deepen understanding of rack-level component behavior.
3. Cell Datasheet
OEM cell-level specification including electrochemical parameters, voltage windows, capacity, maximum current, and other operating limits. Used to validate cell-level configuration in TWAICE, which improves accuracy of TWAICE KPIs. If unavailable, BESS-level documentation will be used as a fallback.
4. PCS Datasheet
Inverter/PCS technical specification covering power rating, AC/DC voltage ranges, and efficiency curves. Used to confirm system operating limits and PCS configuration.
5. PCS Operation Manual
OEM or integrator documentation covering PCS operating procedures, fault codes, and protection logic. Used to confirm alert mappings and support interpretation of PCS-level events.
6. Equipment Alarm Setpoints
Configured alarm threshold table for your system, including warning and trip levels with corresponding engineering units. Used to configure Smart Alerts in TWAICE against your actual system setpoints.
7. Warranty Contracts / LTSA Documentation
Contractual documentation defining operational parameters and equipment constraints, including rated MW/MWh, availability and cycle commitments, and site identifiers. Used to align the TWAICE Warranty module configuration with contractual boundaries.
👉🏻 Questions? If you’re unsure whether a document is suitable, feel free to share it with your TWAICE contact—we’re happy to help review it.