Uporabniška orodja

Orodja spletišča


nabisrestapi-document-v1-7a04stt

Primerjava izbranih različic

Prikazane so razlike med izbrano in trenutno različico strani.

Poveži s tem pogledom primerjave.

Both sides previous revision Prejšnja revizija
Naslednja revizija
Prejšnja revizija
nabisrestapi-document-v1-7a04stt [2017/10/05 09:03]
rok-navodila
nabisrestapi-document-v1-7a04stt [2017/10/05 14:53] (Trenutna)
Vrstica 5: Vrstica 5:
   * Application-Id:​ UUID vaše aplikacije   * Application-Id:​ UUID vaše aplikacije
  
-==== getDocumentHeaders ==== +==== getDocumentHeaders ​(GET) ==== 
-Izvoz glav naročil. Brez dodatnih parametrov se izvozi zadnjih 10 naročil.+Izvoz glav naročil. Brez dodatnih parametrov se izvozi zadnjih 10 novih naročil.
 === Parametri === === Parametri ===
   * page: celo število večje od 0, privzeto: 1   * page: celo število večje od 0, privzeto: 1
 +  * flags: ena ali več oznak naročil ločenih z vejico (privzeto: new):
 +    * read: naročilo je bilo prebrano z getDocument zahtevo
 +    * hidden: naročilo ste ročno označili kot skrito s setDocumentFlags
 +    * processed: naročilo ste ročno označili kot obdelano s setDocumentFlags
 +    * //new//: nova naročila (niso označena z nebeno od zgornjih oznak) (privzeto)
 +    * //any//: vsa naročila, ne glede na oznake
 === Primer === === Primer ===
   * URL/​getDocumentHeaders?​Client-Id=//<​UUID1>//&​Application-Id=//<​UUID2>//​   * URL/​getDocumentHeaders?​Client-Id=//<​UUID1>//&​Application-Id=//<​UUID2>//​
   * URL/​getDocumentHeaders?​Client-Id=//<​UUID1>//&​Application-Id=//<​UUID2>//&​page=2   * URL/​getDocumentHeaders?​Client-Id=//<​UUID1>//&​Application-Id=//<​UUID2>//&​page=2
 +  * URL/​getDocumentHeaders?​Client-Id=//<​UUID1>//&​Application-Id=//<​UUID2>//&​flags=read,​new
  
 Odgovor: Odgovor:
Vrstica 22: Vrstica 29:
       "​supplierName":​ "​DOBAVITELJ 1234",       "​supplierName":​ "​DOBAVITELJ 1234",
       "​supplierVATID":​ "​SI12345678",​       "​supplierVATID":​ "​SI12345678",​
 +      "​deliveryDate":​ "​2016-06-07",​
       "​orderValue":​ "​10.51840000",​       "​orderValue":​ "​10.51840000",​
       "​orderItemCount":​ 1,       "​orderItemCount":​ 1,
Vrstica 32: Vrstica 40:
   * documentID(int):​ ID naročila (uporabno npr. pri zahtevi getDocument)   * documentID(int):​ ID naročila (uporabno npr. pri zahtevi getDocument)
   * documentName(string):​ Nabis naziv naročila   * documentName(string):​ Nabis naziv naročila
-  * documentDate(string): datum in čas oddaje naročila+  * documentDate(datetime): datum in čas oddaje naročila ​(YYYY-MM-DD hh:mm:ss)
   * deliveryNoteID(string|null):​ Številka dobavnice (ali NULL v primeru da dobavitelj ni podal podatka)   * deliveryNoteID(string|null):​ Številka dobavnice (ali NULL v primeru da dobavitelj ni podal podatka)
   * supplierName(string):​ Naziv dobavitelja   * supplierName(string):​ Naziv dobavitelja
   * supplierVATID(string):​ ID za DDV s predpono (SI, AT, ...) ali davčna številka   * supplierVATID(string):​ ID za DDV s predpono (SI, AT, ...) ali davčna številka
 +  * deliveryDate(date):​ datum dobave ki ga je izbrala stranka (YYYY-MM-DD)
   * orderValue(decimal):​ vrednost naročila, brez DDV   * orderValue(decimal):​ vrednost naročila, brez DDV
   * orderItemCount(int):​ število postavk na naročilu   * orderItemCount(int):​ število postavk na naročilu
 +  * flags(string[]):​ kombinacija sledečih oznak (lahko nobena):
 +    * read
 +    * hidden
 +    * processed
  
-==== getDocument ====+==== getDocument ​(GET) ====
 Izvoz posameznega naročila. Izvoz posameznega naročila.
 === Parametri === === Parametri ===
