Mexico catalog.
The Mexico catalog combines a Norday file feed with the Impressline API. Both sources are Spanish-first, so translation and cleanup are part of the catalog pipeline.
Snapshot
| Customer-facing tab | MX |
| Catalog ID | MX |
| Main inputs | Norday JSON file feed in Google Cloud Storage and Impressline product/stock API. |
| Default visibility | Mexico feed products are generally published once normalized, unless an override changes visibility. |
| Currency handling | Source pricing is converted into USD during the sync. |
Input Sources
Norday is a static JSON file feed stored in Google Cloud Storage. PerkUp reads the whole file, translates Spanish names/descriptions into English, and builds catalog products from the normalized rows.
Impressline is an API. PerkUp fetches a product list, then asks the stock/detail endpoint for each product. Impressline provides product information, images grouped by color, price, category, print types, and stock details.
Available vs Stored Data
| Source data available | What PerkUp stores |
|---|---|
| Norday sends product IDs, codes/SKUs, Spanish names and descriptions, categories/collections, preview images, image URLs, prices, discounts, and some inventory-like fields. | Product ID, SKU, English name/description, category/categories, images, USD prices, provider, full decoration level, and broad color value Various. |
| Impressline sends product details in Spanish, category, price, images by color, print types, and stock endpoint data. | Translated/cleaned name and description, categories, images, USD prices, color options inferred from images, markings, provider, and published visibility. |
| Both sources contain more raw supplier detail than the catalog page needs. | Raw step data remains in bulkSwagProductInputs; customer-facing browsing uses bulkSwagProducts. |
AI Enrichment
- AI helps standardize categories, package size, and imprint locations for Norday and Impressline products.
- Spanish product names and descriptions are translated into English before being stored for catalog browsing.
- Impressline color options are helped by image-based color extraction because the color data often lives in image groupings.
- The enhanced mockup image flow can improve product imagery for Mexico products, but that is separate from the supplier feed itself.
Audit Notes
- Norday and Impressline are not listed as regularly scheduled catalog jobs in the current scheduler docs, so freshness should be confirmed during the audit.
- Norday currently stores broad color information rather than detailed variant inventory.
- Best Sellers are hidden from Mexico because fulfillment assumptions differ from the US/EU/Canada catalog surfaces.
- For source quality issues, expect translation, image grouping, and inventory granularity to be the main review areas.
Source: functions/src/catalogs/bulk-swag/norday · functions/src/catalogs/bulk-swag/impressline · functions/src/catalogs/ai · proto/perkup/v1/cart.proto · apps/frontend/src/pages/bulk-swag