Integrări curieri

Cum conectezi Speedy cu easySales: ghid complet de configurare

De echipa easySales · Actualizat 28 septembrie 2026 · 4 min citire

Cum conectezi Speedy cu easySales: ghid complet de configurare

Conectează Speedy la easySales: credențialele API și Obține detalii, contractul și punctul de ridicare, cele trei coduri de serviciu, serviciile adiționale și asigurarea, AWB-urile pentru străinătate și mesajele de eroare Speedy.

Ce îți aduce conectarea Speedy

Cu Speedy conectat, easySales generează AWB-uri Speedy pentru comenzile tale — unul câte unul sau în masă —, le printează, urmărește fiecare colet și anulează un AWB de care nu mai ai nevoie, fără să deschizi aplicația Speedy. Speedy ridică din Bulgaria, așa că integrarea este pentru coletele pe care le trimiți de la o adresă din Bulgaria, către Bulgaria sau în străinătate.

Două lucruri decid dacă AWB-ul se generează sau nu: ce alegi la Contract după Obține detalii și cele trei coduri de serviciu. Cea mai mare parte a ghidului este despre ele.

Înainte să începi

✓

Un contract Speedy cu acces API

Accesul API se cere de la Speedy, la telesales@speedy.bg, și îți dă un utilizator și o parolă API, separate de datele tale obișnuite de autentificare Speedy.

✓

Codurile tale de serviciu

Id-urile numerice Speedy pentru serviciile din contractul tău — unul pentru aceeași localitate, unul între localități și unul internațional. Le găsești în contul tău Speedy sau le ceri de la Speedy.

✓

Un număr de telefon pe punctul tău Speedy

Fiecare punct din care expediezi are nevoie de unul în Speedy, altfel nu apare în lista Contract.

Pasul 1 — Deschide cardul Speedy

Intră în Integrări → Curieri, caută speedy și apasă Conectare pe cardul Speedy — sau Editează, dacă l-ai conectat deja.

Pagina Curieri din easySales filtrată după speedy, cu un card Speedy conectat.
Integrări → Curieri, filtrat după `speedy`.

Pasul 2 — Credențiale și butonul Obține detalii

Partea de sus a formularului de conectare Speedy din easySales, cu Nume Conexiune Speedy Depozit Sofia, ID-ul contului, Parola și butoanele Clonează, Șterge și Obține detalii.
Doar aceste câmpuri apar până când Obține detalii reușește.

ID-ul contului și Parola sunt credențialele API pe care ți le dă Speedy — nu datele cu care intri pe site-ul Speedy. Nume Conexiune este ce vezi în easySales când alegi între conexiuni.

Pasul 3 — Formatul AWB-ului, plătitorul și cele trei coduri de serviciu

Formularul Speedy după Obține detalii, cu Format AWB A6, Platitor serviciu curierat Sender, Tip de pocesare Cash, Codul serviciului național 505, Codul serviciului local 505 și Codul serviciului internațional 202.
Cele trei coduri de serviciu sunt id-uri Speedy, luate din contractul tău.
Câmp Ce face
Format AWB Formatul în care Speedy generează AWB-ul: A4 (o pagină întreagă), A6 (un AWB pentru imprimantă termică) sau A4_4xA6 (patru AWB-uri pe o coală A4).
Platitor serviciu curierat Cui îi facturează Speedy expedierea — Sender (expeditorul), Recipient (destinatarul) sau Third Party (un terț).
Tip de pocesare Cum îți predă Speedy banii încasați la livrare: Cash sau Transfer de bani poștal.
Codul serviciului național Id-ul de serviciu Speedy pentru un colet care circulă între localități — tooltip-ul dă 505 ca exemplu.
Codul serviciului local Id-ul de serviciu Speedy pentru livrarea în aceeași localitate.
Codul serviciului internațional Id-ul de serviciu Speedy pentru un colet care pleacă din Bulgaria — tooltip-ul dă 202 ca exemplu.
Câmpurile AWB-ului și ce face fiecare

Pasul 4 — Contract, servicii adiționale și asigurare

Formularul Speedy cu un Contract ales în Sofia, câmpul Servicii adiționale, Livrare asigurată bifată și Fragil.
Punctul din contract este locul de unde ridică Speedy.

