Bills.hr upotrebljava "kolačiće" (eng. cookies) za pružanje boljega korisničkog iskustva i praćenje posjećenosti. Postavke prihvaćanja kolačića možete namjestiti u vašem internetskom pregledniku. Nastavkom korištenja stranice smatra se da se slažete s korištenjem kolačića u navedene svrhe. Za nastavak kliknite "Prihvaćam". Više o kolačićima pronađite ovdje.
Online dokumentacija dolazi uskoro. Za sve upite oko API-a pošaljite email na podrska@bills.hr
Konekcija (Connection)
U headeru svakog poziva treba poslati token koji se dobije na stranicama www.bills.hr.
|
Name |
Value |
|
header |
Authorization: Bearer {token} |
Zaposlenici (Employees)
[GET]: employees
Dohvat svih zaposlenika
Kupci (Clients)
[GET]: clients
Dohvat svih kupaca.
|
PARAMETERS (QueryString) |
|||
|
Name |
Type |
Default value |
Description |
|
page |
int |
1 |
page number |
|
per_page |
int |
20 |
number of results per page |
Proizvodi (Products)
[GET]: products
Dohvat svih proizvoda.
|
PARAMETERS (QueryString) |
|||
|
Name |
Type |
Default value |
Description |
|
page |
int |
1 |
page number |
|
per_page |
int |
20 |
number of results per page |
Business Spaces
[GET]: businessspaces
Dohvat svih poslovnih prostora.
Naplatni uređaji (Payment Devices)
[GET]: paymentdevice
Dohvat svih naplatnih uređaja.
Kategorije (Categories)
[GET]: categories
Dohvat svih kategorija
[GET]: category/{id}
Dohvat jedne kategorije
|
PARAMETERS (Attribute) |
|||
|
Name |
Type |
Default value |
Description |
|
id |
int |
|
category ID |
[POST]: category
Dodavanje kategorije.
|
PARAMETERS (JSON) |
|||
|
Name |
Type |
Default value |
Description |
|
Naziv |
string |
|
category name |
|
Opis |
string |
|
category description |
[PUT]: category/{id}
Promjena postojeće kategorije.
|
PARAMETERS (Attribute) |
|||
|
Name |
Type |
Default value |
Description |
|
id |
int |
|
category ID |
|
PARAMETERS (JSON) |
|||
|
Name |
Type |
Default value |
Description |
|
Naziv |
string |
|
category name |
|
Opis |
string |
|
category description |
Računi (Documents)
[GET]: documents
Dohvat svih računa.
|
PARAMETERS (QueryString) |
|||
|
Name |
Type |
Default value |
Description |
|
VrstaDokumentaID |
int |
|
1 – izlazni račun 2 – ponuda (offer) 3 – ulazni račun |
|
zaposlenikID |
int |
|
employee ID |
|
datum_od |
string |
|
format d.m.Y |
|
datum_do |
string |
|
format d.m.Y |
|
placen |
int |
|
0 – not paid 1 – paid |
|
naplatniUredjajiID |
int |
|
payment device ID |
|
nacinPlacanjaID |
string |
|
0 – svi (all) T – transakcijski račun (transaction invoice) G – gotovina (cash) K – kartice (credit cards) C – ček (check) O – ostalo (miscellaneous) |
|
naziv |
string |
|
client name |
|
BrojRacuna |
string |
|
|
|
page |
int |
1 |
page number |
|
per_page |
int |
20 |
number of results per page |
Response je JSON koji se sastoji od rezultata dohvata i broja ukupnih stranica prema {page} i {per_page} parametrima.
[GET]: document/{id}
Dohvat jednog računa.
|
PARAMETERS (Attribute) |
|||
|
Name |
Type |
Default value |
Description |
|
id |
int |
|
invoice ID |
[POST]: document
Dodavanje novog računa.
|
PARAMETERS (JSON) |
|||
|
Name |
Type |
Default value |
Description |
|
VrstaDokumentaID |
int |
|
1 – izlazni račun 2 – ponuda (offer) 3 – ulazni račun |
|
JeziciID |
string |
|
hr – croatian en – english |
|
datum |
string |
|
date of invoice creating (format d.m.Y H:i:s) |
|
DatumIsporuke |
string |
|
date of invoice sending (format d.m.Y H:i:s) |
|
naziv |
string |
|
client name |
|
ClientID |
int |
|
client ID (not mandatory) |
|
adresa |
string |
|
client address |
|
grad |
string |
|
client city |
|
postanski |
string |
|
client zip code |
|
drzava |
string |
|
client country |
|
OIB |
int |
|
client OIB |
|
Rabat |
int |
|
% rebate |
|
RabatIznos |
decimal |
|
rebate total (format 10.00) |
|
Ukupno |
decimal |
|
total without tax (format 10.00) |
|
IznosPDV |
decimal |
|
tax total (format 10.00) |
|
Sveukupno |
decimal |
|
total with tax (format 10.00) |
|
NacinPlacanja |
string |
|
0 – svi (all) T – transakcijski račun (transaction invoice) G – gotovina (cash) K – kartice (credit cards) C – ček (check) O – ostalo (miscellaneous) |
|
ValutaPlacanja |
int |
|
deadline in days |
|
Valuta |
string |
|
HRK EUR USD |
|
Kategorija |
ID |
|
category ID (not mandatory) |
|
details |
[] |
|
invoice items |
|
PlacenUCijelosti |
int |
|
0 – not paid |
|
Napomena |
string |
|
Invoice description |
Stavke računa
|
PARAMETERS (JSON) |
|||
|
Name |
Type |
Default value |
Description |
|
name |
string |
|
item name |
|
iznos |
decimal |
|
item price without tax (format 10.00) |
|
popust |
int |
|
% (discount) |
|
bonus |
int |
|
% (bonus) |
|
kolicina |
int |
|
item quantity |
|
ukupno |
decimal |
|
total without tax (format 10.00) |
|
PDV |
int |
|
% (tax) |
|
IznosPDV |
decimal |
|
tax total (format 10.00) |
|
sveukupno |
decimal |
|
total with tax (format 10.00) |
|
BonusStavka |
int |
0 |
(ignore) |
|
KoristiUgovorniRabat |
int |
0 |
(ignore) |
[GET]: document/{id}/fisk
Fiskalizacija računa.
|
PARAMETERS (Attribute) |
|||
|
Name |
Type |
Default value |
Description |
|
id |
int |
|
invoice ID |
[GET]: document/{id}/pdf
Dohvat PDF dokumenta.
|
PARAMETERS (Attribute) |
|||
|
Name |
Type |
Default value |
Description |
|
id |
int |
|
invoice ID |
[GET]: document/{id}/xml
Dohvat XML dokumenta.
|
PARAMETERS (Attribute) |
|||
|
Name |
Type |
Default value |
Description |
|
id |
int |
|
invoice ID |
[POST]: document/{id}/mail
Slanje računa na email koristnika
|
PARAMETERS (Attribute) |
|||
|
Name |
Type |
Default value |
Description |
|
|
string |
|
client email |
Plaćanja (Payments)
[GET]: payments/{id}
Dohvat plaćanja za račun.
|
PARAMETERS (Attribute) |
|||
|
Name |
Type |
Default value |
Description |
|
id |
int |
|
invoice ID |
[POST]: payment
Dodavanje novog plaćanja.
|
PARAMETERS (JSON) |
|||
|
Name |
Type |
Default value |
Description |
|
InvoicesID |
int |
|
invoice ID |
|
DatumPlacanja |
string |
|
format d.m.Y |
|
Iznos |
decimal |
|
format 10.00 |
|
Napomena |
string |
|
|
[PUT]: payment/{id}
Promjena postojećeg plaćanja.
|
PARAMETERS (Attribute) |
|||
|
Name |
Type |
Default value |
Description |
|
id |
int |
|
payment ID |
|
PARAMETERS (JSON) |
|||
|
Name |
Type |
Default value |
Description |
|
InvoicesID |
int |
|
invoice ID |
|
DatumPlacanja |
string |
|
format d.m.Y |
|
Iznos |
decimal |
|
format 10.00 |
|
Napomena |
string |
|
|
[DELETE]: payment/{id}
Brisanje postojećeg plaćanja.
|
PARAMETERS (Attribute) |
|||
|
Name |
Type |
Default value |
Description |
|
id |
int |
|
payment ID |