ファイル変換AIエージェント

ファイル変換AIエージェント設定を利用すると外部システムから出力されたCSVファイルをinvox形式に自動変換できます。

1 前提条件
2 設定画面
3 操作手順
4 詳細設定
5 注意事項
6 よくある質問

前提条件

対応しているフォーマットは以下となります。
請求書データ：明細横並び（1行に複数明細の場合）
請求書データ：明細縦並び（1行に1明細の場合）
請求書でファイル変換AIエージェント設定を利用する場合はアップロード画面から設定画面へ遷移します。
請求データ（CSV）の取込をご参照ください。

設定画面

①変換後の形式、名称、メモ
②CSVファイルアップロードエリア
③変換対象の列（CSVファイルアップロード後に表示されます）
④AIへの指示（CSVファイルアップロード後に表示されます）
⑤行フィルタ
⑥変数
⑦列マッピング
⑧グルーピングキー（縦並びフォーマットのみ）
⑨「変換結果のダウンロード」ボタン

操作手順

1. 変換ルール設定画面で変換対象のCSVファイルをアップロード

ドラッグ&ドロップエリアに変換対象のCSVファイルをドロップ、またはクリックしてファイルを選択します。

2. 列マッピングを設定

CSVファイルをアップロードした後、AIを使って列マッピングを自動生成できます。

①変換対象の列を選択します。

②AIへの指示を入力します。（任意入力）
テキストエリアに、変換時の注意点や要望を500文字まで記載できます。
指示を入れなくても、列名から自動推測されます。

例）
「区分が『請求』の行のみ抽出してください」→行フィルタが設定されます。
「日付形式は YYYY-MM-DD に統一してください」→日付変換操作が設定されます。
「税区分は ‘10%’ → ‘標準税率10%’ に変換してください」→値マッピング操作が設定されます。

AIで生成されるもの
・マッピング（入力列→出力列の対応）
・行フィルタ（ユーザーの指示がある場合）
・変数（列を結合する際に使用）
・各列の操作（日付変換、数値整形など）
・グルーピングキー（空欄の扱い、同じキーの扱い）

③AIで生成ボタンをクリックします。

3. 生成結果を修正する

AIで自動生成した設定を基に列の追加、削除、並び替えを行います。
必要に応じて行フィルタ・変数・操作・グルーピングキーの設定を行います。

必須の出力列には「必須」と表示されます。
各列マッピングに対して、値の変換処理（操作）を追加できます。
操作は上から順に実行されます。

縦並びフォーマットでは列のマッピングとグルーピングキーを設定します。

横並びフォーマットでは列がヘッダー列と明細列の2種類に分かれます。
変換対象のCSVファイルにある明細数に対応した明細列を設定します。

4. 変換結果をダウンロードして確認する

CSVファイルをアップロードした状態で、「変換結果のダウンロード」ボタンをクリックして内容を確認します。

以下の観点で、期待通りに変換されているか確認します。
列の変換：変換対象のCSVファイルで入力列が指定したinvoxの出力列へ正しくマッピングされているか。
フィルタ：不要なデータが除外され、必要なデータのみがinvoxの出力列へ正しくマッピングされているか。
表示形式：日付の形式や、数値のカンマ区切りなどが正しく表示されているか。
グルーピング：設定したグルーピングキーの出力単位でヘッダーと明細が正しくひとまとまりとされているか。

6. ルールを保存する

名称を入力して保存します。

詳細設定

行フィルタ

特定の条件を満たす行のみを、変換対象として処理する機能です。不要なデータを除外し、必要な行だけを出力できます。

フィルタを追加リンクからフィルタ条件を設定します。
複数のフィルタを設定した場合はすべての条件を満たす行のみが変換対象となります。

対象列：フィルタ対象の入力CSV列を選択
演算子：条件の種類を選択（条件付きマッピングと同じ演算子が使用可能）
比較値：比較する値（「空である」「空でない」の場合は不要）

例）区分が「請求」の行のみ抽出

例）金額が10,000以上の行のみ抽出

変数

変数を操作やグルーピングキーで利用する事が可能です。
変数の名前は${var_1}, ${var_2},${var_3}と自動採番されます。

