description














システム接続サービス　V2.04
サービス導入マニュアル



Ver. 2.04 | Net Protections,INC.












Copyright（C）Net Protections,Inc. All Rights Reserved. description













改版履歴

　

版数 日付 改版内容
1.00 2011年7月1日 初版
1.01 2011年8月1日 取引状態確認依頼と、取引状態確認結果のインターフェースを追加
取引状態確認インターフェースのエラーリファレンスを追加
改版時点でシステム上発生しないエラーに関して、一部削除
　　（C10111,C10902,C10903,C10904,C10905）
1.02 2014年5月15日 当マニュアルの記載に不備があったため結果情報を一部訂正
■訂正箇所１ 取引修正結果、取引キャンセル結果、請求依頼結果
No:11 項目名:加盟店取引ID の設定内容
［誤］キャンセルNGの加盟店取引ID
［正］設定されません。
■訂正箇所２ 　
取引状態確認結果 　
No:40 項目名:加盟店取引ID の設定内容
［誤］取引状態確認NGの加盟店取引ID
［正］設定されません。
1.03 2014年8月1日 サービス名の変更
［変更前］ NP企業間決済
［変更後］ FREX B2B後払い決済
1.04 2015年10月28日 各種用語の変更
例)与信結果⇒審査結果,売上報告⇒請求依頼,
NP取引ID⇒FREX取引ID
1.05 2015年12月7日 取引明細の数量についての変更
・桁数を5桁から7桁
・０は入力不可から入力可能に変更
1.06 2016年1月29日 当マニュアルの記載に不備があったため一部訂正
■訂正箇所１
　取引登録依頼
　No:24 項目名:請求書送付方法
　 [誤]必須　空欄
　[正]必須　○
■訂正箇所２
　取引修正依頼
　No:25 項目名:請求書送付方法
　 [誤]必須　空欄
　[正]必須　○
1.07 2016年2月29日 支払明細取得（MS_CB_OT_0006）
NO18：取引合計のタグ記載ミスを修正 （複→単）
1.08 2016年4月21日 取引修正依頼で購入企業IDの変更は行えないため、 取引修正結果エラーにC10325を追加
1.09 2016年6月30日 メールアドレス上限に関してのエラーをC10303に追加
1.10 2017年4月1日 サービス名の変更
［変更前］ FREX B2B後払い決済
［変更後］ NP掛け払い
1.11 2017年5月13日 エラー番号C10404の文言を変更
1.12 2017年7月31日 与信ステータス取得に関する内容の追加 エラーリファレンスを別紙に変更 各種用語の変更
　例）FREX取引ID⇒NP取引ID、売上確定日⇒請求書発行基準日
エラー情報/エラー番号のタグを下記の通り変更
■エラー情報
［変更前］ 単
［変更後］ 複
■エラー番号
［変更前］ 複
［変更後］ 単
1.13 2017年9月19日 購入企業登録、購入企業情報修正、購入企業審査結果 のIFについての情報を追加 利用可能文字として下記を追加
　NEC特殊文字（１３区）
　NEC選定IBM拡張文字（８９区～９２区）
　IBM拡張文字（１１５区～１１９区）
1.14 2017年10月20日 取引登録時に明細に登録できる数量の桁数を拡張
1.15 2017年12月19日 試験環境WSDLのURLを変更
1.16 2018年6月25日 取引登録・修正で商品単価・数量を入力しない場合のルールを追記
取引登録（全モデル共通）　チェック仕様　★８
取引修正（全モデル共通）　チェック仕様　★８
1.17 2019年12月11日 軽減税率への対応に伴い取引登録・修正のIF項目を追加
1.18 2020年8月1日 試験環境の稼働時間に関する記載を追加
1.19 2020年8月27日 マイナス金額登録への対応に伴い取引金額の登録可能範囲を変更
2.00 2020年10月22日 モデル名の変更に伴い、該当箇所の記載を変更
[変更前] → [変更後]
NP掛け払い基本モデル（請求依頼あり）→ 通販モデル
NP掛け払い月額課金モデル（請求依頼なし）→ 月額サービスモデル（事前審査なし）
NP掛け払い事前審査モデル（請求依頼あり）→ 営業販売モデル
NP掛け払い事前審査モデル（請求依頼なし）→ 月額サービスモデル
2.01 2022年7月13日 コンビニ払い設定の追加に伴い、下記リクエストに項目を追加
取引登録依頼
取引修正依頼
取引状態確認結果
2.02 2022年11月30日 インボイス制度への対応に伴い取引登録・修正のIF項目を修正
2.03 2024年7月10日 購入企業IDの許容桁数が25桁から50桁となることに伴い、各種IFのリクエスト・レスポンスの桁数を変更
2.04 2024年9月30日 振込明細IF廃止に伴い、該当項目を削除













目次

　













システム接続サービス


本書は、株式会社ネットプロテクションズ（以降、ＮＰ）が提供するシステム接続サービスをご利用頂く企業様（以降、加盟店）を対象とした説明書です。
NPが提供する決済サービスの内容につきましては、サービスご案内資料をご参照ください。
また、営業販売モデル・月額サービスモデル用IFについては接続方式等が異なるため、データ仕様・接続情報は別紙『システム接続サービス_事前審査型スキーム用IF導入マニュアル』をご参照ください。


システム接続サービス概要

システム接続サービスは、NP掛け払いを行う為のWebサービスを提供します。 NP掛け払いを行うためのインターフェースとして、取引情報の登録・更新・請求依頼などを行う為の 「データ送信用インターフェース」とNP決済システムが生成する結果情報を取得する為の「データ取得用インターフェース」を提供しています。

処理概要イメージ

データ送信(Postメソッド)

  1. NP決済システムへデータを送信します。

  2. 送信されたデータがストレージに格納されます。

  3. 受付番号を返却します。

    以下の異常が返却される場合があります。

    • 認証エラー
    • システムエラー

データ取得(Getメソッド)

  1. バッチ処理により処理結果データが作成されます。

  2. 結果データの取得を行います。

  3. 処理結果データの有無を確認します。

  4. 結果データが返却されます。

    以下の異常が返却される場合があります。

    • 認証エラー
    • データ取得エラー
    • データチェックエラー
    • システムエラー

サービス利用時の認証情報


端末ID

加盟店様のシステムを一意に識別する為のIDです。
システム接続サービスをご導入頂く加盟店様へNPより端末IDをお知らせしています。

SPコード

システム接続サービスが加盟店様を一意に識別する為のコードです。
システム接続サービスをご導入頂く加盟店様へNPよりSPコードをお知らせしています。













インターフェース詳細

インターフェース一覧


以下にシステム接続サービスの全IFを示します。
各記号の意味は以下のとおりです。
○…開発必須
△…状況により開発
×…開発不要

