サプライヤーAPI（/サプライヤー）

最後の更新
PDFとして保存

このページは機械翻訳を使用して翻訳されています。

概要

サプライヤーAPIを使用して、Coupaでサプライヤーを作成、更新、クエリします。

サプライヤーにアクセスするためのURLは：https://<instance>/api/suppliers

詳細については、統合のベストプラクティスを参照してください。

APIオブジェクト

アクション

サプライヤーAPIを使用すると、以下のことができます。

動詞	パス	アクション	説明
投稿	`/api/suppliers`	作成	サプライヤーを作成
投稿	`/api/suppliers/create_supplier_user_preferences`	create_supplier_user_preferences	サプライヤーのユーザー設定を作成
GET	`/api/suppliers`	インデックス	サプライヤーに問い合わせ
削除	`/api/suppliers/logout_iframe_session`	logout_iframe_session	ログアウト（CSP）iframeセッション
GET	`/api/suppliers/:id`	表示	サプライヤーを表示
投稿	`/api/suppliers/sync_supplier_user_locale`	sync_supplier_user_locale	サプライヤーユーザーロケールを同期
置く	`/api/suppliers/:id`	更新	サプライヤーの更新

要素

以下の要素がサプライヤーAPIで利用可能です：

要素	説明	必須フィールド	一意ですか？	許容値	Api_Inフィールド？	Api_Outフィールド？	データタイプ
account_number	アカウント番号				はい	はい	string型
変更要求を許可	サプライヤーはCSPから変更リクエストを作成できます				はい	はい	ブール値
2要素を含まないcspアクセスを許可	サプライヤーが2要素なしでCSPから顧客のデータにアクセスすることを許可しますCSP				はい	はい	ブール値
allow-cxml-invoicing	サプライヤーのcXML請求を許可する				はい	はい	ブール値
allow-inv-choose-billing-account	請求を許可するアカウントの選択を許可				はい	はい	ブール値
allow-inv-from-connect	はいの場合、サプライヤーはCSNでPOまたは契約に対してインボイスを作成できます。 CSP				はい	はい	ブール値
allow-inv-no-backing-doc-from-connect	はいの場合、サプライヤーはCSNで裏付けのPOまたは契約なしでインボイスを作成できます。CSP				はい	はい	ブール値
allow-inv-unbacked-lines-from-connect	はいの場合、サプライヤーはCSNで裏付けのPOまたは契約なしでインボイスを作成できます。CSP				はい	はい	ブール値
business_groups	ビジネスグループ				はい	はい	ContentGroup
バイヤーホールド	購入者のレビューが掲載されるまですべてのPOを保留				はい	はい	ブール値
contacts		no	no	任意	はい		サプライヤー情報問い合わせ先
commodity	ドロップダウンから選択可能なデフォルト商品				はい	はい
企業URL	企業URL				はい		string型
coupa_connect_secret	Coupa接続シークレット					はい	string型
created-at	「YYYY-MM-DDTHH:MM:SS+HH:MMZ」の形式で、Coupaによって自動的に作成されます					はい	日時
created_by	作成したユーザー					はい	ユーザー
cxml_domain	送信元、当社ドメイン cXMLドメイン	はい			はい	はい	文字列（255）
cxml_http_password	cXML HTTPパスワード				はい
cxml-http-username	cXML HTTPユーザー名				はい	はい	string型
cxml_identity	「送信元」、当社ID cXML ID	はい			はい	はい	文字列（255）
cxml-invoice-buyer-domain	cXMLインボイス発行のための購入者ドメイン	はい			はい	はい	string型
cxml-invoice-buyer-identity	cXMLインボイス発行のための購入者ID	はい			はい	はい	string型
cxml_invoice_secret	cXMLインボイス発行認証の秘密キー	はい			はい	はい	string型
cxml-invoice-supplier-domain	cXMLインボイス発行のためのサプライヤードメイン	はい			はい	はい	string型
cxml-invoice-supplier-identity	cXMLインボイス発行のためのサプライヤーID	はい	はい		はい	はい	string型
cxml-protocol	送信プロトコル	はい			はい	はい	文字列（255）
cxml_secret	共有シークレット	はい			はい	はい	文字列（940）
cxml-ssl-version	cXML SSLバージョン				はい	はい	string型
cxml_supplier_domain	「送信先」、サプライヤードメイン cXMLサプライヤードメイン	はい			はい	はい	文字列（255）
cxml_supplier_identity	「送信先」、サプライヤーID cXMLサプライヤーID	はい			はい	はい	文字列（255）
cxml-url	PO送信が「cXML」の場合にPOが送信されるURL	はい			はい	はい	文字列（255）
デフォルトロケール	このサプライヤーにメールを送信するためのデフォルトロケール	no	no	任意	はい		文字列（255）
disable-cert-verify	証明書認証を無効化				はい	はい	ブール値
表示名	表示名				はい	はい	string型
DUNS	サプライヤーDUNS番号				はい	はい	string型
enterprise	エンタープライズ	真			はい	はい	エンタープライズ

