# OmniRetailConnect Docs

> Developer documentation for OmniRetailConnect (ook: OmniRetail), the connected platform for checkout, inventory, purchasing, warehouse and multiple stores, from one set of data. Every page below is available as clean Markdown, and all pages are combined in one file: https://docs.omniretailconnect.nl/llms-full.txt.

## Commerce: Getting started

- [Overview](https://docs.omniretailconnect.nl/commerce/getting-started/overview.md): What the Commerce MCP server and REST API are, what they can and cannot do, and who sets them up.
- [Authentication and tokens](https://docs.omniretailconnect.nl/commerce/getting-started/authentication.md): How bearer tokens work: format, scopes, channels, expiry, storage, creation, rotation and revocation.
- [Errors and status codes](https://docs.omniretailconnect.nl/commerce/getting-started/errors.md): HTTP status codes, REST error codes, MCP transport errors and tool errors.
- [Rate limits, pagination and request limits](https://docs.omniretailconnect.nl/commerce/getting-started/limits.md): Per-token and per-IP rate limits, cursor pagination, result limits and request size caps for both interfaces.
- [Versioning and changelog](https://docs.omniretailconnect.nl/commerce/getting-started/versioning.md): How the REST API and the MCP server are versioned, and what counts as a compatible change.

## Commerce: MCP

- [MCP overview](https://docs.omniretailconnect.nl/commerce/mcp/overview.md): The endpoint, the transport, the fifteen read tools and the forty-five write tools of the Commerce MCP server.
- [Connect with an AI agent](https://docs.omniretailconnect.nl/commerce/mcp/connect-with-an-agent.md): A checklist, connection config, verification procedure and decision table for AI agents and the people who hand them this task.
- [Connect Claude Code](https://docs.omniretailconnect.nl/commerce/mcp/connect-claude-code.md): Add the Commerce MCP server to Claude Code with one command.
- [Connect other clients](https://docs.omniretailconnect.nl/commerce/mcp/connect-other-clients.md): A generic MCP client configuration, a curl smoke test, and what is not supported.
- [Tool reference](https://docs.omniretailconnect.nl/commerce/mcp/tools.md): The fifteen read tools and the first write tools (product content, price, stock, images, categories) with their inputs, limits, required scope, output and errors.
- [Catalogue write tools](https://docs.omniretailconnect.nl/commerce/mcp/catalogue-tools.md): Write tools for product SEO, web address, variants, properties, labels, sale prices, price breaks, brands, the label set and featured products.
- [Discount tools](https://docs.omniretailconnect.nl/commerce/mcp/discount-tools.md): Read discounts and create, change, end and delete discount codes, including when a code is hidden.
- [Order tools](https://docs.omniretailconnect.nl/commerce/mcp/order-tools.md): Confirm an offline payment, cancel an unpaid order, add internal notes and record shipments with tracking, without moving money.
- [Content tools](https://docs.omniretailconnect.nl/commerce/mcp/content-tools.md): List, read, create, change and delete CMS pages: blocks, images, version check, search-engine fields, the home page and size limits.
- [Privacy and security](https://docs.omniretailconnect.nl/commerce/mcp/privacy-and-security.md): What personal data is masked, what is never exposed, and how to handle tokens, write tokens and untrusted text.

## Commerce: REST API

- [REST API overview](https://docs.omniretailconnect.nl/commerce/api/overview.md): The Commerce REST API: base URL, authentication, the full endpoint list, response envelope and the OpenAPI description.
- [Products](https://docs.omniretailconnect.nl/commerce/api/products.md): Search products, get one product by id and look up a product by variant SKU, with sales, price breaks, SEO, labels and properties.
- [Product writes](https://docs.omniretailconnect.nl/commerce/api/product-writes.md): Create products and change content, SEO, web address, properties, labels, variants, price, sales, price breaks, stock and images with a write token.
- [Catalogue structure](https://docs.omniretailconnect.nl/commerce/api/catalogue.md): Reference lists (brands, labels, tax classes, properties) and writes for brands, labels, categories and featured products.
- [Discounts](https://docs.omniretailconnect.nl/commerce/api/discounts.md): Read discount codes and create, change, end and delete them with a write token; when a code is hidden.
- [Availability](https://docs.omniretailconnect.nl/commerce/api/availability.md): Check stock and purchasability of up to 50 SKUs in one request.
- [Orders](https://docs.omniretailconnect.nl/commerce/api/orders.md): Search orders and get one order by reference or id, with masked or full customer data and internal notes depending on the token scope.
- [Order writes](https://docs.omniretailconnect.nl/commerce/api/order-writes.md): Confirm an offline payment, cancel an unpaid order, add internal notes and record shipments with tracking, without moving money.
- [Categories](https://docs.omniretailconnect.nl/commerce/api/categories.md): Read the product category tree.
- [Sales summary](https://docs.omniretailconnect.nl/commerce/api/sales-summary.md): Operational sales metrics for a date range, optionally grouped by day, week or month.
- [Pages](https://docs.omniretailconnect.nl/commerce/api/pages.md): Read, create, change and delete CMS pages with blocks, images, search-engine fields and a version check.

## Commerce: Reference

- [Scopes and masking](https://docs.omniretailconnect.nl/commerce/reference/scopes-and-masking.md): Which scope gives what, and which fields are masked or withheld without the pii scope.
- [Error codes](https://docs.omniretailconnect.nl/commerce/reference/error-codes.md): Every error code and status of the REST API and the MCP server in one table.
- [Limits](https://docs.omniretailconnect.nl/commerce/reference/limits.md): All default limits of the REST API and the MCP server in one table.

## PIM: Aan de slag

- [Overzicht](https://docs.omniretailconnect.nl/pim/aan-de-slag/overzicht.md): Wat de PIM doet, wat de API levert en wat niet.
- [Verbinden](https://docs.omniretailconnect.nl/pim/aan-de-slag/verbinden.md): Een token krijgen, je eerste verzoek doen, het antwoord lezen en het token veilig bewaren.
- [Hoe het werkt](https://docs.omniretailconnect.nl/pim/aan-de-slag/hoe-het-werkt.md): Van leveranciersaanbod naar jouw artikel: licenties, merkrechten, leveranciersrang en eigen voorraad.

## PIM: API

- [Producten](https://docs.omniretailconnect.nl/pim/api/producten.md): GET /products: wanneer een product verschijnt, de filters, het antwoord en de velden.
- [Mijn producten](https://docs.omniretailconnect.nl/pim/api/mijn-producten.md): GET /my-products: één regel per klantartikel, met jouw prijs en voorraad, SEO, categorieën en kenmerken.
- [Synchroniseren](https://docs.omniretailconnect.nl/pim/api/synchroniseren.md): Pagineren, alleen wijzigingen ophalen en een volledig script dat je gegevens up-to-date houdt.

## PIM: Referentie

- [Foutmeldingen](https://docs.omniretailconnect.nl/pim/referentie/foutmeldingen.md): De foutmeldingen van de API, wat ze betekenen en wat je eraan doet.

## Optional

- [Commerce OpenAPI description](https://docs.omniretailconnect.nl/docs/openapi/commerce.json): machine-readable contract of the Commerce REST API (OpenAPI, JSON).
- [All pages as one Markdown file](https://docs.omniretailconnect.nl/llms-full.txt): every page in navigation order.
- [Sitemap](https://docs.omniretailconnect.nl/sitemap.xml): HTML pages of the documentation.