netSEO Oblio Invoicing for CS-Cart - Invoice Generation Integration Module in Oblio (oblio.eu)

netSEO: Oblio Billing for CS-Cart

netSEO: Oblio Invoice is a professional addon for CS-Cart that automates invoice generation by directly integrating with the Oblio platform (oblio.eu) via REST API. The module allows issuing documents from the order page, with automatic retrieval of customer and product data, aligned with the official Oblio documentation ( oblio.eu/api ) and the examples published by OblioSoftware on GitHub.

Automatic invoice generation in Oblio

The module allows generating invoices directly from the order detail page, with a single click. Authentication is done via OAuth 2.0 (client_id = Oblio account email, client_secret = token from Settings > Account data), then requests use Bearer token. The data is sent to the invoice issuing endpoint; the response (series, number, document link) is saved in the CS-Cart database.

Full integration with CS-Cart orders

All order data is automatically taken from CS-Cart:

• Customer information (individual or legal entity)
• Billing address, city, county and country
• Ordered products with prices, quantities and codes
• Transportation costs (dedicated line on invoice)
• Invoice currency (select from the platform's active currencies) and days until due date

The module normalizes texts for the API (removing diacritics where applicable) and fills in client fields according to the Oblio API (e.g. vatPayer, save client, contact for PJ).

Oblio API Configuration

Connecting to Oblio is done through the addon settings:

• API URL – Base URL (default: https://www.oblio.eu/api)
• User (email) – Oblio account (client_id to OAuth token)
• API Token – client_secret from Oblio: Settings > Account details
• Company CUI (without RO) – Issuing company CUI; in applications, normalized CIF with RO prefix is sent
• Invoice series – series name from the Oblio nomenclature (ex: netseo, FCT)
• Days until due – configurable
• Oblio management download – Yes: useStock=1, Goods lines with code (products in nomenclature + stock in management); No: useStock=0, Service lines without code (recommended for online store without Oblio stock alignment)

Support for individuals and legal entities

The module recognizes the client type and retrieves data from the configured profile fields:

• Legal entity – company name, CUI, Commercial Reg. No. (profile field IDs)
• Individual – name from billing; CNP from optional profile field

The county is taken from the order state (b_state_descr). The "Save client in Oblio" option controls the sending of the save field (update Oblio client nomenclature).

Products, shipping, VAT and discount

Product lines follow the Oblio JSON structure: name, quantity, price, currency, vatIncluded, vatName, vatPercentage, measuringUnit (default pc from the PC setting), productType according to the management mode. Shipping is added as a separate line. The module aligns the total to the order amount (rounding adjustment or value discount line according to the Oblio API).

Delegate and invoice preparer

You can configure issuerName, issuerId (CNP), deputyName, deputyIdentityCard, deputyAuto. If the order has an assigned administrator (issuer_id), the module can automatically take over the name displayed for the issuer/delegate, similar to the logic in other netSEO invoicing modules.

History of generated invoices

The generated invoices are saved in the database with:

• Order ID
• Invoice series and number
• Link to document (from Oblio's answer)
• PDF path saved locally when download is possible
• Generation date

On the order page: subheader, list of invoices with link, "Generate Invoice" button (orange color #f36f21) with confirmation via secure POST.

Actions on issued invoices (Oblio API)

After generation, actions are available for each invoice according to Oblio documentation:

• Cancellation – issue cancellation invoice via POST /docs/invoice with referenceDocument (Invoice, refund)
• Cancellation – PUT /docs/invoice/cancel
• Delete – DELETE /docs/invoice (according to API, only the last document in the series)
• Restore – PUT /docs/invoice/restore

Each action is confirmed before submission. Error messages returned by the API are displayed to the user.

PDF viewing and proxy

The link to the invoice can be opened directly; there is also the get_pdf module that serves the PDF saved locally or obtain it via API (GET document + signed link) for viewing from the admin.

Debug mode

Debug option displays the JSON sent to Oblio before output, useful for testing and debugging.

Integration with netSEO Addons Manager

The module depends on netSEO Addons Manager :

• License verification upon activation and when saving license code
• License code in addon settings
• Upgrade Center Connector for updates (same model as other netSEO addons)

Compatibility

• CS-Cart 4.10.1+, ULTIMATE and MULTIVENDOR editions
• Required dependency: netSEO Addons Manager

Native integration into CS-Cart

netSEO: Oblio Billing integrates into the admin via hook in the order detail page: invoice generation, history, Oblio actions and grouped settings (API, delegate, customer data, products and shipping). The flow is designed for stores that use Oblio as an invoicing solution and want fast issuance from CS-Cart orders, with the possibility of linking to management when Oblio products and stock are aligned with the store.

Without dedicated Oblio integration, invoicing from orders requires manual re-entry or separate export. This addon reduces time and errors by respecting the Oblio API and providing clear control between "unmanaged" mode (Service) and "unmanaged" mode (Goods + inventory).