DOCS

Проверка ID декларации

ГлавнаяДля поставщиков логистики Проверка ID декларации

Почтовые ярлыки | Проверка ID декларации

Получите статус ID декларации и автоматически заполните таможенные документы

Если вы создаете почтовые ярлыки, вы можете вызвать Zonos для получения полных деталей таможенной декларации, когда пользователь предоставляет ID декларации. Это устраняет необходимость пользователям вручную заполнять таможенные документы, создавая бесшовный процесс доставки, где пошлины оплачены заранее, а таможенные формы автоматически заполняются.

Автоматическое заполнение таможенных деклараций 

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

1. Включите поле ID декларации в процессе создания ярлыка

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

2. Запросите статус ID декларации и детали таможенной декларации

Используйте следующий запрос для получения полных данных таможенной декларации с использованием ID декларации. Это возвращает статус проверки вместе с деталями товара, значениями, кодами HS и информацией о получателе, если она доступна.

Запрос

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
query DeclarationQuery($id: ID!) {
  declaration(id: $id) {
    id
    status
    paymentStatus
    landedCost {
      id
      method
      landedCostGuaranteeCode
      amountSubtotals {
        duties
        taxes
        fees
        landedCostTotal
      }
    }
    items {
      id
      sku
      productId
      amount
      currencyCode
      name
      hsCode
      description
      hsCodeSource
      countryOfOrigin
      quantity
      measurements {
        type
        value
        unitOfMeasure
      }
    }
    parties {
      id
      type
      person {
        firstName
        lastName
        email
        phone
      }
      location {
        id
        line1
        line2
        countryCode
        postalCode
      }
    }
  }
}

Переменные

GraphQL

1
2
  "id": "0mm1993s0mdcn"
}

3. Обработка ответа и автоматическое заполнение таможенной декларации

Ответ API включает статус валидации и таможенные данные. Используйте информацию о status, чтобы определить, действителен ли идентификатор декларации, затем автоматически заполните доступные таможенные данные или предложите ввести их вручную.

Примеры ответов

Действительный идентификатор декларации с полными таможенными данными:

Ответ

JSON

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
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
{
  "data": {
    "declaration": {
      "id": "0mm1993s0mdcn",
      "status": "OPEN",
      "paymentStatus": "OPEN",
      "landedCost": {
        "id": "landed_cost_eabb13ab-df23-45df-9ce8-96dd29d396d1",
        "method": "DAP",
        "landedCostGuaranteeCode": "NOT_APPLICABLE",
        "amountSubtotals": {
          "duties": 0.0,
          "taxes": 0.0,
          "fees": 2.62,
          "landedCostTotal": 2.62
        }
      },
      "items": [
        {
          "id": "item_0mm199388v57g",
          "sku": "item_1",
          "productId": "item_1",
          "amount": 70.0,
          "currencyCode": "USD",
          "name": "Item 1",
          "hsCode": "9504.90.4000",
          "description": "This is the description for Item 1",
          "hsCodeSource": "TARIFF_COMPLETED",
          "countryOfOrigin": "CN",
          "quantity": 2,
          "measurements": [
            {
              "type": "WEIGHT",
              "value": 1,
              "unitOfMeasure": "POUND"
            }
          ]
        }
      ],
      "parties": [
        {
          "id": "party_0kesb32rw5hfa",
          "type": "DESTINATION",
          "person": {
            "firstName": "test",
            "lastName": "origin",
            "email": null,
            "phone": "1234567890"
          },
          "location": {
            "id": "location_c7882546-652e-49cb-81a4-98962a54c49f",
            "line1": "123 Test Street",
            "line2": "",
            "countryCode": "US",
            "postalCode": "84790"
          }
        },
        {
          "id": "party_0mjfz59bgg175",
          "type": "ORIGIN",
          "person": {
            "firstName": "test",
            "lastName": "destination",
            "email": null,
            "phone": "1234567890"
          },
          "location": {
            "id": "location_0mdzb9vk8bp7c",
            "line1": "998 Ridgehaven",
            "line2": null,
            "countryCode": "CA",
            "postalCode": "N0N 0N0"
          }
        }
      ]
    }
  }
}

4. Создайте отправление

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

5. Связать номер отслеживания с идентификатором декларации

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

Создать отправление

GraphQL

1
2
3
mutation DeclarationShipmentCreate($input: DeclarationShipmentCreateInput!) {
  declarationShipmentCreate(input: $input)
}

Вы можете создать отправление, связанное с идентификатором декларации, передав массив trackingNumbers и declarationID, используемый для отправления.

Переменные без деталей коробки

GraphQL

1
2
3
4
5
6
{
  "input": {
    "declarationId": "0mm32wfyrn5es",
    "trackingNumbers": ["test_tracking_1", "test_tracking_2"]
  }
}

Вы можете создать отправление, передав declarationID, используемый для отправления. Если у вас есть данные о коробках и предметах внутри коробок, вы можете передать их в shipmentCarton вместе с trackingNumber для этой коробки.

Переменные с деталями коробки

GraphQL

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
{
  "input": {
    "declarationId": "0mm32wfyrn5es",
    "shipmentCartons": [
      {
        "dimensionalUnit": "INCH",
        "length": 8,
        "width": 4,
        "height": 2,
        "trackingNumber": "1234567890",
        "weight": 5,
        "weightUnit": "POUND",
        "items": [
          {
            "itemReference": "item_1",
            "quantity": 3,
            "hsCode": "1234.56.7890"
          }
        ]
      }
    ]
  }
}

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

Записаться на демонстрацию
© 2025 Zonoszonos.com
На этой странице:
  • Почтовые ярлыки | Проверка ID декларации