Credit Memos

Credit Memos — MonetizeNow Docs
NetSuite Integration

Syncing Service Credits to NetSuite

MN shows $800. NetSuite shows $1,000. Both are right. This page explains why, what gets created, and how to fix it when something is missing.

Layer 1
Posted invoices in NetSuite never change
Layer 2
Timing determines how the Credit Memo arrives
Layer 3
Reconcile on net balance, not invoice total

Why NetSuite Gets a Credit Memo, Not a Reduced Invoice

NetSuite treats posted invoices as closed accounting entries. Editing one retroactively alters recognized revenue, a GAAP/IFRS concern. So credits always create a new linked transaction. The invoice amount is permanent once exported.

System Rule

An exported invoice is never modified. Every credit adjustment creates a new Credit Memo linked to that invoice, traceable back to MonetizeNow.

How Timing Shapes What NetSuite Receives

One question is checked at sync time: has this invoice already exported? The answer changes the delivery method, not the outcome. A Credit Memo always lands in NetSuite either way.

TimingNetSuite InvoiceNetSuite Credit MemoCustomer Balance
Credit before exportFull original amountCreated, linkedInvoice minus Credit
Credit after exportUnchangedCreated, linkedInvoice minus Credit
Worth Knowing

Pre-export and post-export credits produce identical records in NetSuite. Finance teams reconciling either scenario work with exactly the same transaction types.

Invoice and Credit Memo export together as a paired set. NetSuite receives both in one operation. Gross invoice value is preserved — the credit is always a discrete memo, not absorbed into the invoice lines.

MonetizeNow
Subscription $800
Usage $200
Subtotal $1,000
Service credit -$200
---------------------
Amount due $800
NetSuite receives
Invoice $1,000
Credit Memo -$200
---------------------
Customer bal. $800
Common Misconception

A credit applied before export does not get absorbed into the invoice total. A $1,000 invoice and a $200 Credit Memo are always two discrete records. This is accounting behavior, not a sync quirk.

A standalone Credit Memo is pushed and linked to the existing invoice. The original invoice record is not touched.

Already in NetSuite
// Posted, not modified
Invoice $1,000
Balance $1,000
After credit sync
// Invoice unchanged
Invoice $1,000
// New Credit Memo
Credit Memo -$200
---------------------
Net balance $800
Audit Trail

Every Credit Memo carries a reference to its originating invoice. Full billing history is traceable in a single lookup.

When a credit balance spans multiple open invoices, MN distributes it in invoice order until exhausted. Each distribution creates its own linked Credit Memo in NetSuite.

Invoice Invoice Total Credit Applied NetSuite Credit Memo Remaining
INV-1041$1,000.00$500.00CM-1041 · $500$500.00
INV-1042$600.00$300.00CM-1042 · $300$300.00
INV-1043$400.00$0.00None$400.00
// Account-level credit balance: $800.00
Applied to INV-1041 -$500.00
Applied to INV-1042 -$300.00
--------------------------------
Credit balance used $800.00 · Exhausted
Finance Team Note

When reconciling a customer with a large credit balance, search NetSuite by customer, not by individual invoice. All associated Credit Memos surface under the customer record and their sum equals total credit applied.

What Both Systems Show After a Credit Sync

Reconcile on net balance, not invoice totals. These two views represent the same $800.

MonetizeNow Billing View
Invoice total$1,000.00
Service credit-$200.00
Amount due$800.00
NetSuite Accounting Records
Invoice$1,000.00
Credit Memo-$200.00
Net balance$800.00
Compare net balance, not invoice totals. NetSuite invoice always shows gross pre-credit value. MN amount due should match NetSuite net customer balance.
Search by customer in NetSuite, not by invoice. Credits across multiple invoices produce multiple Credit Memos. Customer record is the right aggregation point.
Credit Memo missing? Check sync timing first. Verify sync has completed for the relevant period before escalating.
Tip

In NetSuite: Transactions › Customers › [Customer] › Open Balance — this view includes all linked Credit Memos and matches what MN reports as amount due.

