お問い合わせ
お問い合わせ

つくーるAPI連携

つくーるAPI連携
つくーるで受注した注文をAPIでサブスクストアと自動連係させることが可能です。本機能をご利用いただく場合は、事前につくーるとご契約をいただく必要がございます。
 

お申込方法

「つくーるAPI連携」は無料のオプション機能となります。 【設定】＞【重要項目設定】＞【オプション申込設定】＞【オプション申込】にて「ツクールAPI連携：利用する」にチェックをいれ、お申込ください。
お申込を確認後、以下の項目についてお伺いするメールをサブスクコンシェルからご連絡いたします。各項目の詳細をご確認いただき、サブスクコンシェルまでご連絡いただけますようお願いいたします。
設定項目詳細
アカウントIDつくーるのアカウントIDを記載ください。
パスワードつくーるのパスワードを記載ください。
アクセスキーつくーるよりサブスクストアと連携させるためのアクセスキーが発行されるため、そちらを記載ください。
受注データ取り込み開始日時つくーるとAPI連携をし、受注取り込みを開始する日付をご指定ください。 ※オプション申込書をご提出いただいてから、設定完了までに2営業日いただいております。
デフォルトの配送方法サブスクストアに取り込む際のデフォルトの配送方法を1つ指定ください。
 

データ更新タイミング

ツクール受注の注文はリアルタイムでサブスクストアに反映されません。
取得するデータの幅(データ取得幅分)の設定により取り込み速度が異なりますため、データ取得幅分のご変更をご希望の場合はサブスクコンシェルまでお問い合わせください。
（例） データ取得幅分：30分 受注データ取り込み開始日時 ：2024-03-01 9:30
上記の状態で【2024-03-01 8:58】にテモナ株式会社にてつくーるAPI連携の設定を完了したと仮定します。
 
  1. 9:30に取込処理が実行され、2024-03-01 9:00 ~ 2024-03-01 9:30（取得幅が30分なため）のデータを取り込みます。
  1. 取込処理自体は10分ごとに指令が飛んでおりますが、データ取得幅分が30分の設定になっているため、30分経過後のタイミングで取込処理の指令に従って次の30分間のデータ連携が実施されます。 サブスクストアに取り込まれたつくーる受注データは【受注管理】＞【注文一覧（検索）】に時系列に蓄積されています。 ※つくーる受注データは受注経路「ツクール」という項目を持って取り込みされます。

商品コードの設定方法

※ツクール側とサブスク側のコードがどちらも全て半角でないとエラーとなりますためご注意ください。

～単品商品～

①商品コードとSKUコードが同じ場合
商品コードのみをつくーる側へご設定ください。
(例)
【サブスクストア】 ・商品コード：apple ・SKUコード ：apple
【つくーる】 ・商品コード：apple
②商品コードとSKUコードが異なる場合
商品コードとSKUコードを半角の「@@」でつなぎ、つくーる側へご設定ください。
(例)
【サブスクストア】 ・商品コード：aaaa ・SKUコード：bbbb
【つくーる】 ・商品コード：aaaa@@bbbb
 

～定期商品～

①定期コードとSKUコードが同じ場合
定期コードのみをつくーる側へご設定ください。
(例)
【サブスクストア】 ・定期コード：apple ・SKUコード ：apple
【つくーる側】 ・商品コード：apple
②定期コードとSKUコードが異なる場合
定期商品のコードと紐づく単品商品のSKUコードを半角の「@@」でつなぎ、つくーる側へご設定ください。
(例)
【サブスクストア】 ・定期コード：T_apple ・SKUコード ：apple
【つくーる側】 ・商品コード：T_apple@@apple
 

～頒布会商品～

①頒布会コードと頒布会1回目のSKUコードが同じ場合
頒布会コードのみをつくーる側へご設定ください。
(例)
【サブスクストア】 ・頒布会コード：apple ・頒布会1回目のSKUコード ：apple
【つくーる側】 ・商品コード：apple
 
 
②頒布会コードと頒布会1回目のSKUコードが異なる場合
商品のコードと頒布会1回目に紐づく単品商品のSKUコードを半角の「@@」でつなぎ、つくーる側へご設定ください。
(例)
【サブスクストア】 ・頒布会コード：H_apple ・頒布会1回目のSKUコード ：apple
【つくーる側】 ・商品コード：H_apple@@apple
 

ご留意点

  • 受注データ連携時、サブスクストアより「注文完了メール」は送信されません
  • 何かしらの理由で受注データの取り込みができない場合は、サブスクストアの【通知ログ】につくーる注文番号並びにその理由を通知するようになっております。 取り込みエラーの詳細は下記よりご確認ください。
  • サブスクストア管理画面＞商品管理にて、商品の公開場所は「両方」にご設定ください。 ※【商品管理】編集ページの「公開場所」にて設定できます。
  • 商品コードを記入する際は、先頭などに空白がないかご確認お願い致します。空白がある場合、正常に取り込めないことがございます。
  • つくーるでパスワードを入力していない場合、顧客は「ゲスト会員」として登録されます。 つくーるで6桁以上のパスワードが入力されている場合、顧客は「オンライン会員」として登録されます。
  • つくーるで「○○からのお得な情報を受け取る」にチェックを入れた場合、メルマガは「購読する」として連携されます。チェックなしの場合は、メルマガは「購読しない」として連携されます。
  • 頒布会コース（月指定）は連携ができません。
  • デフォルトの配送方法にメール便をご指定の場合、お支払い方法は代引き以外を設定してください。
  • サブスクストアで設定している定期頻度とつくーるで設定する定期頻度は一致させてください。 ※一致しない場合1ヵ月頻度として取り込みます。
  • 回数頒布会コースの初回お届け頻度の設定を、つくーるAPI連携からもご利用いただけます。 つくーる側では「2回目以降のお届け頻度」をご設定ください。受注後サブスクストア側では1回目~2回目の間隔は初回お届け頻度に設定した間隔が適用されます。
  • 連携可能な商品の組み合わせは下記となります。 定期×単品 OK 定期×セット商品固定 OK 定期×セット商品固定以外（お好み等） NG
 
 

