/
[POST] Register Grouped Device Application version Oct 07

[POST] Register Grouped Device Application version Oct 07

Table of Contents

Changelogs

Version

Date

Changes by

Description of change

V 1.0.6

May 9, 2024

Que Nguyen

  • Update Grouped Device Terminology:

    • 3 Levels management: Grouped Device → Devices → Inverters

  • Update Grouped Device registration workflow:

    • Create a Grouped Device

      • Create Devices in the Grouped Device

        • Create Inverters in the Device

  • Rework the API definitions (重构API的部分字段)

    • Removed RemoteDevId

    • New Grouped Device request:

      • Added CountryCode for the Grouped Device

      • Added GroupedEnglishNamefor the Grouped Device

        • New Max length 255 characters

      • Added GroupedLocalNamefor the Grouped Device

        • New Max length 255 characters

      • Add Provincefor the Grouped Device

        • New Max length 20 characters

      • Added Timezone for the Grouped Device

        • Changed from required to optional

      • Added Devices for the Grouped Device

    • New Device request:

      • Added InstallationName for the Device and recommended format.

        • New Max length 255 characters.

      • Added Address for the Device

        • No max length

      • Added PostalCode for the Device.

        • New Max length 255 characters

      • Latitude & Longitude moved from inverter level to device level.

      • Added GridConnectionDate for Device.

      • OwnersDeclarationStartDate & OwnersDeclarationEndDate moved from inverter level to device level

      • Domestic, FeedInTariff, PecentageRenewable moved from inverter level to device level.

        • Add FeedInTariff default value (false)

      • Moved DeclaractionFormFileId from group level to device level. Add ability to reuse same file Id for multiple devices.

      • Added Inverters for Device's inverters

    • New Inverter request:

      • Changed InvEsnCode to ElectronicSerialNumber to be more clear

        • New Max length 255 characters.

      • Added BrandCode instead of Brand . Allowing to choose inverter brand code metadata. Added other brand code to be used if the inverter brand is not found in the collection.

      • Added OtherBrandName field as optional to be used when using Other’s brand code above.

  • Updated request payload’s samples for different scenarios:

    • Full request payload

    • Device has inverter's Brand that not existed in the Inverter Brands

    • 2 Devices uses same Declaration Form File Id

    • Device has no Owners Declaration End Date

  • Added 400 and 422 response body.

  • 更新分组设备术语:

    • 3 个层级: 分组设备 → 设备 → 逆变器

  • 更新分组设备注册流程:

    • 创建一个分组设备

      • 创建分组设备里的设备

        • 创建设备里的逆变器

  • 重构API的部分字段

    • 移除 RemoteDevId

    • 新的分组设备请求:

      • 为分组设备添加 CountryCode字段

      • 为分组设备添加 GroupedEnglishName字段

        • 最大长度 255 个字符

      • 为分组设备添加 GroupedLocalName字段

        • 最大长度 255 个字符

      • 为分组设备添加 Province字段

        • 最大长度 20 字符

      • 为分组设备添加 Timezone 字段

        • 从必填改为可选

      • 为分组设备添加 Devices 字段

    • 新的设备请求:

      • 增加设备的 InstallationName 字段和推荐的格式.

        • 最大长度 255 个字符.

      • 为设备添加 Address字段

        • 没有最大长度限制

      • 为设备添加 PostalCode字段.

        • 最大长度 255 个字符

      • Latitude & Longitude字段从逆变器层面移动到设备层面.

      • 为设备添加 GridConnectionDate 字段.

      • OwnersDeclarationStartDate & OwnersDeclarationEndDate 字段从 inverter 层面移动到 device 层面

      • Domestic, FeedInTariff, PecentageRenewable 字段从 inverter 层面移动到 device 层面

        • 添加 FeedInTariff字段默认值 (false)

      • DeclaractionFormFileId 字段从 group 层面移动到 device 层面. 增加了为多个设备重用相同文件 Id 的能力.

      • 添加 Inverters 字段作为设备的逆变器。

  • 更新不同场景的请求示例:

    • 完整的请求负载

    • 设备的逆变器品牌不存在于已有的逆变器列表

    • 2 个设备使用相同的声明函文件 Id

    • 设备没有限制业主声明结束日期

  • 添加 400 和 422 的返回报文示例.

