システム接続サービス V2.02
事前審査型スキーム用IFマニュアル
Ver. 2.02 | Net Protections,INC.
Copyright（C）Net Protections,Inc. All Rights Reserved.
改版履歴
| 版数 | 日付 | 改版内容 |
|---|---|---|
| 1.00 | 2017年8月2日 | 初版 |
| 1.01 | 2017年9月14日 | 購入企業登録、購入企業情報修正,購入企業審査結果取得 のIFについての情報を追加 利用可能文字として下記を追加 NEC特殊文字（１３区） NEC選定IBM拡張文字（８９区～９２区） IBM拡張文字（１１５区～１１９区） |
| 1.02 | 2017年12月19日 | 導入試験用WSDLの変更 |
| 2.00 | 2020年11月27日 | モデル名の変更に伴い、該当箇所の記載を変更 [変更前] → [変更後] NP掛け払い基本モデル（請求依頼あり）→ 通販モデル NP掛け払い月額課金モデル（請求依頼なし）→ 月額サービスモデル（事前審査なし） NP掛け払い事前審査モデル（請求依頼あり）→ 営業販売モデル NP掛け払い事前審査モデル（請求依頼なし）→ 月額サービスモデル |
| 2.01 | 2022年7月13日 | コンビニ払い設定の追加に伴い、下記リクエストに項目を追加 購入企業登録依頼 購入企業情報修正依頼 |
| 2.02 | 2024年7月10日 | 購入企業IDの許容桁数が25桁から50桁となることに伴い、リクエスト・レスポンスの桁数を変更 |
目次
事前審査型スキーム⽤ IF 概要
本書は、事前審査型スキーム（営業販売モデル・月額サービス［事前審査あり］モデル）の企業様（以降、加盟店）の内、株式会社ネットプロテクションズが提供する（以降NP）システム接続サービスをご利用いただく企業様を対象とした説明書です。
システム接続サービスにつきましては、別紙「システム接続サービス導入マニュアル」をご参照ください。
また、各IFの概要につきましては、別紙「システム接続サービス導入マニュアル」17ページから21ページをご参照ください。
基本インターフェースとの違い
インターフェース方式
概要
SOAPの方式に則ったWeb APIを提供します。通信プロトコル
HTTPSを利用し、通信データを暗号化したうえで、HTTPのルールに則り通信を行います。
- HTTPメソッド
SOAPの方式を採用し、POSTを使用します。
接続情報①
購入企業登録、購入企業審査結果、購入企業情報修正は、下記WSDL文書にて接続仕様を公開しています。
以下のURLにアクセスすることで、WSDL文書を取得することができます。
基本インターフェースとは異なるWSDLとなるためご注意ください。
https://bss.netprotections.com/npcb2/services/NPConnectPro2/NpApiBuyerWebserviceEndpoint.wsdl
WSDLには接続先や、どのようなインターフェースが存在するのかが記載されておりますので、WSDLを取得し接続情報として利用してください。
NpApiBuyerWebserviceEndpoint
購入企業に関するインターフェースのWebサービス名です。
requestBuyerRegistrationメソッド
購入企業登録依頼を利用する際に使用してください。
getBuyerRegistrationResultメソッド
購入企業登録結果を利用する際に使用してください。
getBuyerAuthorizationResultメソッド
購入企業審査結果を利用する際に使用してください。
requestBuyerModificationメソッド
購入企業情報修正依頼を利用する際に使用してください。
getBuyerModificationResultメソッド
購入企業情報修正結果を利用する際に使用してください。
該当インターフェース一覧
- 購入企業登録
- 購入企業審査結果
- 購入企業情報修正
| インターフェース | 種別 | 電文ID | メソッド | |
|---|---|---|---|---|
| 購入企業登録 | 購入企業登録依頼 | データ送信 | － | requestBuyerRegistration |
| 購入企業登録結果 | 結果データ取得 | － | getBuyerRegistrationResult | |
| 購入企業審査結果 | 購入企業審査結果 | 定期データ取得 | － | getBuyerAuthorizationResult |
| 購入企業情報修正 | 購入企業情報修正依頼 | データ送信 | － | requestBuyerModification |
| 購入企業情報修正結果 | 結果データ取得 | － | getBuyerModificationResult |
接続情報②
与信ステータス取得は、下記WSDL文書にて接続仕様を公開しています。 以下のURLにアクセスすることで、WSDL文書を取得することができます。 基本インターフェースとは異なるWSDLとなるためご注意ください。
https://bss.netprotections.com/npcb2/services/NPConnectPro2/NpApiCreditWebserviceEndpoint.wsdl
WSDLには接続先や、どのようなインターフェースが存在するのかが記載されておりますので、WSDLを取得し接続情報として利用してください。
NpApiCreditWebserviceEndpoint
与信ステータス取得のWebサービス名です。
getCreditStatusメソッド
与信ステータス取得を利用する際に使用してください。
該当インターフェース一覧
- 与信ステータス取得
| インターフェース | 種別 | 電文ID | メソッド | |
|---|---|---|---|---|
| 与信ステータス取得 | 与信ステータス取得 | 定期データ取得(日次) | － | getCreditStatus |
認証情報
基本インターフェース同様端末ID/SPコードを利用して認証を行います。端末ID
加盟店様のシステムを一意に識別する為のIDです。
システム接続サービスをご導入頂く加盟店様へNPより端末IDをお知らせしています。
SPコード
システム接続サービスが加盟店様を一意に識別する為のコードです。
システム接続サービスをご導入頂く加盟店様へNPよりSPコードをお知らせしています。
リクエスト/レスポンスサンプル
基本インターフェースリクエストサンプル
基本インターフェースレスポンスサンプル
事前審査型スキーム用IFリクエストサンプル
事前審査型スキーム用IFレスポンスサンプル
データ仕様
送受信データ
加盟店様のシステムとNP決済システム間で送受信されるインターフェースデータはSOAP形式です。
文字コード
文字コードは、UTF-8をご使用ください。
ShiftJIS等の文字コードをご利用の際には、UTF-8へのエンコーディングをお願い致します。
なお、NP決済システムで使用可能な文字は以下のものとなっております。
JIS X 0208に準拠した以下の文字
- 半角ダブルクォート・半角シングルクォート・半角カンマを除く、ASCII文字
- 非漢字（０１区～０８区）
- NEC特殊文字（13区）
- JIS第１水準漢字（１６区～４７区）
- JIS第２水準漢字（４８区～８４区）
- NEC選定IBM拡張文字（８９区～９２区）
- IBM拡張文字（１１５区～１１９区）
上記以外の文字を利用した場合、購入企業様や加盟店様に対するメールの内容、請求書の内容に文字化けが発生する可能性がございます。
チェック仕様
インターフェースデータのデータチェックの仕様は以下の４種類に分類されます。詳細については、インターフェース毎のチェック仕様をご参照ください。
必須項目チェック
データ項目毎の設定有無をチェックします。
データ型チェック
データ項目毎のデータ型をチェックします。
| データ型 | 使用可能文字 |
|---|---|
| 半角 | 半角文字のみ使用可能です。 |
| 半角数値 | 半角の数字のみ使用可能です。 |
| 半角英数 | 半角のアルファベットと数字のみ使用可能です。 |
| 日付 | 日付形式のみ使用可能です。 書式（YYYY/MM/DDなど）については、項目によって異なります。 |
| 全角 | 全角文字のみ使用可能です。 |
| 全角カナ | 全角カタカナのみ使用可能です。 |
桁数（文字数）チェック
データ項目毎の文字数をチェックします。
条件チェック
データ項目に対する妥当性チェック、データ項目間の相関チェックを行います。
購入企業登録インターフェース
購入企業登録依頼（NPCB2_SSBY0001）
詳細情報
| No | 項目名 | タグ名 | 説明 | 設定値（例） | ||||
|---|---|---|---|---|---|---|---|---|
| 1 | 購入企業登録依頼リクエスト | buyerRegistrationRequest | データブロックを表します | |||||
| 2 | API共通リクエストヘッダ | apiCommonRequestHeader | ヘッダ-情報のデータブロックを表します | |||||
| 3 | 端末ID | terminalId | 認証に利用する端末IDです | 4010000006 | ||||
| 4 | SPコード | spCode | 認証に利用するSPコードです | sp01900187 | ||||
| 5 | バージョン | version | バージョンです | 1.00 | ||||
| 6 | 購入企業登録依頼パラメータ | buyerRegistrationParameter | 詳細情報のデータブロックを表します | |||||
| 7 | 購入企業情報リスト | buyerInfoList | 購入企業情報のリストです。 | |||||
| 8 | 購入企業情報 | buyerInfo | 購入企業のデータブロックを表します | |||||
| 9 | 購入企業ID | buyerId | 購入企業IDです | |||||
| 10 | 購入企業名 | companyName | 購入企業の購入企業名です。 | |||||
| 11 | 部署名 | department | 購入企業の部署名です。 | |||||
| 12 | 担当者名 | customerName | 購入企業の担当者名です。 | |||||
| 13 | 郵便番号 | zip | 購入企業の郵便番号です。 | 107-0052 | ||||
| 14 | 住所 | address | 購入企業の住所です。 | |||||
| 15 | 電話番号 | tel | 購入企業の電話番号です。 | 03-9999-9999 | ||||
| 16 | FAX番号 | fax | 購入企業のFAX番号です。 | |||||
| 17 | メールアドレス | 購入企業のメールアドレスです。 | np@netprotections.co.jp | |||||
| 18 | 請求書送付方法 | invoicePostingType | 請求書送付方法です。 | 1 | ||||
| 19 | コンビニ払い設定 | conveniencePaymentFlag | コンビニ払い設定です。 | 1 | ||||
| 20 | 上限審査希望フラグ | authorizationFlag | 上限審査の希望フラグです。 | 1 | ||||
チェック仕様
| No | 項目名 | タグ名 | 型 | 桁数 | 必須 | タグ | 条件チェック | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | 購入企業登録依頼リクエスト | buyerRegistrationRequest | － | － | 単 | ||||||
| 2 | API共通リクエストヘッダ | apiCommonRequestHeader | － | － | 単 | ||||||
| 3 | 端末ID | terminalId | 半角数値 | 10 | ○ | 単 | 認証可能であること | ||||
| 4 | SPコード | spCode | 半角英数 | 10 | ○ | 単 | 認証可能であること | ||||
| 5 | バージョン | version | 半角 | 4 | ○ | 単 | 1.00であること | ||||
| 6 | 購入企業登録依頼パラメータ | buyerRegistrationParameter | － | － | 単 | ||||||
| 7 | 購入企業情報リスト | buyerInfoList | － | － | 単 | ||||||
| 8 | 購入企業情報 | buyerInfo | － | － | ○ | 複 | |||||
| 9 | 購入企業ID | buyerId | 半角英数 | 以下 | ○ | 単 | ★ 1 | ||||
| 10 | 購入企業名 | companyName | 全角 | 30以下 | ○ | 単 | |||||
| 11 | 部署名 | department | 全角 | 30以下 | 単 | ||||||
| 12 | 担当者名 | customerName | 全角 | 15以下 | 単 | ||||||
| 13 | 郵便番号 | zip | 半角 | 8以内 | ○ | 単 | ★ 2 （ハイフンは省略可） | ||||
| 14 | 住所 | address | 全角 | 50以下 | ○ | 単 | ★ 2 | ||||
| 15 | 電話番号 | tel | 半角数値 | 13以下 | ○ | 単 | （ハイフンは省略可） | ||||
| 16 | FAX番号 | fax | 半角数値 | 15以下 | 単 | （ハイフンは省略可） | |||||
| 17 | メールアドレス | 半角英数 | 100以下 | ○ | 単 | ★ 3 メールアドレス形式 | |||||
| 18 | 請求書送付方法 | invoicePostingType | 半角数値 | 1 | 単 | 1：郵送 2：メール | |||||
| 19 | コンビニ払い設定 | conveniencePaymentFlag | 半角数値 | 1 | 単 |
★
4 0：なし 1：あり |
|||||
| 20 | 上限審査希望フラグ | authorizationFlag | 半角数値 | 1 | 単 |
★
5 0：希望しない 1：希望する |
|||||
結果情報
| No | 項目名 | タグ名 | 型 | 桁数 | 必須 | タグ | 設定内容 | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | 購入企業登録依頼レスポンス | buyerRegistrationResponse | － | － | 単 | ||||||
| 2 | API共通レスポンスヘッダ | apiCommonResponseHeader | － | － | 単 | ||||||
| 3 | エラーリスト | errorList | － | － | 単 | エラー内容リスト | |||||
| 4 | エラー情報 | errorInfo | － | － | 複 | ||||||
| 5 | エラー番号 | errorNo | 半角英数 | 6 | 単 | エラー番号が設定されます。 | |||||
| 6 | エラー種別 | errorLevel | 半角 | 1 | 単 | エラー種別が設定されます。 | |||||
| 7 | エラー内容 | errorContents | 全角 | 100以下 | 単 | エラー内容が設定されます。 | |||||
| 8 | 処理結果 | buyerRegistrationResult | － | － | 単 | ||||||
| 9 | 受付番号 | acceptNo | 半角英数 | 14 | ○ | 単 | 受付番号が設定されます。 | ||||
★ 1：購入企業IDは、半角英数以外に、「-（ハイフン）_（アンダーバー）.（ドット）@（アットマーク）」が利用可能。
★ 2：郵便番号と住所の相関関係が正しいこと。
★ 3：請求書送付方法がメールの場合は必須。
メールアカウント部は、半角英数以外に、「-（ハイフン）_（アンダーバー）.（ドット）!（エクスクラメーションマーク）#（シャープ）$（ドル）*（アスタリスク）+（プラス）/（スラッシュ）=（イコール）?（クエスチョンマーク）^（カレット）`（バッククオート）、{（左中括弧）、|（縦線）}（右中括弧）~（チルダ）%（パーセント）&（アンド）」が利用可能
メールドメイン部は、半角英数以外に、「-（ハイフン）.（ドット）」が利用可能
★ 4：請求書送付方法が2（メール）の場合、コンビニ払い設定1（あり）は指定できませんのでご注意ください。
また、未設定の場合は請求書発行時点での「コンビニ払いデフォルト設定（郵送）」が適用されます。
★ 5：事前審査型スキームをご利用の場合、設定内容に関わらず購入企業審査が行われます。
購入企業登録結果（NPCB2_SSBY0002）
詳細情報
| No | 項目名 | タグ名 | 説明 | 設定値（例） | ||
|---|---|---|---|---|---|---|
| 1 | 購入企業登録結果取得リクエスト | buyerRegistrationResultRequest | データブロックを表します | |||
| 2 | API共通リクエストヘッダ | apiCommonRequestHeader | ヘッダ-情報のデータブロックを表します | |||
| 3 | 端末ID | terminalId | 認証に利用する端末IDです | 4010000006 | ||
| 4 | SPコード | spCode | 認証に利用するSPコードです | sp01900187 | ||
| 5 | バージョン | version | バージョンです | 1.00 | ||
| 6 | 購入企業登録結果取得パラメータ | buyerRegistrationResultParameter | 詳細情報のデータブロックを表します | |||
| 7 | 受付番号 | acceptNo | 購入企業登録依頼時に初番した受付番号です | 10000000000001 | ||
チェック仕様
| No | 項目名 | タグ名 | 型 | 桁数 | 必須 | タグ | 条件チェック | |||
|---|---|---|---|---|---|---|---|---|---|---|
| 1 | 購入企業登録結果取得リクエスト | buyerRegistrationResultRequest | － | － | － | 単 | ||||
| 2 | API共通リクエストヘッダ | apiCommonRequestHeader | － | － | － | 単 | ||||
| 3 | 端末ID | terminalId | 半角数値 | 10 | ○ | 単 | 認証可能であること | |||
| 4 | SPコード | spCode | 半角英数 | 10 | ○ | 単 | 認証可能であること | |||
| 5 | バージョン | version | 半角 | 4 | ○ | 単 | 1.00であること | |||
| 6 | 与信ステータス取得パラメータ | buyerRegistrationResultParameter | － | － | － | 単 | ||||
| 7 | 受付番号 | acceptNo | 半角英数 | 14 | ○ | 単 | 有効な受付番号であること | |||
結果情報
| No | 項目名 | タグ名 | 型 | 桁数 | 必須 | タグ | 設定内容 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | 購入企業登録結果取得レスポンス | buyerRegistrationResultResponse | － | － | 単 | ||||||||||||
| 2 | API共通レスポンスヘッダ | apiCommonResponseHeader | － | － | 単 | ||||||||||||
| 3 | エラーリスト | errorList | － | － | 単 | エラー内容リスト | |||||||||||
| 4 | エラー情報 | errorInfo | － | － | 複 | ||||||||||||
| 5 | エラー番号 | errorNo | 半角英数 | 6 | 単 | エラー番号が設定されます。 | |||||||||||
| 6 | エラー種別 | errorLevel | 半角 | 1 | 単 | エラー種別が設定されます。 | |||||||||||
| 7 | エラー内容 | errorContents | 全角 | 100以下 | 単 | エラー内容が設定されます。 | |||||||||||
| 8 | 処理結果 | buyerRegistrationResultResponse | － | － | 単 | ||||||||||||
| 9 | 処理情報 | processInfo | － | － | 単 | ||||||||||||
| 10 | 受付番号 | acceptNo | 半角英数 | 14 | ○ | 単 | |||||||||||
| 11 | 処理時間 | processDate | 半角数値 | 14 | ○ | 単 | 処理を開始した時間 | ||||||||||
| 12 | 購入企業登録結果 | buyerRegistrationResult | － | － | 単 | ||||||||||||
| 13 | 購入企業登録OK結果リスト | buyerRegistrationResultOkList | － | － | 単 | 購入企業登録OKの購入企業情報リスト | |||||||||||
| 14 | 購入企業登録OK結果 | buyerRegistrationResultOk | － | － | ○ | 複 | |||||||||||
| 15 | 購入企業ID | buyerId | 半角英数 | 以下 | ○ | 単 | 登録OKの購入企業ID | ||||||||||
| 16 | 購入企業登録NG結果リスト | buyerRegistrationResultNgList | － | － | 単 | 購入企業登録NGの購入企業情報リスト | |||||||||||
| 17 | 購入企業登録NG結果 | buyerRegistrationResultNg | － | － | ○ | 複 | |||||||||||
| 18 | 購入企業ID | buyerId | 半角英数 | 以下 | ○ | 単 | 登録NGの購入企業ID | ||||||||||
| 19 | エラーリスト | errorList | － | － | 単 | エラー内容 | |||||||||||
| 20 | エラー情報 | errorInfo | － | － | 複 | 登録NGとなったエラー内容が設定されます。 | |||||||||||
| 21 | エラー番号 | errorNo | 半角英数 | 6 | 単 | エラー番号が設定されます。 | |||||||||||
| 22 | エラー種別 | errorLevel | 半角 | 1 | 単 | エラー種別が設定されます。 | |||||||||||
| 23 | エラー内容 | errorContents | 全角 | 100以下 | 単 | エラー内容が設定されます。 | |||||||||||
| 24 | エラーリスト | errorList | － | － | 単 | エラー内容リスト | |||||||||||
| 25 | エラー情報 | errorInfo | － | － | 複 | 結果取得に不備があった際に設定されます。 | |||||||||||
| 26 | エラー番号 | errorNo | 半角英数 | 6 | 単 | エラー番号が設定されます。 | |||||||||||
| 27 | エラー種別 | errorLevel | 半角 | 1 | 単 | エラー種別が設定されます。 | |||||||||||
| 28 | エラー内容 | errorContents | 全角 | 100以下 | 単 | エラー内容が設定されます。 | |||||||||||
購入企業審査結果インターフェース
購入企業審査結果取得（NPCB2_SSBY0003）
詳細情報
| No | 項目名 | タグ名 | 説明 | 設定値（例） | |||
|---|---|---|---|---|---|---|---|
| 1 | 購入企業審査結果取得リクエスト | buyerAuthoriResultRequest | データブロックを表します | ||||
| 2 | API共通リクエストヘッダ | apiCommonRequestHeader | ヘッダ-情報のデータブロックを表します | ||||
| 3 | 端末ID | terminalId | 認証に利用する端末IDです | 4010000006 | |||
| 4 | SPコード | spCode | 認証に利用するSPコードです | sp01900187 | |||
| 5 | バージョン | version | バージョンです | 1.00 | |||
| 6 | 購入企業審査結果取得パラメータ | buyerAuthoriResultParameter | 詳細情報のデータブロックを表します | ||||
| 7 | 購入企業IDリスト | buyerIdList | 結果取得を行う購入企業IDのリストです。 | ||||
| 8 | 購入企業ID | buyerId | 結果取得を行う購入企業IDです。 | B6220 | |||
チェック仕様
| No | 項目名 | タグ名 | 型 | 桁数 | 必須 | タグ | 条件チェック | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | 与信ステータス取得リクエスト | buyerAuthoriResultRequest | － | － | － | 単 | |||||
| 2 | API共通リクエストヘッダ | apiCommonRequestHeader | － | － | － | 単 | |||||
| 3 | 端末ID | terminalId | 半角数値 | 10 | ○ | 単 | 認証可能であること | ||||
| 4 | SPコード | spCode | 半角英数 | 10 | ○ | 単 | 認証可能であること | ||||
| 5 | バージョン | version | 半角 | 4 | ○ | 単 | 1.00であること | ||||
| 6 | 購入企業審査結果取得パラメータ | buyerAuthoriResultParameter | － | － | － | 単 | |||||
| 7 | 購入企業IDリスト | buyerIdList | － | － | － | 複 | |||||
| 8 | 購入企業ID | buyerId | 半角英数 | 以下 | ○ | 単 | 有効な購入企業IDであること。 | ||||
結果情報
| No | 項目名 | タグ名 | 型 | 桁数 | 必須 | タグ | 設定内容 | |||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | 購入企業審査結果取得レスポンス | buyerAuthoriResultResponse | － | － | ○ | 単 | ||||||||
| 2 | API共通レスポンスヘッダ | apiCommonResponseHeader | － | － | 単 | |||||||||
| 3 | エラーリスト | errorList | － | － | 単 | エラー内容リスト | ||||||||
| 4 | エラー情報 | errorInfo | － | － | 複 | |||||||||
| 5 | エラー番号 | errorNo | 半角英数 | 6 | 単 | エラー番号が設定されます。 | ||||||||
| 6 | エラー種別 | errorLevel | 半角 | 1 | 単 | エラー種別が設定されます。 | ||||||||
| 7 | エラー内容 | errorContents | 全角 | 100以下 | 単 | エラー内容が設定されます。 | ||||||||
| 8 | 購入企業審査結果 | buyerAuthoriResultResult | － | － | ○ | 単 | ||||||||
| 9 | 購入企業審査結果リスト | buyerAuthoriResultList | － | － | 単 | 購入企業審査結果リスト | ||||||||
| 10 | 購入企業審査結果 | buyerAuthoriResult | － | － | 複 | |||||||||
| 11 | 購入企業ID | buyerId | 半角英数 | 単 | 購入企業IDが設定されます | |||||||||
| 12 | 購入企業審査状況 | buyerAuthoriStatus | 半角英数 | 25以下 | 単 | ★ １ | ||||||||
| 13 | 与信上限金額 | amountCap | 全角 | 30以下 | 単 | 与信上限金額です。 | ||||||||
| 14 | 与信枠適用開始日 | creditFacilityTermBegin | 全角 | 30以下 | 単 | 与信結果の適用開始日です | ||||||||
| 15 | 与信枠適用終了日 | creditFacilityTermEnd | 全角 | 15以下 | 単 | 与信結果の適用終了日です | ||||||||
| 16 | 結果確定日時 | authoriRequiredDate | 日付 | 8 | 単 | NPにて審査結果が確定した日次 | ||||||||
| 17 | 審査結果種別 | resultType | 半角数値 | 2 | 単 | 1：新規 2：更新 | ||||||||
| 18 | エラーリスト | errorList | － | － | 単 | 結果取得に不備があった際に設定されます。 | ||||||||
| 19 | エラー情報 | errorInfo | － | － | 複 | |||||||||
| 20 | エラー番号 | errorNo | 半角英数 | 6 | 単 | エラー番号が設定されます。 | ||||||||
| 21 | エラー種別 | errorLevel | 半角 | 1 | 単 | エラー種別が設定されます。 | ||||||||
| 22 | エラー内容 | errorContents | 全角 | 100以下 | 単 | エラー内容が設定されます。 | ||||||||
★１：結果取得時の購入企業の審査状況です。
01：未申請
02：審査中
03：審査完了
購入企業情報修正インターフェース
購入企業情報修正依頼（NPCB2_SSBY0004）
詳細情報
| No | 項目名 | タグ名 | 説明 | 設定値（例） | ||||
|---|---|---|---|---|---|---|---|---|
| 1 | 購入企業情報修正依頼リクエスト | buyerModificationRequest | データブロックを表します | |||||
| 2 | API共通リクエストヘッダ | apiCommonRequestHeader | ヘッダ-情報のデータブロックを表します | |||||
| 3 | 端末ID | terminalId | 認証に利用する端末IDです | 4010000006 | ||||
| 4 | SPコード | spCode | 認証に利用するSPコードです | sp01900187 | ||||
| 5 | バージョン | version | バージョンです | 1.00 | ||||
| 6 | 購入企業情報変更依頼パラメータ | buyerModificationParameter | 詳細情報のデータブロックを表します | |||||
| 7 | 購入企業情報リスト | buyerInfoList | 購入企業情報のリストです。 | |||||
| 8 | 購入企業情報 | buyerInfo | 購入企業のデータブロックを表します | |||||
| 9 | 購入企業ID | buyerId | 購入企業IDです | |||||
| 10 | 購入企業名 | companyName | 購入企業の購入企業名です。 | |||||
| 11 | 部署名 | department | 購入企業の部署名です。 | |||||
| 12 | 担当者名 | customerName | 購入企業の担当者名です。 | |||||
| 13 | 郵便番号 | zip | 購入企業の郵便番号です。 | 107-0052 | ||||
| 14 | 住所 | address | 購入企業の住所です。 | |||||
| 15 | 電話番号 | tel | 購入企業の電話番号です。 | 03-9999-9999 | ||||
| 16 | FAX番号 | fax | 購入企業のFAX番号です。 | |||||
| 17 | メールアドレス | 購入企業のメールアドレスです。 | np@netprotections.co.jp | |||||
| 18 | 請求書送付方法 | invoicePostingType | 請求書送付方法です。 | 1 | ||||
| 19 | コンビニ払い設定 | conveniencePaymentFlag | コンビニ払い設定です。 | 1 | ||||
| 20 | 上限審査希望フラグ | authorizationFlag | 上限審査の希望フラグです。 | 1 | ||||
チェック仕様
| No | 項目名 | タグ名 | 型 | 桁数 | 必須 | タグ | 条件チェック | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | 購入企業情報修正依頼リクエスト | buyerModificationRequest | － | － | 単 | ||||||
| 2 | API共通リクエストヘッダ | apiCommonRequestHeader | － | － | 単 | ||||||
| 3 | 端末ID | terminalId | 半角数値 | 10 | ○ | 単 | 認証可能であること | ||||
| 4 | SPコード | spCode | 半角英数 | 10 | ○ | 単 | 認証可能であること | ||||
| 5 | バージョン | version | 半角 | 4 | ○ | 単 | 1.00であること | ||||
| 6 | 購入企業情報修正依頼パラメータ | buyerModificationParameter | － | － | 単 | ||||||
| 7 | 購入企業情報リスト | buyerInfoList | － | － | 単 | ||||||
| 8 | 購入企業情報 | buyerInfo | － | － | ○ | 複 | |||||
| 9 | 購入企業ID | buyerId | 半角英数 | 以下 | ○ | 単 | |||||
| 10 | 購入企業名 | companyName | 全角 | 30以下 | ○ | 単 | ★ １ | ||||
| 11 | 部署名 | department | 全角 | 30以下 | 単 | ||||||
| 12 | 担当者名 | customerName | 全角 | 15以下 | 単 | ||||||
| 13 | 郵便番号 | zip | 半角 | 8以内 | ○ | 単 | ★ 2（ハイフンは省略可） | ||||
| 14 | 住所 | address | 全角 | 50以下 | ○ | 単 | ★ 2 | ||||
| 15 | 電話番号 | tel | 半角数値 | 13以下 | ○ | 単 | （ハイフンは省略可） | ||||
| 16 | FAX番号 | fax | 半角数値 | 15以下 | 単 | （ハイフンは省略可） | |||||
| 17 | メールアドレス | 半角英数 | 100以下 | ○ | 単 | ★ 3 メールアドレス形式 | |||||
| 18 | 請求書送付方法 | invoicePostingType | 半角数値 | 1 | 単 | 1：郵送 2：メール | |||||
| 19 | コンビニ払い設定 | conveniencePaymentFlag | 半角数値 | 1 | 単 |
★
4 0：なし 1：あり |
|||||
| 20 | 上限審査希望フラグ | authorizationFlag | 半角数値 | 1 | 単 |
★
5 0：希望しない 1：希望する |
|||||
結果情報
| No | 項目名 | タグ名 | 型 | 桁数 | 必須 | タグ | 設定内容 | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | 購入企業情報修正レスポンス | buyerModificationResponse | － | － | ○ | 単 | |||||
| 2 | API共通レスポンスヘッダ | apiCommonResponseHeader | － | － | 単 | ||||||
| 3 | エラーリスト | errorList | － | － | 単 | エラー内容リスト | |||||
| 4 | エラー情報 | errorInfo | － | － | 複 | ||||||
| 5 | エラー番号 | errorNo | 半角英数 | 6 | 単 | エラー番号が設定されます。 | |||||
| 6 | エラー種別 | errorLevel | 半角 | 1 | 単 | エラー種別が設定されます。 | |||||
| 7 | エラー内容 | errorContents | 全角 | 100以下 | 単 | エラー内容が設定されます。 | |||||
| 8 | 処理結果 | buyerModificationResult | － | － | 単 | ||||||
| 9 | 受付番号 | acceptNo | 半角英数 | 14 | ○ | 単 | 受付番号が設定されます。 | ||||
★1：購入企業審査申請済みの場合、購入企業名は変更できません。
★2：郵便番号と住所の相関が正しいこと。
★3：請求書送付方法がメールの場合は必須。
メールアカウント部は、半角英数以外に、「-（ハイフン）_（アンダーバー）.（ドット）!（エクスクラメーションマーク）#（シャープ）$（ドル）*（アスタリスク）+（プラス）/（スラッシュ）=（イコール）?（クエスチョンマーク）^（カレット）`（バッククオート）、{（左中括弧）、|（縦線）}（右中括弧）~（チルダ）%（パーセント）&（アンド）」が利用可能
メールドメイン部は、半角英数以外に、「-（ハイフン）.（ドット）」が利用可能
★4：請求書送付方法が2（メール）の場合、コンビニ払い設定1（あり）は指定できませんのでご注意ください。
また、未設定の場合は請求書発行時点での「コンビニ払いデフォルト設定（郵送）」が適用されます
★5：購入企業審査済みの場合、設定の内容に関わらず審査は行われません。
購入企業情報修正結果（NPCB2_SSBY0005）
詳細情報
| No | 項目名 | タグ名 | 説明 | 設定値（例） | ||
|---|---|---|---|---|---|---|
| 1 | 購入企業情報修正結果取得リクエスト | buyerModificationResultRequest | データブロックを表します | |||
| 2 | API共通リクエストヘッダ | apiCommonRequestHeader | ヘッダ-情報のデータブロックを表します | |||
| 3 | 端末ID | terminalId | 認証に利用する端末IDです | 4010000006 | ||
| 4 | SPコード | spCode | 認証に利用するSPコードです | sp01900187 | ||
| 5 | バージョン | Version | バージョンです | 1.00 | ||
| 6 | 購入企業情報修正結果取得パラメータ | buyerModificationResultParameter | 詳細情報のデータブロックを表します | |||
| 7 | 受付番号 | acceptNo | 購入企業情報修正依頼時に初番した受付番号です | 10000000000001 | ||
チェック仕様
| No | 項目名 | タグ名 | 型 | 桁数 | 必須 | タグ | 条件チェック | |||
|---|---|---|---|---|---|---|---|---|---|---|
| 1 | 購入企業情報修正結果取得リクエスト | buyerModificationResultRequest | － | － | － | 単 | ||||
| 2 | API共通リクエストヘッダ | apiCommonRequestHeader | － | － | － | 単 | ||||
| 3 | 端末ID | terminalId | 半角数値 | 10 | ○ | 単 | 認証可能であること | |||
| 4 | SPコード | spCode | 半角英数 | 10 | ○ | 単 | 認証可能であること | |||
| 5 | バージョン | version | 半角 | 4 | ○ | 単 | 1.00であること | |||
| 6 | 購入企業情報修正結果取得パラメータ | buyerModificationResultParameter | － | － | － | 単 | ||||
| 7 | 受付番号 | acceptNo | 半角英数 | 14 | ○ | 単 | 有効な受付番号であること | |||
結果情報
| No | 項目名 | タグ名 | 型 | 桁数 | 必須 | タグ | 設定内容 | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | 購入企業情報変更結果取得レスポンス | buyerModificationResultResponse | － | － | 単 | ||||||||||
| 2 | API共通レスポンスヘッダ | apiCommonResponseHeader | － | － | 単 | ||||||||||
| 3 | エラーリスト | errorList | － | － | 単 | エラー内容リスト | |||||||||
| 4 | エラー情報 | errorInfo | － | － | 複 | ||||||||||
| 5 | エラー番号 | errorNo | 半角英数 | 6 | 単 | エラー番号が設定されます。 | |||||||||
| 6 | エラー種別 | errorLevel | 半角 | 1 | 単 | エラー種別が設定されます。 | |||||||||
| 7 | エラー内容 | errorContents | 全角 | 100以下 | 単 | エラー内容が設定されます。 | |||||||||
| 8 | 処理結果 | buyerModificationResultResult | － | － | 単 | ||||||||||
| 9 | 処理情報 | processInfo | － | － | 単 | ||||||||||
| 10 | 受付番号 | acceptNo | 半角英数 | 14 | ○ | 単 | |||||||||
| 11 | 処理時間 | processDate | 半角数値 | 14 | ○ | 単 | 処理を開始した時間 | ||||||||
| 12 | 購入企業情報修正結果 | buyerModificationResult | － | － | 単 | ||||||||||
| 13 | 購入企業情報修正OK結果リスト | buyerModificationResultOkList | － | － | 単 | 購入企業情報修正OKの購入企業情報リスト | |||||||||
| 14 | 購入企業情報修正OK結果 | buyerModificationResultOk | － | － | ○ | 複 | |||||||||
| 15 | 購入企業ID | buyerId | 半角英数 | 以下 | ○ | 単 | 修正OKの購入企業ID | ||||||||
| 16 | 購入企業情報修正NG結果リスト | buyerModificationResultNgList | － | － | 単 | 購入企業情報修正NGの購入企業情報リスト | |||||||||
| 17 | 購入企業情報修正NG結果 | buyerModificationResultNg | － | － | ○ | 複 | |||||||||
| 18 | 購入企業ID | buyerId | 半角英数 | 以下 | ○ | 単 | 修正NGの購入企業ID | ||||||||
| 19 | エラーリスト | errorList | － | － | 単 | エラー内容 | |||||||||
| 20 | エラー情報 | errorInfo | － | － | 複 | 修正NGとなったエラー内容が設定されます。 | |||||||||
| 21 | エラー番号 | errorNo | 半角英数 | 6 | 単 | エラー番号が設定されます。 | |||||||||
| 22 | エラー種別 | errorLevel | 半角 | 1 | 単 | エラー種別が設定されます。 | |||||||||
| 23 | エラー内容 | errorContents | 全角 | 100以下 | 単 | エラー内容が設定されます。 | |||||||||
| 24 | エラーリスト | errorList | － | － | 単 | エラー内容リスト | |||||||||
| 25 | エラー情報 | errorInfo | － | － | 複 | 結果取得に不備があった際に設定されます。 | |||||||||
| 26 | エラー番号 | errorNo | 半角英数 | 6 | 単 | エラー番号が設定されます。 | |||||||||
| 27 | エラー種別 | errorLevel | 半角 | 1 | 単 | エラー種別が設定されます。 | |||||||||
| 28 | エラー内容 | errorContents | 全角 | 100以下 | 単 | エラー内容が設定されます。 | |||||||||
与信ステータス取得インターフェース
与信ステータス取得（NPCB2_SSAT0001）
詳細情報
| No | 項目名 | タグ名 | 説明 | 設定値（例） | ||
|---|---|---|---|---|---|---|
| 1 | 与信ステータス取得リクエスト | getCreditStatusRequest | データブロックを表します | |||
| 2 | API共通リクエストヘッダ | apiCommonRequestHeader | ヘッダ-情報のデータブロックを表します | |||
| 3 | 端末ID | terminalId | 認証に利用する端末IDです | 4010000006 | ||
| 4 | SPコード | spCode | 認証に利用するSPコードです | sp01900187 | ||
| 5 | バージョン | Version | バージョンです | 1.00 | ||
| 6 | 与信ステータス取得パラメータ | creditStatusParameter | 詳細情報のデータブロックを表します | |||
| 7 | 債権保証ステータス更新日（下限） | creditGuaranteeStatusUpdateDateBegin | 債権保証ステータス更新日の下限日付（この日付を含む）です。 ★ １ | 20170729 | ||
| 8 | 債権保証ステータス更新日（上限） | creditGuaranteeStatusUpdateDateEnd | 債権保証ステータス更新日の上限日付です（この日付を含む） ★ １ | 20170731 | ||
チェック仕様
| No | 項目名 | タグ名 | 型 | 桁数 | 必須 | タグ | 条件チェック | |||
|---|---|---|---|---|---|---|---|---|---|---|
| 1 | 与信ステータス取得リクエスト | getCreditStatusRequest | － | － | － | 単 | ||||
| 2 | API共通リクエストヘッダ | apiCommonRequestHeader | － | － | － | 単 | ||||
| 3 | 端末ID | terminalId | 半角数値 | 10 | ○ | 単 | 認証可能であること | |||
| 4 | SPコード | spCode | 半角英数字 | 10 | ○ | 単 | 認証可能であること | |||
| 5 | バージョン | Version | 半角 | 4 | ○ | 単 | 1.00であること | |||
| 6 | 与信ステータス取得パラメータ | creditStatusParameter | － | － | ○ | 単 | ||||
| 7 | 債権保証ステータス更新日（下限） | creditGuaranteeStatusUpdateDateBegin | 半角数値 | 8 | 単 | YYYYMMDD形式 下限が上限より過去の日付であること。 | ||||
| 8 | 債権保証ステータス更新日（上限） | creditGuaranteeStatusUpdateDateEnd | 半角数値 | 8 | 単 | YYYYMMDD形式 | ||||
結果情報
| No | 項目名 | タグ名 | 型 | 桁数 | 必須 | タグ | 設定内容 | |||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | 与信ステータス取得レスポンス | getCreditStatusResponse | － | － | ○ | 単 | ||||||||
| 2 | API共通レスポンスヘッダ | apiCommonResponseHeader | － | － | 単 | |||||||||
| 3 | エラーリスト | errorList | － | － | 単 | エラー内容リスト | ||||||||
| 4 | エラー情報 | errorInfo | － | － | 複 | |||||||||
| 5 | エラー番号 | errorNo | 半角英数 | 6 | 単 | エラー番号が設定されます。 | ||||||||
| 6 | エラー種別 | errorLevel | 半角 | 1 | 単 | エラー種別が設定されます。 | ||||||||
| 7 | エラー内容 | errorContents | 全角 | 100以下 | 単 | エラー内容が設定されます。 | ||||||||
| 8 | 与信ステータス | creditStatusResult | － | － | ○ | 単 | ||||||||
| 9 | 購入企業債権保証状況リスト | creditGuaranteeStatusList | － | － | 単 | 債権保証状況リスト | ||||||||
| 10 | 購入企業債権保証状況 | creditGuaranteeStatus | － | － | 複 | |||||||||
| 11 | NP購入企業ID | npBuyerId | 半角英数 | 11 | 単 | NP購入企業IDが設定されます | ||||||||
| 12 | 購入企業ID | buyerId | 半角英数 | 以下 | 単 | 加盟店にて設定した購入企業IDです | ||||||||
| 13 | 購入企業名 | companyName | 全角 | 30以下 | 単 | 購入企業名 | ||||||||
| 14 | 部署名 | Department | 全角 | 30以下 | 単 | 部署名 | ||||||||
| 15 | 担当者名 | customerName | 全角 | 15以下 | 単 | 担当者名 | ||||||||
| 16 | 債権保証期限日 | creditGuaranteeExpireDate | 日付 | 8 | 単 | NPにて保証が可能な期日 | ||||||||
| 17 | 債権保証ステータス | creditGuaranteeStatus | 半角数値 | 2 | 単 | ★ ２ | ||||||||
| 18 | 債権保証ステータス更新日 | creditGuaranteeStatusUpdateDate | 日付 | 8 | 単 | 債権保証ステータスの更新日 | ||||||||
| 19 | 取引登録期限日 | transactionRegistrationDueDate | 日付 | 8 | 単 | 取引登録が可能な記述。 | ||||||||
| 20 | 取引登録可/不可 | transactionRegistrationStatus | 半角数値 | 2 | 単 | ★ ３ | ||||||||
| 21 | 請求残高 | billedAmount | 半角数値 | 15以下 | 単 | 現在未入金の請求金額。 | ||||||||
| 22 | エラーリスト | errorList | － | － | 単 | エラー内容リスト | ||||||||
| 23 | エラー情報 | errorInfo | － | － | 複 | |||||||||
| 24 | エラー番号 | errorNo | 半角英数 | 6 | 単 | エラー番号が設定されます。 | ||||||||
| 25 | エラー種別 | errorLevel | 半角 | 1 | 単 | エラー種別が設定されます。 | ||||||||
| 26 | エラー内容 | errorContents | 全角 | 100以下 | 単 | エラー内容が設定されます。 | ||||||||
★１：どちらか一方のみの設定も可能です。また、設定していない場合依頼処理日に債権保証
ステータスの変更があった購入企業の情報を返却します。
★２：対象購入企業の債権保証状況です。 00 ：OK 01 ：ALRT 11 ：NG
★３：対象購入企業の取引登録可否ステータスです。 00 ：可 11 ：不可
エラー情報に関しては、別紙「エラーリファレンス」をご参照ください。
導入試験
試験環境を用意しておりますので、システム接続サービス導入の際にご利用ください。
接続情報
試験環境を利用するにあり必要な接続情報を記載します。
WSDL①
購入企業登録、購入企業審査結果、購入企業情報修正は、 下記の導入試験用WSDLを利用し接続情報の取得をお願いいたします。https://bss-ct.np-kakebarai.com/np_ct/npcb2/services/NPConnectPro2/NpApiBuyerWebserviceEndpoint.wsdl
NpApiBuyerWebserviceEndpoint
購入企業に関するインターフェースのWebサービス名です。
requestBuyerRegistrationメソッド
購入企業登録依頼を利用する際に使用してください。
getBuyerRegistrationResultメソッド
購入企業登録結果を利用する際に使用してください。
getBuyerAuthorizationResultメソッド
購入企業審査結果を利用する際に使用してください。
requestBuyerModificationメソッド
購入企業情報修正依頼を利用する際に使用してください。
getBuyerModificationResultメソッド
購入企業情報修正結果を利用する際に使用してください。
該当インターフェース一覧
- 購入企業登録
- 購入企業審査結果取得
- 購入企業情報修正
WSDL②
与信ステータス取得については下記の導入試験用WSDLを利用し接続情報の取得をお願いいたします。
NpApiCreditWebserviceEndpoint
システム接続サービスのWebサービス名です。
getCreditStatusメソッド
与信ステータス取得を利用する際に使用してください。
該当インターフェース一覧
- 与信ステータス取得
SPコード
試験環境用のSPコードはNPよりお知らせします。