B2B și API

OfficePlus B2B — plasarea comenzilor și primirea contului de plată direct din aplicațiile dumneavoastră (ERP, contabilitate, achiziții), fără browser. Funcționează atât pentru clienți externi (persoane juridice), cât și pentru angajații proprii și integrări interne.

Autorizare — două căi

Autentificare de client — sesiune de cont (login/parolă din cabinetul clientului). Comenzile se plasează pe contul propriu, prețurile se aplică automat după tipul clientului (persoană fizică / juridică).
Cheie de încredere (X-API-Key) — pentru angajați și aplicații de sistem. Cheia se transmite în antetul X-API-Key și permite plasarea comenzilor pe orice cod de client (client_cod). Cheia se eliberează de administrator (parametrul BIRO26_API_TOKEN) și poate fi revocată oricând.

API — apeluri principale

Apel	Autorizare	Ce face
`GET /api/biro26/shop/products?limit=&q=`	public	catalogul cu prețuri online (retail / ionline / angro), coduri, stoc, imagini
`GET /api/biro26/shop/product/<cod>`	public	fișa produsului
`GET /api/biro26/shop/tree`	public	arborele grupe → categorii
`POST /api/biro26/b2b/order`	sesiune sau cheie	plasează comanda și întoarce imediat mostra contului: număr, total, linkuri semnate PDF / HTML / JSON
`GET /api/biro26/shop/my-invoices`	sesiune client	lista propriilor conturi («Comenzile mele» din cabinet)
`GET /api/biro26/docs?client=&limit=`	cheie	lista conturilor (număr #A-60, dată, client, total)
`GET /api/biro26/doc/<cod>`	cheie	JSON-ul contului: client, rânduri cu coduri de nomenclatură, TVA, total
`GET /api/biro26/report-by-nr/invoice/<nr>`	cheie	PDF-ul contului după numărul vizibil

Exemplu: comandă B2B cu cheie de încredere

curl -X POST https://officeplus.md/api/biro26/b2b/order \
  -H "X-API-Key: CHEIA_DVS" -H "Content-Type: application/json" \
  -d '{"client_cod": 240559,
       "items": [{"cod": 225712, "qty": 2}, {"cod": 183094, "qty": 1}],
       "tva_mode": "inclus"}'

Răspuns: {"success": true, "data": {"cod": 316, "nrmanual": "A-61", "invoice_pdf": "/api/biro26/shop/report/invoice/316?sig=…", "invoice_html": "…", "doc_json": "/api/biro26/doc/316"}} —
linkurile semnate se deschid fără login și dau exact contul de plată oficial.
Prețurile necompletate se iau automat de pe server (coloana după tipul
clientului); rândurile de transport trimise de client se ignoră.

Exemplu: client autentificat

curl -X POST https://officeplus.md/api/biro26/b2b/order \
  -b cookies.txt -H "Content-Type: application/json" \
  -d '{"items": [{"cod": 225712, "qty": 1}], "distance_km": 8}'

Pentru clienți transportul tur-retur este obligatoriu (distance_km) — tariful se alege pe server; la plata în credit transportul nu se prestează.

Cabinetele

Cabinetul clientului (/cont) — tipul fizic/juridic (schimbă coloana de preț), datele pentru credit, formatele contului și secțiunea «Comenzile mele» cu PDF-ul fiecărui cont — inclusiv comenzile plasate prin API.
Cabinetul angajatului — back-office-ul BIRO26 (autorizare de operator): plasarea comenzilor pe orice client, gestiunea prețurilor, creditelor și șabloanelor de documente. Integrările proprii folosesc aceeași cheie de încredere.

Demo funcțional: aplicația de contabilitate LightAccounting alege marfa cu prețuri online prin API, trimite comanda și primește contul de plată de pe site — exact fluxul descris mai sus.

Solicitați cheia B2B: officeplussrl@gmail.com · Tel/WhatsApp +373 620 07 211