PIM Admin (operators)

PIM Admin — the operator workspace

PIM Admin is the EcomCart operator workspace. It's where the shared catalogue (the canon), supplier imports, companies, plans and translation engines are maintained. This section is for EcomCart staff. If you're a store owner, you want the user guide. How it differs from the company app - PIM Admin has a separate address, reachable only from the EcomCart internal network (VPN). Only platform operators can sign in. - It uses an amber colour scheme so it isn't confused with the company app (blue). - By default you work with the canon — the shared catalogue without any company's data. The header shows VPN and canon chips. - Company sections (Stores, Settings, API documentation) aren't in Admin — they live in the company app. - To see a specific company's data, use View as company. Menu | Group | Sections | |---|---| | — | To-do | | Input | Suppliers, Dedup | | Canon | Products, Categories, Properties, Options, Manufacturers, Convergence, Media | | Enrichment | Source suggestions, AI suggestions | | Translation | Overview, Lists, Review | | Business | Companies, Plans, Users, All data, Engines, Prices and usage | | bottom | System monitor, Audit log | ⌘K / Ctrl+K — search and commands, as in the company app.

To-do

To-do is the PIM Admin home page. The data refreshes every minute. Figures at the top import errors, source suggestions, outdated translations, Batch in progress and MT margin this month. Needs attention The list is sorted by severity. Each row leads to the page where you fix the problem. Errors: - import failed (the latest run of each feed in the last 24 h); - import stuck in running for more than 3 h; - rows skipped in the last import; - translation Batch failed (last 7 days). To decide: - source suggestions waiting for approval (per supplier); - translation Batches still processing; - convergence candidates; - duplicate clusters; - engines without a price. Other blocks - Imports in the last 24 h; - System — queues, translation scan, media ingest, search engine, database; - Translation economics — cost, price for companies and margin. Shortcuts J / K — down / up the list, Enter — open.

Connecting suppliers and imports

