This page explains how to set up order integrations in Norce Commerce. Order integration enables automated order processing by sending order data from Norce Commerce to external business systems, such as ERPs, using webhooks.
Order integration in Norce Commerce allows you to automatically transfer order information to your external systems. This is achieved by configuring a webhook that pushes complete order data, including payment details, to your receiving service whenever an order is placed.
Before configuring order integration, ensure you have completed the following steps:
- Extended the basket and order models if your business requires additional order information.
- Set up freight and payment methods in your Norce Commerce environment.
Before starting the integration setup, gather the following information and make key decisions:
- Order Data Requirements: Identify any additional order information your external system (e.g., ERP) needs.
- Order Workflow: Define how the order process should work, including any custom business logic.
- ERP Integration Needs: Determine what order details must be sent to your ERP or other external systems.
Follow these steps to configure order integration in Norce Commerce:
In your client settings, specify the following for the order integration endpoint:
- Endpoint Type: Select the appropriate type for your integration.
- Content Type: Choose the data format (e.g., JSON).
- Target URL: Enter the URL of your order receiver service.
- Authentication: Optionally, provide basic authentication credentials if required by your receiver.
Develop and deploy a service that can receive and process order data from Norce Commerce. For detailed instructions, see the Building an Order Receiver Service guide.
Order integration in Norce Commerce works as a webhook. When an order is placed, Norce Commerce pushes the complete order data to your configured receiving service. This is currently the primary method to retrieve all order details, including payment information.
After the initial setup, you may need to:
- Extend the order model to include custom fields required by your business or ERP.
- Adjust the integration endpoint settings if your receiver service changes.
- Test the integration to ensure orders are received and processed correctly.