Item WMS 接続：注文と入荷を送信し、製品と在庫を同期
UNIS に Company ID、Customer ID、Facility ID を依頼し、Item WMS のユーザー名とパスワードを Integration に入力、ログインをテストし、Mapping を確認して、出庫・入庫・ラベル・製品・在庫を有効化します。
Item WMS コネクタはこのシステムを Item WMS（UNIS）に接続します。出庫注文を送信してキャンセルでき、注文確認と出荷確認を照会し、出荷ラベルをアップロードし、入庫受領を作成してキャンセルでき、受領確認と受領実績を照会し、製品をインポート・検索し、品目単位の在庫（利用可能、引当済み、破損、凍結、手持）を読み取ります。必要な 3 つの ID はすべて UNIS が割り当てます。ご自身で作成することはできません。1 つの接続は、入力した会社・顧客・施設の値で動作します。
前提条件#
- Item WMS のログイン：Item WMS にログインできるユーザー名とパスワード。
- Company ID。UNIS のシステム管理者が割り当てます。開始前に依頼してください。ほぼすべての API 呼び出しで送信されます。
- Customer ID。UNIS の財務（Finance）が割り当てます。Company ID とは別のチームが担当するため、財務へ別途依頼してください。
- Facility ID（倉庫）。担当の ITEM CSR が割り当てます。この接続が連携する倉庫の ID であることを確認してください。
- 通常 Base URL は不要です。接続は既定で本番アドレスを使用します。UNIS から非本番または特殊な環境が提供された場合のみ、別のアドレスを控えてください。
認証情報の取得#
- UNIS のシステム管理者に Company ID を依頼します。以下の ID はすべて UNIS が割り当てます。Item WMS でご自身で作成することはできません。
- UNIS の財務に Customer ID を依頼します。ここに Company ID を流用しないでください。2 つの ID は別のチームが発行する異なる値です。
- 担当の ITEM CSR に Facility ID を依頼します。この接続が対象とする倉庫の倉庫 ID です。
- 統合に使う Item WMS ログインのユーザー名とパスワードを、Item WMS へのログイン時に使うとおりに控えます。
Integration への入力#
- Integration を開き、Item WMS を選んで新規接続を開始します。
- username、必須、ユーザー名：統合に使う Item WMS ログインのユーザー名（例：your-username）。
- password、必須、パスワード：同じ Item WMS ログインのパスワード。秘密情報として保存されます。
- company_id、必須、会社 ID：UNIS のシステム管理者が割り当てた ID（例：COMPANY01 の形式）。UNIS から受け取ったとおりに入力してください。
- customer_id、必須、顧客 ID：UNIS の財務が割り当てた ID（例：CUST001 の形式）。Company ID と同じ値ではありません。
- facility_id、必須、Facility ID（倉庫）：担当の ITEM CSR が割り当てた倉庫 ID（例：WH01 の形式）。
- base_url、任意、Base URL：空欄にすると既定の本番アドレス https://wms.item.com/api/public/v1/public を使用します。UNIS から非本番または特殊な環境向けに別のアドレスが提供された場合のみ入力してください。
接続テスト#
接続テストをクリックします。テストは実際にログインします。username と password を Item WMS のログインエンドポイントに送信し、トークンが返ってきた場合のみ合格となります。合格は、ユーザー名とパスワードが正しく、アドレスが応答することを証明します。テストでは 3 つの ID を使った業務呼び出しは行いません。そのため、Company ID、Customer ID、Facility ID が間違っていてもテストに合格し、最初の実際の注文・受領・製品・在庫の呼び出しで初めて失敗することがあります。テスト合格後は、有効化する前に、Mapping の手順で説明するように実呼び出しを 1 回行って 3 つの ID を確認してください。
Mapping / テンプレート選択#
注文・受領・製品・在庫には Item WMS 標準の Mapping を選択し、接続の会社・顧客・施設の値を、各呼び出しで送信する値として保持します。次に有効化前に確認します：実注文を 1 件送信または照会し、注文番号・明細・数量を比較します。既知の製品について在庫照会を 1 回実行し、利用可能数量と手持数量を Item WMS と比較します。この確認は 3 つの ID を確認する方法でもあります。ログインのテストでは ID を確認できないため、ここで正しい結果が得られれば、ID がセットで揃い、正しい倉庫を指していることになります。
有効化#
有効化後、接続は出庫注文を Item WMS に送信し、注文キャンセルを送り、入庫受領と受領キャンセルを作成し、ラベルをアップロードし、確認・出荷確認・受領確認を引き続き取り込みます。製品のインポート・検索・在庫の読み取りも同じ接続で実行されます。最初は Runs / Logs で注文と受領を確認し、Item WMS と照合してから無人運用に移してください。
範囲にご注意ください：この接続は、上記の出庫・入庫・ラベル・製品・在庫の作業を、入力した会社・顧客・施設の範囲でカバーします。別の施設や別の顧客の作業には、その値が必要です。稼働中の接続の ID を変更して倉庫を切り替えないでください。別の接続を作成してください。
よくある質問#
テストが AUTH_FAILED で失敗する
ログインが拒否されました。Item WMS はログイン呼び出しに応答しましたが、トークンを返しませんでした。使用しているユーザー名、パスワード、またはアドレスが一致していないということです。ログインの組み合わせは Item WMS ログイン自体でなければならず、base_url を入力した場合は Item WMS の API アドレスを指す必要があります。
同じユーザー名とパスワードで Item WMS に直接ログインし、組み合わせが機能することを確認してください。両方の値を余分な空白なしでコピーし直し、UNIS から別のアドレスが提供されていない限り base_url を空にします。その後、再テストしてください。
テストは合格するが、最初の実際の注文または受領の呼び出しが失敗する
ID が間違っている場合の想定どおりの動作です。テストはユーザー名とパスワードでログインするだけですが、実際の呼び出しでは Company ID、Customer ID、Facility ID も送信します。そのため、ID が間違っていたり組み合わせが合っていなかったりすると、テストには合格し、最初の業務呼び出しで失敗します。
3 つの ID を UNIS が発行したものと 1 文字ずつ比較してください：Company ID は UNIS のシステム管理者、Customer ID は UNIS の財務、Facility ID は担当の ITEM CSR が発行します。接続内の間違った値を修正し、同じ実呼び出しを繰り返して、成功を確認してから有効化してください。
Company ID、Customer ID、Facility ID はどこで取得できますか？
3 つの ID はすべて UNIS が割り当てます。ご自身で作成することはできず、発行元は 3 つとも異なります。Item WMS 内で ID を生成できるページを探しても見つかりません。
各発行元にそれぞれの ID を依頼してください：Company ID は UNIS のシステム管理者、Customer ID は UNIS の財務、Facility ID は担当の ITEM CSR です。3 つを揃え、発行されたとおりに接続へ入力してください。
base_url は入力が必要ですか？
ほとんどの場合、不要です。base_url は任意です。空欄にすると、接続は既定の本番アドレス https://wms.item.com/api/public/v1/public を使用します。コピーしたアドレスや推測したアドレスを入力すると、ログイン失敗のよくある原因になります。
本番環境では base_url を空欄にしてください。UNIS から非本番または特殊な環境向けに別のアドレスが提供された場合のみ入力し、そのアドレスをそのままコピーしてください。
このシステムの在庫数が Item WMS と一致しない
接続は Item WMS から品目単位の在庫を読み取ります。利用可能、引当済み、破損、凍結、手持は別々の数量です。不一致は通常、異なる数量の種類を比較したこと、または 2 つのビューで製品や施設の範囲が異なることを意味します。
同じ施設内の既知の製品を 1 つ選び、両側で同じ数量の種類（例：利用可能同士）を比較し、製品コードが Item WMS の品目と一致することを確認してください。その製品が一致すれば、同じ数量の種類で広いリストを再確認してください。