Integrarea comenzilor

WooCommerce

1. Descarcă modulul și instalează-l: WordPress → Module → Adaugă → Încarcă modulul.
2. WooCommerce → Setări → Farmaro: lipește cheia magazinului din portal (Cont, echipă, integrare).
3. Bifează „Mod de test” și plasează o comandă de probă, intrând pe magazin cu ?fmr_click=00000000-0000-4000-8000-000000000000 la finalul adresei.
4. În portal, la Urmărire comenzi, apasă „Verifică comanda de test”. Apoi debifează „Mod de test”.

Modulul trimite comanda când ajunge „În procesare”, „Finalizată” sau „În așteptare”, iar anularea și rambursarea totală le trimite singur. Compatibil cu checkout-ul cu blocuri și cu tabelele noi de comenzi (HPOS).

PrestaShop 1.7 și 8

1. Module → Manager module → Încarcă un modul: alege arhiva descărcată.
2. Configurează: lipește cheia magazinului și pornește „Mod de test”.
3. Plasează o comandă de probă cu ?fmr_click=00000000-0000-4000-8000-000000000000 în adresă, apoi verifică-o în portal și oprește „Mod de test”.

Trimite referința comenzii, valoarea fără TVA și transport, produsele cu EAN13 și starea: plasată, anulată sau rambursată.

Shopify

Fără aplicație de instalat: Shopify ne trimite comanda prin webhook-uri, iar fmr_click îl găsim în adresa pe care a intrat vizitatorul.

1. În portal, la Cont, echipă, integrare → Shopify, copiezi adresa webhook-ului (e a magazinului tău).
2. În Shopify: Setări → Notificări → Webhook-uri → Creează webhook, pentru „Creare comandă” și „Anulare comandă”, format JSON, cu adresa copiată.
3. Copiezi cheia cu care Shopify semnează webhook-urile și o lipești în portal.
4. Plasezi o comandă de test (cu gateway-ul de test Shopify): ajunge ca test și o vezi la Urmărire comenzi.

Returnările le marchezi din portal, la Vânzări, cât comanda e în validare.

Gomag, MerchantPro și alte platforme

Două bucăți de cod, puse din panoul platformei acolo unde se adaugă coduri de urmărire. Prima, pe toate paginile: păstrează fmr_click 30 de zile.

<script>(function(){var m=location.search.match(/[?&]fmr_click=([0-9a-f-]{36})/i);
if(m){document.cookie='fmr_click='+m[1]+';path=/;max-age=2592000;SameSite=Lax';}})();</script>

A doua, doar pe pagina de comandă finalizată. Înlocuiești SLUGUL_MAGAZINULUI (îl găsești în portal, la Urmărire comenzi → Imagine), iar NR_COMANDA și VALOARE_FARA_TVA cu variabilele platformei pentru numărul comenzii și valoarea fără TVA și transport.

<script>(function(){var c=(document.cookie.match(/(?:^|; )fmr_click=([^;]+)/)||[])[1];if(!c)return;
new Image(1,1).src='https://farmaro.ro/parteneri/p.gif?m=SLUGUL_MAGAZINULUI&click='+c
+'&comanda='+encodeURIComponent('NR_COMANDA')+'&valoare='+encodeURIComponent('VALOARE_FARA_TVA');})();</script>

Pentru test, adaugă +'&test=1' la finalul adresei imaginii. Anulările le marchezi din portal. Imaginea trebuie să se încarce de pe domeniul magazinului (o verificăm).

Apel API (orice platformă)

Cea mai sigură variantă: serverul magazinului ne trimite comanda când e plasată și când se anulează sau se returnează.

POST https://farmaro.ro/api/v1/parteneri/conversii
Authorization: Bearer fmr_live_…
Content-Type: application/json

{ "click": "valoarea fmr_click", "comanda": "100245",
  "valoare_fara_tva": 186.40, "moneda": "RON",
  "stare": "plasata",            // sau "anulata", "returnata"
  "test": false,
  "produse": [{ "ean": "5940000000000", "valoare": 120.50, "nume": "Magneziu bisglicinat" }] }

Răspunsul spune dacă am atribuit comanda unui click și comisionul calculat. Lista de produse e opțională; cu ea, fiecare produs primește procentul categoriei lui.