インターフェース スキーム
通販 営業販売 月額サービス
事前審査あり 事前審査なし
購入企業登録 購入企業登録依頼 × ○ ○ ×
購入企業登録結果
購入企業審査結果 購入企業審査結果取得 × ○ ○ ×
購入企業情報修正 購入企業情報修正依頼 × ○ ○ ×
購入企業情報修正結果
取引登録 取引登録依頼 ○ ○ ○ ○
取引登録結果
審査結果 審査結果取得 ○ ○ ○ ○
取引修正 取引修正依頼 ○ ○ ○ ○
取引修正結果
取引キャンセル 取引キャンセル依頼 ○ ○ ○ ○
取引キャンセル結果
請求依頼 請求依頼依頼 ○ ○ × ×
請求依頼結果
与信ステータス取得 与信ステータス取得 × ○ ○ ○
取引状態確認 取引状態確認依頼 △ △ △ △
取引状態確認結果

処理フローと取引状態


NP掛け払い　通販モデル

NP掛け払いサービスの決済を行なう場合の処理フローと取引状態の遷移を以下に示します。


NP掛け払い　営業販売モデル

NP掛け払いサービスの決済を行なう場合の処理フローと取引状態の遷移を以下に示します。


NP掛け払い　月額サービスモデル

NP掛け払いサービスの決済を行なう場合の処理フローと取引状態の遷移を以下に示します。

NP掛け払い　月額サービスモデル（事前審査なし）

NP掛け払いサービスの決済を行なう場合の処理フローと取引状態の遷移を以下に示します。


インターフェース


購入企業登録（営業販売・月額サービス［事前審査あり］）


NP掛け払い決済の対象となる購入企業情報を登録するためのインターフェースです。
購入企業情報の登録依頼と購入企業登録結果を取得する２種類のインターフェースがあります。

購入企業登録依頼（NPCB2_SSBY0001）


購入企業登録結果（NPCB2_SSBY0002）

購入企業登録依頼を受付後、バッチ処理による購入企業登録処理を行い結果データを生成しておりますので、登録結果の取得が可能になるまでに最長で１時間かかります。

　

購入企業審査結果（営業販売・月額サービス［事前審査あり］）

購入企業審査の結果を取得するためのインターフェースです。
データ仕様、接続情報については別紙を用意しておりますのでそちらをご参照ください。

購入企業審査結果取得（NPCB2_SSBY0003）

購入企業情報修正（営業販売・月額サービス［事前審査あり］）

NP決済システムに登録されている購入企業情報を修正するためのインターフェースです。
購入企業情報の修正依頼と購入企業情報修正結果を取得する２種類のインターフェースがあります。
データ仕様、接続情報については別紙を用意しておりますのでそちらをご参照ください。

購入企業情報修正依頼（NPCB2_SSBY0004）

　　　　　　　　　

購入企業情報修正結果（NPCB2_SSBY0005）

購入企業情報修正依頼を受付後、バッチ処理による購入企業情報修正処理を行い結果データを生成しておりますので、修正結果の取得が可能になるまでに最長で１時間かかります。



取引登録（全モデル共通）

NP掛け払い決済の対象となる取引情報を登録するためのインターフェースです。
取引情報の登録依頼と取引登録結果を取得する２種類のインターフェースがあります。

取引登録依頼（MS_CB_IN_0001）

　　　　　　　　　

取引登録結果（MS_CB_OT_0001）

取引登録依頼を受付後、バッチ処理による取引登録処理を行い結果データを生成しておりますので、登録結果の取得が可能になるまでに最長で１時間かかります。
結果データが生成されていないタイミングで結果取得を実施した場合は、「ER0093：取得対象の結果データがありません。」が返却されますので、しばらく時間をおいてから再取得を行ってください。



審査結果（全モデル共通）


審査結果取得（MS_CB_OT_0005）

審査結果には以下の種類があります。

ステータス 審査結果 説明
結果確定 OK サービスを利用可能です。出荷・サービス提供等を行ってください。
NG サービスを利用できません。
保留 情報の不備などがあります。サポートデスクからのメールを確認し、必要な対応を行ってください。
審査中 － 審査中の状態です。再度審査結果の取得を行ってください。

取引登録受付後、順次与信審査を実施し結果データを生成しておりますので審査結果の取得が可能になるまでに最長で１時間かかります。ただし、取引の内容により詳細審査が必要となった取引については、審査中の取引として結果が返却されます。
審査結果を取得するタイミングによっては、取引登録結果を取得していない取引に対する審査結果が取得される場合があります。



取引修正（全モデル共通）

NP決済システムに登録されている取引情報を修正するためのインターフェースです。
取引情報の修正依頼と取引修正結果を取得する２種類のインターフェースがあります。

取引修正依頼（MS_CB_IN_0002）

取引修正結果（MS_CB_OT_0002）

取引修正依頼を受付後、バッチ処理による取引修正処理を行い結果データを生成しておりますので、修正結果の取得が可能になるまでに最長で１時間かかります。
取引修正を行った場合、取引に対する審査結果が生成されますので審査結果を再取得してください。
請求依頼済みの取引は、請求依頼を取り消すことによって取引修正可能です。ただし、請求書がすでに発行されている場合、取引修正を行うことはできません。



取引キャンセル（全モデル共通）

NP決済システムに登録されている取引をキャンセルするためのインターフェースです。
取引のキャンセル依頼と取引キャンセル結果を取得する２種類のインターフェースがあります。

取引キャンセル依頼（MS_CB_IN_0003）

取引キャンセル結果（MS_CB_OT_0003）

取引キャンセル依頼を受付後、バッチ処理による取引キャンセル処理を行い結果データを生成しておりますので、キャンセル結果の取得が可能になるまでに最長で１時間かかります。



請求依頼（通販、営業販売）

出荷等を行い、売上が確定した取引について請求依頼を行うためのインターフェースです。
請求依頼情報の登録依頼と請求依頼結果を取得する２種類のインターフェースがあります。
※事前審査スキームは、請求依頼が必要な場合と不要な場合があります。

請求依頼依頼（MS_CB_IN_0004）

請求依頼結果（MS_CB_OT_0004）

請求依頼依頼を受付後、バッチ処理による請求依頼処理を行い結果データを生成しておりますので、請求依頼結果の取得が可能になるまでに最長で１時間かかります。



与信ステータス（営業販売・月額サービス）

与信ステータスを確認するためのインターフェースです。

与信ステータス取得（NPCB2_SSAT0001）

債権保証ステータスの更新を深夜に行っているため、依頼時間によって結果が返却されない可能性がございます。その際は、時間をおいて再度取得をお願いいたします。


取引状態確認（全モデル共通。必要に応じて開発）

取引の請求状況などの取引状態を確認するためのインターフェースです。
取引の状態確認依頼と取引状態確認結果を取得する２種類のインターフェースがあります。

取引状態確認依頼（MS_CB_IN_0007）

取引状態確認結果（MS_CB_OT_0007）













データ仕様


送受信データ

