# FINCS_RPTDFINDATABULKIN

**SOAP v1.0.0 — ACTIVE**

## Title / 标题
**Reported Financial Data for Group Reporting – Bulk Import and Update / 集团报告财务数据 – 批量导入和更新**

## Operation / 操作
`ReportedFinancialDataBulkImport`

---

## Description / 描述
Import the reported financial data using this asynchronous inbound service.

使用此异步入站服务导入报告的财务数据。

---

## Endpoint / 端点
| Environment | URL |
|-------------|-----|
| Production | `https://sap.example.com/sap/bc/srt/rfc/sap/FINCS_RPTDFINDATABULKIN` |
| Test | `https://sap-test.example.com/sap/bc/srt/rfc/sap/FINCS_RPTDFINDATABULKIN` |

## Message Structure / 消息结构

### Request / 请求
| Element | Type | Description (EN) | Description (CN) |
|---------|------|------------------|------------------|
| `ReportedFinancialData` | Table | Reported financial data items | 报告的财务数据项 |
| `?ReportingEntity` | `CHAR(32)` | Reporting entity (company code) | 报告实体（公司代码） |
| `?FiscalYear` | `CHAR(4)` | Fiscal year | 会计年度 |
| `?FiscalPeriod` | `CHAR(2)` | Fiscal period | 会计期间 |
| `?FinancialStatementItem` | `CHAR(24)` | Financial statement item | 财务报表项目 |
| `?Amount` | `DECIMAL` | Amount in reporting currency | 报告货币金额 |
| `?Currency` | `CUKY(5)` | Reporting currency | 报告货币 |
| `?UnitOfMeasure` | `UNIT` | Unit of measure for quantity | 数量计量单位 |
| `?Quantity` | `DECIMAL` | Quantity value | 数量值 |
| `DataSource` | `CHAR(10)` | Data source identifier | 数据源标识符 |
| `GroupChartOfAccounts` | `CHAR(2)` | Group chart of accounts | 集团科目表 |

### Response / 响应
| Element | Type | Description (EN) | Description (CN) |
|---------|------|------------------|------------------|
| `Return` | `BAPIRETURN` | Application log message | 应用程序日志消息 |
| `?Type` | `CHAR(1)` | Message type (S/E/W/I) | 消息类型（成功/错误/警告/信息） |
| `?Message` | `CHAR(220)` | Message text | 消息文本 |
| `BatchID` | `CHAR(20)` | Import batch identifier | 导入批次标识 |

---

## Example Payload / 示例负载

### Request
```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ReportedFinancialDataBulkImport>
      <GroupChartOfAccounts>CA</GroupChartOfAccounts>
      <DataSource>EXTERNAL</DataSource>
      <ReportedFinancialData>
        <item>
          <ReportingEntity>1000</ReportingEntity>
          <FiscalYear>2026</FiscalYear>
          <FiscalPeriod>07</FiscalPeriod>
          <FinancialStatementItem>REVENUE</FinancialStatementItem>
          <Amount>1500000.00</Amount>
          <Currency>CNY</Currency>
        </item>
        <item>
          <ReportingEntity>1000</ReportingEntity>
          <FiscalYear>2026</FiscalYear>
          <FiscalPeriod>07</FiscalPeriod>
          <FinancialStatementItem>COGS</FinancialStatementItem>
          <Amount>950000.00</Amount>
          <Currency>CNY</Currency>
        </item>
      </ReportedFinancialData>
    </ReportedFinancialDataBulkImport>
  </soap:Body>
</soap:Envelope>
```

### Response
```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ReportedFinancialDataBulkImportResponse>
      <Return>
        <Type>S</Type>
        <Message>Data imported successfully / 数据导入成功</Message>
      </Return>
      <BatchID>BATCH-20260723-001</BatchID>
    </ReportedFinancialDataBulkImportResponse>
  </soap:Body>
</soap:Envelope>
```

---

## Error Codes / 错误代码
| Code | Description (EN) | Description (CN) |
|------|------------------|------------------|
| `FIN_001` | Invalid reporting entity | 无效的报告实体 |
| `FIN_002` | Financial statement item not found in group COA | 集团科目表中未找到财务报表项目 |
| `FIN_003` | Fiscal period not open | 会计期间未打开 |
| `FIN_004` | Duplicate data record | 重复的数据记录 |
| `FIN_005` | Currency mismatch | 货币不匹配 |

---

## Notes / 备注
- This is an asynchronous service; processing results are returned via a separate response / 这是一项异步服务；处理结果通过单独的响应返回
- Maximum 10,000 data records per batch / 每批最多10,000条数据记录
- The group chart of accounts must be defined in the target system / 集团科目表必须在目标系统中定义
