Cum îți conectezi magazinul

Durează în jur de 10 minute. Nu trebuie să instalezi nimic și nu trebuie să ne dai parola de la magazin — doar niște chei de acces pe care le faci tu, din contul tău, și pe care le poți șterge oricând.

Fă-ți cont și începe →

Ai deja cont? Pașii de mai jos îi găsești și înăuntru, în pagina Integrări, cu un buton de test lângă fiecare — îți spune pe loc dacă cheile merg.

1. Datele firmei

Se scriu o singură dată. De aici ies numele de pe AWB și de pe factură.

Datele firmei

Firma ta: numele, adresa de unde ridică curierul, contact.

  1. Completează datele exact ca pe actele firmei — apar pe etichetele AWB (adresa de ridicare) și pe documente.
  2. Adresa e cea DE UNDE RIDICĂ CURIERUL coletele (depozit/sediu), nu neapărat sediul social.
Ce ai de copiat
Numele firmei — Ex. AutoSSF S.R.L. — apare pe eticheta AWB
Strada — Fără număr — el vine în căsuța următoare
Numărul — Ex. 57A
Orașul — Orașul din sediul social, exact ca pe certificatul de înregistrare. Apare pe factură și pe AWB, ca adresă de expeditor.
Județul — Județul sediului social. Pentru București scrie „București”, nu sectorul — curierii îl vor așa.
Codul poștal — 6 cifre
Telefon — Numărul la care te sună curierul

2. De unde vin comenzile

Magazinul tău online. Conectează măcar unul — de la prima cheie pusă, contul tău real se deschide singur, în 1-2 minute.

Shopify

