---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference
Release :
- australia
ft:locale :
- ja-JP
ft:publication_title :
- オーストラリア API リファレンス
ft:clusterId :
- crapiref
bundleId :
- crapiref
workflow :
- Creator
---
# AP 請求書 API 開発者ガイド
# AP 請求書 API 開発者ガイド {#ariaid-title1}
* リリースバージョン: Australia
*
* 更新日 2026年03月12日
*
*  所要時間：6分
この開発者ガイドでは、買掛金請求書処理 用の AP 請求書 API でデフォルトで提供されていないカスタム請求書フィールドを定義する方法について説明します。cXML をペイロードとして使用する場合に認証を設定する手順も説明されています。
要求本文のカスタム請求書フィールドを定義できます。次のフローを使用して、カスタムフィールドを追加し、ターゲットテーブルにマッピングして、ペイロードで使用できるようにフォーマットします。
1. [請求書インポートのカスタムフィールドを追加](https://servicenow-prod.fluidtopics.net/Xy9A0RpEzfCHQL_2uzJqNA#apInvoice-addColToTable "AP 請求書 API で使用する請求書、請求書明細行、および請求書税明細行のカスタムフィールドを追加するには、次の手順を使用します。")
2. [ソーステーブルとターゲットテーブルの間のカスタムフィールドのマッピング](https://servicenow-prod.fluidtopics.net/Xy9A0RpEzfCHQL_2uzJqNA#apInvoice-mapFieldsTransform "AP 請求書 API のソーステーブルとターゲットテーブルの間でカスタムフィールドをマッピングするには、次の手順を使用します。")
3. [カスタムフィールドのペイロードソース形式へのマッピング](https://servicenow-prod.fluidtopics.net/Xy9A0RpEzfCHQL_2uzJqNA#apInvoice-mapFieldsTSrcFormat "AP 請求書 API の JSON、cXML、または XML のペイロードエントリにカスタムフィールドをマップするには、次の手順を使用します。")
{#apInvoice-dev-guide__ul_kcx_5fx_sdc}
ソースシステム認証情報 \[sn_spend_intg_source_system_credential\] テーブルで cXML ペイロードの認証情報を定義します。手順については、「[cXML ペイロードでの認証用の認証情報の設定](https://servicenow-prod.fluidtopics.net/Xy9A0RpEzfCHQL_2uzJqNA#apInvoice-setCxmlCreds "sn_spend_intg/ap_invoice/cxml エンドポイントは、ソースシステム認証情報 [sn_spend_intg_source_system_credential] テーブルに格納されている認証情報を使用してペイロードで認証されます。")」を参照してください。
複数の ERP を含む請求書明細にフィルター条件を適用できます。詳細については、「[Integration errors](https://www.servicenow.com/docs/access?context=integration-errors-during-erp-posting&version=australia&pubname=australia-source-to-pay-operations&ft:locale=en-US)」を参照してください。
関連項目：
* [Accounts Payable Invoice Processing](https://www.servicenow.com/docs/access?context=acc-pay-invoice-processing&version=australia&pubname=australia-source-to-pay-operations&ft:locale=en-US)
* [AP 請求書 API](https://servicenow-prod.fluidtopics.net/7NYV3KrjQesHeFASWkEnkQ#ap-invoice-api "ベンダーが使用する外部システムなどの外部システムが、構造化され自動化された方法で買掛金システムに請求書を安全に直接送信できるようにします。")
{#apInvoice-dev-guide__ul_vlt_xxw_sdc}
## 請求書インポートのカスタムフィールドを追加 {#ariaid-title2}
AP 請求書 API で使用する請求書、請求書明細行、および請求書税明細行のカスタムフィールドを追加するには、次の手順を使用します。
### 始める前に
* 必要なロール：admin
* アプリケーションスコープ：[Source-to-Pay Integrations](https://www.servicenow.com/docs/access?context=source-to-pay-integrations-landing&version=australia&pubname=australia-source-to-pay-operations&ft:locale=en-US)
{#apInvoice-addColToTable__ul_d2n_2k5_pdc}
### 手順
1. 移動先 すべてシステム定義テーブル.
2. 次のいずれかの請求書インポートテーブルを選択します。
* 請求書のインポート \[sn_spend_intg_imp_invoice\]
* 請求書項目インポート \[sn_spend_intg_imp_invoice_line\]
* 請求書税項目インポート \[sn_spend_intg_imp_invoice_tax_line\]
{#apInvoice-addColToTable__ul_trr_2bg_tdc}
3. \[ テーブル列 \] タブで \[新規\] を選択します。
4. \[タイプ\] メニューからフィールド値に関連付けられたタイプ (整数など) を選択します。
注:
有効なタイプのリストについては、「 [Field types reference](https://www.servicenow.com/docs/access?context=r_FieldTypes&version=australia&pubname=australia-platform-administration&ft:locale=en-US)」を参照してください。
5. \[ 列ラベル\] フィールドにわかりやすい名前を入力します。
ラベルを含むテキストは、\[ 列名 \] フィールドに自動的に入力されます。
6. \[保存\] または \[送信\] を選択します。
7. 同じ名前とタイプの列を請求書 \[sn_shop_invoice\] テーブルに追加します。
注:
列とフィールドの詳細については、「 [Exploring field administration](https://www.servicenow.com/docs/access?context=c_IntroductionToFields&version=australia&pubname=australia-platform-administration&ft:locale=en-US)」を参照してください。
8. [ソーステーブルとターゲットテーブルの間でフィールドをマッピング](https://servicenow-prod.fluidtopics.net/Xy9A0RpEzfCHQL_2uzJqNA#apInvoice-mapFieldsTransform "AP 請求書 API のソーステーブルとターゲットテーブルの間でカスタムフィールドをマッピングするには、次の手順を使用します。")します。
{#apInvoice-addColToTable__steps_uxf_c4g_ndc}
## ソーステーブルとターゲットテーブルの間のカスタムフィールドのマッピング {#ariaid-title3}
AP 請求書 API のソーステーブルとターゲットテーブルの間でカスタムフィールドをマッピングするには、次の手順を使用します。
### 始める前に
* 必要なロール：admin
* アプリケーションスコープ：[Source-to-Pay Integrations](https://www.servicenow.com/docs/access?context=source-to-pay-integrations-landing&version=australia&pubname=australia-source-to-pay-operations&ft:locale=en-US)
{#apInvoice-mapFieldsTransform__ul_d2n_2k5_pdc}
ソーステーブルからターゲットテーブルに新しいフィールドをマッピングするためのテーブル列を作成します。[請求書インポートのカスタムフィールドを追加](https://servicenow-prod.fluidtopics.net/Xy9A0RpEzfCHQL_2uzJqNA#apInvoice-addColToTable "AP 請求書 API で使用する請求書、請求書明細行、および請求書税明細行のカスタムフィールドを追加するには、次の手順を使用します。")の手順を使用します。
### 手順
1. 移動先 すべてシステムインポートセット変換マップ.
2. 請求書インポートテーブル変換マップを開きます。
3. \[フィールドマップ\] タブで \[新規\] をクリックします。
4. \[ ソースフィールド \] メニューからカスタムフィールドの名前を選択します。
5. \[ ターゲットフィールド\] メニューからカスタムフィールドの名前を選択します。
6. \[保存\] または \[送信\] を選択します。
7. [カスタムフィールドのペイロードソース形式へのマッピング](https://servicenow-prod.fluidtopics.net/Xy9A0RpEzfCHQL_2uzJqNA#apInvoice-mapFieldsTSrcFormat "AP 請求書 API の JSON、cXML、または XML のペイロードエントリにカスタムフィールドをマップするには、次の手順を使用します。")。
{#apInvoice-mapFieldsTransform__steps_uxf_c4g_ndc}
## カスタムフィールドのペイロードソース形式へのマッピング {#ariaid-title4}
AP 請求書 API の JSON、cXML、または XML のペイロードエントリにカスタムフィールドをマップするには、次の手順を使用します。
### 始める前に
* 必要なロール：admin
* アプリケーションスコープ：[Source-to-Pay Integrations](https://www.servicenow.com/docs/access?context=source-to-pay-integrations-landing&version=australia&pubname=australia-source-to-pay-operations&ft:locale=en-US)
* [請求書インポートのカスタムフィールドを追加](https://servicenow-prod.fluidtopics.net/Xy9A0RpEzfCHQL_2uzJqNA#apInvoice-addColToTable "AP 請求書 API で使用する請求書、請求書明細行、および請求書税明細行のカスタムフィールドを追加するには、次の手順を使用します。")
* [ソーステーブルとターゲットテーブルの間のカスタムフィールドのマッピング](https://servicenow-prod.fluidtopics.net/Xy9A0RpEzfCHQL_2uzJqNA#apInvoice-mapFieldsTransform "AP 請求書 API のソーステーブルとターゲットテーブルの間でカスタムフィールドをマッピングするには、次の手順を使用します。")
{#apInvoice-mapFieldsTSrcFormat__ul_d2n_2k5_pdc}
### 手順
1. 移動先 すべて調達統合サプライヤー請求書統合フィールドマッピング.
2. \[新規\] を選択します。
3. ソースシステムの名前を \[ ソースシステム \] フィールドに追加します。
* このフィールドマッピングがすべてのソースシステムに適用される場合は、「 デフォルト」と入力します。
* マッピングが特定のソースシステムに固有である場合、この値は API で受信した Source-System ヘッダーパラメーターの値と一致する必要があります。
注:
残りのフィールドマッピングはすべて、このソースシステム専用に構成する必要があります。
{#apInvoice-mapFieldsTSrcFormat__ul_ih3_rl2_tdc}
4. \[ ソース形式 \] 選択リスト (cXML または JSON) から、マッピングを作成するソースシステムの形式を選択します。
5. \[ ソースフィールド \] フィールドにペイロードエントリの名前 (JSON プロパティ) またはパス (cXML/XML 属性または要素) を入力します。
cXML および XML パス設定の例については、請求書統合フィールドマッピング \[sn_spend_intg_invoice_intg_field_mapping\] テーブルを参照してください。
6. フィールドを cXML ペイロードの要素属性として定義する場合は属性の名前を追加し、それ以外の場合はフィールドを空のままにします。
7. \[関連テーブル\] リストからカスタムフィールドを含むターゲットテーブルの名前を選択します。
8. \[ ターゲットフィールド \] リストからカスタムフィールドの名前を選択します。
9. \[保存\] または \[送信\] を選択します。
マッピングされたフィールドが請求書統合フィールドマッピング \[sn_spend_intg_invoice_intg_field_mapping\] テーブルに追加されます。
{#apInvoice-mapFieldsTSrcFormat__steps_uxf_c4g_ndc}
## cXML ペイロードでの認証用の認証情報の設定 {#ariaid-title5}
sn_spend_intg/ap_invoice/cxml エンドポイントは、ソースシステム認証情報 \[sn_spend_intg_source_system_credential\] テーブルに格納されている認証情報を使用してペイロードで認証されます。
### 始める前に
必要なロール：admin
請求書統合フィールドマッピング \[sn_spend_intg_invoice_intg_field_mapping\] テーブルにリストされているペイロードソースシステムを識別します。
「[AP 請求書 -- POST sn_spend_intg/ap_invoice/cxml](https://servicenow-prod.fluidtopics.net/7NYV3KrjQesHeFASWkEnkQ#ap_invoice-POST-cxml "コマース XML (cXML) 形式の自動請求書を処理します。")」も参照してください。
### 手順
1. 移動先 すべて調達統合ソースシステム認証情報.
2. \[新規\] を選択します。
3. 請求書統合フィールドマッピング \[sn_spend_intg_invoice_intg_field_mapping\] テーブルにリストされているソースシステムの名前を \[ ソースシステム \] フィールドに追加します。
ソースシステム名は、Source-System ヘッダーパラメーターと一致する必要があります。
4. フェッチするユーザー名を \[ ユーザー名 \] フィールドに追加します。
この値は、 /cXML/Header/To/Credential \[@domain='NetworkID'\]/Identity 要素で使用します。
5. 文字、数字、および特殊文字の強力な組み合わせを \[パスワード\] フィールドに追加します。
この値は、 /cXML/Header/Sender/Credential \[@domain='NetworkID'\]/SharedSecret 要素で使用します。
6. \[送信\] を選択します。
{#apInvoice-setCxmlCreds__steps_uxf_c4g_ndc}