Como funciona
Zonos Collect se integra ao seu fluxo de trabalho existente de landed cost. Quando você adiciona quoteType: COLLECT à sua mutação landedCostCalculateWorkflow, a solicitação funciona de forma idêntica a um cálculo padrão de landed cost; ela retorna todos os mesmos dados, mas além disso, aciona o fluxo de trabalho de Collect.
O processo é simples: especifique quoteType: COLLECT em sua solicitação, e o sistema gera automaticamente um carrinho de pagamento, envia o link do carrinho para o e-mail da parte destinatária e converte a cotação em um pedido assim que o pagamento é concluído.
Crie uma cotação de Collect
Use o mesmo fluxo de trabalho GraphQL com o qual você já está familiarizado, apenas adicione um parâmetro. Adicionar quoteType: COLLECT à sua entrada landedCostCalculateWorkflow aciona todo o processo de Collect enquanto mantém toda a funcionalidade existente. O campo links na resposta retorna a URL da sessão de checkout, que você pode armazenar e usar para acompanhamento com o pagador conforme necessário.
MUTATION
GraphQL
mutation {
partyCreateWorkflow(
input: [
{
person: { companyName: "Acme Electronics" }
location: {
line1: "123 Commerce Blvd"
locality: "San Francisco"
administrativeAreaCode: "CA"
postalCode: "94102"
countryCode: US
}
type: ORIGIN
}
{
person: {
firstName: "Emma"
lastName: "Thompson"
email: "emma.thompson@example.co.uk"
}
location: {
line1: "45 High Street"
locality: "Manchester"
administrativeAreaCode: "ENG"
postalCode: "M1 1AA"
countryCode: GB
}
type: DESTINATION
}
]
) {
type
id
organization
}
itemCreateWorkflow(
input: [
{
amount: 149.99
currencyCode: USD
countryOfOrigin: CN
quantity: 2
productId: "WH-1000XM4"
hsCode: "8518.30"
description: "Wireless Noise Cancelling Headphones"
}
]
) {
id
amount
quantity
description
}
cartonizeWorkflow {
id
}
shipmentRatingCreateWorkflow(
input: {
serviceLevelCode: "fedex.international_priority"
amount: 45.00
currencyCode: USD
}
) {
id
amount
}
landedCostCalculateWorkflow(
input: {
endUse: NOT_FOR_RESALE
method: DDP
tariffRate: ZONOS_PREFERRED
quoteType: COLLECT
}
) {
id
landedCostGuaranteeCode
links {
key
url
}
amountSubtotals {
duties
fees
taxes
landedCostTotal
}
fees {
amount
currency
type
item {
productId
}
}
}
}
Webhooks
Configure um ORDER_CREATED webhook para ser notificado assim que qualquer cotação for convertida em um pedido:
MUTATION
GraphQL
mutation {
webhookCreate(
input: {
status: ENABLED
type: ORDER_CREATED
url: "https://your.endpoint.com/zonos-webhooks"
}
) {
id
status
url
}
}
A carga incluirá um campo de tipo. Verifique payload.type === "menos queCOLLECT" para lidar apenas com pedidos de Collect:
javascript
if (payload.type === 'COLLECT') {
}
Gerenciamento do painel
Cotações e pedidos: Collect cotações e pedidos são exibidos com os distintivos "COLLECT" no Painel. Você pode filtrar pelo tipo de cotação para visualizar e gerenciar cotações específicas de collect e monitorar o status do pagamento.
Branding de e-mail: Ajuste o branding de e-mail para os carrinhos de pagamento Collect em Painel → Configurações → Modelos de E-mail
Experiência do consignatário
Quando você cria uma Collect cotação, seu cliente recebe um e-mail automatizado com um link de pagamento seguro. O carrinho de pagamento exibe impostos, taxas e encargos com total transparência, mantendo os preços dos seus produtos privados.
Para 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 consignatário.
Comece com Collect
Collect encargos, impostos e taxas de consignatários antes da entrega.