# GS1 Link Resolver

*/Software/GS1_Link_Resolver*

## Solution Overview

GS1 Link Resolver processes standard GS1 Digital Link URIs scanned from physical product packaging and routes the request to a context-specific destination. It translates a single 2D barcode scan into distinct data payloads, directing consumer smartphones to allergen information, point-of-sale systems to pricing APIs, and warehouse scanners to batch-level recall status. The system produces a dynamic routing layer that links a single physical Global Trade Item Number to multiple digital endpoints based on the device, location, and identity of the scanner.

Brand compliance officers and supply chain architects integrate this routing engine to transition from legacy one-dimensional UPC barcodes to data-rich 2D codes. The resolver eliminates the need to print multiple conflicting QR codes on a single label to satisfy separate marketing, regulatory, and inventory requirements. By managing the redirection logic centrally, manufacturers map dynamic attributes like expiration dates and serial numbers to specific downstream web resources without altering the physical packaging.

Operating as a Headless SaaS primitive, the software consumes master data feeds, product taxonomy rules, and regulatory schemas directly from enterprise ERP platforms. Above it, retail mobile applications, automated fulfillment agents, and third-party traceability dashboards query its REST API to resolve the physical scan into the correct JSON payload or HTML page. Human administrators define the foundational routing rules in the control plane, ensuring that safety-critical items like pharmaceuticals strictly resolve to their legally mandated data sheets.

## Headless Saas Data Model

**Entities**:
- Name: RoutingRule · Description: Defines the logic mapping a scanned GS1 Digital Link context to a destination
- Name: TradeItem · Description: The physical product identified by a Global Trade Item Number (GTIN)
- Name: Destination · Description: The downstream web resource or API payload a scan resolves to
- Name: ResolutionEvent · Description: A log of a scanned GS1 URI resolving via the routing engine
- Name: Workspace · Description: The tenant container for a brand or manufacturer's resolver setup
**Relations**:
- To: TradeItem · From: RoutingRule · Label: applies to · Cardinality: many-to-many
- To: Destination · From: RoutingRule · Label: routes to · Cardinality: many-to-many
- To: RoutingRule · From: ResolutionEvent · Label: triggered by · Cardinality: many-to-many
- To: Workspace · From: RoutingRule · Label: belongs to · Cardinality: many-to-many
- To: Workspace · From: TradeItem · Label: belongs to · Cardinality: many-to-many
- To: Workspace · From: Destination · Label: belongs to · Cardinality: many-to-many
- To: Workspace · From: ResolutionEvent · Label: belongs to · Cardinality: many-to-many
**Tenant Anchor**: Workspace
**Primary Resource**: RoutingRule

## Api Definition

**Protocols**:
- REST
- SDK
- MCP
- Webhooks
**Consumed By**:
- [Automated Fulfillment Agent](/Agents/Automated_Fulfillment_Agent)
- [Traceability Sync Agent](/Agents/Traceability_Sync_Agent)
- [Compliance Audit Agent](/Agents/Compliance_Audit_Agent)
- [Retail Inventory Agent](/Agents/Retail_Inventory_Agent)
**Integrations**:
- [SAP S/4HANA](/Products/SAP_S%252F4HANA)
- [Salsify](/Products/Salsify)
- [Oracle NetSuite](/Products/Oracle_NetSuite)
- [GS1 Global Registry](/Products/GS1_Global_Registry)
**Consumption Model**: A fulfillment agent registers the MCP server to pass scanned GS1 URIs natively as tools, instantly receiving the context-specific destination payload while the resolver asynchronously records the ResolutionEvent via REST.
**Workflow Wrappers**:
- Name: Resolve Scan URI · Wraps: evaluates the scanned URI against context rules, logs the event, and returns payload
- Name: Batch Provision Items · Wraps: ingests ERP GTIN data, creates TradeItems, and attaches baseline RoutingRules in one transaction
- Name: Trigger Recall Route · Wraps: overrides active RoutingRules for a TradeItem batch to instantly redirect scans to safety data

## Api Function Cascade

