Cum integrez datele de preț ale concurenților în ERP-ul meu prin API?
Legarea datelor de preț ale concurenților de ERP-ul tău prin API poate elimina copierea manuală a cifrelor și le aduce direct în fluxul de lucru al echipei comerciale. 4pricing nu are un conector nativ pentru ERP: legătura o construiește dezvoltatorul tău (sau al furnizorului ERP) pe API-ul REST documentat, iar ce faci cu datele în ERP rămâne decizia ta.
Răspuns scurt
- Creezi o cheie API în panoul 4pricing; ea se trimite în antetul X-API-Key și cere un plan activ.
- Citești datele cu GET /products/ (produsele urmărite, fiecare cu magazinul și prețul curent) și GET /products/{product_id}/history (istoricul verificărilor); citirile nu consumă credite.
- Dezvoltatorul tău scrie un job care rulează periodic și actualizează câmpul de preț al concurenței în ERP; limita este de 60 de cereri pe minut pe cont.
- Webhook-ul nu e un flux de prețuri: se declanșează doar la evenimente de alertă, deci nu înlocuiește citirea prin API.
Arhitectura tipică a legăturii cu ERP-ul, construită de echipa ta
- Generezi cheia API în panoul 4pricing.net; valoarea completă se vede o singură dată, la creare.
- Adaugi produsele de urmărit cu POST /products/ (URL-ul paginii din magazin) și reții id-ul returnat; pentru multe produse deodată folosești importul CSV, cu coloana url obligatorie și cel mult 2000 de rânduri pe import.
- Dezvoltatorul tău scrie un job care apelează GET /products/ pe cât de des se verifică prețurile (implicit la 6 ore) și, dacă ai nevoie de evoluție, GET /products/{product_id}/history.
- Jobul mapează câmpurile din JSON pe schema ERP-ului tău (de exemplu competitor_price din current_price_cents, best_offer_retailer din retailer, scan_at din last_scraped_at).
- Opțional, configurezi un URL de webhook pe cont, care primește evenimentele de alertă semnate; ce face endpointul tău cu ele este codul tău.
- Validezi legătura: compari datele din ERP cu panoul platformei pe câteva produse pilot.
Exemplu de răspuns JSON și mapare ERP
Un apel GET /products/ returnează obiecte cu câmpuri precum id, name, retailer, current_price_cents, currency, in_stock, role (own sau competitor), group_id și last_scraped_at. Atenție: prețul vine în subunități (bani), deci în ERP îl împarți la 100. Prețurile sunt cele înregistrate, fără conversie valutară și fără tratarea TVA. Pentru un minim al concurenței pe același group_id, fie îl calculezi în job din produsele cu role competitor, fie citești comparația grupului (GET /groups/{group_id}/comparison), care îți dă deja minimul, mediana și cel mai ieftin magazin.
Maparea câmpurilor din răspunsul GET /products/ pe schema ERP.
| Câmp API | Câmp în ERP | Transformare |
|---|---|---|
| current_price_cents | competitor_price | Preț în subunități, deci se împarte la 100 |
| retailer | best_offer_retailer | Retailerul cu cel mai mic preț din același group_id |
| last_scraped_at | scan_at | Se copiază ca atare: arată când a fost ultima verificare |
Greșeli frecvente la integrarea API
- Să faci polling mai des decât se verifică prețurile și să depășești limita de 60 de cereri pe minut; aliniază jobul la intervalul de verificare.
- Să nu gestionezi erorile de tip 429 (limită depășită) și 5xx; adaugă retry cu exponential backoff.
- Să stochezi prețurile fără timestamp: fără last_scraped_at nu știi cât de vechi sunt datele.
Cum te ajută 4pricing
4pricing.net nu oferă conectori nativi către ERP, platforme de e-commerce sau marketplace-uri. Oferă un API REST cu chei API și o specificație OpenAPI, pe care o imporți în clientul tău HTTP sau într-un generator de cod. Citirile (listă, istoric, comparație) nu consumă credite; apelurile care descarcă o pagină de magazin (căutare, produs nou din URL, reîmprospătare) consumă câte un credit. Poți trimite și prețurile tale către 4pricing prin API (/own-products), fără scraping și fără credit. Exportul disponibil este CSV pentru lista de produse. Alertele pot ajunge în panou sau prin webhook semnat, la ciclul de verificare pe care l-ai stabilit.