外部発注のインポート

概要

発注書インポートプロセスは、SFTPフォルダからファイルを読み取ります： 。/Incoming/PurchaseOrders/

これらのファイルは、 にあるアーカイブフォルダに移動されます。/Incoming/Archive/PurchaseOrders/ を英数字順に処理します。

Coupaでは、フラットファイル連携を使用して発注書を更新することはできません。

外部発注書に関するよくある質問には、サードパーティシステムから発注書の読み込む際に役立つ情報が多数記載されています。

キー

Supplier Name
Supplier Number

発注書を仮完了するには、発注書をAction = Closeで更新します

発注書を完了するには、同じ発注書に対して再度Action = Closeで更新を行います。

アイテム検索ロジック

Coupaはまず、発送先ユーザーに対するサプライヤーアイテムの中から、サプライヤー品番が一致するものを探します。何も見つからない場合、Coupaは次のベスト サプライヤーアイテム を 発送先ユーザーで検索します。

注:

外部発注書のインポートでは、発送先住所IDがCoupa内の他の住所IDと照合されるようになりました。一致した住所が「サプライヤー住所」や「支払先住所」など別のタイプの場合、 Coupaは「発送先住所が誤っています」というエラーを表示します。

使用可能な値

アクション: Cancel、Close、Reopen、IssueWithSend、IssueWithoutSend、IgnoreWindowsAndIssue
バージョン番号: 指定する場合は、現在の発注書のバージョン番号以上である必要があります。

外部注文ヘッダー


