スキーマとエクスポートのレイアウト

出力を選ぶ

JSON

JSONは明細や取引のリストなど、入れ子になった文書データを保持します。ダウンロードされるのは文書オブジェクトそのもので、利用上限やファイル転送のメタデータは含みません。フラット設定はJSONに影響しません。

フラット

フラット出力は、行と一貫した列で構成される長方形の表です。各行は1つの明細項目や取引を表し、必要に応じて文書情報を繰り返します。各表は固有の固定列構造を持ちます。Excelには複数のシートが含まれる場合があり、CSVには1つの表が含まれます。

非フラット

非フラットのExcelとCSVでは、文書情報、明細、税金、合計、警告など、目的と列構成が異なる表を横に並べます。全体が同じ構造の1つのデータ表になるわけではありません。Wordでは縦に配置します。給与明細書と表の画像には専用レイアウトを使用します。

会計用CSVは専用テンプレートを使うPremiumの出力オプションです。XeroやQuickBooksへの直接接続ではなく、ダウンロード用ファイルを作成します。インポート前にフィールドと勘定科目の対応を確認してください。 料金プラン

領収書

販売者、日付、通貨、領収書番号、明細ごとの数量と価格、税金、支払方法、合計です。税率は小数で表し、0.20は20%を意味します。

JSONフィールド

型はシリアライズ後のJSONを表します。親オブジェクトと配列を子フィールドより先に表示し、[]は繰り返し項目を示します。既定値のあるフィールドは抽出時に指定しなくても構いません。Decimal値は文字列としてシリアライズされます。ダウンロードにも既定値のあるフィールドが残ります。値が抽出されないこととJSONキー自体の省略は異なります。

フラット

フラットなExcelには明細行と別の文書要約が含まれます。CSVには明細行のみ含まれます。税金とチップの調整により行が追加される場合があり、そのline_totalはtax、taxes[].amount、tipのいずれかを使用します。descriptionは生成され、quantity、unit_price、line_noは空白になります。

非フラット

非フラットでは以下の表を横に配置します。文書情報と合計はフィールドと値の行を使い、明細と税金は列を使います。警告は存在する場合のみ表示します。非フラットの明細表にはunit_priceを含みません。

Xero CSV

領収書ごとに1つの要約行を作成します。下記に参照元がないフィールドはAccountCodeとTaxTypeも含めて空白で出力します。インポート前に必要な対応付けを補ってください。

tax_inclusiveがtrueなら、UnitAmountはtotalを使い、なければsubtotalを使います。それ以外はsubtotalを使い、subtotalがなければtotalからtaxを引きます。金額がない場合は0を使用することがあります。その後、tipを加えます。インポート前に税金とチップの扱いを確認してください。

QuickBooks CSV

非対応

請求書

請求書の日付と参照情報、発行者と受領者の情報、明細項目、税金、割引、源泉徴収額、合計です。unitは文書に印字された単位、tax_rateは小数で表した税率です。

JSONフィールド

型はシリアライズ後のJSONを表します。親オブジェクトと配列を子フィールドより先に表示し、[]は繰り返し項目を示します。既定値のあるフィールドは抽出時に指定しなくても構いません。Decimal値は文字列としてシリアライズされます。ダウンロードにも既定値のあるフィールドが残ります。値が抽出されないこととJSONキー自体の省略は異なります。

各表は出力フィールドとJSONパスの対応を示します。||は最初の空でない値、??はnullの場合の代替値を意味します。番号付け、摘要の結合、書式は出力ルールです。欠損値は通常、空白セルになります。

フラット出力は請求書情報を繰り返す1つの明細表です。非フラットでは請求書情報、取引当事者、明細、税金の内訳、合計、警告を分け、Wordでは縦に配置します。

フラット

Linesは明細ごとに1行を作成し、請求書情報を繰り返します。追加の調整行には−discount、tax_inclusiveがtrueでない場合のtaxes[].amount（またはtax）、−withholdingsを使います。摘要は生成され、line_no、quantity、unit、unit_priceは空白になります。明細のない請求書でも文書行を1行作成します。

非フラット

ExcelとCSVではこれらの表を横に、Wordでは縦に配置します。現在、Excelの明細表にはLine totalがありません。CSVとWordには含まれます。文書情報と合計はフィールドと値の行を使い、警告は存在する場合のみ表示します。

銀行取引明細書

発行機関、明細期間、各口座の識別情報・残高・合計・取引です。trnamtは符号付きで、出金が負、入金が正です。dtpostedは記帳日、dtuserは起算日です。

JSONフィールド

型はシリアライズ後のJSONを表します。親オブジェクトと配列を子フィールドより先に表示し、[]は繰り返し項目を示します。既定値のあるフィールドは抽出時に指定しなくても構いません。Decimal値は文字列としてシリアライズされます。ダウンロードにも既定値のあるフィールドが残ります。値が抽出されないこととJSONキー自体の省略は異なります。

各表は出力フィールドとJSONパスの対応を示します。||は最初の空でない値、??はnullの場合の代替値を意味します。番号付け、摘要の結合、書式は出力ルールです。欠損値は通常、空白セルになります。

フラット出力には明細書と口座の情報を繰り返す取引行が含まれます。非フラットでは明細書情報と各口座の取引、残高、合計を分けて表示します。口座セクションは文書によって異なります。

