DOCS

Prepare o manifesto de alfândega

InícioPara provedores de logística Transportadoras & revendedores Prepare o manifesto de alfândega

Prepare um manifesto de alfândega para remessas para os EUA.

Forneça Zonos com dados de remessa postal de entrada.

Zonos irá preparar manifestos de alfândega abrangentes que incluem todas as informações necessárias para remessas postais para os EUA.

Prepare o pedido 

Criar um manifesto requer organizar os dados da sua remessa na estrutura adequada. A API utiliza uma abordagem hierárquica onde você primeiro cria o manifesto, depois adiciona recipientes e, finalmente, preenche cada recipiente com linhas de manifesto contendo detalhes da remessa.

Cada componente possui campos específicos obrigatórios para garantir a conformidade com a alfândega e a documentação precisa. Abaixo, delineamos a estrutura de dados essencial e as entradas necessárias.

Tipos de entrada principais

A API de manifesto utiliza vários tipos de entrada para organizar os dados da remessa:

  • ManifestInput: Informações de remessa de alto nível, incluindo aeroportos, tipo de conhecimento de embarque e detalhes do voo
  • ManifestLineInput: Detalhes individuais da remessa dentro de um recipiente
  • ManifestLineItemInput: Informações do produto para classificação alfandegária
  • CreatePartyInput: Detalhes da parte e localização para origem e destino

Veja as definições completas dos campos e opções em nossa referência da API GraphQL.

Crie um manifesto via API 

Uma vez que você tenha organizado os dados da sua remessa, envie a mutação GraphQL para criar o manifesto.

Passo 1: Crie o cabeçalho do manifesto

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

Passo 2: Adicionar linhas de manifesto

Usando o ID retornado pela mutação manifestCreate, você pode agora vincular remessas individuais ao manifesto.

MUTAÇÃO

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: Atualizar manifesto

No caso de os detalhes do voo terem mudado, você pode atualizar os detalhes do manifesto usando a seguinte mutação.

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

Esta página foi útil?

Agendar uma demonstração

Perguntas?

Obter suporte
© 2025 Zonoszonos.com
Nesta página:
  • Prepare um manifesto de alfândega para remessas para os EUA.
  • Prepare o pedido
  • Crie um manifesto via API