API連携とは、外部サービス(例:ShopifyやBASE)とTHE CKBをつなぎ、データや機能を自動でやり取りすることで、業務の自動化・効率化を実現する仕組みです。
① エンドユーザーの注文情報を自動で取り込み、自動発注
・BASEやShopifyでエンドユーザーが購入した情報を自動で読み取り、THE CKBでの自動発注が可能です。
・「自動発注」をONにすると、毎日(日本時間2:00)に前日の注文を同期・発注します。
※事前に「仕入れ先のSKUとの紐付け」が必要です。
▶ 詳細はマニュアル【仕入れURLを設定したい、どうすればいいですか?】をご参照ください。

② 商品データを連携先店舗に自動転送(KAERUツール連携)
・自社サイトで登録した商品画像・商品名・紹介文を、API連携済のBASE/Shopifyの管理画面へ自動転送できます。
・商品編集・公開作業がスムーズになり、時間と手間を大幅に削減できます。
※事前に「KAERUツール」のインストールが必要です。
▶ 詳細はマニュアル【KAERUツールの使用方法】をご確認ください。

③ 発送後の追跡番号も自動で反映
・国際発送後、配達追跡番号がTHE CKB側で登録されると、ShopifyやBASE側にも自動反映されます。
・対応画面:マイページ → 注文管理 → 注文履歴

④子アカウントの作成・管理で安全&効率的な運営
・スタッフ用に子アカウントを作成し、アクセス権限の制限をかけることで、安全性を保ちながら複数人でのショップ運営が可能になります。
操作手順:マイページ → 店舗管理 → API連携/店舗作成 → 店舗を選択 → 子アカウント情報を追加
▶ 詳細はマニュアル【子アカウントの作成方法】をご確認ください。

THE CKBシステムでは、BASE店舗とのAPI連携を行うことで、商品データや注文情報の自動同期が可能になります。
以下の手順に従って、BASE店舗との連携を行ってください。
① ログイン後、マイページから「店舗管理」→「API連携/店舗作成」メニューをクリックします。


② 表示された店舗一覧画面にて、「未連携」ボタンをクリックします。

③次に表示される画面で、「API連携へ」ボタンをクリックします。

④BASEのログイン画面に遷移しますので、BASE店舗のメールアドレスとパスワードを入力し、
「アプリを認証する」をクリックしてください。

⑤認証が完了すると、THE CKBシステムに戻り、連携状態が「連携済」に変更されます。
これで連携は完了です。

1、BASE連携を行う前に、まずTHE CKB側で該当の店舗を作成しておく必要があります。
2、親アカウントでは、すべての店舗に対する連携操作が可能です。
3、子アカウントでは、自身に紐付いている店舗のみ操作可能です。
・Shopifyの管理者権限があるアカウント
・連携するShopifyストアのURL
※Client IDとClient secretは、アプリ作成後に取得します。API権限の設定には、このページ末尾の「API権限一覧」を使用します。
| 項目 | 入力値 |
| インストール URL | https://gateway-prod.theckb.com/api/shopify/privateapp/install |
| コールバック URL | https://gateway-prod.theckb.com/api/shopify/privateapp/callback |
上記 2 つの URL は固定値です。入力ミスがあると認証に失敗します。
画面上の表示:アプリ / Apps
左側メニューから「アプリ」をクリックします。

画面上の表示:アプリ設定 / App settings
「アプリの設定」を開きます。

画面上の表示:開発アプリ / Develop apps
「アプリを開発する」を選択します。

画面上の表示:Dev Dashboard でアプリを構築
Dev Dashboardでアプリを構築するためのボタンをクリックします。

画面上の表示:手動で作成 / Create manually
新しくアプリを作成する場合は、「アプリを手動で作成」を選択します。

画面上の表示:アプリを手動で作成 / Create manually
すでにアプリを作成している場合でも、新しく作成する際は、こちらから作成してください。

画面上の表示:アプリ名 / App name
アプリ名は自由に設定できます。どのストアのアプリか分かる名前を入力してください。
・インストール URL:https://gateway-prod.theckb.com/api/shopify/privateapp/install
・コールバック URL:https://gateway-prod.theckb.com/api/shopify/privateapp/callback

