cXML発注書

はじめに

CoupaはcXML標準に準拠しています。詳細については、cXML.orgのcXMLユーザーズガイドを参照することをお勧めします。CXMLでの一般的な特殊文字の処理も参照してください。

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

注釈付きcXML PO (PO)のサンプル

仕組み

Coupaは、次の必須検証フィールドを含むOrderResponse文書を含むOrderResponse cXML文書をお送りします。

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

サポートされているcXML

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

cXMLオーダーレスポンスステータスコード

テストチェックリスト

連携をテストする方法について顧客に相談してください。

サンプルcXML

注釈付きの発注書

<?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">

            <!-- Customer domain typically provided by Supplier, typically DUNS -->

            <Identity>dell</Identity>

            <!-- Customer id typically provided by Supplier, string -->

         </Credential>

      </From>

      <To>

         <Credential domain="Duns">

            <!-- Supplier domain typically provided by Supplier, typically DUNS -->

            <Identity>128293714</Identity>

            <!-- Supplier id typically provided by Supplier, string -->

         </Credential>

      </To>

      <Sender>

         <Credential domain="duns">

            <Identity>dell</Identity>

            <!-- same as From -->

            <Identity>dell</Identity>

            <!-- same as From -->

         </Credential>

         <UserAgent>Coupa Procurement 1.0</UserAgent>

         <!-- does not change -->

      </Sender>

   </Header>

   <Request deploymentMode="production">

      <OrderRequest>

         <OrderRequestHeader orderID="6112" orderDate="2008-01-07T09:14:50-08:00" type="new">

         <!-- Coupa supports "new" and "update" -->

            <Total>

               <Money currency="USD">1505.0</Money>

               <!-- Currency code configured in 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>サンレアンドロ</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>

                  <!-- Company Name under Company Information in Coupa -->

                  <PostalAddress name="default">

                     <DeliverTo>ノア・サニティ宛先：ノアノア</DeliverTo>

                     <Street>3420 Flatiron Way</Street>

                     <City>西インデックス</City>

                     <State>ニュージャージー州</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>

               223 <SupplierPartID>-4511</SupplierPartID>

               <!-- Coupa Item Part Number -->

               <SupplierPartAuxiliaryID>1005379527029\ 1</SupplierPartAuxiliaryID>

               <!-- Auxiliary Part Number is optional, typically used by punchout suppliers -->

            </ItemID>

            <ItemDetail>

               <UnitPrice>

                  <Money currency="USD">1505.0</Money>

                  <!-- Currency code configured in 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>

               <!-- Future expansion -->

            </ItemDetail>

            <Distribution>

               <Accounting name="bbbb">

                  <!-- Coupa Account name -->

                  <Segment id="bbb" 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>

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エラーを参照してください。