DOCS

Crear claves de cuenta

Crear claves de cuenta

Crear IDs de Declaración a través de claves de cuenta para operadores postales y plataformas de envío

Una clave de cuenta es una credencial de autorización única (similar a una clave API) que permite a las organizaciones aprobadas collect derechos en nombre de sus usuarios sin requerir IDs de Declaración individuales para cada envío. Las claves de cuenta eliminan la necesidad de la recolección manual de derechos mientras permiten la facturación automatizada y el cumplimiento de los requisitos de DDP postal.

Una clave de cuenta representa a la última parte responsable del pago de derechos. Por ejemplo, si una plataforma de envío desea obtener su propia clave de cuenta, puede usar esta clave para generar IDs de Declaración en nombre de sus usuarios. En este caso, la plataforma de envío collect los derechos del usuario y Zonos facturaría a la plataforma de envío por los derechos basados en los IDs de Declaración generados a partir de su Clave de Cuenta.

Cómo funcionan las claves de cuenta 

Las organizaciones de Zonos con Claves de Cuenta pueden generar dinámicamente IDs de Declaración durante la creación de etiquetas, creando una experiencia de envío fluida mientras aseguran el cumplimiento del pago de derechos.

Las organizaciones pueden obtener Claves de Cuenta a través del Zonos Dashboard según su caso de uso específico y relación con Zonos.

Generar IDs de Declaración usando su clave de cuenta 

Las organizaciones con Claves de Cuenta pueden generar dinámicamente IDs de Declaración individuales para envíos a través de la API de Zonos. Este proceso permite la recolección automatizada de derechos sin requerir que los usuarios ingresen manualmente los IDs de Declaración.

Utilice la siguiente mutación GraphQL para generar IDs de Declaración para un envío sin detalles sobre el envío en sí.

Solicitud

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

Respuesta

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

¿Fue útil esta página?