画面上の表示:権限範囲 / Access scopes
このページの「API権限一覧」を参照し、必要な権限を選択するか、一覧をコピーして貼り付けます。

API権限をコピーして貼り付ける場合は、以下の一覧を使用してください。
read_analytics,read_analytics_annotations,write_analytics_annotations,read_app_proxy,write_app_proxy,read_assigned_fulfillment_orders,write_assigned_fulfillment_orders,read_audit_events,read_customer_events,read_cart_transforms,write_cart_transforms,read_all_cart_transforms,read_validations,write_validations,read_cash_tracking,write_cash_tracking,read_channels,write_channels,read_checkout_kit_enhanced_buyer_events,read_checkout_and_accounts_configurations,write_checkout_and_accounts_configurations,read_checkout_branding_settings,write_checkout_branding_settings,write_checkouts,read_checkouts,read_companies,write_companies,read_custom_fulfillment_services,write_custom_fulfillment_services,read_custom_pixels,write_custom_pixels,read_customers,write_customers,read_customer_data_erasure,write_customer_data_erasure,read_customer_merge,write_customer_merge,read_delivery_customizations,write_delivery_customizations,read_price_rules,write_price_rules,read_discounts,write_discounts,read_discovery,write_discovery,write_draft_orders,read_draft_orders,read_files,write_files,read_fulfillment_constraint_rules,write_fulfillment_constraint_rules,read_fulfillments,write_fulfillments,read_gift_card_transactions,write_gift_card_transactions,read_gift_cards,write_gift_cards,write_inventory,read_inventory,read_inventory_purchase_orders,write_inventory_shipments,read_inventory_shipments,write_inventory_shipments_received_items,read_inventory_shipments_received_items,write_inventory_transfers,read_inventory_transfers,read_legal_policies,write_legal_policies,read_delivery_option_generators,write_delivery_option_generators,read_locales,write_locales,write_locations,read_locations,read_marketing_integrated_campaigns,write_marketing_integrated_campaigns,write_marketing_events,read_marketing_events,read_markets,write_markets,read_markets_home,write_markets_home,read_merchant_managed_fulfillment_orders,write_merchant_managed_fulfillment_orders,read_metaobject_definitions,write_metaobject_definitions,read_metaobjects,write_metaobjects,read_online_store_navigation,write_online_store_navigation,read_online_store_pages,write_online_store_pages,write_order_edits,read_order_edits,read_orders,write_orders,write_packing_slip_templates,read_packing_slip_templates,read_payment_notifications,write_payment_notifications,read_payment_terms,write_payment_terms,read_payment_customizations,write_payment_customizations,read_privacy_settings,write_privacy_settings,read_product_feeds,write_product_feeds,read_product_listings,write_product_listings,read_products,write_products,read_publications,write_publications,read_purchase_options,write_purchase_options,write_reports,read_reports,read_resource_feedbacks,write_resource_feedbacks,read_returns,write_returns,read_rollouts,read_script_tags,write_script_tags,read_shopify_payments_provider_accounts_sensitive,read_shipping,write_shipping,read_shopify_payments_accounts,read_shopify_payments_payouts,read_shopify_payments_bank_accounts,read_shopify_payments_disputes,write_shopify_payments_disputes,read_content,write_content,read_store_credit_account_transactions,write_store_credit_account_transactions,read_store_credit_accounts,write_theme_code,read_themes,write_themes,read_third_party_fulfillment_orders,write_third_party_fulfillment_orders,read_translations,write_translations,read_pixels,write_pixels,customer_read_companies,customer_write_companies,customer_write_customers,customer_read_customers,customer_read_draft_orders,customer_read_markets,customer_read_metaobjects,customer_read_orders,customer_write_orders,customer_read_store_credit_account_transactions,customer_read_store_credit_accounts,unauthenticated_write_bulk_operations,unauthenticated_read_bulk_operations,unauthenticated_read_bundles,unauthenticated_write_checkouts,unauthenticated_read_checkouts,unauthenticated_write_customers,unauthenticated_read_customers,unauthenticated_read_customer_tags,unauthenticated_read_metaobjects,unauthenticated_read_product_pickup_locations,unauthenticated_read_product_inventory,unauthenticated_read_product_listings,unauthenticated_read_product_tags,unauthenticated_read_selling_plans,unauthenticated_read_shop_pay_installments_pricing,unauthenticated_read_content,shop_app:oauth
必要な権限だけを付与するのが安全です。社内の運用要件に従って確認してください。
権限の設定が完了したら、「Create app(アプリを作成)」をクリックします。
作成後に表示される次の情報をコピーして保管してください。
・Client ID
・Client secret
※Client secretはパスワードと同様に厳重に管理し、第三者に共有しないでください。

