Package: odoo-addon-l10n-fr-pos-caisse-ap-ip
This module adds support for theCaisse APprotocol over IP in the
Odoo Point of Sale.TheCaisse AP
protocolis a vendor-independent protocol used in France to communicate between a
point of sale and a payment terminal. It is implemented byIngenicopayment terminals,Verifonepayment
terminal and other brands of payment terminals. This protocol is
designed by a French association calledAssociation du
paiement, abbreviated asAP. Note that the Caisse-AP protocol is used by Ingenico payment
terminals deployed in France, but not by the same model of Ingenico
payment terminals deployed in other countries!This module support a bi-directionnal link with the payment terminal:it sends the amount to the payment terminalit waits for the end of the payment transactionit parses the answer of the payment terminal which gives the payment
status: in case of success, the payment line is automatically
validated ; in case of failure, an error message is displayed and the
Odoo user can retry or delete the payment line.The Caisse-AP protocol was initially written for serial and USB. Since
the Caisse AP protocol version 3.x, it also supports IP. When used over
IP, the client (point of sale) and the server (payment terminal)
exchange simple text data encoded as ASCII over a raw TCP socket.The Caisse-AP protocol has one important drawback: as it uses a raw TCP
socket, it cannot be used from pure JS code. So the JS code of the point
of sale cannot generate the query to send the amount to the payment
terminal by itself. In this module, the JS code of the point of sale
sends a query to the Odoo server that opens a raw TCP socket to the
payment terminal. It implies that, if the Odoo server is not on the LAN
but somewhere on the Internet and the payment terminal has a private IP
on the LAN, you will need to setup a TCP port forwarding rule on the
firewall to redirect the TCP connection of the Odoo server to the
payment terminal.Table of contentsConfigurationBug TrackerCreditsAuthorsContributorsOther creditsMaintainersConfigurationIn the menuPoint of sale > Configuration > Payment Method, on the
payment method that correspond to a payment by card:select the appropriate journal, which should be a bank journal (and
not a cash journa, otherwise the fieldUse a payment terminalis
invisible)fieldUse a payment terminal: selectCaisse AP over IP (France
only)fieldCaisse-AP Payment Terminal IP Address: set the IP address of
the payment terminal,fieldCaisse-AP Payment Terminal Port: set the TCP port of the
payment terminal (8888 by default),fieldPayment Mode: setCard(the valueCheckis for theCheckpayment method if you use a check printer connected to the
payment terminal such as Ingenico i2200)Bug TrackerBugs are tracked onGitHub Issues.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomedfeedback.Do not contact contributors directly about support or help with technical issues.CreditsAuthorsAkretionContributorsAlexis de Lattre <alexis.delattre@akretion.com>Pierrick Brun <pierrick.brun@akretion.com>Other creditsThe development of this module has been financially supported byCamptocamp.MaintainersThis module is maintained by the OCA.OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.Currentmaintainer:This module is part of theOCA/l10n-franceproject on GitHub.You are welcome to contribute. To learn how please visithttps://odoo-community.org/page/Contribute.