> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 提交企业文件

> 为企业账户上传支持性文件——个体工商户在注册时，或当 KYB 审核要求提供更多信息时。

## 概览

企业文件通过一个**REST 文件上传端点**提交，而不是通过 GraphQL API。该端点存储文件并返回一个 URL，之后你可在 GraphQL mutation 中引用，或交给你的客户经理。

在企业生命周期中，有两个时间点会用到文件：

| 情况               | 需要做什么                                                                                   |
| ---------------- | --------------------------------------------------------------------------------------- |
| 注册**个体工商户**      | 在调用 `registerBusiness` 之前先上传文件，然后将返回的 URL 传入 `soleProprietorshipDocumentUrl`。没有它，注册会失败。 |
| KYB 审核要求**补充材料** | 账户保持在 `PENDING` 状态。上传所需文件，并将这些 URL 连同 `accountId` 一并提供给你的客户经理。                          |

<Note>
  LLC、公司、合伙企业和合作社在注册时**不**需要上传任何文件。Fluz 会根据在 [registerBusiness](/business-registration) 中提交的数据来核验这些实体。只有当自动检查未通过时，才会请求文件。
</Note>

***

## 上传端点

| 属性             | 值                                                  |
| -------------- | -------------------------------------------------- |
| Method         | `POST`                                             |
| Path           | `/api/v1/file-upload/sole-proprietorship-document` |
| Content type   | `multipart/form-data`                              |
| Form field     | `file`                                             |
| Authentication | OAuth Bearer Token                                 |

Staging base URL: `https://transactional-graph.staging.fluzapp.com`

```bash theme={null}
curl -X POST https://transactional-graph.staging.fluzapp.com/api/v1/file-upload/sole-proprietorship-document \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -F "file=@/path/to/document.pdf"
```

该端点会返回一个 URL。保存它，并直接传给 `registerBusiness`：

```json theme={null}
{
  "input": {
    "businessName": "Jane Doe Design",
    "businessStructure": "SOLE_PROPRIETORSHIP",
    "soleProprietorshipDocumentUrl": "<URL RETURNED BY THE UPLOAD ENDPOINT>",
    "...": "..."
  }
}
```

<Warning>
  先上传，再注册。无法向已提交的注册附加文件——如果你提交的个体工商户未包含 `soleProprietorshipDocumentUrl`，该 mutation 将被拒绝，且在第一个申请关闭之前，用户无法开始第二个申请（`BS-0007`）。
</Warning>

<Info>
  **文件要求**——可接受的格式、最大文件大小和页数限制：在构建客户端校验之前，请与你的客户经理确认当前限制。
</Info>

***

## 个体工商户文件

由于个体工商户不是单独登记的法律实体，文件需要证明两点：商号存在，以及业主是其背后个人。

通常可满足要求的文件：

* **虚构商号/DBA 备案**——在县或州对商号的备案
* **营业执照**——由市、县或州签发给业主
* **IRS EIN 分配函**（CP 575 或 147C）——当个体工商户拥有自己的 EIN 时

实务指南：

* 文件上的名称应与您提交的 `businessName` 一致。不匹配是个体工商户审核停滞的最常见原因。
* 提交完整、清晰可读的整份扫描件或 PDF，而不是仅截取一行的裁剪截图。
* 过期的执照与备案不被接受——文件应为当前有效。

## KYB 审核期间的补充材料

如果 Fluz 合规需要超出注册负载所提供的信息，KYB 案件将在提出请求期间保持 `PENDING`，并通过你的客户经理进行沟通。常见的请求项包括：

* 成立文件（组织章程或公司章程、运营协议、合伙协议）
* 企业地址证明
* 实益所有人或控权人的政府签发身份证件
* 对业务性质的说明或补充细节，当 `natureOfBusiness` 留空或过于笼统时

你需要做的：

1. 在你的 UI 中将账户保持为“审核中”状态。不要重新提交 `registerBusiness`——第二个申请会被 `BS-0007` 阻止，且重复案件会拖慢审核。
2. 上传所需文件，并将这些 URL 加上 `accountId` 一并发送给你的客户经理。
3. 以低频率轮询企业账户状态，并在其变更为批准或拒绝时更新你的 UI。参见 [KYB 状态生命周期](/business-registration#kyb-status-lifecycle)。

<Note>
  在注册时提交完整的实益所有权信息，是避免被要求补充文件的最有效方式。参见[实益所有权要求](/business-registration#beneficial-ownership-requirements)。
</Note>

## 相关页面

<CardGroup cols={2}>
  <Card title="注册与验证企业" href="/business-registration">
    `registerBusiness` mutation、参数与错误代码。
  </Card>

  <Card title="业务类别" href="/business-categories">
    获取注册所需的类别与子类别 ID。
  </Card>

  <Card title="用户 KYC 验证" href="/user-kyc-verification">
    对企业背后个人所有者的身份验证。
  </Card>

  <Card title="Staging 与生产环境" href="/concepts/environments">
    各环境下上传端点的基址 URL。
  </Card>
</CardGroup>