即時決済 請求書合算

/api/demand/bulk_register

複数の請求情報登録、合算請求書発行、クレジット決済処理まで行います。 決済手段がクレジットカードの場合のみに限られます。 ※請求元差出人複数オプションは未対応です。

アウトライン

• リクエスト
• レスポンス
• 使用例
  • リクエスト例
  • レスポンス例
• エラー

リクエスト

• Path: /api/demand/bulk_register
• Preferred HTTP method: POST
• Accepted content types: application/json
• Encode: UTF-8

Parameters

名前	概要	桁数	種別	必須
user_id	ユーザーID（管理画面へのログインID）	100	メール形式	必須
access_key	アクセスキー	100	半角英数	必須
bill	請求書に属するパラメータ		array

bill (request)

下記のような項目のオブジェクトを持つリスト

名前	概要	桁数	種別	必須
billing_code	請求先コード	20	半角英数 + 記号	必須
billing_individual_number	請求先部署番号	18	数値	(必須)^1
billing_individual_code	請求先部署コード	20	半角英数 + 記号	(必須)^1
billing_method	請求方法 0:送付なし 1:自動メール 2:手動メール 3:自動郵送 4:手動郵送 5:自動メール+自動郵送 6:手動メール+手動郵送 7:手動マイページ配信 (※マイページ機能を利用可能な方のみ設定できます) 8:自動マイページ配信 (※マイページ機能を利用可能な方のみ設定できます)	1	数値	必須
bill_template_code	請求書テンプレートコード 10000:基本テンプレート 10010:シンプル ※合計請求書はご利用いただけません	18	数値	必須
tax	消費税率 画面上で選択できる消費税率のみ入力可能	2	数値	必須
issue_date	初回請求書発行日 ※本日以前で初回請求書送付日、初回決済期限日以前のみ有効	10	日付形式	必須
sending_date	初回請求書送付日 ※本日以前で初回決済期限日以前のみ有効	10	日付形式	必須
deadline_date	初回決済期限 ※本日以前のみ有効	10	日付形式	必須
bs_owner_code	請求元担当者コード ※両端のスペース除去	20	半角英数 + 記号
jb	決済処理方法 仮実同時売上:CAPTURE	7	文字列	必須
bill.detail	請求書詳細に属するパラメータ		array

bill.detail (request)

下記のような項目のオブジェクトを持つリスト

名前	概要	桁数	種別	必須
demand_type	請求タイプ 0:単発 1:定期定額 2:定期従量	1	数値	必須
goods_code	商品コード	100	文字列
link_goods_code	会計ソフト連携用商品コード	33	文字列
goods_name	商品名	60	文字列	必須
price	単価 両端のスペース除去 ※クレジットカード決済のため桁数上限整数7桁	整数7,小数4	数値	(demand_type=0,1時)
quantity	数量 両端のスペース除去	整数6,小数2	数値	(demand_type=0,1時)
unit	単位	3	文字列
tax_category	税区分 0:外税 1:内税 2:対象外 3:非課税	1	数値	必須
tax	消費税率 画面上で選択できる消費税率のみ入力可能 tax_category=0,1の場合のみ有効 ※指定しない場合はbill.taxの値を参照	2	数値
remark	備考	60×17行	文字列
repetition_period_number	繰返し周期 1～60	2	数値	(demand_type=1,2時)
repetition_period_unit	繰返し周期単位 1:月	1	数値	(demand_type=1,2時)
start_date	サービス提供開始日 yyyy/mm/dd	10	日付	必須
repeat_count	繰返し回数 0:設定しない または1～60	2	数値	(demand_type=1,2時)
period_format	対象期間形式 0:○年○月分 1:○年○月○日分 2:○年○月～○年○月 3:○年○月○日～○年○月○日 99:非表示	2	数値	必須
period_value	対象期間 入力可能値:1～60	2	数値	(period_format=2,3時)
period_unit	対象期間単位 1:月	1	数値	(period_format=3時)
period_criterion	基準 0:対象期間開始日 1:対象期間終了日	1	数値	(period_format=2,3時)

レスポンス

• Type: application/json
• Encode: UTF-8

Fields

名前	概要	型
user	ユーザに属するパラメータ	object

user

名前	概要	型
user_id	ユーザID	string
demand	請求書に属するパラメータ	array

demand (response)

下記のような項目のオブジェクトを持つリスト

