DOCS

Préparer le manifeste douanier

AccueilPour les fournisseurs de logistique Transporteurs & revendeurs Préparer le manifeste douanier

Préparer un manifeste douanier pour les expéditions vers les États-Unis.

Fournissez à Zonos les données d'expédition postale entrantes.

Zonos préparera des manifestes douaniers complets qui incluent toutes les informations nécessaires pour les expéditions postales vers les États-Unis.

Préparer la demande 

Créer un manifeste nécessite d'organiser vos données d'expédition dans la structure appropriée. L'API utilise une approche hiérarchique où vous créez d'abord le manifeste, puis ajoutez des récipients, et enfin remplissez chaque récipient avec des lignes de manifeste contenant les détails de l'expédition.

Chaque composant a des champs requis spécifiques pour garantir la conformité douanière et une documentation précise. Ci-dessous, nous avons décrit la structure de données essentielle et les entrées requises.

Types d'entrées clés

L'API de manifeste utilise plusieurs types d'entrées pour organiser les données d'expédition :

  • ManifestInput : Informations d'expédition de haut niveau incluant les aéroports, le type de lettre de transport, et les détails du vol
  • ManifestLineInput : Détails d'expédition individuels au sein d'un récipient
  • ManifestLineItemInput : Informations sur le produit pour la classification douanière
  • CreatePartyInput : Détails sur la partie et l'emplacement pour l'origine et la destination

Consultez les définitions de champs complètes et les options dans notre référence de l'API GraphQL.

Créer un manifeste via l'API 

Une fois que vous avez organisé vos données d'expédition, envoyez la mutation GraphQL pour créer le manifeste.

Étape 1 : Créer l'en-tête du manifeste

MUTATION

GraphQL

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
mutation ManifestCreate {
  manifestCreate(
    input: {
      arrivalDate: "2025-09-11T16:16:49.262Z"
      postalOperatorCode: J1CMDA
      carrierCode: "AA"
      destinationCode: "JFK"
      serviceNumber: "11"
    }
  ) {
    amount
    createdAt
    createdBy
    id
    postalOperatorCode
    transportationMode
    updatedAt
    updatedBy
    weight
    weightUnit
    lines(first: 5) {
      totalCount
      edges {
        cursor
        node {
          createdAt
          createdBy
          id
          updatedAt
          updatedBy
          landedCost {
            id
          }
        }
      }
    }
    arrivalDate
    awbPrefix
    carrierCode
    destinationCode
    originCode
    operatorDestination
    statusTransitions {
      note
      source
      createdAt
      createdBy
    }
    operatorOrigin
    serviceNumber
    source
  }
}

Étape 2 : Ajouter des lignes de manifeste

En utilisant l'ID retourné par la mutation manifestCreate, vous pouvez maintenant lier des expéditions individuelles au manifeste.

MUTATION

GraphQL

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
mutation ManifestLineCreate {
  manifestLineCreate(
    manifestId: "A-AA137-J1CGBA-(2025-09-12)"
    input: {
      endUse: NOT_FOR_RESALE
      trackingNumber: "1Z08134599"
      referenceNumber: "test"
      items: { amount: "453", quantity: 2, countryOfOrigin: CN }
      parties: [
        { type: ORIGIN, location: { countryCode: GB } }
        { type: DESTINATION, location: { countryCode: US } }
      ]
      currencyCode: USD
    }
  ) {
    createdAt
    createdBy
    endUse
    id
    manifestId
    trackingNumber
    updatedAt
    updatedBy
  }
}

Étape 3 : Mettre à jour le manifeste

Dans le cas où les détails du vol ont changé, vous pouvez mettre à jour les détails du manifeste en utilisant la mutation suivante.

MUTATION

GraphQL

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
mutation ManifestUpdate {
  manifestUpdate(
    id: "manifest_0my2erm8c14z3"
    input: {
      source: RESDIT
      carrierCode: "JFK"
      arrivalDate: "2025-09-12T16:16:49.262Z"
      serviceNumber: "79824513"
      note: "Update from RESDIT"
    }
  ) {
    amount
    arrivalDate
    awbNumber
    awbPrefix
    carrierCode
    createdAt
    createdBy
    destinationCode
    id
    operatorDestination
    operatorOrigin
    originCode
    postalOperatorCode
    serviceNumber
    source
    transportationMode
    updatedAt
    updatedBy
    weight
    statusTransitions {
      note
      source
      createdAt
    }
  }
}

Cette page a-t-elle été utile?

Réserver une démo

Des questions?

Obtenir de l'aide
© 2025 Zonoszonos.com
Sur cette page :
  • Préparer un manifeste douanier pour les expéditions vers les États-Unis.
  • Préparer la demande
  • Créer un manifeste via l'API