プリンターの設定
プリンターの設定は POS の設定 > プリンターにあります。各デバイスが独自のプリンター構成を管理しており、プリンターはローカルに保存され、デバイス間で同期されません。
このページでは、USB、Bluetooth、またはローカルネットワーク経由でレジに接続されたプリンターについて説明します。別の部屋や別の場所にあるプリンター、またはすべてのデバイスで共有したいプリンターについては、クラウド印刷をご覧ください。店舗用に設定したクラウドプリンターは、すべてのデバイスのプリンター一覧に自動的に表示されます。ここで追加する必要はありません。
プラットフォーム別の対応プリンター
プリンターの追加フォームは使用しているアプリに合わせて変化し、各プラットフォームで実際に使用可能な接続方法とオプションのみが表示されます。
| プラットフォーム | 対応プリンター | 接続方法 |
|---|---|---|
| Web アプリ | Web サーバー内蔵の Epson および Star プリンター(ネットワーク)、WebUSB/Web Bluetooth 経由の Epson および Star プリンター(USB/Bluetooth、Chrome/Edge のみ) | ネットワーク (HTTP)、USB、Bluetooth |
| デスクトップアプリ | すべてのネットワークレシートプリンター | ネットワーク (raw TCP)、USB、Bluetooth |
| iOSアプリ | EpsonおよびStar | ネットワーク、Bluetooth |
| Androidアプリ | EpsonおよびStar | ネットワーク、Bluetooth、USB |
Webブラウザは生のTCP接続を開くことができません。EpsonおよびStarのレシートプリンターにはWebサーバーが内蔵されており、HTTP経由で印刷ジョブを受け付けます。これが、ブラウザからネットワークプリンターにESC/POSコマンドを送信する唯一の方法です。デスクトップアプリにはこの制約がなく、TCP経由で直接接続できます。
ブラウザでのUSBおよびBluetooth印刷も利用できますが、ChromeまたはMicrosoft Edgeでのみ動作します(WebUSBおよびWeb Bluetooth APIを使用するため)。SafariとFirefoxではサポートされていません。
モバイルアプリでは、BluetoothおよびUSB印刷はEpsonとStarの公式SDKを使用するため、EpsonまたはStarのプリンターが必要です。汎用プリンターはネットワーク経由でのみ使用できます。
プリンターの追加
プリンター設定を開く
POSの設定 > プリンターを開きます。プリンターが未設定の場合は、プリンターを追加ボタンのある空の画面が表示されます。各プリンターにはプリンター名があり、これは識別用のラベルで「レシートプリンター」(次は「レシートプリンター 2」と順に続きます)が自動入力されます。プリンターを区別しやすい任意の名前に変更できます。
プリンターの接続方法を選択する
すべてのプラットフォームで最初に接続タイプを選択します。表示される選択肢はプラットフォームがサポートするもののみです。選択に応じて、以下のフィールドが更新されます。
- Webアプリ — ネットワーク、USB、またはBluetooth(USBとBluetoothはChromeまたはEdgeが必要です)。ネットワークプリンターの場合は、ベンダー(EpsonまたはStar)を選択します。ブラウザはそのメーカーの内蔵Webサーバーを経由してネットワークプリンターに接続するためです。
- デスクトップアプリ — ネットワーク、USB、またはBluetooth。
- モバイルアプリ — ネットワークまたはBluetooth、およびAndroidではUSB(iOSはUSBに対応していません)。
プリンターの識別
ネットワークプリンター — IPアドレスを入力します(例:192.168.1.100)。WCPOSがそのアドレスを検出し、EpsonまたはStarデバイスかを判別して、ポート、コマンド言語、ベンダーを自動入力します。検出が完了すると「Detected: Epson」または「Detected: Star」のラベルが表示されます。Webアプリでは、接続先のエンドポイントURLも表示されます。
BluetoothまたはUSBプリンター(モバイル) — 検出されたデバイス一覧からプリンターを選択します。デバイスを選択すると、名前とベンダーが自動的に入力されます。プリンターが一覧に表示されない場合は、プリンターをスキャン(Bluetooth)または更新(USB)をタップしてください。
自動検出で正しく設定されない場合は、詳細設定ですべて調整できます。
保存とテスト
保存をクリックします。WCPOSはまずテスト印刷を実行し、成功した場合にのみプリンターを保存します。
テスト印刷は簡易的な診断で、番号付きの列ルーラー、中央揃えの標準サイズと倍角テキスト、左右揃えの行、および用紙カットで構成されています。プリンターに接続できるかだけでなく、用紙幅、配置、サイズ、カットがすべて正しく設定されているかを確認できるように設計されています。
テストが失敗した場合、エラーとともにテストせずに保存オプションが表示され、そのままプロファイルを保存できます。
接続タイプ
プリンター追加フォームの上部で接続タイプを選択すると、接続フィールドがそのタイプに合わせて更新されます。利用可能なタイプはプラットフォームによって異なります(上記の表を参照)。
ネットワーク
プリンターがデバイスと同じ Wi-Fi ネットワーク上にある場合に使用します。デスクトップおよびモバイルアプリでは、ネットワークスキャンをタップしてプリンターを自動検出するか、IP アドレスを手動で入力します — プリンターの IP アドレスの確認方法を参照してください。Web アプリでは手動 IP 入力のみ対応しています。デスクトップおよびモバイルアプリでは、ネットワークプリンターとして Epson、Star、汎用プリンターを使用できます。Web では Epson または Star のみ対応しており、ネットワーク接続の設定でどちらかを選択します。
Bluetooth
プリンターが Bluetooth でデバイスとペアリングされている場合に使用します。リストからプリンターを選択すると、名前とメーカーが自動的に入力されます。モバイルでは、Bluetooth 印刷に Epson および Star のネイティブ SDK を使用するため、Epson または Star のプリンターが必要です。Web では、Chrome または Edge で Web Bluetooth API を介して Bluetooth を使用できます。
USB
プリンターが USB ケーブルで接続されている場合に使用します。接続済みデバイスのリストから選択してください。USB は Web(Chrome または Edge、WebUSB 経由)、デスクトップアプリ、Android で利用できますが、iOS では汎用 USB 周辺機器がサポートされていないため利用できません。モバイルでの USB 印刷には、Epson または Star のプリンターが必要です。
ポート設定はネットワークプリンターにのみ適用されます — Bluetooth および USB 接続では表示されません。
詳細設定
詳細設定を展開して、プリンターの設定を細かく調整できます。ほとんどの項目は、メーカーが判明すると自動的に入力されます。
以下の設定はすべてのプラットフォームで適用されます:
| 設定 | オプション | 説明 |
|---|---|---|
| 言語 | ESC/POS, StarPRNT, Star Line Mode | プリンターが使用するコマンドプロトコルです。検出されたメーカーに基づいて自動入力されます。 |
| プリンター文字幅 | 58mm(32文字)、80mm 標準(42文字)、80mm ワイド(48文字) | 1行に収まる文字数です。用紙とプリンターに合わせて設定してください。80mmプリンターのほとんどは1行42文字ですが、48文字のものもあります。 |
| レシート全体のラスター印刷 | オフ / オン | テキストではなく画像としてレシート全体を印刷します。詳細は下記のレシート全体のラスター印刷を参照してください。 |
以下の2つの設定は、プラットフォームと接続タイプによって動作が異なります:
| 設定 | オプション | 適用対象 |
|---|---|---|
| メーカー | エプソン、スター、汎用 | プリンターの製造元です。Webアプリでは、ネットワーク接続の下でメーカーを直接選択します(エプソンまたはスターのみ)。詳細設定としては表示されません。汎用はデスクトップおよびモバイルアプリのネットワークプリンターで使用できますが、BluetoothやUSB接続では使用できません。 |
| ポート | 自動入力 | プリンターのネットワークポートで、IPアドレスの横に表示されます。ネットワーク接続のみ — BluetoothおよびUSBでは非表示です。メーカーに基づいて自動入力されます(Webの場合は、POSがHTTPまたはHTTPSのどちらで配信されているかも考慮されます)。ネットワーク側でポートが変更されている場合のみ変更してください。 |
プリンターオプション
これらのトグルはプリンター追加フォームの下部にあります:
| オプション | 説明 |
|---|---|
| 用紙自動カット | レシート印刷後に自動的に用紙をカットします |
| キャッシュドロワー自動オープン | 印刷後に接続されたキャッシュドロワーを開くキックコマンドを送信します |
| デフォルトに設定 | このプリンターをデフォルトプリンターに設定します — 特定のプリンターにルーティングされていないレシートに使用されます |
販売完了時にレシートを自動印刷する機能は、プリンター設定ではなくカート設定です。POSのカート設定でレシート自動印刷を有効にしてください。使用されるプリンターは、デフォルトプリンターおよびテンプレートごとのプリンタールーティング設定によって決まります。
印刷ルーティング
複数のテンプレートを使用する場合(例:感熱レシートと A4 請求書)、印刷ルーティングによって各テンプレートがどのプリンターで印刷されるかが決まります。ルーティングは以下の順序で3つのレイヤーがチェックされます:
- ジョブごとの上書き。 レシート画面では、テンプレート切り替えの横にプリンターのドロップダウンがあります。ここでプリンターを選択すると、その印刷ジョブに限りすべての設定が上書きされます。テンプレートを切り替えると自動に戻ります。
- 設定による上書き。 設定 → 印刷ルーティングで、各テンプレートに特定のプリンターを割り当てることができます。例えば、感熱レシートを Epson ネットワークプリンターに、HTML 請求書をシステム印刷ダイアログにルーティングできます。テンプレートを自動に戻すと上書きが解除されます。
- 自動マッチ。 オーバーライドが設定されていない場合、WCPOS は自動的にマッチングを行います:
- サーマルテンプレートは、文字幅が一致するサーマルプリンターにルーティングされます。58mm サーマルテンプレートは 32 桁プリンターを優先し、80mm テンプレートは 42 桁または 48 桁プリンターを優先します。
- HTML テンプレートはシステムの印刷ダイアログにルーティングされます。
- 複数のプリンターが一致する場合は、デフォルトプリンターが優先されます。
テンプレートを互換性のないプリンターに手動で送信した場合(例:サーマルテンプレートをシステムの印刷ダイアログに送信)、レシート画面にアンバー色の不一致警告が表示されます。印刷は続行されますが、出力が正しくレンダリングされない場合があります。
ルーティングのオーバーライドはデバイスごとに保存されます。各 iPad、スマートフォン、またはコンピューターがそれぞれ独自のルーティングを管理し、サーバー側での同期はありません。
印刷ルーティングの設定ページは、プリンターを少なくとも 1 台追加した後にのみ表示されます。プリンターが設定されていない場合、すべてのテンプレートは暗黙的にシステムの印刷ダイアログを使用します。店舗に設定されたクラウドプリンターもここにカウントされ、デバイスに追加しなくても自動的にルーティング先として表示されます。
レシート全体のラスター化
デフォルトでは、WCPOS はレシートをテキストとしてサーマルプリンターに送信します。これはプリンター内蔵フォントを使用するため、高速でコンパクト、かつ鮮明です。ただし注意点があります。サーマルプリンターのフォントは限られた文字セットしかカバーしていません。プリンターにフォントがない文字体系(多くの非ラテン文字、右から左に書く文字、一部の記号など)は、空白の四角や文字化けとして出力されることがあります。
レシート全体のラスター化はこの問題を解決します。この機能を有効にすると、WCPOS はレシート全体を画像としてレンダリングし、その画像をプリンターに送信します。これにより、どの言語や文字体系でも、画面に表示されるとおりの内容が印刷されます。
プリンターごとに詳細設定で有効にしてください。注意点:
- **速度が低下します。**画像はテキスト1行よりもデータ量が大きいため、レシートの送信と印刷に時間がかかります。
- **必要な場合のみ使用してください。**テキストでレシートが正常に印刷される場合は、オフのままにしてください。
- この設定は、ネットワーク、Bluetooth、USB など、すべての接続方式のサーマルプリンターに適用されます。フルページレンダリングから印刷するシステム印刷ダイアログには適用されません。
プリンターの検出
プリンターの検出方法は接続方式によって異なります:
- Bluetooth と USB — モバイルアプリでは、プリンターをスキャン(Bluetooth)または更新(USB)をタップし、一覧からプリンターを選択します。名前とベンダーが自動的に入力されます。Web(Chrome または Edge)では、接続をクリックし、ブラウザのデバイス選択画面からプリンターを選択します。
- ネットワーク — デスクトップおよびモバイルアプリでは、ネットワークスキャンをタップすると、ローカルネットワーク上のプリンターが自動的に検出されます(デスクトップは mDNS/Bonjour で検出、モバイルは Epson および Star SDK を使用)。一覧からプリンターを選択してください。IP アドレスを直接入力することもできます。詳細は下記のプリンターの IP アドレスの確認を参照してください。ブラウザはネットワークスキャンができないため、Web アプリでは常に手動で IP アドレスを入力します。
プリンターの IP アドレスの確認
ほとんどのレシートプリンターは、IP アドレスが記載されたセルフテストページを印刷できます:
- Epson:電源を入れながらフィードボタンを押し続ける
- Star:電源が入った状態でフィードボタンを5秒間押し続ける
または、ルーターの接続デバイス一覧やプリンターの設定ユーティリティで確認してください。
固定IPアドレスの推奨
レシートプリンターには固定IPアドレスの使用を推奨します。プリンターの再起動時にアドレスが変更されるのを防ぐため、以下のいずれかの方法で設定してください:
- プリンター内蔵のWebインターフェース(通常は以下のアドレスでアクセス可能:
http://<printer-ip>) - ルーターのDHCP設定(プリンターのMACアドレスに予約IPを割り当て)
Epsonプリンター
ePOS対応のEpsonプリンターはHTTPで通信します。WCPOSはプリンター内蔵のWebサーバーにSOAP/XMLリクエストを送信します。
接続の詳細:
- ポート
8008(HTTP)または8043(HTTPS) — POSの配信プロトコル(HTTPまたはHTTPS)に合わせて自動入力されます - エンドポイント:
/cgi-bin/epos/service.cgi
動作確認済みモデル:
- Epson TM-T70-i 2(ネットワーク)
- Epson TM-m30iii(Printus ミドルウェア使用)
Epson プリンターの設定で ePOS が有効になっていることを確認してください。プリンターのウェブインターフェースに以下のアドレスでアクセスし、 http://<printer-ip> ePOS の設定を確認・有効化してください。
モバイルアプリでは、Epson プリンターは Epson のネイティブ SDK を通じて Bluetooth または USB でも接続できます。IP アドレスや ePOS ウェブサーバーは不要です。
Star プリンター
WebPRNT 対応の Star プリンターは HTTP 経由で通信します。WCPOS は Star WebPRNT エンドポイントにコマンドを送信します。
接続の詳細:
- ポート
80(HTTP)または443(HTTPS)— POS が HTTP と HTTPS のどちらで配信されているかに応じて自動入力されます - エンドポイント:
/StarWebPRNT/SendMessage
モバイルアプリでは、StarプリンターはStarのネイティブSDKを通じてBluetoothまたはUSBでも接続できます。
汎用プリンター
デスクトップアプリでは、raw TCPを使用してネットワーク接続のレシートプリンターに対応しています。プリンターのIPアドレスとポート(通常は9100)を入力してください。ESC/POSコマンドを受け付けるサーマルプリンターであれば、メーカーを問わず使用できます。
モバイルアプリでも汎用プリンターに対応していますが、ネットワーク接続のみで、BluetoothやUSB接続には対応していません(BluetoothやUSBにはEpsonまたはStarプリンターが必要です)。Webアプリでは汎用プリンターには対応していません。
キャッシュドロワー
レシートプリンターに接続されたキャッシュドロワーは、販売ごとに自動で開くことができます。
- プリンター設定でキャッシュドロワー自動オープンを有効にしてください
- POSは印刷後にESC/POSキックコマンドを送信します
キャッシュドロワーの制御にはサーマルプリンタープロファイルが必要です。ブラウザの印刷ダイアログではキャッシュドロワーを開くことはできません。
トラブルシューティング
セットアップ中にプリンターが検出されない
- プリンターの電源が入っており、お使いのデバイスと同じネットワークに接続されていることを確認してください
- ネットワークプリンターの場合:デスクトップアプリまたはモバイルアプリでネットワークスキャンを試して自動検出してください。検出されない場合は、IPアドレスが正しいか確認してください(セルフテストページを印刷して確認できます)
- Webアプリの場合:プリンターがePOS/WebPRNT対応のEpsonまたはStarモデルであることを確認してください
- デスクトップアプリの場合:汎用ベンダーオプションでポート9100を試してください
- Bluetoothの場合:まずデバイスのBluetooth設定でプリンターをペアリングしてから、プリンターをスキャンをタップしてください
- USB(Android)の場合:ケーブルを確認し、USB許可プロンプトが表示された場合は許可してください
- ファイアウォールが接続をブロックしていないか確認してください
プリンターは検出されるが印刷されない
- 用紙ロールを確認してください — 用紙切れまたは紙詰まりの可能性があります
- 印刷テキスト幅の設定がお使いの用紙サイズ(58mmまたは80mm)と一致しているか確認してください
- プリンター本体からセルフテストを印刷して、正常に動作するか確認してください
- コマンド言語がプリンターに合っているか確認してください(Epson の場合は ESC/POS、Star の場合は StarPRNT または Star Line Mode)
レシートが文字化けしている、または誤った文字が印刷される
- コマンド言語の設定が正しくない可能性があります。ESC/POS、StarPRNT、Star Line Mode を切り替えてみてください
- プリンターのテキスト幅の設定が正しいことを確認してください
- レシートが非ラテン文字や右から左に書く言語の場合は、詳細設定でフルレシートラスターを有効にしてください。レシートが画像として印刷されるため、どの言語でも正しく表示されます
キャッシュドロワーが開かない
- プリンターオプションでキャッシュドロワー自動オープンが有効になっていることを確認してください
- ドロワーがプリンターの DK ポートに接続されていることを確認してください(別の電源ではなく)
- すべてのプリンターがドロワーキックコマンドに対応しているわけではありません。プリンターのドキュメントを参照してください
Web アプリから接続できない
- ネットワーク経由の場合、Web アプリから接続できるのは Epson および Star プリンター(内蔵 Web サーバー経由)のみです。汎用のネットワークプリンターはブラウザではサポートされていません。デスクトップまたはモバイルアプリ、もしくはクラウドプリンターをご利用ください
- USB および Bluetooth プリンターは Web でも動作しますが、Chrome または Microsoft Edge でのみ対応しています(Safari と Firefox は WebUSB / Web Bluetooth API をサポートしていません)
- サイトがHTTPSを使用しているにもかかわらずプリンターがHTTPのみに対応している場合、ブラウザが混合コンテンツとして接続をブロックすることがあります。プリンターはPOSと同じHTTP/HTTPSを使用する必要があります
Bluetoothプリンターが接続できない(モバイル)
- WCPOSに追加する前に、デバイスのシステムBluetooth設定でプリンターをペアリングしてください
- Bluetooth印刷はEpsonおよびStarプリンターのみ対応しています。汎用Bluetoothプリンターには対応していません
- プリンターが一覧に表示されない場合は、プリンターをスキャンをもう一度タップし、プリンターの電源が入っていて通信範囲内にあることを確認してください