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.
- Completează datele exact ca pe actele firmei — apar pe etichetele AWB (adresa de ridicare) și pe documente.
- 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 de unde ridică curierul coletele (depozit/sediu). Apare pe AWB, ca adresă de expeditor.
Județul — Județul de unde ridică curierul. 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
Pepita — panoul de vânzător
Logarea în admin.pepita.hu — de acolo luăm etichetele GLS (AWB) ale comenzilor Pepita.
- Datele cu care intri pe admin.pepita.hu (emailul și parola de vânzător).
- Dacă schimbi parola pe Pepita, schimb-o și aici — altfel AWB-urile nu mai vin în Helion.
Ce ai de copiat
Email — Emailul de logare pe admin.pepita.hu
Parola — Parola de logare pe admin.pepita.hu
ActivArea — furnizor licențe
Contul de pe activarea.ro cu care se cumpără automat licențele comandate de clienți.
- Emailul și parola cu care intri pe activarea.ro (Contul meu).
- Cardul trebuie să fie deja salvat în contul ActivArea; aici pui doar CVV-ul lui (cele 3 cifre de pe spate), pe care site-ul îl cere la fiecare plată.
- Dacă schimbi parola sau cardul pe ActivArea, schimbă-le și aici — altfel licențele nu se mai cumpără singure.
Ce ai de copiat
Email — Emailul de logare pe activarea.ro
Parola — Parola de logare pe activarea.ro
CVV card — Cele 3 cifre de pe spatele cardului salvat în contul ActivArea
Cloudflare — firewall
Blocarea IP-urilor suspecte direct la Cloudflare (portasales.com, autohelix).
- dash.cloudflare.com → profil → API Tokens → Create Custom Token.
- Permisiune: Zone → Firewall Services → Edit; Zone Resources: All zones from an account.
- Lipește aici codul afișat după Create Token (Cloudflare îl arată o singură dată).
Ce ai de copiat
Cheia API (token) — Codul lung afișat de Cloudflare
Stripe — plăți PortaSales
Încasarea abonamentelor PortaSales cu cardul (contul Stripe al firmei).
- dashboard.stripe.com → dreapta sus oprește „Test mode” (să fii pe Live).
- Developers → API keys → la „Secret key” apasă „Reveal live key” și copiaz-o (începe cu sk_live_).
- Lipește-o aici și salvează. Webhook-ul și portalul clientului le face Claude după.
Ce ai de copiat
Cheia secretă (sk_live_…) — Din Stripe → Developers → API keys, modul Live
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.
- 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).
- În Dev Dashboard, în bara neagră din stânga, apasă „Apps” (în română: „App-uri”).
- Sus în dreapta apasă butonul „Create app” („Creează un app”). Se deschide un meniu cu două variante: apasă pe cea de jos, „Create app manually” („Creează manual app-ul”) — NU folosi comanda „npm init…”, e pentru programatori.
- Se deschide un formular. Sus, la „App name” („Nume app”), scrie PortaSales. „Nume versiune” lasă-l gol. La „App URL” („URL-ul app-ului”) lasă ce e scris deja (ex. https://example.com) — e obligatoriu pentru Shopify, dar PortaSales nu-l folosește. Restul secțiunii „URL-uri” lasă-l cum e.
- Mai jos, la „API access” („Acces API”), în dreptul câmpului „Scopes” (în română apare, tradus ciudat, „Domenii”) apasă „Select scopes” („Selectați din listă”) și bifează aceste 8 permisiuni: read_orders, write_orders, read_products, write_products, read_inventory, write_inventory, read_fulfillments, write_fulfillments. Apoi apasă sus în dreapta „Create app” („Creează aplicația”), iar pe ecranul următor „Release” („Lansează”).
- În meniul din stânga al aplicației apasă „Overview” („Prezentare generală”). În dreapta, la „Installs” („Instalări”), apasă butonul „Install app” („Instalează app-ul”). Shopify îți poate cere să te loghezi, apoi arată ecranul „Instalare app” cu mesajul galben „Acest app nu a fost evaluat” — e NORMAL: apare la orice aplicație făcută de tine, fiindcă n-a trecut prin App Store. Apasă „Instalează”.
- Pe aceeași pagină, mai jos, la „Credentials” („Acreditări”): copiază „Client ID” („ID client”) și „Client secret” („Secret client”) cu butonul de copiere din dreapta fiecăruia și pune-le mai jos, în câmpurile cu același nume.
- Primul câmp de mai jos, „Adresa magazinului”, are forma nume.myshopify.com. De unde o iei: în Shopify → Settings → Domains — pe lângă domeniul tău (ex. magazinulmeu.ro) apare unul care se termină în .myshopify.com; pe acela îl copiezi. Îl are ORICE magazin Shopify, chiar dacă nu l-ai folosit niciodată. Apoi apasă „Salvează”. Atât — conectarea o facem noi, automat.
Ce ai de copiat
Adresa magazinului — Forma nume.myshopify.com, NU adresa site-ului tău (ex. magazinulmeu.ro). O găsești în Shopify → Settings → Domains, sau în browser: admin.shopify.com/store/NUME → NUME.myshopify.com.
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.
- Intră în panoul MerchantPro → Setări → API.
- Activează accesul API și notează utilizatorul și parola generate.
- 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.
Gomag
Magazin Gomag — comenzile intră singure; AWB-ul și factura se trec înapoi pe comandă.
- Intră în panoul Gomag → Setări → API.
- Copiază cheia API (Apikey) — dacă nu există, apasă generează.
- Adresa magazinului e cea a site-ului tău, ex. https://www.magazinultau.ro
Ce ai de copiat
Adresa magazinului — Adresa site-ului tău, ex. https://www.magazinultau.ro — aceeași ca în Gomag → Setări → API
Cheie API — Codul lung din Gomag → Setări → API — 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.
WooCommerce
Magazin WordPress + WooCommerce — comenzile intră singure; AWB-ul ajunge la client pe email, factura se notează pe comandă.
- În panoul WordPress intră la WooCommerce → Setări → Avansat → REST API.
- Apasă «Adaugă cheie»: la Descriere scrie PortaSales, la Utilizator alege contul tău de administrator, la Permisiuni alege «Citire/Scriere», apoi «Generează cheia API».
- Copiază Consumer key (începe cu ck_) și Consumer secret (începe cu cs_) — secretul se vede o singură dată.
- Adresa magazinului e cea a site-ului tău, ex. https://www.magazinultau.ro
Ce ai de copiat
Adresa magazinului — Adresa site-ului tău, ex. https://www.magazinultau.ro
Consumer key — Începe cu ck_ — din WooCommerce → Setări → Avansat → REST API
Consumer secret — Începe cu cs_ — se afișează o singură dată, la generarea cheii
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.
- În eMAG Marketplace intră în „Contul meu” → „Profil” → „Detalii tehnice”. Accesul API e deja creat de eMAG pentru orice cont — nu trebuie să activezi sau să creezi nimic.
- IMPORTANT — tot în „Detalii tehnice”, la „IP-uri permise”, adaugă AMBELE adrese: 86.123.111.173 și 162.55.0.253, apoi apasă butonul VERDE „Salvează” de SUS, din DREAPTA paginii. ⚠ Capcană: după ce le scrii, IP-urile apar în listă chiar dacă NU ai salvat — arată bine, dar nu merg. Fără salvare eMAG respinge orice cerere, iar eroarea arată ca „date de acces greșite” — deși emailul și parola sunt bune.
- Pe aceeași pagină găsești „API Code” — copiază-l mai jos, în câmpul „Cheia API eMAG România”.
- Mai jos scrie emailul și parola cu care te loghezi în eMAG Marketplace.
- Același cont eMAG deservește România, Ungaria și Bulgaria. Datele de acces se introduc o singură dată aici; pe cardurile HU și BG completezi doar cheia API a pieței respective, dacă vrei să importăm și produsele/listările de acolo.
- După ce salvezi, apasă „Testează conexiunea”. Dacă primești o eroare, verifică întâi că ai apăsat butonul verde „Salvează” la IP-uri (pasul 2), apoi mai încearcă peste 10-15 minute — eMAG activează IP-urile noi cu întârziere.
Ce ai de copiat
Email eMAG Marketplace — Emailul cu care te loghezi în eMAG Marketplace
Parolă eMAG Marketplace — Parola cu care te loghezi în eMAG Marketplace
Cota TVA la facturare — Alege cota din contul tău de facturare (Oblio sau SmartBill). Se aplică atât produselor, cât și transportului; fără alegere nu emitem facturi.
Cheia API eMAG România — „API Code” din eMAG: Contul meu → Profil → Detalii tehnice. Cu ea importăm produsele/listările și numărul comenzii devine link direct spre eMAG.
eMAG-HU
eMAG Ungaria folosește același cont eMAG. Aici configurezi doar cheia pieței, facturarea și TVA-ul pentru Ungaria.
- Conectează o singură dată contul pe cardul eMAG România. Același utilizator și aceeași parolă sunt folosite și pentru Ungaria.
- Din același cont eMAG, deschide Contul meu → Profil → Detalii tehnice → API Code și copiază cheia aferentă pieței Ungaria.
- 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
Cheia API eMAG Ungaria — „API Code” al pieței Ungaria, din același cont eMAG (Contul meu → Profil → Detalii tehnice). Cu el importăm produsele/listările din emag.hu.
Cota TVA la facturare — Alege cota din contul tău de facturare (Oblio sau SmartBill). Se aplică atât produselor, cât și transportului; fără alegere nu emitem facturi.
eMAG-BG
eMAG Bulgaria folosește același cont eMAG. Aici configurezi doar cheia pieței, facturarea și TVA-ul pentru Bulgaria.
- Conectează o singură dată contul pe cardul eMAG România. Același utilizator și aceeași parolă sunt folosite și pentru Bulgaria.
- Din același cont eMAG, deschide Contul meu → Profil → Detalii tehnice → API Code și copiază cheia aferentă pieței Bulgaria.
- Facturile de Bulgaria au altă cotă de TVA și folosesc EUR — de aceea seria de mai jos e SEPARATĂ de cea de România.
Ce ai de copiat
Cheia API eMAG Bulgaria — „API Code” al pieței Bulgaria, din același cont eMAG (Contul meu → Profil → Detalii tehnice). Cu el importăm produsele/listările din emag.bg.
Cota TVA la facturare — Alege cota din contul tău de facturare (Oblio sau SmartBill). Se aplică atât produselor, cât și transportului; fără alegere nu emitem facturi.
Trendyol
Comenzi și produse Trendyol, inclusiv publicare.
- În panoul tău Trendyol (partner.trendyol.com), apasă sus în dreapta pe numele magazinului → „Detaliile contului”.
- Deschide ultimul tab, „Informații privind integrarea”.
- Apasă butonul portocaliu „Adăugați un integrator nou” și adaugă integratorul PortaSales (dacă butonul nu apare, pornește întâi „Lucrați cu un integrator de marketplace?”).
- Pe cardul PortaSales apasă „Afișați conținutul”, apoi copiază cu iconița de lângă fiecare: ID comerciant (ID entitate), Cheie API și Secret API. „Codul de referință” și „Token” nu ne trebuie.
- Pune-le în căsuțele de mai jos și apasă „Salvează”.
Ce ai de copiat
Cheie API — „Cheie API” din cardul PortaSales — Detaliile contului → Informații privind integrarea
Secret API — „Secret API”, chiar sub Cheia API — copiază-l întreg
ID comerciant (ID entitate) — Doar cifre — îl vezi și sub numele magazinului, în meniul din dreapta sus
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.
- Intră în CEL Marketplace → Setări cont → Acces API.
- Cere activarea modulului API de la reprezentantul tău CEL — fără el, pagina de acces API rămâne goală.
- 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.
- Intră în Okazii → Contul meu → API.
- Generează o cheie de acces și copiaz-o aici.
- 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.
- Intră în Adovo, în „Partner Panel”. În meniul din stânga, la secțiunea TEHNIC, apasă „API & Integrări”.
- IMPORTANT — la „Permisiuni token” bifează AMBELE căsuțe: „Produse (creare/actualizare)” și „Comenzi (citire + ack, pentru ERP)”, apoi apasă „Generează Token Nou”. Un token vechi, făcut înainte, are de obicei DOAR permisiunea de produse — cu el comenzile NU vin la noi.
- Copiază tokenul nou pe loc și pune-l mai jos, la „Token API”. În lista „Token-uri Active” trebuie să scrie la el: Permisiuni: products, orders.
- Apasă „Salvează”, apoi „Testează conexiunea”. Comenzile Adovo vin apoi singure, la câteva minute — nu trebuie setat niciun webhook.
Ce ai de copiat
Token API — Tokenul generat în Adovo → API & Integrări, cu „Comenzi” bifat — 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.
- Cere reprezentantului Altex „cheile de API pentru marketplace” — vin două: una publică și una privată.
- Cheia privată se arată o singură dată. Copiaz-o pe loc; dacă o pierzi, trebuie cerută din nou.
- 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 România
Magazinul Pepita pentru România — feed și comenzi pe /ro.
- Scrie la Seller Support din contul tău Pepita și cere legarea feedului.
- Trimite-le cele două adrese de mai jos pentru magazinul România — «URL Feed» și «URL Comenzi».
- Adresele nu se pun din panoul lor; le configurează ei, la cerere.
Ce ai de copiat
Cheie comenzi — O cheie pe care o alegi tu (ex. un șir lung de litere și cifre) — apare în adresa de comenzi /ro de mai jos, ca doar Pepita să ne poată trimite comenzi.
Seria de facturare pt. această platformă — Exact cum apare în programul tău de facturare (ex. 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.
Pepita Ungaria
Magazinul Pepita pentru Ungaria — feed și comenzi pe /hu.
- Scrie la Seller Support din contul tău Pepita și cere legarea feedului pentru Ungaria.
- Trimite-le cele două adrese de mai jos pentru magazinul Ungaria — «URL Feed» și «URL Comenzi».
- Folosește seria și cota TVA din contul tău de facturare pentru vânzările din Ungaria.
Ce ai de copiat
Cheie comenzi — O cheie pe care o alegi tu (ex. un șir lung de litere și cifre) — apare în adresa de comenzi /hu de mai jos, ca doar Pepita să ne poată trimite comenzi.
Seria de facturare pt. această platformă — Exact cum apare în programul de facturare pentru comenzile din Ungaria
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.
Skroutz
Comenzi Skroutz (Smart Cart). Skroutz ne anunță singur la fiecare comandă; noi o acceptăm, iar AWB-ul vine de la ei.
- În Skroutz Merchants intră la Services → Smart Cart → API și generează tokenul API.
- Aici, la „Cheie webhook”, scrie o parolă lungă, aleasă de tine (litere și cifre) — ea păzește adresa pe care ne sună Skroutz.
- Apasă Salvează și Testează: îți arătăm adresa exactă de webhook. Pune-o în Skroutz Merchants → Smart Cart → Settings → Webhook URL.
Ce ai de copiat
Token API — Din Skroutz Merchants → Services → Smart Cart → API
Cheie webhook — O parolă aleasă de tine (minim 16 caractere) — intră în adresa pe care ne sună Skroutz
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.
Temu
Comenzi Temu (vânzători locali). Comenzile intră singure, iar AWB-ul nostru se trimite înapoi la Temu.
- În Temu Seller Center intră la Apps & Services → App Store și caută PortaSales.
- Apasă Authorize și bifează: Basic Management, Order Management, Order Fulfillment Management, Product Management și Aftersales Management.
- Copiază tokenul (access token) afișat după autorizare și lipește-l mai jos. Tokenul e valabil un an; după aceea autorizezi din nou și pui tokenul nou.
- Comenzile cu plata la livrare (ramburs) se expediază doar pe etichetă Temu, din Seller Center.
Ce ai de copiat
Access token — Din Temu Seller Center, după autorizarea aplicației PortaSales
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.
- Intră în Compari → Centrul de clienți → Setare API și copiază Cheia API.
- Tot acolo, la „Adresa IP”, adaugă adresa serverului nostru: 86.123.111.173.
- 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.
- Cere reprezentantului Infinity acces la API: primești trei lucruri — cont, cheie de aplicație și token de aplicație.
- Toate trei sunt obligatorii. Cu unul lipsă, conexiunea pică fără un mesaj clar despre ce anume lipsește.
- 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.
- Cere reprezentantului GLS activarea accesului MyGLS API pe contul tău.
- 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.
- 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.
- Folosește utilizatorul și parola cu care intri în selfAWB — API-ul FAN merge cu datele de logare, nu cu unele generate.
- 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 Courier
Generare AWB și urmărire colete DPD.
- Sună-ți reprezentantul DPD și cere acces la „DPD API” (i se mai spune și WebService). Primești utilizator și parolă.
- NU sunt datele de logare din aplicația DPD — cere explicit datele de API, altfel îți dau ce nu trebuie.
- 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
ID client DPD — Numărul clientului din contractul DPD sau din contul myDPD — nu este utilizatorul API
Sameday
Generare AWB, easybox și urmărire colete Sameday.
- 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.
- 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.
- 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ă.
- Intră în FGO → „Setări” → „Date utilizatori și date firmă” → „Utilizatori și Permisiuni” → „API Utilizatori”. Când intri acolo, FGO îți arată automat cheia de API — copiaz-o mai jos, la „Cheie privată”.
- 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.
- CUI-ul e cel al firmei tale, fără RO în față.
- Seria e cea pe care o folosești pentru facturi (ex. DM, ECM).
- 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ă — Din FGO → Setări → Date utilizatori și date firmă → Utilizatori și Permisiuni → API Utilizatori — un șir lung de litere și cifre. NU e parola contului
Serie facturi — ex. DM
Firma este plătitoare de TVA? — Alege DA sau NU; FGO folosește răspunsul la calcularea liniilor facturii
SmartBill
Emitere automată de facturi din SmartBill Cloud.
- Intră în SmartBill Cloud → Contul meu → Integrări → API și apasă „Generează token”.
- Copiază emailul cu care intri în SmartBill și token-ul generat.
- 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.
- 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.
- 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
Firma este plătitoare de TVA? — Alege DA sau NU; decide dacă facturile au TVA
Oblio
Emitere automată de facturi. Alternativă la FGO, mai ieftină.
- Intră în Oblio → Setări → Date cont → API.
- Copiază emailul contului și secretul generat.
- 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.
- 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