Data Octopus
Contents
Shops

IdoSell

Orders, returns, the product catalogue, categories and, optionally, customers and shop settings.

Integration overview

Data Views — E-commerce engine

The current documentation for these views describes IdoSell report data and rules.

Typically enabled tables: orders, products, returns, categories. Customers and shop settings are optional.

How to connect

Open the access panel: yourdomain.com/panel/users-api.php (use your own domain) and click "+ Add new key".

The "Add new key" button in the IdoSell API panel
The "Add new key" button in the IdoSell API panel

A window for configuring the new API access key opens. In it:

  1. 1Choose API key.
  2. 2Enter the name Data Octopus.
  3. 3Enter the e-mail address given in the form.
  4. 4Set Active to Yes.
  5. 5Set PIM to Read only.
  6. 6Set OMS to Read only.
  7. 7Click Add.
New IdoSell API key form with read-only permissions
New IdoSell API key form with read-only permissions

After creating the key, go back to users-api.php and click Edit.

The Edit button next to the IdoSell API key
The Edit button next to the IdoSell API key

Click Show key, copy it and paste it into the form.

The Show key button in IdoSell
The Show key button in IdoSell
Access setup guide: every source in one place

Resources we pull

Orders
orders

What customers bought.

Products
products

The product catalogue with prices and stock.

Returns
returns

Returned orders and refunds.

Categories
categories

The category tree.

Customersoptional
clients_crm

Customer accounts and their order history.

Shop settingsoptional
shops

Shop configuration.

Orders

  • Order number and type, internal notes.

Returns

  • Return number, the related order, status and key dates.
  • Returned products: quantity, price, size.
  • Costs: shipping cost, additional payment cost.
  • Refund payments: amount, payment form, status, date.
  • Return method, package number, customer and shop notes.

Products

  • Product id, displayed code, name and description in each language.
  • Category (shop and IdoSell category path), producer.
  • Prices: retail, wholesale, minimal, last and average purchase price (net and gross), VAT.
  • Sizes and variants, stock levels, availability type.
  • Visibility, promotions, deleted flag, dates (added, modified, price and quantity changed).
  • Per-shop settings and per-shop currencies.

Customersoptional

  • Customer id, login, name, company and tax id, e-mail, phone numbers, country, type (retail or wholesale).
  • Order history: number of orders (all and completed), total order value, last purchase date, last login, returns and complaints count.
  • Purchased and observed products, discount, loyalty points, newsletter consents (e-mail and SMS), notes.

Categories

  • Id, parent category, priority, names (singular and plural), description, number of products, language.

Shop settingsoptional

  • Shop id and name, default language and currency, company data on documents, which customer fields are required, loyalty, vouchers and gift cards on/off.