Epicor Eclipse + private AI
AI for Epicor Eclipse, Without Sending Distributor Data Off-Site
Short answer
Adding AI to Epicor Eclipse means grounding a private, on-prem model on your Eclipse SQL Server database (order entry, item master, rebates, warehouse) so counter staff, sales, and finance can ask questions in plain English and get answers with the underlying query shown. It works alongside your existing Eclipse reporting and EDI setup and runs on hardware you control, so pricing, rebate agreements, and customer data never leave your network.
- ERP
- Epicor Eclipse
- Industries
- Distribution, Electrical, Plumbing, HVAC, PVF
- Written for
- Operations Manager
Epicor Eclipse runs the back office for thousands of electrical, plumbing, HVAC, and PVF distributors, and it does the job well: order entry, purchasing, warehouse management, rebates and chargebacks, and counter sales all live in one system built around how distribution actually works. The gap is not functionality. It is that answering an ad hoc question, whether it is a will-call counter clerk checking a substitute item or a branch manager asking why margin dropped on a product line, still means someone navigating Eclipse screens or waiting on a report from IT.
That gap gets worse as branch count grows. A regional distributor with a dozen locations has a handful of people who really know how to pull a rebate report, reconcile a vendor chargeback claim, or explain a price matrix override, and everyone else routes questions to them. When those people are out, the business slows down. Meanwhile counter and inside sales turnover means new hires spend months learning item cross-references and substitute logic that live only in tribal knowledge and Eclipse screens.
A private AI layer on top of Eclipse changes that without changing Eclipse. It reads from your existing database (typically a read-only replica so it never competes with production transactions), understands your item master, price matrices, rebate agreements, and warehouse structure, and lets any authorized employee ask a question in plain English. The model shows the query it ran, so answers are checkable rather than a black box, and it respects the same role-based access your Eclipse users already have.
This page covers what that looks like in practice: the specific pain points Eclipse shops run into, seven concrete use cases with the Eclipse objects they touch, the deployment architecture, and the honest trade-offs between running this on-prem, in a private cloud, or hybrid.
What usually gets in the way
The problems we hear most from operations manager teams running Epicor Eclipse.
Rebate and chargeback reconciliation is a spreadsheet exercise
Vendor rebate agreements and chargeback claims live partly in Eclipse and partly in spreadsheets. Reconciling actual purchase volumes against agreement tiers at quarter close is manual, slow, and error-prone, and the people who know how to do it correctly are few.
Counter and will-call staff can't get a fast answer
A customer on the phone asking about stock, a substitute item, or a customer-specific price forces counter staff to flip between item master, price matrix, and inventory screens. Every extra second on hold is a customer experience problem.
Ad hoc reporting waits on IT or a consultant
Eclipse Data Analytics and the report writer answer known, recurring questions well. A new question from a branch manager, such as slow-movers by category this quarter, usually means a ticket and a multi-day wait.
New hires take months to learn item cross-references
Electrical, plumbing, and PVF distributors carry tens of thousands of SKUs with vendor-specific part numbers, substitutes, and customer-specific pricing. Ramping a new counter or inside sales rep on that knowledge takes far longer than the business would like.
EDI and vendor punch-out exceptions pile up
Routine EDI mismatches (a PO acknowledgment that does not match, an ASN discrepancy) sit in a queue that only one or two power users know how to triage, so exception handling becomes a bottleneck rather than a routine task.
Where AI earns its place in Epicor Eclipse
Each use case names the ERP objects it reads or writes, so your ERP team can judge the integration effort before anyone commits budget.
Natural-language order and inventory lookup for counter and inside sales
Counter and inside sales staff ask questions like which branches have a part in stock, what the customer's contract price is, or what the standard substitute is, and get an answer sourced directly from Eclipse.
Touches: Order entry, item master, warehouse/bin inventory, will-call queue, cross-reference tables
Outcome: Counter staff resolve availability and substitute questions in seconds instead of putting a caller on hold to check three screens.
Rebate and chargeback reconciliation copilot
An agent cross-references vendor rebate agreement terms against actual purchase volumes and chargeback claims, flagging discrepancies and drafting the reconciliation worksheet for review.
Touches: Vendor rebate agreements, purchase history, chargeback claims, vendor invoices
Outcome: Cuts manual rebate-claim prep from days to hours each quarter close.
Price matrix and contract pricing explainer
Sales reps and CSRs ask why a price landed where it did and get a plain-English breakdown of the matrix tier, contract override, or promotion that applied, with the underlying record shown.
Touches: Price matrices, customer contract pricing, cost book, promotions
Outcome: Reps get an instant, auditable explanation instead of escalating pricing questions to a manager.
EDI and vendor punch-out exception triage agent
Routine EDI order acknowledgment and ASN mismatches get summarized and, where the fix is standard, drafted for one-click approval rather than sitting untouched in a shared inbox.
Touches: EDI order/ASN/invoice transaction queues, vendor punch-out catalogs, PO matching records
Outcome: Routine EDI mismatches get resolved same-day instead of aging in a queue only one person knows how to work.
Warehouse and RF exception assistant
Warehouse staff get plain-English help resolving cycle count discrepancies, putaway exceptions, and short-pick situations without paging a supervisor for every mismatch.
Touches: Warehouse management, bin locations, cycle count records, pick/pack transactions
Outcome: Faster exception handling on the floor with fewer supervisor interruptions.
Branch performance and slow-mover reporting
Branch managers ask for a slow-mover list, an inventory turns comparison, or a margin trend by product line in plain English instead of waiting on a monthly report cycle.
Touches: Sales history, inventory turns, branch profitability extracts
Outcome: Branch managers get answers on demand instead of waiting for the next scheduled report.
New-hire onboarding assistant for item cross-references
New counter and inside sales staff ask the assistant questions about item cross-references, substitutes, and vendor part numbers while they learn the catalog, rather than interrupting a senior colleague.
Touches: Item master, cross-reference tables, vendor catalogs
Outcome: Cuts ramp time for counter and inside sales hires learning thousands of SKUs and substitutes.
Reference architecture
The architecture sits beside Eclipse rather than inside it: a read-only data layer keeps production order entry untouched, a semantic layer translates Eclipse's database structure into business terms (rebate, price matrix, will-call), and the model itself runs on hardware inside your network, whether that is a server room at headquarters or a private cloud instance you control.
- 1
Eclipse data connector
Read-only connection to a replicated copy of the Eclipse SQL Server database, refreshed on a schedule that fits your reporting cadence, so nothing touches live order entry transactions.
- 2
Semantic and data layer
Maps Eclipse tables, item cross-references, rebate agreements, and warehouse structures into business terms so the model reasons about rebates and price matrices, not raw column names.
- 3
Model serving
An open-weight model (Llama, Qwen, Mistral, or gpt-oss class) served with vLLM or Ollama on GPU hardware you own or control, sized for your branch count and concurrent user load.
- 4
Retrieval and agents
Retrieval-augmented generation grounds every answer in current Eclipse data and, for the rebate and EDI use cases, agents draft a recommendation with a human review step before anything writes back.
- 5
Governance and audit
Access mirrors your Eclipse security groups so a counter clerk and a controller see different answers to the same question, and every query and response is logged for audit.
Integration notes for your ERP team
- Connects to a replicated, read-only copy of the Eclipse SQL Server database rather than the live transactional instance, so query load never competes with order entry.
- Rebate agreement terms and chargeback claim data are typically the messiest part of the integration; expect a data-mapping pass before the reconciliation use case is reliable.
- EDI exception triage reads from the EDI translator's transaction log or staging tables alongside Eclipse PO and ASN records to explain a mismatch in context.
- Item cross-reference and substitute logic often lives partly in Eclipse and partly in vendor catalogs or spreadsheets maintained outside the system; those sources get folded into the semantic layer.
- A service account with least-privilege, read-only access covers the great majority of use cases; only the rebate and EDI drafting agents need a narrowly scoped write path, and only with human approval.
- Warehouse and RF use cases benefit from a near-real-time feed (minutes, not overnight) since cycle count and pick exceptions are time-sensitive.
- Existing Eclipse Data Analytics dashboards are not replaced; the AI layer answers the ad hoc questions those dashboards were never built to cover.
Deployment options
Air-gapped on-prem
Distributors whose IT already runs Eclipse on local SQL Server hardware and want the AI layer on the same footprint
Model, retrieval layer, and data connector all run on servers in your own data center or server room, with no external network dependency for day-to-day use.
Private or sovereign cloud
Multi-branch distributors that already run Eclipse infrastructure in a private or hosted cloud environment
The same architecture runs in a single-tenant cloud environment you control, useful when branches are geographically spread and a central private cloud is easier to operate than per-site hardware.
Hybrid
Distributors piloting AI at one branch or division before a company-wide rollout
Start with a replicated data feed from one branch or division, prove the rebate reconciliation or counter lookup use case, then extend the same architecture to additional branches.
Compliance and data control
How the architecture supports your obligations. Certification and accountability stay with your organisation; the design keeps the evidence straightforward.
PCI DSS
Card payment data at the counter stays entirely outside the AI layer's scope; the connector reads order, item, and rebate data only, never payment card fields.
Vendor rebate agreement confidentiality
Rebate terms are commercially sensitive; keeping the model and data on-prem or in a private cloud means those agreements never transit a third-party AI vendor.
State and local sales tax audit trails
The retrieval layer preserves the underlying Eclipse records behind every answer, so a tax audit can trace any AI-assisted summary back to source transactions.
Role-based access control
AI access mirrors existing Eclipse security groups rather than introducing a separate permission model, so a rebate answer available to finance is not available to a counter clerk.
Where Netray fits
ERPray
Fits the counter lookup, pricing explainer, and branch reporting use cases directly: grounded natural-language question answering over live Eclipse data, with the query shown.
Custom build
The rebate reconciliation and EDI exception agents need purpose-built logic tied to your specific vendor agreements and EDI trading partner setup, which goes beyond a generic Q&A layer.
How an engagement runs
Phase 1 . 2-3 weeks
Discovery
- -Inventory of Eclipse database structure, rebate agreement sources, and EDI queue setup
- -Prioritized use case list scored by branch impact and data readiness
- -Data access and replication plan that does not touch production Eclipse
- -Draft architecture sized to branch count and concurrent users
Phase 2 . 6-8 weeks
Pilot
- -Working natural-language lookup over item master, inventory, and pricing at one or two branches
- -Rebate reconciliation copilot tested against a real quarter close
- -Access control mapped to existing Eclipse security groups
- -Usage and accuracy review with branch and finance staff
Phase 3 . 4-6 weeks
Production
- -Company-wide rollout across all branches
- -EDI exception triage agent live with human approval step
- -Audit logging and query review process in place
- -Training materials for counter, inside sales, and finance staff
Phase 4 . Ongoing
Scale
- -Additional agents for warehouse exceptions and slow-mover reporting
- -Expanded model coverage as new question types are observed
- -Quarterly review of rebate and EDI agent accuracy against manual audits
- -Capacity planning as branch count or user load grows
Questions to ask any vendor, including us
A short list that separates real Epicor Eclipse AI work from a chatbot demo.
- Where does the model actually run, and does any distributor data leave our network at any point?
- Does the AI layer read from a replica or the live production database, and what is the refresh cadence?
- How are rebate agreement terms and chargeback claims kept confidential from a third-party AI vendor?
- What happens when the model is wrong about a price or a rebate figure? Is the underlying Eclipse record always shown?
- How does access control map to our existing Eclipse security groups, so a counter clerk cannot see finance-only data?
- Can we pilot at one branch before committing to a company-wide rollout?
- What is the total cost, including GPU hardware or private cloud, not just a software license?
- Who owns the model and the integration code if we ever want to bring it in-house or switch vendors?
Frequently asked questions
Can AI work with Epicor Eclipse without Epicor building it themselves?
Yes. Eclipse's SQL Server database can be read on a replicated, read-only basis, which is enough to ground a private AI layer without needing a native Epicor AI feature. This approach works today, independent of Epicor's own product roadmap, and keeps the data and the model under your control.
Does this replace Eclipse Data Analytics or the report writer?
No. Eclipse Data Analytics and the report writer remain the right tools for recurring, scheduled reports. The AI layer covers the ad hoc questions those tools were never built to answer quickly, such as a one-off slow-mover list or a rebate reconciliation check.
How does this help with vendor rebate reconciliation specifically?
The agent cross-references rebate agreement tiers against actual purchase volumes pulled from Eclipse and flags discrepancies before quarter close, drafting a reconciliation worksheet for a human to review. It does not replace the finance team's judgment, but it removes the manual line-by-line matching that eats days at close.
Is on-prem AI overkill for a mid-size distributor?
It depends on branch count and data sensitivity. A single-branch distributor may find a lighter, hosted private-cloud setup sufficient, while a multi-branch regional distributor with meaningful vendor rebate and customer contract data usually finds the control and predictable running cost of on-prem or private cloud worth the investment.
What does the pilot actually prove before we commit further?
A well-run pilot demonstrates accurate natural-language answers over live item, inventory, and pricing data at one or two branches, and a working rebate reconciliation pass against a real quarter close, so you can judge accuracy and time savings with real numbers before a company-wide rollout.
Can counter staff use this without IT involvement for every question?
Yes, that is the point. Once deployed, counter and inside sales staff ask questions directly through a chat interface without filing a ticket. IT stays involved for new agent types, access control changes, and periodic accuracy review, not for every day-to-day question.
How long before this pays for itself?
Most distributors see the clearest early payback in rebate reconciliation time savings and reduced EDI exception handling, both measurable within the first full quarter close after go-live. Counter and onboarding time savings compound over a longer horizon as new hires ramp faster.
Related guides
Natural Language Query for ERP Data: Ask SAP, Infor, or Oracle a Question in Plain English
See how natural language query over SAP, Infor, Oracle, and NetSuite data works: grounded text-to-SQL, role-based permissions, and a visible audit trail.
RAG + SQL + permissionsA Private LLM Grounded on Your ERP Data
How a private LLM answers questions on your ERP data: RAG plus text-to-SQL, role-based permissions inherited from the ERP, and where each fits.
Agents + approval gatesAI Agents for ERP, Running On-Prem
A practical guide to on-prem AI agents for ERP: what they can safely automate, where human approval belongs, and how to design the guardrails.
ERP AI Buyer GuideHow to Choose an ERP AI Implementation Partner
A CIO checklist for picking an ERP AI implementation partner: the architecture questions to ask, red flags, pricing models, and what to demand in the SOW.
ERP AI Cost GuideWhat ERP AI Actually Costs: A CFO's Guide
A CFO's guide to what ERP AI actually costs: GPU hardware, model licensing, integration and connector work, and realistic ongoing run-rate ranges.
Kinetic + private AIAI for Epicor Kinetic, Beyond What Prism Covers
Add AI to Epicor Kinetic beyond Prism: private LLM over BAQs, BPM data, and REST v2, on-prem or private cloud, with honest guidance on when Prism already covers you.
Plan it with numbers
Natural Language ERP Reporting Savings Calculator
Turn report volume, build time, and automation rate into the monthly hours and dollars saved by letting users ask ERP questions in plain English instead of building reports.
Free ToolERP AI Copilot ROI Calculator
Turn user count, query volume, and time saved per question into a monthly savings, license cost offset, and payback period for an ERP AI copilot.
Free ToolERP Data Quality for AI Assessment
Score item master, customer, vendor, and transaction data quality to find out whether your ERP is ready to ground an AI copilot, forecast, or chatbot.
GuideNatural Language ERP Query Interface
Query your ERP using natural language. Transform plain English questions into SQL/API calls with LLM-powered interfaces that democratize ERP data access.
GuideERP Copilots: Measuring Real User Productivity Gains
ERP copilots promise productivity, but what do users actually gain? Measured results, metrics that matter, and how to deploy copilots for SyteLine and LN.
GuideDistribution ERP Comparison: Top Platforms for Wholesalers
Compare distribution ERP platforms for wholesale and distribution. Infor M3, Epicor Prophet 21, SAP Business One, and NetSuite evaluated for distributors.
Talk it through with an engineer who knows Epicor Eclipse
Bring one real question your team cannot answer from the ERP today. We will map the data path, the model, and where it runs, and tell you honestly if AI is the wrong tool for it.