名前	概要	型
demand	請求情報に属するパラメータ
billing_code	請求先コード	string
billing_name	請求先名	string
billing_individual_number	請求先部署番号	int
billing_individual_code	請求先部署コード	string
billing_individual_name	請求先部署名	string
payment_method	決済手段	int
code	請求情報番号	int
type	請求タイプ 0:単発 1:定期定額 2:定期従量	int
goods_code	商品コード	string
link_goods_code	会計ソフト連携用商品コード	string
goods_name	商品名	string
price	単価	string
quantity	数量	string
unit	単位	string
tax_category	税区分 0:外税 1:内税 2:対象外 3:非課税	int
tax	消費税率 画面上で選択できる消費税率のみ入力可能 ※「tax_category = 3:対象外、4:非課税」の場合、空白	int
withholding_tax	源泉所得税設定 0:無し 1:有り ※請求情報登録画面上にこの項目が表示されていない場合は0固定。	int
remark	備考	string
billing_method	請求方法 0:送付なし 1:自動メール 2:手動メール 3:自動郵送 4:手動郵送 5:自動メール+自動郵送 6:手動メール+手動郵送 7:手動マイページ配信 8:自動マイページ配信	int
repetition_period_number	繰返し周期 1～60	string
repetition_period_unit	繰返し周期単位 1:月	string
start_date	サービス提供開始日 yyyy/mm/dd	date
end_date	最終サービス提供期間 yyyy/mm/dd ※repeat_count=0の場合はNULL	date
repeat_count	繰返し回数 0:設定しない または1～60 ※demand_type=1,2以外は”1”固定	string
period_format	対象期間形式 0:○年○月分 1:○年○月○日分 2:○年○月～○年○月 3:○年○月○日～○年○月○日 99:非表示	int
period_value	対象期間 ※period_format=2,3以外はNULL	int
period_unit	対象期間単位 1:月 ※period_format=3以外はNULL	string
period_criterion	基準 0:対象期間開始日 1:対象期間終了日 ※period_format=2,3以外は0	string
issue_month	請求書発行日_月	int
issue_day	請求書発行日_日	int
sending_month	請求書送付日_月	int
sending_day	請求書送付日_日	int
deadline_month	決済期限_月	int
deadline_day	決済期限_日	int
next_issue_date	次回請求書発行日 yyyy/mm/dd ※次回請求書が存在しない場合はNULL	date
bill_template_code	請求書テンプレートコード	int
jb	決済処理方法	string
bs_owner_code	請求元担当者コード	string

bill (response)

下記のような項目のオブジェクトを持つリスト
※下記以外のパラメータも含まれていますが、demandと同じであるため省略しています。値はnullになります。具体的な構成は レスポンス例 をご参照ください。

名前	概要	型
error_code	エラーコード※正常時はnull	int
error_message	エラーメッセージ※正常時はnull	string
ec	決済エラーコード※正常時又はerror_codeが234以外の時はnull	string

使用例

リクエスト例

{
    "user_id": "sample@robotpayment.co.jp",
    "access_key": "xxxxxxxxxxxxxxxx",
    "bill": [
        {
            "billing_code": "billing",
            "billing_individual_number": 1,
            "billing_method": 0,
            "bill_template_code": 10010,
            "tax": 8,
            "issue_date": "2014/11/11",
            "sending_date": "2014/11/12",
            "deadline_date": "2014/11/13",
            "bs_owner_code": "bs_owner_code",
            "jb": "CAPTURE",
            "bill_detail": [
                {
                    "demand_type": 0,
                    "goods_code": "goods",
                    "link_goods_code": "link_goods",
                    "goods_name": "商品",
                    "price": 1000,
                    "quantity": 1,
                    "unit": "円",
                    "tax_category": 0,
                    "remark": "備考",
                    "repetition_period_number": null,
                    "repetition_period_unit": null,
                    "start_date": "2014/11/11",
                    "repeat_count": null,
                    "period_format": 0,
                    "period_value": null,
                    "period_unit": null,
                    "period_criterion": 0
                }
            ]
        }
    ]
}

レスポンス例

Status: 200 OK