加盟店様のシステムとNP決済システム間で送受信されるインターフェースデータはXML形式です。
送受信されるデータには以下の２種類がございます。

送信データ

加盟店様のシステムよりNP決済システムへ送信して頂く情報です。

ヘッダー情報

詳細情報


受信データ

NP決済システムより加盟店様のシステムへ送信する情報です。

結果情報

エラー情報


送受信イメージ


送信データ　：　加盟店様システムよりヘッダー情報と詳細情報を送信します。
受信データ　：　NP決済システムより結果情報またはエラー情報のいずれかが返却されます。


XMLイメージ


ヘッダー情報


<?xml version="1.0" encoding="UTF-8" ?>
<head>
  <telegram_id>XD0010</telegram_id>
  <terminal_id>1234567890</terminal_id>
  <sp_code>abc7654321</sp_code>

詳細情報


<?xml version="1.0" encoding="UTF-8"?>
<root>
<telegram_id>XU0010</telegram_id>
<transaction_details>
    <shop_transaction_id>ID-20100101-010</shop_transaction_id>
    <order_date>2010/01/01</order_date>
    <customer_information>
        <buyer_id>ID-abc-001</buyer_id>
        <company_name>ネットプロテクションズ</company_name>
        <department>システム</department>
        <customer_name>購⼊企業</customer_name>
        <zip>102-0083</zip>
        <address>東京都千代⽥区麹町９９－９９－９９</address>
        <tel>03-9999-9999</tel>
        <email>np@netprotections.co.jp</email>
    </customer_information>
    <dest_information>
        <dest_company_name>ネットプロテクションズ</dest_company_name>
        <dest_department>システム</dest_department>
        <dest_customer_name>担当者名<dest_customer_name>
        <dest_customer_name_kana>タントウシャメイ<dest_customer_name_kana>
        <dest_zip>102-0083</dest_zip>
        <dest_address>東京都千代⽥区麹町９９－９９－９９</dest_address>
        <dest_tel>03-9999-9999</dest_tel>
    </dest_information>
    <settlement_type>02</settlement_type>
    <billed_type>1</billed_type>
    <billed_amount>1000</billed_amount>
    <goods_details>

エラー情報

<?xml version="1.0" encoding="UTF-8" ?>
<root>
   <telegram_id>XD0010</telegram_id>
   <accept_no>100118U0010001</accept_no>
   <error_info>
       <error_no>C10101</error_no>
       <error_level>E</error_level>

結果情報

<?xml version="1.0" encoding="UTF-8" ?>
<root>
    <telegram_id>XD0010</telegram_id>
    <accept_no>100118U0010001</accept_no>
    <transaction_regist_details>
        <regist_OK_result>
            <np_transaction_id>10011800001</np_transaction_id>
            <shop_transaction_id>TRANS-0118-001</shop_transaction_id>
        </regist_OK_result>
    <regist_OK_result>
        <np_transaction_id>10011800002</np_transaction_id>
        <shop_transaction_id>TRANS-0118-003</shop_transaction_id>
    </regist_OK_result>
    <regist_NG_result>
        <np_transaction_id />
        <shop_transaction_id>TRANS-0118-002</shop_transaction_id>

文字コード

XML情報の文字コードは、UTF-8をご使用ください。

ShiftJIS等の文字コードをご利用の際には、UTF-8へのエンコーディングをお願い致します。

なお、NP決済システムで使用可能な文字は以下のものとなっております。


チェック仕様

インターフェースデータのデータチェックの仕様は以下の４種類に分類されます。

詳細については、インターフェース毎のチェック仕様をご参照ください。

データ型 使用可能文字
半角 半角文字のみ使用可能です。
半角数値 半角の数字のみ使用可能です。
半角英数 半角のアルファベットと数字のみ使用可能です。
日付 日付形式のみ使用可能です。 書式（YYYY/MM/DDなど）については、項目によって異なります。
全角 全角文字のみ使用可能です。
全角カナ 全角カタカナのみ使用可能です。

インターフェース共通



ヘッダー情報


ヘッダー情報

No 項目名 タグ名 説明 設定値（例）
1 ヘッダー head ヘッダー情報のブロックです。
2 電文ID telegram_id 電文IDです。与信ステータス取得では不要。 XU0010
3 端末ID terminal_id 認証に使用される端末IDです。 2000009999
4 SPコード sp_code 認証に使用されるSPコードです。 XXX9999999
５ バージョン version インターフェースのバージョンです。 1.00

チェック仕様

No 項目名 タグ名 型 桁数 必須入力 タグ 条件チェック／（備考）
1 ヘッダー head － － ○ 単
2 電文ID telegram_id 半角英数 6 ○ 単 取引登録依頼：XU0010
取引登録結果：XD0010
請求依頼依頼：XU0020
請求依頼結果：XD0020
取引修正依頼：XU0030
取引修正結果：XD0030
取引キャンセル依頼：XU0040
取引キャンセル結果：XD0040
取引状態確認依頼：XU0050
取引状態確認結果：XD0050
審査結果取得：XD1010
3 端末ID terminal_id 半角数値 10 ○ 単 認証可能であること
4 SPコード sp_code 半角英数 10 ○ 単 認証可能であること
５ バージョン version 半角 4 ○ 単 1.00であること

「タグ」列はデータ項目（タグ）が単数（単）であるか、複数設定が可能（複）かを表しています。

エラー情報

No 項目名 タグ名 型 桁数 必須入力 タグ 設定内容
1 ルート root － － ○ 単
2 電文ID telegram_id 半角英数 6 ○ 単
3 受付番号 accept_no 半角英数 14 ○ 単
4 エラー情報 error_info － － ○ 複 エラーの時のみ設定されます。
5 エラー番号 error_no 半角英数 6 ○ 単 エラー番号が設定されます。
6 エラー種別 error_level 半角 1 ○ 単 エラー種別が設定されます。
7 エラー内容 error_contents 全角 100以内 ○ 単 エラー内容が設定されます。

取引登録（全モデル共通）


取引登録依頼（MS_CB_IN_0001）

詳細情報

