AP 請求書 API

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：96分

    • ベンダーが使用するような外部システムが、構造化され自動化された方法で、請求書を買掛金システムに直接安全に送信できるようにします。

    この API には、sn_spend_intg 名前空間内で提供される 買掛金請求書処理 (com.sn_ap_apm) ストアアプリケーションが必要です。詳細については、「Accounts Payable Invoice Processing」を参照してください。

    次のタスクについては、 AP 請求書 API 開発者ガイド を参照してください。
    • 請求書、請求書明細行、請求書税明細行のカスタムフィールドを定義します。
    • ソーステーブルとターゲットテーブルの間でカスタムフィールドをマッピングします。
    • カスタムフィールドを、JSON、CXML、XML などの特定の形式のペイロードエントリにマッピングします。
    • ペイロードとして cXML を使用する場合の認証用の認証情報の設定。
    注:
    デフォルトの最大ペイロードサイズは 100 レコードです。この値は、 sn_spend_intg.ap.invoice.create.api.record_limit システムのプロパティで構成できます。

    AP 請求書 – POST sn_spend_intg/ap_invoice/cxml

    自動請求書をコマース XML (cXML) 形式で処理します。

    請求書統合フィールドマッピング [sn_spend_intg_invoice_intg_field_mapping] テーブルを使用して、フィールドを cXML タグにマッピングする方法を決定します。

    その他の cXML リソースについては、https://xml.cxml.org にある cXML リファレンス ガイドを参照してください。

    この API の認証情報はペイロードに含まれています。ソースシステム認証情報 [sn_spend_intg_source_system_credential] テーブルで認証情報を設定できます。手順については、「cXML ペイロードでの認証用の認証情報の設定」を参照してください。

    要求本文のカスタム請求書フィールドを定義できます。次のフローを使用して、カスタムフィールドを追加し、ターゲットテーブルにマッピングして、ペイロードで使用できるようにフォーマットします。
    1. 請求書インポートのカスタムフィールドを追加
    2. ソーステーブルとターゲットテーブルの間でカスタムフィールドをマッピングする
    3. カスタムフィールドをペイロードソース形式にマップする

    URL 形式

    バージョニングされた URL: /api/sn_spend_intg/v1/ap_invoice/cxml

    デフォルト URL: /api/sn_spend_intg/ap_invoice/cxml

    サポートされている要求パラメーター

    表 : 1. パスパラメーター
    名前 説明
    api_version オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。

    データタイプ：文字列
    表 : 2. クエリパラメーター
    名前 説明
    なし
    表 : 3. 要求本文要素 (cXML)
    パス 説明
    /cXML/Header/From /Credential[@domain='VendorID']/Identity 顧客が注文できるリセラーまたはサプライヤーの識別子。

    ターゲットフィールド:u_supplier

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /cXML/Request/InvoiceDetailRequest /InvoiceDetailRequestHeader[@invoiceDate] 顧客が請求された日付。

    ターゲットフィールド:u_invoice_date

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    形式：YYYY-MM-DD
    /cXML/Request/InvoiceDetailRequest /InvoiceDetailRequestHeader[@invoiceID] サードパーティアプリケーションによって生成された請求書番号。

    ターゲットフィールド:u_external_invoice_number

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /cXML/Request/InvoiceDetailRequest /InvoiceDetailRequestHeader[@invoiceOrigin] 請求書の受領元の外部ソースシステム。たとえば、サプライヤーです。

    ターゲットフィールド:u_inbound_source

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /cXML/Request/InvoiceDetailRequest /InvoiceDetailRequestHeader/InvoicePartner /Contact[@role='billTo']/PostalAddress/City 請求書の送信先の市区町村。

    ターゲットフィールド:u_bill_to_city

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /cXML/Request/InvoiceDetailRequest /InvoiceDetailRequestHeader/InvoicePartner /Contact[@role='billTo']/PostalAddress/Country 請求書の送信先の国 (ISO 3166 形式)。たとえば、 US です。

    ターゲットフィールド:u_bill_to_country

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /cXML/Request/InvoiceDetailRequest /InvoiceDetailRequestHeader/InvoicePartner /Contact[@role='billTo']/PostalAddress/State 請求書の送信先の都道府県。

    ターゲットフィールド:u_bill_to_state_or_province

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /cXML/Request/InvoiceDetailRequest /InvoiceDetailRequestHeader/InvoicePartner /Contact[@role='billTo']/PostalAddress/Street 請求書の送信先の番地。

    ターゲットフィールド:u_bill_to_street

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /cXML/Request/InvoiceDetailRequest /InvoiceDetailRequestHeader/InvoicePartner /Contact[@role='billTo']/PostalAddress/PostalCode 請求書の送信先の郵便番号。

    ターゲットフィールド:u_bill_to_zip_or_postal_code
    連絡先 [@role="remitTo"]/PostalAddress /番地 支払先の番地。

    ターゲットフィールド:u_remit_address
    連絡先 [@role="remitTo"]/PostalAddress /City 支払先の市区町村。

    ターゲットフィールド:u_remit_to_city
    連絡先 [@role="remitTo"]/PostalAddress /State 支払先の都道府県。

    ターゲットフィールド:u_remit_to_state_or_province
    連絡先 [@role="remitTo"]/PostalAddress /PostalCode 支払先の郵便番号。

    ターゲットフィールド:u_remit_to_zip_or_postal_code
    連絡先 [@role="remitTo"]/PostalAddress /Country 支払い先の国 (ISO 3166 形式)。たとえば、 US です。

    ターゲットフィールド:u_remit_to_country
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader /InvoiceDetailShipping/Contact[@role="shipFrom"]/PostalAddress /Street 発注書の品目の配送元の番地。

    ターゲットフィールド:u_ship_from_street

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader /InvoiceDetailShipping/Contact[@role="shipFrom"]/PostalAddress /City 発注書の品目の配送元の市区町村。

    ターゲットフィールド:u_ship_from_city

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader /InvoiceDetailShipping/Contact[@role="shipFrom"]/PostalAddress /State 発注書の品目の配送元の都道府県。

    ターゲットフィールド:u_ship_from_state_or_province

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader /InvoiceDetailShipping/Contact[@role="shipFrom"]/PostalAddress /PostalCode 発注書の品目の配送元の郵便番号。

    ターゲットフィールド:u_ship_from_zip_or_postal_code

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader /InvoiceDetailShipping/Contact[@role="shipFrom"]/PostalAddress /Country 発注書の品目の配送元の国。

    ターゲットフィールド:u_ship_from_country

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader /InvoicePartner/Contact[@role="billTo"] [@addressID] サプライヤーの法人の名前。法人 [sn_fin_legal_entity] テーブルにあります。

    ターゲットフィールド:u_legal_entity

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    連絡先 [@role="shipTo"]/名前 発注書の品目の配送先となる連絡先の名前。

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    連絡先 [@role="shipTo"]/PostalAddress /番地 発注書の品目の配送先の番地。

    ターゲットフィールド:u_ship_to_street

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    連絡先 [@role="shipTo"]/PostalAddress /City 発注書の品目の配送先の市区町村。

    ターゲットフィールド:u_ship_to_city

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    連絡先 [@role="shipTo"]/PostalAddress /State 発注書の品目の配送先の都道府県。

    ターゲットフィールド:u_ship_to_state_or_province
    連絡先 [@role="shipTo"]/PostalAddress /PostalCode 発注書の品目の配送先の郵便番号。

    ターゲットフィールド:u_ship_to_zip_or_postal_code

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    連絡先 [@role="shipTo"]/PostalAddress /Country 発注書の品目の配送先の国。

    ターゲットフィールド:u_ship_from_country

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    /cXML/要求/請求書詳細要求 /請求書詳細要求ヘッダー/支払条件 サプライヤーへの支払いが行われる合意された時期および条件。たとえば、「 Net 30」などです。

    ターゲットフィールド:u_payment_terms

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem[@description]/ 請求書明細行の説明。

    ターゲットフィールド:u_line_description
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem[@quantity]/ 顧客への請求対象となる、物品またはサービスの数量。

    ターゲットフィールド:u_line_quantity
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem/Distribution/Accounting/AccountingSegment[1]/Name 請求書が生成されるコストセンターのアカウント番号。コストセンター [cmn_cost_center] テーブルにリストされます。

    ターゲットフィールド:u_cost_center
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem/Distribution/Accounting/AccountingSegment[2]/Name 請求書の生成に使用される総勘定元帳 (GL) のアカウント番号。

    ターゲットフィールド:u_gl_account

    関連項目：
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem/SubtotalAmount/Money 税金と配送料を除いたサプライヤーに支払われる合計金額。

    ターゲットフィールド:u_subtotal

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /cXML/要求/請求書詳細要求/請求書詳細注文 /請求書詳細品目/正味金額/金額 特定の発注明細に対して顧客に請求される総コスト (税と送料を除く)。

    ターゲットフィールド:u_line_amount_invoiced

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailOrderInfo/OrderReference この注文に対して顧客から提供された発注書番号。発注書 [sn_shop_purchase_order] テーブルにリストされている。

    ターゲットフィールド:u_purchase_order

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /cXML/要求/請求書詳細要求/請求書詳細注文 /請求書詳細品目/単価/測定単位 請求書の品目を計数するために使用される基本測定単位 (UOM)。

    ターゲットフィールド:u_uom

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem/UnitPrice/Money 請求書の項目の単価。

    ターゲットフィールド:u_line_unit_price

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem/UnitPrice/Money[@currency] 品目の通貨。例:USD。

    ターゲットフィールド:u_currency

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem /InvoiceDetailItemReference[@lineNumber] 参照されるサプライヤーの発注書 (PO) 明細行 ID。発注明細 [sn_shop_purchase_order_line] テーブルにリストされます。

    ターゲットフィールド:u_purchase_order_line

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem/InvoiceDetailItemReference /ItemID/SupplierPartID この請求書明細行に対してサプライヤーによって生成される部品番号。

    ターゲットフィールド:u_supplier_part_number

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem/InvoiceDetailItemReference /説明 請求書の発注明細の説明。

    ターゲットフィールド:u_po_line_description

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    cXML/要求/請求書詳細要求/請求書詳細注文/請求書詳細品目/税/金額 購入に対して請求される税金の合計額。

    ターゲットフィールド:u_tax_amount

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    cXML/要求/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem/税/説明 ERP ソースから生成された一意の税コード。

    ターゲットフィールド:u_tax_code

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    /cXML/Request/InvoiceDetailRequest/ InvoiceDetailSummary /SubtotalAmount/Money 税金と配送料を除いたサプライヤーに支払われる合計金額。

    ターゲットフィールド:u_subtotal

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary /税/金額 購入に対して請求される税金の合計額。

    ターゲットフィールド:u_tax_amount

    関連テーブル:請求書税項目インポート [sn_spend_intg_imp_invoice_tax_line]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary /Tax/TaxDetail[@category] 請求書に適用される税のタイプ。税タイプ [sn_fin_tax_type] テーブルに表示されます。

    ターゲットフィールド:u_tax_type

    関連テーブル:請求書税項目インポート [sn_spend_intg_imp_invoice_tax_line]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary /Tax/TaxDetail[@percentageRate] サプライヤーが請求する税率。

    関連テーブル:請求書税項目インポート [sn_spend_intg_imp_invoice_tax_line]

    ターゲットフィールド:u_supplier_tax_rate

    関連テーブル:請求書税項目インポート [sn_spend_intg_imp_invoice_tax_line]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary /SpecialHandlingAmount/Money 請求書に関連するその他の追加料金。これは編集可能なフィールドです。

    ターゲットフィールド:u_other_charges

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary /ShippingAmount/Money 購入全体の合計送料。

    ターゲットフィールド:u_shipping_amount

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary /GrossAmount/Money 必須です。小計、税、および送料の通貨。小計、税、および送料は同じ通貨である必要があります。

    ターゲットフィールド:u_currency

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary /InvoiceDetailDiscount/Money 請求書に適用される割引。

    ターゲットフィールド:u_discounts

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary /NetAmount/Money 税金と配送料を含むサプライヤーに支払われる合計金額。

    ターゲットフィールド:u_amount_invoiced

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    ヘッダー

    次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 4. 要求ヘッダー
    ヘッダー 説明
    Content-Type 要求本文のデータ形式。application/xml のみをサポートします。
    ソースシステム 要求の送信元のソースシステムを指定します。

    利用可能なシステムは、ソースシステムの認証情報 [sn_spend_intg_source_system_credential] テーブルに一覧表示されます。

    この設定は、指定された要求が請求書統合フィールドマッピング [sn_spend_intg_invoice_intg_field_mapping] テーブルの構造に従っているかどうかを判断するのに役立ちます。

    この設定は、ソースシステム認証情報 [sn_spend_intg_source_system_credential] テーブルから認証情報をフェッチするためにも使用されます。
    表 : 5. 応答ヘッダー
    ヘッダー 説明
    なし

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 6. ステータスコード
    ステータスコード 説明
    202 要求が承認されました。要求が成功し、請求書の処理が進行中です。
    400 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。
    429 要求が多すぎます。要求レートが 1 時間あたり最大 10 件の要求を超えました。

    応答本文のパラメーター

    名前 説明
    batch_id バッチ要求の一意の識別子。この ID は、要求のステータスを追跡するために使用できます。このレコードは、請求書統合ログ [sn_spend_intg_invoice_integration_log] テーブルに保存されます。

    データタイプ：文字列
    エラー 要求が失敗した場合のエラーメッセージと詳細が含まれます。
    {
  "detail": String,
  "message": String
}

    データタイプ: オブジェクト
    error.detail 要求エラーに関するその他の詳細。
    考えられる結果:
    • API レベルの ACL 検証に失敗しました:ユーザーにリソースへの読み取り/書き込みアクセス権がありません。
    • AP の 1 時間あたり 13 リクエストのレート制限を超えました 請求書 – バッチ内のレコード数がバッチサイズの設定を超えています。
    • 認証情報の入力を要求 - パスワードまたはユーザー名が間違っています。

    データタイプ：文字列
    error.message 要求が失敗した理由を含むエラーメッセージ
    考えられるエラー:
    • 無効なペイロード:無効なコンテンツタイプ。
    • 無効なペイロード:エラー:無効なペイロード構造です。
    • 無効なペイロード:エラー:ペイロードがバッチで許可される請求書の制限を超えています。バッチ内のレコード数がバッチサイズの設定を超えています。デフォルトの最大ペイロードサイズは 100 レコードです。この値は、 sn_spend_intg.ap.invoice.create.api.record_limit システムのプロパティで構成できます。
    • 無効なペイロード:エラー:請求書が空です。処理するデータがありません。バッチ内のレコード数が 0 である。
    • APO 請求書取り込みの 1 時間あたり 500 要求のレート制限を超えました。
    • ユーザーが認証されていません。パスワードまたはユーザー名が間違っています。
    • API レベルの ACL 検証に失敗しました:ユーザーにリソースへの読み取り/書き込みアクセス権がありません。

    データタイプ：文字列
    メッセージ 成功メッセージ (例: 要求が正常に受信され、処理中です。

    要求のステータスは、請求書統合ログ [sn_spend_intg_invoice_integration_log] テーブルで確認できます。

    データタイプ：文字列
    ステータス 要求の結果を示します。
    可能な値：
    • 成功
    • 失敗

    データタイプ：文字列

    cURL 要求

    次の例は、cXML 形式で要求として提供された請求書を処理する方法を示しています。

    curl -X POST https://instance.servicenow.com/api/sn_spend_intg/v1/ap_invoice/cxml \
-H "Source-System: Ariba" \
-H "Content-Type: application/json" \
-d '{
    "content": "------=_Part_1367_1859161670.1709186492411\r\nContent-Type: text/xml; charset=UTF-8\r\n
Content-ID: 1709186492411.10815535@produs-c4-an-s2-z3-1.us2.gcpint.ariba.com\r\n<?xml version=\"1.0\" 
encoding=\"UTF-8\"?>\r\n<!DOCTYPE cXML SYSTEM \"https://protect-us.mimecast.com/s/fgKrCERVqQU35PNzBuw39pz?domain=xml.cxml.org\">
\r\n<cXML timestamp=\"2024-02-28T22:01:32-08:00\" payloadID=\"1709186492411-3401013259654180284@10.209.37.74\">
\r\n    <Response>\r\n        <Status code=\"200\" text=\"OK\" />\r\n        <DataResponse>\r\n            <Attachment>
\r\n                <URL>186492411.10815535@produs-c4-an-s2-z3-1.us2.gcpint.ariba.com.110</URL>\r\n            </Attachment>
\r\n            <Attachment>\r\n                <URL>1709186492403.306612238@produs-c4-an-s2-z3-1.us2.gcpint.ariba.com.108</URL>
\r\n            </Attachment>\r\n        </DataResponse>\r\n    </Response>\r\n</cXML>\r\n------=_Part_1367_1859161670.1709186492411
\r\nContent-Type: text/xml; charset=UTF-8\r\nContent-ID: 1709186492403.306612238@produs-c4-an-s2-z3-1.us2.gcpint.ariba.com.108
\r\n<?xml version=\"1.0\" encoding=\"UTF-8\"?>\r\n
<!DOCTYPE cXML SYSTEM \"https://protect-us.mimecast.com/s/7QpfCG6VRKf15gQPwFpUTKe?domain=xml.cxml.org\">\r\n
<cXML payloadID=\"1705930173863-1790846563502652473@10.209.37.98\" timestamp=\"2024-01-22T05:29:33-08:00\" version=\"1.2.060\">\r\n
    <Header>\r\n        <From>\r\n            <Credential domain=\"NetworkID\">\r\n                <Identity>AN01532216648-T</Identity>\r\n
            </Credential>\r\n            <Credential domain=\"VendorID\">\r\n                <Identity>3245545</Identity>\r\n
            </Credential>\r\n            <Credential domain=\"PrivateID\">\r\n                <Identity>0000099123</Identity>\r\n
            </Credential>\r\n        </From>\r\n        <To>\r\n            <Credential domain=\"NetworkID\">\r\n
                <Identity>AN01404744424-T</Identity>\r\n            </Credential>\r\n            <Credential domain=\"SystemID\">\r\n
                <Identity>ERP1</Identity>\r\n            </Credential>\r\n            <Credential domain=\"EndPointID\">\r\n
                <Identity>CIG</Identity>\r\n            </Credential>\r\n        </To>\r\n        <Sender>\r\n
            <Credential domain=\"NetworkID\">\r\n                <Identity>AN01000000001</Identity>\r\n
                <SharedSecret>Ariba@123</SharedSecret>\r\n            </Credential>\r\n            <UserAgent>Supplier</UserAgent>\r\n
        </Sender>\r\n    </Header>\r\n    <Request deploymentMode=\"test\">\r\n        <InvoiceDetailRequest>\r\n
            <InvoiceDetailRequestHeader invoiceDate=\"2024-01-22\" invoiceID=\"\" invoiceOrigin=\"supplier\" operation=\"new\ purpose=\"PO Invoice\">\r\n
                <InvoiceDetailHeaderIndicator></InvoiceDetailHeaderIndicator>\r\n
                <InvoiceDetailLineIndicator></InvoiceDetailLineIndicator>\r\n                <InvoicePartner>\r\n
                    <Contact addressID=\"Test123\" role=\"remitTo\">\r\n
                        <Name xml:lang=\"en-US\">Oil and Natural Gas Corporation Limited</Name>\r\n
                        <PostalAddress>\r\n                            <Street>Xyz street</Street>\r\n                            <City>USA</City>\r\n
                            <State isoStateCode=\"US-NY\">NY</State>\r\n                            <PostalCode>10001</PostalCode>\r\n
                            <Country isoCountryCode=\"US\">United States</Country>\r\n                        </PostalAddress>\r\n
                    </Contact>\r\n                </InvoicePartner>\r\n                <InvoicePartner>\r\n
                    <Contact addressID=\"9009\" role=\"billTo\">\r\n                        <Name xml:lang=\"EN\">Bristlecone Inc</Name>\r\n
                        <PostalAddress>\r\n                            <Street>10 Boulvard-10</Street>\r\n
                            <City>San Jose</City>\r\n                            <State>CA</State>\r\n
                            <PostalCode>94077</PostalCode>\r\n                            <Country isoCountryCode=\"US\"></Country>\r\n
                        </PostalAddress>\r\n                        <Phone>\r\n                            <TelephoneNumber>\r\n
                                <CountryCode isoCountryCode=\"US\">1</CountryCode>\r\n                                <Number>7687687799</Number>\r\n
                            </TelephoneNumber>\r\n                        </Phone>\r\n                        <Fax>\r\n
                            <TelephoneNumber>\r\n                                <CountryCode isoCountryCode=\"US\">1</CountryCode>\r\n
                                <Number>768-FAX-NUMBER</Number>\r\n                            </TelephoneNumber>\r\n                        </Fax>\r\n
                    </Contact>\r\n                </InvoicePartner>\r\n                <InvoicePartner>\r\n                    <Contact role=\"from\">\r\n
                        <Name xml:lang=\"en-US\">Oil and Natural Gas Corporation Limited</Name>\r\n                        <PostalAddress>\r\n
                            <Street>123 , street no 5</Street>\r\n                            <City>Dallas</City>\r\n
                            <State isoStateCode=\"US-AL\">AL</State>\r\n                            <PostalCode>36615</PostalCode>\r\n
                            <Country isoCountryCode=\"US\">United States</Country>\r\n                        </PostalAddress>\r\n
                    </Contact>\r\n                </InvoicePartner>\r\n                <InvoiceDetailShipping>\r\n
                    <Contact role=\"shipFrom\">\r\n                        <Name xml:lang=\"en-US\">Oil and Natural Gas Corporation Limited</Name>\r\n
                        <PostalAddress>\r\n                            <Street>Deendayal Urja Bhawan</Street>\r\n
                            <City>New Delhi</City>\r\n                            <State isoStateCode=\"IN-MH\">Maharashtra</State>\r\n
                            <PostalCode>110070</PostalCode>\r\n                            <Country isoCountryCode=\"IN\">India</Country>\r\n
                        </PostalAddress>\r\n                    </Contact>\r\n                    <Contact addressID=\"9999\" role=\"shipTo\">\r\n
                        <Name xml:lang=\"EN\">Buyer Plant Bristlecone</Name>\r\n                        <PostalAddress name=\"default\">\r\n
                            <Street>18 Hanoi Road</Street>\r\n                            <City>San Jose</City>\r\n
                            <State>CA</State>\r\n                            <PostalCode>77077</PostalCode>\r\n
                            <Country isoCountryCode=\"US\"></Country>\r\n                        </PostalAddress>\r\n
                        <Email name=\"default\" preferredLang=\"en\">test@test.com</Email>\r\n                    </Contact>\r\n
                </InvoiceDetailShipping>\r\n            </InvoiceDetailRequestHeader>\r\n            <InvoiceDetailOrder>\r\n
                <InvoiceDetailOrderInfo>\r\n                    <OrderReference orderID=\"\">\r\n
                        <DocumentReference payloadID=\"0AAF8EA1FA5F1EDE9FDC97460BCB03E1\"></DocumentReference>\r\n
                    </OrderReference>\r\n                </InvoiceDetailOrderInfo>\r\n
                <InvoiceDetailItem invoiceLineNumber=\"2\" quantity=\"25\" description=\"Indian Oil\">\r\n
                    <UnitOfMeasure>EA</UnitOfMeasure>\r\n                    <UnitPrice>\r\n                        <Money currency=\"USD\">50</Money>\r\n
                    </UnitPrice>\r\n                    <SubtotalAmount>\r\n                        <Money currency=\"USD\">1250.00</Money>\r\n
                    </SubtotalAmount>\r\n                </InvoiceDetailItem>\r\n            </InvoiceDetailOrder>\r\n        </InvoiceDetailRequest>\r\n
    </Request>\r\n</cXML>\r\n------=_Part_1367_1859161670.1709186492411--"
}'

    次の結果は、要求が成功し、請求書データが処理されていることを示しています。要求のステータスは、請求書統合ログ [sn_spend_intg_invoice_integration_log] テーブルで確認できます。[バッチ ID] 列にリストされているバッチ ID を使用して、請求書を検索します。

    {
    "batchId": "APIINV1729711710733280",
    "status": "Success",
    "message": "Your request has been successfully received and is being processed."
}

    AP 請求書 – POST sn_spend_intg/ap_invoice/json

    JSON 形式の自動請求書を処理します。

    必要なロール:sn_spend_intg.procurement_integrator

    請求書統合フィールドマッピング [sn_spend_intg_invoice_intg_field_mapping] テーブルを使用して、フィールドを JSON プロパティにマッピングする方法を決定します。

    要求本文のカスタム請求書フィールドを定義できます。次のフローを使用して、カスタムフィールドを追加し、ターゲットテーブルにマッピングして、ペイロードで使用できるようにフォーマットします。
    1. 請求書インポートのカスタムフィールドを追加
    2. ソーステーブルとターゲットテーブルの間でカスタムフィールドをマッピングする
    3. カスタムフィールドをペイロードソース形式にマップする

    URL 形式

    バージョニングされた URL: /api/sn_spend_intg/v1/ap_invoice/json

    デフォルト URL: /api/sn_spend_intg/ap_invoice/json

    サポートされている要求パラメーター

    表 : 7. パスパラメーター
    名前 説明
    api_version オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。

    データタイプ：文字列
    表 : 8. クエリパラメーター
    名前 説明
    なし
    表 : 9. 要求本文パラメーター
    名前 説明
    請求書 処理する各請求書を含むリスト。

    データタイプ: ネストされた請求書オブジェクトのオブジェクト。

    "invoices": {
  {
    "amount_invoiced": "String",
    "bill_to_city": "String",
    "bill_to_country": "String",
    "bill_to_state_or_province": "String",
    "bill_to_street": "String",
    "bill_to_zip_or_postal_code": "String",
    "business_owner": "String",
    "currency": "String",
    "discounts": "String",
    "erp_number": "String",
    "external_invoice_number": "String",
    "invoice_date": "String",
    "invoice_line_count": "String",
    "invoice_lines": [Array],
    "invoice_type": "String",
    "legal_entity": "String",
    "original_invoice": "String",
    "other_charges": "String",
    "payment_terms": "String",
    "purchase_order": "String",
    "remit_address": "String",
    "remit_to_city": "String",
    "remit_to_country": "String",
    "remit_to_state_or_province": "String",
    "remit_to_zip_or_postal_code": "String",
    "ship_from_city": "String",
    "ship_from_country": "String",
    "ship_from_state_or_province": "String",
    "ship_from_street": "String",
    "ship_from_zip_or_postal_code": "String",
    "ship_to_city": "String",
    "ship_to_country": "String",
    "ship_to_state_or_province": "String",
    "ship_to_street": "String",
    "ship_to_zip_or_postal_code": "String",
    "shipping_amount": "String",
    "subtotal": "String",
    "supplier": "String",
    "supplier_invoice_number": "String",
    "supplier_tax_id": "String"
  }
}
    invoices.amount_invoiced 税金と配送料を含むサプライヤーに支払われる合計金額。

    ターゲットフィールド:u_amount_invoiced

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：40
    bill_to_city 請求書の送信先の市区町村。

    ターゲットフィールド:u_bill_to_city

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    bill_to_country 請求書の送信先の国 (ISO 3166 形式)。たとえば、 US です。

    ターゲットフィールド:u_bill_to_country

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    bill_to_state_or_province 請求書の送信先の都道府県。

    ターゲットフィールド:u_bill_to_state_or_province

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    bill_to_street 請求書の送信先の番地。

    ターゲットフィールド:u_bill_to_street

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    bill_to_zip_or_postal_code 請求書の送信先の郵便番号。

    ターゲットフィールド:u_bill_to_zip_or_postal_code
    invoices.business_owner 事業側からアプリケーションを所有する所有者の名前。

    ターゲットフィールド:u_business_owner

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：40
    invoices.currency 必須です。小計、税、および送料の通貨。小計、税、および送料は同じ通貨である必要があります。

    ターゲットフィールド:u_currency

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：40
    invoices.discounts 請求書に適用される割引。

    ターゲットフィールド:u_discounts

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：100
    invoices.erp_number 発注書 (PO) に対して ERP (エンタープライズリソースプランニング) システム内で生成された一意の番号。詳細については、「Purchase order integration」を参照してください。

    ターゲットフィールド:u_erp_number

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：40
    請求 書。external_invoice_number 必須。 サードパーティアプリケーションによって生成された請求書番号。

    ターゲットフィールド:u_external_invoice_number

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：40
    invoices.invoice_date 必須。 顧客が請求された日付。

    ターゲットフィールド:u_invoice_date

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：40

    形式：YYYY-MM-DD
    invoices.invoice_line_count 請求書の明細行数。

    ターゲットフィールド:u_invoice_line_count

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：40
    invoices.invoice_lines この注文内の購入に対して請求される明細を定義するオブジェクトのリスト。請求書明細行は、請求書明細行インポート受信 [sn_spend_intg_imp_invoice_line] テーブルにステージングされます。

    データタイプ：アレイ

    "invoice_lines": [
  {
    "cost_center": "String",
    "currency": "String",
    "external_invoice_number": "String",
    "gl_account": "String",
    "line_amount_invoiced": "String",
    "line_description": "String",
    "line_quantity": "String",
    "line_unit_price": "String",
    "po_line_description": "String",
    "purchase_order_line": "String",
    "ship_to_city": "String",
    "ship_to_country": "String",
    "ship_to_state_or_province": "String",
    "ship_to_street": "String",
    "ship_to_zip_or_postal_code": "String",
    "subtotal": "String",
    "supplier_part_number": "String",
    "tax_code": "String",
    "tax_details": [Array],
    "uom": "String"
  }
]
    invoices.invoice_lines。cost_center 請求書が生成されるコストセンターのアカウント番号。コストセンター [cmn_cost_center] テーブルにリストされます。

    ターゲットフィールド:u_cost_center

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]

    データタイプ：文字列

    最大長：40
    invoices.invoice_lines。通貨 品目の通貨。例:USD。

    ターゲットフィールド:u_currency

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]

    データタイプ：文字列

    最大長：40
    invoices.invoice_lines。external_invoice_number 必須。 サードパーティアプリケーションによって生成された請求書番号。

    ターゲットフィールド:u_external_invoice_number

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：40
    invoices.invoice_lines。gl_account 請求書の生成に使用される総勘定元帳 (GL) のアカウント番号。

    ターゲットフィールド:u_gl_account

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]

    データタイプ：文字列

    最大長：40

    関連項目：
    invoices.invoice_lines。line_amount_invoiced 必須。 特定の発注明細に対して顧客に請求される総コスト (税と送料を除く)。

    ターゲットフィールド:u_line_amount_invoiced

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]

    データタイプ：文字列

    最大長：40
    invoices.invoice_lines。line_description 必須。 請求書明細行の説明。

    ターゲットフィールド:u_line_description

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]

    データタイプ：文字列

    最大長：40
    invoices.invoice_lines。line_quantity 必須。 顧客への請求対象となる、物品またはサービスの数量。

    ターゲットフィールド:u_line_quantity

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]

    データタイプ：文字列

    最大長：40
    invoices.invoice_lines。line_unit_price 請求書の項目の単価。

    ターゲットフィールド:u_line_unit_price

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]

    データタイプ：文字列

    最大長：40
    invoices.invoice_lines。po_line_description 請求書の発注明細の説明。

    ターゲットフィールド:u_po_line_description

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]

    データタイプ：文字列

    最大長：100
    invoices.invoice_lines。purchase_order_line 必須。 参照されるサプライヤーの発注書 (PO) 明細行 ID。発注明細 [sn_shop_purchase_order_line] テーブルにリストされます。

    ターゲットフィールド:u_purchase_order_line

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]

    データタイプ：文字列

    最大長：40
    invoices.invoice_lines。ship_to_city 発注書の品目の配送先の市区町村。

    ターゲットフィールド:u_ship_to_city

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]

    データタイプ：文字列

    最大長：100
    invoices.invoice_lines。ship_to_country 発注書の品目の配送先の国。

    ターゲットフィールド:u_ship_to_country

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]

    データタイプ：文字列

    最大長：100
    invoices.invoice_lines。ship_to_state_or_province 発注書の品目の配送先の都道府県。

    ターゲットフィールド:u_ship_to_state_or_province

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]

    データタイプ：文字列

    最大長：100
    invoices.invoice_lines。ship_to_street 発注書の品目の配送先の番地。

    ターゲットフィールド:u_ship_to_street

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]

    データタイプ：文字列

    最大長：100
    invoices.invoice_lines。ship_to_zip_or_postal_code 発注書の品目の配送先の郵便番号。

    ターゲットフィールド:u_ship_to_zip_or_postal_code

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]

    データタイプ：文字列

    最大長：100
    invoices.invoice_lines。小計 必須。 税金と配送料を除いたサプライヤーに支払われる合計金額。

    ターゲットフィールド:u_subtotal

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：100
    invoices.invoice_lines。supplier_part_number 必須。 この請求書明細行に対してサプライヤーによって生成される部品番号。

    ターゲットフィールド:u_supplier_part_number

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：100
    invoices.invoice_lines。tax_code ERP ソースから生成された一意の税コード。

    ターゲットフィールド:u_tax_code

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：100
    invoices.invoice_lines。tax_details 請求書明細行に関連付けられた購入の税明細行のリスト。

    データタイプ：オブジェクトのアレイ

    "tax_details": [
  {
    "tax_amount": "String",
    "tax_rate": "String",
    "tax_type": "String"
  }
]
    invoices.invoice_lines。tax_details.tax_amount 必須。 購入に対して請求される税金の合計額。

    ターゲットフィールド:u_tax_amount

    関連テーブル:請求書税項目インポート [sn_spend_intg_imp_invoice_tax_line]

    データタイプ：文字列

    最大長：40
    invoices.invoice_lines。tax_details.tax_rate サプライヤーが請求する税率。

    ターゲットフィールド:u_supplier_tax_rate

    関連テーブル:請求書税項目インポート [sn_spend_intg_imp_invoice_tax_line]

    データタイプ：文字列

    最大長：100
    invoices.invoice_lines。tax_details.tax_type 請求書に適用される税のタイプ。税タイプ [sn_fin_tax_type] テーブルに表示されます。

    ターゲットフィールド:u_tax_type

    関連テーブル:請求書税項目インポート [sn_spend_intg_imp_invoice_tax_line]

    データタイプ：文字列

    最大長：100
    invoices.invoice_lines.uom 請求書の品目を計数するために使用される基本測定単位 (UOM)。

    ターゲットフィールド:u_uom

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：100
    invoices.invoice_type 処理する請求書のタイプ。

    ターゲットフィールド:u_invoice_type

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：100
    invoices.legal_entity サプライヤーの法人の名前。法人 [sn_fin_legal_entity] テーブルにあります。

    ターゲットフィールド:u_legal_entity

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：100
    invoices.original_invoice サプライヤーによって作成された一意の請求書番号。

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    ターゲットフィールド:u_original_invoice

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：100
    invoices.other_charges 請求書に関連するその他の追加料金。これは編集可能なフィールドです。

    ターゲットフィールド:u_other_charges

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：100
    invoices.payment_terms サプライヤーへの支払いが行われる合意された時期および条件。たとえば、「 Net 30」などです。

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：100
    invoices.purchase_order 必須。 この注文に対して顧客から提供された発注書番号。発注書 [sn_shop_purchase_order] テーブルにリストされている。

    ターゲットフィールド:u_purchase_order

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：40
    invoices.remit_address 必須。 支払先の番地。

    ターゲットフィールド:u_remit_address

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：100
    invoices.remit_to_city 必須。 支払先の市区町村。

    ターゲットフィールド:u_remit_to_city

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：100
    invoices.remit_to_country 必須。 支払い先の国 (ISO 3166 形式)。たとえば、 US です。

    ターゲットフィールド:u_remit_to_country

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：100
    請求 書。remit_to_state_or_province 必須。 支払先の都道府県。

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：100
    請求 書。remit_to_zip_or_postal_code 必須。 支払先の郵便番号。

    ターゲットフィールド:u_remit_to_state_or_province

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：100
    invoices.ship_from_city 発注書の品目の配送元の市区町村。

    ターゲットフィールド:u_ship_from_city

    データタイプ：文字列

    最大長：100
    invoices.ship_from_country 発注書の品目の配送元の国。

    ターゲットフィールド:u_ship_from_country

    データタイプ：文字列

    最大長：100
    請求 書。ship_from_state_or_province 発注書の品目の配送元の都道府県。

    ターゲットフィールド:u_ship_from_state_or_province

    データタイプ：文字列

    最大長：100
    invoices.ship_from_street 発注書の品目の配送元の番地。

    ターゲットフィールド:u_ship_from_street

    データタイプ：文字列

    最大長：100
    請求 書。ship_from_zip_or_postal_code 発注書の品目の配送元の郵便番号。

    ターゲットフィールド:u_ship_from_zip_or_postal_code

    データタイプ：文字列

    最大長：100
    invoices.ship_to_city 発注書の品目の配送先の市区町村。

    ターゲットフィールド:u_ship_to_city

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：100
    invoices.ship_to_country 発注書の品目の配送先の国。

    ターゲットフィールド:u_ship_to_country

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：100
    請求 書。ship_to_state_or_province 発注書の品目の配送先の都道府県。

    ターゲットフィールド:u_ship_to_state_or_province

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：100
    invoices.ship_to_street 発注書の品目の配送先の番地。

    ターゲットフィールド:u_ship_to_street

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：100
    請求 書。ship_to_zip_or_postal_code 発注書の品目の配送先の郵便番号。

    ターゲットフィールド:u_ship_to_zip_or_postal_code

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：100
    invoices.shipping_amount 必須。 購入全体の合計送料。

    ターゲットフィールド:u_shipping_amount

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：40
    invoices.subtotal 必須。 税金と配送料を除いたサプライヤーに支払われる合計金額。

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：40
    invoices.supplier 必須。 顧客が注文できるリセラーまたはサプライヤーの識別子。

    ターゲットフィールド:u_supplier

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：100
    請求 書。supplier_invoice_number 必須。 この請求書に対してサプライヤーが生成した識別番号。

    ターゲットフィールド:u_supplier_invoice_number

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：100
    invoices.supplier_tax_id サードパーティの再販業者に関連付けられている税金識別子。これは編集可能なフィールドです。

    ターゲットフィールド:u_supplier_tax_id

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    データタイプ：文字列

    最大長：100
    invoices.target_erp 請求書が転記される ERP レコード。ERP ソース [sn_fin_erp_source] テーブルにあります。「ERP source」を参照してください。

    データタイプ：文字列

    ヘッダー

    次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 10. 要求ヘッダー
    ヘッダー 説明
    Content-Type 要求本文のデータ形式。application/json のみをサポートします。
    ソースシステム 要求の送信元のソースシステムを指定します。

    この設定は、指定された要求が請求書統合フィールドマッピング [sn_spend_intg_invoice_intg_field_mapping] テーブルの構造に従っているかどうかを判断するのに役立ちます。
    表 : 11. 応答ヘッダー
    ヘッダー 説明
    なし

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 12. ステータスコード
    ステータスコード 説明
    202 要求が承認されました。要求が成功し、請求書の処理が進行中です。
    400 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。
    429 要求が多すぎます。要求レートが 1 時間あたり最大 10 件の要求を超えました。

    応答本文のパラメーター

    名前 説明
    batch_id バッチ要求の一意の識別子。この ID は、要求のステータスを追跡するために使用できます。このレコードは、請求書統合ログ [sn_spend_intg_invoice_integration_log] テーブルに保存されます。

    データタイプ：文字列
    エラー 要求が失敗した場合のエラーメッセージと詳細が含まれます。
    {
  "detail": String,
  "message": String
}

    データタイプ: オブジェクト
    error.detail 要求エラーに関するその他の詳細。
    考えられる結果:
    • API レベルの ACL 検証に失敗しました:ユーザーにリソースへの読み取り/書き込みアクセス権がありません。
    • AP の 1 時間あたり 13 リクエストのレート制限を超えました 請求書 – バッチ内のレコード数がバッチサイズの設定を超えています。
    • 認証情報の入力を要求 - パスワードまたはユーザー名が間違っています。

    データタイプ：文字列
    error.message 要求が失敗した理由を含むエラーメッセージ
    考えられるエラー:
    • 無効なペイロード:無効なコンテンツタイプ。
    • 無効なペイロード:エラー:無効なペイロード構造です。
    • 無効なペイロード:エラー:ペイロードがバッチで許可される請求書の制限を超えています。バッチ内のレコード数がバッチサイズの設定を超えています。デフォルトの最大ペイロードサイズは 100 レコードです。この値は、 sn_spend_intg.ap.invoice.create.api.record_limit システムのプロパティで構成できます。
    • 無効なペイロード:エラー:請求書が空です。処理するデータがありません。バッチ内のレコード数が 0 である。
    • APO 請求書取り込みの 1 時間あたり 500 要求のレート制限を超えました。
    • ユーザーが認証されていません。パスワードまたはユーザー名が間違っています。
    • API レベルの ACL 検証に失敗しました:ユーザーにリソースへの読み取り/書き込みアクセス権がありません。

    データタイプ：文字列
    メッセージ 成功メッセージ (例: 要求が正常に受信され、処理中です。

    要求のステータスは、請求書統合ログ [sn_spend_intg_invoice_integration_log] テーブルで確認できます。

    データタイプ：文字列
    ステータス 要求の結果を示します。
    可能な値：
    • 成功
    • 失敗

    データタイプ：文字列

    cURL 要求

    次の例は、JSON 形式で要求として提供された請求書を処理する方法を示しています。

    curl "https://instance.servicenow.com/api/sn_spend_intg/v1/ap_invoice/json" \
--request \
 POST \
--header \
 "Source-System: Coupa" \
--header \
 "Content-Type: application/json" \
--user 'username' \
:'password' \
--data \
 '{
    "invoices": [
        {
            "invoice_type": "non_po_invoice",
            "supplier_invoice_number": "SPOTLIGHT98",
            "external_invoice_number": "SPOTLIGHT98",
            "erp_number": "RTest12345",
            "purchase_order": "R0030R16537",
            "business_owner": "paula.smith@example.com",
            "supplier": "3245545",
            "original_invoice": "SIN188191",
            "invoice_date": "2023-08-15",
            "payment_terms": "Net 30",
            "legal_entity": "1000",
            "subtotal": "100.00",
            "shipping_amount": "50.00",
            "other_charges": "20.00",
            "discounts": "100.00",
            "amount_invoiced": "150.00",
            "currency": "USD",
            "invoice_line_count": "2",
            "ship_to_city": "",
            "ship_to_country": "USA",
            "ship_to_state_or_province": "NY",
            "ship_to_street": "123 Main St",
            "ship_to_zip_or_postal_code": "10001",
            "ship_from_city": "Los Angeles",
            "ship_from_country": "USA",
            "ship_from_state_or_province": "CA",
            "ship_from_street": "456 Oak Ave",
            "ship_from_zip_or_postal_code": "90001",
            "remit_address": "789 Elm St, Suite 200",
            "remit_to_city": "Chicago",
            "remit_to_country": "USA",
            "remit_to_state_or_province": "IL",
            "remit_to_zip_or_postal_code": "60601",
            "bill_to_city": "San Diego",
            "bill_to_country": "USA",
            "bill_to_state_or_province": "CA",
            "bill_to_street": "4810 Eastgate Mall",
            "bill_to_zip_or_postal_code": "92121",
            "supplier_tax_id": "123456789",
            "tax_details": [
                {
                    "tax_type": "Central Goods and Services Tax",
                    "tax_amount": "25",
                    "tax_rate": ""
                },
                {
                    "tax_type": "Sales tax",
                    "tax_amount": "10",
                    "tax_rate": "10"
                },
                {
                    "tax_type": "IGST",
                    "tax_amount": "",
                    "tax_rate": "15"
                },
                {
                    "tax_type": "State Goods and Service Tax",
                    "tax_amount": "20",
                    "tax_rate": "10"
                }
            ],
            "invoice_lines": [
                {
                    "external_invoice_number": "SPOTLIGHT98",
                    "line_description": "Laptop",
                    "line_quantity": "5",
                    "line_unit_price": "20.00",
                    "subtotal": "100.00",
                    "line_amount_invoiced": "100.00",
                    "purchase_order_line": "232432",
                    "po_line_description": "Mac laptop",
                    "currency": "USD",
                    "cost_center": "41605600",
                    "gl_account": "141101",
                    "tax_code": "A0 - Sales tax, standard rate",
                    "ship_to_city": "New York",
                    "ship_to_country": "USA",
                    "ship_to_state_or_province": "NY",
                    "ship_to_street": "123 Main St",
                    "ship_to_zip_or_postal_code": "10001",
                    "supplier_part_number": "SPN-001",
                    "uom": "Hours",
                    "tax_details": [
                        {
                            "tax_type": "Central Goods and Services Tax",
                            "tax_amount": "25",
                            "tax_rate": ""
                        },
                        {
                            "tax_type": "Sales tax",
                            "tax_amount": "",
                            "tax_rate": "10"
                        }
                    ]
                },
                {
                    "external_invoice_number": "SPOTLIGHT98",
                    "line_description": "Charger",
                    "line_quantity": "5",
                    "line_unit_price": "40.00",
                    "subtotal": "200.00",
                    "line_amount_invoiced": "200.00",
                    "purchase_order_line": "232432",
                    "po_line_description": "Mac laptop",
                    "currency": "USD",
                    "cost_center": "41605600",
                    "gl_account": "141101",
                    "tax_code": "A0 - Sales tax, standard rate",
                    "ship_to_city": "New York",
                    "ship_to_country": "USA",
                    "ship_to_state_or_province": "NY",
                    "ship_to_street": "123 Main St",
                    "ship_to_zip_or_postal_code": "10001",
                    "supplier_part_number": "SPN-001",
                    "uom": "Hours",
                    "tax_details": [
                        {
                            "tax_type": "Central Goods and Services Tax",
                            "tax_amount": "25",
                            "tax_rate": ""
                        },
                        {
                            "tax_type": "Sales tax",
                            "tax_amount": "",
                            "tax_rate": "10"
                        }
                    ]
                }
            ]
        }
    ],
    "target_erp": ""
}'

    次の結果は、要求が成功し、請求書データが処理されていることを示しています。要求のステータスは、請求書統合ログ [sn_spend_intg_invoice_integration_log] テーブルで確認できます。[バッチ ID] 列にリストされているバッチ ID を使用して、請求書を検索します。

    {
    "batchId": "APIINV1729711710733280",
    "status": "Success",
    "message": "Your request has been successfully received and is being processed."
}

    AP 請求書 – POST sn_spend_intg/ap_invoice/xml

    自動請求書を XML 形式で処理します。

    請求書統合フィールドマッピング [sn_spend_intg_invoice_intg_field_mapping] テーブルを使用して、フィールドを XML タグにマッピングする方法を決定します。

    要求本文のカスタム請求書フィールドを定義できます。次のフローを使用して、カスタムフィールドを追加し、ターゲットテーブルにマッピングして、ペイロードで使用できるようにフォーマットします。
    1. 請求書インポートのカスタムフィールドを追加
    2. ソーステーブルとターゲットテーブルの間でカスタムフィールドをマッピングする
    3. カスタムフィールドをペイロードソース形式にマップする

    URL 形式

    バージョニングされた URL: /api/sn_spend_intg/v1/ap_invoice/xml

    デフォルト URL: /api/sn_spend_intg/ap_invoice/xml

    サポートされている要求パラメーター

    表 : 13. パスパラメーター
    名前 説明
    api_version オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。

    データタイプ：文字列
    表 : 14. クエリパラメーター
    名前 説明
    なし
    表 : 15. 要求本文要素 (XML)
    パス 説明
    /請求書/AmountInvoiced 税金と配送料を含むサプライヤーに支払われる合計金額。

    ターゲットフィールド:u_amount_invoiced

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    請求書/請求先市区町村 請求書の送信先の市区町村。

    ターゲットフィールド:u_bill_to_city

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /請求書/BillToCountry 請求書の送信先の国 (ISO 3166 形式)。たとえば、 US です。

    ターゲットフィールド:u_bill_to_country

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /請求書/BillToStateOrProvince 請求書の送信先の都道府県。

    ターゲットフィールド:u_bill_to_state_or_province

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /請求書/BillToStreet 請求書の送信先の番地。

    ターゲットフィールド:u_bill_to_street

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /Invoice/BillToZipOrPostalCode 請求書の送信先の郵便番号。

    ターゲットフィールド:u_bill_to_zip_or_postal_code
    /請求書/通貨 必須です。小計、税、および送料の通貨。小計、税、および送料は同じ通貨である必要があります。

    ターゲットフィールド:u_currency

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /請求書/日付形式 請求書の日付形式をデフォルトの YYYY-MM-DD から別のサポートされている日付形式に設定します。日付値は InvoiceDate 要素に設定されます。
    サポートされている日付形式:
    • DD MMM YYYY
    • DD MMM、YY
    • DD MMM、yyyy
    • DD MMMM YYYY
    • DD MMMM、YY
    • DD MMMM、YYYY
    • DD-MM-YY
    • DD-MM-YYYY
    • DD-MMM-YY
    • DD-MMM-YYYY
    • DD.MM.YY
    • DD.MM.YYYY
    • DD/MM/YY
    • DD/MM/YYYY
    • dd/mmm/yyyy
    • MM-DD-YY
    • MM-DD-YYYY
    • MM.DD.YY
    • MM.DD.YYYY
    • MM/DD/YY
    • MM/DD/YYYY
    • MMM DD YYYY
    • MMM DD、YY
    • MMM DD、YYYY
    • MMMM DD YYYY
    • MMMM DD、YY
    • MMMM DD、YYYY
    • YY-MM-DD
    • YYです。MM.DD
    • YY/MM/DD
    • YYYY-MM-DD (デフォルト)
    • YYYYです。MM.DD
    • YYYY/MM/DD
    注:
    MMM 形式のエントリは、最初の 3 文字で月を表します (例: 8 月)。MMMM 形式のエントリは、8 月など、完全な月の名前を表します。

    ターゲットフィールド:u_date_format

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    デフォルト形式:YYYY-MM-DD
    /請求書/割引 請求書に適用される割引。

    ターゲットフィールド:u_discounts

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /請求書/外部請求書番号 サードパーティアプリケーションによって生成された請求書番号。

    ターゲットフィールド:u_external_invoice_number

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /請求書/請求書日付 顧客が請求された日付。DateFormat 要素を使用して、サポートされているデフォルト以外の形式で日付を追加します。

    ターゲットフィールド:u_invoice_date

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]

    デフォルト形式:YYYY-MM-DD
    /請求書/LegalEntity サプライヤーの法人の名前。法人 [sn_fin_legal_entity] テーブルにあります。

    ターゲットフィールド:u_legal_entity

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /請求書/OtherCharges 請求書に関連するその他の追加料金。これは編集可能なフィールドです。

    ターゲットフィールド:u_other_charges

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /請求書/支払条件 サプライヤーへの支払いが行われる合意された時期および条件。たとえば、「 Net 30」などです。

    ターゲットフィールド:u_payment_terms

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /請求書/送金先住所 支払先の番地。

    ターゲットフィールド:u_remit_address
    請求書/送金先市区町村 支払先の市区町村。

    ターゲットフィールド:u_remit_to_city
    /請求書/送金国 支払い先の国 (ISO 3166 形式)。たとえば、 US です。

    ターゲットフィールド:u_remit_to_country
    /請求書/RemitToStateOrProvince 支払先の都道府県。

    ターゲットフィールド:u_remit_to_state_or_province
    /請求書/RemitToZipOrPostalCode 支払先の郵便番号。

    ターゲットフィールド:u_remit_to_zip_or_postal_code
    /請求書/ShipFromCity 発注書の品目の配送元の市区町村。

    ターゲットフィールド:u_ship_from_city

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /Invoice/ShipFromCountry 発注書の品目の配送元の国。

    ターゲットフィールド:u_ship_from_country

    関連テーブル:請求書明細行 [sn_spend_intg_imp_invoice]
    /請求書/ShipFromStateOrProvince 発注書の品目の配送元の都道府県。

    ターゲットフィールド:u_ship_from_state_or_province

    関連テーブル:請求書明細行 [sn_spend_intg_imp_invoice]
    /請求書/ShipFromStreet 発注書の品目の配送元の番地。

    ターゲットフィールド:u_ship_from_street

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /Invoice/ShipFromZipOrPostalCode 発注書の品目の配送元の郵便番号。

    ターゲットフィールド:u_ship_from_zip_or_postal_code

    関連テーブル:請求書明細行 [sn_spend_intg_imp_invoice]
    /請求書/送料 購入全体の合計送料。

    ターゲットフィールド:u_shipping_amount

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /請求書/小計 税金と配送料を除いたサプライヤーに支払われる合計金額。

    ターゲットフィールド:u_subtotal

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /請求書/サプライヤー 顧客が注文できるリセラーまたはサプライヤーの識別子。

    ターゲットフィールド:u_supplier

    関連テーブル:請求書のインポート [sn_spend_intg_imp_invoice]
    /請求書明細/コストセンター 請求書が生成されるコストセンターのアカウント番号。コストセンター [cmn_cost_center] テーブルにリストされます。

    ターゲットフィールド:u_cost_center
    /InvoiceLine/通貨 品目の通貨。例:USD。

    ターゲットフィールド:u_currency

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    /InvoiceLine/GLAccount 請求書の生成に使用される総勘定元帳 (GL) のアカウント番号。

    ターゲットフィールド:u_gl_account

    関連項目：
    /InvoiceLine/LineAmountInvoiced 特定の発注明細に対して顧客に請求される総コスト (税と送料を除く)。

    ターゲットフィールド:u_line_amount_invoiced

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    /InvoiceLine/LineDescription 請求書明細行の説明。

    ターゲットフィールド:u_line_description
    /InvoiceLine/LineQuantity 顧客への請求対象となる、物品またはサービスの数量。

    ターゲットフィールド:u_line_quantity
    /InvoiceLine/LineUnitPrice 請求書の項目の単価。

    ターゲットフィールド:u_line_unit_price

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    /InvoiceLine/POLineDescription 請求書の発注明細の説明。

    ターゲットフィールド:u_po_line_description

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    /InvoiceLine/PurchaseOrderLine この注文に対して顧客から提供された発注書番号。発注書 [sn_shop_purchase_order] テーブルにリストされている。

    ターゲットフィールド:u_purchase_order

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    /InvoiceLine/ShipToCity 発注書の品目の配送先の市区町村。

    ターゲットフィールド:u_ship_to_city

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    /InvoiceLine/ShipToCountry 発注書の品目の配送先の国。

    ターゲットフィールド:u_ship_to_country

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    /InvoiceLine/ShipToStateOrProvince 発注書の品目の配送先の都道府県。

    ターゲットフィールド:u_ship_to_state_or_province
    /InvoiceLine/ShipToStreet 発注書の品目の配送先の番地。

    ターゲットフィールド:u_ship_to_street

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    /InvoiceLine/ShipToZipOrPostalCode 発注書の品目の配送先の郵便番号。

    ターゲットフィールド:u_ship_to_zip_or_postal_code

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    /InvoiceLine/小計 税金と配送料を除いたサプライヤーに支払われる合計金額。

    ターゲットフィールド:u_subtotal

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    /InvoiceLine/SupplierPartNumber この請求書明細行に対してサプライヤーによって生成される部品番号。

    ターゲットフィールド:u_supplier_part_number

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    /請求書明細/税コード ERP ソースから生成された一意の税コード。

    ターゲットフィールド:u_tax_code

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    /請求書明細行/UOM 請求書の品目を計数するために使用される基本測定単位 (UOM)。

    ターゲットフィールド:u_uom

    関連テーブル:請求書項目インポート [sn_spend_intg_imp_invoice_line]
    /税の詳細/税タイプ 請求書に適用される税のタイプ。税タイプ [sn_fin_tax_type] テーブルに表示されます。

    ターゲットフィールド:u_tax_type

    関連テーブル:請求書税項目インポート [sn_spend_intg_imp_invoice_tax_line]
    /TaxDetail/TaxRate サプライヤーが請求する税率。

    関連テーブル:請求書税項目インポート [sn_spend_intg_imp_invoice_tax_line]

    ターゲットフィールド:u_supplier_tax_rate

    関連テーブル:請求書税項目インポート [sn_spend_intg_imp_invoice_tax_line]

    ヘッダー

    次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 16. 要求ヘッダー
    ヘッダー 説明
    Content-Type 要求本文のデータ形式。application/xml のみをサポートします。
    ソースシステム 要求の送信元のソースシステムを指定します。

    利用可能なシステムは、ソースシステムの認証情報 [sn_spend_intg_source_system_credential] テーブルに一覧表示されます。

    この設定は、指定された要求が請求書統合フィールドマッピング [sn_spend_intg_invoice_intg_field_mapping] テーブルの構造に従っているかどうかを判断するのに役立ちます。

    この設定は、ソースシステム認証情報 [sn_spend_intg_source_system_credential] テーブルから認証情報をフェッチするためにも使用されます。
    表 : 17. 応答ヘッダー
    ヘッダー 説明
    なし

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 18. ステータスコード
    ステータスコード 説明
    202 要求が承認されました。要求が成功し、請求書の処理が進行中です。
    400 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。
    429 要求が多すぎます。要求レートが 1 時間あたり最大 10 件の要求を超えました。

    応答本文のパラメーター

    名前 説明
    batch_id バッチ要求の一意の識別子。この ID は、要求のステータスを追跡するために使用できます。このレコードは、請求書統合ログ [sn_spend_intg_invoice_integration_log] テーブルに保存されます。

    データタイプ：文字列
    エラー 要求が失敗した場合のエラーメッセージと詳細が含まれます。
    {
  "detail": String,
  "message": String
}

    データタイプ: オブジェクト
    error.detail 要求エラーに関するその他の詳細。
    考えられる結果:
    • API レベルの ACL 検証に失敗しました:ユーザーにリソースへの読み取り/書き込みアクセス権がありません。
    • AP の 1 時間あたり 13 リクエストのレート制限を超えました 請求書 – バッチ内のレコード数がバッチサイズの設定を超えています。
    • 認証情報の入力を要求 - パスワードまたはユーザー名が間違っています。

    データタイプ：文字列
    error.message 要求が失敗した理由を含むエラーメッセージ
    考えられるエラー:
    • 無効なペイロード:無効なコンテンツタイプ。
    • 無効なペイロード:エラー:無効なペイロード構造です。
    • 無効なペイロード:エラー:ペイロードがバッチで許可される請求書の制限を超えています。バッチ内のレコード数がバッチサイズの設定を超えています。デフォルトの最大ペイロードサイズは 100 レコードです。この値は、 sn_spend_intg.ap.invoice.create.api.record_limit システムのプロパティで構成できます。
    • 無効なペイロード:エラー:請求書が空です。処理するデータがありません。バッチ内のレコード数が 0 である。
    • APO 請求書取り込みの 1 時間あたり 500 要求のレート制限を超えました。
    • ユーザーが認証されていません。パスワードまたはユーザー名が間違っています。
    • API レベルの ACL 検証に失敗しました:ユーザーにリソースへの読み取り/書き込みアクセス権がありません。

    データタイプ：文字列
    メッセージ 成功メッセージ (例: 要求が正常に受信され、処理中です。

    要求のステータスは、請求書統合ログ [sn_spend_intg_invoice_integration_log] テーブルで確認できます。

    データタイプ：文字列
    ステータス 要求の結果を示します。
    可能な値：
    • 成功
    • 失敗

    データタイプ：文字列

    cURL 要求

    次の例は、XML 形式で要求として提供された請求書を処理する方法を示しています。

    curl -X POST https://instance.servicenow.com/api/sn_spend_intg/v1/ap_invoice/xml \
-H "Source-System: Ariba" \
-H "Content-Type: application/json" \
-d '<Invoices>
    <Invoice>
        <InvoiceType>invoice</InvoiceType>
        <SupplierInvoiceNumber>S-432432425</SupplierInvoiceNumber>
        <ExternalInvoiceNumber>EXT-INV-003</ExternalInvoiceNumber>
        <Supplier>3245545</Supplier>
        <PurchaseOrder>0004511198</PurchaseOrder>
        <BusinessOwner>Paula Smith</BusinessOwner>
        <InvoiceDate>2023-09-02</InvoiceDate>
        <PaymentTerms>Net 60</PaymentTerms>
        <OriginalInvoice></OriginalInvoice>
        <LegalEntity></LegalEntity>
        <Subtotal>23985.00</Subtotal>
        <ShippingAmount>750.00</ShippingAmount>
        <OtherCharges></OtherCharges>
        <Discounts></Discounts>
        <AmountInvoiced>27073.54</AmountInvoiced>
        <Currency>USD</Currency>
        <InvoiceLineCount>2</InvoiceLineCount>
        <ShipToCity>Los Angeles</ShipToCity>
        <ShipToCountry>USA</ShipToCountry>
        <ShipToStateOrProvince>CA</ShipToStateOrProvince>
        <ShipToStreet>456 Oak Ave</ShipToStreet>
        <ShipToZipOrPostalCode>90001</ShipToZipOrPostalCode>
        <ShipFromCity>Addison</ShipFromCity>
        <ShipFromCountry>USA</ShipFromCountry>
        <ShipFromStateOrProvince>TX</ShipFromStateOrProvince>
        <ShipFromStreet>15725 Dallas P</ShipFromStreet>
        <ShipFromZipOrPostalCode>55555</ShipFromZipOrPostalCode>
        <RemitAddress>47 W 11th St</RemitAddress>
        <RemitToCity>New York</RemitToCity>
        <RemitToCountry>USA</RemitToCountry>
        <RemitToStateOrProvince>NY</RemitToStateOrProvince>
        <RemitToZipOrPostalCode>99999</RemitToZipOrPostalCode>
        <BillToStreet>4810 Eastgate Mall</BillToStreet>
        <BillToCity>San Diego</BillToCity>
        <BillToCountry>USA</BillToCountry>
        <BillToStateOrProvince>CA</BillToStateOrProvince>
        <BillToZipOrPostalCode>92121</BillToZipOrPostalCode>
        <SupplierTaxID>7894328742</SupplierTaxID>
        <TaxDetails>
            <TaxDetail>
                <TaxType>CGST</TaxType>
                <TaxAmount></TaxAmount>
                <TaxRate>15</TaxRate>
            </TaxDetail>
            <TaxDetail>
                <TaxType>SGST</TaxType>
                <TaxAmount>100</TaxAmount>
                <TaxRate></TaxRate>
            </TaxDetail>
        </TaxDetails>
        <InvoiceLines>
            <InvoiceLine>
                <ExternalInvoiceNumber>EXT-INV-002</ExternalInvoiceNumber>
                <LineDescription>NowX Laptop</LineDescription>
                <PurchaseOrderLine></PurchaseOrderLine>
                <LineQuantity>15</LineQuantity>
                <LineUnitPrice>1500.00</LineUnitPrice>
                <Subtotal>22500.00</Subtotal>
                <LineAmountInvoiced>24693.75</LineAmountInvoiced>
                <Currency>USD</Currency>
                <CostCenter></CostCenter>
                <GLAccount></GLAccount>
                <TaxCode></TaxCode>
                <ShipToCity></ShipToCity>
                <ShipToCountry></ShipToCountry>
                <ShipToStateOrProvince></ShipToStateOrProvince>
                <ShipToStreet></ShipToStreet>
                <ShipToZipOrPostalCode></ShipToZipOrPostalCode>
                <SupplierPartNumber></SupplierPartNumber>
                <UOM>Individual Unit</UOM>
                <TaxDetails>
                    <TaxDetail>
                        <TaxType>WHTTax</TaxType>
                        <TaxAmount>2193.75</TaxAmount>
                        <TaxRate>9.75</TaxRate>
                    </TaxDetail>
                </TaxDetails>
            </InvoiceLine>
            <InvoiceLine>
                <ExternalInvoiceNumber>EXT-INV-002</ExternalInvoiceNumber>
                <LineDescription>NowX Charger</LineDescription>
                <PurchaseOrderLine>PO-6789-001</PurchaseOrderLine>
                <LineQuantity>15</LineQuantity>
                <LineUnitPrice>99.00</LineUnitPrice>
                <Subtotal>1485.00</Subtotal>
                <LineAmountInvoiced>1629.79</LineAmountInvoiced>
                <Currency>USD</Currency>
                <CostCenter></CostCenter>
                <GLAccount></GLAccount>
                <TaxCode></TaxCode>
                <ShipToCity></ShipToCity>
                <ShipToCountry></ShipToCountry>
                <ShipToStateOrProvince></ShipToStateOrProvince>
                <ShipToStreet></ShipToStreet>
                <ShipToZipOrPostalCode></ShipToZipOrPostalCode>
                <SupplierPartNumber></SupplierPartNumber>
                <UOM>Individual Unit</UOM>
                <TaxDetails>
                    <TaxDetail>
                        <TaxType>GSTTax</TaxType>
                        <TaxAmount>144.79</TaxAmount>
                        <TaxRate>9.75</TaxRate>
                    </TaxDetail>
                    <TaxDetail>
                        <TaxType>CGST</TaxType>
                        <TaxAmount>1000</TaxAmount>
                        <TaxRate>12</TaxRate>
                    </TaxDetail>
                </TaxDetails>
            </InvoiceLine>
        </InvoiceLines>
    </Invoice>
    <Invoice>
        <InvoiceType>invoice</InvoiceType>
        <SupplierInvoiceNumber>S-432432426</SupplierInvoiceNumber>
        <ExternalInvoiceNumber>EXT-INV-006</ExternalInvoiceNumber>
        <Supplier>3245545</Supplier>
        <PurchaseOrder>0004511198</PurchaseOrder>
        <BusinessOwner>Paula Smith</BusinessOwner>
        <InvoiceDate>2023-09-02</InvoiceDate>
        <PaymentTerms>Net 60</PaymentTerms>
        <OriginalInvoice></OriginalInvoice>
        <LegalEntity></LegalEntity>
        <Subtotal>23985.00</Subtotal>
        <ShippingAmount>750.00</ShippingAmount>
        <OtherCharges></OtherCharges>
        <Discounts></Discounts>
        <AmountInvoiced>27073.54</AmountInvoiced>
        <Currency>USD</Currency>
        <InvoiceLineCount>2</InvoiceLineCount>
        <ShipToCity>Los Angeles</ShipToCity>
        <ShipToCountry>USA</ShipToCountry>
        <ShipToStateOrProvince>CA</ShipToStateOrProvince>
        <ShipToStreet>456 Oak Ave</ShipToStreet>
        <ShipToZipOrPostalCode>90001</ShipToZipOrPostalCode>
        <ShipFromCity>Addison</ShipFromCity>
        <ShipFromCountry>USA</ShipFromCountry>
        <ShipFromStateOrProvince>TX</ShipFromStateOrProvince>
        <ShipFromStreet>15725 Dallas P</ShipFromStreet>
        <ShipFromZipOrPostalCode>55555</ShipFromZipOrPostalCode>
        <RemitAddress>47 W 11th St</RemitAddress>
        <RemitToCity>New York</RemitToCity>
        <RemitToCountry>USA</RemitToCountry>
        <RemitToStateOrProvince>NY</RemitToStateOrProvince>
        <RemitToZipOrPostalCode>99999</RemitToZipOrPostalCode>
        <BillToStreet>4810 Eastgate Mall</BillToStreet>
        <BillToCity>San Diego</BillToCity>
        <BillToCountry>USA</BillToCountry>
        <BillToStateOrProvince>CA</BillToStateOrProvince>
        <BillToZipOrPostalCode>92121</BillToZipOrPostalCode>
        <SupplierTaxID>7894328742</SupplierTaxID>
        <TaxDetails>
            <TaxDetail>
                <TaxType>VATTax</TaxType>
                <TaxAmount>2338.54</TaxAmount>
                <TaxRate></TaxRate>
            </TaxDetail>
        </TaxDetails>
        <InvoiceLines>
            <InvoiceLine>
                <ExternalInvoiceNumber>EXT-INV-002</ExternalInvoiceNumber>
                <LineDescription>NowX Laptop</LineDescription>
                <PurchaseOrderLine></PurchaseOrderLine>
                <LineQuantity>15</LineQuantity>
                <LineUnitPrice>1500.00</LineUnitPrice>
                <Subtotal>22500.00</Subtotal>
                <LineAmountInvoiced>24693.75</LineAmountInvoiced>
                <Currency>USD</Currency>
                <CostCenter></CostCenter>
                <GLAccount></GLAccount>
                <TaxCode></TaxCode>
                <ShipToCity></ShipToCity>
                <ShipToCountry></ShipToCountry>
                <ShipToStateOrProvince></ShipToStateOrProvince>
                <ShipToStreet></ShipToStreet>
                <ShipToZipOrPostalCode></ShipToZipOrPostalCode>
                <SupplierPartNumber></SupplierPartNumber>
                <UOM>Individual Unit</UOM>
                <TaxDetails>
                </TaxDetails>
            </InvoiceLine>
            <InvoiceLine>
                <ExternalInvoiceNumber>EXT-INV-002</ExternalInvoiceNumber>
                <LineDescription>NowX Charger</LineDescription>
                <PurchaseOrderLine>PO-6789-001</PurchaseOrderLine>
                <LineQuantity>15</LineQuantity>
                <LineUnitPrice>99.00</LineUnitPrice>
                <Subtotal>1485.00</Subtotal>
                <LineAmountInvoiced>1629.79</LineAmountInvoiced>
                <Currency>USD</Currency>
                <CostCenter></CostCenter>
                <GLAccount></GLAccount>
                <TaxCode></TaxCode>
                <ShipToCity></ShipToCity>
                <ShipToCountry></ShipToCountry>
                <ShipToStateOrProvince></ShipToStateOrProvince>
                <ShipToStreet></ShipToStreet>
                <ShipToZipOrPostalCode></ShipToZipOrPostalCode>
                <SupplierPartNumber></SupplierPartNumber>
                <UOM>Individual Unit</UOM>
                <TaxDetails>
                </TaxDetails>
            </InvoiceLine>
        </InvoiceLines>
    </Invoice>
    <TargetERP>ERP1</TargetERP>
</Invoices>'

    次の結果は、要求が成功し、請求書データが処理されていることを示しています。要求のステータスは、請求書統合ログ [sn_spend_intg_invoice_integration_log] テーブルで確認できます。[バッチ ID] 列にリストされているバッチ ID を使用して、請求書を検索します。

    {
    "batchId": "APIINV1736249646168148",
    "status": "Success",
    "message": "Your request has been successfully received and is being processed."
}