One-click invoicing. Straight to QBO.

NovexERP connects to QuickBooks Online using OAuth 2.0 with the com.intuit.quickbooks.accounting scope. The OAuth handshake exchanges an authorization code for access and refresh tokens, which are stored in the qbo_tokens table alongside the QBO company name and realm ID. Access tokens auto-refresh when within five minutes of expiration, and a single automatic retry on 401 responses handles edge cases where tokens expire mid-request.

Invoice creation is a one-click operation from the order detail screen. The system resolves the NovexERP customer to a QBO customer — querying by email first, then creating the customer in QBO if no match exists. Each line item is similarly resolved through the product mappings table, with unmapped products auto-created in QBO as NonInventory items. The invoice is built with SalesItemLineDetail entries and pushed to the QBO API in a single request. The resulting PDF is downloaded and cached locally so it's available instantly without hitting the QBO API on every view.

Product mapping gives you full control over how NovexERP products appear in QBO. Map products individually through the admin panel, or use bulk create to push all unmapped products to QBO at once. Each mapping links a NovexERP product ID to a QBO item ID, so subsequent invoices reference the correct QBO line items automatically. You can unlink and remap products at any time without affecting historical invoices.

Payment status flows back from QBO via webhooks. NovexERP registers a webhook endpoint that receives Invoice and Payment events, verified with HMAC-SHA256 signature validation against the Intuit-Signature header. Events are queued and processed asynchronously by a cron job — on each update, the system fetches the current invoice state from QBO, updates the local status (draft, sent, paid, partial, overdue, voided), refreshes the cached PDF, and stores the latest balance. This means the order detail screen always shows the real payment status without manual checking.