No 項目名 物理名 説明 設定値（例）
1 ルート root データブロックを表します。
2 電文ID telegram_id 電文IDです。 XU0010
3 取引情報 transaction_details 詳細情報のデータブロックを表します。
4 加盟店取引ID shop_transaction_id 加盟店取引IDです。
5 注文日 order_date 注文が行われた日付です。 2010/01/31
6 購入企業情報 customer_information 購入企業情報のデータブロックを表します。
7 購入企業ID buyer_id 購入企業IDです。
8 企業名 company_name 購入企業の企業名です。
9 部署名 department 購入企業の部署名です。
10 担当者名 customer_name 購入企業の担当者名です。
11 郵便番号 zip 購入企業の郵便番号です。 107-0052
12 住所 address 購入企業の住所です。
13 電話番号 tel 購入企業の電話番号です。 03-9999-9999
14 メールアドレス email 購入企業のメールアドレスです。 np@netprotections.co.jp
15 配送先情報 dest_information 配送先のデータブロックを表します。
16 企業名 dest_company_name 配送先の企業名です。
17 部署名 dest_department 配送先の部署名です。
18 担当者名 dest_customer_name 配送先の担当者名です。
19 担当者名（カナ） dest_customer_name_kana 配送先の担当者名(カナ)です。
20 郵便番号 dest_zip 配送先の郵便番号です。
21 住所 dest_address 配送先の住所です。
22 電話番号 dest_tel 配送先の電話番号です。
23 決済方法 settlement_type 決済方法です。 02
24 請求書送付方法 billed_type 請求書送付方法です。 1
25 コンビニ払い設定 convenience_payment_flag コンビニ払い設定です。 1
26 取引金額 billed_amount 取引金額です。
27 税率別合計金額明細 tax_rate_summaries 税率別合計金額明細のデータブロックを表します。
28 税率別合計金額情報 summary_information 税率別合計金額情報のデータブロックを表します。
29 税率 tax_rate 税率別合計金額の税率です。 8
30 合計金額 total_amount 税率別合計金額の合計金額です。
31 商品明細 goods_details 商品明細のデータブロックです。
32 商品情報 goods_information 商品情報のデータブロックです。 （複数可能） ★ １
33 明細 goods_name 請求書の明細欄に記載される内容です。
34 元加盟店取引受注日 original_transaction_date 返還取引の元加盟店取引受注日です。 2022/10/31
35 商品単価 goods_price 商品の単価です。
36 数量 quantity 商品の数量です。
37 請求書税区分 billed_tax_kind 明細の税区分です。

チェック仕様

No 項目名 物理名 型 桁数 必須入力 タグ 条件チェック/（備考）
1 ルート root － － ○ 単
2 電文ID telegram_id 半角数値 6 ○ 単 XU0010
3 取引情報 transaction_details － － ○ 複
4 加盟店取引ID shop_transaction_id 半角英数 40以内 ○ 単 ★ １
5 注文日 order_date 半角 10 ○ 単 ★ ２
YYYY/MM/DD形式
6 購入企業情報 customer_information － － ○ 単
7 購入企業ID buyer_id 半角 50以内 ○ 単 ★ 3
8 企業名 company_name 全角 30以内 ○ 単
9 部署名 department 全角 30以内 単
10 担当者名 customer_name 全角 15以内 単
11 郵便番号 zip 半角 8以内 ○ 単 ★ ４ （ハイフンは省略可）
12 住所 address 全角 50以内 ○ 単 ★ ４
13 電話番号 tel 半角 13以内 ○ 単 （ハイフンは省略可）
14 メールアドレス email 半角 100以内 ○ 単 ★ ５
メールアドレス形式
15 配送先情報 dest_information － － 単
16 企業名 dest_company_name 全角 30以内 単 ★ 6
17 部署名 dest_department 全角 30以内 単
18 担当者名 dest_customer_name 全角 15以内 単
19 担当者名（カナ） dest_customer_name_kana 全角カナ 25以内 単
20 郵便番号 dest_zip 半角 8以内 単 ★ ４ ★ 6
21 住所 dest_address 全角 50以内 単 ★ ４ ★ 6
22 電話番号 dest_tel 半角数値 13以内 単 ★ 6
23 決済方法 settlement_type 半角数値 2以内 ○ 単 02
24 請求書送付方法 billed_type 半角数値 1 ○ 単 1：郵送 2：メール
25 コンビニ払い設定 convenience_payment_flag 半角数値 1 単 0：なし 1：あり
★ 7
26 取引金額 billed_amount 半角数値 8以内 ○ 単 -99999999 ～ 99999999
★ 8
27 税率別合計金額明細 tax_rate_summaries － － 単 ★ 12
28 税率別合計金額情報 summary_information － － 複 ★ 9
29 税率 tax_rate 半角数値 2以内 ○ 単
30 合計金額 total_amount 半角数値 13以内 ○ 単
31 商品明細 goods_details － － ○ 単
32 商品情報 goods_information － － ○ 複
33 明細 goods_name 全角 150以内 ○ 単
34 元加盟店取引受注日 original_transaction_date 半角 10 単 YYYY/MM/DD形式
★ 14
35 商品単価 goods_price 半角数値 13以内 ★ 10 単 -99999999.999 ～99999999.999
36 数量 quantity 半角数値 13以内 ★ 10 単 -99999999.999 ～99999999.999
37 請求書税区分 billed_tax_kind 半角英数 3 単 N00:集計対象外,
T08:税込8%,
T10:税込10%,
B08:税別8%,
B10:税別10%,
R08:税込8%（返還）,
R10:税込10%（返還）,
H08:税別8%（返還）,
H10:税別10%（返還）,
E00:非課税,
U00:不課税
★ 11 ★ 13

結果情報

No 項目名 タグ名 型 桁数 必須入力 タグ 設定内容
1 ルート root － － ○ 単
2 電文ID telegram_id 半角英数 6 ○ 単 XU0010
3 受付番号 accept_no 半角英数 14 ○ 単 受付番号が設定されます。

取引登録結果（MS_CB_OT_0001）

詳細情報

No 項目名 タグ名 説明 設定値（例）
1 ルート root データブロックを表します。
2 電文ID telegram_id 電文IDです。 XD0010
3 受付番号 accept_no 取引登録依頼時の受付番号です。

チェック仕様

No 項目名 タグ名 型 桁数 必須入力 タグ 条件チェック／（備考）
1 ルート root － － ○ 単
2 電文ID telegram_id 半角英数 6 ○ 単 XD0010であること
3 受付番号 accept_no 半角英数 1４ ○ 単 有効な受付番号であること

結果情報

No 項目名 タグ名 型 桁数 必須入力 タグ 設定内容
1 ルート root － － ○ 単
2 電文ID telegram_id 半角英数 6 ○ 単
3 受付番号 accept_no 半角英数 14 ○ 単
4 処理時間 process_date 半角 19 ○ 単 処理を開始した時間 2011/01/01 12:00:00
5 取引登録結果 transaction_regist_details － － ○ 単
6 登録OK結果 regist_OK_result － － 複 取引登録OKの取引情報
7 NP取引ID np_transaction_id 半角数値 11 単 登録時に付与されたNP取引ID
8 加盟店取引ID shop_transaction_id 半角英数 40以下 単 登録OKの加盟店取引ID
9 登録NG結果 regist_NG_result － － 複 取引登録NGの取引情報
10 NP取引ID np_transaction_id 半角数値 11 単 設定されません。
11 加盟店取引ID shop_transaction_id 半角英数 40以下 単 登録NGの加盟店取引ID
12 エラーリスト error_list － － 複 登録NGのエラー内容リスト
13 エラー番号 error_no 半角英数 6 単 エラー番号が設定されます。
14 エラー種別 error_level 半角 1 単 エラー種別が設定されます。
15 エラー内容 error_contents 全角 100以下 単 エラー内容が設定されます。

