Skip to main content
Tuğrul Yıldırım
By Tuğrul Yıldırım

GTIP / HS Code Classification & Customs SaaS | GtipTakip

Explore a SaaS for explainable GTIP classification, landed-cost calculation, compliance checks, regulatory alerts, bulk workflows, API and MCP.

Technologies Used

Laravel, livewire, tailwindcss
GTIP / HS Code Classification & Customs SaaS | GtipTakip
Laravel 13 Livewire 4 SaaS Customs Intelligence GTIP / HS Classification Compliance API / MCP AI-Assisted

Customs Classification, Landed Cost and Compliance SaaS

GtipTakip is a SaaS platform I designed and developed to turn one of the most fragmented parts of international trade into a structured digital workflow: identifying the correct GTIP / HS classification for a product, evaluating its import cost, checking regulatory obligations and monitoring future changes.

The platform goes significantly beyond a tariff-code search engine. A product can become a persistent operational record containing its technical description, SKU or GTIN, classification candidates, confirmed GTIP, reasoning history, landed-cost calculations, compliance obligations, risk assessments, regulatory watchlists and generated outputs.

GtipTakip also supports professional workflows where hundreds or thousands of products need to be classified, reviewed and tracked across multiple clients. Bulk processing, queues, team permissions, client portfolios, API access, Telegram workflows and Model Context Protocol integrations extend the application beyond manual browser-based research.

The Business Problem

Product classification affects much more than the code printed on a customs declaration. The selected tariff position can influence duties, additional measures, product-safety requirements, permits, surveillance rules and the final economic viability of an import transaction.

Yet the information required to make that decision is often distributed across tariff tables, regulatory publications, spreadsheets, product specifications, previous classifications and specialist knowledge.

Classification Uncertainty

Product names rarely map directly to one tariff code. Material, intended use, construction and technical properties can change the classification.

Fragmented Customs Data

Tariff classifications, tax measures and compliance requirements originate from different datasets and regulatory documents.

Hidden Import Cost

Purchase price alone does not reveal landed cost. Origin, freight, insurance, duties and other applicable measures can materially change unit economics.

Regulatory Change

A classification confirmed today may later be affected by a new tax, surveillance measure, compliance requirement or tariff update.

High-Volume Work

Companies and professional service teams may need to process entire product catalogs, not individual searches one at a time.

Auditability

A code without the evidence and reasoning behind it is difficult to review, correct or defend later.

From Product Description to a Controlled Customs Workflow

01

Product

Name, material, use and technical attributes.

02

Classification

Ranked GTIP candidates and reasoning.

03

Cost

Customs and landed-cost analysis.

04

Compliance

Required controls and obligations.

05

Risk

Uncertainty and BTB decision support.

06

Monitor

Watch future regulatory changes.

Explainable GTIP / HS Code Classification

The classification engine is designed around explainability rather than returning one unexplained code from an AI prompt.

Users can submit free-text product descriptions together with structured product attributes. The system normalizes the input, searches the tariff hierarchy, evaluates classification signals and returns a short ranked candidate set with confidence information and alternatives.

Classification Reasoning Chain

Section

Chapter

Heading

Subheading

12-Digit GTIP

AI-Assisted, Not AI-Only

A customs classification platform should not ask a language model to search the entire tariff and treat its first answer as authoritative.

GtipTakip reduces the search space first. Hierarchical tariff relationships, lexical product terms, verified classification signals and previously governed knowledge are used to construct a relevant candidate pool. AI can then assist with reviewing that constrained context rather than inventing a code outside it.

Normalize

Convert product language into searchable classification signals.

Narrow

Traverse the tariff hierarchy toward relevant candidate branches.

Score

Combine product terms, hierarchy and governed evidence.

Review

Present explainable candidates for human confirmation.

Classification Feedback and Governed Learning

Users can confirm or reject classification candidates. These decisions do more than update the current screen: they create signals that can improve future candidate retrieval.

Shared learning is intentionally governed. Workspace-specific evidence remains separated from shared knowledge, and reusable signals can pass validation before they influence broader classification behavior. This creates a feedback loop without treating every user click as automatically correct training data.

