Envoyez les données des colis et du moyen de transport pour les envois à destination des États-Unis et de l’Union européenne.
Deux appels, identiques pour toutes les destinations.
Appel↕
Envoie↕
Quand↕
brokerageManifestLinesCreate
Colis : marchandises, parties, références. 100 maximum par requête
À l’acceptation du colis
brokerageManifestCreate
Le moyen de transport, en citant les identifiants de colis de l’appel 1
À la remise au transporteur
Aucun des deux appels ne bloque l’autre. Utilisez manifestLinesLink pour les colis acceptés après la création du moyen de transport.
Conservez l’id renvoyé par l’appel 1; il est requis pour l’appel 2.
Le landed cost est calculé de manière asynchrone. Une réponse de succès confirme l’acceptation, pas l’établissement de la soumission. Les données des articles et des parties sont validées pendant le calcul : envoyez donc les champs ci-dessous même lorsque l’API accepte leur absence.
Doit être envoyé pour chaque colis à destination de l’UE. L’API peut accepter un colis sans ce champ, mais la soumission peut être erronée ou échouer, et l’envoi n’est pas conforme.
Obligatoire pour les É.-U.
Doit être envoyé pour chaque colis à destination des États-Unis. Une déclaration en douane ne peut pas être déposée sans ce champ.
Recommandé
Non nécessaire pour établir la soumission, mais utilisé par les postes et les douanes de destination. Envoyez-le chaque fois que vous en disposez.
Une partie ORIGIN et une partie DESTINATION. Consultez les champs de partie.
shippingCost
Obligatoire pour l’UE
Frais d’expédition du colis. Les droits et la TVA de l’UE sont calculés sur la valeur CAF : un coût d’expédition manquant est donc traité comme nul.
shippingCostCurrency
Obligatoire pour l’UE
Devise de shippingCost. Vaut USD par défaut s’il est omis.
taxIdNumber
Facultatif
Le numéro IOSS, lorsque la vente a été effectuée sous le régime IOSS. Consultez IOSS.
consignmentWeight
Recommandé
Poids brut du colis en kilogrammes. Envoyez la même valeur sur chaque ligne partageant un numéro de suivi. Non utilisé pour calculer les droits.
referenceNumber
Recommandé
Votre référence unique pour le colis, utilisée pour éviter les doublons. Consultez Colis en double.
shipperAccountId
Recommandé
L’ID d’organisation Zonos ou votre ID externe pour le compte vérifié de l’expéditeur. Sans lui, le colis vous est attribué plutôt qu’au commerçant qui en est à l’origine.
postalOperatorCode
Facultatif
Remplace la valeur par défaut définie au niveau de la requête sur le chemin court. Ignoré ailleurs.
declarationId
Facultatif
Une déclaration Zonos déjà créée pour ce colis. Normalement résolue à partir de la commande.
Champs d’article
Une entrée par ligne de marchandises. Un colis contenant trois classifications est un seul colis avec trois entrées.
Champ↕
Exigence↕
Remarques↕
quantity
Obligatoire
Nombre d’unités.
countryOfOrigin
Obligatoire
Code pays ISO à 2 lettres. Le pays de fabrication, et non celui de dépôt.
amount
Obligatoire
Valeur unitaire. Envoyez exactement l’un des champs amount ou totalAmount.
totalAmount
Obligatoire
Valeur totale pour toutes les unités. Lorsqu’il est envoyé à la place de amount, la valeur unitaire est totalAmount / quantity.
description
Obligatoire
Description simple des marchandises.
measurements
Obligatoire
Incluez une entrée de poids net (WEIGHT par unité, ou TOTAL_WEIGHT pour toutes les unités, pas les deux). Voir ci-dessous.
hsCode
Obligatoire pour les É.-U.
Code SH ou code tarifaire, par ligne de marchandises. 10 chiffres de préférence, 6 au minimum.
customsDescription
Facultatif
Description propre à la douane, lorsqu’elle diffère de description.
provinceOfOrigin
Facultatif
Province ou État d’origine, lorsqu’un pays l’exige.
Utilisé comme gtin lorsqu’aucun gtin n’est envoyé.
name
Facultatif
Nom court du produit.
documentId
Facultatif
Associe un document que vous avez déjà téléversé.
productComposition
Facultatif
Matériaux qui composent le produit. Chaque entrée nécessite material et percentage.
marketplace
Facultatif
Place de marché sur laquelle l’article a été vendu, sous forme de name et url.
Le code SH et le pays d’origine sont indiqués par ligne de marchandises. Un colis contenant des marchandises de classifications différentes nécessite un code et une origine pour chacune. Un code unique pour un colis mixte ne peut pas être déclaré aux États-Unis.
Mesures. Chaque entrée nécessite un type, une unitOfMeasure et une value. Le poids est net et couvre toutes les unités de la ligne : ne le multipliez donc pas par la quantité. C’est sur ce poids que les droits sont calculés.
type : WEIGHT, TOTAL_WEIGHT, VOLUME, LENGTH, WIDTH, HEIGHT ou ALCOHOL_BY_VOLUME
Composition du produit. Chaque entrée accepte material et percentage, ainsi que les champs facultatifs countryOfMeltAndPour, countryOfCast, primaryCountryOfSmelt et secondaryCountryOfSmelt.
Champs de partie
Chaque partie a un type (ORIGIN pour l’expéditeur, DESTINATION pour le destinataire), une person et une location.
Champ↕
Origine (expéditeur)↕
Destination (destinataire)↕
location.countryCode
Obligatoire
Obligatoire
location.line1
Obligatoire
Obligatoire
location.locality (ville)
Obligatoire
Obligatoire
location.postalCode
Recommandé
Obligatoire (sauf en Irlande)
location.administrativeAreaCode
Facultatif
Obligatoire pour les É.-U. et le Canada
person.firstName
Obligatoire
Obligatoire
person.lastName
Obligatoire
Obligatoire
person.email
Obligatoire pour l’UE
Obligatoire pour l’UE
person.companyName
Facultatif
Facultatif
person.phone
Facultatif
Facultatif
Les deux parties figurent sur la déclaration en douane. Des parties incomplètes sont la cause la plus fréquente d’échec du dédouanement.
Les codes postaux d’origine sont recommandés, et non obligatoires : Hong Kong, les Émirats arabes unis et le Qatar n’en ont pas. Les codes postaux des destinataires dans l’UE sont obligatoires, sauf en Irlande.
administrativeAreaCode accepte le code à deux lettres : TX, et non TEXAS.
Le PDDP de l’UE comporte sept champs d’identifiant de produit. Trois sont alimentés directement par ce que vous envoyez sur l’article : plus vous en envoyez ici, plus la déclaration est complète.
Une expédition maritime utilise le même appel avec transportationMode: SEA, un SCAC dans carrierCode, le numéro de voyage dans serviceNumber, un vesselName et une date d’arrivée fixée à plusieurs semaines plutôt qu’à quelques heures.
Colis acceptés ultérieurement
Les colis acceptés après la création du moyen de transport y sont rattachés avec manifestLinesLink.
MUTATION
graphql
mutation ManifestLinesLink($manifestId: ID!, $lineIds: [ID!]!){
manifestLinesLink(manifestId:$manifestId, lineIds:$lineIds) {
id
}}
Les colis hors États-Unis peuvent se passer du moyen de transport. Transmettez le code d’opérateur avec le tableau.
1mutationBrokerageManifestLinesCreate(
2$postalOperatorCode: PostalOperatorCode
3$input: [ManifestLineInput!]!
4){
5 brokerageManifestLinesCreate(
6postalOperatorCode:$postalOperatorCode
7input:$input
8){
9 id
10 trackingNumber
11}
12}
postalOperatorCode fournit ce que le moyen de transport porterait autrement. Un colis peut remplacer la valeur par défaut définie au niveau de la requête par sa propre valeur.
Les colis à destination des États-Unis nécessitent toujours un moyen de transport : la déclaration en douane mentionne le transporteur, le service et le port d’arrivée.
Envoyez le numéro IOSS dans taxIdNumber lorsque la vente a été effectuée sous le régime IOSS.
Format : IM, un code d’État membre de l’UE à 3 chiffres, puis 7 chiffres. Exemple : IM5281234567.
Valide : soumission établie sans TVA à l’importation.
Mal formé ou absent : soumission établie avec TVA à l’importation. Envoyez le numéro d’enregistrement ou omettez le champ. N’envoyez pas de numéros de séquence ni de nombres de lignes.
Valeurs CAF
Les droits et la TVA de l’UE sont calculés sur la valeur CAF : marchandises plus frais d’expédition. Envoyez shippingCost et shippingCostCurrency sur chaque colis à destination de l’UE. Les omettre revient à traiter l’expédition comme nulle et sous-estime la soumission.
Partie destinataire
Une partie DESTINATION avec le code pays du destinataire est obligatoire. Elle détermine les règles applicables.
Les deux parties nécessitent une adresse complète : nom, rue, localité, code postal, État, pays. administrativeAreaCode accepte le code d’État à deux lettres.
Classification
Un code tarifaire est obligatoire par ligne de marchandises : 10 chiffres de préférence, 6 au minimum. Les codes à six chiffres sont complétés et validés. Les lignes sans code ne peuvent pas être déclarées.
Ce que nous prenons en charge
Résolu par Zonos à partir de la configuration de votre compte et des marchandises du colis :
referenceNumber doit être unique parmi vos colis. Réutiliser une référence renvoie l’enregistrement existant et le déplace vers le nouveau moyen de transport; ses articles et ses parties ne sont pas mis à jour. Pour corriger un colis, contactez Zonos plutôt que de le renvoyer sous la même référence.
Valeurs
Envoyez exactement l’un des champs amount ou totalAmount par article. Envoyer les deux, ou aucun, fait échouer la soumission.
currencyCode est défini une seule fois par colis. Toutes les valeurs d’articles du colis l’utilisent.
Si vous envoyez upc sans gtin, l’UPC est utilisé comme GTIN.
Les valeurs d’énumération sont des chaînes simples, par exemple "KILOGRAM".
API des envois postaux
Informez Zonos de vos envois postaux
Envoyez les données des colis et du moyen de transport pour les envois à destination des États-Unis et de l’Union européenne.
Deux appels, identiques pour toutes les destinations.
brokerageManifestLinesCreatebrokerageManifestCreateAucun des deux appels ne bloque l’autre. Utilisez
manifestLinesLinkpour les colis acceptés après la création du moyen de transport.Conservez l’
idrenvoyé par l’appel 1; il est requis pour l’appel 2.Le landed cost est calculé de manière asynchrone. Une réponse de succès confirme l’acceptation, pas l’établissement de la soumission. Les données des articles et des parties sont validées pendant le calcul : envoyez donc les champs ci-dessous même lorsque l’API accepte leur absence.
Certaines destinations ajoutent un supplément PDDP. Consultez Suppléments PDDP par destination.
Les destinations hors États-Unis disposent d’une alternative en un seul appel.
Légende des champs
Étape 1 : Informez-nous des colis
Champs du colis
trackingNumbercurrencyCodeendUseDOCUMENTS,GIFT,FOR_RESALE,NOT_FOR_RESALEouRETURN.itemspartiesORIGINet une partieDESTINATION. Consultez les champs de partie.shippingCostshippingCostCurrencyshippingCost. VautUSDpar défaut s’il est omis.taxIdNumberconsignmentWeightreferenceNumbershipperAccountIdpostalOperatorCodedeclarationIdChamps d’article
Une entrée par ligne de marchandises. Un colis contenant trois classifications est un seul colis avec trois entrées.
quantitycountryOfOriginamountamountoutotalAmount.totalAmountamount, la valeur unitaire esttotalAmount / quantity.descriptionmeasurementsWEIGHTpar unité, ouTOTAL_WEIGHTpour toutes les unités, pas les deux). Voir ci-dessous.hsCodecustomsDescriptiondescription.provinceOfOriginskuproductIdgtinupcgtinlorsqu’aucungtinn’est envoyé.namedocumentIdproductCompositionmaterialetpercentage.marketplacenameeturl.Le code SH et le pays d’origine sont indiqués par ligne de marchandises. Un colis contenant des marchandises de classifications différentes nécessite un code et une origine pour chacune. Un code unique pour un colis mixte ne peut pas être déclaré aux États-Unis.
Mesures. Chaque entrée nécessite un
type, uneunitOfMeasureet unevalue. Le poids est net et couvre toutes les unités de la ligne : ne le multipliez donc pas par la quantité. C’est sur ce poids que les droits sont calculés.type:WEIGHT,TOTAL_WEIGHT,VOLUME,LENGTH,WIDTH,HEIGHTouALCOHOL_BY_VOLUMEunitOfMeasure:GRAM,KILOGRAM,OUNCE,POUND,LITER,MILLILITER,CENTIMETER,METER,MILLIMETER,INCH,FOOT,YARDouPERCENTAGEComposition du produit. Chaque entrée accepte
materialetpercentage, ainsi que les champs facultatifscountryOfMeltAndPour,countryOfCast,primaryCountryOfSmeltetsecondaryCountryOfSmelt.Champs de partie
Chaque partie a un
type(ORIGINpour l’expéditeur,DESTINATIONpour le destinataire), unepersonet unelocation.location.countryCodelocation.line1location.locality(ville)location.postalCodelocation.administrativeAreaCodeperson.firstNameperson.lastNameperson.emailperson.companyNameperson.phoneLes deux parties figurent sur la déclaration en douane. Des parties incomplètes sont la cause la plus fréquente d’échec du dédouanement.
Les codes postaux d’origine sont recommandés, et non obligatoires : Hong Kong, les Émirats arabes unis et le Qatar n’en ont pas. Les codes postaux des destinataires dans l’UE sont obligatoires, sauf en Irlande.
administrativeAreaCodeaccepte le code à deux lettres :TX, et nonTEXAS.Exemple
mutation BrokerageManifestLinesCreate($input: [ManifestLineInput!]!) {brokerageManifestLinesCreate(input: $input) {idtrackingNumberreferenceNumbertaxIdNumber}}RÉPONSE
json
{ "data": { "brokerageManifestLinesCreate": [ { "id": "line_abc123def456", "trackingNumber": "RB123456799GB", "referenceNumber": "ITM-00184413", "taxIdNumber": "IM5281234567" } ] } }Identifiants de produit
Quatre champs sur chaque ligne de marchandises.
productIdskugtinmanufacturerProductIdCe que l’Europe en fait
Le PDDP de l’UE comporte sept champs d’identifiant de produit. Trois sont alimentés directement par ce que vous envoyez sur l’article : plus vous en envoyez ici, plus la déclaration est complète.
merchantProductIdentifier(MPID)productId, à défautskumanufacturerStandardizedProductIdentifier(S PID)gtinmanufacturerNonStandardizedProductIdentifier(NS PID)manufacturerProductIdlccProviderProductIdentifierest défini à partir de notre identifiant d’article.manufacturerIdentifiern’est pas envoyé.Contraintes :
gtinne contient que des chiffres.05012345678900, et non0-50123-45678-9.gtinouupc, pas les deux. Un UPC est un GTIN-12;upcest normalisé engtin.manufacturerProductIdaccepte 70 caractères. Tous les autres champs d’identifiant sont tronqués à 50.Étape 2 : Informez-nous du moyen de transport
Envoyé à la remise au transporteur, en citant les identifiants de colis de l’étape 1.
postalOperatorCodecarrierCodeserviceNumberarrivalDatedestinationCodetransportationModeAIR,SEA,ROADouRAIL. VautAIRpar défaut.vesselNameoriginCodeawbPrefixawbNumberweightweightUnitweight.amountLa lettre de transport aérien est facultative. La clé du moyen de transport est dérivée de
carrierCode,serviceNumberet de la date.Envoyez
destinationCodeetoriginCodedans votre format existant. Zonos gère la correspondance avec les listes de ports douaniers.mutation BrokerageManifestCreate($input: ManifestInput!, $lineIds: [ID!]!) {brokerageManifestCreate(input: $input, lineIds: $lineIds) {idcarrierCodeserviceNumberdestinationCodearrivalDate}}Une expédition maritime utilise le même appel avec
transportationMode: SEA, un SCAC danscarrierCode, le numéro de voyage dansserviceNumber, unvesselNameet une date d’arrivée fixée à plusieurs semaines plutôt qu’à quelques heures.Colis acceptés ultérieurement
Les colis acceptés après la création du moyen de transport y sont rattachés avec
manifestLinesLink.MUTATION
graphql
mutation ManifestLinesLink($manifestId: ID!, $lineIds: [ID!]!) { manifestLinesLink(manifestId: $manifestId, lineIds: $lineIds) { id } }Un chemin plus court pour l’Europe
Les colis hors États-Unis peuvent se passer du moyen de transport. Transmettez le code d’opérateur avec le tableau.
mutation BrokerageManifestLinesCreate($postalOperatorCode: PostalOperatorCode$input: [ManifestLineInput!]!) {brokerageManifestLinesCreate(postalOperatorCode: $postalOperatorCodeinput: $input) {idtrackingNumber}}postalOperatorCodefournit ce que le moyen de transport porterait autrement. Un colis peut remplacer la valeur par défaut définie au niveau de la requête par sa propre valeur.Les colis à destination des États-Unis nécessitent toujours un moyen de transport : la déclaration en douane mentionne le transporteur, le service et le port d’arrivée.
Remarques sur les données pour l’UE
IOSS
Envoyez le numéro IOSS dans
taxIdNumberlorsque la vente a été effectuée sous le régime IOSS.Format :
IM, un code d’État membre de l’UE à 3 chiffres, puis 7 chiffres. Exemple :IM5281234567.Valeurs CAF
Les droits et la TVA de l’UE sont calculés sur la valeur CAF : marchandises plus frais d’expédition. Envoyez
shippingCostetshippingCostCurrencysur chaque colis à destination de l’UE. Les omettre revient à traiter l’expédition comme nulle et sous-estime la soumission.Partie destinataire
Une partie
DESTINATIONavec le code pays du destinataire est obligatoire. Elle détermine les règles applicables.Remarques sur les données pour les États-Unis
Parties complètes
Les deux parties nécessitent une adresse complète : nom, rue, localité, code postal, État, pays.
administrativeAreaCodeaccepte le code d’État à deux lettres.Classification
Un code tarifaire est obligatoire par ligne de marchandises : 10 chiffres de préférence, 6 au minimum. Les codes à six chiffres sont complétés et validés. Les lignes sans code ne peuvent pas être déclarées.
Ce que nous prenons en charge
Résolu par Zonos à partir de la configuration de votre compte et des marchandises du colis :
Remarques générales
Colis en double
referenceNumberdoit être unique parmi vos colis. Réutiliser une référence renvoie l’enregistrement existant et le déplace vers le nouveau moyen de transport; ses articles et ses parties ne sont pas mis à jour. Pour corriger un colis, contactez Zonos plutôt que de le renvoyer sous la même référence.Valeurs
amountoutotalAmountpar article. Envoyer les deux, ou aucun, fait échouer la soumission.currencyCodeest défini une seule fois par colis. Toutes les valeurs d’articles du colis l’utilisent.upcsansgtin, l’UPC est utilisé comme GTIN."KILOGRAM".Cette page vous a-t-elle été utile?