> ## 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.

# 申請報銷核准

`requestReimbursement`

提交管理者核准請求，透過在同一帳戶內的消費帳戶間移轉資金來報銷使用者。獲得核准後，Fluz 會處理報銷。

## Scopes

| Action | Scope                   |
| ------ | ----------------------- |
| 建立請求   | `REQUEST_REIMBURSEMENT` |
| 列出請求   | `LIST_APPROVALS`        |
| 核准或拒絕  | `MANAGE_APPROVALS`      |

## Webhook 識別碼

| Field          | Value    |
| -------------- | -------- |
| `approvalType` | `PAYOUT` |
| `approvalCode` | `500401` |

Webhook 事件：`APPROVAL_CREATE`、`APPROVAL_APPROVE`、`APPROVAL_DECLINE`，以及執行失敗時的 `APPROVAL_HANDLER_ERROR`。

## 建立請求

### RequestReimbursementInput

| Field                          | Type   | Required | Description         |
| ------------------------------ | ------ | -------- | ------------------- |
| `amount`                       | Float  | Yes      | 報銷金額。必須大於零          |
| `sourceUserCashBalanceId`      | UUID   | Yes      | 提款的消費帳戶（通常為公司或共享餘額） |
| `destinationUserCashBalanceId` | UUID   | Yes      | 入帳的消費帳戶（通常為申請者的餘額）  |
| `memo`                         | String | No       | 交易備註                |
| `categoryId`                   | UUID   | No       | 交易分類 ID             |

來源與目的地必須為不同的消費帳戶。

### 範例 Mutation

```graphql theme={null}
mutation {
  requestReimbursement(
    input: {
      amount: 75.00
      sourceUserCashBalanceId: "6d1b4b19-deef-42f5-80d7-ec34804ce090"
      destinationUserCashBalanceId: "bb584e49-d030-4a6e-a5a9-1c34368cbaed"
      memo: "Client dinner reimbursement"
    }
  ) {
    success
    messageId
    error {
      code
      message
    }
  }
}
```

### 範例回應

```json theme={null}
{
  "data": {
    "requestReimbursement": {
      "success": true,
      "messageId": "1234567890"
    }
  }
}
```

## 核准請求

使用 `approveApprovalRequest` 並提供 `approvalId`。需要 `MANAGE_APPROVALS`。

```graphql theme={null}
mutation {
  approveApprovalRequest(approvalId: "07df5653-43a8-4532-9881-3ab5857bbe12") {
    success
    approvalId
    action
  }
}
```

核准後，Fluz 會處理報銷轉帳。

## 拒絕請求

使用 `declineApprovalRequest` 並提供 `approvalId`。需要 `MANAGE_APPROVALS`。

```graphql theme={null}
mutation {
  declineApprovalRequest(approvalId: "07df5653-43a8-4532-9881-3ab5857bbe12") {
    success
    approvalId
    action
  }
}
```

當請求被拒絕時，不會處理任何報銷。