Uporabniška orodja
nabisrestapi-document-v1-7a04stt
Primerjava izbranih različic
Prikazane so razlike med izbrano in trenutno različico strani.
| Both sides previous revision Prejšnja revizija Naslednja revizija | Prejšnja revizija | ||
|
nabisrestapi-document-v1-7a04stt [2017/10/05 09:18] 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 105: | Vrstica 119: | ||
| * netPrice(decimal|null): neto cena ali NULL | * netPrice(decimal|null): neto cena ali NULL | ||
| * taxPercentage(decimal|null): DDV % 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.1507187905.txt.gz · Zadnja sprememba: 2017/10/05 09:18 (urejanje v zunanjem urejevalniku)
