DOCS
Collect•
InícioPara fornecedores logísticos Zonos Collect Primeiros passos

Primeiros passos com Collect

Cobrar direitos, impostos e taxas dos destinatários antes da entrega.

Como funciona 

Zonos Collect integra-se ao seu fluxo de trabalho de custos no destino existente. Quando você adiciona quoteType: COLLECT à sua mutação landedCostCalculateWorkflow, a solicitação funciona de forma idêntica a um cálculo de custo no destino padrão; retorna os mesmos dados, mas também ativa o fluxo de trabalho Collect.

O processo é simples: especifique quoteType: COLLECT na sua solicitação, e o sistema gera automaticamente um carrinho de finalização da compra, envia o link do carrinho para o e-mail do destinatário e converte a cotação em um pedido após a conclusão do pagamento.

Crie uma cotação para Collect 

Use o mesmo fluxo de trabalho GraphQL que você já conhece, basta adicionar um parâmetro. Adicionar quoteType: COLLECT na entrada do seu landedCostCalculateWorkflow ativa todo o processo Collect, mantendo todas as funcionalidades existentes. O campo links na resposta retorna a URL da sessão de checkout, que você pode armazenar e usar para acompanhar o 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 receber notificações assim que qualquer cotação se tornar um pedido:

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

A carga útil incluirá um campo de tipo. Verifique payload.type === "COLLECT" para gerir apenas encomendas Collect:

javascript

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

Gestão na Dashboard 

Cotações e pedidos: Cotações e pedidos para Collect são exibidos com emblemas "COLLECT" no Dashboard. Você pode filtrar por tipo de cotação para visualizar e gerenciar cotações específicas do Collect e monitorar o status do pagamento.

Marca de e-mail: defina a marca de e-mail para carrinhos de finalização de compra Collect em Dashboard → Configurações → Modelos de e-mail

Experiência do destinatário 

Ao criar uma cotação da Collect, seu cliente recebe um e-mail automático com um link de pagamento seguro. O carrinho de finalização da compra exibe tarifas, impostos e taxas com total transparência, ao mesmo tempo que mantém os preços dos produtos privados.

Para obter detalhes completos sobre o processo de pagamento, países e idiomas suportados e opções de personalização, consulte o guia de 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 suporte·Documentos legais·© 2026 Zonos
Nesta página:
  • Primeiros passos com Collect
  • Como funciona
  • Crie uma cotação para Collect
  • Gestão na Dashboard
  • Experiência do destinatário