フィールド名	必須フィールド	一意？	フィールドタイプ	フィールドの説明	使用可能な値
ヘッダー	なし	なし		行のタイプ.
アクション	なし	なし		発注明細にに対して実行される処理を指定。
バージョン番号	なし	なし		Coupaのデフォルトのバージョニングルールを上書きできます。詳細については、PO SFTPローダーのドキュメントを参照してください。
発注番号	はい	はい	string(20)	Coupaが既存のPOを変更するか、新しいPOを作成するかを決定するために使用します。
Supplier Name	なし	なし		発注のサプライヤーを識別するために使用されます。このフィールドの代わりにサプライヤー番号を渡すことができますが、Coupaは各POの有効なサプライヤーレコードを識別する必要があります。
Supplier Number	なし	なし		発注のサプライヤーを識別するために使用されます。このフィールドの代わりにサプライヤー名を渡すことができますが、Coupaは各POの有効なサプライヤーレコードを識別する必要があります。
サプライヤーサイトコード	なし	なし		サプライヤーサイトコード
Currency Code	なし	なし		Currency Code
勘定科目表の名前	なし	なし		注文の勘定科目表。 CoAがCoupaに存在し、アクティブである必要があります。
確認レベル	なし	なし		説明が見つかりません
確認期限(時間)	なし	なし	整数	説明が見つかりません	0..87600
支払方法	なし	なし	string(255)	説明が見つかりません
支払条件コード	なし	なし		説明が見つかりません
発送条件コード	なし	なし		発送条件コード
発送先のID	なし	なし		発送先のID
発送先の名前	なし	なし		住所の名前. Coupa上で事前に登録されている必要があります。 Coupaに新規または既存の発送先住所を含める必要があります。
発送先宛名	なし	なし	string(255)	発送先住所の注意。リクエスターまたはCoupaの住所にリンクされた注意のいずれか（デフォルトはリクエスター）。
発送先の住所1	なし	なし		住所欄1に発送します。住所がCoupaに存在しない場合は入力してください。
発送先の住所2	なし	なし		住所欄2に発送します。住所がCoupaに存在しない場合は入力してください。
発送先の市区町村	なし	なし		発送先住所の市区町村. 住所がCoupaに存在しない場合は入力してください。
発送先の都道府県	なし	なし		発送先住所の都道府県。住所がCoupaに存在しない場合は入力してください。
発送先の郵便番号	なし	なし		出荷先住所の郵便番号。住所がCoupaに存在しない場合は入力してください。
発送先の国/地域コード	なし	なし		出荷先住所国コード。 Coupa上で事前に登録されている必要があります。
発送先の国名	なし	なし		発送先の国名
発送先のロケーションコード	なし	なし		出荷先住所国コード。 Coupa上で事前に登録されている必要があります。この値が指定されている場合、発送先住所の残りの値を省略できます。 Coupaは、所在地コードに基づいて出荷先住所を見つけ、すべての住所値を外部注文にコピーします。
発送先の従業員番号	なし	なし		受取人は、発送先の従業員番号、発送先の電子メール、または発送先のログインの少なくとも1つで識別する必要があります。
発送先のメール	なし	なし		受取人は、発送先の従業員番号、発送先の電子メール、または発送先のログインの少なくとも1つで識別する必要があります。
発送先のログイン	なし	なし		受取人は、発送先の従業員番号、発送先の電子メール、または発送先のログインの少なくとも1つで識別する必要があります。
送信方法の上書き	なし	はい	string(30)	送信方法の上書き	supplier_default, email、do_not_transmit
送信メール	なし	なし	テキスト	送信メール
価格を非表示にします。	なし	なし	boolean	サプライヤーに価格を表示しない
ヘッダーでERSを許可する	なし	なし	boolean	ヘッダーでERSを許可する
Line	なし	なし		行のタイプ.
Receiving Warehouse Name	なし	なし		在庫管理用の発注にのみ使用.
Contract Number	なし	なし		契約を識別するために使用。ヘッダー行のサプライヤーに関連付けられている必要があります。契約名でも指定可能。
契約の名前	なし	なし		契約を識別するために使用。ヘッダー行のサプライヤーに関連付けられている必要があります。契約番号でも指定可能。
レコード識別子。	なし	なし		レコード識別子。
明細番号	なし	なし		明細番号
Catalog Item Number	なし	なし		アイテム名の代わりにカタログアイテムを識別するために使用できます。
Catalog Item Name	なし	なし		品目番号の代わりにカタログ品目を識別するために使用できます。
非カタログアイテムの説明	なし	なし		カタログ外アイテムのアイテム説明。
Department Name	なし	なし		説明が見つかりません
サプライヤー品番	なし	なし		サプライヤーアイテムの識別に使用可能。詳細については、発注書SFTPローダーのドキュメントを参照してください.
Supplier Aux Part Number	なし	なし		Supplier Aux Part Number
Quantity	なし	なし		明細の数量(サービスベースの明細の場合は空白).
Price	なし	なし		Price
Need By Date	なし	なし		Need By Date
UOM Code	なし	なし		数量単位のコード。 Coupa上で事前に登録されている必要があります。
品目カテゴリー名	なし	なし		品目カテゴリー名
Asset Tags	なし	なし		Asset Tags
勘定名	なし	なし		勘定名
勘定科目コード	なし	なし		勘定科目コード
Account Segment 1	なし	なし		Account Segment 1
Account Segment 2	なし	なし		Account Segment 2
Account Segment 3	なし	なし		Account Segment 3
Account Segment 4	なし	なし		Account Segment 4
Account Segment 5	なし	なし		Account Segment 5
Account Segment 6	なし	なし		Account Segment 6
Account Segment 7	なし	なし		Account Segment 7
Account Segment 8	なし	なし		Account Segment 8
Account Segment 9	なし	なし		Account Segment 9
Account Segment 10	なし	なし		Account Segment 10
Account Segment 11	なし	なし		Account Segment 11
勘定科目区分12	なし	なし		勘定科目区分12
勘定科目区分13	なし	なし		勘定科目区分13
勘定科目区分14	なし	なし		勘定科目区分14
勘定科目区分15	なし	なし		勘定科目区分15
勘定科目区分16	なし	なし		勘定科目区分16
Account Segment 17	なし	なし		Account Segment 17
勘定科目区分18	なし	なし		勘定科目区分18
Account Segment 19	なし	なし		Account Segment 19
Account Segment 20	なし	なし		Account Segment 20
予算期間名	なし	なし		予算期間名
Bulk Price	なし	なし		Bulk Price
Bulk Price Qty	なし	なし		Bulk Price Qty
Bulk Price UoM Code	なし	なし		バルク価格数量単位コード
バルク価格の変換分子	なし	なし		バルク価格の変換分子
バルク価格の変換分母	なし	なし		バルク価格の変換分母
Reason Insight Event Comment	なし	なし		理由インサイトIDまたはコードが提供されている場合は、コメントが必要です。
Reason Insight ID	なし	なし		理由のインサイトを指定する必要がある場合(開示明細や発注書で必須)、IDまたはコードのいずれかとコメントが必要です。
Reason Insight Code	なし	なし		理由のインサイトを指定する必要がある場合(開示明細や発注書で必須)、IDまたはコードのいずれかとコメントが必要です。
Manufacturer Name	なし	なし		Manufacturer Name
製造業者の部品番号	なし	なし		製造業者の部品番号
勘定科目割当	なし	なし		勘定科目割当
見積税額	なし	なし		見積税額
Percent	なし	なし		Percent
推定税明細	なし	なし		推定税明細
税明細番号	なし	なし		税明細番号
推定税コード	なし	なし		推定税コード
推定税率	なし	なし		推定税率
税参照	なし	なし		税参照
Base Amount	なし	なし		Base Amount
製品分類	なし	なし		製品分類
削除	なし	なし		削除

外部注文明細列