Why Credits Don't Sync or Don't Apply

Two different failure modes, often confused. A credit that never reached NetSuite is a sync problem. A credit memo sitting in NetSuite unallocated is an application problem. The fix is different for each.

MN builds credit memos against existing NetSuite records. It does not create them on demand. Three things must already exist:

1
Account is associated to a NetSuite customer Without this, sync cannot build the memo header.
2
Every invoice the credit was applied to is already in NetSuite MN looks up NetSuite invoice IDs from its association table. Credits inherit associations, they do not discover invoices.
3
NetSuite item on the credit memo can be resolved Raw credits use Credit As Credit Memo. Credit notes use per-line product mappings. If either lookup fails, sync fails.
SkippedNetSuite association already exists

On create events, MN skips if an association already exists. Intentional duplicate prevention. Credit appears missing but association record exists in MN? It synced in a prior run.

BlockedUpdate fired but original create never completed

Update events expect an existing association. If the original create never completed, update has nothing to reference. Resolve what blocked the create and re-trigger it, not the update.

FailedApplied invoice has no NetSuite association record

Most common root cause when "invoice synced fine but credit didn't." Invoice syncing to NetSuite and that sync being recorded in MN's association table are not always simultaneous. If credit sync fired before the association was written, the lookup returns nothing.

Worth Checking

If the invoice association was created after credit sync already ran, the credit will not auto-retry. Re-trigger once the association exists.

Credit memo in NetSuite does not mean credit memo allocated to an invoice. MN builds allocation from invoice application records. If that data is missing or cannot resolve to a NetSuite invoice ID, the memo lands unattached.

Not AppliedCredit was issued but not applied to an invoice in MN

Issuing and applying are separate actions. A credit sitting as an account balance has no invoice application data. MN syncs the memo but with nothing to allocate against. Expected behavior, not an error.

Not AppliedApplication data exists but does not target an invoice

MN filters credit applications to invoice targets only. Applications against other target types are excluded from NetSuite allocation entirely, by design.

Not AppliedTarget invoice is in MN but not in NetSuite associations

Even with valid application data, allocation depends on resolving the MN invoice to a NetSuite invoice ID. If the association is missing, the memo arrives in NetSuite unattached.

Preview is not Applied State

Invoice preview runs full billing logic but does not persist credit application. A credit that appears offset in preview has no application record. NetSuite has nothing to allocate against.

Both produce Credit Memos in NetSuite but they build them differently. Treating them as equivalent is where most item-mapping issues come from.

CreditCredit Note
Memo line itemSingle default: Credit As Credit MemoItemized from credit note lines in MN
Item resolutionPreconfigured product lookupPer-line product / SKU mapping
If item is missingFatal, sync failsSync fails, line blocked
Allocation sourceInvoice application dataInvoice application data
Unexpected line items in NetSuite?

Check whether the source was a credit or a credit note. Raw credit = single line using the default item. Credit note = itemized structure from MN, all product mappings must be complete.

Credit As Credit Memo is a required dependency

For raw credit events, MN uses this preconfigured item to build the memo line. If it cannot be found in NetSuite, sync throws an error and does not skip silently. Verify it exists and is mapped before retrying any failed credit sync.

Things to Check Before Opening a Ticket

NetSuite connection is enabled. Disabled connections drop sync events silently, no error, nothing in NetSuite.
Account is associated to a NetSuite customer. Check this first. No mapping, no memo header.
The invoice the credit was applied to has a NetSuite association record. Most common root cause. Not just "it synced" — confirm the association record exists in MN.
Credit was actually applied in MN, not just created. Account balance is not invoice application. Check for invoice application data.
You are not reading preview as applied state. Preview does not write records.
Credit item mapping is in place. Raw credits: confirm Credit As Credit Memo exists in NetSuite. Credit notes: confirm per-line product mappings are complete.
Retrying an update? Verify the original create completed first. Update has nothing to reference without an existing association.