Retail Express by Maropost is a cloud-based retail management platform providing point-of-sale, inventory, customer, and order management for multi-store and omnichannel retailers. Its REST API exposes retail data such as orders, customers, products, purchase orders, and credit notes. This connector lets Nexla ingest data from the Retail Express API for analytics, reporting, and integration with your other systems.
Power end-to-end data operations for your Retail Express by Maropost API with Nexla. Our bi-directional Retail Express by Maropost connector is purpose-built for Retail Express by Maropost, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to Retail Express by Maropost or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Retail Express by Maropost workflows fast, secure, and fully governed.
Features
Type: API
SourceDestination
Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
Request optimization with intelligent batching, retry, and caching to minimize API calls and costs
Before creating a Retail Express by Maropost credential, you need an API key for your Retail Express account. Retail Express authenticates API requests using an API key that is sent in the x-api-key request header.
To generate an API key:
Sign in to your Retail Express account with an administrator user.
Navigate to Settings > Integrations > API Management.
Enter a descriptive name in the API Key Name field, then click Generate Keys.
Copy either the Primary Key or the Secondary Key. Both keys are functionally identical, so either one can be used.
Store the key securely — you will need it when configuring your Nexla credential.
The API key is sensitive and grants access to your Retail Express data, so keep it confidential. If a key is compromised, regenerate it from the same API Management screen. For more detail on the API and authentication, see the Retail Express Developer Portal.
After selecting the data source type, click the Add Credential tile to open the Add New Credential overlay.
Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.
Enter your Retail Express by Maropost API key in the API Key field. This key is sent in the x-api-key header to authenticate all API requests.
The API key grants access to your Retail Express data and should be treated as sensitive information. If it is compromised, regenerate it from Settings > Integrations > API Management in your Retail Express account.
Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source creation.
To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the Retail Express by Maropost connector tile, then select the credential that will be used to connect to Retail Express, and click Next; or, create a new Retail Express by Maropost credential for use in this flow.
Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common Retail Express by Maropost endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below.
[Rest API] List Price Groups Fixed
Retrieve fixed price groups from Retail Express. Use this template to ingest fixed pricing configuration for analysis or integration.
This endpoint returns paginated results. Nexla automatically follows pagination to retrieve all available records.
[Rest API] List Price Groups Standard
Retrieve standard price groups from Retail Express. Use this template to ingest standard pricing configuration for analysis or integration.
This endpoint returns paginated results. Nexla automatically follows pagination to retrieve all available records.
[Rest API] List Users
Retrieve users from your Retail Express account. Use this template to ingest user records for analysis or integration.
This endpoint returns paginated results. Nexla automatically follows pagination to retrieve all available records.
[Rest API] List Orders
Retrieve orders from Retail Express. Use this template to ingest order records for sales analysis, reporting, or integration.
This endpoint returns paginated results. Nexla automatically follows pagination to retrieve all available records.
[Rest API] List Order Items
Retrieve the order items for a specific order. Use this template to ingest line-item detail for a given order.
This endpoint requires an Order ID parameter identifying the parent order whose items are retrieved.
This endpoint returns paginated results. Nexla automatically follows pagination to retrieve all available records.
[Rest API] List Order Fulfilments
Retrieve order fulfilments from Retail Express. Use this template to ingest fulfilment records for analysis or integration.
This endpoint returns paginated results. Nexla automatically follows pagination to retrieve all available records.
[Rest API] List Order Payments
Retrieve order payments from Retail Express. Use this template to ingest payment records associated with orders for analysis or integration.
This endpoint returns paginated results. Nexla automatically follows pagination to retrieve all available records.
[Rest API] List Purchase Orders
Retrieve purchase orders from Retail Express. Use this template to ingest purchase order records for procurement analysis or integration.
This endpoint returns paginated results. Nexla automatically follows pagination to retrieve all available records.
[Rest API] List Purchase Order Items
Retrieve the items for a specific purchase order. Use this template to ingest line-item detail for a given purchase order.
This endpoint requires a Purchase Order ID parameter identifying the parent purchase order whose items are retrieved.
This endpoint returns paginated results. Nexla automatically follows pagination to retrieve all available records.
[Rest API] List Supplier Invoices
Retrieve supplier invoices from Retail Express. Use this template to ingest supplier invoice records for analysis or integration.
This endpoint returns paginated results. Nexla automatically follows pagination to retrieve all available records.
[Rest API] List Product Prices
Retrieve product prices from Retail Express. Use this template to ingest product pricing records for analysis or integration.
This endpoint returns paginated results. Nexla automatically follows pagination to retrieve all available records.
[Rest API] List Customer Logs
Retrieve customer logs from Retail Express. Use this template to ingest customer activity log records for analysis or integration.
This endpoint returns paginated results. Nexla automatically follows pagination to retrieve all available records.
[Rest API] List Customers
Retrieve customers from Retail Express. Use this template to ingest customer records for analysis, segmentation, or integration.
This endpoint returns paginated results. Nexla automatically follows pagination to retrieve all available records.
[Rest API] List Customer Delivery Addresses
Retrieve the delivery addresses for a specific customer. Use this template to ingest delivery address detail for a given customer.
This endpoint requires a Customer ID parameter identifying the parent customer whose delivery addresses are retrieved.
This endpoint returns paginated results. Nexla automatically follows pagination to retrieve all available records.
[Rest API] List Customer Types
Retrieve customer types from Retail Express. Use this template to ingest customer type configuration for analysis or integration.
This endpoint returns paginated results. Nexla automatically follows pagination to retrieve all available records.
[Rest API] List Customer Survey Segments
Retrieve customer survey segments from Retail Express. Use this template to ingest survey segment records for analysis or integration.
This endpoint returns paginated results. Nexla automatically follows pagination to retrieve all available records.
[Rest API] List Countries
Retrieve the list of countries from Retail Express. Use this template to ingest country reference data for analysis or integration.
This endpoint returns paginated results. Nexla automatically follows pagination to retrieve all available records.
[Rest API] List Credit Notes
Retrieve credit notes from Retail Express. Use this template to ingest credit note records for analysis, reconciliation, or integration.
This endpoint returns paginated results. Nexla automatically follows pagination to retrieve all available records.
[Rest API] List Credit Note Items
Retrieve the items for a specific credit note. Use this template to ingest line-item detail for a given credit note.
This endpoint requires a Credit Note ID parameter identifying the parent credit note whose items are retrieved.
This endpoint returns paginated results. Nexla automatically follows pagination to retrieve all available records.
[Rest API] List Currencies
Retrieve the list of currencies from Retail Express. Use this template to ingest currency reference data for analysis or integration.
This endpoint returns paginated results. Nexla automatically follows pagination to retrieve all available records.
Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.
Retail Express by Maropost data sources can also be manually configured to ingest data from any valid Retail Express API endpoint, including endpoints not covered by the pre-built templates, chained API calls, or custom request parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.
Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new Retail Express by Maropost data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.
