DOCS

Créer des clés de compte

Créer des clés de compte

Créer des ID de déclaration via des clés de compte pour les opérateurs postaux et les plateformes d'expédition

Une clé de compte est un identifiant d'autorisation unique (similaire à une clé API) qui permet aux organisations approuvées de collect des droits au nom de leurs utilisateurs sans nécessiter d'ID de déclaration individuels pour chaque expédition. Les clés de compte éliminent le besoin de collecte manuelle des droits tout en permettant une facturation automatisée et la conformité aux exigences DDP postales.

Une clé de compte représente la dernière partie responsable du paiement des droits. Par exemple, si une plateforme d'expédition souhaite obtenir sa propre clé de compte, elle peut utiliser cette clé pour générer des ID de déclaration au nom de ses utilisateurs. Dans ce cas, la plateforme d'expédition collect les droits auprès de l'utilisateur et Zonos facturerait la plateforme d'expédition pour les droits basés sur les ID de déclaration générés à partir de leur clé de compte.

Comment fonctionnent les clés de compte 

Les organisations Zonos avec des clés de compte peuvent générer dynamiquement des ID de déclaration lors de la création d'étiquettes, créant ainsi une expérience d'expédition fluide tout en garantissant la conformité au paiement des droits.

Les organisations peuvent obtenir des clés de compte via le tableau de bord Zonos en fonction de leur cas d'utilisation spécifique et de leur relation avec Zonos.

Générer des ID de déclaration en utilisant votre clé de compte 

Les organisations avec des clés de compte peuvent générer dynamiquement des ID de déclaration individuels pour les expéditions via l'API Zonos. Ce processus permet la collecte automatisée des droits sans nécessiter que les utilisateurs saisissent manuellement des ID de déclaration.

Utilisez la mutation GraphQL suivante pour générer des ID de déclaration pour une expédition sans détails sur l'expédition elle-même.

Demande

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

Variables

JSON

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

Réponse

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

Cette page a-t-elle été utile?