|| 該当なし | 完了 | コメント | |:---|---|---|---| |
全般
| | インテグレーション作業を開始する前に、倉庫内のプロセスをマッピングし、フロー図を作成しておくことが推奨されます。インテグレーションが必要な範囲が明確になり、今後の議論にも役立つためです。過度に詳細で複雑なものを作成する必要はありません。ただし、新しいデータポイントの生成や、外部システムとの連携を行う手順はすべて含めるようにしてください。| | Pioプラットフォームからアクセス可能な場所にインテグレーションをホストし、静的URLを設定してください。このURLを使用し、PioのWebhookを登録します（フックのページを参照）。| |認証
| | インテグレーションにおいてマルチテナント構成に対応する必要があるか、1つのショップや顧客、注文チャネルのみを取り扱うかを、事前に決定しておきます。| |ショップ
| | インテグレーションの認証と承認が完了したら、商品や注文を追加する前にショップを作成する必要があります。| |商品
| | 外部システム（ERP、WMS、ECプラットフォームなど）から取得した商品情報を、Pioと同期する必要があります。つまり、外部システムに新しい商品が追加された場合、Pioにも同じ商品を追加する必要があります。商品を作成する際は、できる限り多くのメタデータを含めてください。ブランドや種類などの情報は、Pioの内部処理に役立ちます。| | 更新や変更は、すべてPioにも反映させる必要があります。| | 外部システムで商品を削除する場合、Pioにその商品の在庫があるかどうかを考慮する必要があります。在庫がなければ、Pio側で問題なく削除できます。在庫がある場合、商品を削除する前にPioに在庫がない状態にすることが推奨されます。| | Pio内の商品を識別するために、固有のSKUが必要です。外部システムにすでに固有のSKUがある場合、Pioで商品を作成する際にそのまま使用できます。固有のSKUがない場合は、外部システムの情報をもとに作成する必要があります。たとえば、商品IDとバリエーションIDを連結するなどの方法が挙げられます。| | 商品画像がある場合、Pioで表示できます。必要に応じ、商品の作成時にホストされた画像のURLを指定することで、画像が表示されます。| | 在庫レベルの変化に合わせ、適切に対応してください。在庫レベルの更新情報を受信した際は、在庫数を表す3つの値（in_stock、reserved、available）に注意してください。これらの値に応じ、インテグレーションを適切に対応させる必要があります。| | 注文を使用する際は、注文の更新や同期に関するWebhookメッセージに適切に対応する必要があります。| |注文
| | 注文情報はPioと同期させる必要があります。タグ、メモ、選択された配送オプションなども同期させてください。その際、同期する注文を取捨選択することもできます。受け取った注文をすべて送信するか、特定のステータスの注文のみを送信するかを選択してください。| | タグ、メモ、配送先住所はリアルタイムで更新できます。注文内容に変更が生じた場合は、注文を削除して再作成する必要があります。| | 注文がキャンセルされた場合、Pio上でも削除する必要があります。キャンセル時にすでにピッキングが完了している場合は、返品フローに従ってください。| | 注文のフルフィルメントが完了したという情報をPioから受け取った場合、外部システムにもこのステータスを反映させる必要があります。| |出荷
| | 事前に出荷の処理方法を決定しておく必要があります。市販のインテグレーション（Webshipper/Shipstation）を使用するか、独自の配送インテグレーションを構築することができます。いずれの場合も、このようなインテグレーションのPioへの追加を検討することをお勧めします。オペレーションが効率化され、ピッキング担当者がピック&パックを行いながら複数のシステムを操作する手間を省くことができるためです。| | 配送プラットフォーム（WebshipperまたはShipstation）を使用する場合は、管理画面のインテグレーションページからPioの配送インテグレーションを通じて接続する必要があります。| | 配送プラットフォームに送信される注文番号は、Pioが受け取る番号と同一である必要があります。この番号は、注文と出荷指示を対応させるために使用します。| |Webhook
| | PioからWebhookを受信した場合、速やかに確認し応答を返す必要があります（現在のタイムアウトは5秒）。ローカルでの処理が必要な場合は、イベントをキューに保存して非同期で処理してください。タイムアウト内に応答しないWebhookは失敗とみなされ、Pioから再送信されます。| | 在庫レベルの更新を受信した際は、最後に受信した値に基づいて在庫レベルを管理してください。| | | |