Fraktlabels | Valider en deklarasjon-ID

Hvis du oppretter fraktlabels, kan du kontakte Zonos for å hente fullstendige opplysninger om tolldeklarasjon når en bruker oppgir en deklarasjon-ID. Dette eliminerer behovet for at brukere manuelt skal fylle ut tollskjemaer, og skaper en sømløs fraktopplevelse der toll betales på forhånd og tollskjemaer fylles ut automatisk.

Fyll tolldeklarasjoner automatisk 

Følg fremgangsmåten nedenfor for å aktivere automatisk populering av tolldeklarasjoner ved hjelp av deklarasjon-ID-er fra plattformen din.

1. Aktiver deklarasjon-ID-felt i flyt for opprettelse av label

Legg til et deklarasjon-ID-felt i grensesnittet for opprettelse av fraktlabel. Når brukere angir en gyldig deklarasjon-ID, kan plattformen din automatisk populere tolldeklarasjonen, noe som eliminerer manuell dataregistrering.

2. Spør etter deklarasjon-ID-status og opplysninger om tolldeklarasjon

Bruk følgende spørring for å hente fullstendige data om tolldeklarasjon ved hjelp av deklarasjon-ID-en. Dette returnerer valideringsstatus sammen med vareopplysninger, verdier, HS-koder og mottakeropplysninger når disse er tilgjengelige

3. Håndter svar og fyll tolldeklarasjon automatisk

API-svaret inneholder valideringsstatus og tolldata. Bruk status-opplysningene til å bestemme om deklarasjon-ID-en er gyldig, deretter populerer du automatisk tilgjengelige tolldata eller ber om manuell oppføring.

Eksempelsvar

Gyldig deklarasjon-ID med fullstendige tolldata:

{
  "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. Opprett forsendelsen

Behandle opprettelsen av label ved hjelp av enten automatisk populerte data fra en deklarasjon-ID eller manuelt angitt deklarasjonsinformasjon.

5. Koble sporingsnummer til deklarasjon-ID

Etter opprettelse av label, bruk mutasjonen declarationShipmentCreate for å koble sporingsnummeret med deklarasjon-ID-en, noe som sikrer riktig validering av tollbetaling og sporing av forsendelsen.

Du kan opprette en forsendelse knyttet til en deklarasjon-ID ved å sende en matrise med trackingNumbers og declarationID som brukes for forsendelsen.

Du kan også opprette en forsendelse ved å sende declarationID med opplysninger om kartonger og varer i kartongene, du kan sende disse i shipmentCarton sammen med trackingNumber for den kartongen.