THE CKBの店舗作成画面で、次の3項目を入力して保存します。
| 項目 | 入力内容 |
| 店舗 URL | Shopify 店舗の URL |
| Client ID | Shopify で取得した Client ID |
| Secret | Shopify で取得した Client secret |

画面上の表示:アプリをインストール / Install app
Shopify の画面に戻り、「アプリをインストール」をクリックします。

画面上の表示:インストールを承認 / Approve
表示された権限を確認して承認します。

画面で探すラベル:接続完了 / Connected
認証が完了すると、THE CKBの画面に戻ります。店舗画面を再読み込みし、接続状態が「接続済み」になっていれば、連携は完了です。



1、Shopifyでアプリのインストール承認が完了していることを確認してください。
2、THE CKBの店舗画面を再読み込みしてください。
3、接続状態が「接続済み」になっていることを確認してください。
4、「接続済み」に変わらない場合は、店舗URL、Client ID、Secret、API権限、インストールURL、コールバックURLの設定を再確認してください。
| 症状 | 確認・対応 |
| 連携の操作後も「未連携」と表示される | THE CKBの店舗画面を再読み込みしてください。また、入力した値の前後に余分な空白が入っていないか確認してください。 |
| 認証エラーになる | インストールURLとコールバックURLが、このページに記載されているURLと完全に一致しているか確認してください。 |
| 権限不足エラーになる | 必要なAPI権限を追加し、アプリを再インストールしてください。 |
| 同じストア用のアプリを複数作成してしまった | 新しく作成せず、Shopifyの開発アプリ一覧から、連携に使用するアプリを選択してください。 |
以上で、Shopifyアプリの作成とTHE CKBとの連携は完了です。
①ログインしてマイページから「店舗管理」の「API連携/店舗作成」メニューをクリックします。

②「未連携」ボタンをクリックします。

③「API連携へ」ボタンをクリックします。

④STORES店舗のメールアドレスとパスワードを入力して、「アプリを認証する」をクリックします。

⑤連携完了すると、THE CKBシステムに遷移して、連携が完了です。連携状態が「連携済」に変更します。

※注意点:
1.連携する前に、まず店舗を作成する必要があります。
2.親アカウント場合、全ての店舗の連携操作が可能です。
3.子アカウント場合、関連る店舗だけが操作可能です。
THE CKBシステムでは、TikTok Shop店舗とAPI連携を行うことで、商品データの一括出品、注文情報や在庫数の管理などがよりスムーズになります。
以下の手順に従って、TikTok Shopとの連携を行ってください。
① ログイン後、マイページから「店舗管理」→「API連携/店舗作成」メニューをクリックします。
(※事前にTHE CKB側で店舗を作成しておく必要があります)

② 表示された店舗一覧画面にて、「未連携」ボタンをクリックします。

③次に表示される画面で、「API連携へ」ボタンをクリックします。

④TikTok Shopのアプリストア(下記リンク)に遷移しますので、「インストール」をクリックします。
👉 https://seller-jp.tiktok.com/appstore/jp/7512709085121218309

⑤認証期間を「無期限」に設定し、必要事項を入力したうえで「確認してインストール」をクリックします。

⑥権限内容を確認し、「承認」ボタンをクリックしてください。

⑦認証が完了しました。
⑧認証後、自動的にTHE CKBのプラットフォームに遷移します。
すでにアカウントをお持ちの方はログイン、未登録の方は【新規登録】からアカウントを作成してください。

⑨ログイン後、THE CKBで連携したい店舗を選択してください。
まだTHE CKB側に店舗がない場合は、左下の「TikTokショップを新規作成」をクリックし、店舗名とURLを入力して新規作成してください。

⑩店舗の選択または作成が完了すると、TikTok ShopとTHE CKBの連携が完了し、状態が「連携済」と表示されます。

