LGL Solutions

[ SERVICII LGL SOLUTIONS ]

Integrări API care păstrează datele sincronizate

Contracte clare, idempotency keys și retry logic pentru integrarea sistemelor externe.

Solicită o ofertăVezi structura de prețuri și ofertare
De la 3.800 €RESTJSONTypeScriptPostgreSQLWebhooks
$ POST /v1/reconcile?provider=oblioHTTP/2 200 · 112 ms{  "provider": "oblio",  "checked": 120,  "matched": 118,  "differences": [    {      "type": "status_divergent",      "auto_fix": false    },    {      "type": "intarziere",      "auto_fix": false    }  ]}
Arhitectură de Referință LGL · Edge Deployment

CE PRIMEȘTE PROIECTUL

Sisteme conectate, cu date care se pot reconcilia

Un request HTTP nu este o integrare: contractul, eroarea și auditul contează la fel de mult.

OBLIO.EU • SMARTBILL

Facturare mapată explicit

Oblio.eu este conectorul principal; SmartBill se acoperă ca alternativă. Clientul, produsele, TVA-ul, moneda și seria documentului sunt mapate pentru fiecare API, cu ID-uri locale și externe păstrate.

REST API • IDEMPOTENT

Fără facturi duplicate

Fiecare comandă externă primește o cheie derivată din operațiune.

SAMEDAY • FAN COURIER

AWB și tracking

Expedierile și statusurile de curier rămân legate de comanda internă.

STRIPE • WEBHOOKS

Plăți event-driven

Plata se actualizează numai după evenimentul autorizat și semnat.

POSTGRESQL • RECONCILIERE

Diferențe semnalate

Nicio corecție financiară automată fără o regulă explicită.

O integrare API de producție nu înseamnă doar un request HTTP. Definim contractul datelor, timeout-ul, autentificarea, idempotency key și politica de retry cu exponential backoff. Răspunsurile sunt validate și stocate suficient pentru audit și depanare.

Putem evalua conectarea la servicii precum Oblio.eu, SmartBill, Sameday, Fan Courier, Stripe sau sisteme ERP existente, în funcție de API-ul și accesul disponibile pentru proiect. Exemplele de mai jos sunt scenarii posibile, nu integrări prezentate ca fiind deja realizate pentru clienți. Un job de reconciliere poate compara starea locală cu sistemul extern și semnala diferențele fără să rescrie orbește datele.

Vezi structura de prețuri și ofertare

Începe cu o singură integrare bine definită

În loc să presupunem că toate sistemele pot fi conectate la fel, putem începe cu un flux delimitat:

  1. Identificăm sistemele implicate.
  2. Verificăm disponibilitatea și limitele API-urilor.
  3. Stabilim fluxul de date și regulile.
  4. Delimităm cazurile de eroare.
  5. Definim testele și acceptarea.
  6. Estimăm implementarea.

Exemplele pot include facturare, CRM, plăți sau notificări, dar sunt scenarii posibile care necesită verificare înainte de ofertare. Descrie integrarea dorită.

Contracte externe și identificatori

Pentru Oblio.eu (și, la cerere, SmartBill) putem mapa explicit clientul, produsele, TVA-ul, moneda și seria documentului. Nu presupunem că etichetele locale au aceeași semnificație în fiecare API. Păstrăm ID-ul local, ID-ul extern, payload-ul minim și versiunea contractului. Pentru Sameday și Fan Courier normalizăm AWB-ul, statusurile și evenimentele de tracking într-un model intern stabil.

Idempotency și retry logic

În funcție de contractul furnizorului, fiecare comandă externă poate primi o cheie de idempotență derivată din operațiune și ID-ul intern. Nu presupunem că furnizorul acceptă nativ cheia sau că lipsa duplicatelor poate fi garantată în orice condiții; definim separat deduplicarea internă, reconcilierea și retry-urile sigure.

Fiecare operațiune primește o idempotency key derivată din operațiune și ID-ul intern. Retry-ul cu exponential backoff se aplică doar erorilor tranzitorii și are limită; un 400 de validare merge într-o coadă de intervenție, nu este repetat la nesfârșit. Timeout-urile sunt separate pentru conectare și citirea răspunsului, iar circuit breaker-ul protejează aplicația când un furnizor cade.

Stripe și webhooks

Stripe este tratat event-driven: verificăm semnătura webhook-ului, stocăm event ID-ul și actualizăm plata numai după evenimentul autorizat. Pentru Stripe Connect, contul conectat și transferul sunt corelate cu comanda, iar refund-ul are propria stare. Nu considerăm redirectul din browser dovadă de plată. În cazul 3D Secure, clientul poate reveni mai târziu, iar serverul rămâne sursa de adevăr.

Reconciliere și baze de date

Un job de reconciliere compară periodic înregistrările locale cu Oblio.eu, SmartBill, curierul sau Stripe. Diferențele sunt clasificate: întârziere, lipsă, sumă diferită sau status divergent. Nu reparăm automat o diferență financiară fără regulă explicită. PostgreSQL păstrează tranzacțiile, indexurile pe ID extern și istoricul schimbărilor; datele sunt suficient de precise pentru audit.

Testare în România

Folosim medii sandbox unde furnizorul le oferă și payloaduri contractuale versionate. Testăm TVA, lei, facturi stornate, numere de telefon românești, AWB duplicat, timeout și limitare de rată. Documentația de operare explică ce poate relua operatorul și ce necesită analiza unui dezvoltator.