受注伝票出荷確定処理
curl -X POST -H 'content-type: application/x-www-form-urlencoded' \ -d 'access_token=xxx&refresh_token=xxx&wait_flag=1&receive_order_id=7&receive_order_last_modified_date=xxx' \ https://api.next-engine.org/api_v1_receiveorder_base/shipped// POST /api_v1_receiveorder_base/shipped - 受注伝票出荷確定処理const params = new URLSearchParams({ access_token: '<access_token>', receive_order_id: '<receive_order_id>', receive_order_last_modified_date: '<receive_order_last_modified_date>',})const res = await fetch('https://api.next-engine.org/api_v1_receiveorder_base/shipped', { method: 'POST', headers: { 'content-type': 'application/x-www-form-urlencoded' }, body: params,})const json = await res.json()if (json.result !== 'success') throw new Error(json.message ?? json.code)console.log(json.data)# POST /api_v1_receiveorder_base/shipped - 受注伝票出荷確定処理import requests
params = { 'access_token': '<access_token>', 'receive_order_id': '<receive_order_id>', 'receive_order_last_modified_date': '<receive_order_last_modified_date>',}res = requests.post( 'https://api.next-engine.org/api_v1_receiveorder_base/shipped', data=params,)json = res.json()if json['result'] != 'success': raise RuntimeError(json.get('message') or json.get('code'))print(json.get('data'))Request Body required
Section titled “Request Body required ”object
OAuth2 アクセストークン (必須)
OAuth2 リフレッシュトークン (access_token 期限切れ時の自動更新に使用)
同期実行フラグ。“1” 指定で処理完了を待つ
取得するフィールドをカンマ区切りで指定 (search 系のみ)
検索開始位置 (search 系のみ)
取得件数 (search 系のみ)
伝票番号 / 出荷確定処理をする受注の伝票番号
最終更新日 / 出荷確定処理をする受注の最終更新日。 API実行時にメイン機能またはアプリで、受注伝票が更新されていないかを確認するために利用します。 メイン機能またはアプリで受注伝票が更新されている場合はエラーになります。 エラーになったら再度、受注伝票を検索してAPIを実行して下さい。
Responses
Section titled “ Responses ”実行結果 (result が success / error / redirect のいずれか)
object
実行結果ステータス
エラー時のエラーコード
object
更新後のアクセストークン
アクセストークン有効期限 (YYYY-MM-DD HH:MM:SS)
更新後のリフレッシュトークン
リフレッシュトークン有効期限
エンドポイント固有のレスポンスデータ
Count/search 系のヒット件数 (form-urlencoded レスポンスでは文字列で返ることがある)
object
店舗コード / 数値型 / 店舗マスタの店舗コード
伝票番号 / 数値型 / ネクストエンジン内で一意に付与される番号
受注番号 / 文字列型 / 原則、店舗内で一意に付与される番号(重複する可能性あり。)
受注日 / 日時型 / 店舗側で受注した日
取込日 / 日時型 / ネクストエンジンに取り込まれた日
重要チェック区分 / 文字列型 / 1:重要
重要チェック名 / 文字列型 / 重要チェックを付けた担当者名
確認チェック区分 / 文字列型 / 0:確認不要1:確認必要2:確認済み
確認チェック名 / 文字列型 / 確認チェックを付けた担当者名
受注確認内容ID / 文字列型 / 受注確認内容IDが”:“区切りで設定されます。明細行に対する確認は”#“の後に明細行番号が設定されます。Ex: “AO:AA#1:AA#2”の場合送り先の郵便番号と住所があってません。商品コードが商品マスタに存在しません。:1行目商品コードが商品マスタに存在しません。:2行目
メール送信状態値 / 文字列型 / 次の値によりどの種類のメール送信が終了したかを表します。区切り文字はありません。例えばJHとあれば受注メールと発送完了メールが送信済みです。 J:受注確認メール B:印刷日待ち連絡メール C:印刷待ち以降連絡メール H:発送メール N:入金確認メール F:フォローメール
受注分類タグ / 文字列型 / []区切りでタグの名称が設定されている。受注分類タグ自体の検索には未対応。例:[連絡待ち][ゴールド会員]
取込種類区分 / 文字列型 / 0:メール1:CSV2:手入力
取込種類名 / 文字列型
受注キャンセル区分 / 文字列型 / 受注キャンセル区分
受注キャンセル名 / 文字列型
受注キャンセル日 / 日時型
受注状態区分 / 文字列型 / 受注状態区分
受注状態名 / 文字列型
発送方法区分 / 文字列型 / 発送方法区分
発送方法名 / 文字列型
支払区分 / 文字列型 / 支払区分受注伝票の支払方法の値
支払名 / 文字列型
総合計 / 数値型 / 商品計+税金+手数料+発送代+他費用-ポイント数
税金 / 数値型
手数料 / 数値型
発送代 / 数値型
他費用 / 数値型
ポイント数 / 数値型
商品計 / 数値型
入金額 / 文字列型
入金状況区分 / 文字列型 / 入金区分
入金状況名 / 文字列型
入金日 / 日時型
備考 / 文字列型
同梱候補伝票番号 / 数値型 / ネクストエンジンが自動判定した同梱候補の伝票番号
同梱先伝票番号 / 数値型 / 同梱した場合の同梱先の伝票番号
複数配送親伝票番号 / 数値型 / 複数配送の親の伝票番号
分割元伝票番号 / 数値型 / 分割元の伝票番号
複写元伝票番号 / 数値型 / 複写元の伝票番号
複数配送親フラグ / 文字列型 / 複数配送の親か否か
納品書印刷指示日 / 日時型
納品書発行日 / 日時型 / 納品書をダウンロードした日
納品書特記事項 / 文字列型
出荷確定日 / 日時型 / 受注状態が出荷確定済みになった日
出荷予定日 / 日時型
出荷順序 / 文字列型 / ラベル発行フラグがたった順序
作業用欄 / 文字列型
ピッキング指示内容 / 文字列型
ラベル発行日 / 日時型
ラベル発行フラグ / 文字列型 / 配送伝票の印刷対象か否か0:対象外1:対象2:発行済み
配達希望日 / 日時型
配達希望時間帯区分 / 文字列型 / 指定の発送方法の伝票印字ソフト用の値が設定されます。
配達希望時間帯名 / 文字列型
便種区分 / 文字列型 / 指定の発送方法の伝票印字ソフト用の値が設定されます。
便種名 / 文字列型
シール1区分 / 文字列型 / 指定の発送方法の伝票印字ソフト用の値が設定されます。
シール1名 / 文字列型
シール2区分 / 文字列型 / 指定の発送方法の伝票印字ソフト用の値が設定されます。
シール2名 / 文字列型
シール3区分 / 文字列型 / 指定の発送方法の伝票印字ソフト用の値が設定されます。
シール3名 / 文字列型
シール4区分 / 文字列型 / 指定の発送方法の伝票印字ソフト用の値が設定されます。
シール4名 / 文字列型
営業止め区分 / 文字列型 / 指定の発送方法の伝票印字ソフト用の値が設定されます。
営業止め名 / 文字列型
送り状区分 / 文字列型 / 指定の発送方法の伝票印字ソフト用の値が設定されます。
送り状名 / 文字列型
温度区分 / 文字列型 / 指定の発送方法の伝票印字ソフト用の値が設定されます。
温度名 / 文字列型
営業所名 / 文字列型
ギフトフラグ / 文字列型 / 0:ギフトではない1:ギフト
発送伝票番号 / 文字列型 / 各発送方法の問い合わせ番号が設定されます。
発送伝票備考欄 / 文字列型
クレジット区分 / 文字列型 / クレジット種類区分
クレジット名 / 文字列型
クレジット承認番号 / 文字列型
クレジット承認額 / 文字列型
クレジット承認区分 / 文字列型 / クレジット承認区分
クレジット承認名 / 文字列型
クレジット承認日 / 日時型
クレジット承認時レート / 数値型
クレジット支払い回数 / 文字列型 / 受注伝票の支払区分の値
クレジット承認センター区分 / 文字列型
クレジット承認センター名 / 文字列型
クレジット承認FAX印刷日 / 日時型
顧客区分 / 文字列型 / 顧客区分
顧客名 / 文字列型
顧客コード / 文字列型 / 顧客区分が9:卸 だった場合に卸先コードが設定されます。
購入者名 / 文字列型
購入者カナ / 文字列型
購入者郵便番号 / 文字列型
購入者住所1 / 文字列型
購入者住所2 / 文字列型
購入者電話番号 / 文字列型
購入者FAX / 文字列型
購入者メールアドレス / 文字列型
送り先名 / 文字列型
送り先カナ / 文字列型
送り先郵便番号 / 文字列型
送り先住所1 / 文字列型
送り先住所2 / 文字列型
送り先電話番号 / 文字列型
送り先FAX / 文字列型
重要チェック担当者ID / 数値型
重要チェック担当者名 / 文字列型
受注担当者ID / 数値型
受注担当者名 / 文字列型
出荷担当者ID / 数値型
出荷担当者名 / 文字列型
作成日 / 日時型
最終更新日 / 日時型
最終更新日 / 日時型 / NULLの場合作成日
作成担当者ID / 数値型
作成担当者名 / 文字列型
最終更新者ID / 数値型
最終更新者ID / 数値型 / NULLの場合作成者ID
最終更新者名 / 文字列型
最終更新者名 / 文字列型 / NULLの場合作成者名
Example
{ "result": "success", "access_token": "xxx", "access_token_end_date": "2017-04-18 11:19:26", "refresh_token": "xxx", "refresh_token_end_date": "2017-04-20 11:19:26"}クライアントエラー (HTTP ステータス自体は 200 + result=error で返ることが多い)
object
実行結果ステータス
エラー時のエラーコード
object
更新後のアクセストークン
アクセストークン有効期限 (YYYY-MM-DD HH:MM:SS)
更新後のリフレッシュトークン
リフレッシュトークン有効期限
エンドポイント固有のレスポンスデータ
Count/search 系のヒット件数 (form-urlencoded レスポンスでは文字列で返ることがある)
Example
{ "result": "success"}