審査結果（全モデル共通）


審査結果取得（MS_CB_OT_0005）

詳細情報

結果情報

No 項目名 タグ名 型 桁数 必須入力 タグ 設定内容
1 ルート root － － ○ 単
2 電文ID telegram_id 半角英数 6 ○ 単
3 処理時間 process_date 半角 19 ○ 単 リクエストを受け付けて処理を行った時間 2011/01/01 12:00:00
4 審査結果 authori_result_details － － ○ 単
5 結果確定 authori_decision － － 複 審査結果が確定した取引情報
6 NP取引ID np_transaction_id 半角数値 11 単 結果確定した取引のNP取引ID
7 加盟店取引ID shop_transaction_id 半角英数 40以下 単 結果確定した取引の加盟店取引ID
8 受付番号 transaction_accept_no 半角英数 14 単 取引登録依頼時の受付番号
9 審査結果 authori_result 半角数値 1 単 1：OK 2：保留 3：NG
10 結果確定日時 authori_required_date 半角英数 19 単 YYYY/MM/DD HH:MM;SS形式
11 審査NG理由 authori_ng_reason 半角英数 5 単 NG001：金額超過によるNG NG999：金額超過以外のNG
12 審査中 authori_examination － － 複 審査中の取引情報
13 NP取引ID np_transaction_id 半角数値 11 単 審査中の取引のNP取引ID
14 加盟店取引ID shop_transaction_id 半角英数 40以下 単 審査中の取引の加盟店取引ID
15 受付番号 transaction_accept_no 半角英数 14 単 取引登録依頼時の受付番号

取引修正（全モデル共通）


取引修正依頼（MS_CB_IN_0002）

詳細情報

No 項目名 物理名 説明 設定値（例）
1 ルート root データブロックを表します。
2 電文ID telegram_id 電文IDです。 XU0010
3 取引情報 transaction_details 詳細情報のデータブロックを表します。
4 NP取引ID np_transaction_id NP取引IDです。
5 加盟店取引ID shop_transaction_id 加盟店取引IDです。
6 注文日 order_date 注文が行われた日付です。 2010/01/31
7 購入企業情報 customer_information 購入企業情報のデータブロックを表します。
8 購入企業ID buyer_id 購入企業IDです。
9 企業名 company_name 購入企業の企業名です。
10 部署名 department 購入企業の部署名です。
11 担当者名 customer_name 購入企業の担当者名です。
12 郵便番号 zip 購入企業の郵便番号です。 107-0052
13 住所 address 購入企業の住所です。
14 電話番号 tel 購入企業の電話番号です。 03-9999-9999
15 メールアドレス email 購入企業のメールアドレスです。 np@netprotections.co.jp
16 配送先情報 dest_information 配送先のデータブロックを表します。
17 企業名 dest_company_name 配送先の企業名です。
18 部署名 dest_department 配送先の部署名です。
19 担当者名 dest_customer_name 配送先の担当者名です。
20 担当者名（カナ） dest_customer_name_kana 配送先の担当者名(カナ)です。
21 郵便番号 dest_zip 配送先の郵便番号です。
22 住所 dest_address 配送先の住所です。
23 電話番号 dest_tel 配送先の電話番号です。
24 決済方法 settlement_type 決済方法です。 02
25 請求書送付方法 billed_type 請求書送付方法です。 1
26 コンビニ払い設定 convenience_payment_flag コンビニ払い設定です。 1
27 取引金額 billed_amount 取引金額です。
28 税率別合計金額明細 tax_rate_summaries 税率別合計金額明細のデータブロックを表します。
29 税率別合計金額情報 summary_information 税率別合計金額情報のデータブロックを表します。
30 税率 tax_rate 税率別合計金額の税率です。 8
31 合計金額 total_amount 税率別合計金額の合計金額です。
32 商品明細 goods_details 商品明細のデータブロックです。
33 商品情報 goods_information 商品情報のデータブロックです。 （複数可能） ★ １
34 明細 goods_name 請求書の明細欄に記載される内容です。
35 元加盟店取引受注日 original_transaction_date 返還取引の元加盟店取引受注日です。 2022/10/31
36 商品単価 goods_price 商品の単価です。
37 数量 quantity 商品の数量です。
38 請求書税区分 billed_tax_kind 明細の税区分です。

チェック仕様

No 項目名 物理名 型 桁数 必須入力 タグ 条件チェック/（備考）
1 ルート root － － ○ 単
2 電文ID telegram_id 半角数値 6 ○ 単 XU0010
3 取引情報 transaction_details － － ○ 複
4 NP取引ID np_transaction_id 半角数値 11 ○ 単 有効なNP取引IDの取引であること
5 加盟店取引ID shop_transaction_id 半角英数 40以内 ○ 単 ★ １
6 注文日 order_date 半角 10 ○ 単 ★ ２
YYYY/MM/DD形式
7 購入企業情報 customer_information － － ○ 単
8 購入企業ID buyer_id 半角 50以内 ○ 単 ★ 3
9 企業名 company_name 全角 30以内 ○ 単
10 部署名 department 全角 30以内 単
11 担当者名 customer_name 全角 15以内 単
12 郵便番号 zip 半角 8以内 ○ 単 ★ ４ （ハイフンは省略可）
13 住所 address 全角 50以内 ○ 単 ★ ４
14 電話番号 tel 半角 13以内 ○ 単 （ハイフンは省略可）
15 メールアドレス email 半角 100以内 ○ 単 ★ ５メールアドレス形式
16 配送先情報 dest_information － － 単
17 企業名 dest_company_name 全角 30以内 単 ★ 6
18 部署名 dest_department 全角 30以内 単
19 担当者名 dest_customer_name 全角 15以内 単
20 担当者名（カナ） dest_customer_name_kana 全角カナ 25以内 単
21 郵便番号 dest_zip 半角 8以内 単 ★ ４ ★ 6
22 住所 dest_address 全角 50以内 単 ★ ４ ★ 6
23 電話番号 dest_tel 半角数値 13以内 単 ★ 6
24 決済方法 settlement_type 半角数値 2以内 ○ 単 02
25 請求書送付方法 billed_type 半角数値 1 ○ 単 1：郵送 2：メール
26 コンビニ払い設定 convenience_payment_flag 半角数値 1 単 0：なし 1：あり
★ 7
27 取引金額 billed_amount 半角数値 8以内 ○ 単 -99999999 ～ 99999999
★ 8
28 税率別合計金額明細 tax_rate_summaries － － 単 ★ 12
29 税率別合計金額情報 summary_information － － 複 ★ 9
30 税率 tax_rate 半角数値 2以内 ○ 単
31 合計金額 total_amount 半角数値 13以内 ○ 単
32 商品明細 goods_details － － ○ 単
33 商品情報 goods_information － － ○ 複
34 明細 goods_name 全角 150以内 ○ 単
35 元加盟店取引受注日 original_transaction_date 半角 10 単 YYYY/MM/DD形式
★ 14
36 商品単価 goods_price 半角数値 13以内 ★ 10 単 -99999999.999 ～99999999.999
37 数量 quantity 半角数値 13以内 ★ 10 単 -99999999.999 ～99999999.999
38 請求書税区分 billed_tax_kind 半角英数 3 単 N00:集計対象外,
T08:税込8%,
T10:税込10%,
B08:税別8%,
B10:税別10%,
R08:税込8%（返還）,
R10:税込10%（返還）,
H08:税別8%（返還）,
H10:税別10%（返還）,
E00:非課税,
U00:不課税
★ 11 ★ 13

