cXML発注書

Coupaは、cXML OrderRequestおよびOrderResponseドキュメントをサポートしています。

はじめに

CoupaはcXML規格に準拠しています。 cXMLユーザーズガイド を参照することをお勧めします cXML.org

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.014/cXML.dtd"> <cXML xml:lang="en-US" payloadID="1452186890.009162@ip-10-7-14-126" timestamp="2008-01-07T09:14:50-08:00"> <Header> <From> <Credential domain="duns"> <!--典型的にはサプライヤーが提供する顧客ドメイン、典型的にはDUNS --> <Identity>DELL</Identity> <!--典型的にはサプライヤーが提供する顧客ID、STRING --> </Credential> </From> <To> <Credential domain="Duns"> <!--典型的にはサプライヤーが提供するサプライヤードメイン、-->典型的にはDUNS <Identity>128293714</Identity> 典型的には<!--サプライヤーが提供するサプライヤーID、STRING --> </Credential> </To> <Sender> <Credential domain="duns"> <Identity>DELL</Identity> <!-- FROM --> <Identity>DELL</Identity> <!-- FROM --> </Credential> <UserAgent>Coupa Procurement 1.0</UserAgent> <!-- DON 'T CHANGE --> </Sender> </Header> <Request deploymentMode="production"> <OrderRequest> <OrderRequestHeader orderID="6112" orderDate="2008-01-07T09:14:50-08:00" type="new"> <!-- Coupa SUPPPORTS "NEW" AND "UPDATE" --> <Total> <Money currency="USD">1505.0</Money> <!-- Coupaで設定された通貨コード--> </Total> <ShipTo> <Address isoCountryCode="US" addressID="3119"> <Name xml:lang="en">jmadden</Name> <PostalAddress name="default"> <DeliverTo>j maddedn</DeliverTo> <Street>333 East Hill Dr</Street> <City>san leandro</City> <State>ca</State> <PostalCode>22222</PostalCode> <Country isoCountryCode="US">米国</Country> </PostalAddress> <Email name="default">jmadden@coupa1.com</Email> </Address> </ShipTo> <BillTo> <Address isoCountryCode="US" addressID="142"> <Name xml:lang="en">SOB 1</Name> <!-- COAのPOカスタマイズページの下の会社名-指定されていない場合は、会社情報の下の会社名が使用-->されます <PostalAddress name="default"> <DeliverTo>Noah Sanity Attn: Noah Noah</DeliverTo> <Street>3420 Flatiron Way</Street> <City>West Index</City> <State>NJ</State> <PostalCode>43023</PostalCode> <Country isoCountryCode="US">米国</Country> </PostalAddress> </Address> </BillTo> <Contact role="endUser"> <Name xml:lang="en">j maddedn</Name> <Email name="default">jmadden@coupa1.com</Email> </Contact> <Comments xml:lang="en">ヘッダーコメントは、ユーザー</Comments> </OrderRequestHeader> <ItemOut quantity="1" lineNumber="1"> <ItemID> <SupplierPartID>223 -4511</SupplierPartID> Coupa品目番号 <SupplierPartAuxiliaryID>1005379527029\ 1</SupplierPartAuxiliaryID> 補助<!--部品番号-->はオプションで、通常、パンチアウトサプライヤー </ItemID> <ItemDetail> <UnitPrice> <Money currency="USD">1505.0</Money> で構成さ<!--れ-->た<!--通貨コードです。Coupa --> </UnitPrice> <Description xml:lang="en">OptiPlex 755エナジースマートミニタワー。IntelREG CoreTM 2クアッドプロセッサQ 6600 ( 2.40 GHz、2 X 4 M、1066 MHz FSB )</Description> <UnitOfMeasure>EA</UnitOfMeasure> <Classification domain="UNSPSC">44000000</Classification> <!--将来の拡張--> </ItemDetail> <Distribution> <Accounting name="bbbb"> <!-- Coupaアカウント名--> <Segment description="ORG" type="Organization" /> <Segment id="b" description="DEPT" type="Department" /> <Segment id="bb" description="PROJ" type="Project" /> </Accounting> <Charge> <Money currency="USD">1505.0</Money> </Charge> </Distribution> <Comments xml:lang="en">ラインアイテムコメントは、ユーザー</Comments> </ItemOut> </OrderRequest> </Request> </cXML>が入力すると、ここに移動します

詳細をご覧ください。 また、 cXMLにおける一般的な特殊文字の処理も参照してください。

以下の発注書の例を使用してください。

注釈付きのサンプルcXML発注書

注:

CXMLを介して発注書を受け取る予定の場合は、Coupa cXMLサプライヤーアンケートに記入し、顧客に提供する必要があります。

仕組み

Coupaは、OrderResponse cXMLドキュメントとOrderResponseドキュメントを送信します。このドキュメントには、次の必須検証フィールドが含まれています。

  • サプライヤードメイン
  • サプライヤーID
  • バイヤードメイン
  • 購入者の身元
  • 共有済みシークレット

サポートされているcXML

Coupaは、次のcXML発注書ドキュメントをサポートしています。 サプライヤーは、受信したOrderRequestごとに60秒以内にOrderResponseを返さなければなりません。

表 1.
cXMLドキュメントDescription
OrderRequest

次の要素を含めます。

  • ルーティングURL
  • サプライヤーのドメインとID
  • バイヤーのドメインとアイデンティティ
  • 共有シークレット
OrderResponseOrderRequestを受け取ったら、cXMLをCoupaに返信してください。

cXML注文応答ステータスコード

表 2.
コード意味
2 xx成功
5 xxエラーが発生しましたが、システムは1時間間隔で5回再試行します
4 xxエラーが発生し、再試行は成功しません

テストチェックリスト

連携をテストする方法について、お客様と話し合ってください。

サンプルcXML

注釈付き発注書

OrderResponse

<?xml version="1.0"?> <cXML payloadID="111111111" xml:lang="en" timestamp="1999-03-12T18:39:09-08:00"> <Response> <Status code="200" text="OK"/> </Response> </cXML>

エラー処理

CXML接続の設定中にエラーが発生した場合は、 cXMLエラー処理を参照してください。

CoupaはSSLクライアント証明書認証をサポートしていないため、サプライヤーはこの制限を削除する必要があります。 詳細については、PO送信中の TLS/SSLエラー を参照してください。