> ## 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 中參照該 URL，或交給你的客戶經理。

在商業生命週期中有兩個時刻會用到文件：

| 情況                               | 要做什麼                                                                                      |
| -------------------------------- | ----------------------------------------------------------------------------------------- |
| 註冊 **個人獨資（sole proprietorship）** | 在呼叫 `registerBusiness` 之前先上傳文件，然後將回傳的 URL 傳入 `soleProprietorshipDocumentUrl`。若未提供將導致註冊失敗。 |
| KYB 審查要求 **補充文件**                | 帳戶會保持在 `PENDING`。上傳所要求的檔案，並將這些 URL 與 `accountId` 一併提供給你的客戶經理。                             |

<Note>
  LLC、股份公司、合夥企業與合作社在註冊時**不**需要上傳任何文件。Fluz 會根據於 [registerBusiness](/business-registration) 提交的資料來驗證這些實體。只有在自動檢核未通過時才會要求提供文件。
</Note>

***

## 上傳端點

| 屬性   | 值                                                  |
| ---- | -------------------------------------------------- |
| 方法   | `POST`                                             |
| 路徑   | `/api/v1/file-upload/sole-proprietorship-document` |
| 內容型態 | `multipart/form-data`                              |
| 表單欄位 | `file`                                             |
| 驗證   | OAuth Bearer Token                                 |

Staging 基底 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. 在你的介面中將帳戶維持在「審查中」狀態。不要重新提交 `registerBusiness`——第二個申請會被 `BS-0007` 阻擋，而重複個案會拖慢審查。
2. 上傳所要求的檔案，並將這些 URL 連同 `accountId` 一併提供給你的客戶經理。
3. 以低頻率輪詢商業帳戶狀態，當其變更為核准或拒絕時更新你的介面。請參閱 [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>
