Cin7 接続：注文と顧客を取り込み、在庫を確認

go.cin7.com の Cin7 Omni で API 接続を開き、そのユーザー名とパスワードを控え、その 2 項目だけを Integration に入力し、テスト・マッピング・有効化を行います。販売注文と顧客が取り込まれ、在庫を確認できます。

Cin7 コネクタは Cin7 Omni の販売注文と顧客をこのシステムに取り込み、Cin7 にある在庫数量（利用可能数量と手持ち数量を含む）を確認できます。Cin7 から読み取る接続です：在庫の変更を Cin7 に返送せず、注文や顧客を Cin7 に書き戻しません。アドレスの入力欄はありません。コネクタは常に Cin7 公式の API アドレスを使います。1 接続で Cin7 の API 接続を 1 つ使います。

前提条件#

• go.cin7.com でログインできる Cin7 Omni アカウント。
• Cin7 で API 接続を開く、または作成する権限。この統合のユーザー名とパスワードは、その API 接続から取得します。
• 開始前の重要点：API ユーザー名と API パスワードは Cin7 のログインアカウントではありません。Cin7 へのログインに使うメールアドレスとパスワードを入力しても接続できません。
• 取得頻度を決める際は Cin7 API の制限に注意してください：1 秒あたり 3 リクエスト、1 分あたり 60 リクエスト、1 日あたり 5,000 リクエストです。

認証情報の取得#

1. go.cin7.com で Cin7 Omni にログインします。
2. API 接続のエリアを開き、この統合に使う API 接続を開くか、新しく作成します。
3. その API 接続のユーザー名を控えます。このユーザー名は API 接続用に生成され、Basic 認証に使います。Cin7 のログイン名ではありません。
4. 同じ API 接続に設定された API パスワードを控えます。ユーザー名とパスワードは同じ API 接続のものでなければなりません。2 つの異なる接続の値を混ぜないでください。

Integration への入力#

1. Integration → コネクタマーケットプレイス → Cin7 → 新規接続 を開きます。
2. username、必須、Cin7 API ユーザー名：Cin7 の API 接続のユーザー名を入力します。フィールドの案内文には API username と表示されます。
3. password、必須、Cin7 API パスワード：同じ API 接続に設定された API パスワードを入力します。パスワード型のフィールドで、秘密情報として保存されます。
4. 入力は以上です。この接続にアドレス欄はありません。常に公式アドレス https://api.cin7.com/api に接続するため、変更場所を探す必要はありません。

接続テスト#

接続テストをクリックします。username または password が未入力の場合、Basic 認証には両方の値が必要なため、テストはリクエストを送る前に止まり、未入力のフィールドを報告します。それ以外の場合、テストは Basic 認証付きで支店一覧を読むリクエスト、GET https://api.cin7.com/api/v1/Branches を送信します。これは Cin7 で最も軽い読み取りです。200 が返れば接続は機能しています。401 は認証情報が無効であることを示します。403 は認証情報が受け入れられたものの、この API 接続にそのリソースへの権限がないことを示します。401 と 403 では対処が異なるため、何かを変更する前にコードを確認してください。テストは 12 秒でタイムアウトします。

Mapping / テンプレート選択#

Cin7 標準の Mapping を選択します。販売注文は Cin7 の販売注文データ、顧客は Cin7 の連絡先データ、在庫確認は Cin7 の在庫データを読みます。テスト合格後、1 回取得を実行し、実注文を並べて確認してください（注文番号、顧客、明細、数量）。さらに顧客レコード 1 件を確認し、1 製品の数量を Cin7 の表示と照合してから有効化します。注文の項目が異なる場合は、Cin7 のレコードを変更せず、Mapping でその項目を調整してください。

有効化#

有効化後、接続は設定した頻度で Cin7 の販売注文と顧客をこのシステムに取り込みます。Cin7 の制限（1 秒あたり 3 リクエスト、1 分あたり 60 リクエスト、1 日あたり 5,000 リクエスト）の範囲内で運用し、在庫確認では Cin7 の現在の数量を読み取ります。最初は Runs / Logs で取得を確認し、Cin7 と照合してから無人運用に移してください。

この接続が行わないこと：在庫の変更を Cin7 に返送せず、注文、顧客、履行実績を Cin7 に書き戻しません。これらは引き続き Cin7 自体で、または実際の作業を行うシステムで処理してください。

よくある質問#

テストが 401 で失敗する — 認証情報が無効

Cin7 が Basic 認証を拒否しました。ユーザー名またはパスワードが Cin7 の API 接続のいずれとも一致していません。よくある原因は、Cin7 のログインメールアドレスとパスワードを入力したこと、またはユーザー名とパスワードが異なる 2 つの API 接続のものになっていることです。

go.cin7.com の Cin7 Omni で API 接続を開き、そのユーザー名を username フィールドにそのままコピーし、同じ接続の API パスワードを設定またはコピーして password フィールドに入力し、保存して再テストしてください。Cin7 のログインパスワードは使わないでください。

テストが 403 で失敗する — この API 接続にそのリソースへの権限がない

これは 401 とは異なります。Cin7 は認証情報を受け入れましたが、API 接続にテストで使う支店一覧を読む許可がありません。パスワードを再変更しても 403 は直りません。

Cin7 でこの API 接続に与えられたアクセスを確認し、接続に必要なリソースを読むことを許可するか、すでにそのアクセスを持つ API 接続に切り替えてください。ユーザー名とパスワードはその接続の同じペアを保持し、保存して再テストしてください。

テストがリクエストを送る前に止まり、未入力フィールドを報告する

username または password が空です。テストの Basic 認証には両方の値が必要なため、Cin7 に拒否されるだけのリクエストを送らずに停止します。

Cin7 の同じ API 接続から両フィールドを入力してください（接続のユーザー名と、同じ接続に設定されたパスワード）。保存して再テストしてください。

Cin7 のログインアカウントを入力したが接続できない

ログインアカウントと API 接続の認証情報は Cin7 では別物です。この接続は API 接続のユーザー名とパスワードでのみ認証するため、正しいログインアカウントでもここでは失敗します。

Cin7 Omni の go.cin7.com → API 接続に移動し、API 接続を開くか作成し、ログイン情報の代わりにそのユーザー名と API パスワードを Integration に入力してください。その後、再テストしてください。

接続済みだが販売注文が取り込まれない

接続は機能しています（テストで支店一覧を正常に読みました）が、新しく取り込むものがありません。取得範囲内に Cin7 の新しい販売注文がないか、あるレコードが販売注文ではありません。

Cin7 で販売注文を 1 件作成または確認し、手動取得を実行して、プレビューまたは Runs / Logs に注文が表示されるか確認してください。取得頻度は上記の制限の範囲内に保ってください。

在庫確認で、ある製品の数量が返らない

接続は Cin7 の在庫を読めますが、その製品に対応する在庫レコードがないか、Mapping の製品コードが Cin7 の製品と一致していません。テストが合格しても、特定の製品だけ数量が返らないことがあります。

まず Cin7 でその製品と在庫レコードを確認し、次に Mapping のその品目の製品コードを確認して Cin7 と一致するよう修正してください。その製品だけ在庫確認を再実行してください。