Skip to main content

Retail Express by Maropost

Availability
Available CoreAvailable StandardAvailable PlusAvailable ProAvailable Enterprise FlexAvailable PyAirbyte
Support Level
Marketplace
Connector Version
0.0.54 (last updated 11 days ago)
Data workers used
0.2 per sync (Learn more)
Definition ID
73c01e46-6b1d-434f-8f15-b9a0e67c8999

Retail Express by Maropost is an Australian retail point-of-sale, inventory management, fulfilment and multichannel ecommerce platform.

Getting Started​

Prerequisites​

You will need to create an API key before configuring this connector. Log into your Retail Express account and navigate to Settings→Integrations→Api Management, set an API Key Name and click Generate Keys, copy either the Primary Key or Secondary Key (both keys are functionally identical).

Performance Considerations​

Retail Express has restrictive API limits, it is strongly recommended to limit the number of active streams to only the essential data.

The API is limited to a maximum of 100,000 requests per 24 hour period and 300 requests per minute (approximately 5 requests per second).

If a live feed of data is required, it is recommended to connect those individual streams in a separate connection instance to avoid rate limit saturation.

Known Issues​

Incremental Sync​

Due to upstream API bugs causing records to have null values in modified_on timestamps, certain streams are unable to take advantage of incremental sync despite the availability of timestamp filters.

In some circumstances this only affects historical records prior to a certain date, where known these have been noted in the "Special Considerations" column of the Streams table.

The streams with known issues have been configured by default to avoid potential data loss, however you may choose to customize these streams to enable or disable incremental sync.

Epoch timestamp for modified_on or created_on​

In relation to the aforementioned bug, in some circumstances the API returns null or entirely excludes created_on and modified_on attributes from the response. Transformations have been configured to:

  1. If created_on is present, use this value for a missing modified_on
  2. If neither value is present, inject Unix epoch timestamps (1970-01-01T00:00:00Z)

Ephemeral order item records returned​

Due to an upstream API bug, the order_item stream can return ephemeral records for line items that are actively being edited in POS - these records are deleted but may result in inaccurate information being captured. There is currently no way to filter out or ascertain if a record is ephemeral except for performing a full sync.

Missing endpoint /producteta​

There are no plans to support this endpoint as it relies on a separate license and connecting RetailExpress to Shopify and using a specific configuration.

Missing endpoint /fulfilmentorders​

It is unclear what populates this API and the sandbox environment does not provide any data for this API, preventing it from being tested for inclusion in this connector.

Configuration​

InputTypeDescription
api_keystringAPI Key.
start_datestringStart date.

Streams​

Stream NameIncrementalSpecial Considerations
countries✅
credit_notes✅
credit_note_items✅
currencies✅
customer_logs✅
customers✅
customer_delivery_addresses✅
customer_types✅
freight_types❌
orders✅
order_items❌Returns null values for modified_on. Returns ephemeral records.
order_fulfilments✅
order_payments✅
outlets❌
product_attributes❌Returns null values for modified_on.
product_attribute_values❌Depends on non-incremental parent stream product_attributes.
product_replenishment_methods❌
products✅
product_types❌Returns null values for modified_on (historical records).
purchase_orders✅
purchase_order_items✅
transfers✅
transfer_items✅
receipt_variance_reasons✅
shipment_types❌
shipping_ports❌
shipping_status❌
stock_receipts✅
supplier_invoices✅
supplier_return_item_source❌
supplier_return_item_status❌
supplier_return_reasons✅
supplier_return_status❌
supplier_returns✅
suppliers✅
users❌
vouchers❌
voucher_types❌
inventory✅
inventory_movement_logs✅Provides a high volume of data that may rapidly exhaust API allowance.
customer_survey_segments❌
loyalty_adjustment_reasons❌
max_discount_rules✅
price_groups_fixed❌
price_groups_standard❌
product_barcodes✅
product_details_log❌
product_prices❌
return_reasons✅
stock_adjustment_reasons✅
transfer_status❌
transfer_types❌

IP allow list​

If you use Airbyte Cloud and your organization restricts access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.

Reference​

Config fields reference

Field
Type
Property name
API Key
required
string
api_key
string
start_date

Changelog​

Expand to review
VersionDatePull RequestSubject
0.0.552026-09-2286804Update dependencies
0.0.542026-09-1586206Update dependencies
0.0.532026-09-0885657Update dependencies
0.0.522026-08-1884749Update dependencies
0.0.512026-08-1184082Update dependencies
0.0.502026-08-0483592Update dependencies
0.0.492026-07-2883074Update dependencies
0.0.482026-07-2182567Update dependencies
0.0.472026-07-1481976Update dependencies
0.0.462026-07-0781213Update dependencies
0.0.452026-06-2380659Update dependencies
0.0.442026-06-1680031Update dependencies
0.0.432026-06-0979469Update dependencies
0.0.422026-06-0278980Update dependencies
0.0.412026-04-2877404Update dependencies
0.0.402026-04-2176773Update dependencies
0.0.392026-03-3175854Update dependencies
0.0.382026-03-2474972Update dependencies
0.0.372026-03-1074697Update dependencies
0.0.362026-03-0374234Update dependencies
0.0.352026-02-1772675Update dependencies
0.0.342026-01-2072043Update dependencies
0.0.332026-01-1471454Update dependencies
0.0.322025-12-1870625Update dependencies
0.0.312025-11-2570030Update dependencies
0.0.302025-11-1869589Update dependencies
0.0.292025-10-2968869Update dependencies
0.0.282025-10-2168360Update dependencies
0.0.272025-10-1467907Update dependencies
0.0.262025-10-0767535Update dependencies
0.0.252025-09-3066439Update dependencies
0.0.242025-09-0965687Update dependencies
0.0.232025-08-2465448Update dependencies
0.0.222025-08-1665018Update dependencies
0.0.212025-08-0264464Update dependencies
0.0.202025-07-2063655Update dependencies
0.0.192025-06-1461300Update dependencies
0.0.182025-05-2460459Update dependencies
0.0.172025-05-1060149Update dependencies
0.0.162025-05-0459615Update dependencies
0.0.152025-04-2759025Update dependencies
0.0.142025-04-1958390Update dependencies
0.0.132025-04-1258007Update dependencies
0.0.122025-04-0557361Update dependencies
0.0.112025-03-2956737Update dependencies
0.0.102025-03-2256175Update dependencies
0.0.92025-03-1455765Update dependencies
0.0.82025-03-0855557Update dependencies
0.0.72025-03-0154997Update dependencies
0.0.62025-02-2354588Update dependencies
0.0.52025-02-1554008Update dependencies
0.0.42025-02-0853484Update dependencies
0.0.32025-02-0153016Update dependencies
0.0.22025-01-2552467Update dependencies
0.0.12025-01-17Initial release by @GamesmenJordan via Connector Builder

Official Documentation​

The official documentation can be found here.

Was this page helpful?