Jumia WhatsApp Importer

Your ZIP was read successfully. Choose the one calendar day you want to process.

Accuracy rule: generated fields are editable. Brand becomes Generic when no brand is stated. Weight is deliberately conservative. Color is taken from supplier text when stated; otherwise the browser samples the matched product image and suggests a common color name for you to verify.

Category rule: the generated category is still a suggestion. Stage 5 now binds the batch to the exact columns of the current category template you upload; it never invents category IDs.

Taxonomy-aware matching: the app first identifies the likely Jumia department (for example Home & Office for kitchen tools), then ranks the most relevant leaf categories. If the right option is not in the suggestions, use the built-in search across all synced Jumia categories. Your corrections are remembered.

Your saved official templates remain available as a fallback/reference only. Stage 17 does not require you to download Fashion, Home & Office, Electronics or other templates manually.

Mixed batch mode: the app compares each product against every saved official Jumia template, assigns the strongest matching template/category, and keeps each product attached to that template through image hosting, pricing, validation and export.

Example: mugs can go to Home & Office while dresses go to Fashion in the same WhatsApp batch. At the end you get separate Jumia XLSX workbooks plus one Jumia_Ready_Uploads ZIP.

Use this only for a single-category/section batch. Stage 14 above is recommended for mixed categories. For manual use, in Jumia Vendor Center go to Products → Manage Products → Import / Export → Product → Download template, choose the category for these listings, then upload that downloaded .xlsx here. The app reads the workbook locally and does not replace Jumia's template structure.

For this build, use samples/REAL_JUMIA_TEMPLATE_FROM_VENDOR_CENTER.xlsx — the real workbook you supplied from Vendor Center.

What this stage does: the browser reads the exact matched WhatsApp image, normalizes it to a 1200 × 1200 JPEG without cropping, and the Python backend uploads it to your own public Supabase Storage bucket. The resulting HTTPS URL is inserted directly into MainImage and Image2–Image8.

Important image-quality rule: technical resizing does not magically remove a bad background or restore missing detail. Jumia requires a pure-white main-image background, the full product visible, no text/watermarks, and 500–3000 px dimensions. Stage 7 checks dimensions and public reachability, but you still visually approve the image.

Secret safety: the Supabase secret never enters this web page. In live mode, the Supabase secret is stored only as a protected server environment variable and never enters this web page.

Same calculator rules: fixed KSh 100 fare, default KSh 20 packaging, 35% net-margin target plus KSh 400 minimum net profit, category commission, and Drop-shipping/Jumia Express logistics fees. Start typing in Product Type to search the full mapped pricing list; the confirmed live Jumia category is used as the strongest hint.

Every product is matched independently against the exact Categories sheet from the uploaded Jumia workbook. Strong matches are selected automatically; uncertain ones stay marked for review.

Each product is checked before it can be published. Category, required attributes, hosted images, Seller SKU, stock and pricing must all pass.

Direct Jumia API publishing: this sends QC-passed products to Jumia using the official product-creation feed. Start with one real product, wait for Jumia's feed result, then publish the remaining products.

The app checks Seller SKU duplicates before submission. A product is synced to Arizona254 only after Jumia returns a successful product result.

Production mode uses HTTPS hosting, backend-only Supabase secrets, password protection, and cloud import history.

A successful final XLSX export is recorded in persistent history. In live mode this history is stored in Supabase, so duplicate protection follows you across devices.