パンチアウトカタログ

はじめに

パンチアウトを利用して、Coupaユーザーは通常どおり購入できるサプライヤーのeコマースウェブサイトへのリンクをたどります。ユーザーがチェックアウトに進むと、Coupaカートに入った選択したアイテムと共にCoupaに戻されます。ユーザーは、サプライヤーのウェブサイトのアイテム、コスト、詳細を使用して、Coupaで請求書を提出できます。

バイヤーのメリット

設定とメンテナンスに手間がかからない
販売者が提供するすべてのアイテムを購入できる
ノートパソコンや名刺などのアイテムを簡単に設定/カスタマイズ

サプライヤーのメリット

カタログアイテムをすぐに変更
顧客ごとのカタログのメンテナンスが不要

パンチアウトの実装を計画している場合は、Coupa cXMLサプライヤーアンケートを記入して顧客に提供する必要があります。

仕組み

Coupaユーザーを認識するには、パンチアウトを設定する必要があります。Coupaに設定し、顧客と契約する必要もあります。顧客があなたを設定する前に、顧客に次の情報を提供する必要があります。

アイテム	説明
会社のロゴ	ロゴはパンチアウトへのリンクとして機能します。これは、[オンラインショッピング]セクションのCoupaホーム画面に表示されます。画像は150 x 50ピクセルのJPGまたはPNG形式にしてください。
パンチアウトURL	Coupaで発注書を受け取るために必要なフルルーティングURL。
顧客のドメインとID	通常、DUNSまたはNetworkID。
サプライヤーのドメインとID	通常、DUNSまたはNetworkID。
共有済みシークレット	サプライヤーと購入者を検証するパスワード。これは必須の証明書です。

あなたがパンチアウト情報を提供すると、顧客はCoupaでパンチアウトを設定できます。

通常サプライヤーは、テスト用と本番用の2つの情報セットを提供します。

基本的なパンチアウトの順序は次のとおりです。

Coupaユーザーがサプライヤーのパンチアウトリンクをクリックすると、Coupaは購入者のID（送信元、送信者、共有シークレット）を含むPunchoutSetupRequest cXML文書を送信します。
パンチアウトはユーザーを認証し、ランディングページURLを含むPunchoutSetupResponse cXML文書を返します。
ユーザーがチェックアウトすると、パンチアウトは、ユーザーがショッピングカートに追加したアイテムと共にPupchoutOrderMessage cXML文書をCoupaに送信します。
Coupaは注文メッセージに含まれる情報から請求書を作成します。

Diagram showing the punchout workflow.

サポートされているcXML

cXML文書説明

cXML文書	説明
`PunchOutSetupRequest`	次の要素が含まれます。パンチアウトURL 送信先/送信者/送信元のドメインおよびID 共有済みシークレット会社のロゴ Coupaは作成と検査のみをサポートします。
`PunchOutSetupResponse`	`PunchOutSetupRequest`を受け取ったら、cXMLをCoupaに返送します。この文書にはランディングページURLが含まれています。
`PunchOutOrderMessage`	cXMLを`PunchoutSetupRequest`の`<BrowserFormPost>`に返送します。

PunchOutSetupRequest

次の要素が含まれます。

パンチアウトURL
送信先/送信者/送信元のドメインおよびID
共有済みシークレット
会社のロゴ

Coupaは作成と検査のみをサポートします。

PunchOutSetupResponse PunchOutSetupRequestを受け取ったら、cXMLをCoupaに返送します。この文書にはランディングページURLが含まれています。

PunchOutOrderMessage cXMLをPunchoutSetupRequestの<BrowserFormPost>に返送します。

cXML用語定義

<BuyerCookie> ユーザーが初めてサプライヤーのパンチアウトサイトを利用すると、Coupaは各ユーザーとサプライヤーのパンチアウトサイトの組み合わせに固有のBuyerCookieIDを作成します。この値は変更されません。BuyerCookieIDは、ユーザーがサプライヤーのパンチアウトサイトをチェックアウトしてPunchOutOrderMessageでCoupaに戻った際にBuyerCookieID がPunchOutSetupRequest.の一部として送信されたものと一致するかどうかを検証するために使用します。

このフィールドは発注書（別名: OrderRequest）では渡されません。