Contract este lista întoarsă de Speedy pentru contul tău. Fiecare intrare este unul dintre punctele tale Speedy, iar alegerea ei fixează locul de unde ridică Speedy și telefonul expeditorului de pe AWB — de aceea un al doilea punct de ridicare înseamnă o a doua conexiune, nu o setare.

Setare Ce face
Servicii adiționale Trei opțiuni: Livrare sambata, Deschidere la livrare (clientul poate deschide coletul înainte să plătească; un colet refuzat se întoarce pe costul tău) și Paletizat (expedierea circulă ca palet). Ce alegi se adaugă fiecărui AWB creat pe conexiunea asta.
Livrare asigurată Declară către Speedy valoarea produselor, cu TVA inclus. Cu ea pornită apare o a doua opțiune — Fragil — care declară și conținutul ca fragil.
Ramburs Nu este un câmp al formularului. easySales adaugă singur suma de încasat când comanda se plătește la livrare.
Servicii adiționale și asigurare

Pasul 5 — Template Note AWB

Template Note AWB al unei conexiuni Speedy din easySales, cu butoanele de variabile pentru comandă și produse deasupra unei casete care conține Comanda ${order.id}.
Ce produce șablonul se printează pe AWB.

Ce produce șablonul pleacă odată cu coletul și se printează pe AWB, așa că ține-l la ce trebuie să citească un șofer sau un depozit. Butoanele de deasupra casetei inserează valori din comandă și din produsele ei. Speedy acceptă cel mult 97 de caractere; ce depășește se taie.

Pasul 6 — Setări de printare și opțiuni avansate

Ambele secțiuni sunt pliate și niciuna nu este obligatorie.

Setările de printare și opțiunile avansate desfășurate ale unei conexiuni Speedy: formatul hârtiei, tipul de scalare, Email de rezervă și Generarea AWB-ului tine cont de numarul de pachete ale fiecarui produs.
Ambele secțiuni sunt pliate implicit.
Setare Ce face
Afișează setări de printare Formatul hârtiei și scalarea, folosite doar când printezi prin conexiunea Printer din easySales și doar pentru curierul acesta. Nu este același lucru cu Format AWB: Speedy decide cum arată AWB-ul, acestea decid cum ajunge pe hârtie.
Email de rezervă Se trimite ca e-mail al destinatarului când comanda nu are unul.
Generarea AWB-ului tine cont de numarul de pachete ale fiecarui produs Numără coletele de pe AWB după numărul de pachete setat pe fiecare produs, în loc să trimită mereu unul.
Setări de printare și opțiuni avansate

Apasă Salvare. Cardul Speedy arată acum Conectat.

Mai multe puncte de ridicare

Deschide meniul ⋮ de pe cardul Speedy și alege Conecteză-te la alt cont de curierat, sau deschide o conexiune existentă și apasă Clonează ca să îi copiezi toate setările. Fiecare conexiune are contractul ei, codurile ei de serviciu și serviciile ei adiționale, iar tu alegi între ele după Nume Conexiune când generezi AWB-ul. Șterge, din același loc, elimină o conexiune pe care nu o mai folosești.

Generarea AWB-urilor

Deschide Comenzi, selectează comenzile și folosește Generare AWB, sau deschide o singură comandă și generează AWB-ul de acolo. Câteva lucruri se rezolvă automat:

  • Rambursul se adaugă automat când comanda se plătește la livrare, la valoarea comenzii. Tip de pocesare decide cum ți-l plătește Speedy.
  • Birourile și automatele Speedy. Când clientul a ales un birou sau un automat Speedy, AWB-ul merge acolo în locul adresei de domiciliu, fără nicio modificare pe conexiune.
  • Greutatea. O comandă fără greutate se trimite cu 0,25 kg.
  • Destinațiile. AWB-uri Speedy se pot genera pentru Bulgaria, România, Grecia, Polonia, Ungaria, Cehia, Slovacia, Austria, Germania, Italia și Franța. Pentru orice altă țară, comanda afișează Curierul selectat nu suportă livrări în această țară.

Expedieri în străinătate: dimensiunile coletului

Pune comenzii o cutie de împachetare — îți definești cutiile în Cutii de împachetare, apoi selectezi comanda în Comenzi și folosești Selectați cutii de împachetare — și generează AWB-ul din pagina comenzii. Fiecare cutie de pe comandă devine un colet, iar lungimea, lățimea, înălțimea și greutatea ei pleacă la Speedy odată cu AWB-ul. Tot din pagina comenzii generezi un AWB cu mai multe colete sau plicuri.

