Zonos aanroepen voor douanegegevens
Volg de stappen hieronder zodat uw klanten douanegegevens kunnen ophalen voor het aanmaken van zendingen vanuit uw platform.
Klanten Zonos API-credentials laten doorgeven
De Zonos API is toegankelijk via een credentialToken. Uw platform moet klanten de mogelijkheid bieden om hun credentialToken vanuit het Zonos Dashboard in uw platform in te voeren. Vanaf dat moment kunt u namens hen verzoeken aan Zonos doen.
Douanegegevens queryen
Gebruik de volgende query om douanegegevens op te halen die nodig zijn om de zending aan te maken. Voor orderId kunt u het Zonos order-ID of het accountOrderNumber gebruiken dat waarschijnlijk al in uw systeem staat.
query GetCustomsSpec($referenceId: String!) { customsSpecByReference(referenceId: $referenceId) { id currencyCode amountSubtotals { items shipping } reasonForExport incoterm declarationStatement attributes { type value } serviceLevel { name code carrier { name code } } parties { id type person { companyName firstName lastName email phone } location { countryCode line1 locality postalCode administrativeAreaCode administrativeArea } } customsItems { id amount quantity hsCode hsCodeSource description countryOfOrigin items { id amount currencyCode quantity } } }}De zending aanmaken bij de carrier
Zodra u de douanegegevens voor een order hebt opgehaald, kunt u deze gegevens gebruiken in uw verzoek aan de carrier. Wanneer u het label en trackingnummer van de carrier terugkrijgt, kunt u de shipmentCreate-mutatie gebruiken om Zonos op de hoogte te stellen van het trackingnummer, zodat we de status van de order kunnen bijwerken.
Douanegegevens ophalen
Ordergegevens ophalen om een zending voor te bereiden.GraphQL
Bent u partner van Zonos en werkt u met een klant die uw platform voor verzending gebruikt, dan kunt u Zonos aanroepen voor orderdetails. Deze details kunnen in uw labelverzoek aan de carrier worden gebruikt zodat de doorgegeven details overeenkomen met die waarmee Zonos de invoerrechten en belastingen op die zending garandeert. We retourneren details over belasting-ID's, items inclusief HS-codes en douanebeschrijvingen, en accountnummers waarvoor invoerrechten en belastingen gefactureerd moeten worden.