Vrstica 49: Vrstica 62:
  
   {   {
-    "​documentID": ​10063+    "​documentID": ​10060
-    "​documentName":​ "2017\/1", +    "​documentName":​ "2016\/9", 
-    "​documentDate":​ "2017-02-12 19:37:18",+    "​documentDate":​ "2016-06-06 12:50:26",
     "​deliveryNoteID":​ null,     "​deliveryNoteID":​ null,
     "​supplierName":​ "​Dobavitelj 1234",     "​supplierName":​ "​Dobavitelj 1234",
     "​supplierVATID":​ "​SI12345678",​     "​supplierVATID":​ "​SI12345678",​
 +    "​deliveryDate":​ "​2016-06-07",​
     "​flags":​ [],     "​flags":​ [],
     "​supplierAddress":​ "​NAVADNA ULICA 15",     "​supplierAddress":​ "​NAVADNA ULICA 15",
Vrstica 62: Vrstica 76:
     "​items":​ [     "​items":​ [
         {         {
-            "​eanCode": ​null+            "​eanCode": ​"​1234567890123"​
-            "​code":​ "2285",+            "​code":​ "1234",
             "​productName":​ "BELA \u0160TRUCA 1,00 KG",             "​productName":​ "BELA \u0160TRUCA 1,00 KG",
             "​unit":​ "​KOS",​             "​unit":​ "​KOS",​
Vrstica 75: Vrstica 89:
         {         {
             "​eanCode":​ null,             "​eanCode":​ null,
-            "​code":​ "2270",+            "​code":​ "5678",
             "​productName":​ "​POLBELA \u0160TRUCA 1,00 KG",             "​productName":​ "​POLBELA \u0160TRUCA 1,00 KG",
             "​unit":​ "​KOS",​             "​unit":​ "​KOS",​
Vrstica 89: Vrstica 103:
   }   }
   ​   ​
 +=== Polja ===
 +  * Polja ki so identična s polji iz getDocumentHeaders imajo enako vsebino in tip
 +  * supplierAddress(string):​ naslov dobavitelja
 +  * supplierZipCode(string):​ poštna številka dobavitelja
 +  * supplierCity(string):​ kraj dobavitelja
 +  * supplierOrderNotes(string):​ opombe naročila ki jih je vpisal dobavitelj. Lahko več vrstic, ločilo: //\n//
 +  * items: seznam postavk naročila:
 +    * eanCode: EAN šifra ali NULL
 +    * code(string):​ dobaviteljeva šifra artikla
 +    * productName(string):​ naziv artikla
 +    * unit(string):​ enota mere
 +    * amount(decimal):​ naročena količina
 +    * salesGrossPrice(decimal|null):​ cena brez rabata in brez DDV ali NULL
 +    * discountPercentage(decimal|null):​ rabat % ali NULL
 +    * netPrice(decimal|null):​ neto cena ali NULL
 +    * taxPercentage(decimal|null):​ DDV % ali NULL
 +
 +
 +==== setDocumentFlags (POST) ====
 +Nastavi ali doda oznake naročil.
 +=== Parametri ===
 +  * documentID: ID naročila (obveznen parameter)
 +  * flags: kombinacija sledečih oznak (lahko nobena) ločenih z vejico (obvezen parameter):
 +    * read
 +    * hidden
 +    * processed
 +  * mode: način spreminjanja (privzeto: add):
 +    * add: doda k že obstoječim oznakam
 +    * set: odstrani obstoječe oznake in nastavi na podane
 +=== Primer ===
 +  * URL/​setDocumentFlags?​Client-Id=//<​UUID1>//&​Application-Id=//<​UUID2>//&​documentID=10060&​flags=processed
 +    * Doda oznako "​obdelano"​
 +  * URL/​setDocumentFlags?​Client-Id=//<​UUID1>//&​Application-Id=//<​UUID2>//&​documentID=10060&​mode=set&​flags=
 +    * Odstrani vse obstoječe oznake
 +  * URL/​setDocumentFlags?​Client-Id=//<​UUID1>//&​Application-Id=//<​UUID2>//&​documentID=10060&​mode=set&​flags=read,​hidden
 +    * Odstrani vse obstoječe oznake in nastavi oznaki "​prebrano"​ in "​skrito"​
 +
 +Odgovor:
 +  {
 +    "​documentID":​ 10060,
 +    "​flags":​ ["​read",​ "​processed"​]
 +  }
 +
 +=== Polja ===
 +  * documentID: ID naročila
 +  * flags: novo stanje po spremembi
 +
 +==== Napake ====
 +  * Vsaka pravilna zahteva ima HTTP status 200
 +  * V primeru napačne metode (GET, POST) je status 405
 +  * V primeru napak v parametrih je status 400, ter dodan HTTP header REST-Errors s kratkim opisom napake
  
nabisrestapi-document-v1-7a04stt.1507187034.txt.gz · Zadnja sprememba: 2017/10/05 09:03 (urejanje v zunanjem urejevalniku)