カラム名	Description	必須	一意	Type	許容値
Line	行のタイプ	なし	なし	-	Line
アクション	発注明細にに対して実行される処理を指定。	なし	なし	文字列	delete SoftCloseForReceiving、SoftCloseForInvoicing、ReopenForReceiving、ReopenForInvoicing
Receiving Warehouse Name	在庫管理用の発注にのみ使用	なし	なし	string(255)	any
Contract Number	契約を識別するために使用。ヘッダー行のサプライヤーに関連付けられている必要があります。契約名でも指定可能。	なし	なし	string(50)	any
契約の名前	契約を識別するために使用。ヘッダー行のサプライヤーに関連付けられている必要があります。契約番号でも指定可能。	なし	なし	string (100)	any
レコード識別子。	レコード識別子。	なし	なし		any
明細番号	既存の発注明細を更新する場合はその識別に使用され、新規の発注明細を作成する場合は明細番号として機能します。	なし	なし	string(255)	any
Catalog Item Number	アイテム名の代わりに、カタログアイテムを識別するために使用できます。	なし	なし	string(255)	any
Catalog Item Name	アイテム番号の代わりに、カタログアイテムを識別するために使用できます。	なし	なし	string(255)	any
非カタログアイテムの説明	カタログ外アイテムのアイテム説明。	なし	なし	string(255)	any
Department Name	申請書ローダーと同じ	なし	なし	string(255)	any
サプライヤー品番	サプライヤーアイテムの識別に使用可能。詳細については、発注書SFTPローダーのドキュメントを参照してください	なし	なし	string(255)	any
Quantity	明細の数量(サービスベースの明細の場合は空白)	いいえ*	なし	decimal(30,6)	any
価格	アイテムの単価	はい***	なし	decimal(30,6)	any
Need By Date	納品希望日	なし	なし	datetime	YYYY-MM-DDTHH:MM:SS+HH:MM
UOM Code	数量単位のコード。 Coupa上で事前に登録されている必要があります。	いいえ*	なし	string(6)	any
品目カテゴリー名	品目カテゴリー名. Coupa上で事前に登録されている必要があります。	なし	なし	string(255)	Coupa上で事前に登録されている必要があります
Asset Tags	現在は未使用	なし	なし		any
勘定名	申請書ローダーと同じ	なし	なし	string(100)	any
勘定科目コード	申請書ローダーと同じ	なし	なし	string(2020)	any
Account Segment 1	Account Segment 1	なし	なし	string (100)	any
Account Segment 2	Account Segment 2	なし	なし	string(100)	any
Account Segment 3	Account Segment 3	なし	なし	string(100)	any
Account Segment 4	Account Segment 4	なし	なし	string (100)	any
Account Segment 5	Account Segment 5	なし	なし	string(100)	any
Account Segment 6	Account Segment 6	なし	なし	string(100)	any
Account Segment 7	Account Segment 7	なし	なし	string(100)	any
Account Segment 8	Account Segment 8	なし	なし	string(100)	any
Account Segment 9	Account Segment 9	なし	なし	string(100)	any
Account Segment 10	Account Segment 10	なし	なし	string(100)	any
Account Segment 11	Account Segment 11	なし	なし	string(100)	any
勘定科目区分12	勘定科目区分12	なし	なし	string(100)	any
勘定科目区分13	勘定科目区分13	なし	なし	string(100)	any
勘定科目区分14	勘定科目区分14	なし	なし	string(100)	any
勘定科目区分15	勘定科目区分15	なし	なし	string(100)	any
勘定科目区分16	勘定科目区分16	なし	なし	string(100)	any
Account Segment 17	Account Segment 17	なし	なし	string(100)	any
勘定科目区分18	勘定科目区分18	なし	なし	string(100)	any
Account Segment 19	Account Segment 19	なし	なし	string(100)	any
Account Segment 20	Account Segment 20	なし	なし	string(100)	any
予算期間名	予算期間の名前	なし	なし	string(255)	any
Bulk Price	Bulk Price	なし	なし	decimal(30,6)	any
バルク価格の変換分子	バルク価格の変換分子	なし	なし	decimal(30,6)	any
バルク価格の変換分母	バルク価格の変換分母	なし	なし	decimal(30,6)	any
Bulk Price Qty	Bulk Price Qty	なし	なし	decimal(30,6)	any
Bulk Price UoM Code	Bulk Price UoM Code	なし	なし	int(11)	any
Supplier Aux Part Number	Supplier Aux Part Number	なし	なし		any
Manufacturer Name	Manufacturer Name	なし	なし		any
製造業者の部品番号	製造業者の部品番号	なし	なし		any

非表示の列

これらの列は外部注文明細の行で使用可能ですが、テンプレートには含まれていません。必要に応じて手動で追加できます。


