DOCS

Preparare il manifesto doganale

HomePer i fornitori di logistica Vettori & rivenditori Preparare il manifesto doganale

Preparare un manifesto doganale per le spedizioni negli Stati Uniti.

Fornire a Zonos i dati di spedizione postale in arrivo.

Zonos preparerà manifesti doganali completi che includono tutte le informazioni necessarie per le spedizioni postali negli Stati Uniti.

Preparare la richiesta 

Creare un manifesto richiede di organizzare i dati della spedizione nella struttura corretta. L'API utilizza un approccio gerarchico in cui prima si crea il manifesto, poi si aggiungono i contenitori e infine si popola ciascun contenitore con le righe del manifesto contenenti i dettagli della spedizione.

Ogni componente ha campi specifici richiesti per garantire la conformità doganale e una documentazione accurata. Di seguito abbiamo delineato la struttura dei dati essenziali e gli input richiesti.

Tipi di input chiave

L'API del manifesto utilizza diversi tipi di input per organizzare i dati della spedizione:

  • ManifestInput: Informazioni generali sulla spedizione, inclusi aeroporti, tipo di bollettino e dettagli del volo
  • ManifestLineInput: Dettagli individuali della spedizione all'interno di un contenitore
  • ManifestLineItemInput: Informazioni sul prodotto per la classificazione doganale
  • CreatePartyInput: Dettagli sulla parte e sulla posizione per origine e destinazione

Visualizza le definizioni complete dei campi e le opzioni nella nostra riferimento API GraphQL.

Creare un manifesto tramite API 

Una volta che hai organizzato i dati della tua spedizione, invia la mutazione GraphQL per creare il manifesto.

Passo 1: Creare l'intestazione del manifesto

MUTAZIONE

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
  }
}

Passo 2: Aggiungi righe di manifesto

Utilizzando l'ID restituito dalla mutazione manifestCreate, puoi ora collegare singole spedizioni al manifesto.

MUTAZIONE

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
  }
}

Passo 3: Aggiorna il manifesto

Nel caso in cui i dettagli del volo siano cambiati, puoi aggiornare i dettagli del manifesto utilizzando la seguente mutazione.

MUTAZIONE

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
    }
  }
}

Questa pagina è stata utile?

Prenota una demo
© 2025 Zonoszonos.com
In questa pagina:
  • Preparare un manifesto doganale per le spedizioni negli Stati Uniti.
  • Preparare la richiesta
  • Creare un manifesto tramite API