DOCS

UPS Unlock

Automatiseer douane- en belastingfacturering aan Zonos voor UPS-zendingen die buiten Dashboard worden verwerkt.

Met UPS Unlock kunt u Zonos-compliant zendingen genereren vanuit uw eigen verzendplatform, in plaats van Zonos Dashboard te gebruiken. Door bij het verwerken van UPS-zendingen een specifiek referentienummer toe te voegen, valideert en actualiseert UPS automatisch de zendingsgegevens via Zonos, waaronder douaneomschrijvingen, HS-codes, rekeningnummers voor invoerrechten, fiscale ID's en goederenwaarden. Hierdoor is het niet meer nodig om complexe regels of integraties te configureren om deze informatie aan uw verzendplatform door te geven. In plaats daarvan haalt UPS de gegevens rechtstreeks op bij Zonos, wat het risico op afwijkingen of ontbrekende informatie verkleint en de tijd voor handmatige instelling en onderhoud minimaliseert.

UPS Unlock instellen 

  1. Neem contact op met Zonos-support - Voordat u UPS Unlock inschakelt, neemt u contact op met Zonos Support om ervoor te zorgen dat uw UPS-account correct is geconfigureerd. Dit proces duurt doorgaans 24-48 uur.
  2. Schakel UPS Unlock in Dashboard in - Ga naar Zonos Dashboard → Settings → Rates → UPS en zet UPS Unlock op Enable
  3. Configureer uw referentienummers - Ten minste één referentienummer moet beginnen met zx of zx-. Zolang ten minste één referentie begint met zx (ook als de waarde alleen zx is), doorzoekt Zonos alle referentienummers om een overeenkomende Zonos-order-ID of accountordernummer te vinden.
    • Voorbeelden:
      • zxORDER123 of zx-ORDER123 (gecombineerd formaat met bestelnummer van de merchant)
      • zxorder_0jy1vh6gygcks of zx-order_0jy1vh6gygcks (gecombineerd formaat met Zonos-order-ID)
      • Referentie 1: zx, Referentie 2: ORDER123 (verdeeld over twee referentievelden)

Hoe het werkt 

Zodra u UPS Unlock hebt ingesteld, verwijzen UPS-zendingen naar Zonos-ordergegevens. Zo werkt dat proces:

  1. UPS roept Zonos automatisch aan om de order te valideren met de opgegeven referentievelden
  2. Zonos valideert en retourneert bijgewerkte douanegegevens aan UPS - Zonos controleert of de zending overeenkomt met de oorspronkelijke offerte door het volgende te controleren:
    1. De artikelen in de zending komen overeen met die in de offerte
    2. De hoeveelheden zijn kleiner dan of gelijk aan de geoffreerde hoeveelheden
    3. Onderdeelnummers komen overeen met product-ID's of SKU's uit de offerte
    4. Bestemmingsgegevens (land/provincie) komen overeen met de offerte
  3. UPS verwerkt uw zending met compliance-informatie
  4. UPS roept Zonos aan om een zendingsrecord met trackingnummer aan te maken
  5. Zonos registreert de zending op de order

Referentie-matching 

Wanneer UPS Zonos aanroept met een referentie zoals zx-ORDER123, verwijdert Zonos het voorvoegsel en zoekt naar de order. De waarde na het voorvoegsel (in dit voorbeeld ORDER123) wordt vergeleken met drie velden op de Zonos-order:

FieldDescriptionExample
Order IDDe Zonos-order-UUIDorder_0jy1vh6gygcks
Account order numberUw bestelnummer als merchantORD-12345, #1001
Zonos order IDKorte Zonos-identificatiezo-1232423

Zonos retourneert de meest recente overeenkomende order. Als er geen overeenkomst wordt gevonden, wordt een foutmelding geretourneerd.

Vereisten

Om UPS Unlock te laten slagen, moet de order aan deze vereisten voldoen:

  • Landed Cost Guarantee (LCG) - De order moet zijn aangemaakt via de Zonos checkout-flow met een gegarandeerde landed cost. Orders die buiten Zonos zijn aangemaakt, kunnen niet worden gebruikt met UPS Unlock.
  • Overeenkomende oorsprong/bestemming - Het land van verzending (ship-from) en het land van bestemming (ship-to) moeten overeenkomen met de oorspronkelijke offerte. Voor zendingen naar Canada of Brazilië moet ook de provincie overeenkomen.
  • Overeenkomende producten - Onderdeelnummers moeten overeenkomen met de product-ID's of SKU's uit de offerte, en hoeveelheden mogen de geoffreerde hoeveelheden niet overschrijden.

Foutcodes 

Als validatie mislukt, ontvangt UPS een foutmelding van Zonos. Veelvoorkomende foutcodes zijn:

