API pentru comerciantii online: Diferență între versiuni

De la wiki.livrarionline.ro
Salt la: navigare, căutare
 
(Nu s-au afișat 41 de versiuni intermediare efectuate de același utilizator)
Linia 1: Linia 1:
'''Modelul comerciantilor LivrariOnline.ro'''
+
== '''Modelul comerciantilor LivrariOnline.ro''' ==
  
 
Comerciantii inregistrati primesc un cont in sistem definit prin:
 
Comerciantii inregistrati primesc un cont in sistem definit prin:
  
*un identificator unic «ID Companie de curierat »;
+
*un identificator unic '''«ID Companie de curierat»''';
*un identificator unic «ID Comerciant »;
+
 
 +
*un identificator unic '''«ID Comerciant»''';
 +
 
 
*chei de securitate;
 
*chei de securitate;
 +
 
*conturi de utilizator.
 
*conturi de utilizator.
  
<br/>'''Serviciile contractate de Comercianti'''
+
== '''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.).
 
Atunci cand Comerciantii semneaza contractul, compania de curierat defineste serviciile contractate cu toti parametrii agreati (de exemplu pret livrare loc, sau km inclusi, etc.).
Linia 24: Linia 27:
  
  
Functionalitatile API:
+
== '''Functionalitatile API''' ==
 +
 
 +
Toate cererile API de inregistrare livrari online sunt trimise sistemului Livrari Online in formatul&nbsp;'''«application/x-www-form-urlencoded»''', iar raspunsul serviciului va fi in formatul&nbsp;'''«Content type: text/json»'''.
  
== Cum se adauga o livrari/Cum se genereaza un AWB ==
+
*Cererile sunt construite in format JSON.
 +
*Fiecare camp utilizat de API Livrari Online are un nume de forma f_nume_camp.
  
Toate cererile API de inregistrare livrari online sunt trimise sistemului Livrari Online in formatul «&nbsp;SOAP - application/json&nbsp;».
+
=== [[Cum se adauga o livrare/Cum se genereaza un AWB]] ===
  
Cererile sunt construite in format JSON:
+
=== [[Print AWB/Document de transport]] ===
  
*Fiecare camp utilizat de API Livrari Online are un nume de forma f_nume_camp. De exemplu:
+
Dupa ce ati obtinut AWB (nr documentului de transport) &nbsp;puteti sa incarcati direct si Documentul de transport aferent.
  
<source lang="php">
+
Incarcarea documentului de transport se face prin accesarea linkului:&nbsp;
{"loapi":
 
{"f_login":0192022210,
 
"f_request":"39795057696e61727a744",
 
"f_secure":"BI6LOK68S\/1v8v+hKNjHiDo3lbZfACR19fYWPWDwBbzqe8bCu\/ThSy9F8=" } }
 
</source>
 
  
*Numele campurilor este “'''case sesitive'''”.
+
[http://api.livrarionline.ro/Lobackend_print/PrintAwb.aspx?f_login=nr_comerciant&awb=nrawb http://api.livrarionline.ro/Lobackend_print/PrintAwb.aspx?f_login=nr_comerciant&amp;awb=nrawb]
*Stabiliti metoda '''POST''' pentru trimiterea datelor.
 
*Trimiteti datele la adresa URL:&nbsp;[https://api.livrarionline.ro/Lobackend.asmx/GenerateAwb https://api.livrarionline.ro/Lobackend.asmx/GenerateAwb]
 
  
  
  
Campul&nbsp;'''f_login''' reprezinta ID-ul de comercisnt din sistem.
+
Parametrii GET:
  
Campul == '''f_request''' == reprezinta&nbsp;datele despre livrare&nbsp;intr-un '''bloc JSON''', incriptate cu '''algoritmul AES''' cu o '''cheie de securitate generata aleator''' pentru fiecare cerere la server; Rezultatul incriptarii '''AES''' este tranformat in '''base64''' si apoi in '''hexa'''.
+
*'''f_login''' - ID Comerciant - [http://wiki.livrarionline.ro/index.php?title=Interfata_comerciantilor#Info_API.2C_adica_implementarea_modulului_de_shipping_pe_platforma_on-line Cum se obtin datele pentru API?]&nbsp;
  
Campul&nbsp;'''f_secure''' reprezinta '''cheia AES generata random''' incriptata cu '''algoritmul RSA''' si transformata in '''base64'''.
+
*'''awb -'''&nbsp;nr documentului de transport
  
== Printarea AWB-ului ==
+
=== [[Urmarire AWB]] ===
  
== Urmarirea AWB-ului ==
+
=== Interogare referinta AWB ===
  
== Interogare referinta AWB ==
+
=== [[Anulare AWB]] ===
  
== Anularea AWB-ului ==
+
== '''Serviciul ISSN (Instant Shipping Status Notification)''' ==

Versiunea curentă din 21 noiembrie 2016 14: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

Toate cererile API de inregistrare livrari online sunt trimise sistemului Livrari Online in formatul «application/x-www-form-urlencoded», iar raspunsul serviciului va fi in formatul «Content type: text/json».

  • Cererile sunt construite in format JSON.
  • Fiecare camp utilizat de API Livrari Online are un nume de forma f_nume_camp.

Cum se adauga o livrare/Cum se genereaza un AWB

Print AWB/Document de transport

Dupa ce ati obtinut AWB (nr documentului de transport)  puteti sa incarcati direct si Documentul de transport aferent.

Incarcarea documentului de transport se face prin accesarea linkului: 

http://api.livrarionline.ro/Lobackend_print/PrintAwb.aspx?f_login=nr_comerciant&awb=nrawb


Parametrii GET:

  • awb - nr documentului de transport

Urmarire AWB

Interogare referinta AWB

Anulare AWB

Serviciul ISSN (Instant Shipping Status Notification)