Oxygen Pelatologio for OpenCart — receipts, invoices and myDATA from orders

Oxygen Pelatologio Invoices for OpenCart 4.x, 3.x and 2.3 creates a document from an order in the Greek service Oxygen Pelatologio (pelatologio.gr) through its API: a retail receipt, an invoice or a credit note. The document is created in Oxygen in your numbering sequence with the buyer, the rows and the VAT rates, and Oxygen passes it to myDATA according to the settings of your account.

What you need. An Oxygen Pelatologio account and an API key from its dashboard. You set the document types, the myDATA income classification and the numbering sequences together with your accountant: the module uses what you have chosen.

What the buyer sees

At the OpenCart checkout the buyer enters the usual data. The module adds an optional AFM (ΑΦΜ) field: a buyer who fills it in gets an invoice for the company (in Pro), the others get a retail receipt as a private person. The module finds the buyer in Oxygen by e-mail or creates the contact, so there are no duplicates.

What the admin gets

Extensions → Modules → Oxygen Pelatologio has the tabs “Connection”, “Document”, “Buyer”, “Automation”, “Products” and “Pro”. On “Connection” you paste the API key from the Oxygen dashboard (it is stored encrypted and never returned to the form), switch the sandbox on if needed and press “Save and check the connection”: the module reads the VAT rates, payment methods, numbering sequences and warehouses from the account. On “Document” you choose the document type, the sequence, the default payment method and the myDATA income classification.

The order page gets an “Oxygen Pelatologio” panel: the buyer, a preview of the rows with net prices and the rate, the total and the document type. After issuing it shows the document number, the myDATA MARK, the state and the buttons: PDF, e-mail the PDF and credit note. Under Sales there is a list of all documents with the states “In progress”, “Stopped” and “Issued”. A stopped document can be retried once the reason, for example the AFM, is fixed.

A document is never created twice: after a lost answer from Oxygen the module finds the document that already exists instead of creating another. Network errors, 5xx and 429 are retried by the module itself. The document total equals the order total to the cent; for other currencies the document goes in euro. If an order cannot be split into rows (a gift voucher, a fixed fee, reward points), no document is created and the module explains why.

In Pro the document is issued by itself at the order statuses, without slowing down the buyer’s page. For companies the module issues an invoice: it tells Greek, EU and non-EU buyers apart by the AFM, looks the AFM up in the registry (the name, tax office, address and activity go into the contact) and in VIES. An invalid AFM stops the document with a clear text, and fixing the AFM in the order lets you retry. A credit note is made by a button or by a status, for a receipt and for an invoice; a credit note covers the whole order.

Pro also has numbering sequences and a payment method for each payment extension, order rows tied to Oxygen products by SKU or model with a warehouse, creating missing products, updating the e-mail and phone of the contact, marking the payment for online payments and for cash on delivery by status, and an e-mail with the PDF in the language of the order.

How it works, step by step

1. Install the archive for your OpenCart version and switch the module on.
2. Create an API key in the Oxygen Pelatologio dashboard.
3. On “Connection” paste the key and press “Save and check the connection”.
4. On “Document” choose the document type, the sequence and the payment method; on “Buyer” create the AFM field.
5. On the order page look through the rows and press “Issue the document”.
6. In Pro documents, payments, credit notes and e-mails go by themselves at the statuses.

Under the hood

• Oxygen Pelatologio API v1; the key is encrypted.
• A retail receipt goes as a document of type rp or rs, an invoice as the type for Greek, EU and non-EU buyers; Oxygen passes the document to myDATA.
• The document date is always today in Athens; the module does not issue back-dated documents.
• Issued documents are not deleted in myDATA, they are credited.
• A credit note from the module covers the whole order; partial returns are not made by the module.
• A missing product created by the module appears in Oxygen with zero stock.
• Own document tables; they stay when the module is removed.
• OpenCart events, no core edits.
• Interface in English and Greek.

How to install

1. Extensions → Installer: upload the archive for your version without renaming it (OpenCart 4: cc_oxygen.ocmod.zip, 3.x: cc_oxygen-oc3.ocmod.zip). For 2.3 unpack cc_oxygen-oc23.ocmod.zip and upload the contents of the upload folder to the shop root.
2. For 3.x and 2.3: Extensions → Modifications → Refresh.
3. Extensions → Modules → Oxygen Pelatologio: install and open it.
4. Paste the API key, press “Save and check the connection”, choose the document type and the sequence.
5. For Pro: paste the licence key or start the trial on the “Pro” tab.