Open Input → Suppliers. The list Buttons: Import all, Suspend all, Progress, New. The list can be sorted by arbitration order: the top supplier wins each field; with equal priority the lowest ID wins. Fields changed by a person or locked are never overwritten. Row actions: View, Import, Suspend, Open card, Edit, Delete. Supplier card - Check access — checks the source is reachable with the stored credentials; - Run now — runs an import outside the schedule; - tabs: Runs, Mapping, Offers, Companies, Log; - the next scheduled run is shown. Setting up a new supplier (Edit) 1. Basic data — code, name, country, currency. 2. Import connection — format (XML, CSV, Excel, JSON, API) and address. 3. Accounts and access — credentials (stored encrypted). 4. Text cleanup — stripping stray HTML, whitespace, etc. 5. Schedule and network — a cron expression in Riga time. Avoid 03:00–04:00 (daylight-saving change). Empty = no automatic import. If the previous run is still going, the next one is skipped. 6. Companies — which companies get new products added automatically. 7. Data file and field mapping — which source field goes where. 8. Import options and Updating existing products — incl. Disappearance from feed (default safety threshold 20%: if more disappear, products aren't retired). 9. Arbitration priority. 10. Notes. At the bottom: Run history (status, started, rows ok/total, errors, counters), the Run import button and Image fetching → Fetch missing. Mappings and vocabulary - Mappings — supplier categories → our categories. Filter unmapped only. Unmapped ones stay as a backlog. - Supplier vocabulary — link Unmapped axes to attributes (Link, with a suggestion); Import-created values — values the import created, rarest first. - Manufacturer and attribute-value mapping — still being built.

Duplicates (Dedup)

Open Input → Dedup. Product duplicates Two canon products with the same GTIN or MPN. Choose: - Merge — combine into one product; - Reject — they aren't duplicates. Merges are recorded in the audit log. Check queue A supplier row that looks like an existing product, but the system isn't sure. Choose: - Merge — attach to the existing product; - New product — create a new one; - Reject. Staging log The last 3 runs per supplier: new, matches, for checking, rejected.

The canon — categories, properties, options, manufacturers

The Canon group is the structure of the shared catalogue that every company sees. Products The canon product list. New product creates a canon product (a draft). Categories The canonical category tree. New subcategory, Expand all. Companies only view the tree. Properties (Attributes) Tabs Attributes, Families, Groups. - Types: Text, Long text, Number, Yes/No, Select, Multi-select, Date, Price. - Flags: filter, variant, localisable. - On the attribute page: Basic data, Type and units, Names by language, Value vocabulary, Value merging, Compound value → parts, Vocabulary log (each entry can be Undone), Supplier spellings (aliases), Danger zone → Merge attributes (last resort only). - Family — which attributes are Included and which Required (required ones count towards completeness). - Group — code, order and names; sets the order of properties on the product card and in the store specification. Options Product variant axes (colour, size, etc.). Search by SKU or code. Manufacturers The canonical manufacturer register. Media The DAM library: all images, videos and documents. Filters Used / Unused. Uploads up to 64 MB per file (JPG, PNG, WebP, AVIF, GIF, SVG, PDF, MP4, WebM, MOV).

Convergence

Different suppliers call the same property different things ("Krāsa", "Colour", "Spalva"). Convergence finds such candidates. Open Canon → Convergence. - Tabs: Open, Rejected, Approved. - Kinds: attribute or value. - The Similarity and Signals columns show why a candidate was found. Actions - View — opens the attribute page with a preview; decide about merging there. - Reject — they aren't the same thing. Nothing is merged automatically. Candidates are detected every Monday at 03:30. Unreviewed candidates are closed nightly and found again later.

Source and AI suggestions

Source suggestions Enrichment → Source suggestions — values from reference sources (e.g. Open Icecat). An accepted value is used only where no supplier provides one. - Tabs: Awaiting decision, Accepted, Rejected, Superseded. - Filters: Field, Supplier, Link (Icecat ID, EAN, EAN (duplicates), Brand + MPN), Language, Source, Brand. - Actions: Accept selected, Reject selected, "… all by filter", Undo selected. Follow the Icecat licence attribution requirement (shown on the page). AI suggestions Enrichment → AI suggestions — the same as for companies (see AI suggestions), but for the canon: Confirm / Reject, runs for 1–1000 products. Operators also see the AI tool's name.

Companies, plans and users

Companies Business → Companies (the Tenants page). 1. New tenant. 2. Fill in Name, Slug, Plan, Status (Active / Suspended). 3. Save. Then add the owner under Users (below). Master tenant — only one; it may write to the canon from the company app and ignores the /api/v1 limits (the ?sync=1 limit still applies). Turning it on for one company turns it off for the previous one. Suspend (in the row menu) — the company's users get 403 (they can only sign out or switch company), and its API keys get 403 too. Plans Business → Plans: - Monthly price; - Limits: Products, Channels, Languages, MT quota (segments per month, 0 = unlimited); - API limits: Requests/min, Units/min; - Features: AI enrichment, Dedup, Publishing API, Webhooks, Extended roles. A plan used by any company can't be deleted. Users Business → Users. On a user's page, Add tenant / Remove manage which companies the user belongs to and in which role. The Platform operator checkbox exists only when creating a user — it can't be changed from the UI later. All data Business → All data — data across all companies: catalogue by provenance source, by company, recent imports. Browse all items opens the list of all items.

Translation engines, prices and markup

Engines Business → Engines (Translation engines). An engine without credentials (an API key) runs as a mock — no paid calls happen by accident. Engine fields: - Key — a unique code (fixed after creation); - Level — Economy, Quality or Baltic; - Mode — Real-time or Batch; - Enabled; - Available to plans (none ticked = all); - Options (JSON). Test connection checks the key. Deleting an engine moves its companies to the mock. Prices and usage Business → Prices and usage (Translation prices). - Sale price = cost × (1 + markup). - Markup: company → plan → global. An empty plan field = global; an empty company field = plan. - Price table (costs) — changing a price adds a new row with a later Valid from date (history is kept). - A usage table per company and month: Costs, Sales, Margin. Companies only see their sale price, never the cost or margin. An engine without a price shows up in To-do.

View as company

View as company lets an operator look at a specific company's data (assortment, its changes, publications) — read-only. Turning it on 1. Press ⌘J / Ctrl+J or the button in the top bar. 2. Search for the company name or slug. 3. Choose the company. Every page then shows a bar at the top: Viewing as: [company] · read-only, writing is disabled · Exit view · Switch company. Restrictions - Nothing can be changed. Every save is refused with Nothing can be changed in view mode — first exit "View as". - The mode ends after 12 hours. - Starting and stopping are recorded in the audit log. Leaving Click Exit view in the bar or Back to Canon in the dialog.

System monitor and audit log

System monitor At the bottom of the sidebar, System monitor. It refreshes every 30 seconds (or click Refresh): - background job queues and Failed jobs; - Scheduler — when each scheduled task last ran; - Imports 24 h; - search engine, database and Disks. Audit log At the bottom of the sidebar, Audit log — a record of who changed what. Filters: Entity, Action, User, Tenant, From, To. Click View to see a change's details. Operators see all companies; company users see only their own.