RFID Printer Setup

The RFID Printer screen connects the In-Store App to a SATO CL4NX label printer over the local network. Once connected, you can send test labels, query printer diagnostics, and manage the label templates used to print product tags with embedded RFID data.

RFID label printing requires a physical SATO CL4NX printer on the same network as the device running the app.

Opening the RFID printer screen

1. Open Settings (tap the gear icon in the sidebar).
2. Tap RFID Printer.

The RFID Printer screen opens, showing four sections: Connection, Status, Actions, and Label Templates.

Connecting to the printer

The Connection section contains a single IP address field and a connect/disconnect button.

1. Tap the Printer IP Address field and enter the printer's IP address (for example 192.168.1.100). The app connects using port 9100.
2. Tap Connect. The button label changes to Disconnect while the app establishes the connection.

The IP address is saved automatically. The next time you open the RFID Printer screen the saved address is pre-filled, so you only need to tap Connect.

To disconnect, tap Disconnect. The status returns to disconnected and the connect button becomes available again.

Printer status

The Status section shows the current connection state at all times.

When the status is Error, an error message container appears below the status tile with the specific reason. Review the message, check the printer is powered on and reachable, then tap Connect again.

When the status is Connected or higher, the tile subtitle shows the printer's IP address and port.

Actions

The Actions section provides two operations.

Test print

Tap the Test Print tile to send a label using the Print Settings dialog (see Print settings dialog below). This is the same flow as printing from a label template — use it to verify the printer is responding correctly.

The tile is only enabled when the printer status is active (Connected or Printing). If the printer is not connected, the subtitle reads Connect to a printer first and the tile is disabled.

On success, a snackbar confirms Test label sent to printer. On failure, the error is shown in a snackbar.

Run diagnostics

Tap the Run Diagnostics tile to query the printer and display a diagnostic report. The tile is only enabled when the printer is connected. While the query runs, a loading spinner appears on the tile.

Once complete, a Diagnostic Report section appears below Actions with the following information:

Printer information

Status checks

EPC bank

The report includes the current contents of the EPC memory bank on the last tag read, if available.

Label templates

The Label Templates section lists all label templates saved for this tenant. Templates control the visual layout of the printed label and the fields printed on it.

Template list

Each template is shown as a list tile with:

• A label icon in a circular avatar
• The template name
• The label dimensions and element count — for example 200×100 dots · 3 elements
• Three icon buttons: Preview, Edit, and Delete

When no templates have been saved yet, the section shows a No templates yet message with a Create First Template button. If templates fail to load, a Failed to load templates message appears with a Retry button.

Creating a template

Tap the New Template button (the floating + button in the bottom-right corner). The label designer opens.

The label designer is a visual canvas where you place and size text fields, barcodes, and other label elements. Drag elements onto the canvas, resize them, and configure their content. When you are finished, use the save action in the designer to return to the template list.

After the designer closes, the Template Settings dialog opens automatically so you can name the template and set its scope (see Template settings dialog below).

Previewing a template

Tap the Preview icon button on a template tile. A preview of the label layout opens, rendered at its configured dimensions. Close the preview to return to the template list.

Editing a template

Tap the Edit icon button on a template tile. The label designer opens with the existing template loaded. Make your changes and save to return to the list.

Deleting a template

1. Tap the Delete icon button on the template tile.
2. A confirmation dialog appears:
   • Title: Delete Template
   • Message: Delete "[name]"? This cannot be undone.
   • Cancel — closes the dialog without deleting.
   • Delete — removes the template permanently.
3. On success, the tile disappears from the list. On failure, a snackbar shows the error reason.

Template settings dialog

The Template Settings dialog opens after creating a new template, or by tapping the Edit icon and then accessing settings from within the designer.

Tap Apply to save the settings, or Cancel to discard.

Print settings dialog

The Print Settings dialog appears whenever you initiate a print — via Test Print or by printing from a label template elsewhere in the app. It has two parts: field values and RFID tag data.

Field values

The top section shows an editable field for each variable in the label template. Fill in the values to be printed on the label.

RFID tag data

Use the segmented button to choose how to encode the RFID chip embedded in the label:

SGTIN-96 mode

As you fill in the fields, the dialog shows a derivation panel with the resolved Company Prefix, Item Reference, and Partition, followed by a live EPC preview. The preview is shown in green when the EPC is valid and red when there is an error.

Tag data mode

Enter up to 12 bytes of data in the Tag data field. This field is optional — leave it empty to print the label without writing to the RFID chip.

EPC hex mode

Enter the full EPC as 24 hexadecimal characters in the EPC field (for example E2801191200073D412345678). This field is optional.

Tap Print to send the job. The Print button is disabled while the RFID input is invalid. Tap Cancel to close without printing.

Troubleshooting

Related pages

• Printing RFID Labels
• RFID Delivery Batches
• RFID Test
• Receipt Printer Setup