DOCS

Walidacja identyfikatora deklaracji

Strona głównaDla dostawców logistyki Walidacja identyfikatora deklaracji

Etykiety wysyłkowe | Walidacja identyfikatora deklaracji

Pobierz status identyfikatora deklaracji i automatycznie wypełnij dokumentację celną

Jeśli tworzysz etykiety pocztowe, możesz wywołać Zonos w celu pobrania pełnych szczegółów deklaracji celnej, gdy użytkownik poda identyfikator deklaracji. Eliminuje to potrzebę ręcznego wypełniania dokumentacji celnej przez użytkowników, tworząc płynne doświadczenie wysyłkowe, w którym opłaty celne są opłacone z góry, a formularze celne są automatycznie wypełniane.

Automatyczne wypełnianie deklaracji celnych 

Postępuj zgodnie z poniższymi krokami, aby włączyć automatyczne wypełnianie deklaracji celnych przy użyciu identyfikatorów deklaracji z Twojej platformy.

1. Włącz pole identyfikatora deklaracji w procesie tworzenia etykiety

Dodaj pole identyfikatora deklaracji do interfejsu tworzenia etykiet pocztowych. Gdy użytkownicy wprowadzą ważny identyfikator deklaracji, Twoja platforma może automatycznie wypełnić deklarację celną, eliminując ręczne wprowadzanie danych.

2. Zapytaj o status identyfikatora deklaracji i szczegóły deklaracji celnej

Użyj poniższego zapytania, aby pobrać pełne dane deklaracji celnej przy użyciu identyfikatora deklaracji. Zwraca to status walidacji wraz z szczegółami przedmiotów, wartościami, kodami HS i informacjami o odbiorcy, gdy są dostępne.

Zapytanie

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

Zmienne

GraphQL

1
2
  "id": "0mm1993s0mdcn"
}

3. Obsługa odpowiedzi i automatyczne wypełnianie deklaracji celnej

Odpowiedź API zawiera status walidacji oraz dane celne. Użyj informacji o statusie, aby określić, czy identyfikator deklaracji jest ważny, a następnie automatycznie wypełnij dostępne dane celne lub poproś o ręczne wprowadzenie.

Przykładowe odpowiedzi

Ważny identyfikator deklaracji z kompletnymi danymi celnymi:

Odpowiedź

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. Utwórz przesyłkę

Przetwórz tworzenie etykiety, korzystając z automatycznie wypełnionych danych z identyfikatora deklaracji lub ręcznie wprowadzonych informacji o deklaracji.

5. Połącz numer śledzenia z identyfikatorem deklaracji

Po utworzeniu etykiety użyj mutacji declarationShipmentCreate, aby połączyć numer śledzenia z identyfikatorem deklaracji, zapewniając prawidłową walidację płatności ceł i śledzenie przesyłki.

Utwórz przesyłkę

GraphQL

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

Możesz utworzyć przesyłkę powiązaną z identyfikatorem deklaracji, przekazując tablicę trackingNumbers oraz declarationID używany do przesyłki.

Zmienne bez szczegółów kartonu

GraphQL

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

Możesz utworzyć przesyłkę, przekazując declarationID używane do przesyłki. Jeśli masz szczegóły dotyczące kartonów i przedmiotów w kartonach, możesz je przekazać w shipmentCarton wraz z trackingNumber dla tego kartonu.

Zmienne z szczegółami kartonu

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

Czy ta strona była pomocna?

Zarezerwuj demonstrację

Zobacz Zonos

polityki i umowy.
© 2025 Zonoszonos.com
Na tej stronie:
  • Etykiety wysyłkowe | Walidacja identyfikatora deklaracji
  • Automatyczne wypełnianie deklaracji celnych