**Ai Role**: The primitive operates entirely as a deterministic, straight-through code pipeline to guarantee sub-millisecond standard compliance, relying exclusively on automated rule evaluation without human intervention or generative processing in the resolution path.
**Cascade**:
- Kind: Code · Note: Receives GS1 Digital Link URIs via REST or MCP. · Step: Parse Scan URI · Verb: ingest · Realizes: Ingest Request Data · Oversight: none
- Kind: Code · Note: Fetches GTIN data from SAP S/4HANA or Salsify caches. · Step: Retrieve TradeItem Context · Verb: fetch · Realizes: Retrieve Product Information · Oversight: none
- Kind: Code · Note: Applies context parameters and active recall overrides. · Step: Evaluate Routing Logic · Verb: evaluate · Realizes: Evaluate Business Rules · Oversight: none
- Kind: Code · Note: Constructs and returns the resolved endpoint payload. · Step: Return Destination Payload · Verb: format · Realizes: Format Output Data · Oversight: none
- Kind: Code · Note: Asynchronously logs the event and fires configured webhooks. · Step: Record Resolution Event · Verb: log · Realizes: Record Transaction Data · Oversight: none
**Optimizes**:
- [URI Resolution Latency](/Metrics/URI_Resolution_Latency)
- [Routing Rule Accuracy](/Metrics/Routing_Rule_Accuracy)
- [API Uptime Percentage](/Metrics/API_Uptime_Percentage)
- [System Event Throughput](/Metrics/System_Event_Throughput)

## Headless Saas Representative Offer

**Warranty**: Maintains a 99.99% API uptime guarantee for scan resolutions, issuing prorated billing credits if global edge latency exceeds 50 milliseconds.
**Price Band**: ~$0.0001 to ~$0.005 per GS1 URI resolution or batch provisioning event, depending on contextual routing complexity
**Pricing Kind**: UsageMeter
**Deliverables**:
- Scan URI resolution REST API and MCP server endpoints
- TradeItem batch provisioning data pipeline access
- Emergency recall route override controls
- Asynchronous ResolutionEvent webhook delivery
**Delivery Mode**: The buyer or agent provisions API keys and MCP server access instantly via a self-serve developer portal, with consumption metered automatically upon endpoint execution.
**Business Function**: ProvideService
**Agent Checkout Support**:
- agentic-commerce-protocol
- stored-credential

## Headless Saas Crud Surface

**Auth Model**: API Key
**Endpoints**:
- GET /routing-rules — list routing rules
- POST /routing-rules — create a routing rule
- GET /routing-rules/{id} — fetch a routing rule
- PATCH /routing-rules/{id} — update a routing rule
- GET /routing-rules/{id}/trade-items — list trade items governed by a routing rule
- GET /routing-rules/{id}/destinations — list destinations targeted by a routing rule
- GET /routing-rules/{id}/resolution-events — list resolution events triggered by a routing rule
- GET /trade-items — list trade items
- POST /trade-items — create a trade item
- GET /trade-items/{id} — fetch a trade item
- PATCH /trade-items/{id} — update a trade item
- GET /destinations — list destinations
- POST /destinations — create a destination
- GET /destinations/{id} — fetch a destination
- PATCH /destinations/{id} — update a destination
- GET /resolution-events — list resolution events
- POST /resolution-events — log a resolution event
- GET /resolution-events/{id} — fetch a resolution event
- GET /workspaces — list workspaces
- POST /workspaces — create a workspace
- GET /workspaces/{id} — fetch a workspace
- PATCH /workspaces/{id} — update a workspace
- GET /workspaces/{id}/routing-rules — list routing rules belonging to a workspace
- GET /workspaces/{id}/trade-items — list trade items belonging to a workspace
- GET /workspaces/{id}/destinations — list destinations belonging to a workspace
- GET /workspaces/{id}/resolution-events — list resolution events belonging to a workspace
**Multitenancy**: Row-level isolation
**Webhook Events**:
- routing_rule.activated
- trade_item.registered
- destination.updated

## Headless Saas Erd

