# プリンターの設定

プリンターの設定は POS の**設定 > プリンター**にあります。各デバイスが独自のプリンター構成を管理しており、プリンターはローカルに保存され、デバイス間で同期されません。

このデバイスに接続されていないプリンターに印刷したい場合

このページでは、USB、Bluetooth、またはローカルネットワーク経由でレジに接続されたプリンターについて説明します。別の部屋や別の場所にあるプリンター、またはすべてのデバイスで共有したいプリンターについては、[クラウド印刷](/ja/receipts/cloud-printing.md)をご覧ください。店舗用に設定したクラウドプリンターは、すべてのデバイスのプリンター一覧に**自動的に**表示されます。ここで追加する必要はありません。

## プラットフォーム別の対応プリンター[​](#supported-printers-by-platform "プラットフォーム別の対応プリンターへの直接リンク")

**プリンターの追加**フォームは使用しているアプリに合わせて変化し、各プラットフォームで実際に使用可能な接続方法とオプションのみが表示されます。

| プラットフォーム       | 対応プリンター                                                                                                                                               | 接続方法                               |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------- |
| **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版でネットワーク接続がEpsonとStarのみである理由

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のプリンターが必要です。汎用プリンターはネットワーク経由でのみ使用できます。

## プリンターの追加[​](#adding-a-printer "プリンターの追加への直接リンク")

1

#### プリンター設定を開く

POSの**設定 > プリンター**を開きます。プリンターが未設定の場合は、**プリンターを追加**ボタンのある空の画面が表示されます。各プリンターには**プリンター名**があり、これは識別用のラベルで「レシートプリンター」（次は「レシートプリンター 2」と順に続きます）が自動入力されます。プリンターを区別しやすい任意の名前に変更できます。

2

#### プリンターの接続方法を選択する

すべてのプラットフォームで最初に**接続タイプ**を選択します。表示される選択肢はプラットフォームがサポートするもののみです。選択に応じて、以下のフィールドが更新されます。

* **Webアプリ** — **ネットワーク**、**USB**、または**Bluetooth**（USBとBluetoothはChromeまたはEdgeが必要です）。**ネットワーク**プリンターの場合は、**ベンダー**（EpsonまたはStar）を選択します。ブラウザはそのメーカーの内蔵Webサーバーを経由してネットワークプリンターに接続するためです。
* **デスクトップアプリ** — **ネットワーク**、**USB**、または**Bluetooth**。
* **モバイルアプリ** — **ネットワーク**または**Bluetooth**、およびAndroidでは**USB**（iOSはUSBに対応していません）。

3

#### プリンターの識別

**ネットワークプリンター** — **IPアドレス**を入力します（例：`192.168.1.100`）。WCPOSがそのアドレスを検出し、EpsonまたはStarデバイスかを判別して、ポート、コマンド言語、ベンダーを自動入力します。検出が完了すると「Detected: Epson」または「Detected: Star」のラベルが表示されます。Webアプリでは、接続先のエンドポイントURLも表示されます。

**BluetoothまたはUSBプリンター**（モバイル） — 検出されたデバイス一覧からプリンターを選択します。デバイスを選択すると、名前とベンダーが自動的に入力されます。プリンターが一覧に表示されない場合は、**プリンターをスキャン**（Bluetooth）または**更新**（USB）をタップしてください。

自動検出で正しく設定されない場合は、**詳細設定**ですべて調整できます。

4

#### 保存とテスト

**保存**をクリックします。WCPOSはまず**テスト印刷**を実行し、成功した場合にのみプリンターを保存します。

テスト印刷は簡易的な診断で、番号付きの列ルーラー、中央揃えの標準サイズと倍角テキスト、左右揃えの行、および用紙カットで構成されています。プリンターに接続できるかだけでなく、用紙幅、配置、サイズ、カットがすべて正しく設定されているかを確認できるように設計されています。

テストが失敗しても保存できます

テストが失敗した場合、エラーとともに**テストせずに保存**オプションが表示され、そのままプロファイルを保存できます。

## 接続タイプ[​](#connection-types-mobile-apps "接続タイプへの直接リンク")

プリンター追加フォームの上部で**接続タイプ**を選択すると、接続フィールドがそのタイプに合わせて更新されます。利用可能なタイプはプラットフォームによって異なります（上記の表を参照）。

### ネットワーク[​](#network "ネットワークへの直接リンク")

