出荷確定処理-入出力パラメータ
出荷確定処理
Section titled “出荷確定処理”入力パラメータはPOST、出力パラメータはレスポンス(レスポンスボディにJSON)になります。
動作は出荷確定処理と同じで、有効な納品書印刷済みの受注伝票を出荷確定済みにします。
処理結果はレスポンスのステータスコードで確認します。
入力パラメータ
Section titled “入力パラメータ”| パラメータ | 値 | 省略 | 備考 |
|---|---|---|---|
access_token | access_token取得により取得した値 | 必須(SDKの場合不要) | |
refresh_token | access_token取得により取得した値 | 可能(SDKの場合不要) | 【指定してaccess_tokenの有効期限が切れた場合】 正常に出力パラメータが設定されaccess_tokenとrefresh_tokenが新しい値に更新されます 【省略してaccess_tokenの有効期限が切れた場合】 出力パラメータ「result」の値がredirectになります(成功時以外の出力パラメータ参照) |
wait_flag | 1:メイン機能過負荷でも可能な限りエラーにせず実行1以外:メイン機能過負荷の場合、003002のエラーを返却 | 可能(省略時は1以外とする) | 詳細はパラメータ共通事項「待機フラグについて」を参照して下さい |
receive_order_id | 伝票番号 | 必須 | 出荷確定処理をする受注の伝票番号 |
receive_order_last_modified_date | 最終更新日 | 必須 | 出荷確定処理をする受注の最終更新日。 API実行時にメイン機能またはアプリで、受注伝票が更新されていないかを確認するために利用します。 メイン機能またはアプリで受注伝票が更新されている場合はエラーになります。 エラーになったら再度、受注伝票を検索してAPIを実行して下さい。 |
出力パラメータ
Section titled “出力パラメータ”| パラメータ名 | 値 | 備考 |
|---|---|---|
result | success | success以外の場合の出力パラメータは成功時以外の出力パラメータ参照 |
access_token | 入力パラメータで指定したaccess_token/新たに発行されたaccess_token | 有効なrefresh_tokenを指定してaccess_tokenの有効期限がきれた場合、新たに発行(この時点から1日有効)されたaccess_tokenになります |
refresh_token | 入力パラメータで指定したrefresh_token/新たに発行されたrefresh_token | access_tokenが新しく発行された場合、新たに発行(この時点から3日有効)されたrefresh_tokenになります |
出荷確定処理できる条件
Section titled “出荷確定処理できる条件”以下は受注伝票の項目になります。
| 項目名 | フィールド名 | 条件 |
|---|---|---|
| 伝票番号 | receive_order_id | メイン機能に存在する受注伝票 |
| 受注キャンセル区分 | receive_order_cancel_type_id | 0:キャンセルされていない有効な受注伝票 |
| 受注状態区分 | receive_order_order_status_id | 20または40:納品書印刷待ちまたは納品書印刷済みの受注伝票 |
| 納品書印刷指示日 | receive_order_statement_delivery_instruct_printing_date | 指定されていない、またはAPI実行日以前であること |