結果情報
No 項目名 タグ名 型 桁数 必須入力 タグ 設定内容
1 ルート Root － － ○ 単
2 電文ID telegram_id 半角英数 6 ○ 単 XU0030
3 受付番号 accept_no 半角英数 14 ○ 単 受付番号が設定されます。

取引修正結果（MS_CB_OT_0002）

詳細情報

No 項目名 タグ名 説明 設定値（例）
1 ルート Root データブロックを表します。
2 電文ID telegram_id 電文IDを設定します。 XD0030
3 受付番号 accept_no 取引修正依頼時の受付番号を設定します。

チェック仕様

No 項目名 タグ名 型 桁数 必須入力 タグ 条件チェック
1 ルート Root － － ○ 単
2 電文ID telegram_id 半角数値 6 ○ 単 XD0030であること
3 受付番号 accept_no 半角英数 1４ ○ 単 有効な受付番号であること

結果情報

No 項目名 タグ名 型 桁数 必須入力 タグ 設定内容
1 ルート Root － － ○ 単
2 電文ID telegram_id 半角英数 6 ○ 単
3 受付番号 accept_no 半角英数 14 ○ 単
4 処理時間 process_date 半角 19 ○ 単 処理を開始した時間 2011/01/01 12:00:00
5 取引修正結果 transaction_revision_details － － ○ 単
6 修正OK結果 regist_OK_result － － 複 取引修正OKの取引情報
7 NP取引ID np_transaction_id 半角数値 11 単 修正OKのNP取引ID
8 加盟店取引ID shop_transaction_id 半角英数 40以下 単 修正OKの加盟店取引ID
9 修正NG結果 regist_NG_result － － 複 取引修正NGの取引情報
10 NP取引ID np_transaction_id 半角数値 11 単 修正NGのNP取引ID
11 加盟店取引ID shop_transaction_id 半角英数 40以下 単 設定されません。
12 エラーリスト error_list － － 複 修正NGのエラー内容リスト
13 エラー番号 error_no 半角英数 6 単 エラー番号が設定されます。
14 エラー種別 error_level 半角 1 単 エラー種別が設定されます。
15 エラー内容 error_contents 全角 100以下 単 エラー内容が設定されます。

取引キャンセル（全モデル共通）


取引キャンセル依頼（MS_CB_IN_0003）

詳細情報

No 項目名 タグ名 説明 設定値（例）
1 ルート Root データブロックを表します。
2 電文ID telegram_id 電文IDです。 XU0040
3 取引キャンセル情報 transaction_cancel_details 詳細情報のデータブロックを表します。
4 NP取引ID np_transaction_id 登録時に付与されたNP取引IDです。

チェック仕様

No 項目名 タグ名 型 桁数 必須入力 タグ 条件チェック
1 ルート Root － － ○ 単
2 電文ID telegram_id 半角数値 6 ○ 単 XU0040
3 取引キャンセル情報 transaction_cancel_details － － ○ 複
4 NP取引ID np_transaction_id 半角数値 11 ○ 単 有効なNP取引IDであること

結果情報

No 項目名 タグ名 型 桁数 必須入力 タグ 設定内容
1 ルート Root － － ○ 単
2 電文ID telegram_id 半角英数 6 ○ 単 XU0040
3 受付番号 accept_no 半角英数 14 ○ 単 受付番号が設定されます。

取引キャンセル結果（MS_CB_OT_0003）

詳細情報

No 項目名 タグ名 説明 設定値（例）
1 ルート Root データブロックを表します。
2 電文ID telegram_id 電文IDです。 XD0040
3 受付番号 accept_no 取引登録依頼時の受付番号です。

チェック仕様

No 項目名 タグ名 型 桁数 必須入力 タグ 条件チェック
1 ルート Root － － ○ 単
2 電文ID telegram_id 半角数値 6 ○ 単 XD0040であること
3 受付番号 accept_no 半角英数 1４ ○ 単 有効な受付番号であること

結果情報

No 項目名 タグ名 型 桁数 必須入力 タグ 設定内容
1 ルート Root － － ○ 単
2 電文ID telegram_id 半角英数 6 ○ 単
3 受付番号 accept_no 半角英数 14 ○ 単
4 処理時間 process_date 半角 19 ○ 単 処理を開始した時間 2011/01/01 12:00:00
5 取引キャンセル結果 transaction_cancel_details － － ○ 単
6 キャンセルOK結果 regist_OK_result － － 複 取引キャンセルOKの取引情報
7 NP取引ID np_transaction_id 半角数値 11 単 キャンセルOKのNP取引ID
8 加盟店取引ID shop_transaction_id 半角英数 40以下 単 キャンセルOKの加盟店取引ID
9 キャンセルNG結果 regist_NG_result － － 複 取引キャンセルNGの取引情報
10 NP取引ID np_transaction_id 半角数値 11 単 キャンセルNGのNP取引ID
11 加盟店取引ID shop_transaction_id 半角英数 40以下 単 設定されません。
12 エラーリスト error_list － － 複 キャンセルNGのエラー内容リスト
13 エラー番号 error_no 半角英数 6 単 エラー番号が設定されます。
14 エラー種別 error_level 半角 1 単 エラー種別が設定されます。
15 エラー内容 error_contents 全角 100以下 単 エラー内容が設定されます。

請求依頼（通販、営業販売）


請求依頼依頼（MS_CB_IN_0004）


詳細情報
No 項目名 タグ名 説明 設定値（例）
1 ルート root データブロックを表します。
2 電文ID telegram_id 電文IDです。 XU0020
3 請求依頼明細 sales_details 詳細情報のデータブロックを表します。
4 NP取引ID np_transaction_id 登録時に付与されたNP取引IDです。
5 請求書発行基準日 sales_date 請求書発行基準日です。 2011/01/01

チェック仕様

No 項目名 タグ名 型 桁数 必須入力 タグ 条件チェック
1 ルート root － － ○ 単
2 電文ID telegram_id 半角数値 6 ○ 単 XU0020
3 請求依頼明細 sales_details － － ○ 複
4 NP取引ID np_transaction_id 半角数値 11 ○ 単 有効なNP取引IDであること
5 請求書発行基準日 sales_date 半角数値 10 ○ 単 YYYY/MM/DD形式

