別送同梱電子バーコード

EC-CUBE4系をご利用の場合

概要

加盟店様のご利用環境によっては、株式会社ネットプロテクションズ（以降、弊社）が提供するNP後払い・atone共通IF決済モジュール（以下、共通IFプラグイン）が正常に動作せず、本プラグインをご利用いただけない場合がございます。
本ページでは共通IFプラグインを利用できないケース（現時点で判明しているもののみ）についてご案内いたします。
弊社サービス導入前に、加盟店様の利用環境が本ページに記載されているケースに該当しないかをご確認の上、弊社サービスをお申し込みくださいませ。

ECCUBE4.0/4.1系共通IFプラグインの詳細は以下リンクをご覧ください。

■ECCUBE4.0/4.1系共通IFプラグイン
https://www.ec-cube.net/products/detail.php?product_id=2778

■ECCUBE4.2系共通IFプラグイン
https://www.ec-cube.net/products/detail.php?product_id=2870

共通IFプラグインをご利用可能なEC-CUBEのバージョンについて

共通IFプラグインは以下のEC-CUBEバージョンにのみ対応しています。
EC-CUBE4系であっても以下に記載のないバージョンで共通IFプラグインをご利用の場合、エラーが発生し正常に動作しない可能性がありますのでご注意ください。

共通IFプラグインが対応しているバージョン
EC-CUBE 4.0系4.0.6-p1
EC-CUBE 4.1系4.1.2
EC-CUBE 4.2系4.2.3

共通IFプラグインの挙動に影響を与えるEC-CUBEカスタマイズについて

EC-CUBE本体のカスタマイズ内容によっては、共通IFプラグインの挙動に影響が出る可能性がございます。
共通IFプラグインのインストール前に以下に記載の内容を必ずご一読の上、ご利用予定のEC-CUBE上にて該当するカスタマイズが実施されていないかをご確認ください。

①チェックアウト画面上の「注文する」ボタンのカスタマイズ

  • 具体的なカスタマイズ内容
    • class名の変更（class=”ec-blockBtn–action”）
    • 「注文する」ボタン押下時に何らかのアクションをもたせるようなjsによるカスタマイズ等
  • 具体的な影響
    • 購入時にエラーが発生し、購入完了できない
  • 原因
    • 商品購入時、NP決済モジュール（NP側システムプログラム）は、まず class名（button.ec-blockBtn–action）にて「注文する」ボタンを判定しています。
    • 「注文する」ボタンが判定できるとそのボタンに対して「文言の変更」と「 ID（np-atobarai-button）の追加」を行います。
    • NP決済モジュール（NP側システムプログラム）は、この追加した IDが押下（click）されたらNP決済モジュールプログラムが開始（Np.start）する仕様となっているため、class名が見つけられない場合、IDを追加することができません。
    • IDが追加されてないボタンをクリック後もNP決済モジュールが動かず、必要な情報がないままEC-CUBE側に受注を作成しようとしてしまうためエラーとなり購入ができない事象が発生します。

②対応状況（OrderStatus）のカスタマイズ

  • 具体的なカスタマイズ内容
    • 例）デフォルトの「発送済み（DELIVERED）」を使わず、独自に追加した「発送完了（shippingCompleted）」等を使用するようなカスタマイズを行っている場合等
  • 具体的な影響
    • EC-CUBE管理画面の受注管理（NP後払い決済管理画面）において「個別売上」、「個別取消」などのリンクが正常に表示できなくなる可能性がございます。
  • 原因
    • 各種対応状況の判定に、プログラムの中で「DELIVERED」などのデフォルトの対応状況（OrderStatus名）を用いていることにより判定に失敗します。
    • よって、下記の対応状況（OrderStatus）の変更、追加、未使用などで影響が出る可能性がございますのでご注意ください。
  • 対応状況（OrderStatus）
    • 新規受付（NEW）
    • 注文取消し（CANCEL）
    • 発送済み（DELIVERED）
    • 決済処理中（PENDING）
    • 購入処理中（PROCESSING）

③お問い合わせ番号（tracking_number）のカスタマイズ

  • 具体的なカスタマイズ内容
    • カスタマイズや別プラグインにてお問い合わせ番号（tracking_number）を別の名称にカスタマイズしている場合
    • 例）
      • tracking_numberという名称をプログラム内部で変更
      • データベース項目を別に追加しお問い合わせ番号を管理… etc
  • 具体的な影響
    • EC-CUBE管理画面の受注管理（NP後払い決済管理画面）において「個別売上」のリンクが正常に表示できなくなる可能性がございます。
  • 原因
    • 本プラグインは tracking_number を「個別売上」のリンク表示の条件の1つとして取得確認しますが、お問い合わせ番号（tracking_number）が別の名称に変更されてしまうと正常に値を取得できない（値が空となる）ため本影響が発生します。

関連記事