# Zonos

> Zonos is the AI operating system for cross-border trade — powering duty calculations, tariff classifications, and compliance infrastructure for Shopify stores, postal operators, carriers, and US customs.

This file follows the [llms.txt](https://llmstxt.org) convention. It is a curated index of pages on zonos.com that are most useful to AI agents and developers building on, integrating with, or answering questions about Zonos.

## Products

- [Landed Cost](https://zonos.com/landed-cost): Total landed cost (duties, taxes, fees) calculated at checkout.
- [International Checkout](https://zonos.com/international-checkout): Localized checkout for cross-border ecommerce.
- [Classify](https://zonos.com/classify): AI-powered HS code classification.
- [Restrict](https://zonos.com/restrict): Denied-party and restricted-goods screening at checkout.
- [Screen](https://zonos.com/screen): Compliance screening for cross-border orders.
- [Instant Rate](https://zonos.com/instant-rate): Real-time international shipping rates.
- [Cartonization](https://zonos.com/cartonization): Carton selection and packing optimization.
- [Greenlight](https://zonos.com/greenlight): Pre-clearance / pre-shipment compliance checks.
- [Prepay App](https://zonos.com/prepay-app): Prepaid duty and tax collection at checkout.
- [Cross-border calculators](https://zonos.com/cross-border-ecommerce-tools-calculators): Free tools for landed cost, HS lookup, and more.

## Developer reference

- [Zonos Graph (GraphQL)](https://zonos.com/developer): Entry point for the Zonos GraphQL API. Browse types, queries, and mutations.
- [Legacy REST API reference](https://zonos.com/docs/api-reference): Reference for the legacy REST endpoints.
- [GraphQL key (auth)](https://zonos.com/docs/account/retrieve-graphql-key): How to retrieve a credential token to call the Graph.
- [Generate code from the GraphQL schema](https://zonos.com/docs/supply-chain/generate-code-from-graphql-schema): Pattern for auto-generating typed clients.

## API operations

- [Webhooks](https://zonos.com/docs/supply-chain/webhooks): Real-time event notifications for orders, shipments, and cancellations.
- [Rate limiting](https://zonos.com/docs/supply-chain/rate-limiting): Request limits and throttling behavior.
- [Idempotency and safe retries](https://zonos.com/docs/supply-chain/idempotency): Patterns to make mutations safe to retry; status of native idempotency-key support.
- [Test mode and sandbox](https://zonos.com/docs/global-ecommerce/integration/integrating-new-checkout/test-mode-overview): How to develop against a non-production environment.
- [OAuth](https://zonos.com/docs/supply-chain/oauth): OAuth flow for partner integrations.
- [API errors](https://zonos.com/docs/supply-chain/api-errors): Standard error shapes returned by the Graph.
- [MCP server (status)](https://zonos.com/docs/supply-chain/mcp-server): Roadmap for the Zonos Model Context Protocol server.

## SDKs

- [TypeScript SDK](https://github.com/Zonos/fe-10-typescript-sdk): Auto-generated from the Zonos Graph. Install with `npm install @zonos/typescript-sdk`.
- [PHP SDK](https://github.com/Zonos/zonos-php-sdk): PHP client for the Zonos Graph with common ecommerce integration utilities.

## Integration guides

- [Docs home](https://zonos.com/docs): Top-level developer and merchant documentation.
- [Guides index](https://zonos.com/docs/guides): Cross-border ecommerce knowledge base.
- [Global ecommerce](https://zonos.com/docs/global-ecommerce): Selling internationally — taxes, duties, compliance.
- [Postal integrations](https://zonos.com/docs/postal): Integration docs for postal operators.
- [Supply chain](https://zonos.com/docs/supply-chain): Customs brokerage, logistics, and developer/API docs.
- [Account](https://zonos.com/docs/account): Account setup, billing, and configuration.

## Cross-border knowledge

- [HS codes](https://zonos.com/docs/guides/hs-codes): Harmonized System code basics.
- [Country of origin](https://zonos.com/country-of-origin): How country of origin is determined and used.
- [Customs value](https://zonos.com/customs-value): How customs value is calculated.
- [Customs description](https://zonos.com/customs-description): Writing compliant customs descriptions.
- [Customs documentation](https://zonos.com/customs-documentation): Commercial invoices and customs paperwork.
- [De minimis values](https://zonos.com/docs/guides/de-minimis-values): Country-by-country de minimis thresholds.
- [Delivered Duty Paid (DDP)](https://zonos.com/docs/guides/delivered-duty-paid-ddp): What DDP means and when to use it.
- [Duty calculation methods](https://zonos.com/docs/guides/duty-calculation-methods): How duties are computed.
- [VAT, GST, and sales tax](https://zonos.com/docs/guides/vat-gst-and-sales-tax): Cross-border tax fundamentals.
- [IOSS](https://zonos.com/ioss): EU Import One-Stop Shop registration and use.
- [Inclusive pricing](https://zonos.com/inclusive-pricing): Duty-inclusive pricing strategies.
- [Country guides](https://zonos.com/docs/guides/country-guides): Country-specific import requirements.
- [US tariff changes](https://zonos.com/docs/guides/us-tariff-changes): Updates to US tariff schedules.
- [IEEPA tariff ruling updates](https://zonos.com/ieepa-tariff-ruling-updates): Latest IEEPA-related rulings.

## Carriers and postal operators

- [DHL](https://zonos.com/dhl)
- [FedEx](https://zonos.com/fedex)
- [UPS](https://zonos.com/ups) — also [UPS Ready](https://zonos.com/ups-ready)
- [Australia Post](https://zonos.com/australia-post)
- [Canada Post](https://zonos.com/canada-post)
- [Royal Mail](https://zonos.com/royal-mail)
- [Japan Post](https://zonos.com/japan-post)
- [La Poste du Togo](https://zonos.com/la-poste-du-togo)
- [Hellenic Post](https://zonos.com/hellenic-post)
- [Cyprus Post](https://zonos.com/cyprus-post)
- [Ukrposhta](https://zonos.com/ukrposhta)
- [Bermuda Post](https://zonos.com/bermuda-post)
- [Post Aruba](https://zonos.com/post-aruba)
- [Qaz Post](https://zonos.com/qaz-post)
- [Saint Lucia Postal Service](https://zonos.com/saint-lucia-postal-service)
- [All posts](https://zonos.com/all-posts)

## Government and compliance

- [CBP partnership](https://zonos.com/cbp): Zonos as a qualified party with US Customs and Border Protection.
- [Brokerage](https://zonos.com/brokerage): Customs brokerage services.
- [Vision](https://zonos.com/vision): Company vision for cross-border trade.

## Company

- [About Zonos](https://zonos.com/about-us)
- [Pricing](https://zonos.com/pricing)
- [Contact sales](https://zonos.com/contact-sales)
- [Contact support](https://zonos.com/contact-support)
- [Partners](https://zonos.com/contact-partners)
- [All posts (blog, podcasts, webinars)](https://zonos.com/all-posts)

## For AI agents

- [Sitemap](https://zonos.com/sitemap.xml): Authoritative list of all indexable URLs.
- [robots.txt](https://zonos.com/robots.txt): Crawl rules. `/api/`, `/developer/auth`, `/developer/internal`, `/developer/viewport`, and `/developer/frontend` are off-limits to crawlers and agents.
- For product questions, prefer the [Products](#products) section.
- For API questions, prefer [Developer reference](#developer-reference), [API operations](#api-operations), and [SDKs](#sdks).
- The Zonos Graph is the supported integration surface; the legacy REST API is maintained for backwards compatibility but is not the recommended starting point for new integrations.