Appeler Zonos pour les détails douaniers
Suivez les étapes ci-dessous pour permettre à vos clients de récupérer les détails douaniers utilisables lors de la création d'envois depuis votre plateforme.
Permettre aux clients de saisir leurs identifiants API Zonos
L'API Zonos est accessible via un credentialToken. Votre plateforme doit permettre aux clients de saisir leur credentialToken depuis le Zonos Dashboard dans votre plateforme. Vous pourrez ensuite effectuer des requêtes à Zonos en leur nom.
Interroger les détails douaniers
Utilisez la requête suivante pour récupérer les détails douaniers nécessaires à la création de l'envoi. Pour l'orderId, vous pouvez utiliser l'ID de commande Zonos ou l'accountOrderNumber qui figure probablement déjà dans votre système.
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 } } }}Créer l'envoi avec le transporteur
Une fois les détails douaniers récupérés pour une commande, vous pouvez les utiliser dans votre requête au transporteur. Lorsque vous recevez l'étiquette et le numéro de suivi du transporteur, utilisez la mutation shipmentCreate pour informer Zonos du numéro de suivi afin que nous mettions à jour le statut de la commande.
Récupérer les détails douaniers
Récupérez les détails de commande pour préparer un envoi.GraphQL
Si vous êtes partenaire Zonos et travaillez avec un client utilisant votre plateforme d'expédition, vous pouvez appeler Zonos pour obtenir les détails de la commande. Ces détails peuvent être utilisés dans votre demande d'étiquette au transporteur afin de garantir que les détails transmis sont bien ceux utilisés pour que Zonos garantisse les droits et taxes évalués sur cet envoi. Nous renverrons les détails concernant les identifiants fiscaux, les articles, y compris les codes HS et les descriptions douanières, ainsi que les numéros de compte à facturer pour les droits et taxes.