Documentație BOCP REST Api v1 - BETA

BOCP oferă un REST API prin care sistemele externe (magazine online, aplicații de contabilitate, integrări proprii) pot citi și trimite date către ERP: documente, produse, stocuri, plăți, AWB-uri și altele.

Activare

Pentru a folosi API-ul aveți nevoie de modulul Integrări → BOCP REST API activat în cont.

Din acest modul se pot genera utilizatori de API (user & parolă) și se pot seta limite de acces (adrese IP, module permise, metode HTTP permise).

Termeni și condiții

Utilizatorul serviciului este responsabil pentru:

• securizarea și păstrarea în secret a datelor de acces;
• utilizarea rezonabilă a resurselor — fără apeluri excesive sau repetate inutil;
• păstrarea unei copii locale (cache) unde este posibil, pentru a nu resolicita aceleași informații;
• configurarea limitelor de acces la crearea utilizatorului (IP-uri, module, metode).

În varianta BETA limitele sunt încă în ajustare; pentru volume mari de apeluri contactați suportul.

Reguli de bază

• Accesul se face doar prin HTTPS.
• Autentificarea se face prin HTTP Basic Auth (user și parolă generate în cont).
• Este obligatoriu ca fiecare utilizator API să aibă cel puțin o adresă IP validă în lista de acces.
• La apeluri repetate cu date de autentificare incorecte, IP-ul este blocat temporar (protecție anti brute-force).
• Apelurile de citire (GET) sunt sigure — nu modifică date. Apelurile POST/PATCH/PUT/DELETE aplică modificările imediat.

Logare apeluri

Istoricul apelurilor poate fi verificat în Sistem → Activity log → Api log.

Documentația tehnică completă

Documentația detaliată pentru dezvoltatori — cu descrierea fiecărui endpoint, filtre disponibile, exemple de request/response și un tester interactiv (Swagger) — este disponibilă direct în ERP la adresa:

https://secure.bocp.eu/app/rest/v1/2/apidoc/

Documentația este în limba engleză (destinată dezvoltatorilor) și acoperă:

• vânzări, facturi, proforme, bonuri fiscale, încasări și plăți;
• produse, stocuri, imagini produse, categorii web;
• AWB-uri și puncte de ridicare curier;
• fișe service, cereri trimitere în service;
• abonamente, contacte, puncte de lucru;
• comenzi webshop cu emitere proformă și finalizare;
• căutare cod poștal.

Suport

Pentru întrebări legate de integrare vă rugăm să contactați echipa de suport tehnic BOCP.