Cara kerjanya
Zonos Collect terintegrasi ke dalam alur kerja landed cost yang sudah ada. Ketika Anda menambahkan quoteType: COLLECT ke dalam mutasi landedCostCalculateWorkflow Anda, permintaan berfungsi identik dengan perhitungan landed cost standar; ia mengembalikan semua data yang sama, tetapi juga memicu alur kerja Collect.
Prosesnya sederhana: tentukan quoteType: COLLECT dalam permintaan Anda, dan sistem secara otomatis menghasilkan keranjang pembayaran, mengirimkan tautan keranjang ke email pihak tujuan, dan mengonversi kutipan menjadi pesanan setelah pembayaran selesai.
Buat kutipan Collect
Gunakan alur kerja GraphQL yang sama yang sudah Anda kenal, cukup tambahkan satu parameter. Menambahkan quoteType: COLLECT ke input landedCostCalculateWorkflow Anda memicu seluruh proses Collect sambil mempertahankan semua fungsionalitas yang ada. Bidang links dalam respons mengembalikan URL sesi checkout, yang dapat Anda simpan dan gunakan untuk tindak lanjut dengan pihak yang membayar sesuai kebutuhan.
MUTASI
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
Konfigurasikan ORDER_CREATED webhook untuk mendapatkan pemberitahuan segera setelah kutipan apa pun dikonversi menjadi pesanan:
MUTASI
GraphQL
mutation {
webhookCreate(
input: {
status: ENABLED
type: ORDER_CREATED
url: "https://your.endpoint.com/zonos-webhooks"
}
) {
id
status
url
}
}
Payload akan mencakup sebuah field type. Periksa payload.type === "COLLECT" untuk menangani hanya pesanan Collect:
javascript
if (payload.type === 'COLLECT') {
}
Manajemen dasbor
Kutipan dan pesanan: Collect kutipan dan pesanan ditampilkan dengan badge "COLLECT" di Dasbor. Anda dapat memfilter berdasarkan jenis kutipan untuk melihat dan mengelola kutipan khusus collect dan memantau status pembayaran.
Merek email: Sesuaikan merek email untuk keranjang pembayaran Collect di bawah Dasbor → Pengaturan → Template Email
Pengalaman penerima
Ketika Anda membuat kutipan Collect, pelanggan Anda menerima email otomatis dengan tautan pembayaran yang aman. Keranjang pembayaran menampilkan bea, pajak, dan biaya dengan transparansi penuh sambil menjaga harga produk Anda tetap pribadi.
Untuk detail lengkap tentang proses pembayaran, negara dan bahasa yang didukung, serta opsi kustomisasi, lihat panduan pengalaman penerima.
Mulai dengan Collect
Collect bea, pajak, dan biaya dari penerima sebelum pengiriman.