DOCS
Collect•
InícioPara fornecedores logísticos Zonos Collect Introdução

Introdução ao Collect

Cobre direitos aduaneiros, impostos e taxas aos destinatários antes da entrega.

Como funciona 

O Zonos Collect integra-se no seu fluxo de trabalho de landed cost existente. Ao adicionar quoteType: COLLECT à sua mutação landedCostCalculateWorkflow, o pedido funciona exatamente como um cálculo de landed cost padrão; devolve os mesmos dados, mas também aciona o fluxo de trabalho do Collect.

O processo é simples: especifique quoteType: COLLECT no seu pedido e o sistema gera automaticamente um carrinho de pagamento, envia a ligação do carrinho para o e-mail do destinatário e converte a cotação numa encomenda assim que o pagamento é concluído.

Criar uma cotação do Collect 

Utilize o mesmo fluxo de trabalho GraphQL que já conhece, bastando adicionar um parâmetro. Adicionar quoteType: COLLECT à entrada do seu landedCostCalculateWorkflow aciona todo o processo do Collect, mantendo todas as funcionalidades existentes. O campo links na resposta devolve o URL da sessão de checkout, que pode guardar e utilizar para acompanhamento junto do pagador, conforme necessário.

1mutation CollectQuote(
2$parties: [PartyCreateWorkflowInput!]!
3$items: [ItemCreateWorkflowInput!]!
4$shipmentRating: ShipmentRatingCreateWorkflowInput!
5$landedCost: LandedCostCalculateWorkflowInput!
6) {
7 partyCreateWorkflow(input: $parties) {
8 type
9 id
10 organization
11 }
12 
13 itemCreateWorkflow(input: $items) {
14 id
15 amount
16 quantity
17 description
18 }
19 
20 cartonizeWorkflow {
21 id
22 }
23 
24 shipmentRatingCreateWorkflow(input: $shipmentRating) {
25 id
26 amount
27 }
28 
29 landedCostCalculateWorkflow(input: $landedCost) {
30 id
31 landedCostGuaranteeCode
32 links {
33 key
34 url
35 }
36 amountSubtotals {
37 duties
38 fees
39 taxes
40 landedCostTotal
41 }
42 fees {
43 amount
44 currency
45 type
46 item {
47 productId
48 }
49 }
50 }
51}

Webhooks

Configure um webhook ORDER_CREATED para ser notificado assim que qualquer cotação for convertida numa encomenda:

1mutation CreateOrderWebhook($input: WebhookCreateInput!) {
2 webhookCreate(input: $input) {
3 id
4 status
5 url
6 }
7}

O payload incluirá um campo de tipo. Verifique payload.type === "COLLECT" para processar apenas encomendas do Collect:

javascript

if (payload.type === 'COLLECT') {
}

Gestão no Dashboard 

Cotações e encomendas: as cotações e encomendas do Collect são apresentadas com etiquetas "COLLECT" no Dashboard. Pode filtrar pelo tipo de cotação para ver e gerir cotações específicas do Collect e acompanhar o estado do pagamento.

Imagem de marca do e-mail: ajuste a imagem de marca do e-mail dos carrinhos de pagamento do Collect em Dashboard → Definições → Modelos de e-mail

Experiência do destinatário 

Quando cria uma cotação do Collect, o seu cliente recebe um e-mail automático com uma ligação de pagamento segura. O carrinho de pagamento apresenta os direitos aduaneiros, impostos e taxas com total transparência, mantendo privados os preços dos seus produtos.

Para obter detalhes completos sobre o processo de pagamento, os países e idiomas suportados e as opções de personalização, consulte o guia da experiência do destinatário.

GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentRatingCreateWorkflowInput WebhookCreateInput

MUTATIONS

cartonizeWorkflow itemCreateWorkflow landedCostCalculateWorkflow partyCreateWorkflow shipmentRatingCreateWorkflow webhookCreate

Esta página foi útil?

Obter apoio·Documentos legais·© 2026 Zonos
Nesta página:
  • Introdução ao Collect
  • Como funciona
  • Criar uma cotação do Collect
  • Gestão no Dashboard
  • Experiência do destinatário