DOCS

Criar chaves de conta

Criar chaves de conta

Crie IDs de Declaração através de chaves de conta para operadores postais e plataformas de envio

Uma chave de conta é uma credencial de autorização única (semelhante a uma chave de API) que permite que organizações aprovadas collect impostos em nome de seus usuários sem exigir IDs de Declaração individuais para cada remessa. As chaves de conta eliminam a necessidade de coleta manual de impostos, permitindo a cobrança automatizada e a conformidade com os requisitos de DDP postal.

Uma chave de conta representa a parte final responsável pelo pagamento dos impostos. Por exemplo, se uma plataforma de envio deseja obter sua própria chave de conta, ela pode usar essa chave para gerar IDs de Declaração em nome de seus usuários. Nesse caso, a plataforma de envio collect os impostos do usuário e Zonos faturaria a plataforma de envio pelos impostos com base nos IDs de Declaração gerados a partir de sua Chave de Conta.

Como funcionam as chaves de conta 

As organizações Zonos com Chaves de Conta podem gerar dinamicamente IDs de Declaração durante a criação de etiquetas, criando uma experiência de envio contínua enquanto garantem a conformidade no pagamento de impostos.

As organizações podem obter Chaves de Conta através do Zonos Dashboard com base em seu caso de uso específico e relacionamento com Zonos.

Gerar IDs de Declaração usando sua chave de conta 

As organizações com Chaves de Conta podem gerar dinamicamente IDs de Declaração individuais para remessas através da API Zonos. Esse processo permite a coleta automatizada de impostos sem exigir que os usuários insiram manualmente os IDs de Declaração.

Use a seguinte mutação GraphQL para gerar IDs de Declaração para uma remessa sem detalhes sobre a própria remessa.

Solicitação

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

Variáveis

JSON

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

Resposta

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

Esta página foi útil?