プリンターがデバイスと同じ Wi-Fi ネットワーク上にある場合に使用します。**デスクトップ**および**モバイル**アプリでは、**ネットワークスキャン**をタップしてプリンターを自動検出するか、IP アドレスを手動で入力します — [プリンターの IP アドレスの確認方法](#finding-your-printers-ip-address)を参照してください。**Web アプリ**では手動 IP 入力のみ対応しています。デスクトップおよびモバイルアプリでは、ネットワークプリンターとして Epson、Star、汎用プリンターを使用できます。Web では **Epson または Star** のみ対応しており、ネットワーク接続の設定でどちらかを選択します。

### Bluetooth[​](#bluetooth "Bluetoothへの直接リンク")

プリンターが Bluetooth でデバイスとペアリングされている場合に使用します。リストからプリンターを選択すると、名前とメーカーが自動的に入力されます。**モバイル**では、Bluetooth 印刷に Epson および Star のネイティブ SDK を使用するため、**Epson または Star** のプリンターが必要です。**Web** では、Chrome または Edge で Web Bluetooth API を介して Bluetooth を使用できます。

### USB[​](#usb-android-only "USBへの直接リンク")

プリンターが USB ケーブルで接続されている場合に使用します。接続済みデバイスのリストから選択してください。USB は **Web**（Chrome または Edge、WebUSB 経由）、**デスクトップ**アプリ、**Android** で利用できますが、**iOS** では汎用 USB 周辺機器がサポートされていないため利用できません。モバイルでの USB 印刷には、**Epson または Star** のプリンターが必要です。

ノート

**ポート**設定はネットワークプリンターにのみ適用されます — Bluetooth および USB 接続では表示されません。

## 詳細設定[​](#advanced-settings "詳細設定への直接リンク")

**詳細設定**を展開して、プリンターの設定を細かく調整できます。ほとんどの項目は、メーカーが判明すると自動的に入力されます。

以下の設定はすべてのプラットフォームで適用されます：

| 設定                           | オプション                                                 | 説明                                                                                                                                   |
| ------------------------------ | ---------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| **言語**                       | ESC/POS, StarPRNT, Star Line Mode                          | プリンターが使用するコマンドプロトコルです。検出されたメーカーに基づいて自動入力されます。                                             |
| **プリンター文字幅**           | 58mm（32文字）、80mm 標準（42文字）、80mm ワイド（48文字） | 1行に収まる文字数です。用紙とプリンターに合わせて設定してください。80mmプリンターのほとんどは1行42文字ですが、48文字のものもあります。 |
| **レシート全体のラスター印刷** | オフ / オン                                                | テキストではなく画像としてレシート全体を印刷します。詳細は下記の[レシート全体のラスター印刷](#full-receipt-raster)を参照してください。 |

以下の2つの設定は、プラットフォームと接続タイプによって動作が異なります：

| 設定         | オプション             | 適用対象                                                                                                                                                                                                                                                                                                       |
| ------------ | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **メーカー** | エプソン、スター、汎用 | プリンターの製造元です。**Webアプリ**では、**ネットワーク**接続の下でメーカーを直接選択します（エプソンまたはスターのみ）。詳細設定としては表示されません。汎用はデスクトップおよびモバイルアプリの**ネットワーク**プリンターで使用できますが、BluetoothやUSB接続では使用できません。                          |
| **ポート**   | 自動入力               | プリンターのネットワークポートで、IPアドレスの横に表示されます。**ネットワーク接続のみ** — BluetoothおよびUSBでは非表示です。メーカーに基づいて自動入力されます（Webの場合は、POSがHTTPまたはHTTPSのどちらで配信されているかも考慮されます）。ネットワーク側でポートが変更されている場合のみ変更してください。 |

## プリンターオプション[​](#printer-options "プリンターオプションへの直接リンク")

これらのトグルはプリンター追加フォームの下部にあります：

| オプション                         | 説明                                                                                                                |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **用紙自動カット**                 | レシート印刷後に自動的に用紙をカットします                                                                          |
| **キャッシュドロワー自動オープン** | 印刷後に接続されたキャッシュドロワーを開くキックコマンドを送信します                                                |
| **デフォルトに設定**               | このプリンターをデフォルトプリンターに設定します — 特定のプリンターにルーティングされていないレシートに使用されます |

「会計後に自動印刷」をお探しですか？

販売完了時にレシートを自動印刷する機能は、プリンター設定ではなく**カート設定**です。POSのカート設定で**レシート自動印刷**を有効にしてください。使用されるプリンターは、デフォルトプリンターおよびテンプレートごとのプリンタールーティング設定によって決まります。

## 印刷ルーティング[​](#print-routing "印刷ルーティングへの直接リンク")

複数のテンプレートを使用する場合（例：感熱レシート**と** A4 請求書）、印刷ルーティングによって各テンプレートがどのプリンターで印刷されるかが決まります。ルーティングは以下の順序で3つのレイヤーがチェックされます：

1. **ジョブごとの上書き。** レシート画面では、テンプレート切り替えの横にプリンターのドロップダウンがあります。ここでプリンターを選択すると、その印刷ジョブに限りすべての設定が上書きされます。テンプレートを切り替えると**自動**に戻ります。

2. **設定による上書き。** **設定 → 印刷ルーティング**で、各テンプレートに特定のプリンターを割り当てることができます。例えば、感熱レシートを Epson ネットワークプリンターに、HTML 請求書をシステム印刷ダイアログにルーティングできます。テンプレートを**自動**に戻すと上書きが解除されます。

3. **自動マッチ。** オーバーライドが設定されていない場合、WCPOS は自動的にマッチングを行います：

   <!-- -->

   * **サーマルテンプレート**は、文字幅が一致するサーマルプリンターにルーティングされます。58mm サーマルテンプレートは 32 桁プリンターを優先し、80mm テンプレートは 42 桁または 48 桁プリンターを優先します。
   * **HTML テンプレート**はシステムの印刷ダイアログにルーティングされます。
   * 複数のプリンターが一致する場合は、**デフォルト**プリンターが優先されます。

テンプレートを互換性のないプリンターに手動で送信した場合（例：サーマルテンプレートをシステムの印刷ダイアログに送信）、レシート画面にアンバー色の**不一致警告**が表示されます。印刷は続行されますが、出力が正しくレンダリングされない場合があります。

ルーティングのオーバーライドは**デバイスごと**に保存されます。各 iPad、スマートフォン、またはコンピューターがそれぞれ独自のルーティングを管理し、サーバー側での同期はありません。

ノート

印刷ルーティングの設定ページは、プリンターを少なくとも 1 台追加した後にのみ表示されます。プリンターが設定されていない場合、すべてのテンプレートは暗黙的にシステムの印刷ダイアログを使用します。店舗に設定された**クラウドプリンター**もここにカウントされ、デバイスに追加しなくても自動的にルーティング先として表示されます。

## レシート全体のラスター化[​](#full-receipt-raster "レシート全体のラスター化への直接リンク")

デフォルトでは、WCPOS はレシートを**テキスト**としてサーマルプリンターに送信します。これはプリンター内蔵フォントを使用するため、高速でコンパクト、かつ鮮明です。ただし注意点があります。サーマルプリンターのフォントは限られた文字セットしかカバーしていません。プリンターにフォントがない文字体系（多くの非ラテン文字、右から左に書く文字、一部の記号など）は、空白の四角や文字化けとして出力されることがあります。

**レシート全体のラスター化**はこの問題を解決します。この機能を有効にすると、WCPOS はレシート全体を画像としてレンダリングし、その画像をプリンターに送信します。これにより、どの言語や文字体系でも、画面に表示されるとおりの内容が印刷されます。

プリンターごとに**詳細設定**で有効にしてください。注意点：

* \*\*速度が低下します。\*\*画像はテキスト1行よりもデータ量が大きいため、レシートの送信と印刷に時間がかかります。
* \*\*必要な場合のみ使用してください。\*\*テキストでレシートが正常に印刷される場合は、オフのままにしてください。
* この設定は、ネットワーク、Bluetooth、USB など、すべての接続方式のサーマルプリンターに適用されます。フルページレンダリングから印刷するシステム印刷ダイアログには適用されません。

## プリンターの検出[​](#discovering-printers "プリンターの検出への直接リンク")

プリンターの検出方法は接続方式によって異なります：

* **Bluetooth と USB** — **モバイルアプリ**では、**プリンターをスキャン**（Bluetooth）または**更新**（USB）をタップし、一覧からプリンターを選択します。名前とベンダーが自動的に入力されます。**Web**（Chrome または Edge）では、**接続**をクリックし、ブラウザのデバイス選択画面からプリンターを選択します。
* **ネットワーク** — **デスクトップ**および**モバイル**アプリでは、**ネットワークスキャン**をタップすると、ローカルネットワーク上のプリンターが自動的に検出されます（デスクトップは mDNS/Bonjour で検出、モバイルは Epson および Star SDK を使用）。一覧からプリンターを選択してください。IP アドレスを直接入力することもできます。詳細は下記の[プリンターの IP アドレスの確認](#finding-your-printers-ip-address)を参照してください。ブラウザはネットワークスキャンができないため、**Web アプリ**では常に手動で IP アドレスを入力します。

## プリンターの IP アドレスの確認[​](#finding-your-printers-ip-address "プリンターの IP アドレスの確認への直接リンク")

ほとんどのレシートプリンターは、IP アドレスが記載されたセルフテストページを印刷できます：

* **Epson**：電源を入れながらフィードボタンを押し続ける
* **Star**：電源が入った状態でフィードボタンを5秒間押し続ける

または、ルーターの接続デバイス一覧やプリンターの設定ユーティリティで確認してください。

### 固定IPアドレスの推奨[​](#static-ip-recommended "固定IPアドレスの推奨への直接リンク")

レシートプリンターには**固定IPアドレス**の使用を推奨します。プリンターの再起動時にアドレスが変更されるのを防ぐため、以下のいずれかの方法で設定してください：

* プリンター内蔵のWebインターフェース（通常は以下のアドレスでアクセス可能： `http://<printer-ip>`）
* ルーターのDHCP設定（プリンターのMACアドレスに予約IPを割り当て）

## Epsonプリンター[​](#epson-printers "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 プリンター[​](#star-printers "Star プリンターへの直接リンク")

WebPRNT 対応の Star プリンターは HTTP 経由で通信します。WCPOS は Star WebPRNT エンドポイントにコマンドを送信します。

**接続の詳細：**

* ポート `80`（HTTP）または `443`（HTTPS）— POS が HTTP と HTTPS のどちらで配信されているかに応じて自動入力されます
* エンドポイント：`/StarWebPRNT/SendMessage`

**モバイルアプリ**では、StarプリンターはStarのネイティブSDKを通じてBluetoothまたはUSBでも接続できます。

## 汎用プリンター[​](#generic-printers "汎用プリンターへの直接リンク")

**デスクトップアプリ**では、raw TCPを使用してネットワーク接続のレシートプリンターに対応しています。プリンターのIPアドレスとポート（通常は`9100`）を入力してください。ESC/POSコマンドを受け付けるサーマルプリンターであれば、メーカーを問わず使用できます。

**モバイルアプリ**でも汎用プリンターに対応していますが、**ネットワーク**接続のみで、BluetoothやUSB接続には対応していません（BluetoothやUSBにはEpsonまたはStarプリンターが必要です）。**Webアプリ**では汎用プリンターには対応していません。

## キャッシュドロワー[​](#cash-drawers "キャッシュドロワーへの直接リンク")

レシートプリンターに接続されたキャッシュドロワーは、販売ごとに自動で開くことができます。

1. プリンター設定で**キャッシュドロワー自動オープン**を有効にしてください
2. POSは印刷後にESC/POSキックコマンドを送信します

ノート

キャッシュドロワーの制御にはサーマルプリンタープロファイルが必要です。ブラウザの印刷ダイアログではキャッシュドロワーを開くことはできません。

## トラブルシューティング[​](#troubleshooting "トラブルシューティングへの直接リンク")

セットアップ中にプリンターが検出されない

* プリンターの電源が入っており、お使いのデバイスと同じネットワークに接続されていることを確認してください
* ネットワークプリンターの場合：デスクトップアプリまたはモバイルアプリで**ネットワークスキャン**を試して自動検出してください。検出されない場合は、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 サーバー経由）のみです。汎用のネットワークプリンターはブラウザではサポートされていません。デスクトップまたはモバイルアプリ、もしくは[クラウドプリンター](/ja/receipts/cloud-printing.md)をご利用ください
* **USB および Bluetooth** プリンターは Web でも動作しますが、**Chrome または Microsoft Edge** でのみ対応しています（Safari と Firefox は WebUSB / Web Bluetooth API をサポートしていません）
* サイトがHTTPSを使用しているにもかかわらずプリンターがHTTPのみに対応している場合、ブラウザが混合コンテンツとして接続をブロックすることがあります。プリンターはPOSと同じHTTP/HTTPSを使用する必要があります

Bluetoothプリンターが接続できない（モバイル）

* WCPOSに追加する前に、デバイスのシステムBluetooth設定でプリンターをペアリングしてください
* Bluetooth印刷はEpsonおよびStarプリンターのみ対応しています。汎用Bluetoothプリンターには対応していません
* プリンターが一覧に表示されない場合は、**プリンターをスキャン**をもう一度タップし、プリンターの電源が入っていて通信範囲内にあることを確認してください