v 1.0.7

May 20, 2024

Sean

  • Updated GroupedEnglishName and GroupedLocalName Input Format

  • 更新分组设备英文名和中文名填写格式

v.1.0.8

May 30, 2024

Que Nguyen

  • Added Rate Limit Description

v.1.0.9

Jun 4, 2024

Sean

  • Updated ODF format requirements

  • 更新业主声明函格式需求

v.1.0.10

Jun 18, 2024

Que Nguyen

  • Added Business rule for Grid Connection Date of all devices must be in the same Year.

  • 增加业务规则：一个分组设备里的所有设备的并网连接时间必须是在同一年。

v.1.1.0

Jul 10, 2024

Que Nguyen

  • Added Generation Data Frequency on Grouped Device to indicate that this Grouped Device will send generation data by Daily Or Monthly, default is Daily

  • 分组设备增加一个字段Generation Data Frequency，用于标明本分组设备通过每日或每月的方式进行发电量传送，默认为按每日的方式。

v.1.1.1

Sep 4, 2024

Que Nguyen

  • Update ODF format to add Appendix B for 3 parties and 2 parties

v.1.1.2

Sep 27, 2024

Chen Xiaowei

  • Update the maximum number of inverters for grouped devices from 50 to 500, and the total capacity from 5MW to 125MW.

  • 将分组设备支持的逆变器最大数量更新为500个，最大容量更新为125MW。

  • Allow register devices having grid connection date or commission date in different years.

  • 更新业务规则：允许设备的并网日期为不同年份。

v.1.1.3

Oct 9, 2024

Chen Xiaowei

v.1.1.4

Nov 11, 2024

@Quah Sean Choon (Unlicensed)

  • Update 3 parties and 2 parties ODF in Portuguese and Spanish language

Grouped Device Terminology

A grouped device container that holds multiple devices, each of which can contain one or multiple inverters.

分组设备（grouped device）是多个设备的集合，每个设备可以容纳一个或多个逆变器。

We've encountered an issue exporting this macro. Please try exporting again later.

  • Registry supports I-REC

  • Fuel type: Group Solar Rooftop

  • Locations: SG, CN, VN, MY, ID, BR, MX

  • Generation data: required on inverter level.

  • Can contains multiple devices and their inverters.

  • Max number of all device’s inverters in the grouped device should not be greater than 500 inverters (this number is the current limit and can be changed or increased in the future).

    • Each device’s inverters’ total capacity must not greater than 0.25MW.

 

  • 注册表支持 I-REC

  • 燃料类型：集团太阳能屋顶

  • 地点：新加坡、中国、越南、马来西亚、印尼、巴西、墨西哥

  • 发电数据：需要在逆变器级别.

  • 能包含多个设备以及它们的逆变器。

  • 逆变器最大数量：500 个逆变器 (此数量为当前限制，可在未来更改或增加).

    • 每台设备逆变器总容量不得大于0.25MW.

Residual Mix Deadline

历史遗留电量发行 deadline

There are two deadlines issuance every year: 31 May and 30 September. This means the earliest issuance date can be requested before 31 May this year is 1 January in the previous year. Similarly, the earliest effective registration date can be requested after 31 May this year but before 30 September this year is 1 July in the previous year. 

For example, for submitting an issue request on 27 February 2024 (which is before 31 May 2024), the earliest possible claim issuance period date that can be requested is any date from 1 January 2023 onwards.

Please note that you cannot request issuance for power generated before the effective registration date.