Product Catalog and Customs Dossier

Classification is more useful when it belongs to a persistent product record. GtipTakip includes a product catalog where customs information can evolve together with the product's operational identity.

Product Identity

Product name, SKU, GS1/GTIN and technical description can be retained as stable business references.

Classification History

Classification requests, candidates, confirmations, confidence and reasoning remain associated with the product.

Cost Scenarios

Product classification can flow directly into saved landed-cost calculations.

Compliance Checklist

Applicable obligations can become trackable product-level tasks.

Regulatory Monitoring

Confirmed tariff codes can be added to a watchlist for future regulatory changes.

BTB Preparation

High-risk or ambiguous classifications can use existing product data as the foundation for a draft BTB package.

Landed-Cost Calculation Engine

Identifying a GTIP code is only the beginning of an import decision. The platform connects classification with a structured customs-cost calculation workflow.

Calculations accept shipment and commercial context such as GTIP, origin country, product value, currency, freight, insurance, quantity, Incoterm and commercial margin assumptions.

Calculation Area Purpose
Customs Duty Evaluate supported duty rules against GTIP, origin and effective date
Additional Customs Duty Include supported additional-duty measures separately from base duty
Additional Financial Liability Keep applicable additional measures visible as independent cost components
Anti-Dumping Reflect supported product/origin-specific trade-remedy measures
VAT and Other Taxes Build the calculation from explicit components instead of one opaque total
Unit Landed Cost Translate customs and logistics inputs into per-unit commercial economics

Calculation snapshots retain the rules and source context used for each result. Unsupported or insufficiently verified rates can remain unavailable or require review instead of being presented as authoritative values.

Traceable Financial Calculations

Customs cost calculations need different engineering discipline from ordinary UI arithmetic. Values can depend on origin, date, rule version and several sequential tax components.

Decimal-Safe Math

Monetary, rate, quota and quantity logic avoids uncontrolled floating-point calculations.

Calculation Snapshots

Saved calculations retain their inputs and resolved component context for later review.

Effective-Date Rules

Supported tax and compliance rules can be evaluated against their effective period instead of assuming the latest value applies historically.

Source Traceability

A result can retain the source version or evidence behind the rule used to calculate it.

Customs Compliance and Import Obligation Workflows

The same GTIP that drives customs calculation may also trigger product-safety, permit or trade-policy requirements. GtipTakip resolves supported compliance rules into actionable obligations.

TAREKS

CE Requirements

Control Certificates

Import Permits

Surveillance Measures

Import Restrictions

Obligations can be converted into saved checklists with status tracking, creating an operational bridge between tariff research and the work that must be completed before an import proceeds.

Classification Risk and BTB Decision Support

Not every classification deserves the same level of confidence. GtipTakip evaluates signals that can indicate when a result requires additional professional review.

Low Classification Confidence

Closely Ranked Alternatives

Missing Product Attributes

Compliance Conflicts

Prior Classification Disagreement

Material Commercial Exposure

When stronger evidence is appropriate, existing classification and product information can be used to generate an editable BTB preparation draft, including the proposed classification, risk summary, product information, attention points and missing evidence.

The generated package is decision-support material, not an official binding classification.

GTIP Watchlists and Regulatory Change Monitoring

Product classification is not a one-time data-entry problem. Businesses need to know when a tariff code they already use is affected by a new classification, tax or compliance development.

GtipTakip includes workspace-scoped watchlists and scheduled monitoring workflows. Source versions and approved regulatory records can be compared, and relevant changes can be connected back to the GTIP codes being monitored.

Tariff Description Changes

Tax & Measure Updates

Compliance Changes

Watcher Impact Analysis

Source-Backed Regulatory Publishing

Regulatory automation needs a higher evidence standard than ordinary content aggregation. The platform separates source discovery from publication.

Official-source findings can be stored with source references and evidence, evaluated for affected tariff codes and then passed through validation or human-review gates before they become subscriber-facing compliance rules or regulatory alerts.

Discover

Collect a source-backed finding.

Validate

Check evidence, scope and affected codes.

Publish

Create an auditable change and alert affected watchers.