操作タイプ	参照箇所
デフォルト値	デフォルト値
値マッピング	変換後の値
条件付きマッピング	判定対象・比較値・結果
カスタム文字列	テンプレート
文字列置換	置換後の文字列
グルーピングキー	キーとして使用可能

例）部門1＋部門2で結合した文字列を部門名として生成する

変数を設定します。

カスタム文字列の操作を追加します。
設定：${value}${var_1}

${value}：参照元列 = 部門1
${var_1}：参照元列 = 部門2

入力：部門1=横浜支店　部門2=営業部
出力：横浜支店営業部

操作

操作タイプ	用途	変数参照
空白をトリム	前後の空白を削除	–
デフォルト値	空の値に初期値を設定	〇
数値を整形	カンマ除去、小数点処理、負数処理	–
値をマッピング	値を別の値に変換（対応表）	〇
日付を変換	日付フォーマットを変換	–
カスタム文字列	テンプレートで文字列生成	〇
条件付きマッピング	条件に応じて値を設定	〇
文字列分割	区切り文字で分割	–
文字列置換	文字列の一部を置換	〇

空白をトリム

文字列の前後の空白を削除します。
例）
入力:” ABC ” → 出力: “ABC”

デフォルト値

空の値にデフォルト値を設定します。値がある場合はそのまま出力されます。
例）
入力:”” → 出力: “未設定”
入力:”ABC” → 出力: “ABC”（変更なし）

数値を整形

数値文字列を整形します。（カンマ除去、括弧負数の変換など）
小数点以下桁数：丸める桁数を入力します。（空欄=元の値を保持、0=整数に丸め、N=小数点以下N桁に丸め）
マイナス値を除外：チェックすると負数は空になります。

例）
入力: “1,234,567” → 出力: “1234567”（カンマ自動除去）
入力: “(100)” → 出力: “-100″（括弧は負数として解釈）
入力: “123.456” + 小数点以下桁数=2 → 出力: “123.46”（四捨五入）

日付を変換

日付フォーマットを変換します。
「自動推測」は複数の形式に対応しますが、形式が決まっている場合は指定する事をおすすめします。
特に海外形式（月/日の順序が異なる）は自動推測で誤判定される可能性があります。

形式	例
自動推測（デフォルト）	複数形式に対応
%Y-%m-%d	2024-01-15（ハイフン区切り）
%Y/%m/%d	2024/01/15（スラッシュ区切り）
%Y.%m.%d	2024.01.15（ドット区切り）
%Y年%m月%d日	2024年01月15日（日本語形式）
%Y%m%d	20240115（区切りなし）
%d/%m/%Y	15/01/2024（イギリス式）
%m/%d/%Y	01/15/2024（アメリカ式）
%d-%b-%Y	15-Jan-2024
%d %b %Y	15 Jan 2024
%d %B %Y	15 January 2024
%B %d, %Y	January 15, 2024
%b %d, %Y	Jan 15, 2024

値をマッピング

入力値を別の値に変換する対応リストを設定します。
許容値がある出力列の場合:変換後の値はドロップダウンから選択します。
「変換元 → 変換後」のペアを複数設定します。

例）
マッピングルール:
“A” → “優良”
“B” → “普通”
“C” → “要注意”
入力: “A” → 出力: “優良”
入力: “B” → 出力: “普通”
入力: “X” → 出力: “X”（マッピングにない値はそのまま出力）

条件付きマッピング

条件に応じて異なる値を設定します。

演算子一覧

グループ	演算子	説明
論理演算子	すべて満たす (AND)	複数条件をすべて満たす
論理演算子	いずれか満たす (OR)	複数条件のいずれかを満たす
数値比較	より大きい (>)	数値として大きい
数値比較	以上 (>=)	数値として以上
数値比較	より小さい (<)	数値として小さい
数値比較	以下 (<=)	数値として以下
文字列比較	等しい	完全一致
文字列比較	等しくない	不一致
文字列比較	含む	部分文字列を含む
文字列比較	含まない	部分文字列を含まない
文字列比較	で始まる	指定文字列で始まる
文字列比較	で終わる	指定文字列で終わる
文字列比較	空である	空文字列である
文字列比較	空でない	空文字列でない