1、連携を行う前に、THE CKB上で店舗を作成しておく必要があります。
2、親アカウントではすべての店舗の連携操作が可能です。
3、子アカウントでは、自身に紐づいている店舗のみ操作可能です。
THE CKBシステムを通じてTikTok Shopへ商品を出品することで、
一括登録・在庫管理・データ同期を効率的に行うことができます。
以下の手順に従って、出品作業を進めてください。
① 出品したい商品を選び、「自社サイトへ一括登録」をクリックします。

② 表示された画面にて、言語を【日本語】に設定します。

③ 商品カテゴリーを選択します。
※このカテゴリーはTikTok Shopの分類に基づきます。

④ 出品に必要な情報を入力します:
・梱包後の荷物の重量
・梱包後の荷物の寸法
※上記の情報はTikTok出品時に必須です。不明な場合は仮の数値でも登録可能で、後ほどTikTokの管理画面で修正できます。

⑤ アップロード進行状況がポップアップで表示されます。

⑥ アップロードが完了すると、成功メッセージが表示されます。

⑦ 【紐付け管理を確認】ボタンをクリックし、【紐付け管理】画面に進みます。

⑧ 【マイページ】→【商品管理】→【紐付け管理】より、アップロード済み商品を確認できます。

⑨ 【店舗商品を取り込み】をクリックすると、TikTok Shop上の既存商品をTHE CKBに取り込めます。

⑩ 商品の右側にある【商品更新】をクリックし、TikTok上の最新情報と同期します。

⑪ SKU別の在庫数を手動で更新するには:
商品を展開し、右側の【TikTok在庫数を更新】をクリックしてください。
※TikTokの在庫数は手動更新のみ対応しています。自動同期には非対応です。

⑫ 在庫数を入力・変更後、【在庫を反映】をクリックすると、TikTok側へ反映されます。

THE CKBシステムでは、TikTok Shopで発生した注文をAPI経由で取り込み、倉庫出荷までの処理を一元化することが可能です。
手動または自動での発注に対応しており、出荷状況もTikTok側へ自動反映されます。
以下の手順に従って、注文〜発送処理を行ってください。
① ログイン後、【マイページ】→【注文管理(API発注)】メニューを開きます。

② 【注文取り込み】ボタンをクリックし、対象の期間を指定してTikTok注文を同期します。

③ 注文ごとに発送方法を選択します。
※現在対応している配送方法は【佐川配送_スピード便_一般商品】のみです。

④ 発送方法を選択後、【発注】ボタンをクリックして注文を確定します。


⑤ 発注が完了した注文は、【発注済】タブから確認できます。

⑥ 必要に応じて【自動発注】をONにします。
設定すると、日本時間毎日13:00に、前日13:00~当日13:00の注文を自動で取り込み・発注します。

※事前に配送方法を指定する方法はこちらのマニュアルをご参照ください:
⑦ 商品がTHE CKB倉庫に到着し、検品・梱包が完了すると注文ステータスが自動更新されます。
注文発生から約1時間後、TikTok側のステータスは「発送待ち」に自動で切り替わります。

⑧ THE CKBから商品が出荷されると、以下のようにステータスが反映されます:
・THE CKB:ステータスが「発送済」に
・TikTok:ステータスが「発送待ち」→「集荷待ち」に自動変更されます。

1、自動発注をONにすることで、毎日の手動操作が不要になり、業務効率が向上します。
2、TikTok側のステータスはTHE CKBでの出荷処理に連動して自動更新されます。
3、THE CKB倉庫到着後の検品・梱包が完了するまで出荷は行われません。
THE CKBでは、API連携による注文管理・発注が可能です。
以下の手順に沿って、「自動発注」または「手動発注」の設定・操作を行ってください。
1、ログイン後、マイページから「注文管理」→「注文管理(API発注)」をクリックします。API発注専用の画面が開きます。




■ 注意事項
1、発注後は、「注文履歴」ページにて商品ごとのステータスをご確認いただけます。
2、発注する前に、各商品と仕入れ先を事前に紐付けておく必要があります。
BASEやShopifyとTHE CKBを連携している場合、外部店舗の商品情報をTHE CKBシステムに取り込むことで、
スムーズにSKU紐付けや発注が行えます。
以下の手順で、連携済み店舗の商品情報を取り込んでください。
①ログイン後、マイページから「商品管理」→「紐付け管理」メニューをクリックします


