CapsPos

Configure CapsPos

This guide covers the ImaCash CapsPos connector using exchange files. Confirm the edition, format and installation with the provider before use; it does not certify every similarly named product.

A dedicated folder accessible from the ImaCash computer is required. Both programs must be able to read, create, write and manage their own files and subfolders under their actual Windows users. No SQL connection or DSN is configured.

Setup steps

1. Agree the exchange folder, sales format and response handling with the provider. Prepare a recoverable backup and prevent another reader from processing the same files.
2. Open Configuration > Integration > POS and select CapsPos.
3. In Sales, use the folder picker to select the confirmed directory. This is a folder, not a database file. Check permissions under the user running ImaCash; an existing folder does not prove that the exchange can be completed.
4. Confirm the cash and card payment types sent by the provider and review Accept cards. Disabled card payments are archived as processed rather than kept pending for later activation. Do not assume that other methods or mixed payments are interpreted correctly.
5. Close the changed configuration and choose to save. Review the checks and explicitly confirm a proposed restart when appropriate. Saving without changes may retain the previous check.
6. With the provider, validate a controlled sale: unique reference, amount including cents, date, terminal, cashier, payment method and actual cash. Also check that the provider recognises the result. Selecting or saving a folder does not validate the whole workflow.

Scope and checks

Reads TXT sales files directly in the selected folder, without scanning subfolders or providing date-based historical recovery. Date, terminal and cashier come from the message; it does not discover a terminal or staff catalogue or guarantee local filters for them.

Completed files move to a processed subfolder; invalid files may be archived as errors. Retain the exchange as agreed with the provider. Do not restore, delete or put files back to repeat an operation whose outcome is uncertain.

ImaCash writes a payment or cancellation result file for the provider to read. Writing it successfully does not prove that the provider applied it. Cancelling a payment does not prove that the sale was cancelled or cash refunded. If uncertain, check both systems and actual cash before repeating, resynchronising or restarting.

Does not import products or shifts or provide a bank total for cards. Refunds, mixed payments and physical use require specific provider validation; a file test does not certify a validated physical installation.