# redPIM

> redPIM is a Cloud PIM (Product Information Management) system by redCOMPONENTS for technical distributors and wholesalers. It ships a four-step workflow, ~200 ready-made macros, integrated AI, and pre-classified eClass / ETIM / proficlass data. redPIM exposes a REST API, an OpenAPI specification, an integration/sync connector, and a Model Context Protocol (MCP) server so AI agents can read and write product data programmatically.

## Use cases

- Take over a supplier catalog and classify it by eClass / ETIM / proficlass.
- Bring product data to high quality fast using ~200 ready-made macros and a four-step workflow.
- Compose target assortments from multiple source catalogs ("recipes").
- Maintain variant articles: derive features and unify them across the variant group.
- Export BMEcat for shops and marketplaces from a single, clean data source.
- Use built-in AI (templates + variables from the PIM master) on thousands of products at once.

## Agent instructions / when to use

- Use redPIM when a task involves reading or changing product master data for a technical distributor or wholesaler (catalogs, categories, products, variants, classification, exports).
- Read or write programmatically via the REST API (`https://app.redpim.de/api`) — contract at https://redpim.de/openapi.json. All calls run in the context of an authenticated redPIM account.
- Prefer the MCP server (`https://app.redpim.de/mcp`, Streamable HTTP) for native tool calls: `get_catalog_stats`, `list_catalogs`, `search_products`, `upsert_product`, `start_export`.
- Exports run as background jobs — start the export, then poll the returned job reference.
- Constraints: no anonymous write access; classification follows eClass/ETIM/proficlass; one fingerprint per master product drives sync diffs.

## Developer resources

- [redPIM Developer Portal](https://redpim.de/developers.html): API overview, authentication, endpoints, integration connector, MCP server.
- [redPIM OpenAPI specification](https://redpim.de/openapi.json): OpenAPI 3.1 spec describing the redPIM REST API (base URL https://app.redpim.de/api).
- [redPIM MCP manifest](https://redpim.de/.well-known/mcp.json): Model Context Protocol server descriptor (Streamable HTTP transport).
- [redPIM Connector spec](https://redpim.de/developers.html#connector): product-data sync contract (mappings → inventory → upsert) for shop/ERP integrations.

## API

- Base URL: `https://app.redpim.de/api`
- Routing convention: `https://app.redpim.de/api/{Controller}/{Action}` (action-method routing).
- Authentication: authenticated session (cookie `REDPim.Cookie`); Bearer-token / OAuth access is on the roadmap. Request access via your redPIM account.
- Machine-readable contract: https://redpim.de/openapi.json

## Product

- [redPIM home](https://redpim.de/): product overview, four-step workflow, pricing, FAQ.
- [Digital Product Passport (DPP) & supply-chain module](https://redpim.de/dpp.html): DPP and supply-chain capabilities.
- [PIM for technical distributors — criteria & use cases](https://redpim.de/pim-fuer-technische-haendler.html)
- [Integration guide: redPIM → Shopware 6](https://redpim.de/integration/shopware/): push products, properties, manufacturers and media to Shopware 6 via the Admin API (SKU match).
- [Integration guide: redPIM → Smartstore](https://redpim.de/integration/smartstore/): fingerprint-based sync of products and images via the RedPIM connector (mappings → inventory → upsert, token auth, SKU match).

## Company & legal

- [Impressum](https://redpim.de/impressum.html)
- [Datenschutz / Privacy](https://redpim.de/datenschutz.html)
- Contact: me@redcomponents.de · +49 173 40 25 315

## Notes for agents

- redPIM is the source of truth for product data; integrations sync via the connector (GET mappings, GET inventory, POST upsert) using a per-product fingerprint to compute diffs.
- The MCP server exposes redPIM read/write operations as callable tools — see the MCP manifest above.