クラウド印刷
クラウド印刷はインターネット経由でレシートをプリンターに送信するため、POSを実行する端末にプリンターを接続する必要がありません。レジとは別のネットワークにあるプリンターでの印刷、注文ごとに自動印刷するキッチンプリンター、オンライン販売ごとの納品書の印刷に利用できます。
クラウドプリンターは、WP Admin → POS → 設定 → クラウド印刷で一度設定するだけです。その後はすべての端末に表示され、レジ係は他のプリンターと同じようにPOSから印刷できます。
POSから印刷する
クラウドプリンター用のレシートはショップ側で注文から作成されるため、印刷する前に売上がショップに保存されている必要があります。
- 支払い完了画面、または注文のレシートウィンドウで、プリンターメニューを開き、クラウドプリンターを選びます。
- レシートを印刷を押します。
- 画面に印刷先とプリンター名が表示されます。これはショップがジョブを受け取ったことを意味します。レシートが出力されたことを確認してください。出力されない場合、管理者は印刷キューでジョブの状況を確認できます。
レシートを印刷するを参照してください。特定のテンプレートを毎回クラウドプリンターに送るには、設定 → 印刷でそのテンプレートのプリンターを選択します。印刷先の振り分けを参照してください。
- 注文がショップに保存されている必要があります。 オフラインで受けた注文など、ショップがまだ売上を確認していない場合、POSに*このプリンターはショップ側のデータを印刷しますが、この売上はまだショップで確認されていません。確認後にもう一度印刷してください。*と表示されます。レジがオンラインになり、ショップが売上を確認したら、レシートを印刷をもう一度押してください。レジがオフラインの間は、過去の注文でもクラウドプリンターへの印刷は失敗します。
- セッションレポートと締め処理のレポートをクラウドプリンターに送信すると、代わりにシステムの印刷ダイアログが開きます。
- StarまたはEpsonのクラウドプリンターでHTMLテンプレートを使用する場合、*このクラウドプリンターはサーマルテンプレートのみ印刷できるため、何も印刷されません。サーマルテンプレートを選択してください。*と表示されます。
クラウドプリンターは、すべての端末の設定 → 印刷のプリンター欄に自動で表示されます。各行の2行目には、Star CloudPRNT · WCPOSで管理などの種類が表示されます。レジ係はその行のテスト印刷や、⋯メニューの設定レポートをコピーを押せますが、編集や削除はできません。編集や削除はクラウド印刷画面で行います。プリンターの設定を参照してください。
プリンターの種類を選ぶ
プリンターやルールの追加は、店舗のオーナーまたは管理者がWP Admin → POS → 設定 → クラウド印刷で行います。
クラウド印刷画面に接続するプリンターの種類は何ですか? と表示されます。お使いのプリンターに合うものを選んでください。
- Star CloudPRNT — CloudPRNTを内蔵したStarプリンター(mC-Print、TSP143IV…)向けです。別のアカウントを作らず、無料で接続したい場合に適しています。プリンターがショップからジョブを取得します。サーマルテンプレートのみ対応。
- Epson Server Direct Print — Epsonの「インテリジェント」TMプリンター(TM-T88VI/VII、TM-m30III、TM-iシリーズ)向けです。プリンターがショップからジョブを取得します。サーマルテンプレートのみ対応。
- Star Online — stario.onlineアカウントに紐づけられたStarプリンター(mC-Print3、TSP143IV、mC-Label3)向けです。ショップがStar Onlineにジョブを渡し、Star Onlineが配信します。サーマルテンプレートのみ対応。
- PrintNode — 店舗のコンピューターで軽量なPrintNodeアプリを実行できる場合に、一般的なUSBプリンターやネットワークプリンターで利用できます。ショップがPrintNodeにジョブを渡し、そのコンピューター上のアプリが印刷します。すべてのテンプレートに対応。
StarまたはEpsonのクラウドプリンターではHTMLテンプレートを印刷できません。レシートをプリンター固有のコマンドに変換する必要があるためです。HTMLテンプレートやページ全体を使うテンプレートにはPrintNodeを使用してください。サーマルテンプレートを参照してください。
ジョブがプリンターに届くまで
- ショップ — 注文とテンプレートからレシートを作成し、ジョブを印刷キューに保持します。POSからの印刷も自動印刷ルールも、ここから始まります。
- WCPOS Cloud Print — 中継サービスです。Star CloudPRNTまたはEpsonのプリンターは通常、このサービスを通じてジョブを取得するため、プリンターが次に問い合わせるまでジョブは待機します。
- PrintNode — ショップがPrintNodeにジョブを渡し、店舗のコンピューター上のPrintNodeアプリが印刷します。
- Star Online — ショップがStar Onlineにジョブを渡し、Star Onlineがプリンターに配信します。
プリンターを追加する
- WP Admin → POS → 設定 → クラウド印刷を開きます。クラウドプリンター一覧で + プリンターを追加を押します。
- 種類を選びます。
- プリンター名を入力します(例:キッチンプリンター)。WCPOSはこの名前からプリンターIDを生成します。IDは後から変更できません。変更するにはプリンターを削除し、追加し直してください。
- 種類に応じた手順を完了します:Star CloudPRNTまたはEpson、PrintNode、Star Online。
- プリンターがクラウドプリンター一覧にカードとして表示されます。カードのテスト印刷を押します。プリンターのカードを参照してください。
Star CloudPRNTまたはEpson Server Direct Print
これらのプリンターは自らジョブを取得するため、アカウントの連携は不要です。プリンター側からショップに接続するので、ポートの開放、固定IPの設定、ファイアウォールの変更は必要ありません。プリンターが次に問い合わせたときにジョブが印刷されます。+ プリンターを追加の最後の手順で、秘密トークンを含むプリンターのポーリングURLが表示されます。
Star CloudPRNTまたはEpsonのプリンターを接続する
- ポーリングURLの横にあるコピーを押します。アドレス全体が表示されるのは一度だけです。紛失した場合は、プリンターを削除して追加し直し、新しいアドレスを取得してください。カードの設定とトークンでは、トークンが非表示になります。
- プリンター自体の設定ページを開き、サーバーURL欄にアドレスを貼り付けます。StarではCloudPRNT設定、EpsonではServer Direct Print設定にあります。ポーリングを有効にして保存し、プリンターを再起動します。
- カードに戻ると、プリンターが初めて取得を行った時点で、状態がプリンターを待機中から接続済みに変わります。
アドレスは通常、https://cloudprint.wcpos.comで始まります。これはWCPOS Cloud Printの中継サービスのアドレスで、通常はこちらを使用します。アドレスの下にある詳細設定:このサイトに直接接続(中継なし)を開くと、代わりに直接接続URLが表示されます。サイトに直接接続できないプリンターでは、プリンターを待機中のままになることがあります。
Epsonでは、WCPOSからこの方法で印刷している間、Server Direct Printを有効のままにしてください。Server Direct Printを参照してください。
PrintNode
PrintNodeを使うには、プリンターの近くのコンピューターでクライアントを実行し、PrintNodeアカウントからAPIキーを取得する必要があります。
PrintNodeプリンターを接続する
- プリンターの近くのコンピューターにPrintNodeクライアントをインストールし、サインインします。印刷するには、コンピューターの電源が入り、クライアントが実行されている必要があります。
- PrintNodeアカウントでAPIキーを作成します。
- + プリンターを追加でPrintNodeを選び、PrintNode APIキーにキーを貼り付けて、プリンターを取得を押します。
- プリンターを選択でクライアントが報告するプリンターを選び、設定を完了します。最後の手順にPrintNodeに連携済みと表示されます。コピーするアドレスやトークンはありません。
連携後、プリンターのカードで印刷形式を設定します。
- PDF(推奨) は、サーマル、HTMLを問わず、すべてのテンプレートをPDFとして印刷します。変更する理由がなければ、この設定のままにしてください。
- ESC/POS RAW — サーマルテンプレートのみは、サーマルテンプレートをPDFではなくレシートプリンター用のコマンドとして送信します。HTMLテンプレートは引き続きPDFとして送信されます。
Star Online
Star Onlineを使うには、stario.onlineアカウントからプリンターのグループアドレスとAPIキーを取得する必要があります。
Star Onlineプリンターを接続する
- stario.onlineでデバイスグループを開き、グループのCloudPRNT URLをコピーします。URLは
https://device.stario.online/cloudprnt/...のような形式で、EUではhttps://eu-device.stario.online/cloudprnt/...です。 - stario.onlineで、EnumDevices、ViewDevice、PrintToDevice、ViewDeviceGroupsの権限を持つAPIキーを作成します。これらの権限がないキーでも受け付けられますが、一覧の取得や印刷はできません。
- + プリンターを追加でStar Onlineを選びます。CloudPRNT URLとStar Online APIキーを貼り付け、デバイスを取得を押します。
- デバイスを選択でプリンターを選び、設定を完了します。カードにデバイス、グループ、AccessIdentifierが表示されます。
プリンターのカード
各クラウドプリンターは、クラウドプリンター一覧にカードとして表示されます。
- 名前 — クリックするとプリンター名を変更できます。その下に種類が表示されます。
- 状態 — 下記の一覧を参照してください。30秒ごとに更新されます。
- 最終チェックイン — Star CloudPRNTまたはEpsonのプリンターが最後に取得を行った時刻、または未実行が表示されます。
- プリンターID — プリンターを追加したときに確定します。
- 印刷形式 — PrintNodeのみ:PDF(推奨)またはESC/POS RAW — サーマルテンプレートのみ。PrintNodeを参照してください。
- テスト印刷 — 短いテストページを送信します。…にテスト印刷を送信しましたというメッセージ、または失敗の理由が表示されます。
- プリンターの操作(⋮)— 設定とトークンで最後の設定手順を再度開きます。プリンターを削除でプリンターへのジョブの配信を停止します。後から再度追加できます。
Star CloudPRNTとEpson Server Direct Printの状態
- プリンターを待機中 — プリンターはまだ取得を行っていません。プリンターに設定したポーリングURLを確認してください。「プリンターを待機中」のままになるを参照してください。
- 接続済み — プリンターが過去二分半以内に取得を行いました。
- オフライン — プリンターは以前に取得を行っていますが、最近は行っていません。電源が入り、オンラインになっていることを確認してください。
- ブロック中 — 中継サービスがショップにアクセスできません。理由はカードに表示されます。Cloudflareなどのセキュリティサービスやファイアウォールプラグインによるブロック、またはサイトからのサーバーエラー応答が原因です。Star CloudPRNTまたはEpsonの問題を参照してください。
Star OnlineとPrintNodeの状態
- オンライン — サービスがプリンターを利用可能と報告しています。
- オフライン — サービスがプリンター、またはPrintNodeを実行するコンピューターを利用できないと報告しています。PrintNodeの場合、コンピューターがスリープしておらず、クライアントが実行されていることを確認してください。
- 不明 — WCPOSがサービスから状態を取得できませんでした。PrintNodeまたはStar OnlineでAPIキーを確認してください。
注文を自動印刷する
自動印刷ルールを使うと、誰も操作しなくても注文が印刷されます。設定は任意です。ルールがない場合、クラウドプリンターはレジ係がPOSから印刷したときだけ印刷します。
自動印刷ルールで + ルールを追加を押します。各ルールは文章の形で表示され、下線のある部分がそれぞれメニューになっています。
店頭(POS)でのすべての注文を、作成後すぐに、キッチン伝票テンプレートでキッチンプリンターに2部自動印刷します。
- 対象の注文 — すべての注文、店頭(POS)でのすべての注文、またはすべてのオンライン注文。WCPOS Proでは、特定の店舗の店舗別の注文も選択できます。店舗別プリンターを参照してください。
- プリンター — 登録済みのクラウドプリンターのいずれかを選びます。
- テンプレート — そのプリンターで印刷できるテンプレートのみが表示されます。テンプレートはPOS › テンプレートから取得されます。
- 部数 — 1~5部。
- タイミング — 支払い完了後(デフォルト)、または作成後すぐに。POSの注文では、作成とはカートが最初に保存された時点を指すため、キッチン伝票は支払い前に印刷されます。
キッチン伝票と顧客用レシートなど、複数のルールで同じ注文を印刷できます。各ルールが同じ注文を印刷するのは一度だけです。レシートはショップ側で注文とテンプレートから作成されるため、レジ係の操作は不要です。自動印刷でキャッシュドロワーが開くことはありません。
ルールのプリンターを、そのテンプレートに対応していないものに変更すると、そのプリンターで印刷できる最初のテンプレートに切り替わります。意図したテンプレートになっているか確認してください。印刷できるテンプレートが一つもない場合、テンプレート欄は空になり、選択するまでルールは印刷を行いません。
店舗別プリンター(Pro)
WCPOS Proを使用し、複数の店舗がある場合、対象の注文メニューに各店舗の店舗別の注文も表示されます。店舗別ルールは、その店舗に属する注文を印刷します。対象は、その店舗のレジで受けた注文と、注文の編集画面でその店舗に割り当てた注文です。オンライン注文は、店舗を割り当てない限りどの店舗にも属さないため、全店舗対象のルールでのみ印刷されます。
ルールは重複して適用されます。ある店舗の注文は、その店舗のルールに加えて、すべての注文、店頭(POS)でのすべての注文、すべてのオンライン注文を対象とする各ルールでも印刷されます。ある拠点のキッチン伝票が別の拠点のプリンターに出ないようにするには、拠点ごとに店舗別ルールを設定し、その伝票に全店舗対象のルールを追加しないでください。
印刷キュー
ルールの下にある印刷キューには、すべてのジョブが注文、プリンター、テンプレート、状態、詳細、作成日時とともに表示されます。注文番号は注文へのリンクになっています。
- 状態(要確認、すべての状態、または待機中、印刷中、印刷済み、失敗、キャンセル済みのいずれか)とプリンターで絞り込みできます。
- 待機中のジョブはキャンセル、失敗したジョブは再試行(新しいジョブとして追加され、#…として再試行済みと表示)、ジョブの削除は削除で行います。複数の行にチェックを入れると、選択項目をキャンセルまたは選択項目を削除を実行できます。
- 詳細には、*Star Onlineがリクエストを拒否しました。APIキーに必要な権限があることを確認してください。*など、ジョブが失敗した理由が表示されます。
Star CloudPRNTまたはEpsonのプリンターに印刷待ちのレシートがあり、10分間取得が行われていない場合、または一度も取得されていない場合は、警告が表示されます。警告にはプリンター名、最後の取得時刻、待機中のレシート数と、すべてキャンセルが表示されます。
プリンターからこのジョブの確認が返されませんでしたは、印刷されたかどうかをWCPOSが判断できないことを意味します。二重印刷を避けるため、自動では再送信されません。プリンターを確認し、何も出力されていない場合に限り再試行を押してください。
ジョブの保持期間と再試行
印刷済みとキャンセル済みのジョブは7日後、失敗したジョブは30日後に削除されます。開発者はwcpos_print_job_retention_daysおよびwcpos_print_job_failed_retention_daysフィルターで変更できます。
WCPOSからPrintNodeまたはStar Onlineに渡すジョブは、最初は一分後、次は二分後に再試行され、合計三回試行されます。サービスがキーまたはアカウントを拒否した場合は即座に失敗となり、詳細に理由が表示されます。
中継サービスWCPOS Cloud Print
Star CloudPRNTまたはEpsonのプリンターのポーリングURLは、ご自身のサイトではなくcloudprint.wcpos.comを指します。これは、プリンターとショップの間をつなぐ、WCPOSが運営する無料の中継サービスWCPOS Cloud Printです。
有効にする操作は不要です。ジョブはプリンターに届くまでに中継サービスを通るため、接続するとサイトのアドレスがwcpos.comと共有され、注文の詳細を含むレシートがこのサービスを経由します。プライバシーポリシーを参照してください。
中継サービスの仕組み
レシートプリンターは小規模なファームウェアで動作しており、更新されることはまれです。多くの機種は、最新のホスティング環境にあるショップに安全に接続できなかったり、サイトの手前にあるCloudflareなどのサービスに拒否されたりします。その場合、設定がすべて正しくてもプリンターを待機中のままになります。中継サービスはプリンターが利用できる接続先を提供し、そのリクエストをショップに転送します。
- 初めてクラウド印刷を開くと、サイトが自動的に中継サービスに接続します。
- 中継サービスを利用するには、サイトがHTTPSに対応している必要があります。対応していない場合は、クラウド印刷にその旨が表示されます。
- ローカルのテストサイトなど、中継サービスに接続できないサイトでは、ポーリングURLがサイトを直接指します。
- カードのブロック中は、中継サービスがサイトにアクセスしたものの拒否されたことを意味します。カードの案内に従い、セキュリティサービスで中継サービスからのアクセスを許可してください。Star CloudPRNTまたはEpsonの問題を参照してください。
中継サービスを無効にする(開発者向け)
Star CloudPRNTまたはEpsonのプリンターの最後の設定手順には、詳細設定:このサイトに直接接続(中継なし)と直接接続URLがあります。サイト全体で中継サービスを無効にするには、次のようにします。
add_filter( 'wcpos_cloud_print_relay_enabled', '__return_false' );
WCPOS 2.0より前では、このフィルターはwoocommerce_pos_cloud_print_relay_enabledでした。この名前は引き続き動作しますが、2.0から非推奨となっており、早ければ2.2で削除されます。フックの命名を参照してください。
レシートがStar CloudPRNTプリンターに届く仕組み
WCPOSは、StarPRNTコマンド、レシートのPNG画像、プレーンテキストの順にプリンターに提示し、プリンターが読み取り可能と報告した中で最適な形式を使用します。Line Modeのみを読み取れる旧型のStar機種(TSP650II、TSP700II、TSP800II)では、ロゴは画像経由でのみ印刷できます。画像を使用するには、サーバーにGDおよびFreeTypeのPHP拡張が必要です。EpsonプリンターにはePOS-Print XML、Star OnlineにはStar Document Markupが送信されます。
問題が発生した場合
POSからクラウドプリンターに印刷したのに、レシートが出ません。 POSが把握しているのは、ショップがジョブを受け取ったことだけです。印刷キューを開き、該当する注文を探してください。
- 待機中 — プリンターがまだジョブを受け取っていません。カードでプリンターの状態を確認してください:Star CloudPRNTとEpson Server Direct Printの状態、またはStar OnlineとPrintNodeの状態。
- 印刷中 — ジョブは送信中で、プリンターから印刷完了の応答はまだありません。
- 失敗 — 詳細に理由が表示されます。原因を解消してから再試行を押してください。詳細にプリンターからこのジョブの確認が返されませんでしたと表示されている場合は、すでに印刷されている可能性があります。再試行を押す前にプリンターを確認してください。
- 印刷済み — プリンター、PrintNode、またはStar Onlineがジョブを受け取りました。用紙を確認し、プリンター列に目の前のプリンターの名前が表示されていることを確認してください。
テンプレートが選択肢に表示されません。 Star CloudPRNT、Epson、Star Onlineのプリンターはサーマルテンプレートのみに対応しています。サーマルテンプレートを選ぶか、PrintNode経由で印刷してください。
Star CloudPRNTまたはEpsonの問題
「プリンターを待機中」のままになります。 プリンターがショップに一度もアクセスできていません。プリンターに設定したポーリングURLが完全に一致しているか確認してください。一文字でも間違っていると、取得は毎回拒否されます。不確かな場合は、プリンターを削除して追加し直し、新しいURLを取得してください。プリンターのCloudPRNTまたはServer Direct Print設定でポーリングが有効になっていることを確認し、再起動します。直接接続URLを使用した場合は、cloudprint.wcpos.comのアドレスに切り替えてください。このような問題を解決するのが中継サービスです。
ブロック中。 セキュリティサービスやファイアウォールプラグインが中継サービスを拒否しているか、サイトがサーバーエラーを返しています。カードのメッセージに従ってください。サーバーエラーの場合は、サイトヘルスとエラーログを確認してください。
中継サービスの導入前に設定しました。 プリンターに保存済みのアドレスは引き続き利用できます。そのプリンターがプリンターを待機中のままになる場合は、削除して追加し直し、新しいcloudprint.wcpos.comのアドレスをプリンターに設定してください。
PrintNodeの問題
プリンターを取得できません。 APIキーと、コンピューター上でPrintNodeクライアントが実行されていることを確認してください。
PrintNodeのジョブが印刷されません。 クライアントが実行中かつオンラインである必要があります。コンピューターがスリープしていると印刷されません。クライアントが報告するプリンターを選択していることと、キーが失効していないことを確認してください。
Star Onlineの問題
デバイスを取得できません。 *Star Onlineのデバイス一覧を取得できませんでした。CloudPRNT URLとAPIキーを確認してください。*というメッセージが表示されます。キー全体をコピーしたこと、キーが失効していないこと、URLと同じstario.onlineアカウントおよびリージョンに属するキーであることを確認してください。次に、Star Onlineに記載された権限がキーにあるか確認します。このStar Onlineグループにデバイスが見つかりませんは、グループにデバイスがないか、URLが別のグループのものであることを意味します。