Alerts Across Panel, Email and Telegram

Regulatory intelligence becomes operational only when the relevant person receives it. Monitoring events can therefore flow through configurable notification channels while delivery attempts remain auditable.

In-App Alerts

Keep regulatory events inside the same product and customs workflow.

Email

Queue notification delivery according to user preferences and enabled channels.

Telegram

Linked accounts can receive alerts and interact with selected GTIP workflows through bot commands.

Telegram as an Operational Interface

Telegram integration is not limited to outbound notifications. Authenticated users can perform selected product and customs actions through a controlled bot interface.

GTIP Classification

Tariff Code Lookup

Usage / Quota Status

Watchlist Management

Compliance Summary

Support Workflow

Bulk Classification and Product Catalog Operations

Professional customs operations frequently involve hundreds or thousands of products. GtipTakip therefore treats bulk workflows as background operations instead of looping through synchronous browser requests.

Stage Capability
Import CSV / XLSX templates and uploads
Validation Row-level validation and error visibility
Processing Asynchronous queue-based classification
Review Filter by row state, product, GTIP and confidence
Correction Row-level error correction and retry workflows
Export CSV, XLSX and PDF report outputs
Audit Record actor, input, decisions and generated outputs

Multi-Client Bureau and Team Workspace

The SaaS also supports organizations that perform customs work for multiple clients. Customer context is modeled explicitly instead of forcing every record into one shared product list.

Client Portfolio

  • Client company records and contacts
  • Client-specific product catalogs
  • Classifications and landed-cost calculations
  • Compliance checklists
  • Watched GTIP codes
  • Bulk operations
  • Operation and report history

Team Management

  • User invitations
  • Role-based permissions
  • Client responsibility assignment
  • Employee workload visibility
  • Read-only roles
  • Workspace isolation
  • Team activity context

Workspace, Client and Role Isolation

Client portfolios introduce an important security requirement: authorization must exist in the data queries and policies, not merely in the sidebar.

Classification, products, calculations, compliance, BTB, watchlists and bulk records can carry client context, while role policies determine which users may view or mutate those workflows.

Customs Classification API

The browser interface is only one client of the underlying customs platform. GtipTakip exposes versioned API contracts so ERP, e-commerce, PIM and other business systems can integrate customs workflows directly.

Classification API

Submit product information and retrieve classification results through stable references.

Landed-Cost API

Run supported customs-cost calculations from external systems.

Compliance API

Resolve supported GTIP and origin-based obligation records.

Bulk Operations API

Queue higher-volume product workflows without blocking client requests.

Usage API

Expose plan and quota consumption to authenticated clients.

Webhook Delivery

Asynchronous integrations can receive completion events instead of repeatedly polling.

Asynchronous API Architecture for Expensive Classification Work

Classification can involve tariff search, evidence retrieval, scoring and AI-assisted review. The enterprise API therefore does not need to keep an HTTP request open until every stage has completed.

Submit

Accepted

Queue

Status

Result / Webhook

Idempotency, token scopes, quotas, rate limits and request logging provide additional control for machine-to-machine integrations.

Model Context Protocol for AI-Native Customs Workflows

GtipTakip includes HTTP MCP surfaces that allow supported AI clients to work with defined customs capabilities through explicit application tools.

The important distinction is that an AI assistant does not receive unrestricted database access. Existing authentication, workspace membership, roles, quotas and product rules continue to govern what the MCP client can see or execute.

User MCP

Tenant-aware product and customs tools for authorized users.

Administrative MCP

Separate administrative tools for controlled tariff, quality and regulatory operations.

AI-Assisted Regulatory Operations With Review Gates

The administrative side also uses AI-oriented workflows for regulatory research and classification-quality operations. These workflows are intentionally separated from automatic subscriber publication.

Findings can be represented as proposals, validated independently, reviewed when confidence is insufficient, published through controlled services and rolled back when later evidence shows that a change should not remain active.

Research

Proposal

Verification

Approval

Publish

SaaS Plans, Usage Quotas and Feature Access

