DOCS
ГлавнаяДля логистических компаний Проверка ID декларации

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

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

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

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

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

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

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

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

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

1query DeclarationQuery($id: ID!) {
2 declaration(id: $id) {
3 id
4 status
5 paymentStatus
6 landedCost {
7 id
8 method
9 landedCostGuaranteeCode
10 amountSubtotals {
11 duties
12 taxes
13 fees
14 landedCostTotal
15 }
16 }
17 items {
18 id
19 sku
20 productId
21 amount
22 currencyCode
23 name
24 hsCode
25 description
26 hsCodeSource
27 countryOfOrigin
28 quantity
29 measurements {
30 type
31 value
32 unitOfMeasure
33 }
34 }
35 parties {
36 id
37 type
38 person {
39 firstName
40 lastName
41 email
42 phone
43 }
44 location {
45 id
46 line1
47 line2
48 countryCode
49 postalCode
50 }
51 }
52 }
53}

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

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

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

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

{
  "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. Создайте отправление

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

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

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

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

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

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

GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

DeclarationShipmentCreateInput

MUTATIONS

declarationShipmentCreate

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

Получить поддержку·Юридические документы·© 2026 Zonos
На этой странице:
  • Почтовые ярлыки | Проверка ID декларации