NetSuite

NetSuite is Oracle’s cloud-based ERP and accounting platform. Hyperline connects to NetSuite so your finance team can send billing data from Hyperline to NetSuite without manually recreating customers, invoices, credit notes, payments, refunds, or chargebacks.

​

What Hyperline synchronizes

The NetSuite integration is a one-way accounting synchronization from Hyperline to NetSuite. Hyperline also reads NetSuite metadata, such as subsidiaries, items, accounts, tax codes, and custom fields, so you can configure mappings from the Hyperline interface.

​

Prerequisites

Before connecting NetSuite, make sure you have:

• A NetSuite account with SuiteTalk REST Web Services and Token-Based Authentication enabled.
• A NetSuite Integration record and access token for the user or role used by Hyperline.
• Admin rights in Hyperline.
• NetSuite subsidiaries, items, accounts, and tax codes ready for the Hyperline entities you plan to synchronize.
• Hyperline products, sync rules, tax settings, and invoicing entities configured.

​

Setup

​

Configure mappings

​

Subsidiaries

NetSuite requires a subsidiary on every customer and transaction. Map each Hyperline invoicing entity to a NetSuite subsidiary on Settings > Integrations > NetSuite. In OneWorld accounts, subsidiary mapping also controls which NetSuite items, accounts, and tax codes are available when you configure the rest of the integration.

​

Customers

If a customer already exists in NetSuite, you can link it to the matching Hyperline customer:

1. Open the customer in Hyperline.
2. Go to the Integrations section.
3. Click Edit.
4. Enter the NetSuite customer internal ID.
5. Click Save.

For bulk linking during onboarding, contact our support team or use the bulk provider mapping API. You can choose whether Hyperline should create missing NetSuite customers automatically:

• No synchronization: the customer must be linked manually before its invoices can be pushed.
• From Hyperline to NetSuite: Hyperline creates the NetSuite customer the first time it is needed by an invoice, credit note, payment, refund, or chargeback.

​

Products and items

Every synchronized invoice line must have a NetSuite item. For each Hyperline product, open the product page, go to the Accounting section, and select the matching NetSuite item. Hyperline fetches items from NetSuite and filters the list based on the subsidiary mapped to the invoicing entity. If a product is missing an item mapping, the invoice synchronization stops with an issue you can fix and retry. If your NetSuite account uses revenue recognition rules, you can also select the relevant rule from the product Accounting section after choosing the NetSuite item.

​

Bulk update product mappings

During implementation, you can update NetSuite product mappings for several products from the product catalog:

1. Go to Catalog > Products.
2. Select the products you want to update.
3. Click Bulk update.
4. In the accounting fields, update the NetSuite item or product code mapping.
5. If you use NetSuite revenue recognition, select the matching Revenue recognition rule.
6. Click Save.

​

Accounts

Configure NetSuite account mappings from Settings > Integrations > NetSuite > Sync rules. Only accounts that can be used for posting are available in rules. Non-posting and statistical accounts are filtered out. Review your sync rules before go-live so each invoice line, payment, refund, and chargeback can resolve to the expected NetSuite account.

​

Accounting sync rule criteria

NetSuite account mapping is resolved from Hyperline sync rules. When a record is synchronized, Hyperline evaluates the matching rules, applies the highest-priority account mapping, then sends the matching NetSuite account on the invoice line, payment, refund, or chargeback record. Use rule criteria to control when a mapping applies:

​

Tax codes

Configure tax codes at the Hyperline invoicing entity level. Hyperline resolves the tax code from the invoice tax settings and sends it to NetSuite for taxable invoice lines. See Tax management for the Hyperline tax setup.

​

Payment synchronization

Payment, refund, and chargeback synchronization is configured per payment method, such as card, direct debit, bank transfer, external payments, and other payment sources. Each payment method can be set to:

• No synchronization: payments, refunds, and chargebacks using this method are not sent to NetSuite.
• From Hyperline to NetSuite: settled payments, settled refunds, and chargebacks are sent to NetSuite for the corresponding invoice or payment.

For invoice overpayments, Hyperline creates the NetSuite Customer Payment for the full amount received. It applies only the remaining NetSuite invoice balance and leaves the excess amount unapplied on the Customer Payment. Invoice overpayments are not automatically treated as wallet top-ups.

​

Optional field mappings

You can map Hyperline customer fields, invoice custom properties, and invoice line fields to NetSuite fields from Settings > Integrations > NetSuite. This is useful for reporting dimensions such as location, department, class, contract references, or service periods. Create the relevant custom properties in Hyperline before mapping them to NetSuite fields.

​

Synchronization behavior

Hyperline sends eligible records to NetSuite automatically after they are created or updated. The synchronization delay is 5 minutes maximum. By default, only data created after the connection date is synchronized. To send older data, contact our support team or use Resync when the option is available from the integration actions menu.

​

Locked accounting periods

For invoices, credit notes, and customer payment creation or updates, Hyperline checks the NetSuite accounting period for the transaction date. If that period is closed, fully locked, or A/R locked, Hyperline keeps the original transaction date and sends the record to the nearest open NetSuite posting period. Customer Payment deletion is stricter. If the NetSuite Customer Payment belongs to a closed, fully locked, or A/R locked period, Hyperline does not delete it and records an integration issue. An administrator can adjust or remove the payment in NetSuite, then resolve or ignore the issue in Hyperline when the accounting state is correct. For creation and updates, you do not need to reopen the locked period or change the financial date in Hyperline. The following invoice statuses are not pushed to NetSuite:

• draft
• open
• charged on parent
• pending parent concatenation
• closed
• archived

​

Refunds, chargebacks, and wallet activity

Credit notes are synchronized as NetSuite Credit Memo records. When a credit note is linked to an invoice in Hyperline, Hyperline applies the NetSuite credit memo to the matching NetSuite invoice. Settled refunds are synchronized as NetSuite Customer Refund records when the payment method is configured to synchronize. Chargebacks are also synchronized as NetSuite Customer Refund records, applied to the original Customer Payment. The related Customer Refund is removed and the Customer Payment application is restored when the chargeback is cleared or the transaction is deleted in Hyperline. Paid wallet top-ups are handled separately from regular invoices:

• The wallet top-up document generated by Hyperline is not pushed as a NetSuite Invoice.
• Paid top-ups are synchronized as NetSuite Customer Payments when eligible.
• Wallet payments are applied to the NetSuite invoices paid with wallet balance.
• When a paid top-up is reverted, Hyperline un-applies the related NetSuite Customer Payment and creates a Customer Refund. If the original Customer Payment was not synchronized, Hyperline records an integration issue instead.
• Free wallet credits are not pushed as Customer Payments.

​

Monitor and recover

If NetSuite rejects a record or a mapping is missing, Hyperline records an integration issue. Open Settings > Integrations > NetSuite > View issues to review the error, fix the configuration or source data, then retry the synchronization. Use Resync from the integration actions menu after changing mappings, reconnecting NetSuite, or correcting issues that affected existing records. For accounting integrations, Resync can send missing invoices, update existing provider invoices, and update linked customers. See Manage connected integrations for details about reauthorization, reconfiguration, resync, and disconnection actions.

​

Next steps

• Review sync rules on Settings > Integrations > NetSuite before mapping NetSuite accounts.
• Configure tax settings for each invoicing entity.