Manufacturing · Plumbing, Water, HVAC and Appliances
EDI and API Integration for Water Heater and Boiler Manufacturers
Water heater and boiler makers sell heavy, serialized equipment through plumbing wholesalers, home centers and contractors, with warranty and replacement as a routine flow. ECOM connects orders, serial-number shipments, freight and returns to your ERP.
What this covers
Products and business models in water heater and boiler
Products
- Tank and tankless water heaters
- Residential and commercial boilers
- Heat pump water heaters
- Parts, venting and accessories
Business models
- Manufacturers selling to wholesalers and home centers
- Contractor replacement market
- Commercial and multifamily programs
Scenarios
Where water heater and boiler manufacturers lose time and margin
Recurring problems for this kind of business, how ECOM connects the systems and documents involved, and what you gain. Bring your own example and we will work through it with you.
-
Emergency replacement
- The problem
- A failed water heater is replaced the same day, so wholesale orders are urgent.
- How ECOM helps
- ECOM posts urgent replacement orders as they arrive and can flag an order with no 855 by a configured cutoff.
- What you gain
- Same-day replacement orders are answered inside the wholesaler’s window.
Talk to an EDI/API Expert about emergency replacement Share a sample 850 Purchase Order and 855 Purchase Order Acknowledgment, or describe what goes wrong, and we will show how it would map to your ERP.
-
Serial numbers and warranty
- The problem
- Serial numbers tie a unit to warranty and service records.
- How ECOM helps
- ECOM carries serial numbers onto the 856 and can hold a unit with no serial for review.
- What you gain
- Warranty and service records link to the serial on the notice.
Talk to an EDI/API Expert about serial numbers and warranty Share a sample 856 Advance Ship Notice, or describe what goes wrong, and we will show how it would map to your ERP.
-
Heavy freight and delivery
- The problem
- Units are heavy and ship from regional distribution points.
- How ECOM helps
- ECOM connects warehouse and carrier documents for regional distribution points.
- What you gain
- Heavy units ship from the closest stock with status in one view.
Talk to an EDI/API Expert about heavy freight and delivery Share a sample 940 Warehouse Shipping Order, 945 Warehouse Shipping Advice and 204 Motor Carrier Load Tender, or describe what goes wrong, and we will show how it would map to your ERP.
Who you connect with
Trading relationships for water heater and boiler manufacturers
Typical relationships. Which of them apply, and how each one wants to connect, depends on your business.
- Plumbing wholesalers
- Order for contractors and emergency replacement, often for same-day pickup or delivery.
- Home centers
- Stock replacement units and replenish by program.
- Builders and multifamily developers
- Order for developments in phases.
- Tank, burner and control suppliers
- Supply components whose lead times affect build schedules.
- Carriers and local delivery partners
- Deliver heavy units from regional distribution points.
Partner guides: Distributor guides · Retailer guides · Carrier guides
Typical workflow
Where ECOM connects your systems and trading partners
The pattern below is typical for water heater and boiler manufacturers, not one partner's confirmed requirements. Each trading partner publishes its own guide; confirm the details with that partner.
- Wholesaler or home center→Your plant and ERP 850 Purchase Order The customer order: items, quantities, prices, ship-to and requested dates.
- Wholesaler or home center→Your plant and ERP 860 Purchase Order Change Request Changes to open orders: quantities, dates or cancellations.
- Your plant and ERP→Wholesaler or home center 855 Purchase Order Acknowledgment The order acknowledgment: confirms the order or reports differences from what was requested, including dates.
- Your plant and ERP→Carrier or 3PL 940 Warehouse Shipping Order Tells the warehouse or 3PL what to pick and ship.
- Carrier or 3PL→Your plant and ERP 945 Warehouse Shipping Advice Confirms what the warehouse actually shipped.
- Your plant and ERP→Carrier or 3PL 204 Motor Carrier Load Tender Tenders a truck shipment to a motor carrier.
- Carrier or 3PL→Your plant and ERP 990 Response to a Load Tender The motor carrier’s acceptance or decline of the tender.
- Your plant and ERP→Wholesaler or home center 856 Advance Ship Notice Unit and serial detail where the customer asks.
- Your plant and ERP→Wholesaler or home center 810 Invoice Bills for what was shipped, tied to the order and the ship notice.
- Wholesaler or home center→Your plant and ERP 180 Return Merchandise Authorization and Notification Authorizations for returned or replaced units.
- Your plant and ERP→Wholesaler or home center 846 Inventory Inquiry/Advice Inventory availability for emergency replacement.
Urgent and stock orders
Orders (850) and changes (860).
Ship fast
Release to the warehouse (940/945) or tender (204/990).
Ship notice with serials
The 856 reports units and serial numbers where asked.
Invoice
The 810 follows.
Returns and warranty
Return authorizations (180) cover defects and returns.
EDI and API exchanges
The documents behind the workflow
X12 transaction sets typical for this workflow, with what each carries here. Select a code for the full transaction reference.
| Document | Direction | What it carries for water heater and boiler manufacturers |
|---|---|---|
| 850 Purchase Order | You receive | The customer order: items, quantities, prices, ship-to and requested dates. |
| 860 Purchase Order Change Request | You receive | Changes to open orders: quantities, dates or cancellations. |
| 855 Purchase Order Acknowledgment | You send | The order acknowledgment: confirms the order or reports differences from what was requested, including dates. |
| 940 Warehouse Shipping Order | You send | Tells the warehouse or 3PL what to pick and ship. |
| 945 Warehouse Shipping Advice | You receive | Confirms what the warehouse actually shipped. |
| 204 Motor Carrier Load Tender | You send | Tenders a truck shipment to a motor carrier. |
| 990 Response to a Load Tender | You receive | The motor carrier’s acceptance or decline of the tender. |
| 856 Advance Ship Notice | You send | Unit and serial detail where the customer asks. |
| 810 Invoice | You send | Bills for what was shipped, tied to the order and the ship notice. |
| 180 Return Merchandise Authorization and Notification | You receive | Authorizations for returned or replaced units. |
| 846 Inventory Inquiry/Advice | You send | Inventory availability for emergency replacement. |
Other exchanges you may meet
- Wholesaler portals
- Registration systems outside the integration
Where a trading partner offers an API, a portal or file exchange instead of EDI, ECOM scopes that connection alongside the EDI ones. Functional acknowledgments (997 or 999) report validation results, including rejection; they do not prove business acceptance or ERP posting. Which acknowledgments and business responses each partner expects is confirmed with that partner.
Operational detail
Serials, warranty and urgency
A failed water heater is replaced the same day, so fast order acknowledgment and shipment confirmation matter. Serial numbers on the shipment connect to warranty claims later, and regional distribution points mean inventory advice must reflect what each can ship.
Serial and model numbers
Appliances and equipment are tracked by model and serial number. Where a customer or warranty process needs them, they travel with the shipment data.
Warranty-related exchanges and returns
Returns, replacements and warranty claims create documents and adjustments that follow the original sale.
Distributor and contractor channels
Plumbing, HVAC and appliance products reach contractors through wholesale distributors, retailers and builders, each with its own order and item data.
Connected systems
Systems that send and receive this data
Documents are only useful when they reach the systems that run the business.
- ERP
- Warehouse management with serial capture
- Transportation management
- Warranty systems
ERP integration guides: SAP S/4HANA · Oracle NetSuite · Microsoft Dynamics 365 Business Central · Infor CloudSuite Industrial (SyteLine) · Epicor Prophet 21 · QAD MFG PRO · All ERP guides
Onboarding and monitoring
From first requirement to daily exception handling
Confirm the requirement
Obtain each partner's implementation guide or specification, for example from your wholesaler or home center, and agree which documents, versions and data are in scope.
Map to your systems
Map each document to the fields in your ERP and warehouse management with serial capture so the data posts without re-keying.
Test with the partner
Exchange test documents and review the results with the partner before go-live, including changes, cancellations and error cases, not only the simple order.
Validate, acknowledge and monitor
A 997 or 999 reports the validation result of the document as received, including rejection; it does not show that the business accepted the content or that your ERP posted it. Business responses are separate: an 855 for orders, an 824 for application errors. Monitoring can show what is late, missing or rejected, once it is set up with you.
Resolve exceptions
Which failures and late documents are watched, who is alerted and how each is resolved are agreed during onboarding. Rejected or unacknowledged documents can then go to the people who can fix them, with the document and the reason in view.
Example exceptions for water heater and boiler manufacturers
| Exception | Example handling, once configured |
|---|---|
| Serial missing on a shipped unit | A required-field check can hold the shipment for review before the notice is sent. |
| Urgent order not acknowledged | An urgent order with no 855 by a configured cutoff can be flagged. |
Illustrative examples of exceptions a team in this industry may need to review. Each check compares data from your ERP, WMS, trading partner documents or scans, where those are available. Which conditions are checked, who is alerted and what happens next are configured with you during onboarding. This is not a screenshot of a live system or a list of built-in checks.
How ECOM helps
ECOM products and services that apply
Each partner connects in the way it can support. These products cover the connections and visibility manufacturers need most.
-
PRISM-EDI
Exchange of schedules, orders, ship notices and invoices with customers and suppliers in X12 or EDIFACT, translated to and from your ERP.
-
PRISM-WebEDI
Browser-based purchase orders, acknowledgments, ship notices and invoices for suppliers without EDI systems.
-
PRISM-SmartConvert
Supplier confirmations, invoices and customer orders that arrive as PDFs, emails or scans converted into ERP-ready data.
-
PRISM-SCV
Monitoring of transactions and exceptions across customer and supplier documents.
Services: Trading partner onboarding · ERP integration · API integration · Fully managed EDI · Supply chain visibility · Mapping and translation
Frequently asked questions
Can serial numbers be sent to wholesalers?
Where the wholesaler asks and your warehouse system captures them, yes. They are mapped into the ship notice so the wholesaler’s receiving record matches your shipment.
Does ECOM manage warranty claims?
No. Warranty processes stay in your service systems. The integration exchanges the underlying orders, shipments and return authorizations.
Do you need our trading partner's implementation guide to start?
It helps, but you can start without one. Tell us who you trade with and which systems you run, and we will help obtain and review each partner's requirements. The guide, not this page, decides the exact documents, versions and rules for that partner.
Talk to an EDI/API expert about water heater and boiler manufacturers
Share your trading partners, your ERP, a sample document or the problem that keeps recurring. A completed specification is not needed: a partner guide, a rejected document or a description of the issue is enough to start.