ap-reviews-for-ap-review	このサプライヤーからのインボイスが、APレビューの前に承認されないようにします。				はい		ブール値
id	Coupaの内部ID。					はい	整数
請求書メール	登録されたメールアドレスは、請求書をメールで `invoices@yourhost.coupahost.comに`送信することを許可されています。				はい	はい
請求書照合レベル	インボイスの照合レベル	はい		2点、3点、3点ダイレクト、なし	はい	はい	string型
name	サプライヤー名	はい	はい		はい	はい	文字列（100）
number	サプライヤー番号		はい		はい	はい	string型
保留中	保留中のサプライヤー				はい	はい	ブール値
OnlineStore	サプライヤーのウェブサイト	はい			はい	はい
親	親				はい	はい	サプライヤー
payment-method	既定の支払方法、ドロップダウンから選択可能	はい		invoice、pcard、invoice_only、pcard_only、virtual_card	はい	はい	文字列（255）
payment-term	既定の支払条件、ドロップダウンから選択可能				はい	はい	payment-term
APIの支払期間ID	APIの支払条件ID				はい
po_change_method	発注書変更の送信方法	真	false	cxml、xml、email、prompt、mark_as_sent、buy_online	はい	はい	文字列（255）
po_email	PO送信が「メール」の場合、POが送信されるメールアドレス。	はい			はい	はい	文字列（255）
po_method	発注書の送信方法			cxml、xml、email、prompt、mark_as_sent、buy_online	はい	はい	文字列（255）
primary_address	代表住所	はい		サプライヤーの住所	はい	はい	サプライヤー情報住所
primary_contact	サプライヤーの代表連絡先のメール	はい			はい	はい
remit_to_addresses	支払先住所				はい	はい	支払先住所
制限付きアカウントタイプ	制限付き勘定科目タイプ				はい	はい	account-type
節減率	このサプライヤーの使用による節約				はい	はい	decimal型
請求書を承認に送信	はいの場合、合計金額にかかわらず、インボイスは承認することですべて送信されます。				はい	はい	ブール値
scf-configs	サプライヤー向けにホワイトリストに登録されたサプライチェーンファイナンス構成				はい	はい	string型
発送期限	サプライヤー発送条件、ドロップダウンから選択可能				はい	はい	ShippingTerm
status	サプライヤーステータス					はい	string型
storefront-url	サプライヤーのウェブサイト				はい		string型
supplier_addresses		no	no	任意	はい		[]
						はい	SupplierSite
サプライヤーステータス	サプライヤーステータス				はい		ドラフト
tax-code	サプライヤー税金コード				はい	はい
納税者番号	サプライヤーDUNS番号				はい	はい	string型
updated-at	「YYYY-MM-DDTHH:MM:SS+HH:MMZ」の形式で、Coupaによって自動的に作成されます					はい	日時
updated_by	更新したユーザー					はい	ユーザー

ウェブサイト	サプライヤーのウェブサイト				はい	はい	string型
ホワイトリスト-dd	動的割引のためにサプライヤーをホワイトリストにサプライヤー向け	false	偽	任意	はい	はい	ブール値
dd-設定	サプライヤーのホワイトリストにサプライヤー向け動的割引設定				はい	はい	string型
顧客サポート連絡先	サプライヤーアカウント所有者（カスタマーサポート連絡先）とその目的のリストが含まれています				はい	はい	[]
多様性	サプライヤー多様性のリスト。			多様性マーカーコードを参照	はい	はい	[]

ソースフィールドからの値に基づいてクエリ可能になる可能性がある依存フィールドがあります。たとえば、po-method = emailに対してクエリを実行する場合、追加のクエリ条件としてpo-emailを追加できます。はい*の付いたフィールドをご覧ください。
大きなデータセットとパフォーマンスの最適化のために、常にいくつかのGET基準で結果を制限します。
サプライヤーのステータスを設定しない場合、システムはデフォルトでドラフトになります。
デフォルトの支払方法を設定しない場合、システムはデフォルトで請求書を発行します。
APIがカスタムフィールドを認識するように、フィールドは設定でAPI編集可能として設定する必要があります。
Coupa Supplier Portal 環境で（CSP）を有効にしている場合、 [サプライヤーにインボイスの作成を許可] フィールドはデフォルトでオンになっています。
サプライヤーの主要住所を更新する場合、住所オブジェクトのすべての属性を更新できますが、異なる住所IDをサプライヤーレコードに関連付けることはできません。
サプライヤーレコードの代表連絡先を更新する場合、連絡先情報のすべての属性を更新できますが、完全に異なる連絡先IDをサプライヤーレコードに割り当てることはできません。

多様性マーカーコード

多様性マーカーコード	説明
MBE	少数民族企業
WBE	女性が経営する企業
SBE	小規模企業
LGBTBE	レズビアン、ゲイ、バイセクシュアル、トランスジェンダー企業
DOB	障害者所有ビジネス
NPO	非営利団体
DBE	不利な企業
SDB	中小企業
SDVBE	退役軍人が経営する企業でのサービスの無効化
WOSB	女性が経営する中小企業
VOB	退役軍人が経営する企業
DVBE	退役軍人企業
SDVOSB	退役軍人が所有する中小企業でのサービスの障害
HUBZone	歴史的に十分に活用されていないビジネスゾーン
SBA8A	SBA-8(A)
ACDBE	空港コンセッション不利な企業
ANC	Alaskan Native Corporation
HBCU	歴史的に黒人の大学または少数大学
LSA	労働余剰エリア
VVO	ベトナムベテラン所有
アビリティーワン	Ability Oneプログラム
EDWOSB	経済的に恵まれない女性所有の中小企業
NAO	ネイティブアメリカンが所有
IOB	先住民が所有する企業
AMS	カナダ - 先住民および少数民族のサプライヤー
BOB	黒人経営
MGOB	マイノリティが経営する企業
EMB	少数民族ビジネス（EMB）