.png)
Epicor Kinetic Integration Guide
Integrate Epicor Kinetic with enterprise applications through REST/OData business object APIs, scheduled workflows, and tenant-specific outbound event mechanisms.
Epicor Kinetic integration options at a glance
Epicor Kinetic primarily integrates through REST APIs and OData-based query endpoints associated with business objects such as Customers, Parts, Suppliers, Sales Orders, Purchase Orders, and Jobs. Martini can consume these APIs, expose endpoints for upstream applications, and orchestrate mappings, validations, business rules, and retries. Webhook-style callbacks or event processing may be available through tenant-specific business processes, Epicor Functions, or other configured mechanisms, but universal coverage is not confirmed. Large-volume synchronization can use filtered and paginated queries, BAQs, service-specific operations, and incremental timestamps. OAuth 2.0, API credentials, and legacy Basic Authentication may be available depending on deployment.
Common Epicor Kinetic integration patterns
Common Epicor Kinetic data objects used in integrations
Authentication and security considerations
Deployment-specific authentication
Epicor Kinetic authentication varies by tenant, release, and deployment model. OAuth 2.0, API keys or application credentials, and legacy Basic Authentication may be encountered. Confirm the exact grant, scopes, token endpoint, and credential requirements with the Epicor administrator.
Authorization and context
API access is governed by Epicor users, security groups, company access, plant access, and business object permissions. Workflows should make tenant, company, plant, and warehouse context explicit rather than relying on a global identifier.
Secure transport and secrets
- Use HTTPS for all external API communication.
- Store tokens, keys, and service credentials in secure Martini environment configuration.
- Use least-privilege Epicor permissions for each integration.
- Review permissions after tenant configuration or business object changes.
Operational considerations for Epicor Kinetic integrations
Throughput and pagination
Use server-side filters, field selection, pagination, bounded concurrency, and incremental checkpoints. Do not assume a universal bulk, asynchronous, or OData batch capability across all business objects.
Idempotency and retries
Store external identifiers and correlation keys for Customers, Parts, Orders, Suppliers, and other synchronized objects. Retry transient transport or service failures with backoff, but route validation, authorization, duplicate, and business-rule errors for correction or reconciliation.
Schema and tenant changes
API methods, custom fields, BAQs, BPM rules, and required fields may differ between releases and tenants. Test integrations after upgrades and major configuration changes, and inspect the target tenant's service metadata where possible.
Manufacturing and document data
Manufacturing flows should preserve revisions, operations, materials, resources, plants, and job status. Attachment operations may require separate metadata and binary-content calls, with object-specific limits and storage rules.
Why use Martini instead of scripts or point-to-point integrations?
Reusable orchestration
Martini separates Epicor API consumption, API exposure, transformation, validation, business rules, and target-system writes into maintainable workflows rather than isolated scripts.
Reliable synchronization
Scheduled triggers, callback endpoints, pagination, checkpoints, correlation identifiers, retry handling, and structured errors support reliable synchronization across Epicor and surrounding applications.
Controlled change management
Secure environment configuration keeps tenant-specific credentials and endpoints outside workflow logic. Reusable mappings and services make it easier to accommodate company, plant, release, and schema differences.
Standards-based integration
Martini can consume REST/OData and, where required, SOAP services, while exposing controlled APIs for other applications. This avoids direct transactional database writes that could bypass Epicor validation and business rules.