拠点在庫マスタアップロード

POST

/api_v1_warehouse_stock/upload

curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d 'access_token=xxx&refresh_token=xxx&wait_flag=1&data_type=csv&data=kyoten_mei,syohin_code,kasan_su,nyusyukko_riyu
拠点A,test-0001,3,在庫数調整のため
拠点B,test-0002,4,在庫数調整のため' https://api.next-engine.org/api_v1_warehouse_stock/upload

// POST /api_v1_warehouse_stock/upload - 拠点在庫マスタアップロード
const params = new URLSearchParams({
  access_token: '<access_token>',
  data_type: '<data_type>',
  data: '<data>',
})
const res = await fetch('https://api.next-engine.org/api_v1_warehouse_stock/upload', {
  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_warehouse_stock/upload - 拠点在庫マスタアップロード
import requests

params = {
    'access_token': '<access_token>',
    'data_type': '<data_type>',
    'data': '<data>',
}
res = requests.post(
    'https://api.next-engine.org/api_v1_warehouse_stock/upload',
    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

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

data_type

required

Dataのファイル種類 / csv:拠点在庫マスタCSV,gz:拠点在庫マスタCSVをGZIPで圧縮

string

data

required

拠点在庫マスタCSVのファイル内容（3000件まで） / メイン機能仕様と同じ（推奨: Shift_JISまたはUTF-8）。列 kyoten_syohin_himoduke に a を指定すると、在庫数を変えずに商品と拠点の紐づけだけを登録できる。列 kyoten_syohin_sakujyo に d を指定すると、商品と拠点の紐づけを解除し拠点在庫を削除できる（引当数が0の時だけ削除可）。kasan_su/gensan_su/kyoten_syohin_himoduke/kyoten_syohin_sakujyoは同じ行に併用不可（1行につきどれか1つだけ指定）

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

Example

{
  "result": "success",
  "que_id": "5",
  "access_token": "xxx",
  "access_token_end_date": "2023-05-01 14:19:22",
  "refresh_token": "xxx",
  "refresh_token_end_date": "2023-05-03 14:19:22"
}

4XX

クライアントエラー (HTTP ステータス自体は 200 + result=error で返ることが多い)

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

Example

{
  "result": "success"
}

拠点在庫マスタアップロード

Request Body required

Responses

200

Example

4XX

Example

Request Body^required