CodeMessageOorzaak
10001Shipper number not foundHet UPS-shippernummer is niet geregistreerd bij Zonos
10002No Zonos order found for any of the provided reference IDsGeen order komt overeen met een referentie (na verwijdering van het voorvoegsel)
10003Invalid reference IDs. No prefix of zx- foundGeen van de referenties heeft het voorvoegsel zx of zx-
10006The requested order is not guaranteedDe order bestaat, maar heeft geen Landed Cost Guarantee
10010ShipFrom.CountryCode mismatchHet land van verzending komt niet overeen met de geoffreerde oorsprong
10011ShipTo.CountryCode mismatchHet land van bestemming komt niet overeen met de geoffreerde bestemming
10012ShipTo.StateProvinceCode mismatchVoor CA/BR-zendingen komt de provincie niet overeen
10013No matching Product on quote with PartNumberSKU/product-ID werd niet gevonden op de order
10015Quantity exceeds the quoted quantityDe gevraagde hoeveelheid is groter dan de geoffreerde hoeveelheid

ShipStation-integratie 

ShipStation-gebruikers kunnen UPS Unlock configureren door het voorvoegsel zx toe te voegen, hetzij upstream (via de API voordat orders ShipStation bereiken) of binnen ShipStation met behulp van Label Messages- en Automation Rules-configuraties. Hierdoor kunnen het zx-voorvoegsel en de order-ID worden opgenomen in UPS-zendingen die via ShipStation worden verwerkt, waardoor UPS Unlock wordt geactiveerd. Nadat u de eerste installatiestappen hebt voltooid, kunt u ShipStation configureren om met UPS Unlock te werken.

Het voorvoegsel zx upstream toevoegen

Als u het voorvoegsel zx upstream kunt toevoegen (voordat orders ShipStation bereiken), hoeft u alleen uw Label Messages te configureren om het zx-ordernummer weer te geven:

Label Messages configureren

  1. Open de Label Messages-instellingen: Navigeer naar SettingsPrintingPrinting Setup, en klik vervolgens op Document Options voor Label
  2. Configureer Label Messages: In de sectie Label Messages kunt u tot 3 aangepaste berichten definiëren die als referentienummers op UPS-labels worden weergegeven. Label Messages accepteren alleen vooraf ingestelde waarden zoals "Custom Field 1", "Order #" enz.
  3. Stel uw Messages in om Order Number te gebruiken: Stel Message #1 in op [Order #]. Als u al een #1 heeft, voegt u een #2 of #3 toe
  4. Sla de Settings op om uw configuratie toe te passen

Zodra dit is voltooid, plaatst ShipStation automatisch uw ordernummer op uw label, inclusief het geconfigureerde zx-voorvoegsel.

Het voorvoegsel zx toevoegen in ShipStation

Als u het voorvoegsel zx niet upstream kunt toevoegen (voordat orders ShipStation bereiken), moet u uw Label Messages en Automation Rules configureren om het zx-voorvoegsel en het ordernummer weer te geven met behulp van twee afzonderlijke Label Messages:

Stap 1: Label Messages configureren

Configureer uw Label Messages om zowel het voorvoegsel als het ordernummer weer te geven:

  1. Open de Label Messages-instellingen: Navigeer naar SettingsPrintingPrinting Setup, en klik vervolgens op Document Options voor Label
  2. Configureer Label Messages: In de sectie Label Messages kunt u tot 3 aangepaste berichten definiëren die als referentienummers op UPS-labels worden weergegeven.
  3. Stel uw Messages in:
    • Stel Message #1 in op [Custom Field 1] (dit wordt door de automation rule ingevuld met "zx")
    • Stel Message #2 in op [Order #] (selecteer uit de dropdown)
  4. Sla de Settings op om uw configuratie toe te passen

Stap 2: Automation Rules configureren

Nadat u uw Label Messages hebt ingesteld, maakt u een automation rule aan om Custom Field 1 te vullen met het voorvoegsel zx. Navigeer naar SettingsAutomationAutomation Rules en klik vervolgens op Create a Rule.

Rule voor Zonos UPS-orders:

  1. Naam: "Zonos UPS Unlock"
  2. Zorg ervoor dat Active Rule is ingeschakeld
  3. Selecteer Orders match these specific criteria
  4. Stel criteria in: "International Order" = "True" AND "Carrier" + "Includes" + "UPS"

Opmerking: uw triggercriteria kunnen variëren afhankelijk van uw ShipStation-configuratie. Dit is een aanbevolen startpunt - pas de voorwaarden aan op basis van uw specifieke workflow en voorkeuren, zodat UPS Unlock alleen wordt toegepast op de juiste orders.

  1. Stel acties in:
    • Action Type: selecteer "Set Custom Field 1..."
    • Custom Field 1: zx (dit stelt het voorvoegsel in)
  2. Klik op Save Rule

Zodra dit is voltooid, vult ShipStation automatisch Custom Field 1 met zx en Message #2 met het ordernummer voor internationale UPS-orders. Deze verschijnen als twee afzonderlijke referentieregels op uw UPS-labels.

Belangrijk: De Label Message-configuratie in ShipStation is een globale wijziging die van invloed is op alle carriers. Met de aanpak via automation rules werkt UPS Unlock naadloos voor Zonos-orders, terwijl uw voorkeursinstellingen voor Label Messages voor andere zendingen behouden blijven.

Boek een demo

Was deze pagina nuttig?