Când Speedy refuză un AWB

Speedy răspunde în bulgară, iar mesajul lui apare pe comandă așa cum vine. Acestea sunt cele pe care merită să le recunoști.

Mesaj Ce înseamnă
Пакети: Изискват се описани размери на пакета Sunt necesare dimensiunile coletului. Frecvent la serviciile internaționale — pune comenzii o cutie de împachetare și generează AWB-ul din pagina comenzii.
Услуга: Услугата не е позволена Serviciul nu este permis: codul trimis nu este unul pe care contractul tău îl poate folosi pentru acea destinație. Verifică cele trei coduri de serviciu cu Speedy.
Получател Адрес: Попълнете номер на улица/блок … Adresa de livrare nu are număr de stradă sau de bloc. Completează adresa pe comandă și generează din nou AWB-ul.
Получател Телефон 1: Невалидна стойност Numărul de telefon al destinatarului lipsește sau nu este unul acceptat de Speedy.
Получател Лице за контакт: … Comanda este pentru o firmă, iar persoana de contact trebuie să fie numele unei persoane, diferit de numele firmei. Corectează numele din adresa de livrare.
Обявена стойност: … е по-голяма от максималната … Cu Livrare asigurată pornită, valoarea declarată depășește ce permite serviciul. Limita este a Speedy, pe fiecare serviciu.
Пакети: Броят пакети е извън допустимия интервал … Numărul de colete este în afara intervalului acceptat de serviciu.
Получател Адрес 2: Максималната позволена дължина е 35 A doua linie de adresă are mai mult de 35 de caractere. Scurteaz-o pe comandă.
Ce înseamnă refuzurile Speedy

Întrebări frecvente

Credențialele API pe care Speedy le emite pentru contractul tău, nu utilizatorul și parola de pe site-ul Speedy. Accesul API îl ceri de la Speedy, la telesales@speedy.bg.

Apasă întâi Obține detalii. Se autentifică la Speedy și citește punctele din contractul tău, iar restul formularului — inclusiv Salvare — apare abia după ce reușește. Dacă întoarce o eroare, datele sunt greșite sau accesul API nu a fost activat încă.

easySales listează doar punctele care au un număr de telefon în Speedy, pentru că Speedy printează telefonul expeditorului pe fiecare AWB. Cere Speedy să adauge un număr de telefon pentru acel punct, apoi apasă din nou Obține detalii.

Sunt id-urile numerice de serviciu ale Speedy, din contractul tău: Codul serviciului local pentru livrarea în aceeași localitate, Codul serviciului național între localități și Codul serviciului internațional pentru coletele care pleacă din Bulgaria. Pentru o adresă din Bulgaria, România sau Polonia, easySales întreabă Speedy ce servicii ajung acolo și trimite primul confirmat, în această ordine.

Speedy îți spune că serviciul trimis nu este unul pe care contractul tău îl poate folosi pentru acea destinație. Întreabă Speedy ce id-uri de serviciu are contractul tău și corectează codurile de pe conexiune.

Serviciile internaționale Speedy au nevoie de dimensiunile coletului. Pune comenzii o cutie de împachetare (Comenzi → Selectați cutii de împachetare) și generează AWB-ul din pagina comenzii — lungimea, lățimea și înălțimea cutiei se trimit odată cu AWB-ul.

Nu. Când comanda se plătește la livrare, easySales adaugă singur suma de încasat. Tip de pocesare de pe conexiune decide doar cum ți-o plătește Speedy — cash sau prin transfer de bani poștal.

Da. Când clientul a ales un birou sau un automat Speedy, AWB-ul este adresat automat acolo, fără nimic de schimbat pe conexiune.

Deschide meniul ⋮ de pe cardul Speedy și alege Conecteză-te la alt cont de curierat, sau deschide o conexiune existentă și apasă Clonează. Adresa de ridicare urmează punctul ales la Contract, deci un al doilea punct de ridicare înseamnă o a doua conexiune.

Format AWB se trimite la Speedy și decide cum arată AWB-ul produs de Speedy — o pagină A4 întreagă, un AWB A6 sau patru AWB-uri A6 pe o coală A4. Formatul de hârtie din setările de printare se aplică doar când printezi prin conexiunea Printer din easySales și suprascrie setarea implicită a imprimantei doar pentru curierul acesta.

A fost util acest ghid?