{
    "user": {
        "user_id": "sample@robotpayment.co.jp",
        "demand": {
            "billing_code": "billing",
            "billing_name": "請求先名",
            "billing_individual_number": 1,
            "billing_individual_code": "bicd0001",
            "billing_individual_name": "請求先部署名",
            "payment_method": 0,
            "code": 1,
            "type": 0,
            "goods_code": "goods",
            "link_goods_code": "link_goods",
            "goods_name": "商品",
            "price": "1000.0000",
            "quantity": "1.00",
            "unit": "円",
            "tax_category": 0,
            "tax": 8,
            "withholding_tax": 0,
            "remark": "備考",
            "billing_method": 0,
            "repetition_period_number": null,
            "repetition_period_unit": null,
            "start_date": "2014/11/11",
            "end_date": "2014/11/30",
            "repeat_count": null,
            "period_format": 0,
            "period_value": null,
            "period_unit": null,
            "period_criterion": "0",
            "issue_month": 0,
            "issue_day": 1,
            "sending_month": 0,
            "sending_day": 1,
            "deadline_month": 0,
            "deadline_day": 1,
            "next_issue_date": "2014/11/01",
            "bill_template_code": 10010,
            "jb": "CAPTURE",
            "bs_owner_code": "bs_owner_code"
        }
    }
}

エラーが発生した時のレスポンス例

{
    "user": {
        "user_id": "sample@robotpayment.co.jp",
        "bill": [
            {
                "error_code": 234,
                "error_message": "Credit Payment failure",
                "number": null,
                "billing_code": null,
                "billing_name": null,
                "billing_individual_number": null,
                "billing_individual_code": null,
                "billing_individual_name": null,
                "issue_date": null,
                "sending_date": null,
                "payment_status": null,
                "bill_carryover_payment_status": null,
                "deadline_date": null,
                "payment_method": null,
                "demand_number": null,
                "subtotal_amount_billed": null,
                "consumption_tax_amount": null,
                "total_bill_detail_consumption_tax_amount": null,
                "withholding_tax_amount": null,
                "total_amount_billed": null,
                "billing_method": null,
                "carryover_total_amount_billed": null,
                "ec": "ER003",
                "bs_owner_code": null,
                "carryover_payment_complete_date": null,
                "transfer_date": null,
                "update_date": "",
                "bill_detail": [
                    {
                        "error_code": null,
                        "error_message": null,
                        "goods_code": null,
                        "goods_name": null,
                        "unit_price": "",
                        "quantity": "",
                        "unit": null,
                        "subtotal_amount_billed": null,
                        "consumption_tax_amount": null,
                        "total_amount_billed": null
                    }
                ]
            }
        ]
    }
}

エラー

共通エラー

決済システムエラーコード

個別エラー

エラーコード	内容
201	請求先部署が存在しない
202	請求先部署の登録ステータスが不正
203	請求タイプが不正
204	商品コードが不正
205	会計ソフト連携用商品コードが不正
206	商品名が不正
207	単価が不正
208	数量が不正
209	単位が不正
210	税区分が不正
211	消費税率が不正
212	源泉所得税設定が不正
213	備考が不正
214	請求方法が不正
215	繰返し周期が不正
216	繰返し周期単位が不正
217	サービス提供開始日が不正
218	繰返し回数が不正
219	対象期間形式が不正
220	対象期間が不正
221	対象期間単位が不正
222	基準が不正
223	請求書発行日_月が不正
224	請求書発行日_日が不正
225	請求書送付日_月が不正
226	請求書送付日_日が不正
227	決済期限_月が不正
228	決済期限_日が不正
229	請求書テンプレートコードが不正
230	請求情報登録に失敗
231	請求先部署の決済手段がクレジット以外(即時決済APIのみ)
232	jbが不正(即時決済APIのみ)
233	請求書発行に失敗(即時決済APIのみ)
234	クレジット決済に失敗(即時決済APIのみ)
235	請求元担当者コードが不正
236	仕訳作成に失敗(即時決済APIのみ)
237	請求先コードが不正
238	請求先部署番号または請求先部署コードが不正
239	請求書発行日が不正 - 入力がない場合 - 日付形式でない場合 - リクエスト日より未来の場合 - サービス提供開始月と次回請求書発行月の差の絶対値が60より大きい場合 - 請求書が本日以前に2回以上発行される場合
240	請求書送付日が不正 - 入力がない場合 - 日付形式でない場合 - サービス提供開始月と次回請求書送付月の差の絶対値が60より大きい場合
241	決済期限日が不正 - 入力がない場合 - 日付形式でない場合 - リクエスト日より未来の場合 - サービス提供開始月と次回決済期限月の差の絶対値が60より大きい場合
242	請求書発行件数が不正 リクエストした請求書が1件より多い場合
243	既に締められた期間への請求書発行日は設定できません
244	既に締められた期間への売上計上日の指定はできません

---

TOPへ戻る