Skip to content
Book a demoStart free
Connectors

Retail Express connector

Set up the Retail Express connector in Kaivo: authentication, configuration, the 52 BigQuery tables it syncs, and answers to common questions.

Retail Express connector pricing, tier and credits on kaivo.io

Kaivo is a fully managed data platform that syncs your Retail Express data into a Google BigQuery warehouse and keeps it up to date automatically. There is no pipeline to build and no infrastructure to run, so you can spend your time analysing your e-commerce data instead of moving it.

Sync your Retail Express by Maropost data into BigQuery with Kaivo to analyse sales, customers, and fulfilment across your stores.

CategoryE-commerce
AuthenticationAPI key
SetupSelf-service

Getting started with the Retail Express connector

Section titled “Getting started with the Retail Express connector”
  1. Sign up for Kaivo and create a workspace.
  2. Connect your Retail Express account.
  3. Choose which tables to sync.
  4. Wait for the initial sync to finish.
  5. Query your data in BigQuery or your favourite AI or BI tool.

Authenticate with your API Key.

Field Description
API Key

When you set up the connector, you provide:

Field Description
Start Date
Any data before this date will not be fetched.

|

Tables and columns synced from Retail Express

Section titled “Tables and columns synced from Retail Express”

Kaivo syncs 52 tables from Retail Express into a dedicated dataset in your BigQuery warehouse. Click any table to see its columns and types.

