DOCS
Collect•
ГлавнаяДля логистических компаний Zonos Collect Начало работы

Начало работы с Collect

Собирайте пошлины, налоги и сборы у конечных получателей перед доставкой.

Как это работает 

Zonos Collect интегрируется в ваш существующий рабочий процесс расчета таможенных платежей. Когда вы добавляете quoteType: COLLECT в мутацию landedCostCalculateWorkflow, запрос функционирует идентично стандартному расчету таможенных платежей; он возвращает все те же данные, но дополнительно запускает рабочий процесс Collect.

Процесс очень простой: укажите quoteType: COLLECT в своем запросе, и система автоматически создает корзину оплаты, отправляет ссылку на корзину на электронную почту стороне назначения и преобразует предложение в заказ после завершения платежа.

Создание предложения Collect 

Используйте тот же рабочий процесс GraphQL, с которым вы уже знакомы, просто добавьте один параметр. Добавление quoteType: COLLECT во входные данные landedCostCalculateWorkflow запускает весь процесс Collect при сохранении всех существующих функций. Поле links в ответе возвращает URL сеанса оформления заказа, который вы можете сохранить и использовать для последующего контакта с плательщиком при необходимости.

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}

Вебхуки

Настройте ORDER_CREATED вебхук, чтобы получать уведомления, как только любое предложение будет преобразовано в заказ:

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

Полезная нагрузка будет включать поле типа. Проверьте payload.type === "COLLECT" для обработки только заказов Collect:

javascript

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

Управление на Dashboard 

Предложения и заказы: Предложения и заказы Collect отображаются с бейджами "COLLECT" на Dashboard. Вы можете фильтровать по типу предложения для просмотра и управления предложениями, специфичными для Collect, и мониторинга статуса платежа.

Фирменный стиль электронной почты: Отрегулируйте фирменный стиль электронной почты для корзин платежей Collect в разделе Dashboard → Settings → Email Templates

Опыт конечного получателя 

Когда вы создаете предложение Collect, ваш клиент получает автоматическое электронное письмо с защищенной ссылкой на оплату. Корзина оплаты отображает пошлины, налоги и сборы с полной прозрачностью, сохраняя при этом конфиденциальность цен на ваши товары.

Для получения полной информации о процессе оплаты, поддерживаемых странах и языках, а также вариантах настройки см. Руководство по опыту конечного получателя.

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

ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentRatingCreateWorkflowInput WebhookCreateInput

MUTATIONS

cartonizeWorkflow itemCreateWorkflow landedCostCalculateWorkflow partyCreateWorkflow shipmentRatingCreateWorkflow webhookCreate

Была ли эта страница полезной?

Получить поддержку·Юридические документы·© 2026 Zonos
На этой странице:
  • Начало работы с Collect
  • Создание предложения Collect
  • Управление на Dashboard