受注伝票分割

POST

/api_v1_receiveorder_base/divide

curl -X POST -H 'content-type: application/x-www-form-urlencoded' \ -d 'access_token=xxx&refresh_token=xxx&wait_flag=1&receive_order_id=xxx&receive_order_last_modified_date=xxx&data=xxx&credit_unauthorized_flag=1' \ https://api.next-engine.org/api_v1_receiveorder_base/divide

// POST /api_v1_receiveorder_base/divide - 受注伝票分割
const params = new URLSearchParams({
  access_token: '<access_token>',
  receive_order_id: '<receive_order_id>',
  receive_order_last_modified_date: '<receive_order_last_modified_date>',
  data: '<data>',
  // credit_unauthorized_flag: '...', // optional
})
const res = await fetch('https://api.next-engine.org/api_v1_receiveorder_base/divide', {
  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/divide - 受注伝票分割
import requests

params = {
    'access_token': '<access_token>',
    'receive_order_id': '<receive_order_id>',
    'receive_order_last_modified_date': '<receive_order_last_modified_date>',
    'data': '<data>',
    # 'credit_unauthorized_flag': '...',  # optional
}
res = requests.post(
    'https://api.next-engine.org/api_v1_receiveorder_base/divide',
    data=params,
)
json = res.json()
if json['result'] != 'success':
    raise RuntimeError(json.get('message') or json.get('code'))
print(json.get('data'))

<?xml version="1.0" encoding="utf-8"?>
<root>
    <receiveorder_row>
        <receive_order_row_no value="2">
            <receive_order_row_quantity>1</receive_order_row_quantity>
        </receive_order_row_no>
        <receive_order_row_no value="4">
            <receive_order_row_quantity>0</receive_order_row_quantity>
        </receive_order_row_no>
        <receive_order_row_no value="5">
            <receive_order_row_quantity>0</receive_order_row_quantity>
        </receive_order_row_no>
    </receiveorder_row>
</root>

Request Body^required

application/x-www-form-urlencoded

object

access_token

required

OAuth2 アクセストークン (必須)

string

refresh_token

OAuth2 リフレッシュトークン (access_token 期限切れ時の自動更新に使用)

string

wait_flag

同期実行フラグ。“1” 指定で処理完了を待つ

string

Allowed values: 0 1

fields

取得するフィールドをカンマ区切りで指定 (search 系のみ)

string

offset

検索開始位置 (search 系のみ)

integer

limit

取得件数 (search 系のみ)

integer

>= 1

receive_order_id

required

伝票番号 / 分割する受注の伝票番号

string

receive_order_last_modified_date

required

最終更新日 / 分割する受注の最終更新日 API実行時にメイン機能またはアプリで、受注伝票が更新されていないかを確認するために利用しますメイン機能またはアプリで受注伝票が更新されている場合はエラーになりますエラーになったら再度、受注伝票を検索してAPIを実行して下さい

string

data

required

更新するデータ / XML形式で指定します / 詳細なXMLフォーマットは各APIのMarkdownドキュメントの「XML形式」セクションを参照

string

credit_unauthorized_flag

1:条件を満たす場合（備考欄参照）、分割先・分割元ともに、受注伝票の請求情報を「未承認の状態(※1)」にする。1以外:分割元伝票の請求情報はそのまま、分割先伝票も分割元から請求情報を引き継ぐ。 / 1で、次の条件を全て満たす場合、「未承認の状態(※1)」にする。オーソリ区分ID(shop_authorization_type_id)=0 支払区分(receive_order_payment_method_id)=[0:クレジット] クレジット承認区分(receive_order_credit_approval_type_id) が [20:承認中]以上。

string

Responses

200

実行結果 (result が success / error / redirect のいずれか)

application/json

object

result

required

実行結果ステータス

string

Allowed values: success error redirect

code

エラー時のエラーコード

string

message

One of:

string
Array<object>

string

access_token

更新後のアクセストークン

string

access_token_end_date

アクセストークン有効期限 (YYYY-MM-DD HH:MM:SS)

string

refresh_token

更新後のリフレッシュトークン

string

refresh_token_end_date

リフレッシュトークン有効期限

string

data

エンドポイント固有のレスポンスデータ

count

Count/search 系のヒット件数 (form-urlencoded レスポンスでは文字列で返ることがある)

integer | string

data

Array<object>

object

receive_order_shop_id

店舗コード / 数値型 / 店舗マスタの店舗コード