Unii clienti care plaseaza comenzi online completeaza adresa de livrare incorect sau incomplet. Cele mai frecvente situatii includ localitati scrise gresit, judete selectate incorect din lista sau coduri postale eronate.

In functie de validarile aplicate de fiecare curier, aceste erori pot genera doua tipuri de probleme:

• AWB-ul nu poate fi generat – adresa din comanda nu este acceptata de sistemul curierului, iar emiterea AWB-ului este blocata.

• AWB-ul este generat, dar coletul nu poate fi livrat – sistemul curierului accepta initial adresa, insa, odata ajuns in reteaua de distributie, coletul nu poate fi livrat din cauza informatiilor incorecte sau incomplete.

In ambele situatii, erorile de adresare pot provoca intarzieri, interventii manuale pentru corectarea datelor si, in unele cazuri, returul coletelor catre expeditor.

xConnector compară adresa de livrare a fiecărei comenzi cu nomenclatorul intern xConnector, consolidat din nomenclatoarele de adrese ale curierilor, îți arată dacă adresa e corectă și poate completa automat codul poștal lipsă.

Funcția este disponibilă doar pentru adresele din România.

Cuprins

1. Activează validarea
2. Setările recomandate
3. Cum vezi rezultatul în comenzi
4. Corectează adresele greșite în bulk
5. Corectare automată cu agentul AI
6. Oprește automat comenzile cu adresă greșită (Shopify Flow)

Activează validarea

Acceseaza xConnector - Profile - Preferences - Address validation si bifeaza urmatoarele optiuni. 

Correct wrong zip code suprascrie codul poștal scris de client. Dacă sistemul potrivește din greșeală o adresă asemănătoare, coletul poate pleca la altă adresă. Lasă această setare oprită, dacă nu verifici adresele înainte de AWB.

Setările recomandate

Pragul de 93% acceptă greșeli mici (o diacritică, o literă lipsă) și respinge confuziile mari. Dacă vezi adrese greșite acceptate ca bune, crește-l la 95–96%. Dacă vezi adrese corecte respinse, coboară-l la 90–92%.

Cum vezi rezultatul în comenzi

În lista de comenzi, fiecare comandă are o iconiță în formă de mașină, colorată după statusul adresei:

• Verde: adresa și codul poștal sunt corecte.
• Galben: adresa sau codul poștal sunt incomplete.
• Roșu: adresa sau codul poștal sunt greșite.
• Gri: validarea nu a rulat (de exemplu, nu era activă când a intrat comanda).

• Filtrare: în panoul din stânga, la Address status, alegi un status (Perfect match, Valid, Incomplete, Wrong, Unknown) și vezi toate comenzile cu acel status.

• Corectare: apasă pe iconița roșie (adresă greșită) sau galbenă (adresă incompletă) din dreptul comenzii. Se deschide fereastra de corectare, unde modifici adresa și apeși Save.
• Corectare la AWB: când generezi AWB-ul, xConnector îți arată adresa sau codul poștal corect, iar tu confirmi corectura cu butonul Fix.
• Adresă greșită care nu se poate corecta: contactează clientul înainte de a genera AWB-ul.
• Raportează o problemă: dacă validatorul greșește o adresă, folosește Report Address Issue și descrie corectura. Echipa noastră ajustează validatorul.

Corectează adresele greșite în bulk

Fereastra de corectare e gândită pentru a lucra comandă după comandă, fără să o închizi:

1. În panoul din stânga, la Address status, alege Wrong. Apar toate comenzile cu adresa greșită.
2. Apasă pe iconița roșie a adresei de la prima comandă. Se deschide fereastra de corectare.
3. Corectează adresa și apasă Save.
4. Nu închide fereastra: apasă săgeata Next order. Se deschide direct următoarea comandă cu adresă greșită.
5. Corectează, salvează, apoi din nou săgeata, până termini toate comenzile din listă

Corectare automată cu agentul AI

Dacă ai multe adrese de corectat, poți folosi asistentul xConnector de corectare a adreselor. Asistentul verifică comenzile cu adresa greșită sau incompletă și propune corecturi sigure pentru stradă, localitate și cod poștal.

Regula asistentului: mai bine nicio corectură decât una greșită. Cazurile nesigure nu le atinge. Ți le lasă ție, cu explicația exactă a neclarității.

Cum funcționează

• Asistentul rulează pe calculatorul tău, în aplicația Claude Code (e nevoie de un abonament Claude Pro).
• Comunică cu magazinul printr-o cheie API pe care o generezi tu din xConnector. Cheia rămâne doar la tine și o poți șterge oricând.
• Nimic nu se schimbă în magazin fără aprobarea ta. Întâi rulezi asistentul în modul de verificare: doar citește comenzile și îți arată într-un raport exact ce corecturi AR face. După ce verifici raportul, îl rulezi a doua oară cu opțiunea --apply, care aplică corecturile.
• Adresa corectată se salvează în comanda din Shopify. În istoricul comenzii din xConnector apare mesajul „Adresa de livrare a fost corectată de agentul AI”.

Ce îți trebuie

1. Planul Enterprise în xConnector (accesul API este disponibil doar pe Enterprise).
2. O cheie API: xConnector → Profile → API Keys → Create, cu permisiunile API_GET_ORDERS și API_AI_CORRECT_ADDRESS. Dacă ai mai multe magazine, creezi câte o cheie în profilul fiecăruia.
3. Pachetul cu asistentul: îl primești de la echipa xConnector, împreună cu ghidul de instalare pas cu pas (durează aproximativ 10 minute).

Recomandare pentru început: rulează asistentul în modul de verificare pe un interval mic de comenzi și uită-te peste raport înainte de orice aplicare.

Dacă vrei să construiești propria integrare, endpoint-urile pentru adrese sunt descrise în documentația API xConnector: GET /api/orders/{shopifyOrderId}/address-detail (adresa, rezultatul validării și istoricul) și POST /api/orders/{shopifyOrderId}/address-correction (aplică o corectură).

Oprește automat comenzile cu adresă greșită (Shopify Flow)

Poți opri automat livrarea comenzilor cu adresă greșită până le corectezi:

1. Activează Shopify Flow trigger: address validated în xConnector → Profile → Preferences → Automation.
2. În Shopify Flow, creează un Flow cu declanșatorul Address validated: dacă addressStatus este WRONG sau INCOMPLETE → Hold fulfillment order.
3. Al doilea Flow: dacă addressStatus este VALID sau PERFECT → Release fulfillment hold. Comanda se deblochează după ce corectezi adresa în xConnector.

xConnector nu generează AWB pentru comenzile cu livrarea în așteptare (hold) în Shopify. Dacă folosești acest Flow, nu activa crearea automată a AWB-ului la comandă nouă: AWB-ul poate porni înainte ca Flow-ul să oprească livrarea.

Abonament

• Validate address și Normalize city name: planurile Basic și Advanced.
• Fill in missing zip code și Correct wrong zip code: planul Advanced.
• Corectarea automată cu agentul AI și accesul API: planul Enterprise.

Ai nevoie de ajutor?

Echipa noastră te ajută cu plăcere:

• Chat: direct din contul xConnector sau pe about.xconnector.app
• Email: support@xconnector.app
• Telefon și WhatsApp: +40 373 747 991
• Website: about.xconnector.app