DOCS

Utwórz klucze konta

Utwórz klucze konta

Utwórz identyfikatory deklaracji za pomocą kluczy konta dla operatorów pocztowych i platform wysyłkowych

Klucz konta to unikalne poświadczenie autoryzacyjne (podobne do klucza API), które pozwala zatwierdzonym organizacjom na collect cła w imieniu ich użytkowników, bez konieczności posiadania indywidualnych identyfikatorów deklaracji dla każdej przesyłki. Klucze konta eliminują potrzebę ręcznego pobierania ceł, umożliwiając jednocześnie automatyczne fakturowanie i zgodność z wymaganiami DDP pocztowego.

Klucz konta reprezentuje ostateczną stronę odpowiedzialną za płatność ceł. Na przykład, jeśli platforma wysyłkowa chce uzyskać własny klucz konta, może użyć tego klucza do generowania identyfikatorów deklaracji w imieniu swoich użytkowników. W takim przypadku platforma wysyłkowa collect cła od użytkownika, a Zonos wystawi fakturę platformie wysyłkowej za cła na podstawie identyfikatorów deklaracji wygenerowanych z ich klucza konta.

Jak działają klucze konta 

Zonos organizacje z kluczami konta mogą dynamicznie generować identyfikatory deklaracji podczas tworzenia etykiety, tworząc płynne doświadczenie wysyłkowe, jednocześnie zapewniając zgodność z płatnością cła.

Organizacje mogą uzyskać klucze konta za pośrednictwem Zonos Dashboard w zależności od ich konkretnego przypadku użycia i relacji z Zonos.

Generuj identyfikatory deklaracji za pomocą swojego klucza konta 

Organizacje z kluczami konta mogą dynamicznie generować indywidualne identyfikatory deklaracji dla przesyłek za pośrednictwem Zonos API. Proces ten umożliwia automatyczne pobieranie ceł bez konieczności ręcznego wprowadzania identyfikatorów deklaracji przez użytkowników.

Użyj następującej mutacji GraphQL, aby wygenerować identyfikatory deklaracji dla przesyłki bez szczegółów dotyczących samej przesyłki.

Prośba

GraphQL

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
  declarationCreate(input: $input) {
    id
    status
    paymentStatus
    source
    organizationId
    parties {
      id
    }
    items {
      id
    }
    landedCost {
      id
      currencyCode
    }
  }
}

Zmienne

JSON

1
2
3
4
5
{
  "input": {
    "source": "POST"
  }
}

Odpowiedź

JSON

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
  "data": {
    "declarationCreate": {
      "id": "0mm32wfyrn5es",
      "status": "OPEN",
      "paymentStatus": "OPEN",
      "source": "POST",
      "organizationId": "organization_test",
      "parties": [],
      "items": [],
      "landedCost": null
    }
  }
}

Czy ta strona była pomocna?