結果情報

No 項目名 タグ名 型 桁数 必須入力 タグ 設定内容
1 ルート root － － ○ 単
2 電文ID telegram_id 半角英数 6 ○ 単 XU0020
3 受付番号 accept_no 半角英数 14 ○ 単

請求依頼結果（MS_CB_OT_0004）

詳細情報

No 項目名 タグ名 説明 設定値（例）
1 ルート root データブロックを表します。
2 電文ID telegram_id 電文IDです。 XD0020
3 受付番号 accept_no 請求依頼依頼時の受付番号です。

チェック仕様

No 項目名 タグ名 型 桁数 必須入力 タグ 条件チェック
1 ルート root － － ○ 単
2 電文ID telegram_id 半角数値 6 ○ 単 XD0020であること
3 受付番号 accept_no 半角英数 1４ ○ 単 有効な受付番号であること

結果情報

No 項目名 タグ名 型 桁数 必須入力 タグ 設定内容
1 ルート root － － ○ 単
2 電文ID telegram_id 半角英数 6 ○ 単
3 受付番号 accept_no 半角英数 14 ○ 単
4 処理時間 process_date 半角 19 ○ 単 処理を開始した時間 2011/01/01 12:00:00
5 請求依頼結果明細 sales_report_details － － ○ 単
6 請求依頼OK結果 regist_OK_result － － 複 請求依頼OKの取引情報
7 NP取引ID np_transaction_id 半角数値 11 単 請求依頼OKのNP取引ID
8 加盟店取引ID shop_transaction_id 半角英数 40以下 単 請求依頼OKの加盟店取引ID
9 請求依頼NG結果 regist_NG_result － － 複 請求依頼NGの取引情報
10 NP取引ID np_transaction_id 半角数値 11 単 請求依頼NGのNP取引ID
11 加盟店取引ID shop_transaction_id 半角英数 40以下 単 設定されません。
12 エラーリスト error_list － － 複 請求依頼NGのエラー内容リスト
13 エラー番号 error_no 半角英数 6 単 エラー番号が設定されます。
14 エラー種別 error_level 半角 1 単 エラー種別が設定されます。
15 エラー内容 error_contents 全角 100以下 単 エラー内容が設定されます。

取引状態確認（全モデル共通。必要に応じて開発）


取引状態確認取得（MS_CB_IN_0007）

詳細情報

No 項目名 タグ名 説明 設定値（例）
1 ルート root データブロックを表します。
2 電文ID telegram_id 電文IDです。 XU0050
3 取引状態確認 transaction_confirm_details 詳細情報のデータブロックを表します。
4 NP取引ID np_transaction_id 登録時に付与されたNP取引IDです。

チェック仕様

No 項目名 タグ名 型 桁数 必須入力 タグ 条件チェック
1 ルート root － － ○ 単
2 電文ID telegram_id 半角数値 6 ○ 単 XU0050
3 取引状態確認 transaction_confirm_details － － ○ 複
4 NP取引ID np_transaction_id 半角数値 11 ○ 単 有効なNP取引IDであること

結果情報

No 項目名 タグ名 型 桁数 必須入力 タグ 設定内容
1 ルート root － － ○ 単
2 電文ID telegram_id 半角英数 6 ○ 単 XU0050
3 受付番号 accept_no 半角英数 14 ○ 単

取引状態確認結果（MS_CB_OT_0007）

詳細情報

No 項目名 タグ名 説明 設定値（例）
1 ルート root データブロックを表します。
2 電文ID telegram_id 電文IDです。 XD0050
3 受付番号 accept_no 取引状態確認依頼時の受付番号です。

チェック仕様

No 項目名 タグ名 型 桁数 必須入力 タグ 条件チェック
1 ルート root － － ○ 単
2 電文ID telegram_id 半角数値 6 ○ 単 XD0050であること
3 受付番号 accept_no 半角英数 1４ ○ 単 有効な受付番号であること

結果情報

No 項目名 タグ名 型 桁数 必須入力 タグ 設定内容
1 ルート root － － ○ 単
2 電文ID telegram_id 半角英数 6 ○ 単
3 受付番号 accept_no 半角英数 14 ○ 単
4 処理時間 process_date 半角 19 ○ 単 処理を開始した時間 2011/01/01 12:00:00
5 取引状態確認結果 transaction_confirm_details － － ○ 単
6 状態確認OK結果 confirm_OK_result － － 複 取引状態確認OKの取引情報
7 NP取引ID np_transaction_id 半角数値 11 単 取引状態確認OKのNP取引ID
8 加盟店取引ID shop_transaction_id 半角英数 40以下 単 取引状態確認OKの加盟店取引ID
9 購入企業情報 buyer_information － － 単 対象取引の購入企業情報です。
10 購入企業ID buyer_id 半角 50以内 単 登録されている購入企業IDです。
11 企業名 company_name 全角 30以内 単 購入企業IDに対する企業名です。
12 部署 department 全角 30以内 単 購入企業IDに対する部署名です。
13 担当者名 customer_name 全角 15以内 単 購入企業IDに対する担当者名です。
14 郵便番号 zip 半角 8以内 単 購入企業IDに対する郵便番号です。
15 住所 address 全角 50以内 単 購入企業IDに対する住所です。
16 電話番号 tel 半角 13以内 単 購入企業IDに対する電話番号です。
17 メールアドレス email 半角 100以内 単 購入企業IDに対するメールアドレスです。
18 銀行コード bank_code 半角数値 4 単 購入企業IDに対する入金用口座の銀行コードです。
19 支店コード branch_code 半角数値 3 単 購入企業IDに対する入金用口座の銀行支店コードです。
20 口座番号 account_number 半角数値 7 単 購入企業IDに対する入金用口座の口座番号です。
21 コンビニ払い設定 convenience_payment_flag 半角数値 1 単 購入企業IDに対するコンビニ払い設定です。
22 配送先情報 dest_information － － 対象取引の配送先情報です。
23 企業名 dest_company_name 全角 30以内 対象取引に対する配送先企業名です。
24 部署名 dest_department 全角 30以内 対象取引に対する配送先部署名です。
25 担当者名 dest_customer_name 全角 15以内 対象取引に対する配送先担当者名です。
26 担当者名（カナ） dest_customer_name_kana 全角 15以内 対象取引に対する配送先担当者名 （カナ）です。
27 郵便番号 dest_zip 半角 8以内 対象取引に対する配送先郵便番号です。
28 住所 dest_address 全角 50以内 対象取引に対する配送先住所です。
29 電話番号 dest_tel 半角 13以内 対象取引に対する配送先電話番号です。
30 取引情報 transaction_information － － 単 対象取引の取引情報です。
31 取引金額 transaction_amount 半角 15以内 単 対象取引の取引金額です。
32 請求書送付方法 billed_type 半角数値 1 単 対象取引の請求書送付方法です。
33 審査結果 authori_result 半角数値 1 単 ★ １
34 キャンセル cancel_flag 半角数値 1 単 ★ ２
35 請求依頼 sales_flag 半角数値 1 単 ★ ３
36 請求書締日 target_date 半角 10 単 ★ ４
37 購入企業支払期限日 receipts_due_date 半角 10 単 ★ ５
38 加盟店振込ステータス payment_status 半角 2 単 ★ ６
39 状態確認NG結果 confirm_NG_result － － 複 取引状態確認NGの取引情報
40 NP取引ID np_transaction_id 半角数値 11 単 取引状態確認NGのNP取引ID
41 加盟店取引ID shop_transaction_id 半角英数 40以下 単 設定されません。
42 エラーリスト error_list － － 複 取引状態確認NGのエラー内容 リスト
43 エラー番号 error_no 半角英数 6 単 エラー番号が設定されます。
44 エラー種別 error_level 半角 1 単 エラー種別が設定されます。
45 エラー内容 error_contents 全角 100以下 単 エラー内容が設定されます。













