DOCS
Collect•
InicioPara proveedores logísticos Zonos Collect Primeros pasos

Primeros pasos con Collect

Cobre aranceles, impuestos y tasas a los consignatarios antes de la entrega.

Cómo funciona 

Zonos Collect se integra en su flujo de trabajo de landed cost existente. Cuando añade quoteType: COLLECT a su mutación landedCostCalculateWorkflow, la solicitud funciona de forma idéntica a un cálculo de landed cost estándar; devuelve los mismos datos, pero además activa el flujo de trabajo de Collect.

El proceso es sencillo: especifique quoteType: COLLECT en su solicitud, y el sistema genera automáticamente un carrito de pago, envía el enlace del carrito al correo electrónico de la parte de destino y convierte la cotización en un pedido una vez completado el pago.

Crear una cotización de Collect 

Utilice el mismo flujo de trabajo GraphQL que ya conoce, solo añada un parámetro. Añadir quoteType: COLLECT a la entrada de su landedCostCalculateWorkflow activa todo el proceso de Collect manteniendo toda la funcionalidad existente. El campo links en la respuesta devuelve la URL de la sesión de checkout, que puede almacenar y utilizar para el seguimiento con el pagador según sea necesario.

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 un webhook ORDER_CREATED para recibir notificaciones en cuanto cualquier cotización se convierta en un pedido:

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

La carga útil incluirá un campo type. Compruebe payload.type === "COLLECT" para gestionar solo pedidos de Collect:

javascript

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

Gestión en Dashboard 

Cotizaciones y pedidos: Las cotizaciones y pedidos de Collect se muestran con insignias "COLLECT" en Dashboard. Puede filtrar por tipo de cotización para ver y gestionar cotizaciones específicas de Collect y supervisar el estado de pago.

Marca de correo electrónico: Ajuste la marca de correo electrónico para los carritos de pago de Collect en Dashboard → Settings → Email Templates

Experiencia del consignatario 

Cuando crea una cotización de Collect, su cliente recibe un correo electrónico automatizado con un enlace de pago seguro. El carrito de pago muestra aranceles, impuestos y tasas con total transparencia mientras mantiene privados los precios de sus productos.

Para obtener detalles completos sobre el proceso de pago, países e idiomas compatibles y opciones de personalización, consulte la guía de experiencia del consignatario.

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

ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentRatingCreateWorkflowInput WebhookCreateInput

MUTATIONS

cartonizeWorkflow itemCreateWorkflow landedCostCalculateWorkflow partyCreateWorkflow shipmentRatingCreateWorkflow webhookCreate

¿Fue útil esta página?

Obtener soporte·Documentos legales·© 2026 Zonos
En esta página:
  • Primeros pasos con Collect
  • Cómo funciona
  • Crear una cotización de Collect
  • Gestión en Dashboard
  • Experiencia del consignatario