cXML用語	定義
`<BuyerCookie>`	ユーザーが初めてサプライヤーのパンチアウトサイトを利用すると、Coupaは各ユーザーとサプライヤーのパンチアウトサイトの組み合わせに固有の`BuyerCookieID`を作成します。この値は変更されません。`BuyerCookieID`は、ユーザーがサプライヤーのパンチアウトサイトをチェックアウトして`PunchOutOrderMessage`でCoupaに戻った際に`BuyerCookieID` が`PunchOutSetupRequest.`の一部として送信されたものと一致するかどうかを検証するために使用します。このフィールドは発注書（別名: `OrderRequest`）では渡されません。
`<cXML Payload ID>`	`payloadID`は、Coupaが送信するあらゆるcXML文書を一意に識別します。`PunchoutSetupRequest`でのパンチアウト時、および`OrderRequest`での発注書送信時に生成されます。サプライヤーは、ショッピングカートのアイテムを含む`PunchOutOrderMessage`をCoupaに返送する際に`payloadID`を参照する必要がありません。サプライヤーが`payloadID`を参照する必要があるのは、`StatusUpdateRequest`をCoupaに返送して`OrderRequest`または`PurchaseOrder`の受領を承認する場合です。 `PayloadID` は最大180文字まで入力できます。
`<SupplierPartAuxiliaryID>`	これは、Coupaへの`PunchOutOrderMessage`の品目アイテムレベルのオプションタグです。サプライヤーは`SupplierPartAuxiliaryID`の任意の値を渡すことができ、Coupaはサプライヤーに`OrderRequest`の同じ値を渡します。 `SupplierPartAuxiliaryID`は最大765文字まで入力できます。

<cXML Payload ID>

payloadIDは、Coupaが送信するあらゆるcXML文書を一意に識別します。PunchoutSetupRequestでのパンチアウト時、およびOrderRequestでの発注書送信時に生成されます。

サプライヤーは、ショッピングカートのアイテムを含むPunchOutOrderMessageをCoupaに返送する際にpayloadIDを参照する必要がありません。

サプライヤーがpayloadIDを参照する必要があるのは、StatusUpdateRequestをCoupaに返送してOrderRequestまたはPurchaseOrderの受領を承認する場合です。

PayloadID は最大180文字まで入力できます。

<SupplierPartAuxiliaryID>

これは、CoupaへのPunchOutOrderMessageの品目アイテムレベルのオプションタグです。

サプライヤーはSupplierPartAuxiliaryIDの任意の値を渡すことができ、CoupaはサプライヤーにOrderRequestの同じ値を渡します。

SupplierPartAuxiliaryIDは最大765文字まで入力できます。

例

パンチアウト設定要求の例

パンチアウト設定応答の例

パンチアウト注文メッセージの例

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.014/cXML.dtd">
<cXML payloadID="9949494@cxml.Comergent.com" xml:lang="en-US" timestamp="--T+00:00" version="1.2.0.14">
  <Header>
    <From>
      <Credential domain="NetworkID">
        <Identity />
      </Credential>
    </From>
    <To>
      <Credential domain="NetworkId">
        <Identity>user@coupa.com</Identity>
      </Credential>
    </To>
    <Sender>
      <Credential domain="NetworkID">
        <Identity />
      </Credential>
      <UserAgent />
    </Sender>
  </Header>
  <Message deploymentMode="production">
    <PunchOutOrderMessage>
      <BuyerCookie>f5d75ddbc9e75b6346b36ee5c28c5e8b</BuyerCookie>
      <PunchOutOrderMessageHeader operationAllowed="edit" quoteStatus="final">
        <Total>
          <Money currency="USD">325.38</Money>
        </Total>
        <Shipping>
          <Money currency="USD">53.50</Money>
          <Description xml:lang="en-US">Unknown</Description>
        </Shipping>
        <Tax>
          <Money currency="USD">21.88</Money>
          <Description xml:lang="en-US">Unknown</Description>
        </Tax>
      </PunchOutOrderMessageHeader>
      <ItemIn quantity="1">
        <ItemID>
          <SupplierPartID>AM2692</SupplierPartID>
          <SupplierPartAuxiliaryID>A_B:5008937A_B:</SupplierPartAuxiliaryID>
        </ItemID>
        <ItemDetail>
          <UnitPrice>
            <Money currency="USD">250.00</Money>
          </UnitPrice>
          <Description xml:lang="en-US">ANTI-RNase (15-30 U/ul)</Description>
          <UnitOfMeasure>EA</UnitOfMeasure>
          <Classification domain="UNSPSC">41106104</Classification>
          <ManufacturerName />
          <LeadTime>0</LeadTime>
        </ItemDetail>
      </ItemIn>
    </PunchOutOrderMessage>
  </Message>
</cXML>