```mermaid
erDiagram
  RoutingRule {
    UUID id PK
    UUID workspaceId FK
    UUID tradeItemId FK
    UUID destinationId FK
    VARCHAR contextType
    DECIMAL priority
    BOOLEAN isActive
  }
  TradeItem {
    UUID id PK
    UUID workspaceId FK
    VARCHAR gtin
    VARCHAR productName
    VARCHAR lifecycleState
  }
  Destination {
    UUID id PK
    UUID workspaceId FK
    VARCHAR name
    VARCHAR targetUrl
    VARCHAR responseType
    JSONB payloadTemplate
  }
  ResolutionEvent {
    UUID id PK
    UUID workspaceId FK
    UUID routingRuleId FK
    VARCHAR scannedUri
    VARCHAR deviceType
    TIMESTAMP resolvedAt
  }
  Workspace {
    UUID id PK "Tenant Key"
    VARCHAR name
    VARCHAR gs1CompanyPrefix
    TIMESTAMP createdAt
  }
  RoutingRule }o--o{ TradeItem : "applies to"
  RoutingRule }o--o{ Destination : "routes to"
  ResolutionEvent }o--o{ RoutingRule : "triggered by"
  RoutingRule }o--o{ Workspace : "belongs to"
  TradeItem }o--o{ Workspace : "belongs to"
  Destination }o--o{ Workspace : "belongs to"
  ResolutionEvent }o--o{ Workspace : "belongs to"
```

## Neighborhood

### Composed into

- [Supplier Sourcing Agent](/Agents/Supplier_Sourcing_Agent) — composes · Agents

### Optimizes

- [URI Resolution Latency](/Metrics/URI_Resolution_Latency) — optimizes · Metrics
- [API Uptime Percentage](/Metrics/API_Uptime_Percentage) — optimizes · Metrics
- [Routing Rule Accuracy](/Metrics/Routing_Rule_Accuracy) — optimizes · Metrics
- [System Event Throughput](/Metrics/System_Event_Throughput) — optimizes · Metrics

### What it uses

- [GS1 Global Registry](/Products/GS1_Global_Registry) — uses · Products
- [Oracle NetSuite](/Products/Oracle_NetSuite) — uses · Products
- [Salsify](/Products/Salsify) — uses · Products

### Who consumes this

- [Automated Fulfillment Agent](/Agents/Automated_Fulfillment_Agent) — consumed by · Agents
- [Compliance Audit Agent](/Agents/Compliance_Audit_Agent) — consumed by · Agents
- [Retail Inventory Agent](/Agents/Retail_Inventory_Agent) — consumed by · Agents
- [Traceability Sync Agent](/Agents/Traceability_Sync_Agent) — consumed by · Agents

### Similar Software

- [GS1 Standards Resolver](/Software/GS1_Standards_Resolver) — similar · Software
- [EPCIS Repositories](/Activities/Receiving/Software/EPCIS_Repositories) — similar · Software
- [Warehouse Management Systems](/Activities/Repackaging/Software/Warehouse_Management_Systems) — similar · Software
- [Enterprise Resource Planning](/Activities/Receiving/Software/Enterprise_Resource_Planning) — similar · Software
- [Machine Vision Software](/Activities/Inspecting/Software/Machine_Vision_Software) — similar · Software
- [Barcode Scanning Software](/Activities/Assembling/Software/Barcode_Scanning_Software) — similar · Software
- [Supplier Management Software](/Metrics/Total_cost_to_perform_the_process_"manage_suppliers"_per_goods_receipt_received/Software/Supplier_Management_Software) — similar · Software
- [SMPP Gateways](/Resources/Carrier_network_integrations/Software/SMPP_Gateways) — similar · Software
- [Ingestion Routing Engine](/Software/Ingestion_Routing_Engine) — similar · Software
- [GitHub Enterprise](/Metrics/Requirements_Traceability_Index/Problems/Delayed_Product_Certification/Competitors/Atlassian_Jira/Software/GitHub_Enterprise) — similar · Software
- [Source Code Repositories](/Metrics/Requirements_Traceability_Index/Software/Source_Code_Repositories) — similar · Software
- [IoT Edge Gateways](/Software/IoT_Edge_Gateways) — similar · Software
- [Real-Time Tracking API](/Software/Real-Time_Tracking_API) — similar · Software
- [Warehouse Execution API](/Software/Warehouse_Execution_API) — similar · Software
- [Application Lifecycle Management](/Metrics/Requirements_Traceability_Index/Software/Application_Lifecycle_Management) — similar · Software
- [SCADA Systems](/Metrics/Production_Schedule_Adherence/Software/SCADA_Systems) — similar · Software
- [Distributed Inventory Feed](/Software/Distributed_Inventory_Feed) — similar · Software
- [Vendor Resolution Engine](/Software/Vendor_Resolution_Engine) — similar · Software

### Similar Places

- [Digital Endpoin](/Places/Digital_Endpoin) — similar · Places

### Similar Agents

- [Gateway Ingestion API](/Agents/Gateway_Ingestion_API) — similar · Agents