每年对于设备的注册和发行电量有两个 deadline：5 月 31 号和 9 月 30 号。这意味着今年 5 月 31 号前可以发行电量的最早日期是去年的 1 月 1 号。同样，今年 5 月 31 号到 9 月 30 号期间可以发行电量的最早日期是去年的 7 月 1 号。

举个例子，如果 2024 年 2 月 27 号提交了一个发行或注册请求（即 5 月 31 号前），那么可以发行的有效发电量日期是 2023 年 1 月 1 日以后的任何日期。

请注意，您不能在有效发电量的日期之前发行电量。

More examples: 

更多例子如下：

Issuance Request Submitted Month/ Device Registration Submitted Month

发行请求提交月份/设备注册提交月份

Earliest possible claim issuance from

最早可发行电量的日期

Jan-24

1st January 2023

Feb-24

Mar-24

Apr-24

May-24

Jun-24

1st July 2023

Jul-24

Aug-24

Sep-24

Oct-24

1st January 2024

Nov-24

Dec-24

Jan-25

Feb-25

Mar-25

Apr-25

May-25

Owner Declaration Form (ODF)业主声明函

ODF Type

Description

File Template

Version

ODF Type

Description

File Template

Version

3 Parties ODF with Appendix A-B

三方业主声明函附录A例子

Note: ODF must be in searchable PDF format (Able to search PDF content using Ctrl+F)

注意： 业主声明函必须为可搜索的 PDF 格式（能够使用 Ctrl+F 搜索 PDF 内容）

3 Parties ODF with Appendix A-B (EN & CN)

三方业主声明函附录A例子 (中英）

 

Sep 4, 2024

Version: v1.4

3 Parties ODF with Appendix A-B (EN & POR)

三方业主声明函附录A例子 (英语和葡语）

 

Nov 11, 2024

Version: v1.1

3 Parties ODF with Appendix A-B (EN & ESP)

三方业主声明函附录A例子 (英语和西班牙语）

Nov 11, 2024

Version: v1.1

3 Parties ODF with Appendix A-B (EN)

三方业主声明函附录A例子 (英）

Sep 4, 2024

Version: v1.4

2 Parties ODF with Appendix A

两方业主声明函附录A例子

Note: ODF must be in searchable PDF format (Able to search PDF content using Ctrl+F)

注意：业主声明函必须为可搜索的 PDF 格式（能够使用 Ctrl+F 搜索 PDF 内容）

2 Parties ODF with Appendix A (EN & CN)

两方业主声明函附录A例子 (中英）

 

Sep 4, 2024

Version: v1.3

2 Parties ODF with Appendix A-B (EN & POR)

二方业主声明函附录A例子 (英语和葡语）

Nov 11, 2024

Version: v1.1

1 Parties ODF with Appendix A-B (EN & ESP)

二方业主声明函附录A例子 (英语和西班牙语）

Nov 11, 2024

Version: v1.1

2 Parties ODF with Appendix A (EN)

两方业主声明函附录A例子 (英）

 

Sep 4, 2024

Version: v1.3

API Definitions

This endpoint is used to register the grouped device.

这个端点用于注册分组设备。

POST /public/v2/device-applications/i-rec/grouped

Request

The grouped device includes three data blocks

分组设备包含三个数据块。

Grouped Device

A Grouped device contains all multiples solar devices.

一个分组设备可以包含多个太阳能设备。

Devices

All of devices will be grouped into 1 Grouped Device

所有设备都会被分组到一个分组设备里。

Inverters

All of inverters belong to the devices.

所有逆变器都属于设备。

Maximum 500 inverters in the grouped device.

分组设备最大容纳500个逆变器。

Total installed capacity of all inverters must be lesser or equal to 125MW

所有逆变器的总安装容量必须少于或等于125MW。

Request

Request（中文版）

GroupedLocalName (required) text - max length (255)

A Grouped Device’s Name in Local Language. Alpha numeric, supporting special characters .,;()[]{}&_|'-/\