Etykiety wysyłkowe | Zwaliduj identyfikator deklaracji

Jeśli tworzysz etykiety pocztowe, możesz zażądać od Zonos kompletnych szczegółów deklaracji celnej, gdy użytkownik poda identyfikator deklaracji. Eliminuje to konieczność ręcznego wypełniania dokumentacji celnej przez użytkowników, tworząc bezproblemowe doświadczenie wysyłki, w którym cła są przedpłacone, a formularze celne są automatycznie wypełniane.

Automatyczne wypełnianie deklaracji celnych 

Wykonaj poniższe kroki, aby włączyć automatyczne wypełnianie deklaracji celnej przy użyciu identyfikatorów deklaracji z Twojej platformy.

1. Włącz pole identyfikatora deklaracji w przepływie tworzenia etykiet

Dodaj pole identyfikatora deklaracji do interfejsu tworzenia etykiet pocztowych. Gdy użytkownicy wprowadzą prawidłowy 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ć kompletne dane deklaracji celnej przy użyciu identyfikatora deklaracji. Zwraca status walidacji wraz ze szczegółami elementów, wartościami, kodami HS i informacjami o odbiorcy, jeśli są dostępne

3. Obsłuż odpowiedź i automatycznie wypełnij deklarację celną

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

Przykładowe odpowiedzi

Prawidłowy identyfikator deklaracji z kompletną dokumentacją celną:

{
  "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 wysyłkę

Przetwórz tworzenie etykiet przy użyciu danych automatycznie wypełnionych 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 właściwą walidację płatności cła i śledzenie wysyłki.

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

Możesz również utworzyć wysyłkę, przekazując declarationID ze szczegółami kartonów i pozycji w kartonach — możesz przekazać te informacje w shipmentCarton wraz z trackingNumber dla tego kartonu.