Logiwa 接続：注文を送信し、在庫を確認
API アクセス権のある Logiwa アカウントのメールとパスワードを WMS 接続に入力し、実際のトークン取得をテストして、Mapping 後に有効化します。
Logiwa コネクタは、このシステムを外部倉庫システムである Logiwa に接続します。出荷注文を単件または一括で Logiwa に送信でき、Logiwa にある在庫を確認できます。出荷確認はこの接続のポーリングではなく、Logiwa Webhook V2 で戻ります。この接続はチャネルウィザードではなく WMS 領域で設定し、Logiwa のユーザー名とパスワードでログインしてセッショントークンを取得します。
前提条件#
- ログインできる Logiwa アカウント。この接続のユーザー名は、API アクセス権のある Logiwa ユーザーのメールアドレスです。
- 同じ Logiwa ユーザーのパスワード。この接続では別途生成する API Key はありません。アカウントのメールとパスワードが認証情報です。
- デフォルトのサービスアドレス https://myapi.logiwa.com を使うか、Logiwa 環境向けに別途指定された baseUrl を使うかが分かっていること。別のアドレスの指定がなければ、デフォルトを使ってください。
認証情報の取得#
- 統合に使う Logiwa ユーザーを決め、そのユーザーに API アクセス権があることを確認します。個人のパスワード変更で接続が切れないよう、可能な限り専用ユーザーを使ってください。
- ユーザー名を控えます：その Logiwa ユーザーのメールアドレスです。
- 同じユーザーのパスワードを控えます。WMS 接続に一度入力すると秘密情報として保存され、ユーザー名と一緒にトークン取得に使われます。
- Logiwa 環境からデフォルトと異なるサービスアドレスが指定されている場合は、その baseUrl も控えてください。そうでなければ、他に集めるものはありません。
Integration への入力#
この接続にはチャネルウィザードのフィールド一覧はありません。Integration で Logiwa の WMS 接続を開き、その WMS 接続フォームに以下の値を入力してください。チャネルウィザードのフィールド手順で Logiwa を探さないでください。ウィザードにはそのフィールドがありません。
- username、必須：API アクセス権のある Logiwa ユーザーのメールアドレス。Logiwa へのログインに使うものと完全に一致させてください。
- password、必須：同じ Logiwa ユーザーのパスワード。秘密フィールドで、システムがトークンを取得する際に username と一緒に送信されます。
- baseUrl、任意：Logiwa のサービスアドレス。空欄にするとデフォルトの https://myapi.logiwa.com を使います。Logiwa 環境向けに別のアドレスが指定されている場合はそれを入力してください。
接続テスト#
WMS 接続のテストを使ってください。入力した username と password を使って、baseUrl 配下のトークンアドレスへ実際のログインリクエストを送り、Logiwa がトークンを返した場合のみ合格します。username または password が未入力の場合、テストは MISSING_CREDENTIALS で止まります。リクエストがトークンを返さない場合、AUTH_FAILED で失敗します。テストの入口は 2 つある場合があります。ここで説明する WMS 接続テストが実際の認証情報チェックです。一方、チャネルウィザードに表示されるテストはこの認証情報で Logiwa に接続しません。そちらの合格を Logiwa アカウントが使える証拠としないでください。接続の判定は WMS 接続テストだけで行ってください。
Mapping / テンプレート選択#
Logiwa 標準の Mapping を選択します。これにより、このシステムの出庫注文が Logiwa の出荷注文になり、在庫確認ではマッピング済みの SKU について Logiwa の在庫リストを読みます。テスト合格後、実注文を 1 件送信し、Logiwa で照合してください（参照番号、明細、数量）。さらに 1 つの SKU の数量を Logiwa の表示と照合してから有効化します。このシステムの SKU が Logiwa で同じ製品と異なる名前になっている場合は、どちらのシステムでも製品名を変えず、Mapping でその SKU を修正してください。
有効化#
有効化後、このシステムの出庫注文は出荷注文として 1 件ずつまたは一括で Logiwa に送信され、在庫確認ではマッピング済み SKU の Logiwa 現在数量を読みます。出荷確認は Logiwa Webhook V2 で戻るため、Logiwa 側の Webhook 配信が機能する状態を保ってください。最初は Runs / Logs と Logiwa 自体で注文を確認してから無人運用に移してください。
よくある質問#
WMS テストが AUTH_FAILED で失敗する
トークンリクエストは Logiwa に届きましたが、トークンが返りませんでした。ユーザー名とパスワードの組み合わせが受け付けられていません。メールが API アクセス権のある Logiwa ユーザーではない、パスワードがそのユーザーのものではない、または baseUrl がアカウントの属する Logiwa 環境と異なる環境を指しています。
同じメールとパスワードでブラウザから Logiwa にログインし、組み合わせが有効なことを証明してください。ユーザーに API アクセス権があることを確認し、WMS 接続に username と password を切り取らず再入力します。環境向けに別の baseUrl が指定されている場合はそのまま設定し、そうでなければ baseUrl を空にしてデフォルトアドレスを使い、再テストしてください。
テストが MISSING_CREDENTIALS で止まる
WMS 接続の username または password が空です。トークンリクエストには両方の値が必要なため、テストは Logiwa に接続する前に止まります。
WMS 接続フォームの両フィールドを入力してください。username には Logiwa ユーザーのメール、password にはそのユーザーのパスワードを入れ、保存して再テストします。
チャネルウィザードのテストは合格したのに、WMS テストが失敗する
2 つのテストは同じチェックではありません。チャネルウィザードには Logiwa のフィールドがなく、そのテストはあなたの username と password で Logiwa にログインしません。そちらの合格は Logiwa アカウントについて何も示しません。実際のトークンログインを行うのは WMS 接続テストだけです。
この接続ではウィザードの結果を無視してください。WMS 接続のテストを実行し、その結果から対応します。MISSING_CREDENTIALS はフィールドが空、AUTH_FAILED はアカウントの組み合わせが拒否されたという意味です。
注文は送信されたが、Logiwa の数量が違う
接続とトークンは機能しています（注文は届いています）が、明細が一致しません。通常は、注文の SKU が Logiwa で別の製品を指しているか、明細の単位が 2 つのシステムで異なります。
送信した注文を Logiwa の注文と明細ごとに比較し、一致しない製品の SKU マッピングを修正してください。新しいテスト注文を送信して再照合し、通常の注文を再開してください。
Logiwa にある SKU の在庫確認で何も返らない
在庫確認はマッピング済み SKU で Logiwa の在庫リストを読みます。送信した SKU が Logiwa で在庫を保持している SKU でない場合、製品が存在してもリストは空で戻ります。
Logiwa の製品レコードで正確な SKU を確認し、その値をこの製品の Mapping に設定して、在庫確認を再実行してください。
Logiwa で出荷済みなのに、ここに出荷確認が届かない
この接続の出荷確認は、注文や在庫の呼び出しではなく Logiwa Webhook V2 で届きます。Logiwa 側の Webhook 配信が止まっているか失敗している場合、注文と在庫は機能し続けますが、確認は届かなくなります。
Logiwa 側の Webhook 配信状態を確認して復旧し、Logiwa でテスト注文を 1 件出荷して、通常量に戻す前に確認がここに届くことを確かめてください。