Yes—catalog-gap monitoring can prepare a distributor’s assortment review, but it cannot decide what to add. A “missing” item becomes a human review candidate only after the compared item is identified, its taxonomy and variant are aligned, the supplier or manufacturer catalog is complete for the stated scope, and the apparent absence is not a temporary availability state.
This guide is for a distributor merchandising or data-services owner who must decide which proposed assortment gaps deserve a buyer’s time. The deliverable is a small evidence ledger and a review queue, not a replenishment order, demand forecast, supplier recommendation, price comparison, or claim that IPHTML observes any particular catalog. A licensed feed, an official API, a supplier export, or direct approved access is usually the better route when it supplies the needed evidence.
Start with the decision and the unit of review
Write one review row before collecting: market | channel | category | candidate item/variant | identifier | reference catalog | compared catalog | observation time | owner. The buyer’s question is deliberately narrow: “Is there enough current, comparable catalog evidence to investigate whether this item or variant belongs in our assortment?” It is not “Will it sell?” and it is not “Does an unavailable listing prove a gap?”
Agree the deliverable in advance: a dated candidate list; each row’s evidence and disposition; the coverage denominator; and one named reviewer. A useful acceptance rule is that every REVIEW row has a stable or documented identifier, an aligned category and variant, declared COMPLETE_CURRENT coverage for both the reference and compared catalogs, confirmed ABSENT_CONFIRMED membership in the compared catalog, and an in-stock comparable reference. A confirmed PRESENT record becomes NO_GAP only after those comparability checks pass; unknown membership and every other unresolved condition remain HOLD.
| Input | Why the reviewer needs it | What it cannot establish |
|---|---|---|
| Reference item, variant and identifier | Defines the thing being considered. | Demand, margin, supplier approval or a same-item match by title alone. |
| Reference and compared taxonomy mapping | Makes category scope visible before calling absence a gap. | That two similar labels represent the same merchandise. |
| Two declared coverage denominators, compared-catalog membership and extraction time | Shows that both reference and compared catalogs are complete/current for their stated market, channel and records, and whether the candidate is confirmed absent. | That omitted pages, regions or seller accounts contain nothing relevant. |
| Current availability state | Separates a temporary listing state from an assortment decision. | Future supply, demand, or fulfillment eligibility. |
Do not collapse five different reasons for an apparent gap
An item absent from one result set has several plausible explanations. The following offline matrix is synthetic: it contains no retailer, supplier, sales, stock, or customer data. Its purpose is to prevent a queue from quietly treating uncertainty as a product opportunity.
| Row | Observed evidence | Disposition | Reason |
|---|---|---|---|
| A | Identifier and variant match; taxonomy aligned; declared source coverage complete; current reference is in stock; no comparable item in the compared catalog. | REVIEW | A real human-review candidate—not a conclusion to list, buy, or forecast. |
| B | Title looks similar, but identifier is unknown. | HOLD | May be a missing comparable item or merely an identity mismatch. |
| C | Identifier and variant match, but categories map differently. | HOLD | Resolve the taxonomy mapping before comparing assortments. |
| D | Compared source covers only one channel or partial category pages. | HOLD | Incomplete coverage cannot prove absence. |
| E | Comparable item is marked out of stock, preorder, or backorder. | HOLD | This is a temporary or non-current purchasing state, not a gap verdict. |
| F | Availability is missing or observation currency is unknown. | HOLD | Do not infer an availability or assortment state. |
| G | Identifier matches, but the variant does not. | HOLD | A present parent family cannot settle a mismatched variant. |
| H | All comparability checks pass and the comparable item is confirmed present in the compared catalog. | NO_GAP | It is not an absence candidate. |
| I | Compared-catalog membership is unknown. | HOLD | Unknown is not absence. |
| J | Membership says present, but the variant mismatches. | HOLD | Do not let present membership bypass comparability. |
| K | Compared-catalog coverage is stale. | HOLD | Both catalogs must be complete and current. |
The important denominator is not the number of rows returned. It is two declared universes: for example, “approved supplier X’s active US wholesale catalog, categories Y–Z, observed at time T” and the named compared catalog under the same stated review context. Both must be COMPLETE_CURRENT. If either catalog is partial, inaccessible, stale, or not authorized for that use, stop the gap claim. A proxy may be relevant only for an already authorized, location-specific observation; it never supplies catalog completeness, identity, membership evidence, or permission.
Use identifiers and variants as evidence, not magic matching keys
GS1 defines GTIN for identifying trade items; it can strengthen a record’s identity evidence, but it does not replace evidence for pack, variant, market, or catalog scope. A missing, reused, unverified, or differently scoped identifier must not be repaired with a title match. Google Merchant Center’s product guidance likewise separates a unique item ID from an item-group ID that groups actual variants; its availability guidance distinguishes in_stock, out_of_stock, preorder, and backorder. These are useful data-model examples, not a universal catalog taxonomy or proof about any other seller.
- Normalize only declared fields: identifier type/value, brand when available, pack or unit, variant attributes, and source taxonomy version.
- Map each source category to a documented local category. Keep an unmapped or many-to-one mapping as
HOLD. - Compare the same variant, not merely the parent family. A missing color, size, memory, pack, or format may be a variant decision rather than a missing product.
- Record coverage: source route, permitted scope, market/channel, expected record count or page range, retrieval time, and exclusions.
- Send only
REVIEWcandidates to the merchandising owner, who can consider supplier terms, compliance, demand research, margin, and business strategy outside this monitor.
Choose the least intrusive source route that can answer the question
For a distributor’s own or partner-authorized catalog, first ask whether an official feed/API, licensed export, supplier report, or direct approved portal view supplies the declared IDs, variants, coverage and update evidence. Keep that route if it does. A monitoring service has a narrower role only when an authorized source lacks the needed, documented comparison delivery path; its permission, scope, cadence, retention and stop conditions still need an owner. The public data-source selection worksheet covers the broader source-admission decision.
Hand the buyer a decision-ready row—not a recommendation
For each confirmed gap, create a handoff that can open an assortment meeting without hiding the next work. The row below is a blank decision method, not evidence that any named item should be listed.
| Handoff field | What to record | Buyer action |
|---|---|---|
| Confirmed catalog gap | Reference item/variant, identifier evidence, compared catalog, declared denominator, both observation times, and ABSENT_CONFIRMED. | Check that the candidate is truly within the assortment scope. |
| Category rationale | The documented taxonomy mapping and why this variant—not merely its parent family—belongs in the review category. | Accept, change, or reject the mapping. |
| Commercial evidence still needed | Blank/unknown fields for supplier terms, compliance, demand research, margin, lead time, and local strategy. | Assign owners or decide not to investigate; never fill unknown with a monitor result. |
| Owner and next action | Named merchandising owner, review-by date, approved next check, and a close/hold reason. | Record the human outcome; do not trigger an automatic listing or purchase. |
REVIEW means the catalog evidence cleared this narrow admission gate. It does not mean an item has demand, a viable margin, compliance approval, supplier availability, a listing decision, or positive return on investment.
Do not add a proxy merely because a catalog is difficult to compare. If a permitted workflow genuinely needs a network location to observe a specified market, review IPHTML residential proxy information and contact the team with the authorized source category, markets, fields, cadence, coverage denominator, and stop conditions—never credentials or customer data. The service should be evaluated against that stated task, not assumed necessary.
Run the offline disposition fixture before designing a service
Download the catalog-gap offline example and test script and run it with Python 3.9 or later:
python3 catalog-gap-assortment-review.pyIt uses only the standard library, has no configuration, makes no network calls, and changes no system. The deterministic synthetic rows produce exactly one REVIEW candidate, one NO_GAP row where membership is confirmed present after comparability passes, and nine fail-closed HOLD counterexamples for unknown identity, taxonomy mismatch, incomplete reference coverage, stale compared-catalog coverage, temporary availability, unknown availability, variant mismatch, unknown membership, and a misleading present record with a mismatched variant. It cannot verify a real feed, API, catalog, contract, completeness claim, demand, sales, margin, or IPHTML performance.
Keep adjacent decisions separate
This page owns recurring evidence for an assortment-review queue. It does not compare sellable basket prices, issue regional restock alerts, decide whether a monitoring service is economical, or choose a public data source generally. For those distinct decisions, see the comparable-price monitoring guide, regional stock-alert policy, market-monitoring service feasibility guide, and public data-source selection worksheet.
Sources checked November 10, 2026: GS1: What is the GTIN?; Google Merchant Center’s item group ID and availability guidance. They describe GS1 and Merchant Center concepts, not a distributor’s catalog, permitted access, completeness, demand, sales, supplier terms, or IPHTML capability. The matrix and fixture are synthetic editorial methods.