DOCS

Подготовить таможенную декларацию

ГлавнаяДля поставщиков логистики Перевозчики и реселлеры Подготовить таможенную декларацию

Подготовьте таможенную декларацию для отправлений в США.

Предоставьте Zonos данные о входящих почтовых отправлениях.

Zonos подготовит полные таможенные декларации, которые включают всю необходимую информацию для почтовых отправлений в США.

Подготовьте запрос 

Создание декларации требует организации данных о вашей отправке в правильной структуре. API использует иерархический подход, где вы сначала создаете декларацию, затем добавляете контейнеры, и, наконец, заполняете каждый контейнер строками декларации, содержащими детали отправления.

Каждый компонент имеет конкретные обязательные поля для обеспечения соблюдения таможенных требований и точной документации. Ниже мы описали основную структуру данных и необходимые входные данные.

Основные типы входных данных

API декларации использует несколько типов входных данных для организации информации о отправках:

  • ManifestInput: Информация о высоком уровне отправки, включая аэропорты, тип накладной и детали рейса
  • ManifestLineInput: Индивидуальные детали отправления внутри контейнера
  • ManifestLineItemInput: Информация о продукте для таможенной классификации
  • CreatePartyInput: Данные о стороне и местоположении для отправления и назначения

Просмотрите полные определения полей и варианты в нашей GraphQL API справке.

Создайте декларацию через API 

После того как вы организовали данные о вашей отправке, отправьте мутацию GraphQL для создания декларации.

Шаг 1: Создайте заголовок декларации

МУТАЦИЯ

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

Шаг 2: Добавьте строки манифеста

Используя ID, возвращенный из мутации manifestCreate, вы теперь можете связать отдельные отправления с манифестом.

МУТАЦИЯ

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

Шаг 3: Обновление манифеста

В случае изменения деталей рейса вы можете обновить данные манифеста, используя следующую мутацию.

МУТАЦИЯ

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

Была ли эта страница полезной?

Записаться на демонстрацию
© 2025 Zonoszonos.com
На этой странице:
  • Создайте декларацию через API