カラム名	Description	必須	一意	Type	許容値
Reason Insight ID	理由のインサイトを指定する必要がある場合(開示明細や発注書で必須)、IDまたはコードのいずれかとコメントが必要です。	True*	false	整数	any
Reason Insight Code	理由のインサイトを指定する必要がある場合(開示明細や発注書で必須)、IDまたはコードのいずれかとコメントが必要です。	True*	false	string(255)	any
Reason Insight Event Comment	理由インサイトIDまたはコードが提供されている場合は、コメントが必要です。	True*	false	string(255)	any

外部発注の勘定科目割当の列


カラム名	Description	必須	一意	Type	許容値
勘定科目割当	行のタイプ	なし	なし	-	勘定科目割当
レコード識別子。		なし	なし		any
明細番号	既存の発注明細を更新する場合はその識別に使用され、新規の発注明細を作成する場合は明細番号として機能します。	なし	なし	string(255)	any
Amount	Amount	なし	なし	decimal(30,3)	any
Percent	Percent	なし	なし	decimal(16,10)	any
勘定名	申請書ローダーと同じ	なし	なし	string(100)	any
勘定科目コード	申請書ローダーと同じ	なし	なし	string (20)	any
勘定科目区分1 - 20	勘定科目区分1～20	なし	なし	string(100)	any
予算期間名	予算期間の名前	なし	なし	string(255)	any

*サービスベースの明細には数量または数量単位はありません

**サプライヤー名またはサプライヤー番号のいずれかが必要です

***このフィールドは、Coupa内のアイテムに値が割り当てられていない場合のみ必須です

すべての明細の発注明細デフォルト


ライン属性	ソース	ソース属性	条件
説明	アイテム	名前
unit_price	CSV	csv_row[ rice]	指定されている場合
unit_price	SupplierItem	価格	CSV値(上記)が空欄の場合
contract	#load_contract	csv_row[:contract_number]またはcsv_row[:contract_name]	名前または番号と一致
contract	SupplierItem	contract	CSV値(上記)が空欄の場合
source_part_num	CSV	csv_row[:supplier_part_number]	指定されている場合
source_part_num	SupplierItem	サプライヤー品番	CSV値(上記)が空欄の場合
サプライヤー予備品番	CSV	csv_row[:supplier_aux_part_number]	指定されている場合
サプライヤー予備品番	SupplierItem	サプライヤー予備品番	CSV値(上記)が空欄の場合
supplier	#load_supplier	サプライヤー	一致する名前または番号と「アクティブ」
supplier_site	CSV	OrderHeader
uom	#load_uom	数量単位	「数量単位コード」と一致
uom	アイテム	数量単位	CSV値(上記)が空欄の場合
commodity	#load_commodity	コモディティ	品目カテゴリー名と一致
currency	OrderHeader	Currency
period	#load_period	BudgetPeriod	AccountType (上記)の「予算期間名」と一致
line_num	CSV	csv_row[:line_number]
quantity	CSV	csv_row[:quantity]
need_by_date	CSV	csv_row[:need_by_date]

自由形式の申請明細のデフォルト


ライン属性	ソース	ソース属性	条件
説明	CSV	csv_row[:non_catalog_item_description]

アイテム検索エラー

次の場合、エラーが返されます。

カタログおよび/または製造業者の詳細がローダー入力に含まれているが、該当するカタログアイテムが見つからない場合。既存のカタログ詳細に一致するが製造業者詳細が異なる場合も含みます。
カタログアイテムが見つからず、非カタログアイテムの説明がローダー入力で空白の場合。
サプライヤーアイテムが見つからない場合。
価格またはバルク価格が見つからない場合。

以下の場合も「カタログアイテムが見つかりません」というエラーメッセージが表示されます。

カタログアイテム番号 または カタログアイテム名 がペイロードに存在しますが、アイテムが見つかりません。
カタログアイテム名 とMFGの詳細がペイロードに存在し、 カタログアイテム名 が選択したアイテムの 名前 と一致しません。
メーカー名 がペイロードに存在し、選択したアイテムに設定されていて一致していません。
製造元部品番号 がペイロードに存在し、選択したアイテムに構成されており、一致していません。

「カタログアイテムが見つかりません」というエラーメッセージは、「[ペイロード内の属性と値のリスト]のカタログアイテムがみつかりません」という形式で表示されます。たとえば、次のようなメッセージが表示されます。「値がABC123のカタログアイテム番号、値がABC 123 ITEMのカタログアイテム名のカタログアイテムが見つかりません」

上記のメッセージに加え、申請書ヘッダーローダーで設定キーcsv_requisition_loader_supplier_item_required? がtrueに設定されている場合、サプライヤーアイテムが一致しないと「サプライヤーアイテムが見つかりません」というエラーが返されます。たとえば、次のようなメッセージが表示されます。「値がABC 123 ITEMのカタログアイテム名、値がSUPP123のサプライヤー品番のサプライヤーアイテムが見つかりません」

Coupa Documentation