②上部に表示される「店舗商品を取込」ボタンをクリックします。

③画面上に「取り込みが完了しました」と表示されれば、商品情報の取り込みは完了です。

・取り込まれた商品情報は、紐付け管理画面に一覧で表示されます。
・複数店舗を連携している場合、それぞれの店舗ごとに商品取り込みを行ってください。
BASE・Shopifyなどの店舗商品と、THE CKBシステム上の仕入れ商品(SKU)を紐付けることで、
自動発注や在庫連携などの機能を活用できます。
以下の手順でSKUの紐付けを行ってください。
■ 操作手順
①マイページ→「商品管理」→「紐付け管理」を開き、画面右側にある「商品SKU紐付け」ボタンをクリックします。

②表示された画面で、左側の「店舗商品を選択」ボタンをクリックします。

③「店舗商品取込」をクリックして、紐付けたい商品を一覧から選択します。
※公開中の商品データのみ取り込み可能です。

④次に、画面右側にて、紐付けたい仕入れ商品のURLやキーワードを検索し、該当商品を表示させます。

※OEM商品、セット組商品、在庫商品、またはお気に入り商品と紐付けたい場合は、
上部タブから「OEM商品」「セット組」「在庫商品」「お気に入り商品」を選択してください。
⑤該当の仕入れ商品の「選択して下さい」をクリックし、
バリエーション(色・サイズなど)を選択してSKUを紐付けます。

⑥紐付けが完了すると、1つの仕入れ商品SKUとの連携が成立します。

※各行の仕様には対応しており、1つの店舗商品SKUに対して、最大3つまでの仕入れ商品SKUと紐付けが可能です。
THE CKBでは、1つの店舗商品SKUに対して最大3つまでの仕入れ商品SKUを紐付けることができます。
これにより、在庫保有・仕入先分散・価格変動対応など、柔軟な運用が可能になります。
以下に機能の仕組みと注意点をまとめます。
・API注文が入った場合、紐付けされたSKUのうち、THE CKB倉庫に在庫がある商品(在庫保有分)から先に利用されます。
・すべての在庫が不足している場合は、第1仕入れ商品のURLから新規発注が行われます。
・異なる仕入れ先から仕入れた商品のTHE CKB在庫は、第1商品、第2商品、第3商品の順で利用されます。
つまり、複数の仕入れ商品SKUがTHE CKB倉庫に在庫として存在する場合、システムは設定された順序に従って在庫を消費します。
・3つの仕入れ商品の保有在庫数が共有されます。
在庫はSKUごとに分かれていても、優先順に共有在庫として自動適用されます。
・現時点では、新規発注時に利用される仕入れURLは、第1商品(メインSKU)のみです。
・第2・第3商品は在庫利用のための補助的な設定であり、買付先としては使用されません。
❗ 第1商品が仕入れ不可(在庫切れ・削除・URL無効など)の場合、システムが異常として通知を行います。
そのため、第1商品には常に仕入れ可能な商品URLを設定してください。
・価格・納期・信頼性の異なる仕入れ先を分けて第1〜第3に設定しておくことで、柔軟な在庫運用が可能になります。
・第1SKUには常に安定して供給できる仕入先を設定するのがおすすめです。
はい。仕入れたい商品URLを第1(メイン)商品に指定すれば可能です。
「メインに設定」ボタンをクリックすると、仕入れURLに設定できます。

システム内には、2つページにて追跡番号の自動反映設定ボタンを配置しました。
自動反映のボタンをクリックして自動反映のON/OFFを切り替えます。
「マイページ」→「注文管理」→「注文管理(API発注)」ページにて追跡番号の自動反映のON/OFFの切り替えができます。

「マイページ」→「注文管理」→「注文履歴」の注文詳細ページにて追跡番号の自動反映のON/OFFの切り替えができます。


