> For the complete documentation index, see [llms.txt](https://docs.alphaus.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.alphaus.cloud/api-reference/ripple/export.md).

# Export

CSV出力に関するAPIリファレンスは以下の通りです。

## Get invoice csv(account)

請求書CSV(account)の出力

**Role actions**

* `ReadInvoice`
* `ModifyInvoice`

**Request**

```http
POST /export/csv/invoice_account/{month} HTTP1.1
Authorization: Bearer {token}
```

リクエストパラーメータの`{month}`のフォーマット: `yyyy-mm` 例: 2020-01

**Response**

```ruby
HTTP 200

{
  "status":"success",
  "url":"csv link"
}
```

CSVの内容

| Field                    | Description |
| ------------------------ | ----------- |
| BillingGroupID           | 請求グループID    |
| BillingGroupName         | 請求グループ名     |
| CompanyName              | 会社名         |
| Vendor                   | ベンダー        |
| CustomerID               | 顧客ID        |
| CustomerName             | 顧客名         |
| ServiceType              | サービスタイプ     |
| ServiceName              | サービス名       |
| Charge                   | 金額          |
| DiscountCharge           | 割引後額        |
| DiscountCharge - TaxFree | 割引後額 - 免税金額 |
| FreeFormat               | フリーフォーマット金額 |
| CustomService            | 請求サービス金額    |
| Tax                      | 消費税         |
| Total                    | 振込金額        |

## Get invoice csv(tag)

請求書CSV(tag)の出力

**Role actions**

* `ReadInvoice`
* `ModifyInvoice`

**Request**

```http
POST /export/csv/invoice_tag/{month} HTTP1.1
Authorization: Bearer {token}
```

リクエストパラーメータの`{month}`のフォーマット: `yyyy-mm` 例: 2020-01

**Response**

```ruby
HTTP 200

{
  "status":"success",
  "url":"csv link"
}
```

CSVの内容

| Field                    | Description |
| ------------------------ | ----------- |
| BillingGroupID           | 請求グループID    |
| BillingGroupName         | 請求グループ名     |
| CompanyName              | 会社名         |
| Vendor                   | ベンダー        |
| Tag                      | タグ詳細        |
| ServiceType              | サービスタイプ     |
| ServiceName              | サービス名       |
| Charge                   | 金額          |
| DiscountCharge           | 割引後額        |
| DiscountCharge - TaxFree | 割引後額 - 免税金額 |
| FreeFormat               | フリーフォーマット金額 |
| CustomService            | 請求サービス金額    |
| Tax                      | 消費税         |
| Total                    | 振込金額        |

## Get billing group csv

請求グループCSVの出力

**Role actions**

* `ReadBillingGroup`
* `ModifyBillingGroup`

**Request**

```http
POST /exportcsv/billing-group HTTP1.1
Authorization: Bearer {token}
Content-Type: application/json

{request body}
```

以下に`{request body}`のリクエストペイロードの例を示します。

**{request body}**

```ruby
{
  "redo":false
}
```

| Field | Type      | Required | Validation | Description                                               |
| ----- | --------- | -------- | ---------- | --------------------------------------------------------- |
| redo  | *boolean* | Yes      | -          | true:作成済みののCSVを出力。CSVがない場合はCSVを生成する。 false:新しいCSVを生成して出力。 |

**Response**

```ruby
HTTP 200

{
  "status":"success",
  "path":"csv link"
}
```

CSVの内容

| Field     | Description |
| --------- | ----------- |
| 請求グループID  | -           |
| 請求グループ名   | -           |
| 企業名       | -           |
| 郵便番号      | -           |
| 住所        | -           |
| 電話番号      | -           |
| 宛名        | -           |
| 請求書タイトル   | -           |
| コスト       | -           |
| カスタムフィールド | -           |

## Get billing group setting csv

請求グループ設定CSVの出力

**Role actions**

* `ReadBillingGroup`
* `ModifyBillingGroup`

**Request**

```http
POST /exportcsv/billing-group-setting HTTP1.1
Authorization: Bearer {token}
Content-Type: application/json

{request body}
```

以下に`{request body}`のリクエストペイロードの例を示します。

**{request body}**

```ruby
{
  "redo":false
}
```

| Field | Type      | Required | Validation | Description                                               |
| ----- | --------- | -------- | ---------- | --------------------------------------------------------- |
| redo  | *boolean* | Yes      | -          | true:作成済みののCSVを出力。CSVがない場合はCSVを生成する。 false:新しいCSVを生成して出力。 |

**Response**

```ruby
HTTP 200

{
  "status":"success",
  "path":"csv link"
}
```

CSVの内容

| Field           | Description |
| --------------- | ----------- |
| 請求グループID        | -           |
| 請求グループ名         | -           |
| ベンダー            | -           |
| 値引率             | -           |
| 消費税             | -           |
| AWSサポート請求方法     | -           |
| AWSサポート（一律%の場合） | -           |
| AWSサポート（固定）     | -           |
| 代行手数料請求方法       | -           |
| 代行手数料（％）        | -           |
| 代行手数料（固定）       | -           |
| 集計タイプ           | -           |
| 値引き対象           | -           |
| 請求代行サービス計算対象    | -           |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.alphaus.cloud/api-reference/ripple/export.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.