利用可能な決済方法

以下の決済方法での連携が可能となっております。
  • 代引き
  • クレジットカード（テモナペイメントG、テモナペイメントZ）
  • NP後払い
  • Amazon Pay
  • スコア後払い
 

取込エラーが発生した場合

サブスクストアの画面右上の【通知ログ】に以下のフォーマットでエラー通知が表示されます。
■ 取り込みができなかったご注文がございます。
エラー理由1：つくーる注文番号1 エラー理由2：つくーる注文番号2,つくーる注文番号3,つくーる注文番号4
エラー通知詳細対象方法
その他：一時的なエラーが発生いたしました。再度お試しください。IDつくーるでエラーが生じた場合に発生します。原因はつくーるに確認する必要があります。こちらのエラーが表示された場合はサブスクコンシェルまでご連絡ください。E-mail：subsc-store＠temona.co.jp
移行前注文番号がすでに存在しますつくーる側での注文番号がすでにサブスクストア側に登録がある場合に出力されるエラーです。すでに取り込みが完了している注文となりますため、サブスクストアの管理画面で注文内容をご確認ください。受注管理＞注文一覧から検索条件1に「移行前注文番号」を選択し、つくーるの注文番号を入力し検索することで対象注文をご確認いただけます。
商品の登録がございませんサブスクストア側にご登録がない商品を取込まれた場合に出力されるエラーです。以下いずれかの場合に発生するため、ご確認ください。 ・商品コード設定の誤り ・つくーる側の販売方法設定の誤り （通常商品 or 定期商品（サブスク）) ・「@@」が半角ではない
指定の配送方法の場合代引はご利用できません代引きが利用できない配送方法を利用されている際に出力されるエラーです。管理画面の受注管理＞注文登録にて新規で注文作成を行ってください。 また、サブスクストアで登録されている該当商品の配送方法にメール便以外の配送方法を追加ください。
クレジット支払いの注文のデータに不備がございますつくーると連携時にクレジットカードのデータが正しく連携できなかった場合に出力されるエラーです。つくーる側の注文をご確認いただき、サブスクコンシェルまでお問い合わせください。E-mail：subsc-store＠temona.co.jp
支払い方法が存在しませんサブスクストア側にご登録されている支払方法以外の注文を取込まれた場合に出力されるエラーです。管理画面の商品管理＞各商品編集画面にて、利用可能な決済方法を紐づけてください。
必要なデータがございません姓、名(スペースでも可)、郵便番、都道府、住所1(全角変換）、電話番号、メールアドレス のいずれかがない場合に発生します。不足している情報をご入力ください。
注文に商品のデータが存在しません。つくーるでのアップセル設定を確認してください。つくーる管理画面のキャンペーン詳細にて、「受注データフォーマットを変更しない」にチェックが入っていない状態で、購入完了画面でのアップセルを利用している場合に発生します。 ※チェックを入れない場合、アップセル注文の取り込みができません。つくーる管理画面のキャンペーン詳細にて、「受注データフォーマットを変更しない」にチェックを入れてください。
住所情報が正しくありませんAmazonPay以外の支払い方法で「住所1、住所2」のどちらかがなかった場合に出力されるエラーです。管理画面の受注管理＞注文登録にて新規で注文作成を行ってください。
電話番号が正しくありません。桁数を再度ご確認ください電話番号が10~15文字以外の場合に出力されるエラーです。管理画面の受注管理＞注文登録にて新規で注文作成を行ってください。
お届け頻度に関する情報が正しくありません。該当する頻度情報がサブスクストアにない場合に出力されるエラーです。つくーる管理画面＞キャンペーン管理＞対象キャンペーン編集＞商品編集にて、サブスクストアと同じお届け頻度に修正ください。
スコア後払いの注文データに不備がございます。スコア後払いの決済データに不備がある場合に出力されるエラーです。エラーが起きた背景などをご確認いただき、サブスクコンシェルまでお問い合わせください。E-mail：subsc-store＠temona.co.jp
 

つくーるで購入完了画面のアップセルを行っている場合

つくーるにて購入完了画面でのアップセルを行っているショップ様は必ず、以下設定を行って頂く必要がございます。
つくーる管理画面＞キャンペーン管理＞対象キャンペーン編集＞2.商品・支払設定の、高度な設定はこちらからにある、「受注データフォーマットを変更しない」にチェック
  • こちらにチェックをしていないLPで完了画面のアップセル受注が行われた場合、注文をサブスクストアに取り込むことはできません。
  • サブスクストア管理画面＞通知ログに以下エラーが発生した場合は対象キャンペーンのアップセル設定をご確認ください。 「注文に商品のデータが存在しません。つくーるでのアップセル設定を確認してください。」
  • 取り込めなかった注文は管理画面＞受注管理＞注文登録より手動でご登録頂くか、LP編集後、ご購入者様に再度ご注文頂く必要がございます。