API pentru comerciantii online: Diferență între versiuni

De la wiki.livrarionline.ro
Salt la: navigare, căutare
Linia 24: Linia 24:
 
Functionalitatile API:
 
Functionalitatile API:
  
==Adaugarea unei livrari/Generare AWB==
+
== Cum se adauga o livrari/Cum se genereaza un AWB ==
 +
 
 +
Toate cererile API de inregistrare livrari online sunt trimise sistemului Livrari Online in formatul « SOAP - application/json ».
 +
 
 +
Cererile sunt construite in felul urmator:
 +
 
 +
*Fiecare camp utilizat de Livrari Online are un nume de forma f_nume_camp. De exemplu:
 +
<source lang="json">
 +
{"loapi":
 +
{"f_login":10,
 +
"f_request":"39795057696e61727a7443534c5832767a426c4c595838494d566e474f4c384a767051596f6f4c337043673d",
 +
"f_secure":"BI6LOK68S\/1v8v1QdPIF7n6XD7XnkNrbVRHAlRJWBxkQOB2Chw+hKNjHiDo3lbZfACR19fYWPWDwBbzqe8bCu\/ThSqbnqArFXsLiwFmZKPmsqOh0BPDQuprU7KGGF\/WsbmT\/M0RFcQq0ltzxs3F3NL3i1HvLJf9GAzR7y\/Ey9F8="
 +
}
 +
}
 +
</source>
 +
 
 +
Restul campurilor pe care le trimiteti doar tranziteaza sistemul si ajung inapoi la pagina de raspuns;
 +
 
 +
*La valoarea campului toate textele se incapsuleaza intre ghilimele sau apostrof. De exemplu un camp ce contine mesajul de final tranzactie va fi definit: <nowiki><input type=”text” name=”frm_mesaj” value=”Va multumim pentru achizitie”/></nowiki>;
 +
 
 +
*Numele campurilor este “'''case insesitive'''”.
 +
 
 +
In formular stabiliti metoda '''POST''' utilizata la trimiterea datelor iar la parametrul '''action''' puneti adresa URL pe care o primiti in momentul in care va inrolati in systemul Plati Online.
 +
 
 +
== De exemplu: ==
 +
 
 +
*'''<nowiki><form name=’frm_po’ method=’post’ action=’https://secure2.plationline.ro/’></nowiki>'''
 +
 
 
==Printarea AWB-ului==
 
==Printarea AWB-ului==
 
==Urmarirea AWB-ului==
 
==Urmarirea AWB-ului==
 
==Interogare referinta AWB==
 
==Interogare referinta AWB==
 
==Anularea AWB-ului==
 
==Anularea AWB-ului==

Versiunea de la data 24 septembrie 2013 11:15

Modelul comerciantilor LivrariOnline.ro

Comerciantii inregistrati primesc un cont in sistem definit prin:

  • un identificator unic «ID Companie de curierat »;
  • un identificator unic «ID Comerciant »;
  • chei de securitate;
  • conturi de utilizator.


Serviciile contractate de Comercianti

Atunci cand Comerciantii semneaza contractul, compania de curierat defineste serviciile contractate cu toti parametrii agreati (de exemplu pret livrare loc, sau km inclusi, etc.).

Serviciile sunt identificate in mod unic in systemul LivrariOnline.ro prin:

  • ID Serviciu.

Aceste elemente de identificare leaga livrarile de contul comerciantului. Aceste informatii le primiti automat pe adresa de e-mail specificata in formularele de contact indata ce inrolare comrciantului a fost facuta cu succes. Recomandam ca indata ce primiti informatiile pe e-mail sa va conectati la interfata comerciantilor https://comercianti.livrarionline.ro/ si sa schimbati parola.

Comerciantii care semneaza contract cu compania de curierat au automat acces API (Application programming interface) pentru gestiunea livrarilor. API este perfect pentru integrarea cu site-urile de e-commerce.

API permite comerciantilor sa automatizeze procesele legate de livrarile comenzilor in cadrul activitatii online/offline.

Functionalitatile API:

Cum se adauga o livrari/Cum se genereaza un AWB

Toate cererile API de inregistrare livrari online sunt trimise sistemului Livrari Online in formatul « SOAP - application/json ».

Cererile sunt construite in felul urmator:

  • Fiecare camp utilizat de Livrari Online are un nume de forma f_nume_camp. De exemplu:
{"loapi":
{"f_login":10,
"f_request":"39795057696e61727a7443534c5832767a426c4c595838494d566e474f4c384a767051596f6f4c337043673d",
"f_secure":"BI6LOK68S\/1v8v1QdPIF7n6XD7XnkNrbVRHAlRJWBxkQOB2Chw+hKNjHiDo3lbZfACR19fYWPWDwBbzqe8bCu\/ThSqbnqArFXsLiwFmZKPmsqOh0BPDQuprU7KGGF\/WsbmT\/M0RFcQq0ltzxs3F3NL3i1HvLJf9GAzR7y\/Ey9F8="
}
}

Restul campurilor pe care le trimiteti doar tranziteaza sistemul si ajung inapoi la pagina de raspuns;

  • La valoarea campului toate textele se incapsuleaza intre ghilimele sau apostrof. De exemplu un camp ce contine mesajul de final tranzactie va fi definit: <input type=”text” name=”frm_mesaj” value=”Va multumim pentru achizitie”/>;
  • Numele campurilor este “case insesitive”.

In formular stabiliti metoda POST utilizata la trimiterea datelor iar la parametrul action puneti adresa URL pe care o primiti in momentul in care va inrolati in systemul Plati Online.

De exemplu:

  • <form name=’frm_po’ method=’post’ action=’https://secure2.plationline.ro/’>

Printarea AWB-ului

Urmarirea AWB-ului

Interogare referinta AWB

Anularea AWB-ului