フラット

Transactions では、各取引行に文書と口座の詳細を繰り返します。取引や口座がない場合も、フラット出力には識別情報の行を作成し、取引フィールドを空欄にします。

非フラット

口座ごとに取引表と詳細表を作成し、Excel と CSV では横に並べます。明細書の詳細は最初の口座に添え、警告は存在する場合のみ表示します。Word では各セクションを縦に並べます。以下にフィールドと値の各行を示します。

クレジットカード明細書

発行機関、明細期間、口座情報、残高、利用限度額、利用状況の概要、取引です。trnamtは銀行取引明細書とは逆の購入符号を使い、請求が正、支払いと返金が負になります。

JSONフィールド

型はシリアライズ後のJSONを表します。親オブジェクトと配列を子フィールドより先に表示し、[]は繰り返し項目を示します。既定値のあるフィールドは抽出時に指定しなくても構いません。Decimal値は文字列としてシリアライズされます。ダウンロードにも既定値のあるフィールドが残ります。値が抽出されないこととJSONキー自体の省略は異なります。

各表は出力フィールドとJSONパスの対応を示します。||は最初の空でない値、??はnullの場合の代替値を意味します。番号付け、摘要の結合、書式は出力ルールです。欠損値は通常、空白セルになります。

フラット出力には明細書と口座のフィールドを繰り返す取引行が含まれます。非フラットには取引、残高、限度額、概要の口座別セクションがあります。口座が複数ある場合はセクション数も変わります。

フラット

Transactions では、各取引行に文書と口座の詳細を繰り返します。取引や口座がない場合も、フラット出力には識別情報の行を作成し、取引フィールドを空欄にします。

非フラット

口座ごとに取引表と詳細表を作成し、Excel と CSV では横に並べます。明細書の詳細は最初の口座に添え、警告は存在する場合のみ表示します。Word では各セクションを縦に並べます。以下にフィールドと値の各行を示します。

給与明細書

給与対象期間、従業員と雇用主、単価、支給額、控除、税金、雇用主負担額、合計です。current_amountは当期の金額、ytd_amountは年初来累計です。

JSONフィールド

型はシリアライズ後のJSONを表します。親オブジェクトと配列を子フィールドより先に表示し、[]は繰り返し項目を示します。既定値のあるフィールドは抽出時に指定しなくても構いません。Decimal値は文字列としてシリアライズされます。ダウンロードにも既定値のあるフィールドが残ります。値が抽出されないこととJSONキー自体の省略は異なります。

各表は出力フィールドとJSONパスの対応を示します。||は最初の空でない値、??はnullの場合の代替値を意味します。番号付け、摘要の結合、書式は出力ルールです。欠損値は通常、空白セルになります。

フラット・非フラットの選択はありません。Paystubシートは明細書、従業員、雇用主、単価、支給額、控除、税金、負担額、合計のセクションで構成されます。CSVはセクションに分かれた表で、Wordは縦に配置します。

専用レイアウト

給与明細レイアウトの各セクションです。Excel と CSV では横に、Word では縦に並べます。説明には description または code を使用し、is_imputed が true の場合は「imputed」、is_taxable が false の場合は「non-taxable」を付加します。Rate 列はパーセント形式です。合計では、各 Metric に Current と YTD の値を対応させます。警告は存在する場合のみ表示します。

表の画像

表のタイトル、見出し行、本文セル、注記です。headersとrows[].cellsは原本の列に従い、固定の財務スキーマではありません。行タイプはデータや小計など、行の役割を表します。

JSONフィールド

型はシリアライズ後のJSONを表します。親オブジェクトと配列を子フィールドより先に表示し、[]は繰り返し項目を示します。既定値のあるフィールドは抽出時に指定しなくても構いません。Decimal値は文字列としてシリアライズされます。ダウンロードにも既定値のあるフィールドが残ります。値が抽出されないこととJSONキー自体の省略は異なります。

各表は出力フィールドとJSONパスの対応を示します。||は最初の空でない値、??はnullの場合の代替値を意味します。番号付け、摘要の結合、書式は出力ルールです。欠損値は通常、空白セルになります。

フラット・非フラットの選択はありません。1つのTableシートに抽出した見出しとセルを配置します。列数は可変で、タイトル、注記、警告により行が追加される場合があります。CSVはExcelのセル結合や書式を保持できません。

専用レイアウト

列名は固定リストではなく headers から取得します。本文のセルは元の順序を保ち、短い行は補完し、null のセルは空欄にします。title と caption は表の上、notes と warnings は下に表示します。Excel では隣接する同じ見出し値を結合します。rows[].type は Excel と Word の表示形式を制御し、追加の出力列にはなりません。CSV に装飾はありません。データ表が1列でも、警告行は2列を使用する場合があります。

欠損値と結果の確認

nullを許可するフィールドにはnullが入り、存在しないリストの既定値は[]です。入れ子のオブジェクトにも独自の既定値を持つフィールドがあります。スプレッドシート出力では欠損値を通常は空白セルで表示します。日付や金額が正規化され、照合時に不足する合計が算出されたり、警告が追加されたりする場合があります。doc_idとsource_filenameは抽出された財務フィールドではなく、エクスポート用メタデータです。

原本と出力された値を確認してください。reconciliation_warningsリストが空でも、正確さが証明されたわけではありません。