netSEO Smartbill Invoicing for CS-Cart - Smartbill Invoice Generation Integration Module
netSEO: Smartbill Billing for CS-Cart
netSEO: Smartbill Invoicing is a professional addon for CS-Cart that automates the generation of electronic invoices through direct integration with the Smartbill Cloud platform (smartbill.ro). The module allows issuing invoices according to ANAF directly from the order page, with automatic retrieval of customer and product data, minimizing manual intervention and ensuring compliance with Romanian tax legislation.
Automatic invoice generation in Smartbill
The module allows generating invoices directly from the order detail page, with a single click. The data is sent to the Smartbill API (documentation: https://api.smartbill.ro/), and the issued invoice is automatically saved in the system, with the possibility of accessing the link to the document. The flow complies with Smartbill specifications: Basic authentication (email + API token), company, customer, products and shipping parameters.
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)
- Currency and due date (configurable)
The module normalizes data for the API (removing diacritics where applicable) and ensures the completion of mandatory fields according to the Smartbill documentation (e.g. address/locality "-" if missing, CUI/CNP or "-" for individuals).
Smartbill API Configuration
Connecting to Smartbill is done through the addon settings:
- API URL – Base URL (default: https://ws.smartbill.ro/SBORO/api)
- User (email) – email address from SmartBill Billing/Management account
- API Token – the token in SmartBill: My Account → Integrations → API
- Company ID – The issuing company ID (numbers only, no RO prefix)
- Invoice series – document series (e.g. netseo, FACT, INV), defined in the Cloud account
- Days to Due – number of days until the invoice due date
Authentication is done through Basic Authentication (email:token), according to the official Smartbill documentation.
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; for no CNP, send "-" according to Smartbill API
The county is taken from the order state (b_state_descr) and sent in a format accepted by Smartbill. The "Save customer in Smartbill" option allows the customer to be automatically added to the Smartbill nomenclature.
Products and shipping on invoice
Each product line is sent to the API with:
- Product name, code (product_code or PROD-ID), quantity, price (with or without VAT)
- VAT rate (name and percentage) and unit of measure (default BUC)
- Currency per line (according to Smartbill documentation)
Shipping is added as a separate line, with configurable name and code (e.g. "Shipping cost", TRANSP code). All lines follow the API structure (name, code, quantity, price, isTaxIncluded, taxName, taxPercentage, measuringUnitName, currency, isService for shipping).
Flexible invoice configuration
Administrators can configure:
- Invoice series and days until due date
- VAT rate and rate name (e.g. Normal)
- Prices including or excluding VAT (isTaxIncluded)
- Unit of measure for products and transportation
- Name and code for the transmission line
- Profile fields for company, CUI, CNP, Commercial Reg. No.
History of generated invoices
All generated invoices are saved in the database with:
- Order ID
- Invoice series and number (from API response)
- Link to invoice (PDF or view, if returned by API)
- Generation date
The order page displays the subheader "Smartbill Invoice Generator", a list of links to existing invoices, and a "Generate Invoice" button (blue design, color #467AD2) with confirmation. The invoice action buttons appear only after at least one invoice has been generated.
Actions on issued invoices (SmartBill API)
After generating an invoice, small buttons with icons are displayed for each invoice that directly call the SmartBill API (according to the documentation https://api.smartbill.ro/ – reverse, cancel, delete, restore):
- Storno – issue a reverse invoice based on the existing invoice (POST /invoice/reverse). The reverse invoice is automatically saved in the list; reversal is possible only if there are no reversals already on the invoice.
- Cancellation – cancel invoice in SmartBill without deleting it from the database (PUT /invoice/cancel).
- Delete – delete invoice from SmartBill and CS-Cart (DELETE /invoice). According to the API, only the last invoice in the series can be deleted; for the others, cancellation is used.
- Restore – restore previously canceled invoice (PUT /invoice/restore).
Each action is confirmed before sending. Error messages returned by the API (e.g. "Invoice already canceled", "Document is not the last in the series") are displayed to the user.
Debug mode for development
The module includes a debug option that displays the JSON sent to the Smartbill API before the invoice is generated. It is useful for testing the configuration, validating data, and troubleshooting API errors (e.g. non-existent series, invalid CIF, 400 messages).
Integration with netSEO Addons Manager
The module integrates with netSEO Addons Manager for license and update management:
- License verification upon activation and when saving license code
- License code configured from addon settings
- Upgrade Center Connector for automatic updates
- Behavior aligned with other netSEO addons
Compatibility
The addon is built for stability and compliance with the Smartbill API:
- Compatible with CS-Cart 4.10.1+, ULTIMATE and MULTIVENDOR editions
- Required dependency: netSEO Addons Manager
- Uninstallation deletes the invoice table and license record from Addons Manager
Native integration into CS-Cart
netSEO: Smartbill Invoicing integrates into the CS-Cart administration interface via a hook in the order detail page (delivery information area): "Generate Invoice" button (blue) and list of already generated Smartbill invoices, each with buttons for PDF viewing, reversal, cancellation, deletion and restoration. The configuration of the API, customer fields and product/transportation parameters is done from the addon Settings, and the issuing flow (data preparation → POST /invoice → save series/number/link) and invoice actions (reverse, cancel, delete, restore) are fully managed by the module.
Without a dedicated Smartbill integration, generating invoices from orders involves manual exports or invoicing in another application. This addon offers a complete solution, aligned with the official Smartbill documentation (https://api.smartbill.ro/), with support for individuals and legal entities, shipping, VAT and invoice history, suitable for CS-Cart stores using Smartbill Cloud as their invoicing solution.
Intrebari frecvente despre netSEO Smartbill Invoicing for CS-Cart - Smartbill Invoice Generation Integration Module
netSEO Smartbill Invoicing for CS-Cart - Smartbill Invoice Generation Integration Module este un produs digital pentru platforma CS-Cart, disponibil pe CS-Cart Romania. După achiziție, produsul poate fi utilizat conform descrierii, documentației și condițiilor afișate în pagina produsului.
După plasarea și achitarea comenzii, pentru modulele CS-Cart se generează automat serialul de licență, iar modulul poate fi descărcat și instalat în site-ul clientului. Pentru licențele CS-Cart, distribuirea se face în aproximativ 1-2 zile lucrătoare după confirmarea plății.
Comenzile se pot plasa online și se achită cu card Visa sau Mastercard prin procesatori de plată securizați, inclusiv procesatori internaționali precum Stripe, acolo unde sunt disponibili.
Da. Modulele netSEO includ update gratuit timp de 6 luni, perioadă în care sunt corectate gratuit bug-urile sesizate. Licențele CS-Cart includ, de regulă, 12 luni de upgrade gratuit, conform condițiilor licenței.
Produsele digitale achiziționate și instalate nu sunt rambursabile. Te rugăm să verifici descrierea, compatibilitatea și documentația produsului înainte de achiziție.
Nu. Modulele netSEO respectă documentația de dezvoltare CS-Cart Add-on Development și nu modifică fișierele core ale platformei CS-Cart.
Modulele netSEO se instalează prin Add-on Manager netSEO, printr-un singur clic, iar fiecare modul include documentație de utilizare și configurare.