DOCS

Przygotuj manifest celny

Strona głównaDla dostawców logistyki Przewoźnicy i sprzedawcy Przygotuj manifest celny

Przygotuj manifest celny dla przesyłek do USA.

Podaj Zonos dane dotyczące przesyłek pocztowych przychodzących.

Zonos przygotuje kompleksowe manifesty celne, które zawierają wszystkie niezbędne informacje dla przesyłek pocztowych do USA.

Przygotuj żądanie 

Utworzenie manifestu wymaga zorganizowania danych przesyłki w odpowiedniej strukturze. API wykorzystuje podejście hierarchiczne, w którym najpierw tworzysz manifest, następnie dodajesz pojemniki, a na końcu wypełniasz każdy pojemnik liniami manifestu zawierającymi szczegóły przesyłki.

Każdy komponent ma określone wymagane pola, aby zapewnić zgodność z przepisami celnymi i dokładną dokumentację. Poniżej przedstawiamy niezbędną strukturę danych i wymagane dane wejściowe.

Kluczowe typy danych wejściowych

API manifestu wykorzystuje kilka typów danych wejściowych do organizacji danych przesyłki:

  • ManifestInput: Informacje o przesyłce na wysokim poziomie, w tym lotniska, typ listu przewozowego i szczegóły lotu
  • ManifestLineInput: Szczegóły pojedynczej przesyłki w pojemniku
  • ManifestLineItemInput: Informacje o produkcie do klasyfikacji celnej
  • CreatePartyInput: Szczegóły dotyczące strony i lokalizacji dla miejsca pochodzenia i przeznaczenia

Zobacz pełne definicje pól i opcje w naszym GraphQL API referencji.

Utwórz manifest za pomocą API 

Gdy zorganizujesz dane przesyłki, wyślij mutację GraphQL, aby utworzyć manifest.

Krok 1: Utwórz nagłówek manifestu

MUTACJA

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

Krok 2: Dodaj linie manifestu

Używając identyfikatora zwróconego z mutacji manifestCreate, możesz teraz powiązać poszczególne przesyłki z manifestem.

MUTACJA

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

Krok 3: Zaktualizuj manifest

W przypadku, gdy szczegóły lotu uległy zmianie, możesz zaktualizować szczegóły manifestu, używając następującej mutacji.

MUTACJA

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

Czy ta strona była pomocna?

Zarezerwuj demonstrację

Zobacz Zonos

polityki i umowy.
© 2025 Zonoszonos.com
Na tej stronie:
  • Przygotuj manifest celny dla przesyłek do USA.
  • Przygotuj żądanie
  • Utwórz manifest za pomocą API