導入の手引き


システム環境

SOAP通信が可能なプラットフォームであれば、システム接続サービスの利用が可能です。
代表的なプラットフォームには以下の様なものがあります。


接続情報

NP決済システムのシステム接続サービスを利用するうえで、必要な接続情報について記載します。


WSDL

システム接続サービスのWebサービスは、WSDL文書にて接続仕様を公開しています。
以下のURLにアクセスすることで、WSDL文書を取得することができます。
https://bss.netprotections.com/npcb/services/NPConnectPro?wsdl

WSDLにはWebサービスの接続先や、どのようなインターフェースが存在するのかが記載されておりますので、WSDLを取得し接続情報として利用してください。


該当インターフェース一覧

インターフェース 種別 電文ID メソッド
取引登録 取引登録依頼 データ送信 XU0010 POST
取引登録結果 結果データ取得 XD0010 GET
取引修正 取引修正依頼 データ送信 XU0030 POST
取引修正結果 結果データ取得 XD0030 GET
取引キャンセル 取引キャンセル依頼 データ送信 XU0040 POST
取引キャンセル結果 結果データ取得 XD0040 GET
審査結果 審査結果取得 定期データ取得 XD1010 GET
請求依頼 請求依頼依頼 データ送信 XU0020 POST
請求依頼結果 結果データ取得 XD0020 GET
取引状態確認 取引状態確認依頼 データ送信 XU0050 POST
取引状態確認結果 結果データ取得 XD0050 GET

タイムアウト

通信中にタイムアウトが発生した場合には、加盟店様システムよりリトライを実施してください。

接続処理プログラム　サンプル

代表的なプラットフォームにおけるSOAP通信の接続処理のサンプルコードを記載します。


Java

  ApacheAxisを使用した接続処理の例を記載します。

  import org.apache.axis.client.Call;

  import org.apache.axis.client.Service;

  import org.apache.axis.encoding.XMLType;

  import org.apache.axis.utils.Options;

  import javax.xml.rpc.ParameterMode;

  import javax.xml.rpc.namespace.QName;

  import java.net.URL;


  public class SampleClient {

    public static void main(String args[]) {

      Service service = null;

      Call call = null;

      String ret = null;

      try {

        // Remote Procedure Call の設定

        service = new Service();

        call    = (Call) service.createCall();

        // サービスを提供している URL を記述

        call.setTargetEndpointAddress(

  new URL(“https://bss.netprotections.com/npcb/services/NPConnectPro”)

  );

        // メソッド名を設定

        call.setOperationName("post");

        // メソッドの引数の型を設定

        call.addParameter("headerData", XMLType.XSD_STRING, ParameterMode.PARAM_MODE_IN);

        call.addParameter("rootData", XMLType.XSD_STRING, ParameterMode.PARAM_MODE_IN);

        // 返却値の型を設定

        call.setReturnType( XMLType.XSD_STRING );

        // XML情報の作成

        String headerData = createHeaderXML();

        String rootData = createRootXML();

        // メソッドを実行

        ret = (String)call.invoke( new Object[] { headerData, rootData } );

        System.out.println(ret);

      } catch (Exception e) {

        e.printStackTrace();

      }

    }

  }

※wsdlからStabを作成する開発方式もございます。


Microsoft.NET

VB.NETを使用した接続処理の例を記載します。

  1. wsdlコマンドにてプロキシクラスを自動生成する。
 wsdl /l:VB https://bss.netprotections.com/npcb/services/NPConnectPro?wsdl
  1. NPConnectPro.vbができあがるので、コンパイルする。
  vbc /t:library /r:System.dll /r:System.Web.Services.dll 
    /r:System.Xml.dll NPConnectPro.vb
  1. NPConnectPro.dllが作成されるので、プログラムより利用してWebサービスを呼び出す。
   NPConnectPro npws = new NPConnectPro()
   headerData = createHeaderXML()
   rootData = createRootXML()  
   result = npws.post()

Perl

SOAP:Liteを使用した接続処理の例を記載します。

   #!/usr/bin/perl

   # 1. SOAP Lite のインクルード
   use SOAP::Lite;

   # 2. WSDLの指定
   $service = SOAP::Lite -> service(
      ' https://bss.netprotections.com/npcb/services/NPConnectPro?wsdl');

   # 3.XML情報の作成
   $headerData = createHeaderXML();
   $rootData = createRootXML();

   # 4. WEBサービスの呼び出し
   $result = $service->post($headerData, $rootData);













導入試験


試験環境を用意しておりますので、システム接続サービス導入の際にご利用ください。
試験環境の稼働時間はNP営業日の9:00～22:00です。
18:00以降、1・2時間ほどメンテナンスが行われる場合がございます。


接続情報

試験環境を利用するにあり必要な接続情報を記載します。

WSDL

システム接続サービスのWebサービスは、WSDL文書にて接続仕様を公開しています。
以下のURLにアクセスすることで、WSDL文書を取得することができます。

https://bss-ct.np-kakebarai.com/np_ct/npcb/services/NPConnectPro?wsdl

WSDLにはWebサービスの接続先や、どのようなインターフェースが存在するのかが記載されておりますので、WSDLを取得し接続情報として利用してください。


該当インターフェース一覧


SPコード


試験環境用のSPコードはNPよりお知らせします。

審査結果

試験環境では与信審査の仕組みがないため、取引登録および取引修正に購入企業情報メールアドレスの内容によって、生成される審査結果を指定できるテストモードを用意しております。

メールアドレス（local@任意のドメイン） のローカル部を下表の様に変更してください。

メールアドレス 審査結果 備考
OK@任意のドメイン OK 審査OK
NG@任意のドメイン NG 審査NG
PD@任意のドメイン 保留 審査保留の状態
IR@任意のドメイン 審査中 審査中の状態
上記以外 審査前 審査前の状態となり、審査結果は生成されません。