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.

​

Coupon discount lines

When an invoice or credit note includes coupons, Hyperline sends each coupon discount to NetSuite as a separate line below the impacted product line. This makes discounts easier to trace in NetSuite reports, revenue recognition, and journals. Each coupon discount line uses:

• The same NetSuite item as the impacted product line.
• The same account, tax code, and revenue recognition rule as the impacted product line.
• A negative amount that offsets the gross product line amount.
• A description that includes the coupon name, product name, and service period when available.

When a coupon applies to multiple invoice lines, Hyperline splits the discount across the impacted lines and creates one discount line for each allocated share.

​

Rounding product

NetSuite can recalculate invoice and credit memo totals after Hyperline sends the record, for example when NetSuite applies its own tax or line rounding. To reconcile small differences, configure a dedicated rounding item from Settings > Integrations > NetSuite > Default codes > Rounding product. When the NetSuite total differs from the Hyperline total by one currency minor unit, such as EUR 0.01 or USD 0.01, Hyperline adds a non-taxable Round Off line using the selected item. The rounding item is only used for this adjustment line; regular invoice lines still use the product item mappings configured on each Hyperline product. If the difference is larger than one minor unit, Hyperline records an integration issue instead of adjusting the NetSuite record. If no rounding product is configured, Hyperline does not add a rounding adjustment line.

​

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, chargeback, and invoice write-off can resolve to the expected NetSuite account. Coupon discount lines use the same account as the product line they discount. To route discounts differently, configure account sync rule criteria so the impacted invoice line resolves to the expected account. If you synchronize invoices marked uncollectible, configure Bad Debt Expense on the matching invoice sync rule. NetSuite write-offs are created as Credit Memos applied to the original invoice, and Hyperline uses this account on the write-off lines. If no matching rule provides a bad debt expense account, the write-off synchronization stops with an issue you can fix and retry.

​

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. When a credit note is refunded to the customer’s wallet, Hyperline does not create a NetSuite Customer Refund because no cash refund is sent back to the customer. Instead, Hyperline applies the NetSuite Credit Memo to the original invoice and keeps the customer value available as wallet balance in Hyperline. If the original NetSuite invoice was already closed by payments, Hyperline first opens the invoice balance for the credit memo:

• For wallet-paid invoices, Hyperline reduces or removes the wallet top-up Customer Payment application.
• For card, direct debit, bank transfer, or other Hyperline-synchronized payments, Hyperline reduces the matching Customer Payment application for the credited amount.
• For invoices paid by both wallet and another payment method, Hyperline adjusts the wallet payment first, then reduces the other synchronized payment only for the remaining amount.

Hyperline does not change manual or unknown NetSuite payments when preparing a wallet-refunded credit note. If such a payment blocks the credit memo application, Hyperline records an integration issue so the payment can be reviewed in NetSuite. 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 unapplies 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.

​

Guides

​

Record an offline payment

Choose the payment action based on how the payment should be applied.

​

Payment for a specific invoice

Use Mark as paid when the payment received is for one specific invoice and you want to apply it directly to that invoice.

1. Open the invoice in Hyperline.
2. Click Actions > Mark as paid.
3. Enter the payment details, such as the amount paid, settlement date, bank account, payment reference, or internal comment.
4. Click Save.

When the payment method is configured to synchronize, Hyperline sends the settled payment to NetSuite as a Customer Payment applied to the matching NetSuite Invoice.

​

Customer-level payment or prepayment

Use Record offline payment from the customer’s wallet when you receive one payment that should cover several invoices, or when part of the amount should remain available for future invoices.

1. Open the customer in Hyperline.
2. Go to the Wallet tab.
3. Click Actions > Record offline payment.
4. Enter the payment details, such as the amount received, bank account, payment reference, or internal comment.
5. Open the invoice you want to settle.
6. Click Actions > Pay with wallet.
7. Select the amount to allocate from the wallet to the invoice.
8. Repeat the wallet payment action on any other invoice that should use part of the same payment.

Any unused amount remains in the customer’s wallet. When the related payment method is configured to synchronize, Hyperline sends the full context to NetSuite: the customer payment, the invoices paid with wallet balance, the payment applications, and any remaining unapplied amount.

​

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.