EANCustom

Set up EANCustom, also called Custom EAN

EANCustom is the ImaCash mode that reads a ticket code using a mask agreed with the POS supplier. The mask specifies the positions containing the amount and references; it does not turn any product barcode into a payment ticket.

Prepare scanning

1. Confirm the format. Ask the supplier for the exact code structure, the meaning of each position, the currency and the ticket reference. Set up the scanner and cash machine separately. This mode does not need a connection to the POS database or supplier login details.
2. Select EANCustom. In Configuration > Integration, choose EANCustom. This is the selector name; Custom EAN is another name for the same mode.
3. Fill in Characters. Enter the mask in uppercase, with one position for every character in the complete code. It must contain at least three E positions and one D. Agree on two D positions for cents; do not copy a mask from another POS or add spaces or separators that the scanner does not send.
4. Save and check. When closing configuration, confirm saving if prompted and follow the proposed restart when applicable. Saving does not prove that scanning is correct. Before real use, check sample codes without customer data, amounts, currency, references and payment method with the supplier.

What each letter means

• L: Ticket location or store, if included in the code.
• C: POS till or terminal, if included in the code.
• T: Original ticket reference. It should identify each ticket unambiguously.
• X: Payment type: 0 cash and 1 card. If X is omitted, the code is interpreted as cash; check that this matches the ticket.
• E: Whole digits of the amount. At least three E positions are required.
• D: Decimal digits of the amount. At least one D position is required.
• O: Ignored position. Its contents are not checked as a fixed value or a check digit.

The scanned length must match the mask exactly. A single D is interpreted as tenths; with more than two D positions only the first two are kept, without rounding. Letters are case sensitive: use the uppercase letters shown and always check the displayed amount.

Scope and precautions

A price code may recur across sales: it is not necessarily a ticket identifier. Without T, the local reference does not identify the POS ticket consistently. Do not assume general duplicate protection or universal EAN13 check digit validation. If the result is uncertain, check the operation and actual cash before scanning again or restarting.

This workflow records the operation in ImaCash; its local confirmation or rejection does not write closure or cancellation to the POS. It does not retrieve sales by date, products, shifts or the supplier’s bank total. Review tickets and references with the person responsible for the POS.

This guide documents the mode’s behaviour; it does not establish compatibility with every POS, scanner or cash machine. The supplier must confirm the format and a supervised physical test before commercial use.