プリンター設定
プリンター設定は POS の 設定 > プリンター にあります。各デバイスは独自のプリンター設定を管理します。プリンターはローカルに保存され、デバイス間で同期されません。
このページでは、USB、Bluetooth、またはローカルネットワークでレジに接続されたプリンターについて説明します。別の部屋や場所にあるプリンター、またはすべてのデバイスで共有したいプリンターについては、クラウド印刷を参照してください。
プラットフォーム別の対応プリンター
プリンターを追加フォームは、使用しているアプリに応じて変わります。各プラットフォームには、実際に使用できる接続とオプションのみが表示されます。
| プラットフォーム | 対応プリンター | 接続 |
|---|---|---|
| Web アプリ | Web サーバー内蔵の Epson および Star プリンター | ネットワーク (HTTP) |
| デスクトップアプリ | 任意のネットワークレシートプリンター | ネットワーク (raw TCP) |
| iOSアプリ | EpsonおよびStar | ネットワーク、Bluetooth |
| Androidアプリ | EpsonおよびStar | ネットワーク、Bluetooth、USB |
Webブラウザーは未加工のTCP接続を開けません。EpsonおよびStarのレシートプリンターには、HTTP経由で印刷ジョブを受け付ける組み込みWebサーバーがあります。これが、ブラウザーからESC/POSコマンドを送信する唯一の方法です。デスクトップアプリには、TCP経由で直接接続できるため、この制限はありません。
モバイルアプリでは、BluetoothおよびUSB印刷はEpsonとStarの公式SDKを経由するため、これらの接続にもEpsonまたはStarのプリンターが必要です。汎用プリンターはネットワーク経由でのみ動作します。
プリンターの追加
プリンター設定を開く
POSで設定 > プリンターに移動します。まだプリンターが設定されていない場合は、プリンターを追加ボタンのある空の状態が表示されます。各プリンターにはプリンター名が付きます。これは単なるラベルで、"レシートプリンター"（続いて"レシートプリンター 2"など）として自動入力されます。プリンターを区別しやすい任意の名前に変更できます。
プリンターの接続方法を選択する
この手順はプラットフォームによって異なります。
- Webアプリ — ベンダーを選択します: Epson または Star。ブラウザーからアクセスできるのは、この2つのブランドの内蔵Webサーバーだけであるため、Webでは最初に選択します。
- デスクトップアプリ — プリンターはネットワーク経由で接続されるため、ここで追加で選択する項目はありません。
- モバイルアプリ — 接続タイプを選択します: ネットワーク, Bluetooth、または USB （USB は Android のみです）。以下のフィールドは選択内容に合わせて変わります。
プリンターを識別
ネットワークプリンター — IP アドレス（例: 192.168.1.100）を入力します。WCPOS はそのアドレスを調べ、Epson または Star デバイスかどうかを検出し、ポート、コマンド言語、ベンダーを自動入力します。検出が完了すると、「Detected: Epson」または「Detected: Star」ラベルが表示されます。Web アプリでは、接続先となる正確なエンドポイント URL も表示されます。
Bluetooth または USB プリンター（モバイル） — 検出されたデバイス一覧からプリンターを選択します。デバイスを選択すると、名前とベンダーが自動的に入力されます。プリンターがまだ一覧に表示されない場合は、プリンターをスキャン（Bluetooth）または 更新（USB）をタップします。
自動検出ですべてが正しく設定されない場合は、詳細設定ですべて調整できます。
保存してテスト
保存をクリックします。WCPOS はまずテスト印刷を送信し、成功した場合にのみプリンターを保存します。
テスト印刷は短い診断用の印刷です。番号付きの列ルーラー、中央揃えの通常サイズおよび倍サイズのテキスト、左右配置の行、用紙カットが含まれます。プリンターに到達できることだけでなく、用紙幅、配置、サイズ、カットがすべて正しく設定されていることを確認できるように設計されています。
テストに失敗した場合は、エラーと、プロファイルをそのまま保存するための テストせずに保存 オプションが表示されます。
接続タイプ（モバイルアプリ）
iOS および Android アプリでは、プリンターは 3 通りの方法で接続できます。プリンター追加フォーム上部で接続タイプを選択すると、接続フィールドがそれに合わせて更新されます。
ネットワーク
プリンターがデバイスと同じ Wi-Fi ネットワーク上にあります。IP アドレスを入力します — プリンターの IP アドレスを確認するを参照してください。ネットワークプリンターには Epson、Star、汎用を使用できます。
Bluetooth
プリンターが Bluetooth でデバイスとペアリングされています。プリンターをスキャンをタップし、一覧から使用するプリンターを選択します — 名前とベンダーは自動入力されます。Bluetooth 印刷では Epson と Star のネイティブ SDK を使用するため、プリンターは Epson または Star モデルである必要があります。
USB (Android のみ)
プリンターが USB ケーブルで接続されています。更新をタップし、接続済みデバイスの一覧から選択します。Bluetooth と同様に、USB 印刷には Epson または Star プリンターが必要です。iOS は一般的な USB 周辺機器に対応していないため、このオプションは Android でのみ表示されます。
ポート設定はネットワークプリンターにのみ適用されます — Bluetooth 接続と USB 接続では非表示になります。
詳細設定
詳細設定を展開して、プリンター設定を細かく調整します。これらのほとんどは、ベンダーが判明すると自動入力されます。
| 設定 | オプション | 説明 |
|---|---|---|
| ベンダー | Epson, Star, 汎用 | プリンターメーカー。ウェブアプリでは、ベンダーは詳細設定ではなく、フォーム上部の主要な選択項目です (Epson または Star のみ)。汎用はデスクトップアプリおよびモバイルアプリのネットワークプリンターで使用できますが、Bluetooth 接続または USB 接続では使用できません。 |
| ポート | 自動入力 | プリンターのネットワークポート。ネットワーク接続のみ — Bluetooth と USB では非表示です。 |
| 言語 | ESC/POS, StarPRNT, Star Line Mode | プリンターが使用するコマンドプロトコル。検出されたベンダーから自動入力されます。 |
| プリンターの文字幅 | 58mm (32 文字), 80mm 標準 (42 文字), 80mm 幅広 (48 文字) | 1 行に収まる文字数。用紙とプリンターに合わせてください — ほとんどの 80mm プリンターは 1 行 42 文字で、一部は 48 文字です。 |
| レシート全体のラスター印刷 | オフ / オン | レシート全体をテキストではなく画像として印刷します — 下記の レシート全体のラスター印刷 を参照してください。 |
プリンターオプション
これらの切り替えは、「プリンターを追加」フォームの下部にあります。
| オプション | 説明 |
|---|---|
| 用紙の自動カット | 各レシートの印刷後に用紙を自動でカットします |
| キャッシュドロワーの自動オープン | 印刷後、接続されたキャッシュドロワーを開くキックコマンドを送信します |
| デフォルトに設定 | このプリンターをデフォルトにします — 特定のプリンターにルーティングされていないすべてのレシートで使用されます |
販売完了時にレシートを自動印刷する機能はプリンター設定ではなく、カート設定です — POS カート設定で レシートを自動印刷 をオンにしてください。どのプリンターを使用するかは、デフォルトプリンターとテンプレートごとのプリンタールーティングによって決まります。
印刷ルーティング
複数のテンプレート（たとえば感熱レシートとA4請求書）を使用する場合、印刷ルーティングによって各テンプレートをどのプリンターで印刷するかが決まります。ルーティングには3つの階層があり、次の順序で確認されます。
- ジョブごとの上書き。 レシート画面では、テンプレート切り替えの横にプリンターのドロップダウンがあります。ここでプリンターを選択すると、その1回の印刷ジョブについてすべての設定が上書きされます。テンプレートを切り替えると 自動 にリセットされます。
- 設定による上書き。 設定 → 印刷ルーティング に移動して、各テンプレートに特定のプリンターを割り当てます。たとえば、感熱レシートはEpsonネットワークプリンターに、HTML請求書はシステムの印刷ダイアログにルーティングできます。上書きを解除するには、テンプレートを 自動 に戻します。
- 自動照合。 上書きが設定されていない場合、WCPOS は自動的に照合します。
- 感熱テンプレート は、文字幅が一致する感熱プリンターにルーティングされます。58mmの感熱テンプレートでは32列プリンターが優先され、80mmのテンプレートでは42列または48列プリンターが優先されます。
- HTMLテンプレート は、システムの印刷ダイアログにルーティングされます。
- 複数のプリンターが一致する場合は、デフォルト のプリンターが使用されます。
互換性のないプリンターにテンプレートを手動で送信した場合（たとえば、感熱テンプレートをシステムダイアログに送る場合）、レシート画面に琥珀色の 不一致警告 が表示されます。印刷は続行されますが、出力が正しくレンダリングされない場合があります。
ルーティングの上書きは デバイスごと に保存されます。各iPad、スマートフォン、またはコンピューターがそれぞれ独自のルーティングを管理します。サーバー側での同期はありません。
印刷ルーティング設定ページは、少なくとも1台のプリンターを追加した後にのみ表示されます。プリンターが設定されていない場合、すべてのテンプレートは暗黙的にシステムの印刷ダイアログを使用します。
レシート全体のラスタライズ
デフォルトでは、WCPOS はレシートをサーマルプリンターへ テキスト として送信します。これは高速でコンパクト、かつプリンター内蔵フォントにより鮮明に印刷できます。ただし、サーマルプリンターのフォントが対応できる文字は限られています。プリンターに対応フォントがない文字体系、多くの非ラテン文字、右から左に書くテキスト、一部の記号などは、空白の四角や文字化けとして出力されることがあります。
レシート全体のラスタライズ はこの問題を解決します。有効にすると、WCPOS はレシート全体を画像としてレンダリングし、その画像をプリンターへ送信するため、印刷結果は画面上の表示と完全に一致します。どの言語や文字体系でも同様です。
プリンターごとに 詳細設定 で有効にします。知っておくべき点:
- 速度が低下します。 画像は1行のテキストよりはるかに大きいため、レシートの送信と印刷に時間がかかります。
- 必要な場合にのみ使用してください。 レシートがテキストのまま正常に印刷される場合は、無効のままにしてください。
- これは、どの接続方式（ネットワーク、Bluetooth、USB）のサーマルプリンターにも適用されます。すでにページ全体のレンダリングから印刷するシステムの印刷ダイアログには適用されません。
プリンターの検出
モバイルアプリ では、プリンター追加フォームに、Bluetooth（iOS と Android）および USB（Android のみ）接続で近くのプリンターが一覧表示されます。プリンターをスキャン または 更新 をタップし、一覧から使用するプリンターを選択してください。名前とベンダーは自動的に入力されます。
どのプラットフォームでも、ネットワーク プリンターの場合は 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) - エンドポイント:
/cgi-bin/epos/service.cgi
動作確認済みモデル:
- Epson TM-T70-i 2（ネットワーク）
- Epson TM-m30iii（Printusミドルウェア使用）
Epsonプリンターの設定でePOSが有効になっていることを確認してください。プリンターのWebインターフェースには http://<printer-ip> からアクセスし、ePOS設定を確認して有効化します。
モバイルアプリでは、EpsonプリンターはEpsonのネイティブSDKを介してBluetoothまたはUSBでも接続できます。IPアドレスやePOS Webサーバーは不要です。
Starプリンター
WebPRNT 対応の Star プリンターは HTTP 経由で通信します。WCPOS は Star WebPRNT エンドポイントにコマンドを送信します。
接続の詳細:
- HTTPS または HTTP
- エンドポイント:
/StarWebPRNT/SendMessage
モバイルアプリでは、Star プリンターは Star のネイティブ SDK を通じて Bluetooth または USB でも接続できます。
汎用プリンター
デスクトップアプリは、raw TCP 経由で任意のネットワークレシートプリンターに対応します。プリンターの IP アドレスとポート（通常は 9100）を入力します。ESC/POS コマンドを受け付ける限り、メーカーを問わずほとんどのサーマルプリンターで動作します。
モバイルアプリでも汎用プリンターに対応しています。ただし、ネットワーク接続のみで、Bluetooth または USB 経由では対応していません（これらには Epson または Star プリンターが必要です）。Webアプリは汎用プリンターにまったく対応していません。
キャッシュドロワー
レシートプリンターに接続されたキャッシュドロワーは、各販売後に自動で開くことができます:
- プリンターオプションで キャッシュドロワーを自動で開く を有効にします
- POS は印刷後に ESC/POS キックコマンドを送信します
現金ドロワーの制御にはサーマルプリンタープロファイルが必要です — ブラウザーの印刷ダイアログから現金ドロワーを開くことはできません。
トラブルシューティング
セットアップ中にプリンターが検出されない
- プリンターの電源が入っており、端末と同じネットワークに接続されていることを確認します
- ネットワークプリンターの場合: IP アドレスが正しいことを確認します (セルフテストページを印刷してください)
- ウェブアプリの場合: プリンターが 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アプリは、内蔵Webサーバーを備えたEpsonおよびStarプリンターにのみ接続できます
- 汎用プリンターとUSBプリンターはWebではサポートされていません — 代わりにデスクトップアプリまたはモバイルアプリを使用してください
- サイトがHTTPSを使用していて、プリンターがHTTPにのみ対応している場合、ブラウザーが混在コンテンツとして接続をブロックすることがあります
Bluetoothプリンターが接続できない（モバイル）
- WCPOSに追加する前に、端末のシステムBluetooth設定でプリンターをペアリングしてください
- Bluetooth印刷はEpsonおよびStarプリンターのみをサポートしています — 汎用Bluetoothプリンターはサポートされていません
- プリンターが一覧に表示されない場合は、プリンターをスキャンをもう一度タップし、電源が入っていて通信範囲内にあることを確認してください