Outbound Transaction Consolidation
Consolidation determines how NetSuite records are grouped into outbound EDI transactions. When you receive a single 850 Purchase Order that creates multiple Sales Orders (for example, due to ship-to address splitting), consolidation controls whether the connector sends one outbound document per Sales Order or combines them into a single EDI envelope.
Consolidation Methods
The connector supports four consolidation methods, configured per Enabled Transaction Type on the Customer record.
Parent 850
All records originating from the same inbound 850 Purchase Order are grouped into a single outbound envelope.
Use case: Your trading partner expects one 856 Ship Notice that includes all shipments from a PO, regardless of how many Ship-To locations or fulfillments are involved.
Example: An 850 PO splits into 3 Sales Orders (one per Ship-To). Each Sales Order generates an Item Fulfillment. With Parent 850 consolidation, all 3 Item Fulfillments are combined into a single outbound 856.
Ship To
Records are grouped by ship-to address. Sales Orders with the same shipping address (or DC Number) share an outbound envelope.
Use case: Your trading partner requires separate ASNs per Ship-To location, but you may have multiple Sales Orders going to the same location that should be combined.
Example: An 850 PO splits into 3 Sales Orders across 2 Ship-To addresses. Ship-To A has 2 Sales Orders; Ship-To B has 1. With Ship To consolidation, you send 2 outbound 856s: one containing both fulfillments for Ship-To A, another for Ship-To B.
Sales Order
Each Sales Order gets its own outbound envelope. Records created from the same Sales Order (for example, multiple Item Fulfillments from partial shipments) are grouped together.
Use case: Your trading partner requires one outbound document per Sales Order, but partial shipments from the same SO should be combined.
Example: A Sales Order has 2 partial Item Fulfillments. With Sales Order consolidation, both fulfillments are combined into a single outbound 856.
None
No consolidation. Each NetSuite record produces its own outbound EDI envelope, processed immediately when the record reaches the ready state.
Use case: Simple 1:1 processing where each fulfillment or invoice should generate a separate EDI document immediately.
Example: Each Item Fulfillment generates its own 856 the moment it ships.
Note: When Consolidation Method is set to None, the connector processes records synchronously via the User Event script. All other consolidation methods use the scheduled Map/Reduce script for batch processing.
How Consolidation Works by Transaction Type
855 Purchase Order Acknowledgment
| Method | Groups By | Envelope Contains |
|---|---|---|
| Parent 850 | Inbound 850 | All Sales Orders from the PO |
| Ship To | Shipping address | Sales Orders with matching Ship-To |
| Sales Order | Each SO | Single Sales Order |
| None | Each SO | Single Sales Order (processed immediately) |
856 Advance Ship Notice
| Method | Groups By | Envelope Contains |
|---|---|---|
| Parent 850 | Inbound 850 | All Item Fulfillments from all SOs created from the PO |
| Ship To | Shipping address | Item Fulfillments from SOs with matching Ship-To |
| Sales Order | Parent SO | All Item Fulfillments from a single Sales Order |
| None | Each IF | Single Item Fulfillment (processed immediately) |
810 Invoice
| Method | Groups By | Envelope Contains |
|---|---|---|
| Parent 850 | Inbound 850 | All Invoices from all SOs created from the PO |
| Ship To | Shipping address | Invoices from SOs with matching Ship-To |
| Sales Order | Parent SO | All Invoices from a single Sales Order |
| None | Each Invoice | Single Invoice (processed immediately) |
When Does the Connector Send Outbound Transactions?
The connector waits until all related Sales Orders are ready before sending a consolidated outbound document. This ensures your trading partner receives complete information.
What the Connector Waits For
| Transaction Type | The connector sends when... |
|---|---|
| 855 PO Acknowledgment | All Sales Orders have been approved (not "Pending Approval") |
| 856 Ship Notice | All Sales Orders have been fulfilled ("Pending Billing" or "Billed") |
| 810 Invoice | All Sales Orders have been invoiced ("Billed") |
Handling Cancelled or Closed Orders
If a Sales Order is Cancelled or Closed, the connector treats it as complete and won't wait for it. For example:
- An 850 PO creates 3 Sales Orders
- SO1 is cancelled, SO2 and SO3 are fulfilled and invoiced
- The connector will send the 856 and 810 with just SO2 and SO3 — it won't wait for SO1
Ensuring All Records Are Included
For 856 Ship Notice and 810 Invoice, the connector also verifies that all fulfillments or invoices are included before sending:
| Transaction Type | What must be included |
|---|---|
| 855 PO Acknowledgment | All approved Sales Orders |
| 856 Ship Notice | All Item Fulfillments from the related Sales Orders |
| 810 Invoice | All Invoices from the related Sales Orders |
This prevents partial shipments or invoices from being sent prematurely when you have multiple fulfillments or invoices being processed.
Configuration
Setting the Consolidation Method
- Navigate to the Customer record in NetSuite
- Go to the Orderful subtab
- Under EDI Enabled Transaction Types, find or create the entry for the transaction type (855, 856, or 810)
- Set the Consolidation Method field:
None- No consolidation (1:1 processing)Parent 850- Group by inbound POShip To- Group by shipping addressSales Order- Group by parent Sales Order
Which Method Should I Use?
| Scenario | Recommended Method |
|---|---|
| Simple setup, no multi-Ship-To, immediate processing | None |
| Partner wants one document per PO, regardless of splits | Parent 850 |
| Partner wants separate documents per shipping location | Ship To |
| Partner wants one document per SO, partial shipments combined | Sales Order |
Transaction Types That Support Consolidation
| Transaction Type | Consolidation Supported |
|---|---|
| 855 PO Acknowledgment | Yes |
| 856 Ship Notice | Yes |
| 810 Invoice | Yes |
| 880 Grocery Invoice | No (always Parent 850 behavior) |
| 940 Warehouse Shipping Order | No |
| 846 Inventory Advice | No |
Troubleshooting
Outbound transaction stuck in Pending
Symptoms: The Orderful Transaction record shows status "Pending" but the transaction is not being sent.
Check:
- Readiness gate: Verify all related Sales Orders have reached the required status. Navigate to the linked Sales Orders and check their status.
- Completeness gate: For 856 and 810, verify all downstream records exist and are linked. Check the Orderful Transaction's related records list.
- Auto-send disabled: Verify the Enabled Transaction Type has "Auto Send" checked.
Missing records in consolidated envelope
Symptoms: The outbound 856 or 810 is missing some expected records.
Check:
- Records may still be processing in a later batch. The scheduled script processes up to 500 records per run.
- Check if the missing records have a different Ship-To address (Ship To consolidation) or parent SO (Sales Order consolidation).
- Verify the missing records are linked to the same inbound 850.
Cancelled SO blocking outbound
Symptoms: Outbound transaction won't send because a related SO was cancelled.
Resolution: As of version 1.20.81, Cancelled and Closed SOs are treated as terminal statuses and will not block outbound transactions. Ensure you're running the latest connector version.
Updated about 5 hours ago
