# Printer instellen

Printerinstellingen staan in de POS onder **Instellingen > Printer**. Elk apparaat beheert zijn eigen printerconfiguratie — printers worden lokaal opgeslagen en niet tussen apparaten gesynchroniseerd.

Afdrukken naar een printer die niet aan dit apparaat is gekoppeld?

Deze pagina behandelt printers die via USB, Bluetooth of het lokale netwerk aan de kassa zijn gekoppeld. Voor een printer in een andere ruimte of locatie — of een printer die door elk apparaat gedeeld moet worden — zie [Cloudprinten](/nl/receipts/cloud-printing.md).

## Ondersteunde printers per platform[​](#supported-printers-by-platform "Directe link naar Ondersteunde printers per platform")

Het formulier **Printer toevoegen** past zich aan de app aan die wordt gebruikt — elk platform toont alleen de verbindingen en opties die het daadwerkelijk kan gebruiken.

| Omgeving        | Ondersteunde printers                                | Verbindingen            |
| --------------- | ---------------------------------------------------- | ----------------------- |
| **Web-app**     | Epson- en Star-printers met een ingebouwde webserver | Netwerk (HTTP)          |
| **Desktop-app** | Elke netwerkbonprinter                               | Netwerk (raw TCP)       |
| **iOS-app**     | Epson en Star                                        | Netwerk, Bluetooth      |
| **Android-app** | Epson en Star                                        | Netwerk, Bluetooth, USB |

Waarom alleen Epson en Star op het web?

Webbrowsers kunnen geen raw TCP-verbindingen openen. Epson- en Star-bonprinters bevatten een ingebouwde webserver die printopdrachten via HTTP accepteert — dit is de enige manier om ESC/POS-opdrachten vanuit een browser te verzenden. De desktop-app heeft deze beperking niet, omdat deze rechtstreeks via TCP verbinding kan maken.

In de **mobiele apps** verloopt afdrukken via Bluetooth en USB via de officiële SDK's van Epson en Star, dus voor die verbindingen is ook een Epson- of Star-printer vereist. Generieke printers werken alleen via het netwerk.

## Een printer toevoegen[​](#adding-a-printer "Directe link naar Een printer toevoegen")

1

#### Printerinstellingen openen

Ga naar **Instellingen > Printer** in de POS. Als er nog geen printers zijn geconfigureerd, wordt een lege status weergegeven met een knop **Printer toevoegen**. Elke printer krijgt een **Printernaam** — gewoon een label, automatisch ingevuld als "Bonprinter" (daarna "Bonprinter 2", enzovoort) — dat kan worden gewijzigd in iets waarmee de printers makkelijk uit elkaar te houden zijn.

2

#### Kies hoe de printer verbinding maakt

Deze stap verschilt per platform:

* **Web-app** — kies de **Leverancier**: Epson of Star. Dit is de eerste keuze op het web, omdat browsers alleen de ingebouwde webservers van deze twee merken kunnen bereiken.
* **Desktop-app** — printers maken verbinding via het netwerk; hier hoeft u niets extra's te kiezen.
* **Mobiele apps** — kies een **Verbindingstype**: **Netwerk**, **Bluetooth**, of **USB** (USB is alleen voor Android). De onderstaande velden worden aangepast aan je keuze.

3

#### De printer identificeren

**Netwerkprinters** — voer het **IP-adres** in (bijvoorbeeld `192.168.1.100`). WCPOS controleert het adres om te detecteren of het een Epson- of Star-apparaat is, en vult automatisch de poort, opdrachttaal en leverancier in. Zodra de detectie is voltooid, zie je een label "Gedetecteerd: Epson" of "Gedetecteerd: Star". In de web-app wordt ook de exacte endpoint-URL getoond waarmee verbinding wordt gemaakt.

**Bluetooth- of USB-printers** (mobiel) — kies je printer uit de lijst met gevonden apparaten. Wanneer je een apparaat selecteert, worden de naam en leverancier automatisch ingevuld. Tik op **Naar printers zoeken** (Bluetooth) of **Vernieuwen** (USB) als je printer nog niet in de lijst staat.

Als de automatische detectie niet alles correct instelt, kun je alles aanpassen onder **Geavanceerde instellingen**.

