• 最終編集日時: 30 March 2023

パンチアウトカタログ

パンチアウトカタログはcXMLを使用し、顧客のCoupaインスタンスとサプライヤーのeコマースサイトとの間に直接リンクを作成します。

はじめに

パンチアウトすると、Coupaユーザーはリンクをたどってサプライヤーのeコマースサイトにアクセスし、通常通りに買い物をすることができます。ユーザーがチェックアウトする際には、Coupaのカートで選んだアイテムがCoupaに戻ってきます。ユーザーは、サプライヤーのウェブサイトにあるアイテム、コスト、詳細情報を使って、Coupaで申請書を提出することができます。

バイヤー福利厚生

  • セットアップとメンテナンスの手間が少ない
  • 販売者が提供するすべてのアイテムは購入可能です
  • ノートパソコンや名刺などのアイテムの簡単な構成/カスタマイズ

サプライヤーの福利厚生

  • カタログアイテムの即時変更
  • さまざまな顧客のカタログを維持する必要はありません。
メモ

パンチアウトを実装する場合は、Coupa cXML Supplier Questionnaireに記入し、顧客に提供する必要があります。

仕組み

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

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

パンチアウト情報を入力すると、顧客はCoupaでパンチアウトを設定できます。

メモ

通常、サプライヤーは2つの情報セットを提供します。1つはテスト用、もう1つは生産用です。

基本的なパンチアウトシーケンスは次のとおりです。

  1. Coupaユーザーがサプライヤーのパンチアウトリンクをクリックすると、CoupaはバイヤーのID ( From、Sender、SharedSecret )を含むPunchoutSetupRequest cXMLドキュメントを送信します。
  2. パンチアウトはユーザーを認証し、ランディングページのURLを含むPunchoutSetupResponse cXMLドキュメントを返します。
  3. ユーザーがチェックアウトすると、パンチアウトはユーザーがショッピングカートに追加したアイテムを含むPunchoutOrderMessage cXMLドキュメントをCoupaに送信します。
  4. Coupaは、注文メッセージに含まれる情報から申請書を作成します。

パンチアウトワークフローを示す図。

サポートされているcXML

cXMLドキュメント 説明
PunchOutSetupRequest

次の要素を含める:

  • パンチアウトURL
  • 宛先/送信者/送信元ドメインとID
  • 共有シークレット
  • 会社のロゴ

作成と検査のみサポートしています。

PunchOutSetupResponse PunchOutSetupRequestを受け取ったら、cXMLをCoupaに返信します。このドキュメントにはランディングページのURLが含まれています。
PunchOutOrderMessage CXMLをPunchoutSetupRequestのに投稿<BrowserFormPost>ます。
cXML用語 定義
<BuyerCookie> ユーザーがサプライヤーのパンチアウトサイトに初めてパンチアウトすると、Coupaは各ユーザーとサプライヤーパンチアウトサイトの組み合わせに固有のBuyerCookieIDを作成します。この値は変更されません。BuyerCookieID は、ユーザーがサプライヤーのパンチアウトサイトをチェックアウトし、PunchOutOrderMessageを使用してCoupaに戻ると、BuyerCookieIDがPunchOutSetupRequestの一部として送信されたものと一致することを検証するために使用されます。

このフィールドは発注書に渡されていません(別名:OrderRequest )。
<cXML Payload ID>

ペイロードIDは、Coupaが送信するcXMLドキュメントを一意に識別します。これは、PunchoutSetupRequestのパンチアウト時 、OrderRequestで発注書を送信したときに生成されます。

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

サプライヤーは、OrderRequestまたはPurchaseOrderの受領を承認するために、CoupaにStatusUpdateRequestを返すときにpayloadIDを参照する必要があります。

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 xml:lang="en-US" payloadID="1591126611.9325364@stg1302app4.int.coupahost.com" timestamp="2020-06-02T14:36:51-05:00">

  <Header>

    <From>

      <Credential domain="DUNS">

        <Identity>COUPA 1</Identity>

      </Credential>

    </From>

    <To>

      <Credential domain="DUNS">

        <Identity>079928354</Identity>

      </Credential>

    </To>

    <Sender>

      <Credential domain="DUNS">

        <Identity>COUPA 1</Identity>

        <SharedSecret>ALD</SharedSecret>

      </Credential>

      <UserAgent>Coupa Procurement 1.0</UserAgent>

    </Sender>

  </Header>

  <Request>

    <PunchOutSetupRequest operation="create">

      99 ea 3 c 4 c 8 cf 9 f 6 dc 905 a 6 b<BuyerCookie> 6772 daa 0 d 1</BuyerCookie>

      <Extrinsic name="FirstName">メアリー・アン</Extrinsic>

      <Extrinsic name="LastName">クシェミンスキー</Extrinsic>

      <Extrinsic name="UniqueName">maryanne.krzeminski@coupa.com</Extrinsic>

      <Extrinsic name="UserEmail">maryanne.krzeminski@coupa.com</Extrinsic>

      <Extrinsic name="User">maryanne.krzeminski@coupa.com</Extrinsic>

      <Extrinsic name="BusinessUnit">COUPA</Extrinsic>

      <BrowserFormPost>

        <URL>https://mwilczek-demo.coupacloud.com/punchout/checkout?id=2</URL>

      </BrowserFormPost>

      <Contact role="endUser">

        <Name xml:lang="en-US">maryanne.krzeminski@coupa.com</Name>

        <Email>maryanne.krzeminski@coupa.com</Email>

      </Contact>

      <SupplierSetup>

        <URL>https://uttest.free.beeceptor.com</URL>

      </SupplierSetup>

    </PunchOutSetupRequest>

  </Request>

</cXML>

パンチアウトセットアップ応答の例

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.1.010/cXML.dtd">

<cXML version="1.1.007" xml:lang="en-US" payloadID="200303450803006749@b2b.euro.com" timestamp="2020-06-02T14:36:53-05:00">

  <Response>

    <Status code="200" text="OK" />

    <PunchOutSetupResponse>

      <StartPage>

        <URL>https://mygreatpunchoutsite.com/punchoutLogin.asp</URL>

      </StartPage>

    </PunchOutSetupResponse>

  </Response>

</cXML>

パンチアウトオーダーメッセージの例

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

      f 5 d 75<BuyerCookie> ddbc 9 e 75 b 6346 b 36 ee 5 c 28 c 5 e 8 b</BuyerCookie>

      <PunchOutOrderMessageHeader operationAllowed="edit" quoteStatus="final">

        <Total>

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

        </Total>

        <Shipping>

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

          <Description xml:lang="en-US">不明</Description>

        </Shipping>

        <Tax>

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

          <Description xml:lang="en-US">不明</Description>

        </Tax>

      </PunchOutOrderMessageHeader>

      <ItemIn quantity="1">

        <ItemID>

          AM <SupplierPartID>2692</SupplierPartID>

          <SupplierPartAuxiliaryID>A_B: 5008937 A_B:</SupplierPartAuxiliaryID>

        </ItemID>

        <ItemDetail>

          <UnitPrice>

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

          </UnitPrice>

          <Description xml:lang="en-US">抗RNase (15 -30 U/ul)</Description>

          <UnitOfMeasure>EA</UnitOfMeasure>

          <Classification domain="UNSPSC">41106104</Classification>

          AM <ManufacturerPartID>2692</ManufacturerPartID>

          <ManufacturerName xml:lang="en">アクメ</ManufacturerName>

          <ManufacturerName />

          <LeadTime>0</LeadTime>

        </ItemDetail>

      </ItemIn>

    </PunchOutOrderMessage>

  </Message>

</cXML>