Frequently asked questions

Kijun is a Shopify-embedded app that turns the purchase orders you record into a monthly performance scorecard for every supplier you buy from. It surfaces who ships on time, who runs hot on defects, and how lead times are trending — purpose-built for merchants who want a dedicated supplier scorecard layered on top of Shopify's order data.

The v1 release is read-only by design: you record vendors and POs, the app computes a 0–100 score per vendor with a trend arrow. Write actions (push POs to vendors, auto-reorder) are on the roadmap.

Each vendor receives a 0–100 overall score, weighted across four metrics computed from the purchase orders you record:

Lead time is tracked and displayed alongside the score but is deliberately not composited — "ideal" lead time varies too much by category to fold into a single number.

Live scorecards use a rolling 90-day window of POs, and a background job archives a monthly snapshot per vendor so the trend arrow can compare the most recent month against the prior month.

From Shopify, on install, Kijun receives:

• Shop identity — shop domain, Shopify shop ID, shop name, plan, locale, and shop-owner email.
• OAuth session tokens — stored encrypted at rest so the app can call the Shopify Admin API on your behalf.

Inside the app, you also enter:

• Vendor records — supplier name, optional contact details, payment terms, lead time, currency, notes.
• Purchase-order records — PO number, dates, line items, quantities, unit costs, defect counts.

Kijun does not read customer names, customer emails, customer addresses, shopper order history, or any protected customer data. The app's access scopes are intentionally empty of customer-data permissions, so it has no path to that data even if a future feature tried. Full breakdown lives in the privacy policy.

Yes. Export your supplier list as CSV from your current inventory tool, then in Kijun go to Vendors → Import vendors and pick the guided wizard. Common column names — vendor_name, email, phone, payment_terms, lead_time, currency, notes — are detected automatically (Stocky exports use these names directly), so you don't need to rename or remap columns.

Kijun runs independently of any other inventory app you may have installed and does not read or write to their data. Purchase-order CSV import is on the roadmap; for now POs are entered through the app's PO form.

Pricing is published through Shopify Managed Pricing on the Kijun App Store listing — open the listing in your Shopify admin to see the current plans and any free tier or trial.

Installs onto a Shopify development store are always free; that's how merchants and partners can evaluate Kijun end-to-end before committing on a production shop.

As soon as you uninstall from Shopify admin, Shopify delivers the app/uninstalled webhook. Kijun handles it immediately — the shop is marked inactive and access tokens are revoked within minutes.

Approximately 48 hours later, Shopify delivers the mandatory shop/redact webhook. At that point Kijun deletes all of your shop's records — vendors, purchase orders, line items, scorecard snapshots, vendor-product mappings, settings, and session tokens.

Encrypted backup volumes are rotated within 30 days, so the deleted data also disappears from backups inside that window. No manual action is required from you. The privacy policy covers the full retention and deletion timeline.

Scores recompute on demand the moment you record or edit a purchase order — receipts, defect counts, and price changes are reflected the next time you load the Scorecard page. There's no overnight lag for the live numbers.

A daily background job also writes a VendorScoreSnapshot for each vendor so the trend arrows (improving / stable / declining) on the Scorecard can compare this month against last month. The live score uses a rolling 90-day window of POs.

Yes — through a mix of free and Pro features. Every merchant on the Free plan can pick from seven industry presets in Settings: Recommended (a balanced 40 / 30 / 15 / 15 default), Fashion / Apparel, Food / Beverage, Electronics, Cosmetics / Beauty, Home / Furniture, and Wholesale / B2B. Each preset re-weights the score for a different sourcing profile.

The Pro plan unlocks Custom weights, so you can fine-tune the four metric weights yourself — on-time delivery, defect rate, price stability, and completion rate — for your exact business model. The weights must sum to 100, and the form blocks saves that don't.

The Scorecard recomputes live after you save, so you can A/B a heavier weight on defects (for example) and immediately see how the rankings move without waiting for the nightly snapshot. Open Settings in the app to explore the presets.

Yes. Each vendor and each purchase order carries its own currency field, and the currency is shown next to PO totals in the UI so you always know what unit you're looking at.

The scorecard metrics themselves are currency-agnostic — on-time delivery, defect rate, price stability, and completion rate are ratios and counts, not money — so a vendor priced in USD and another in JPY can be compared on the same 0–100 scale without any FX conversion.

Email support@kijun.app. Response target is 48 business hours. Please include your shop domain (the *.myshopify.com URL) and a short description of what you're seeing — a screenshot helps when reporting a UI issue.

For data-subject access or deletion requests under GDPR / CCPA / PDPA, the same email address is the right channel — see the privacy policy for the full list of rights and the response window.

The Terms of Service and privacy policy together cover billing, cancellation, data handling, and your rights as a merchant.