4

#### Opslaan en testen

Klik op **Opslaan**. WCPOS verstuurt eerst een **testafdruk** en slaat de printer alleen op als deze slaagt.

De testafdruk is een korte diagnose: een genummerde kolomliniaal, gecentreerde normale tekst en tekst op dubbele grootte, een rij voor links/rechts-uitlijning en een papiersnede. Deze is ontworpen zodat je kunt bevestigen dat de papierbreedte, uitlijning, grootte en snede allemaal correct zijn geconfigureerd, niet alleen dat de printer bereikbaar is.

Als de test mislukt, zie je de fout samen met de optie **Opslaan zonder te testen** om het profiel toch op te slaan.

## Verbindingstypen (mobiele apps)[​](#connection-types-mobile-apps "Directe link naar Verbindingstypen (mobiele apps)")

In de iOS- en Android-apps kan een printer op drie manieren verbinding maken. Kies het **Verbindingstype** bovenaan het formulier Printer toevoegen; de verbindingsvelden worden daarop aangepast.

### Netwerk[​](#network "Directe link naar Netwerk")

De printer bevindt zich op hetzelfde Wi-Fi-netwerk als uw apparaat. Voer het IP-adres in — zie [Het IP-adres van uw printer vinden](#finding-your-printers-ip-address). Netwerkprinters kunnen Epson, Star of Generiek zijn.

### Bluetooth[​](#bluetooth "Directe link naar Bluetooth")

De printer is via Bluetooth gekoppeld aan uw apparaat. Tik op **Naar printers zoeken** en kies uw printer uit de lijst — de naam en leverancier worden automatisch ingevuld. Afdrukken via Bluetooth gebruikt de native SDK's van Epson en Star, dus de printer moet een **Epson- of Star**-model zijn.

### USB (alleen Android)[​](#usb-android-only "Directe link naar USB (alleen Android)")

De printer is aangesloten met een USB-kabel. Tik op **Vernieuwen** en kies de printer uit de lijst met verbonden apparaten. Net als Bluetooth vereist afdrukken via USB een **Epson- of Star**-printer. iOS biedt geen algemene ondersteuning voor USB-randapparatuur, dus deze optie verschijnt alleen op Android.

opmerking

De instelling **Poort** is alleen van toepassing op netwerkprinters — deze is verborgen voor Bluetooth- en USB-verbindingen.

## Geavanceerde instellingen[​](#advanced-settings "Directe link naar Geavanceerde instellingen")

Vouw **Geavanceerde instellingen** uit om de printerconfiguratie nauwkeurig af te stellen. De meeste hiervan worden automatisch ingevuld zodra de leverancier bekend is.

| Instelling                             | Opties                                                               | Beschrijving                                                                                                                                                                                                                                                                                  |
| -------------------------------------- | -------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Leverancier**                        | Epson, Star, Generiek                                                | Printerfabrikant. In de **web-app** is Leverancier de primaire keuze bovenaan het formulier (alleen Epson of Star) in plaats van een geavanceerde instelling. Generiek is beschikbaar voor **netwerk**printers in de desktop- en mobiele apps, maar niet voor Bluetooth- of USB-verbindingen. |
| **Poort**                              | Automatisch ingevuld                                                 | Netwerkpoort voor de printer. Alleen netwerk — verborgen voor Bluetooth en USB.                                                                                                                                                                                                               |
| **Taal**                               | ESC/POS, StarPRNT, Star Line Mode                                    | Het opdrachtprotocol dat de printer gebruikt. Automatisch ingevuld op basis van de gedetecteerde leverancier.                                                                                                                                                                                 |
| **Tekstbreedte printer**               | 58mm (32 tekens), 80mm standaard (42 tekens), 80mm breed (48 tekens) | Het aantal tekens dat op een regel past. Stem dit af op het papier en de printer — de meeste 80mm-printers gebruiken 42 tekens per regel, sommige 48.                                                                                                                                         |
| **Volledige bon als rasterafbeelding** | Uit / Aan                                                            | Druk de volledige bon af als afbeelding in plaats van als tekst — zie [Volledige bon als rasterafbeelding](#full-receipt-raster) hieronder.                                                                                                                                                   |

## Printeropties[​](#printer-options "Directe link naar Printeropties")

Deze schakelaars staan onderaan het formulier Printer toevoegen:

| Optie                            | Beschrijving                                                                                              |
| -------------------------------- | --------------------------------------------------------------------------------------------------------- |
| **Papier automatisch afsnijden** | Snijd het papier automatisch af na elke bon                                                               |
| **Kassalade automatisch openen** | Stuur een kick-opdracht om een verbonden kassalade na het afdrukken te openen                             |
| **Instellen als standaard**      | Maak dit de standaardprinter — gebruikt voor elke bon die niet naar een specifieke printer wordt gestuurd |

Op zoek naar "automatisch afdrukken na afrekenen"?

Automatisch een bon afdrukken wanneer een verkoop is afgerond is een **winkelwageninstelling**, geen printerinstelling — schakel **Bon automatisch afdrukken** in de POS-winkelwageninstellingen in. *Welke* printer wordt gebruikt, wordt bepaald door de standaardprinter en eventuele printerroutering per sjabloon.

## Afdrukroutering[​](#print-routing "Directe link naar Afdrukroutering")

Als je meer dan één sjabloon gebruikt — bijvoorbeeld een thermische kassabon **en** een A4-factuur — bepaalt afdrukroutering op welke printer elk sjabloon wordt afgedrukt. Routering heeft drie lagen, die in deze volgorde worden gecontroleerd:

1. **Overschrijving per taak.** Op het kassabonscherm staat naast de sjabloonkiezer een keuzelijst voor printers. Als je hier een printer kiest, overschrijft dat alles voor die ene afdruktaak. Wanneer je van sjabloon wisselt, wordt dit teruggezet naar **Automatisch**.

2. **Overschrijving via instellingen.** Ga naar **Instellingen → Afdrukroutering** om aan elk sjabloon een specifieke printer toe te wijzen. Routeer bijvoorbeeld de thermische kassabon naar de Epson-netwerkprinter en de HTML-factuur naar het systeemafdrukvenster. Zet een sjabloon terug op **Automatisch** om de overschrijving te verwijderen.

3. **Automatisch koppelen.** Wanneer er geen overschrijving is ingesteld, koppelt WCPOS automatisch:

   <!-- -->

   * **Thermische sjablonen** worden gerouteerd naar thermische printers met een passende tekenbreedte. Een thermisch sjabloon van 58mm geeft de voorkeur aan printers met 32 kolommen; een sjabloon van 80mm geeft de voorkeur aan printers met 42 of 48 kolommen.
   * **HTML-sjablonen** worden gerouteerd naar het systeemafdrukvenster.
   * Als meerdere printers overeenkomen, wordt de **standaardprinter** gebruikt.

Als je handmatig een sjabloon naar een incompatibele printer stuurt — bijvoorbeeld een thermisch sjabloon naar het systeemafdrukvenster — verschijnt er een oranje **waarschuwing voor mismatch** op het kassabonscherm. De afdruk gaat nog steeds door, maar de uitvoer wordt mogelijk niet correct weergegeven.

Routeringsoverschrijvingen worden **per apparaat** opgeslagen. Elke iPad, telefoon of computer beheert zijn eigen routering — er is geen serversynchronisatie.

opmerking

De instellingenpagina voor afdrukroutering verschijnt pas nadat er ten minste één printer is toegevoegd. Zonder geconfigureerde printers gebruikt elke template impliciet het systeemdialoogvenster voor afdrukken.

## Volledige bonrastering[​](#full-receipt-raster "Directe link naar Volledige bonrastering")

Standaard verzendt WCPOS bonnen naar thermische printers als **tekst**: snel, compact en scherp, met de ingebouwde lettertypen van de printer. De beperking: lettertypen van thermische printers ondersteunen slechts een beperkte set tekens. Schriften waarvoor de printer geen lettertype heeft, zoals veel niet-Latijnse alfabetten, tekst van rechts naar links en sommige symbolen, kunnen worden afgedrukt als lege vakjes of onleesbare tekens.

**Volledige bonrastering** lost dit op. Wanneer dit is ingeschakeld, rendert WCPOS de volledige bon als afbeelding en stuurt die afbeelding naar de printer, zodat de afdruk exact overeenkomt met wat op het scherm staat, in elke taal of elk schrift.

Schakel dit per printer in onder **Geavanceerde instellingen**. Belangrijk om te weten:

* **Het is langzamer.** Een afbeelding is veel groter dan een tekstregel, waardoor het verzenden en afdrukken van de bon langer duurt.
* **Gebruik dit alleen wanneer het nodig is.** Als je bonnen als tekst goed worden afgedrukt, laat deze optie dan uitgeschakeld.
* Dit geldt voor thermische printers met elke verbinding (netwerk, Bluetooth, USB). Het geldt niet voor het systeemdialoogvenster voor afdrukken, dat al afdrukt vanuit een volledige-paginaweergave.

## Printers detecteren[​](#discovering-printers "Directe link naar Printers detecteren")

In de **mobiele apps** toont het formulier Printer toevoegen printers in de buurt voor **Bluetooth**-verbindingen (iOS en Android) en **USB**-verbindingen (alleen Android): tik op **Scannen naar printers** of **Vernieuwen** en kies je printer uit de lijst. De naam en leverancier worden automatisch ingevuld.

Voer voor **netwerkprinters** op elk platform het IP-adres rechtstreeks in; zie [Het IP-adres van je printer vinden](#finding-your-printers-ip-address) hieronder. De web-app heeft geen netwerkdetectie (browsers kunnen geen netwerken scannen), dus die gebruikt altijd handmatige invoer van het IP-adres.

## Het IP-adres van uw printer vinden[​](#finding-your-printers-ip-address "Directe link naar Het IP-adres van uw printer vinden")

De meeste bonprinters kunnen een zelftestpagina afdrukken met daarop het IP-adres:

* **Epson**: Houd de doorvoerknop ingedrukt terwijl u de printer inschakelt
* **Star**: Houd de doorvoerknop 5 seconden ingedrukt terwijl de printer is ingeschakeld

U kunt ook de lijst met verbonden apparaten in uw router of het configuratieprogramma van uw printer controleren.

### Statisch IP-adres aanbevolen[​](#static-ip-recommended "Directe link naar Statisch IP-adres aanbevolen")

Bonprinters moeten een **statisch IP-adres** gebruiken om te voorkomen dat het adres verandert wanneer de printer opnieuw wordt opgestart. Configureer dit op een van deze manieren:

* In de ingebouwde webinterface van uw printer (meestal toegankelijk via `http://<printer-ip>`)
* In de DHCP-instellingen van uw router (wijs een gereserveerd IP-adres toe aan het MAC-adres van de printer)

## Epson-printers[​](#epson-printers "Directe link naar Epson-printers")

Epson-printers met ePOS-ondersteuning communiceren via HTTP. WCPOS stuurt SOAP/XML-verzoeken naar de ingebouwde webserver van de printer.

**Verbindingsgegevens:**

* Poort `8008` (HTTP) of `8043` (HTTPS)
* Eindpunt: `/cgi-bin/epos/service.cgi`

**Bevestigd werkende modellen:**

* Epson TM-T70-i 2 (netwerk)
* Epson TM-m30iii (met Printus-middleware)

tip

Controleer of ePOS in de configuratie van de Epson-printer is ingeschakeld. Open de webinterface van de printer op `http://<printer-ip>` om de ePOS-instellingen te controleren en in te schakelen.

In de **mobiele apps** kunnen Epson-printers ook via Bluetooth of USB verbinding maken via de native SDK van Epson — geen IP-adres of ePOS-webserver vereist.

## Star-printers[​](#star-printers "Directe link naar Star-printers")

Star-printers met WebPRNT-ondersteuning communiceren via HTTP. WCPOS stuurt opdrachten naar het Star WebPRNT-eindpunt.

**Verbindingsgegevens:**

* HTTPS of HTTP
* Eindpunt: `/StarWebPRNT/SendMessage`

In de **mobiele apps** kunnen Star-printers ook verbinding maken via Bluetooth of USB met de native SDK van Star.

## Generieke printers[​](#generic-printers "Directe link naar Generieke printers")

De **desktop-app** ondersteunt elke netwerkbonprinter via raw TCP. Voer het IP-adres en de poort van de printer in (meestal `9100`). Dit werkt met de meeste thermische printers, ongeacht de fabrikant, zolang ze ESC/POS-opdrachten accepteren.

In de **mobiele apps** worden generieke printers ook ondersteund, maar alleen voor **netwerkverbindingen**, niet via Bluetooth of USB (daarvoor is een Epson- of Star-printer vereist). De **web-app** ondersteunt helemaal geen generieke printers.

## Kassalades[​](#cash-drawers "Directe link naar Kassalades")

Kassalades die zijn aangesloten op een bonprinter kunnen na elke verkoop automatisch worden geopend:

1. Schakel **Kassalade automatisch openen** in bij de printeropties
2. De POS stuurt na het afdrukken een ESC/POS-kickopdracht

opmerking

Voor bediening van de kassalade is een thermisch printerprofiel vereist — het afdrukvenster van de browser kan kassalades niet activeren.

## Problemen oplossen[​](#troubleshooting "Directe link naar Problemen oplossen")

Printer niet gedetecteerd tijdens de installatie

* Controleer of de printer is ingeschakeld en verbonden is met hetzelfde netwerk als het apparaat
* Voor netwerkprinters: controleer of het IP-adres correct is (druk een zelftestpagina af)
* Voor de web-app: controleer of de printer een Epson- of Star-model is met ondersteuning voor ePOS/WebPRNT
* Voor de desktop-app: probeer de optie Generieke leverancier met poort 9100
* Voor Bluetooth: koppel de printer eerst in de Bluetooth-instellingen van het apparaat en tik daarna op **Scannen naar printers**
* Voor USB (Android): controleer de kabel en keur de USB-machtigingsprompt goed als deze verschijnt
* Controleer of geen firewall de verbinding blokkeert

Printer gedetecteerd, maar er wordt niets afgedrukt

* Controleer de papierrol — deze kan leeg zijn of vastzitten
* Controleer of de instelling **Tekstbreedte printer** overeenkomt met het papier (58mm of 80mm)
* Probeer een zelftest vanaf de printer zelf af te drukken om te controleren of deze werkt
* Controleer of de opdrachttaal overeenkomt met de printer (ESC/POS voor Epson, StarPRNT of Star Line Mode voor Star)

Kassabon is onleesbaar of bevat verkeerde tekens

* De instelling voor de opdrachttaal is mogelijk verkeerd — probeer te wisselen tussen ESC/POS, StarPRNT en Star Line Mode
* Controleer of de instelling **Tekstbreedte printer** correct is
* Als de kassabon in een niet-Latijns schrift of een rechts-naar-links-taal is, schakel dan **Volledige bon als raster** in bij Geavanceerde instellingen — hiermee wordt de kassabon als afbeelding afgedrukt, zodat elke taal correct wordt weergegeven

Kassalade gaat niet open

* Controleer of **Kassalade automatisch openen** is ingeschakeld in de printeropties
* Controleer of de kassalade is aangesloten op de DK-poort van de printer (niet op een aparte stroombron)
* Niet alle printers ondersteunen het lade-openingscommando — raadpleeg de documentatie van de printer

Kan geen verbinding maken vanuit de web-app

* De web-app kan alleen verbinding maken met Epson- en Star-printers met ingebouwde webservers
* Generieke printers en USB-printers worden niet ondersteund op het web — gebruik in plaats daarvan de desktop- of mobiele app
* Als de site HTTPS gebruikt maar de printer alleen HTTP ondersteunt, kan de browser de verbinding blokkeren als gemengde inhoud

Bluetooth-printer maakt geen verbinding (mobiel)

* Koppel de printer in de Bluetooth-systeeminstellingen van het apparaat voordat u deze toevoegt in WCPOS
* Afdrukken via Bluetooth ondersteunt alleen Epson- en Star-printers — generieke Bluetooth-printers worden niet ondersteund
* Als de printer niet in de lijst verschijnt, tikt u opnieuw op **Scannen naar printers** en controleert u of deze is ingeschakeld en binnen bereik is
