Как это работает
Zonos Collect интегрируется в ваш текущий рабочий процесс landed cost. Когда вы добавляете quoteType: COLLECT в ваш запрос landedCostCalculateWorkflow, запрос функционирует идентично стандартному расчету landed cost; он возвращает все те же данные, но дополнительно запускает рабочий процесс Collect.
Процесс прост: укажите quoteType: COLLECT в вашем запросе, и система автоматически создает корзину оплаты, отправляет ссылку на корзину на электронную почту адресата, и преобразует предложение в заказ после завершения оплаты.
Создание предложения Collect
Используйте тот же рабочий процесс GraphQL, с которым вы уже знакомы, просто добавьте один параметр. Добавление quoteType: COLLECT в ваш ввод landedCostCalculateWorkflow запускает весь процесс Collect, сохраняя все существующие функции. Поле links в ответе возвращает URL сессии checkout, который вы можете сохранить и использовать для последующего общения с плательщиком по необходимости.
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
}
}
}
}
Вебхуки
Настройте ORDER_CREATED вебхук, чтобы получать уведомления, как только любое предложение преобразуется в заказ:
МУТАЦИЯ
GraphQL
mutation {
webhookCreate(
input: {
status: ENABLED
type: ORDER_CREATED
url: "https://your.endpoint.com/zonos-webhooks"
}
) {
id
status
url
}
}
Пакет данных будет включать поле type. Проверьте payload.type === "COLLECT" для обработки только заказов Collect:
javascript
if (payload.type === 'COLLECT') {
}
Управление панелью инструментов
Цитаты и заказы: Collect цитаты и заказы отображаются с значками "COLLECT" на панели инструментов. Вы можете фильтровать по типу цитаты, чтобы просмотреть и управлять цитатами, специфичными для collect и отслеживать статус платежа.
Брендинг электронной почты: Настройте брендинг электронной почты для Collect платежных корзин в разделе Панель инструментов → Настройки → Шаблоны электронной почты
Опыт получателя
Когда вы создаете Collect цитату, ваш клиент получает автоматическое электронное письмо с безопасной ссылкой для платежа. Платежная корзина отображает пошлины, налоги и сборы с полной прозрачностью, при этом сохраняя конфиденциальность цен на ваши продукты.
Для получения полной информации о процессе платежа, поддерживаемых странах и языках, а также вариантах настройки, смотрите Руководство по опыту получателя.
Начните работу с Collect
Collect налоги, пошлины и сборы с грузополучателей до доставки.