.png)
Epicor Eclipse Integration Guide
Epicor Eclipse integrates with enterprise systems primarily through deployment-specific REST APIs, supported authentication services, scheduled workflows, and customer-configured exchange mechanisms.
Epicor Eclipse integration options at a glance
Epicor positions REST APIs as an integration mechanism across its ERP portfolio, although the resources, operations, authentication scheme, and write support available in a particular Eclipse deployment must be verified. Martini can consume exposed Eclipse REST APIs, authenticate through the configured gateway or integration service, and orchestrate workflows for Customers, Vendors, Products, Inventory, Sales Orders, Purchase Orders, and Invoices. Scheduled workflows can support incremental synchronization where reliable change markers exist. Webhooks, outbound callbacks, bulk services, file exchange, EDI, and database access should be treated as deployment-specific rather than assumed capabilities. Martini can also expose a controlled API façade for downstream applications.
Common Epicor Eclipse integration patterns
Common Epicor Eclipse data objects used in integrations
Authentication and security considerations
Deployment-specific authentication
Eclipse authentication may be configured through an API gateway or integration service using credentials, keys, or another environment-specific mechanism. OAuth 2.0, JWT, and scopes should not be assumed without confirmation from the target deployment.
Credential protection
- Use HTTPS for API communication.
- Store credentials, keys, or tokens in environment-specific Martini secrets.
- Use a dedicated integration identity with only the permissions required for the workflow.
- Do not place credentials in payloads, mappings, source-controlled scripts, or hard-coded workflow values.
Authorization
Confirm resource-level permissions, read and write access, and whether Eclipse roles, service accounts, or gateway policies govern each operation.
Operational considerations for Epicor Eclipse integrations
API variability
Eclipse installations can differ by version, hosting model, enabled services, customizations, and API exposure. Confirm base URLs, resources, operations, custom fields, pagination, filtering, and write behavior before implementation.
Volume and synchronization
- Use pagination and bounded extraction windows for Products, Inventory, Customers, and Invoices.
- Prefer reliable modified-since values, sequence markers, or checkpoints for incremental synchronization.
- Use controlled batch workflows for large historical migrations.
- Limit concurrency and honor HTTP 429 or vendor-specific throttling responses.
Reliability and data integrity
- Use idempotency keys and source identifiers for Sales Orders and Invoices.
- Reconcile ambiguous responses before retrying writes.
- Separate validation and business-rule failures from transient transport errors.
- Preserve currency precision, tax treatment, units of measure, warehouse identifiers, time zones, and document statuses.
Testing and change management
Test against representative Eclipse data and customer-specific customizations. Version mappings, validate optional fields, monitor schema changes, and verify that API acceptance does not necessarily indicate order release or fulfillment.
Database caution
Direct database access should not be the default transactional strategy. Consider read-only reporting or reconciliation access only when explicitly authorized and compatible with support and upgrade requirements.
Why use Martini instead of scripts or point-to-point integrations?
Centralized orchestration
Martini coordinates Eclipse API calls, validation, enrichment, target writes, status handling, and exception routing in workflows rather than scattering logic across scripts or point-to-point integrations.
Reusable transformation logic
Mappings and reusable workflow assets can normalize Eclipse Customers, Products, Inventory, orders, purchasing data, and Invoices for multiple downstream applications while preserving source identifiers.
Operational resilience
Martini provides a structured place to implement checkpoints, idempotency, controlled retries, throttling, validation, logging, and reconciliation for deployment-specific Eclipse behavior.
Stable API boundaries
Martini can expose controlled REST APIs that shield downstream applications from Eclipse-specific schemas and customizations, allowing enterprise consumers to use a consistent contract.
Maintainable enterprise integration
Compared with isolated scripts, workflow-based integration makes authentication, business rules, transformations, monitoring, and error handling easier to govern and update as the Eclipse environment changes.