DOCS

Preparar manifiesto de aduanas

InicioPara proveedores de logística Transportistas y revendedores Preparar manifiesto de aduanas

Prepare un manifiesto de aduanas para envíos a EE. UU.

Proporcione a Zonos los datos de envío postal entrante.

Zonos preparará manifiestos de aduanas completos que incluyen toda la información necesaria para los envíos postales a EE. UU.

Preparar la solicitud 

Crear un manifiesto requiere organizar los datos de su envío en la estructura adecuada. La API utiliza un enfoque jerárquico donde primero crea el manifiesto, luego agrega los recipientes y, finalmente, llena cada recipiente con líneas de manifiesto que contienen los detalles del envío.

Cada componente tiene campos específicos requeridos para garantizar el cumplimiento aduanero y la documentación precisa. A continuación, hemos delineado la estructura de datos esencial y las entradas requeridas.

Tipos de entrada clave

La API de manifiesto utiliza varios tipos de entrada para organizar los datos de envío:

  • ManifestInput: Información de envío de alto nivel que incluye aeropuertos, tipo de guía y detalles del vuelo
  • ManifestLineInput: Detalles individuales del envío dentro de un recipiente
  • ManifestLineItemInput: Información del producto para la clasificación aduanera
  • CreatePartyInput: Detalles de la parte y ubicación para el origen y destino

Vea las definiciones de campo completas y las opciones en nuestra referencia de API GraphQL.

Crear un manifiesto a través de la API 

Una vez que haya organizado los datos de su envío, envíe la mutación GraphQL para crear el manifiesto.

Paso 1: Crear el encabezado del manifiesto

MUTACIÓN

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

Paso 2: Agregar líneas de manifiesto

Usando el ID devuelto de la mutación manifestCreate, ahora puedes vincular envíos individuales al manifiesto.

MUTACIÓN

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

Paso 3: Actualizar el manifiesto

En caso de que los detalles del vuelo hayan cambiado, puede actualizar los detalles del manifiesto utilizando la siguiente mutación.

MUTACIÓN

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

¿Fue útil esta página?

Reservar una demostración

¿Preguntas?

Obtener soporte
© 2025 Zonoszonos.com
En esta página:
  • Prepare un manifiesto de aduanas para envíos a EE. UU.
  • Preparar la solicitud
  • Crear un manifiesto a través de la API