Jak to działa
Zonos Collect integruje się z Twoim istniejącym przepływem pracy landed cost. Gdy dodasz quoteType: COLLECT do swojej mutacji landedCostCalculateWorkflow, żądanie działa identycznie jak standardowe obliczenie landed cost; zwraca wszystkie te same dane, ale dodatkowo uruchamia przepływ pracy Collect.
Proces jest prosty: określ quoteType: COLLECT w swoim żądaniu, a system automatycznie generuje koszyk płatności, wysyła link do koszyka na adres e-mail strony docelowej i przekształca wycenę w zamówienie po zakończeniu płatności.
Utwórz wycenę Collect
Użyj tego samego przepływu pracy GraphQL, który już znasz, wystarczy dodać jeden parametr. Dodanie quoteType: COLLECT do swojego wejścia landedCostCalculateWorkflow uruchamia cały proces Collect, zachowując jednocześnie wszystkie istniejące funkcjonalności. Pole links w odpowiedzi zwraca URL sesji checkout, który możesz przechować i wykorzystać do dalszego kontaktu z płatnikiem w razie potrzeby.
MUTACJA
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
}
}
}
}
Webhooki
Skonfiguruj ORDER_CREATED webhook, aby otrzymywać powiadomienia, gdy jakiekolwiek zapytanie zostanie przekształcone w zamówienie:
MUTACJA
GraphQL
mutation {
webhookCreate(
input: {
status: ENABLED
type: ORDER_CREATED
url: "https://your.endpoint.com/zonos-webhooks"
}
) {
id
status
url
}
}
Ładunek będzie zawierał pole typu. Sprawdź payload.type === "COLLECT" aby obsłużyć tylko zamówienia Collect:
javascript
if (payload.type === 'COLLECT') {
}
Zarządzanie panelem
Oferty i zamówienia: oferty i zamówienia Collect wyświetlają się z oznaczeniami "COLLECT" w panelu. Możesz filtrować według typu oferty, aby przeglądać i zarządzać ofertami specyficznymi dla collect oraz monitorować status płatności.
Marka e-mailowa: Dostosuj markę e-mailową dla koszyków płatności Collect w Panelu → Ustawienia → Szablony e-maili
Doświadczenie odbiorcy
Gdy tworzysz ofertę Collect, Twój klient otrzymuje automatyczny e-mail z bezpiecznym linkiem do płatności. Koszyk płatności wyświetla cła, podatki i opłaty z pełną przejrzystością, jednocześnie zachowując prywatność cen Twoich produktów.
Aby uzyskać pełne informacje na temat procesu płatności, obsługiwanych krajów i języków oraz opcji dostosowywania, zapoznaj się z przewodnikiem po doświadczeniu odbiorcy.
Rozpocznij z Collect
Collect opłaty celne, podatki i opłaty od odbiorców przed dostawą.