Integration FAQs
Everything you need to know about integrating eveXso with your ERP system
Getting Started
How do I start integrating with eveXso?
Start with our Quick Start Guide which walks through the complete integration process step-by-step. You'll need API credentials (provided during onboarding), access to our API Playground for testing, and our Postman collection with all 72+ endpoints. Most developers make their first successful API call within 30 minutes.
What are the prerequisites for integration?
You need: a development environment with HTTP/REST capabilities, API credentials from eveXso (client_id and client_secret), basic understanding of REST APIs and JSON, and access to your ERP system's data structure. No special libraries or SDKs required.
Is there a sandbox environment for testing?
Yes, all eveXso accounts include a test environment where you can safely test integrations without affecting production data. The test environment mirrors production functionality and includes sample data for testing.
How long does a typical integration take?
Integration timelines vary: Simple integration (orders and inventory): 1-2 weeks, Standard integration (customers, suppliers, locations): 2-4 weeks, Complex integration (production, custom workflows): 4-8 weeks. Self-integrators typically complete in 2-4 weeks.
Authentication & Security
How does authentication work?
eveXso uses OAuth 2.0 client credentials flow. You exchange your client_id and client_secret for an access token, which is then used in the Authorization header for all API requests. Tokens expire after 24 hours and must be refreshed.
How do I get API credentials?
API credentials are provided during your eveXso onboarding. You'll receive a client_id and client_secret for both test and production environments. Keep these secure and never commit them to source control.
Is the API secure?
Yes, all API communication uses HTTPS/TLS 1.2+, OAuth 2.0 authentication, IP whitelisting (optional), request rate limiting, and comprehensive audit logging. We follow industry best practices for API security.
What are the rate limits?
Standard rate limits are 1000 requests per minute per client. Bulk operations (e.g., inventory imports) have higher limits. If you need higher limits for specific use cases, contact support.
Data Synchronization
How do I sync inventory from my ERP to eveXso?
Use the inventory/add or inventory/check endpoints. Send inventory items with item_code, description, and optional fields like stocking_factor, warehouse_info, dangerous_goods. The check endpoint validates data before committing. Sync frequency is typically every 15-60 minutes.
How do I import sales orders?
Use the sales_order/add endpoint. Include customer details, line items, and delivery information. eveXso will validate the order, allocate inventory, and make it available for picking. Orders can be imported in real-time or batched.
How do I get updates back to my ERP?
Two methods: Polling - use erp_update/outgoing_consignment, erp_update/incoming_consignment, erp_update/move_attempt endpoints to retrieve updates every 5-15 minutes. Webhooks - configure real-time webhooks to receive instant notifications of shipments, receipts, and inventory movements.
What happens if the same data is sent twice?
eveXso handles idempotency intelligently. For inventory and customers, duplicate data updates existing records. For orders, duplicate order_number will be rejected. Use the check endpoints to validate before committing.
How do I handle inventory reconciliation?
Use the comparison endpoints: 1) Create comparison with comparison/add, 2) Send ERP inventory with comparison_erp_on_hand/add, 3) Set eveXso inventory with comparison_evexso_on_hand/set, 4) Add adjustments with comparison_adjustment_item/add, 5) Process with comparison_item/process, 6) Complete with comparison/complete. This creates adjustment transactions for discrepancies.
Specific Integrations
How do I integrate with MYOB Acumatica?
We provide a pre-built AWS Lambda connector for Acumatica that handles authentication, data mapping, and error handling. The connector syncs customers, inventory, sales orders, purchase orders, and shipments. Implementation typically takes 2-3 weeks. View our Acumatica integration guide for details.
How do I integrate with MYOB EXO?
We provide a pre-built connector for MYOB EXO that syncs via EXO's REST API. The connector handles stock items, customers, sales orders, purchase orders, and goods receipts. Implementation typically takes 2-3 weeks. View our MYOB EXO integration guide for details.
Can I integrate with Microsoft Dynamics 365 Business Central?
Yes, customers have successfully integrated with Business Central using our REST API. The integration syncs items, customers, sales orders, purchase orders, and shipments. Implementation typically takes 3-4 weeks. Contact us for Business Central integration examples.
Can I integrate with legacy systems like AS400?
Yes, customers have successfully integrated with AS400/IBM i systems. The integration typically uses DB2 database queries or AS400 APIs to extract data, transform it, and send to eveXso's REST API. D'Osogna Foods successfully integrated their AS400 system with eveXso.
Do you support NetSuite, SAP, or other ERPs?
Yes, our API-first design means any system that can make HTTP requests can integrate with eveXso. Customers have integrated with NetSuite, SAP Business One, Sage, Odoo, and custom systems. We provide API documentation and support for all integrations.
Troubleshooting
What if I get a 401 Unauthorized error?
This means your access token is invalid or expired. Ensure you're using the correct client_id and client_secret, refresh your access token (they expire after 24 hours), and check that you're using the correct environment (test vs production).
What if I get a 400 Bad Request error?
This means the request data is invalid. Check the error message for specific field validation errors, ensure required fields are included, verify data types match the API specification, and use the check endpoints to validate data before committing.
How do I debug integration issues?
Use the API Playground to test endpoints interactively, check the API response messages for specific error details, review the audit log in eveXso for request history, enable verbose logging in your integration code, and contact support with specific request/response examples.
Where can I get help with my integration?
Multiple support channels available: API documentation and Quick Start Guide, interactive API Playground for testing, Postman collection with examples, email support (support@evexso.com), live chat during business hours, and partner network for implementation assistance.
Advanced Topics
Can I customize the integration workflow?
Yes, eveXso supports event-driven scripts that can trigger custom logic during integration events. You can write JavaScript functions that execute on order import, inventory updates, shipment creation, and more. This allows complex business rules and data transformations.
How do I handle multi-warehouse scenarios?
Each warehouse in eveXso has a unique warehouse_code. When syncing inventory, specify the warehouse_code for each item. Orders can be assigned to specific warehouses, and the API supports inter-warehouse transfers.
Can I integrate with multiple ERPs?
Yes, eveXso can receive data from multiple source systems simultaneously. Each integration can use separate API credentials, and data is merged based on unique identifiers (item_code, customer_code, order_number).
How do I handle custom fields from my ERP?
eveXso supports custom fields through the custom_fields JSON object on most entities. You can store any additional data from your ERP in custom_fields, and it will be preserved and returned in API responses.
Ready to Start Integrating?
Our API-first design makes integration straightforward. Get started today.