PIM Module
Product Information Management — unified catalog, ERP sync, AI enrichment, channels, and public catalog sites.
Product Information Management (PIM)
The PIM module centralizes SKU masters, structured attributes, assets, supplier intake, completeness scoring, and channel publication — inside your multi-tenant CRM org (schema-per-tenant products + pim_* tables).
What's included
| Area | Description |
|---|---|
| Tenant catalog | GET /api/v1/pim/products — search, paginate, draft/publish workflow |
| Attributes | Typed facet definitions + localized values (pim_attribute_definitions, pim_attribute_values) |
| Families & categories | Merchandising hierarchy + inheritance hooks (pim_categories, pim_families) |
| Assets | Blob-backed media with checksum/dedup hooks (pim_assets, pim_asset_links) |
| Channels | Publication matrix (pim_channels, pim_channel_views) — web, ERP, marketing, conversations |
| Completeness | Heuristic scoring + daily snapshots (pim_completeness_snapshots, cron /api/cron/pim-completeness) |
| Supplier intake | Import jobs + review queue (pim_supplier_imports, pim_review_tasks) |
| Public catalog | SEO-friendly /catalog/{orgSlug} microsite + POST /api/v1/catalog/{orgSlug}/quote → lead |
| AI tools | MCP pim_* tools + enrichment pipeline (PDF, vision, translator, gap detector) |
Enablement
PIM ships off by default.
- Self-service:
POST /api/v1/pim/setup/enable(authenticated org user) provisions DDL + seeds default channels + flipsorganizations.settings.modules.pim. - Super admin:
/admin/tenants/{slug}/modulescan toggle PIM for any tenant.
CRM / ERP / Marketing wiring
- ERP sync: nightly
erp-syncmirrors ERP master SKUs intoerp_productsand upserts unifiedproductsrows when PIM is enabled (source = erp). - Marketing segments: audience builders can filter on
products.attributesJSON and linked ERP facets — treat PIM-enriched attributes as first-class segment predicates alongside CRM fields (evaluate against tenantproductsrows). - Automations: steps
pim_publish_productandpim_enrich_productship in the workflow registry.
OAuth scopes
Machine clients may request:
pim:read,pim:write,pim:assets:write,pim:publish
Deprecated API
Legacy GET/POST /api/v1/products (global products.env table + x-org-id) is retired. Use /api/v1/pim/products with a normal session or Bearer token — tenant routing uses Auth.js org context, not custom headers.