Comenzar con Collect

Cómo funciona 

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

El proceso es simple: especifica quoteType: COLLECT en tu 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 que se completa el pago.

Crear una cotización de Collect 

Utiliza el mismo flujo de trabajo de GraphQL con el que ya estás familiarizado, solo agrega un parámetro. Agregar quoteType: COLLECT a tu entrada landedCostCalculateWorkflow activa todo el proceso de Collect mientras mantiene toda la funcionalidad existente. El campo links en la respuesta devuelve la URL de la sesión de checkout, que puedes almacenar y usar para hacer seguimiento con el pagador según sea necesario.

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

Configura un ORDER_CREATED webhook para recibir notificaciones tan pronto como cualquier cotización se convierta en un pedido:

mutation {
  webhookCreate(
    input: {
      status: ENABLED
      type: ORDER_CREATED
      url: "https://your.endpoint.com/zonos-webhooks"
    }
  ) {
    id
    status
    url
  }
}

La carga incluirá un campo de tipo. Verifique payload.type === "COLLECT" para manejar solo pedidos de Collect:

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

Gestión del tablero 

Cotizaciones y pedidos: las cotizaciones y pedidos de Collect se muestran con las insignias "COLLECT" en el Tablero. Puedes filtrar por el tipo de cotización para ver y gestionar cotizaciones específicas de collect y monitorear el estado de pago.

Marca de correo electrónico: ajusta la marca de correo electrónico para los carritos de pago de Collect en Tablero → Configuraciones → Plantillas de correo electrónico

Experiencia del consignatario 

Cuando creas una cotización de Collect, tu cliente recibe un correo electrónico automatizado con un enlace de pago seguro. El carrito de pago muestra derechos, impuestos y tarifas con total transparencia mientras mantiene el precio de tu producto privado.

Para obtener detalles completos sobre el proceso de pago, los países y idiomas admitidos, y las opciones de personalización, consulta la guía de experiencia del consignatario.