How Clarify works
Een typische end-to-end flow gebruikt the Zonos GraphQL API in four steps:
- Discover requirements. Query
complianceRequirementswith an item's HS code and ship-to country to see which compliance programs are triggered, and read each program's questions. - Infer and prefill. Call
complianceQuestionnaireInferwith your items. Clarify opens a questionnaire session and pre-answers questions from your item data — each pre-filled answer carries a confidence score. - Review and answer. Confirm or correct the pre-filled answers with
questionnaireAnswersSubmit. The questionnaire branches automatically, so the shipper only sees the questions that actually apply. - Finalize. Accept the answers with
questionnaireSessionAttest(or submit a complete set directly). Clarify records an immutable response and attaches the answers to the item for customs filing.
See Complete a questionnaire for the full walkthrough, and How it works for branching, provenance, and dynamic options.
Belangrijke concepten
| Concept↕ | Wat het betekent↕ |
|---|---|
| Compliance program | A regulatory program (e.g. an FDA prior-notice program) identified by a stable code. Each program owns a questionnaire. |
| Question | A prompt with an answerType of BOOLEAN, SINGLE_SELECT, MULTI_SELECT, TEXT, NUMBER, or DATE. |
| Display condition | Branching logic that shows or hides a question based on earlier answers, so shippers never see irrelevant questions. |
| Inference & provenance | Clarify pre-answers questions from your item data. Each answer records where it came from — INFERRED, MANUAL, or SUPPLIED — and inferred answers carry a confidence score. |
| Session vs. response | A session is the in-progress questionnaire. A response is the finalized, immutable record of the answers. |
| Attestation | Accepting the pre-filled answers as-is to finalize without re-typing them. |
| Target | What the answers describe: a reusable CATALOG_ITEM (answer once, reuse) or a per-shipment ITEM. |
| Intended use | The declared import intent (CONSUMER, COMMERCIAL, PERSONAL, RESEARCH) that guides inference. |
Ondersteunde programma's
Clarify modelleert compliance as programs, each with a programType:
PGA- U.S. partner government agency programs, including the FDA, EPA, USDA (AMS and APHIS, including the Lacey Act), CPSC, and FWS.FTA- Free trade agreement eligibility.TARIFF_MEASURE- Questionnaires tied to specific tariff measures.OTHER- Anything that doesn't fit the categories above.
New programs are added over time. Use
complianceRequirements
to see exactly which apply to a given item and route.
Volgende stappen
- Check compliance requirements - discover applicable programs and read questionnaire structures.
- Complete a questionnaire - infer, answer, attest, and finalize via GraphQL.
- How it works - branching, provenance, dynamic options, and intended use.
- New to the Zonos API? Start with OAuth and API errors.
Zonos Clarify
Automatiseer partner government agency (PGA)-compliance — ontdek welke agencyvereisten per item gelden, beantwoord vragenlijsten met AI-voorinvulling en koppel compliant antwoorden voor douaneaangifte.Veel cross-borderzendingen vallen onder partner government agency (PGA)-vereisten in addition to customs duties and taxes. Before goods can clear the border, the importer often has to answer agency-specific questions per item — for example, the FDA's questions for food and cosmetics, or the CPSC's certification for children's products. Getting these answers wrong (or missing them) holds shipments at the border.
Zonos Clarify maakt van dat handmatige, foutgevoelige proces een gestructureerde, automatiseerbare flow:
Deze documentatie is bedoeld voor integratie. Het is geen juridisch of douaneadvies. Raadpleeg een erkende customs broker of complianceprofessional voor uw specifieke verplichtingen.