countries (13 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
code STRING
name STRING
tax_rate FLOAT64
tax_label STRING
modified_on STRING
fob_currency__id FLOAT64
fob_currency__modified_on STRING
fob_currency__currency_code STRING
fob_currency__currency_name STRING
currency_multiplier FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
credit_note_items (34 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
product__id FLOAT64
product__size__id FLOAT64
product__size__name STRING
product__modified_on STRING
product__supplier_sku STRING
product__supplier_sku2 STRING
product__short_description STRING
created_by__id FLOAT64
created_by__surname STRING
created_by__user_code STRING
created_by__first_name STRING
created_on STRING
modified_by__id FLOAT64
modified_by__surname STRING
modified_by__user_code STRING
modified_by__first_name STRING
modified_on STRING
credit_note_id FLOAT64
credit_quantity FLOAT64
credit_amount_ex FLOAT64
applied_credit_tax FLOAT64
total_credit_amount_ex FLOAT64
applied_credit_quantity FLOAT64
supplier_return_item_id FLOAT64
total_credit_amount_inc FLOAT64
total_credit_amount_tax FLOAT64
applied_credit_amount_ex FLOAT64
total_applied_credit_tax FLOAT64
applied_credit_amount_inc FLOAT64
total_applied_credit_amount_ex FLOAT64
total_applied_credit_amount_inc FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
credit_notes (33 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
outlet__id FLOAT64
outlet__name STRING
outlet__modified_on STRING
supplier__id FLOAT64
supplier__name STRING
supplier__modified_on STRING
supplier__supplier_code STRING
created_by__id FLOAT64
created_by__surname STRING
created_by__user_code STRING
created_by__first_name STRING
created_on STRING
include_tax BOOL
modified_by__id FLOAT64
modified_by__surname STRING
modified_by__user_code STRING
modified_by__first_name STRING
modified_on STRING
supplier_reference STRING
supplier_return_id FLOAT64
rounding_adjustment FLOAT64
supplier_credited_on STRING
total_credit_quantity FLOAT64
total_credit_amount_ex FLOAT64
total_credit_amount_inc FLOAT64
total_credit_amount_tax FLOAT64
total_applied_credit_tax FLOAT64
total_applied_credit_quantity FLOAT64
total_applied_credit_amount_ex FLOAT64
total_applied_credit_amount_inc FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
currencies (6 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
modified_on STRING
currency_code STRING
currency_name STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
customer_delivery_addresses (17 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
phone STRING
state STRING
mobile STRING
suburb STRING
company STRING
country STRING
default BOOL
postcode STRING
last_name STRING
first_name STRING
modified_on STRING
country_code STRING
address_line1 STRING
address_line2 STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
customer_logs (13 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
created_by__id FLOAT64
created_by__surname STRING
created_by__user_code STRING
created_by__first_name STRING
created_on STRING
customer_id FLOAT64
customer_number STRING
master_customer_id FLOAT64
loyalty_points_balance FLOAT64
master_customer_number STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Repeating fields are split into their own tables, listed here with their column counts.

  • customer_logs__price_groups (4 columns)
customer_survey_segments (5 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
name STRING
active BOOL
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Repeating fields are split into their own tables, listed here with their column counts.

  • customer_survey_segments__options (5 columns)
customer_types (8 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
name STRING
active BOOL
default BOOL
deleted BOOL
modified_on STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
customers (45 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
fax STRING
email STRING
phone STRING
mobile STRING
company STRING
last_name STRING
marketing__receive_sms BOOL
marketing__receive_post BOOL
marketing__receive_email BOOL
created_on STRING
first_name STRING
home_outlet__id FLOAT64
home_outlet__name STRING
home_outlet__modified_on STRING
modified_on STRING
customer_type__id FLOAT64
customer_type__name STRING
export_to_web BOOL
total_payments FLOAT64
billing_address__state STRING
billing_address__suburb STRING
billing_address__country STRING
billing_address__postcode STRING
billing_address__last_name STRING
billing_address__first_name STRING
billing_address__country_code STRING
billing_address__address_line1 STRING
billing_address__address_line2 STRING
customer_number STRING
loyalty_program__enabled BOOL
loyalty_program__points_to_date FLOAT64
loyalty_program__points_redeemed FLOAT64
loyalty_program__auto_price_group BOOL
loyalty_program__points_available FLOAT64
account_customer__enabled BOOL
account_customer__credit_limit FLOAT64
account_customer__payment_terms FLOAT64
account_customer__credit_blocked BOOL
account_customer__credit_remaining FLOAT64
custom_reference STRING
total_transactions FLOAT64
date_of_birth_withheld BOOL
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Repeating fields are split into their own tables, listed here with their column counts.

  • customers__price_groups (4 columns)
  • customers__sales_channels (4 columns)
  • customers__survey_responses (4 columns)
freight_types (6 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
name STRING
deleted BOOL
modified_on STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
inventory (19 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
msl FLOAT64
faulty FLOAT64
picked FLOAT64
on_order FLOAT64
received FLOAT64
allocated FLOAT64
available FLOAT64
outlet_id FLOAT64
requested FLOAT64
product_id FLOAT64
transit_in FLOAT64
modified_on STRING
transit_out FLOAT64
bin_location STRING
last_sold_on STRING
stock_on_hand FLOAT64
last_fulfiled_on STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
inventory_movement_logs (65 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
origin STRING
outlet__id FLOAT64
outlet__name STRING
cogs_ex__after FLOAT64
cogs_ex__before FLOAT64
cogs_ex__change FLOAT64
comment STRING
product__id FLOAT64
product__product_type__id FLOAT64
product__product_type__name STRING
product__product_type__modified_on STRING
product__supplier_sku STRING
product__short_description STRING
created_by__id FLOAT64
created_by__surname STRING
created_by__user_code STRING
created_by__first_name STRING
created_on STRING
buy_price_ex__after FLOAT64
buy_price_ex__before FLOAT64
buy_price_ex__change FLOAT64
quantity_soh__after FLOAT64
quantity_soh__delta FLOAT64
quantity_soh__before FLOAT64
reference_id STRING
movement_type STRING
total_cogs_ex__after FLOAT64
total_cogs_ex__before FLOAT64
total_cogs_ex__change FLOAT64
direct_costs_ex__after FLOAT64
direct_costs_ex__before FLOAT64
direct_costs_ex__change FLOAT64
quantity_faulty__after FLOAT64
quantity_faulty__delta FLOAT64
quantity_faulty__before FLOAT64
quantity_picked__after FLOAT64
quantity_picked__delta FLOAT64
quantity_picked__before FLOAT64
quantity_onorder__after FLOAT64
quantity_onorder__delta FLOAT64
quantity_onorder__before FLOAT64
quantity_onreturn__after FLOAT64
quantity_onreturn__delta FLOAT64
quantity_onreturn__before FLOAT64
quantity_received__after FLOAT64
quantity_received__delta FLOAT64
quantity_received__before FLOAT64
quantity_allocated__after FLOAT64
quantity_allocated__delta FLOAT64
quantity_allocated__before FLOAT64
quantity_available__after FLOAT64
quantity_available__delta FLOAT64
quantity_available__before FLOAT64
quantity_requested__after FLOAT64
quantity_requested__delta FLOAT64
quantity_requested__before FLOAT64
quantity_in_transit_inbound__after FLOAT64
quantity_in_transit_inbound__delta FLOAT64
… and 5 more columns
loyalty_adjustment_reasons (6 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
name STRING
is_system BOOL
is_deleted BOOL
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
max_discount_rules (7 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
id FLOAT64
name STRING
value FLOAT64
modified_on STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
order_fulfilments (11 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
order_id FLOAT64
created_on STRING
order_number STRING
fulfil_outlet__id FLOAT64
fulfil_outlet__name STRING
fulfil_outlet__modified_on STRING
order_item_id FLOAT64
quantity_fulfiled FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
order_items (32 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
cogs_ex FLOAT64
product__id FLOAT64
product__package BOOL
product__product_type__id FLOAT64
product__product_type__name STRING
product__product_type__modified_on STRING
product__supplier_sku STRING
product__short_description STRING
product__has_package_products BOOL
taxable BOOL
tax_rate FLOAT64
created_on STRING
sell_price FLOAT64
modified_on STRING
fulfil_outlet__id FLOAT64
fulfil_outlet__name STRING
fulfil_outlet__modified_on STRING
source_outlet__id FLOAT64
source_outlet__name STRING
source_outlet__modified_on STRING
original_price FLOAT64
direct_costs_ex FLOAT64
order_item_type STRING
supplier_buy_ex FLOAT64
order_item_total FLOAT64
quantity_ordered FLOAT64
fulfilment_method STRING
quantity_fulfiled FLOAT64
order_item_discount_total FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Repeating fields are split into their own tables, listed here with their column counts.

  • order_items__applied_promotional_campaigns (4 columns)
order_payments (9 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
amount FLOAT64
order_id FLOAT64
created_on STRING
order_number STRING
payment_method__id FLOAT64
payment_method__name STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
orders (56 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
outlet__id FLOAT64
outlet__name STRING
outlet__modified_on STRING
taxable FLOAT64
customer__id FLOAT64
customer__email STRING
customer__last_name STRING
customer__first_name STRING
customer__customer_number STRING
customer__custom_reference STRING
created_on STRING
modified_on STRING
order_total FLOAT64
order_number STRING
order_status__id FLOAT64
order_status__status STRING
sales_person__id FLOAT64
sales_person__surname STRING
sales_person__user_code STRING
sales_person__first_name STRING
ext_unique_id STRING
freight_total FLOAT64
billing_address__email STRING
billing_address__phone STRING
billing_address__state STRING
billing_address__mobile STRING
billing_address__suburb STRING
billing_address__company STRING
billing_address__country STRING
billing_address__postcode STRING
billing_address__last_name STRING
billing_address__first_name STRING
billing_address__country_code STRING
billing_address__address_line1 STRING
billing_address__address_line2 STRING
paid_in_full_on STRING
public_comments STRING
delivery_address__id FLOAT64
delivery_address__phone STRING
delivery_address__state STRING
delivery_address__mobile STRING
delivery_address__suburb STRING
delivery_address__company STRING
delivery_address__country STRING
delivery_address__postcode STRING
delivery_address__last_name STRING
delivery_address__first_name STRING
delivery_address__modified_on STRING
delivery_address__country_code STRING
delivery_address__address_line1 STRING
delivery_address__address_line2 STRING
private_comments STRING
fulfilled_in_full_on STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
outlets (30 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
logo__description STRING
logo__id FLOAT64
name STRING
email STRING
phone STRING
address__state STRING
address__suburb STRING
address__country__id FLOAT64
address__country__name STRING
address__postcode STRING
address__address_line1 STRING
address__address_line2 STRING
enabled BOOL
store_type__id FLOAT64
store_type__name STRING
modified_on STRING
billing_type FLOAT64
company_name STRING
fob_currency__id FLOAT64
fob_currency__currency_code STRING
fob_currency__currency_name STRING
invoice_email_template__id FLOAT64
invoice_email_template__name STRING
invoice_receipt_comments STRING
company_registration_label STRING
display_address_on_invoice BOOL
company_registration_number STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
price_groups_fixed (5 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
name STRING
modified_on STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
price_groups_standard (7 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
name STRING
rule__type STRING
rule__value FLOAT64
modified_on STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
product_attribute_values (7 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
name STRING
list_order FLOAT64
modified_on STRING
attribute_id FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
product_attributes (6 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
id FLOAT64
name STRING
modified_on STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
product_barcodes (8 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
barcode STRING
enabled BOOL
created_on STRING
product_id FLOAT64
modified_on STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
product_details_log (39 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
origin STRING
product__id FLOAT64
product__created_on STRING
product__supplier_sku STRING
product__short_description STRING
rrp_inc__after FLOAT64
rrp_inc__before FLOAT64
rrp_inc__change FLOAT64
disabled__after BOOL
disabled__before BOOL
created_by__id FLOAT64
created_by__surname STRING
created_by__user_code STRING
created_by__first_name STRING
created_on STRING
buy_price_ex__after FLOAT64
buy_price_ex__before FLOAT64
buy_price_ex__change FLOAT64
product_type__after STRING
product_type__before STRING
movement_type STRING
web_price_inc__after FLOAT64
web_price_inc__before FLOAT64
web_price_inc__change FLOAT64
discount_price__after FLOAT64
discount_price__before FLOAT64
discount_price__change FLOAT64
sell_price_inc__after FLOAT64
sell_price_inc__before FLOAT64
sell_price_inc__change FLOAT64
direct_costs_ex__after FLOAT64
direct_costs_ex__before FLOAT64
direct_costs_ex__change FLOAT64
supplier_buy_ex__after FLOAT64
supplier_buy_ex__before FLOAT64
supplier_buy_ex__change FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
product_prices (12 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
cogs_ex FLOAT64
taxable BOOL
outlet_id FLOAT64
product_id FLOAT64
sell_price_inc FLOAT64
direct_costs_ex FLOAT64
supplier_buy_ex FLOAT64
promotional_price_end STRING
promotional_price_inc FLOAT64
promotional_price_start STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
product_replenishment_methods (5 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
code STRING
name STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
product_types (5 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
name STRING
modified_on STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
products (44 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
cubic FLOAT64
depth FLOAT64
length FLOAT64
weight FLOAT64
breadth FLOAT64
cogs_ex FLOAT64
package BOOL
rrp_inc FLOAT64
disabled BOOL
supplier__id FLOAT64
supplier__name STRING
supplier__modified_on STRING
supplier__supplier_code STRING
lead_time FLOAT64
created_on STRING
freight_inc FLOAT64
modified_on STRING
buy_price_ex FLOAT64
core_product BOOL
last_sold_on STRING
product_type__id FLOAT64
product_type__name STRING
product_type__modified_on STRING
supplier_sku STRING
export_to_web BOOL
supplier_sku2 STRING
sell_price_inc FLOAT64
carton_quantity STRING
direct_costs_ex FLOAT64
supplier_buy_ex FLOAT64
voucher_product BOOL
last_fulfiled_on STRING
manufacturer_sku STRING
prevent_disabling BOOL
requires_assembly BOOL
short_description STRING
has_package_products BOOL
replenishment_method__id FLOAT64
replenishment_method__code STRING
replenishment_method__name STRING
promotional_price_expiry STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Repeating fields are split into their own tables, listed here with their column counts.

  • products__inventory (4 columns)
  • products__attributes (9 columns)
  • products__price_groups (4 columns)
  • products__external_links (6 columns)
  • products__sales_channels (9 columns)
  • products__custom_properties (5 columns)
  • products__fixed_price_groups (4 columns)
purchase_order_items (67 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
po_id FLOAT64
mark_up FLOAT64
pricing__taxable BOOL
pricing__outlet_id FLOAT64
pricing__product_id FLOAT64
pricing__sell_price_inc FLOAT64
pricing__promotional_price_inc FLOAT64
product__id FLOAT64
product__cubic FLOAT64
product__depth FLOAT64
product__length FLOAT64
product__weight FLOAT64
product__breadth FLOAT64
product__cogs_ex FLOAT64
product__package BOOL
product__rrp_inc FLOAT64
product__disabled BOOL
product__supplier__id FLOAT64
product__supplier__name STRING
product__supplier__modified_on STRING
product__supplier__supplier_code STRING
product__lead_time FLOAT64
product__created_on STRING
product__freight_inc FLOAT64
product__modified_on STRING
product__buy_price_ex FLOAT64
product__core_product BOOL
product__last_sold_on STRING
product__product_type__id FLOAT64
product__product_type__name STRING
product__product_type__modified_on STRING
product__supplier_sku STRING
product__export_to_web BOOL
product__supplier_sku2 STRING
product__sell_price_inc FLOAT64
product__direct_costs_ex FLOAT64
product__supplier_buy_ex FLOAT64
product__voucher_product BOOL
product__last_fulfiled_on STRING
product__prevent_disabling BOOL
product__requires_assembly BOOL
product__short_description STRING
product__has_package_products BOOL
product__replenishment_method__id FLOAT64
product__replenishment_method__code STRING
product__replenishment_method__name STRING
inventory__msl FLOAT64
inventory__outlet__id FLOAT64
inventory__outlet__name STRING
inventory__quantity_on_order FLOAT64
inventory__quantity_available FLOAT64
po_item_id FLOAT64
modified_on STRING
total_cubic FLOAT64
gross_profit FLOAT64
total_weight FLOAT64
supplier_buy_ex FLOAT64
quantity_ordered FLOAT64
quantity_received FLOAT64
… and 7 more columns

Repeating fields are split into their own tables, listed here with their column counts.

  • purchase_order_items__product__inventory (4 columns)
  • purchase_order_items__product__attributes (9 columns)
  • purchase_order_items__product__price_groups (4 columns)
  • purchase_order_items__product__external_links (6 columns)
  • purchase_order_items__product__sales_channels (9 columns)
  • purchase_order_items__product__custom_properties (5 columns)
  • purchase_order_items__product__fixed_price_groups (4 columns)
purchase_orders (41 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
eta STRING
outlet__id FLOAT64
outlet__name STRING
status__id FLOAT64
status__name STRING
deposit FLOAT64
sent_on STRING
supplier__id FLOAT64
supplier__name STRING
created_on STRING
deliver_to STRING
modified_on STRING
received_on STRING
total_cubic FLOAT64
fob_currency__id FLOAT64
fob_currency__currency_code STRING
fob_currency__currency_name STRING
total_weight FLOAT64
payment_terms STRING
shipping_terms STRING
fumes_documents STRING
container_number STRING
internal_comments STRING
invoice_documents STRING
supplier_comments STRING
total_supplier_buy_ex FLOAT64
packing_list_documents STRING
total_quantity_ordered FLOAT64
purchase_order_template STRING
supplier_invoice_number STRING
total_quantity_received FLOAT64
bill_of_lading_documents STRING
total_quantity_cancelled FLOAT64
total_quantity_remaining FLOAT64
total_quantity_special_order FLOAT64
packing_declaration_documents STRING
total_quantity_linked_transfers FLOAT64
certificate_of_original_documents STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
receipt_variance_reasons (6 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
name STRING
enabled BOOL
modified_on STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
return_reasons (7 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
name STRING
enabled BOOL
created_on STRING
modified_on STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
shipment_types (4 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
name STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
shipping_ports (4 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
name STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
shipping_status (4 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
name STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
stock_adjustment_reasons (7 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
name STRING
disabled BOOL
created_on STRING
modified_on STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
stock_receipts (32 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
outlet__id FLOAT64
outlet__name STRING
outlet__modified_on STRING
product__id FLOAT64
product__cubic FLOAT64
product__depth FLOAT64
product__length FLOAT64
product__weight FLOAT64
product__breadth FLOAT64
product__package BOOL
product__rrp_inc FLOAT64
product__supplier__modified_on STRING
product__supplier__supplier_code STRING
product__product_type__id FLOAT64
product__product_type__modified_on STRING
product__supplier_sku STRING
product__export_to_web BOOL
product__supplier_sku2 STRING
product__sell_price_inc FLOAT64
product__carton_quantity STRING
product__manufacturer_sku STRING
product__short_description STRING
product__has_package_products BOOL
tax_rate FLOAT64
source_id FLOAT64
created_on STRING
buy_price_ex FLOAT64
direct_costs_ex FLOAT64
received_quantity FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Repeating fields are split into their own tables, listed here with their column counts.

  • stock_receipts__product__attributes (6 columns)
  • stock_receipts__product__external_links (4 columns)
  • stock_receipts__product__custom_properties (5 columns)
supplier_invoices (47 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
notes STRING
status STRING
total_tax FLOAT64
created_by__id FLOAT64
created_by__surname STRING
created_by__user_code STRING
created_by__first_name STRING
created_on STRING
modified_by__id FLOAT64
modified_by__surname STRING
modified_by__user_code STRING
modified_by__first_name STRING
modified_on STRING
direct_costs__duty__total_ex FLOAT64
direct_costs__duty__total_inc FLOAT64
direct_costs__duty__total_tax FLOAT64
direct_costs__duty__includes_tax BOOL
direct_costs__misc__total_ex FLOAT64
direct_costs__misc__total_inc FLOAT64
direct_costs__misc__total_tax FLOAT64
direct_costs__misc__includes_tax BOOL
direct_costs__freight__total_ex FLOAT64
direct_costs__freight__total_inc FLOAT64
direct_costs__freight__total_tax FLOAT64
direct_costs__freight__includes_tax BOOL
direct_costs__applied_on STRING
direct_costs__apply_pending BOOL
finalised_by__id FLOAT64
finalised_by__surname STRING
finalised_by__user_code STRING
finalised_by__first_name STRING
finalised_on STRING
origin_country__id FLOAT64
origin_country__name STRING
total_buy_price_ex FLOAT64
currency_conversion FLOAT64
distribute_costs_by STRING
international_order BOOL
rounding_adjustment FLOAT64
total_buy_price_inc FLOAT64
supplier_invoiced_on STRING
supplier_invoice_number STRING
landed_costs_calculation STRING
total_applied_buy_price_ex FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Repeating fields are split into their own tables, listed here with their column counts.

  • supplier_invoices__purchase_order_receipts (5 columns)
supplier_return_item_source (4 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
name STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
supplier_return_item_status (4 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
name STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
supplier_return_reasons (7 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
name STRING
deleted BOOL
created_on STRING
modified_on STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
supplier_return_status (4 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
name STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
supplier_returns (39 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
notes STRING
outlet__id FLOAT64
outlet__name STRING
outlet__modified_on STRING
supplier__id FLOAT64
supplier__name STRING
supplier__modified_on STRING
supplier__supplier_code STRING
created_by__id FLOAT64
created_by__surname STRING
created_by__user_code STRING
created_by__first_name STRING
created_on STRING
started_on STRING
include_tax BOOL
modified_by__id FLOAT64
modified_by__surname STRING
modified_by__user_code STRING
modified_by__first_name STRING
modified_on STRING
finalised_on STRING
supplier_address__state STRING
supplier_address__suburb STRING
supplier_address__country__id FLOAT64
supplier_address__country__name STRING
supplier_address__postcode STRING
supplier_address__address_line1 STRING
return_authorisation STRING
total_claim_amount_ex FLOAT64
total_return_quantity FLOAT64
supplier_return_status__id FLOAT64
supplier_return_status__name STRING
total_claim_amount_inc FLOAT64
total_claim_amount_tax FLOAT64
total_credit_received_ex FLOAT64
total_credit_received_inc FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
suppliers (24 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
fax STRING
name STRING
phone STRING
address__state STRING
address__suburb STRING
address__country__id FLOAT64
address__country__name STRING
address__postcode STRING
address__address_line1 STRING
comments STRING
modified_on STRING
order_email STRING
contact_name STRING
contact_email STRING
payment_terms STRING
supplier_code STRING
deposit_required BOOL
admin_only_orders BOOL
country_of_origin__id FLOAT64
country_of_origin__name STRING
purchase_order_template STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
transfer_items (40 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
product__id FLOAT64
product__cubic FLOAT64
product__depth FLOAT64
product__length FLOAT64
product__weight FLOAT64
product__breadth FLOAT64
product__package BOOL
product__rrp_inc FLOAT64
product__supplier__id FLOAT64
product__supplier__name STRING
product__supplier__modified_on STRING
product__supplier__supplier_code STRING
product__last_sold_on STRING
product__product_type__id FLOAT64
product__product_type__name STRING
product__product_type__modified_on STRING
product__supplier_sku STRING
product__export_to_web BOOL
product__supplier_sku2 STRING
product__sell_price_inc FLOAT64
product__carton_quantity STRING
product__last_fulfiled_on STRING
product__manufacturer_sku STRING
product__short_description STRING
product__has_package_products BOOL
created_on STRING
modified_on STRING
transfer_id FLOAT64
buy_price_ex FLOAT64
direct_costs_ex FLOAT64
quantity_picked FLOAT64
quantity_proposed FLOAT64
quantity_received FLOAT64
quantity_allocated FLOAT64
quantity_requested FLOAT64
quantity_dispatched FLOAT64
quantity_made_available FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Repeating fields are split into their own tables, listed here with their column counts.

  • transfer_items__product__attributes (9 columns)
  • transfer_items__product__price_groups (4 columns)
  • transfer_items__product__external_links (6 columns)
  • transfer_items__product__sales_channels (9 columns)
  • transfer_items__product__custom_properties (5 columns)
  • transfer_items__product__fixed_price_groups (4 columns)
transfer_status (4 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
name STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
transfer_types (4 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
name STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
transfers (39 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
notes STRING
order__id FLOAT64
order__customer__id FLOAT64
order__customer__email STRING
order__customer__last_name STRING
order__customer__first_name STRING
order__customer__customer_number STRING
order__customer__custom_reference STRING
order__created_on STRING
order__order_number STRING
status__id FLOAT64
status__name STRING
approved BOOL
outlet_to__id FLOAT64
outlet_to__name STRING
created_by__id FLOAT64
created_by__surname STRING
created_by__user_code STRING
created_by__first_name STRING
created_on STRING
modified_on STRING
outlet_from__id FLOAT64
outlet_from__name STRING
simple_mode BOOL
transfer_type__id FLOAT64
transfer_type__name STRING
purchase_order__id FLOAT64
purchase_order__status__id FLOAT64
purchase_order__status__name STRING
purchase_order__created_on STRING
purchase_order__modified_on STRING
purchase_order__received_on STRING
purchase_order__supplier_invoice_number STRING
total_picked_cogs_ex FLOAT64
total_picked_buy_price_ex FLOAT64
total_picked_direct_costs_ex FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Repeating fields are split into their own tables, listed here with their column counts.

  • transfers__transfer_items (4 columns)
users (11 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
enabled BOOL
surname STRING
is_admin BOOL
user_code STRING
first_name STRING
modified_on STRING
security_profile__id FLOAT64
security_profile__name STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Repeating fields are split into their own tables, listed here with their column counts.

  • users__outlets (5 columns)
  • users__stock_outlets (5 columns)
voucher_types (6 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
name STRING
voucher_text STRING
valid_for_days FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
vouchers (19 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type__id FLOAT64
type__name STRING
id FLOAT64
code STRING
order__id FLOAT64
order__customer__id FLOAT64
order__customer__email STRING
order__customer__last_name STRING
order__customer__first_name STRING
order__customer__customer_number STRING
order__customer__custom_reference STRING
order__created_on STRING
order__order_number STRING
balance FLOAT64
created_on STRING
expires_on STRING
initial_value FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Repeating fields are split into their own tables, listed here with their column counts.

  • vouchers__order__vouchers (11 columns)

After the first load, Kaivo keeps your BigQuery warehouse up to date for you. Where Retail Express supports it, each sync pulls only new and changed records so it stays fast; otherwise it refreshes the whole table. Every record keeps its original ID, so you won’t get duplicate rows.

How long does the initial sync take for Retail Express?

Section titled “How long does the initial sync take for Retail Express?”

It depends on how much history is in your Retail Express account. Most initial syncs finish within minutes, while large accounts can take a few hours. After that, syncs only fetch new and changed records, so they’re much faster.

Yes. You pick which tables to sync when you set up the connection and can change the selection later. Tables you don’t select are never copied to your warehouse.

What happens when Retail Express’s schema changes?

Section titled “What happens when Retail Express’s schema changes?”

New fields are never added automatically. You choose which fields to sync, so data you haven’t selected (sensitive personal data, for example) never lands in your warehouse. When a new field appears, it becomes available for you to add. What happens to removed or renamed fields depends on a table’s sync mode: full-refresh tables always match what’s currently in Retail Express, so dropped fields disappear, while incremental tables keep their existing columns and history, so an old field stays and newly added fields fill in over time.

How do I handle GDPR or data deletion requests?

Section titled “How do I handle GDPR or data deletion requests?”

Your data lives in your own Kaivo-managed BigQuery warehouse, so the most direct option is to delete or anonymise specific records right in BigQuery. If you delete data in Retail Express instead, full-refresh tables drop it on the next sync, while incremental tables keep it, so you would remove the row in BigQuery or ask us to run a full refresh. To remove everything, delete the Retail Express connector in Kaivo and all of its synced data is deleted with it.

Use orders and order_items to track revenue and what sells over time.

Join customers with orders to measure repeat purchases and lifetime value.

Use order_fulfilments and outlets to monitor fulfilment across stores.

Use Retail Express data in your AI and BI tools

Section titled “Use Retail Express data in your AI and BI tools”

Once Retail Express data lands in your Kaivo-managed BigQuery warehouse, you can explore it with AI tools or any BI tool that connects to BigQuery. Here’s how the most common destinations work with Retail Express data.

Use Kaivo’s MCP server to give Claude secure, workspace-scoped access to your data. Setup guide →

Microsoft’s BI tool with a native BigQuery connector. Supports direct query and scheduled refresh. Setup guide →

Free Google BI tool with native BigQuery support. One-click connection to your Kaivo warehouse; great for SMB teams on Google Workspace. Setup guide →

The premium analytics standard, with native BigQuery integration. Setup guide →

Use Connected Sheets to query BigQuery directly from a spreadsheet, with no SQL. Setup guide →

Connect via Power Query’s BigQuery connector. Setup guide →

Open-source BI tool with strong BigQuery support. Setup guide →

See our pricing page for Retail Express connector pricing and plan details.