GtipTakip is designed as a commercially operable SaaS product. Subscription plans do not simply change a label on the billing page; plan capabilities are enforced across user interfaces, background jobs and APIs.

Classification Quota

Bulk Row Quota

API Quota

Team Limits

BTB Capabilities

Notification Channels

Add-on purchase records, billing profiles, payment notifications, receipt uploads, invoices and usage history provide the supporting commercial workflow. The current implementation intentionally keeps real automated payment-provider integration separate from the completed operational SaaS billing foundation.

Queue-First Architecture for Expensive Workloads

Large imports, classification jobs, reports, exports, regulatory scans and notifications are not appropriate workloads for long synchronous HTTP requests.

The platform uses queue-oriented execution so expensive operations can run asynchronously with retry, failure and quota behavior separated from the browser lifecycle.

Classification Jobs

Bulk Imports

Reports & Exports

Regulatory Monitoring

Production Operations and Observability

A data-driven compliance SaaS needs visibility into whether its queues, source data and background processes are actually healthy.

Horizon

Queue supervision and background-work visibility.

Source Freshness

Identify stale tariff or monitoring inputs.

Failed Job Visibility

Surface operations that require intervention.

API & Webhook Health

Keep machine-to-machine behavior observable and recoverable.

Security Is Part of the SaaS Architecture

The product contains customer portfolios, commercial calculations, regulatory work and API credentials. Security therefore extends beyond login authentication.

Workspace and client-scoped authorization

Role-based mutation restrictions

Scoped API and MCP access

Production administrator 2FA requirements

Upload and MIME validation

Security headers and CSP hardening

Technical Scope

Laravel 13

Domain services, SaaS workflows, APIs, queues and business orchestration.

Livewire 4 + Flux

Interactive SaaS interfaces without requiring a heavy SPA architecture.

Laravel Horizon

Queue execution and workload supervision.

Redis

Queue and application infrastructure for asynchronous workloads.

TailwindCSS 4

Responsive public, subscriber and administrative interfaces.

Laravel AI

Controlled AI-assisted classification and operations workflows.

Laravel MCP

Structured tools for authorized AI and agent clients.

CSV / XLSX / PDF

Product imports, bulk classification and formal report outputs.

REST API & OAuth

Scoped machine-to-machine and external application access.

Signed Webhooks

Asynchronous result delivery for external integrations.

Telegram Bot API

Operational alerts and authenticated customs interactions.

Sentry-Compatible Monitoring

External error-monitoring capability alongside internal operational health checks.

Platform Architecture

Layer 1

Product Data

Products, technical attributes, SKU, GTIN and client context.

Layer 2

Customs Intelligence

Classification, tariff hierarchy, tax and compliance rules.

Layer 3

Business Workflows

Landed cost, compliance, risk, BTB, monitoring and reports.

Layer 4

SaaS & Operations

Workspaces, clients, roles, plans, quotas, queues and monitoring.

Layer 5

External Interfaces

Web, API, webhooks, Telegram and MCP clients.

From Tariff Search to a Customs Operations Platform

GtipTakip demonstrates how a narrow search problem can evolve into a complete vertical SaaS product. Finding a possible GTIP code is only the entry point.

The real workflow begins when classification is connected with product data, financial consequences, compliance obligations, regulatory monitoring, professional review and the business systems that depend on that result.

From a software-engineering perspective, the project combines hierarchical search, AI-assisted decision support, regulatory-data processing, financial calculation, workflow automation, multi-client SaaS architecture, bulk data processing, role-based access, API contracts, asynchronous jobs, notifications and agent-compatible interfaces inside one continuously evolving Laravel application.

Compliance note: GtipTakip is designed as research, calculation, monitoring and decision-support software. Classification candidates, risk indicators, cost calculations and generated BTB preparation materials do not replace official tariff decisions, customs authorities or qualified professional advice. Regulatory and tax outputs should be evaluated against their displayed source, effective date and available evidence before operational use.

Related Projects

Explore more projects showcasing CRM, ERP, and API integration work.

Interested in a similar project?

Get a practical scope direction and integration roadmap for your CRM, ERP, or API integration needs.

Typical response within 24 hours · Clear scope & timeline · Documentation included