注意点:
1)自動反映をONにすると、API注文の追跡番号が自動で更新致しますので、ご注意ください。
2)自動反映をOFFにすると、API注文の追跡番号が手動で更新する必要がありますので、ご注意ください。
3)既に発送済の注文には、追跡番号の自動反映を解除できません。
【※新しい連携手順は、[Shopify店舗と連携する方法(新版)]をご確認ください。】
ShopifyとTHE CKBをAPI連携することで、商品データ・注文情報・配送情報を自動で同期することができます。
以下の手順に沿って、アプリの作成および連携設定を行ってください。
設定は、大きく分けて以下の 4ステップ です。順番にご説明します。
1. Shopify側でアプリを作成する
2. プライバシー設定を行う
3. THE CKBにショップ情報を登録する
4. Shopifyでアプリをインストールする
1、Shopify開発者画面にアクセス
Shopify管理画面にログインし、「アプリ」→「アプリと販売チャネルの設定」をクリックします。
Shopify管理画面:https://dev.shopify.com/dashboard/128965947/apps


2、 アプリ作成画面へ進む
「アプリを開発」→「Dev Dashboardでアプリを開発」を順にクリックします。


3、 アプリを新規作成 (以下の手順でアプリを作成します)
a. 「Create app」をクリック 
b. アプリ名は任意で設定(例:CKB Integration)
※ 名前は管理用のものなので、どんな名称でも問題ありません。

c. アプリ設定画面で、以下のURLを入力します。
https://gateway-prod.theckb.com/api/shopify/privateapp/install

d. 権限(Scopes)の設定・Redirect URLの追加
「Select scopes」をクリックし、表示されている すべての権限にチェック を入れてください。
そして、 以下のURLをRedirect URLとして追加します。
https://gateway-prod.theckb.com/api/shopify/privateapp/callback

※ 権限が不足していると、注文や商品情報を正しく取得できません。
e. アプリをリリース
設定が完了しましたら、「Release」をクリックし、アプリをリリースします。
※バージョン番号は任意の値で問題ありません(例:1.0)

※このステップは、アプリ画面に「Select distribution method」が表示される場合のみ必要です。
表示されない場合は、本ステップはスキップして問題ありません。
1、配信方法を選択
「Select distribution method 」をクリックします。

2、APIアクセス方法を設定
「APIアクセス要求」にての「アクセス権をクエスト 」を選択し、すべての権限に同意してください。

3、顧客データへのアクセスを設定
「保護された顧客データ」「名前」「メール」「電話番号」「住所」それぞれについて、「選択」をクリックし、「ストアの管理 」にチェックを入れて保存します。



1、Client情報を確認
アプリの「Settings」を開き、以下の情報をコピーしてください。
• Client ID
• Client Secret

※ 次の手順でTHE CKBに登録します。
2、THE CKBにログイン
「マイページ → 店舗管理 → API連携/店舗作成」を開きます。
3、対象店舗を選択
対象店舗の「未連携」ボタンをクリックしてください。
※ 店舗が未作成の場合は、「店舗追加」から事前に作成してください。

(追加)店舗URLが自動で切り替わっている場合
※ Shopifyの設定により、ストアURLが別のアドレスに自動で切り替わっている場合があります。
そのまま登録すると、連携に失敗することがあります。
■ 確認方法
Shopify管理画面の「設定 → ドメイン」を開き、
一覧の中に、緑色のアイコンが表示されているドメインがある場合は、
現在そのアドレスに自動的に切り替わっています。

表示されている赤枠のURLをコピーします。
複数ある場合は、一番上のURLをご使用ください。

■ 入力方法
コピーしたURLを、THE CKBの【店舗URL】欄へ貼り付けて、保存してください。

4、 店舗情報を入力
以下の情報を入力します:
・ shopify店舗名
・ 店舗URL(例:https://◯◯◯.myshopify.com)
・ Client IDとSecret(Step ③-1 でコピーしたもの)

5、保存
入力内容を確認し、「保存」をクリックします。
※ 同一のShopify店舗URLは複数登録できません。
🔔 この時点ではまだ連携は完了していません。
続いてShopifyのアプリ管理画面に戻り、「Install app(アプリをインストール)」をクリックしてください。
1、アプリをインストール
Shopifyのアプリ管理画面に戻り、「Install app」をクリックします。

2、権限内容を確認
表示される権限内容を確認し、インストールを承認してください。

3、連携完了
インストールが完了すると、THE CKBとの連携が自動的に有効になります。
THE CKB画面上で店舗の状態が「連携済」と表示されれば完了です。
1、プライバシー設定は必須項目です
2、Shopify店舗URLは重複登録不可です
3、一度連携が完了すれば、再設定は不要です