Magazinul tău Shopify — comenzi, produse și stocuri.

  1. Intră în Shopify → Settings → Apps and sales channels → „Develop apps”. Shopify te trimite în Dev Dashboard (dev.shopify.com) — apasă „Build apps using Dev Dashboard” (prima dată îți face un cont de dezvoltator, gratuit, legat de magazinul tău).
  2. În Dev Dashboard: „Create app” → numele „PortaSales” → Create.
  3. La versiune/configurare: lasă „App URL” cum e (sau pune https://shopify.dev/apps/default-app-home), iar la „Admin API access scopes” bifează: read_orders, write_orders, read_products, write_products, read_inventory, write_inventory, read_fulfillments, write_fulfillments. Apasă „Release”.
  4. La „Distribution” alege „Custom distribution”, scrie adresa magazinului tău (nume.myshopify.com) și apasă „Generate link”. Deschide linkul și apasă „Install” — aplicația se instalează în magazinul tău.
  5. Înapoi în Dev Dashboard, la aplicație → Settings (sau Credentials): copiază „Client ID” și „Client secret” și pune-le mai jos. NU mai există „Admin API access token” la aplicațiile noi — ni-l facem noi din cele două, automat, în fiecare zi.
  6. Ai deja o aplicație veche, cu token care începe cu shpat_? Merge în continuare: pune-l la „Admin API access token” și lasă goale Client ID și Client secret.
Ce ai de copiat
Adresa magazinului — Forma nume-magazin.myshopify.com, nu adresa ta personalizată.
Cota TVA la facturare — Alege cota din contul tău de facturare (Oblio sau SmartBill). Se aplică produselor și transportului; fără alegere nu emitem facturi pe acest canal.

MerchantPro

Magazin MerchantPro — comenzi, produse, stocuri și prețuri.

  1. Intră în panoul MerchantPro → Setări → API.
  2. Activează accesul API și notează utilizatorul și parola generate.
  3. Adresa API e de forma https://www.magazinultau.ro/api/v2
Ce ai de copiat
Adresa API — https://www.magazinultau.ro/api/v2
Utilizator API — Un cod de litere și cifre generat de MerchantPro la pasul 2 — NU emailul tău
Parolă API — Parola generată de MerchantPro lângă utilizator — NU parola ta de logare
Cota TVA la facturare — Alege cota din contul tău de facturare (Oblio sau SmartBill). Se aplică produselor și transportului; fără alegere nu emitem facturi pe acest canal.

2. (sau) Marketplace-uri

eMAG, Trendyol, CEL, Okazii și celelalte. Merg în paralel cu magazinul; poți conecta câte vrei.

eMAG-RO

Comenzi eMAG, stocuri și AWB-uri prin curierul eMAG.

  1. Utilizatorul și parola de API sunt EXACT emailul și parola cu care te loghezi în eMAG Marketplace. Nu există o parolă separată de API — scrie-le aici pe cele de logare.
  2. Contul trebuie să aibă accesul API activat: eMAG Marketplace → Contul meu → Detalii tehnice → API. Dacă nu e pornit, cere activarea de acolo (se aprobă de obicei în 1-2 zile lucrătoare).
  3. Dacă nu vrei să folosești contul principal, poți crea un utilizator separat în Setări → Utilizatori, îi dai drept de API și pui aici emailul și parola LUI.
  4. IMPORTANT — lista albă de IP: tot în „Detalii tehnice”, la „IP-uri permise”, adaugă adresa 86.123.111.173 și salvează. Fără pasul ăsta eMAG respinge orice cerere, iar eroarea arată ca „date de acces greșite” — deși utilizatorul și parola sunt bune.
  5. Dacă vinzi și în Bulgaria sau Ungaria: fiecare țară are contul ei ȘI lista ei de IP-uri. Adaugă adresa în fiecare cont, separat.
  6. După ce salvezi, apasă „Testează conexiunea” aici. Dacă tot pică, mai așteaptă 10-15 minute — eMAG propagă lista de IP-uri cu întârziere.
Ce ai de copiat
Utilizator API — Emailul cu care te loghezi în eMAG Marketplace
Parolă API — Parola cu care te loghezi în eMAG Marketplace
Cota TVA la facturare — Alege exact cota din contul tău Oblio. Se aplică atât produselor, cât și transportului; fără alegere nu emitem facturi.

eMAG-HU

Comenzile tale de pe eMAG Ungaria (emag.hu). Cont SEPARAT de cel din România — alt user, altă parolă, altă listă de IP-uri.

  1. eMAG Ungaria e un cont DIFERIT de cel din România. Intră în contul tău de emag.hu, nu în cel de .ro.
  2. Utilizatorul și parola de API sunt EXACT cele cu care te loghezi acolo — nu există o parolă separată de API.
  3. Contul meu → Detalii tehnice → API: activează accesul API dacă nu e pornit (se aprobă în 1-2 zile lucrătoare).
  4. La „IP-uri permise” adaugă adresa 86.123.111.173 — SEPARAT, în contul de Ungaria. Lista de IP-uri NU se moștenește din contul de România; ăsta e motivul #1 pentru care pică legătura aici deși în România merge.
  5. Facturile de Ungaria au altă cotă de TVA și altă monedă (HUF) — de aceea seria de mai jos e SEPARATĂ de cea de România.
Ce ai de copiat
Utilizator API Ungaria — Emailul cu care te loghezi în eMAG Ungaria
Parolă API Ungaria — Parola cu care te loghezi în eMAG Ungaria
Cota TVA la facturare — Alege exact cota din contul tău Oblio. Se aplică atât produselor, cât și transportului; fără alegere nu emitem facturi.

eMAG-BG

Comenzile tale de pe eMAG Bulgaria (emag.bg). Cont SEPARAT de cel din România — alt user, altă parolă, altă listă de IP-uri.

  1. eMAG Bulgaria e un cont DIFERIT de cel din România. Intră în contul tău de emag.bg, nu în cel de .ro.
  2. Utilizatorul și parola de API sunt EXACT cele cu care te loghezi acolo — nu există o parolă separată de API.
  3. Contul meu → Detalii tehnice → API: activează accesul API dacă nu e pornit (se aprobă în 1-2 zile lucrătoare).
  4. La „IP-uri permise” adaugă adresa 86.123.111.173 — SEPARAT, în contul de Bulgaria. Lista de IP-uri NU se moștenește din contul de România; ăsta e motivul #1 pentru care pică legătura aici deși în România merge.
  5. Facturile de Bulgaria au altă cotă de TVA și altă monedă (BGN) — de aceea seria de mai jos e SEPARATĂ de cea de România.
Ce ai de copiat
Utilizator API Bulgaria — Emailul cu care te loghezi în eMAG Bulgaria
Parolă API Bulgaria — Parola cu care te loghezi în eMAG Bulgaria
Cota TVA la facturare — Alege exact cota din contul tău Oblio. Se aplică atât produselor, cât și transportului; fără alegere nu emitem facturi.

Trendyol

Comenzi și produse Trendyol, inclusiv publicare.

  1. Intră în Trendyol Partner → Hesabım → Entegrasyon Bilgileri.
  2. Copiază API Key, API Secret și Supplier ID (Satıcı ID).
  3. Pentru România, cere-le să activeze storefront-ul RO — fără el, publicarea produselor eșuează tăcut.
Ce ai de copiat
API Key — Un cod scurt de litere și cifre — îl copiezi din Entegrasyon Bilgileri
API Secret — Al doilea cod, afișat chiar sub API Key — copiază-l întreg
Supplier ID — Doar cifre
Cota TVA la facturare — Alege cota din contul tău de facturare (Oblio sau SmartBill). Se aplică produselor și transportului; fără alegere nu emitem facturi pe acest canal.

CEL.ro

Comenzi de pe CEL.ro.

  1. Intră în CEL Marketplace → Setări cont → Acces API.
  2. Cere activarea modulului API de la reprezentantul tău CEL — fără el, pagina de acces API rămâne goală.
  3. Modulul „Publicare produse” se activează separat, tot de ei.
Ce ai de copiat
Utilizator — Utilizatorul de API primit de la CEL — NU emailul tău de logare
Parolă — Parola de API primită de la CEL, împreună cu utilizatorul
Cota TVA la facturare — Alege cota din contul tău de facturare (Oblio sau SmartBill). Se aplică produselor și transportului; fără alegere nu emitem facturi pe acest canal.

Okazii.ro

Comenzi Okazii. Produsele se trimit prin feed, nu prin API.

  1. Intră în Okazii → Contul meu → API.
  2. Generează o cheie de acces și copiaz-o aici.
  3. Atenție: API-ul Okazii dă DOAR comenzi. Produsele le publici printr-un feed pe care ți-l generăm noi automat.
Ce ai de copiat
Cheie API — Un cod lung — apare după „Generează” la Contul meu → API
Cota TVA la facturare — Alege cota din contul tău de facturare (Oblio sau SmartBill). Se aplică produselor și transportului; fără alegere nu emitem facturi pe acest canal.

Adovo

Comenzi Adovo.

  1. Scrie-i reprezentantului tău Adovo și cere „token de API pentru integrare” — nu se generează singur din cont.
  2. Primești un token lung și, uneori, o adresă de API separată. Dacă nu ți-o dau, lasă câmpul gol: folosim adresa standard.
  3. Dacă îți cer IP-ul de pe care rulează integrarea, e 86.123.111.173.
Ce ai de copiat
Token API — Codul lung primit de la reprezentantul Adovo — lipește-l întreg
Cota TVA la facturare — Alege cota din contul tău de facturare (Oblio sau SmartBill). Se aplică produselor și transportului; fără alegere nu emitem facturi pe acest canal.

Altex Marketplace

Comenzi Altex.

  1. Cere reprezentantului Altex „cheile de API pentru marketplace” — vin două: una publică și una privată.
  2. Cheia privată se arată o singură dată. Copiaz-o pe loc; dacă o pierzi, trebuie cerută din nou.
  3. Dacă îți cer IP-ul de pe care rulează integrarea, e 86.123.111.173.
Ce ai de copiat
Cheie publică — Prima din cele două chei primite de la Altex
Cheie privată — A doua cheie — cea care se arată o singură dată
Cota TVA la facturare — Alege cota din contul tău de facturare (Oblio sau SmartBill). Se aplică produselor și transportului; fără alegere nu emitem facturi pe acest canal.

Pepita

Marketplace din Ungaria, cu magazine și în România, Polonia și Slovacia. Merge pe feed de produse + adresă unde ne trimit comenzile — amândouă le generăm noi, mai jos.

  1. Scrie la Seller Support din contul tău Pepita și cere legarea feedului.
  2. Trimite-le cele două adrese de mai jos, exact cum sunt — «URL Feed» și «URL Comenzi».
  3. Adresele nu se pun din panoul lor; le configurează ei, la cerere.
  4. Începe DOAR cu România — celelalte țări cer conversie valutară.
Ce ai de copiat
Cheie comenzi — O alegem noi și o dăm lor; e în adresa de comenzi.
Seria de facturare pt. această platformă — Exact cum apare în Oblio → Setări → Serii documente
Cota TVA la facturare — Alege cota din contul tău de facturare (Oblio sau SmartBill). Se aplică produselor și transportului; fără alegere nu emitem facturi pe acest canal.

Compari.ro

Comparator de prețuri cu marketplace. Ei ne sună când cineva cumpără; noi le dăm stocul și prețul în timp real.

  1. Intră în Compari → Centrul de clienți → Setare API și copiază Cheia API.
  2. Tot acolo, la „Adresa IP”, adaugă adresa serverului nostru — ți-o arătăm după ce salvezi.
  3. Apoi în „Setări API Marketplace” completează cele trei adrese pe care ți le generăm și pune fiecare pe „Pornit”.
Ce ai de copiat
Cheie API — Codul din Centrul de clienți → Setare API
Cota TVA la facturare — Alege cota din contul tău de facturare (Oblio sau SmartBill). Se aplică produselor și transportului; fără alegere nu emitem facturi pe acest canal.

Infinity

Comenzi Infinity.

  1. Cere reprezentantului Infinity acces la API: primești trei lucruri — cont, cheie de aplicație și token de aplicație.
  2. Toate trei sunt obligatorii. Cu unul lipsă, conexiunea pică fără un mesaj clar despre ce anume lipsește.
  3. Dacă îți cer IP-ul de pe care rulează integrarea, e 86.123.111.173.
Ce ai de copiat
Cont — Numele de cont primit de la Infinity (primul din cele trei)
App Key — Cheia de aplicație — al doilea cod primit de la Infinity
App Token — Tokenul de aplicație — al treilea cod, cel mai lung
Cota TVA la facturare — Alege cota din contul tău de facturare (Oblio sau SmartBill). Se aplică produselor și transportului; fără alegere nu emitem facturi pe acest canal.

3. Curierul

Ca să iasă AWB-ul dintr-un buton. Poți conecta mai mulți și alegi la fiecare comandă.

GLS

Generare AWB și urmărire colete GLS.

  1. Cere reprezentantului GLS activarea accesului MyGLS API pe contul tău.
  2. Utilizatorul e EMAILUL cu care intri în MyGLS, parola e cea de logare. În plus îți trebuie numărul de client (Client Number) — îl găsești în MyGLS sau pe contract.
  3. Parola se trimite criptat — noi o transformăm automat, tu o pui simplu.
Ce ai de copiat
Utilizator MyGLS — Emailul cu care intri pe mygls.ro
Parolă — Parola cu care intri pe MyGLS — o scrii normal, noi o criptăm
Număr de client — Doar cifre — în MyGLS sau pe contractul GLS

FAN Courier

Generare AWB și urmărire colete FAN.

  1. Folosește utilizatorul și parola cu care intri în selfAWB — API-ul FAN merge cu datele de logare, nu cu unele generate.
  2. ID-ul de client îl vezi în selfAWB la datele contului (sau pe contractul FAN).
Ce ai de copiat
Utilizator — Utilizatorul cu care intri în selfAWB
Parolă — Parola cu care intri în selfAWB
ID client — Doar cifre — în selfAWB la datele contului sau pe contractul FAN

DPD

Generare AWB și urmărire colete DPD.

  1. Sună-ți reprezentantul DPD și cere acces la „DPD API” (i se mai spune și WebService). Primești utilizator și parolă.
  2. NU sunt datele de logare din aplicația DPD — cere explicit datele de API, altfel îți dau ce nu trebuie.
  3. Dacă trimiți și în afara țării, întreabă-i ce serviciu ai pe contract pentru livrări externe.
Ce ai de copiat
Utilizator — Utilizatorul de API primit de la DPD — NU cel din aplicația DPD
Parolă — Parola de API primită de la DPD, împreună cu utilizatorul

Sameday

Generare AWB, easybox și urmărire colete Sameday.

  1. Cere reprezentantului Sameday activarea accesului API pe contul tău. Îți dau un UTILIZATOR DE API separat (arată ca «firmaAPI») și o parolă pentru el.
  2. Utilizatorul NU e emailul tău de logare și parola NU e parola ta din eAWB (21 sep 2026: primul client a pus emailul și Sameday a refuzat contul, fără să spună de ce). Dacă nu le mai găsești, cere-le din nou reprezentantului — le poate reseta.
  3. Ai nevoie și de ID-ul punctului de ridicare (de unde ia curierul coletele). Nu-l știi? Salvează doar utilizatorul și parola și apasă «Testează»: îți arătăm punctele tale de ridicare cu ID-urile lor, apoi îl pui pe cel bun.
Ce ai de copiat
Utilizator API — Utilizatorul de API primit de la Sameday (ex. «firmaAPI») — NU emailul tău
Parolă API — Parola utilizatorului de API — NU parola ta din eAWB

4. Facturarea

Ca factura să plece singură, cu seria ta.

FGO

Emitere automată de facturi la fiecare comandă.

  1. Intră în FGO → Setări → API și copiază cheia privată.
  2. NU ne da parola de la FGO — nu ne trebuie și nu ți-o cerem niciodată. Cheia privată e altceva: o generezi tu, o folosim doar ca să emitem facturi, și o poți anula oricând din același loc, fără să-ți schimbi parola.
  3. CUI-ul e cel al firmei tale, fără RO în față.
  4. Seria e cea pe care o folosești pentru facturi (ex. DM, ECM).
  5. La «Adresa magazinului» pune site-ul TĂU, cel de pe care vinzi (ex. https://magazinultau.ro). E adresa pe care FGO o trece drept platforma de unde vine factura. Dacă vinzi doar pe marketplace-uri și n-ai site, las-o goală.
Ce ai de copiat
CUI firmă — Fără RO în față
Cheie privată — Codul din FGO → Setări → API — un șir lung de litere și cifre. NU e parola contului
Serie facturi — ex. DM

SmartBill

Emitere automată de facturi din SmartBill Cloud.

  1. Intră în SmartBill Cloud → Contul meu → Integrări → API și apasă „Generează token”.
  2. Copiază emailul cu care intri în SmartBill și token-ul generat.
  3. NU ne da parola de la SmartBill — nu ne trebuie și nu ți-o cerem niciodată. Token-ul e o cheie separată, făcută pentru programe: o poți regenera oricând din același loc, fără să-ți schimbi parola.
  4. CUI-ul se scrie CU „RO” în față dacă firma e plătitoare de TVA (așa îl cere SmartBill), fără RO dacă nu e.
  5. Seria de facturi e cea din SmartBill → Configurare → Serii (ex. FCT). Trebuie să existe deja la ei — butonul de test o caută.
Ce ai de copiat
Email cont SmartBill — Emailul cu care intri în SmartBill Cloud
Token API — Din Contul meu → Integrări → API → „Generează token”. NU e parola contului
CUI-ul firmei tale — Cu RO în față dacă ești plătitor de TVA (ex. RO12345678), altfel doar cifrele
Serie facturi — Numele seriei din SmartBill → Configurare → Serii, ex. FCT
Plătitor de TVA? — Scrie DA dacă firma e plătitoare de TVA, NU dacă nu e

Oblio

Emitere automată de facturi. Alternativă la FGO, mai ieftină.

  1. Intră în Oblio → Setări → Date cont → API.
  2. Copiază emailul contului și secretul generat.
  3. NU ne da parola de la Oblio — nu ne trebuie și nu ți-o cerem niciodată. Emailul e doar numele contului, iar secretul e o cheie separată, făcută pentru programe: o poți regenera oricând din același loc, fără să-ți schimbi parola.
  4. Seria NU se pune aici: Oblio e program de facturare și își știe seriile. Tu alegi doar CARE serie merge pe fiecare platformă — câmpul «Seria de facturare» din dreptul fiecărui magazin sau marketplace de mai sus.
Ce ai de copiat
Email cont Oblio — Emailul cu care intri în Oblio
Secret API — Codul din Oblio → Setări → Date cont → API, la „Secret”
CUI-ul firmei tale — Doar cifrele, fără RO în față — firma pe care emiți facturile