コンテンツにスキップ
トレカクラウド
Esc
↑↓移動↵開く⌘Jプレビュー

個体を持ち出す

撮影・イベントなどへ最大200件持ち出します。個体は棚と在庫を離れremovedとなり、返却するまで販売できません。 同じrequestId・同じ内容の再実行は200、初回作成は201です。requestIdを別の内容へ流用するとidempotency_conflictになります。 inventory:readに加え、この操作のスコープと許可したメンバーのinventory.write権限が必要です。

POST/inventory/checkouts
認証
AuthorizationOAuth2 アクセストークン · header必須

認可コードフロー(PKCE S256 必須)。認可・トークン・更新のリクエストには resource=https://api.toreca-cloud.com/partner/v1 を付けます。アクセストークンは15分、リフレッシュトークンは90日有効で、更新のたびに入れ替わります。

スコープ:inventory:readinventory:move
リクエストボディ
必須application/json
requestIdstring<uuid>必須
inventoryItemIdsstring<uuid>[]必須
最小項目数 1 · 最大項目数 200
destinationLabelstring必須
最小長 1 · 最大長 200
reasonstring必須
最小長 1 · 最大長 2000
externalRefstring
最小長 1 · 最大長 200
レスポンス
200

成功

idstring<uuid>必須
createdAtstring<date-time>必須
updatedAtstring<date-time>必須
orderNumberstring必須
versioninteger必須
destinationLabelstring必須
reasonstring必須
externalRefstring | null必須
プロパティを表示
いずれか 1 つ:
string
string
null
null
shippedAtstring<date-time> | null必須
プロパティを表示
いずれか 1 つ:
string<date-time>
string<date-time>
null
null
itemsobject[]必須
プロパティを表示
object の配列
inventoryItemIdstring<uuid>必須
assetNumberstring必須
statusstring必須
許可される値:outreturned
returnedAtstring<date-time> | null必須
プロパティを表示
いずれか 1 つ:
string<date-time>
string<date-time>
null
null
returnLocationIdstring<uuid> | null必須
プロパティを表示
いずれか 1 つ:
string<uuid>
string<uuid>
null
null
201

作成しました

idstring<uuid>必須
createdAtstring<date-time>必須
updatedAtstring<date-time>必須
orderNumberstring必須
versioninteger必須
destinationLabelstring必須
reasonstring必須
externalRefstring | null必須
プロパティを表示
いずれか 1 つ:
string
string
null
null
shippedAtstring<date-time> | null必須
プロパティを表示
いずれか 1 つ:
string<date-time>
string<date-time>
null
null
itemsobject[]必須
プロパティを表示
object の配列
inventoryItemIdstring<uuid>必須
assetNumberstring必須
statusstring必須
許可される値:outreturned
returnedAtstring<date-time> | null必須
プロパティを表示
いずれか 1 つ:
string<date-time>
string<date-time>
null
null
returnLocationIdstring<uuid> | null必須
プロパティを表示
いずれか 1 つ:
string<uuid>
string<uuid>
null
null
400

invalid_request。パラメーターが正しくありません。

errorstring必須

エラーのコード

scopestring

insufficient_scope のとき、足りない権限

requestIdstring<uuid>
inventoryItemIdsstring<uuid>[]
holdIdsstring<uuid>[]
commitmentIdsstring<uuid>[]
401

invalid_token。トークンがない、期限切れ、または別のリソース向けです。

errorstring必須

エラーのコード

scopestring

insufficient_scope のとき、足りない権限

requestIdstring<uuid>
inventoryItemIdsstring<uuid>[]
holdIdsstring<uuid>[]
commitmentIdsstring<uuid>[]
403

insufficient_scope、connection_revoked、client_disabled、forbidden のいずれかです。

errorstring必須

エラーのコード

scopestring

insufficient_scope のとき、足りない権限

requestIdstring<uuid>
inventoryItemIdsstring<uuid>[]
holdIdsstring<uuid>[]
commitmentIdsstring<uuid>[]
409

競合・requestIdの流用・受取未確認

errorstring必須

エラーのコード

scopestring

insufficient_scope のとき、足りない権限

requestIdstring<uuid>
inventoryItemIdsstring<uuid>[]
holdIdsstring<uuid>[]
commitmentIdsstring<uuid>[]
422

現在の状態・対象・値では実行できません。errorと対象IDを確認します。

errorstring必須

エラーのコード

scopestring

insufficient_scope のとき、足りない権限

requestIdstring<uuid>
inventoryItemIdsstring<uuid>[]
holdIdsstring<uuid>[]
commitmentIdsstring<uuid>[]
試してみる
サーバー
認証
ボディapplication/json
リクエスト
curl -X POST 'https://api.toreca-cloud.com/partner/v1/inventory/checkouts' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6",
  "inventoryItemIds": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ],
  "destinationLabel": "string",
  "reason": "string",
  "externalRef": "string"
}'
レスポンス
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "orderNumber": "string",
  "version": 0,
  "destinationLabel": "string",
  "reason": "string",
  "externalRef": "string",
  "shippedAt": "2019-08-24T14:15:22Z",
  "items": [
    {
      "inventoryItemId": "ef1bc09e-447a-46aa-a9d9-d86e3d490831",
      "assetNumber": "string",
      "status": "out",
      "returnedAt": "2019-08-24T14:15:22Z",
      "returnLocationId": "1d1d177a-c4a1-4389-b833-16c3941f123e"
    }
  ]
}

このページは役に立ちましたか?