NoteCashDebit
Nota obciążeniowa
Pola
Nazwa
czy jest obowiązkowy
typ
klucz obcy
min. wartość/długość
max. wartość/długość
opis
id
NO
Int
NO
1
2147483647
ID
dateCreate
YES
Date
NO
-
-
Data utworzenia
number
YES
String
NO
0
63
Numer dokumentu
place
NO
String
NO
0
31
Miejsce wystawienia
annotation
NO
String
NO
0
65535
Adnotacja
info
NO
String
NO
0
65535
Informacje dodatowe
footer
NO
String
NO
0
65535
Stopka
footerIconPath1
NO
String
NO
0
63
Ścieżka do pierwszej grafiki stopki
footerIconPath2
NO
String
NO
0
63
Ścieżka do drugiej grafiki stopki
footerIconPath3
NO
String
NO
0
63
Ścieżka do trzeciej grafiki stopki
documentHeader
NO
String
NO
0
65535
Nagłowek dokumentu
documentFooter
NO
String
NO
0
65535
Stopka dokumentu
documentInfo
NO
String
NO
0
65535
Infomracje dokdatkowe dokumentu
logoPath
NO
String
NO
0
255
Ścieżka do logo
signPath
NO
String
NO
0
255
Ścieżka do podpisu
personPut
NO
String
NO
0
63
Osoba upoważniona do wystawienia
personGet
NO
String
NO
0
63
Osoba upoważniona do odbioru
language
YES
String
NO
0
7
Język
typeJPK
NO
String
NO
0
7
client
NO
client
YES
-
-
Klient
data
YES
data
YES
-
-
Zestaw danych
postscript
NO
postscript
YES
-
-
Dopisek
status
NO
status
YES
-
-
Status
personBuy
YES
Object (NotecashData)
NO
-
-
Sprzedawca
personSell
YES
Object (NotecashData)
NO
-
-
Nabywca
sendMailDates
NO
Array (NotecashSendDate)
NO
-
-
Daty wysłania wiadomości e-mail
sendSMSDates
NO
Array (NotecashSendSMSDate)
NO
-
-
Daty wysłania wiadomości SMS
editDates
NO
Array (NotecashEdit)
NO
-
-
Daty edycji dokumentu
hash
NO
String
NO
0
10
HASH
dateKind
NO
Int
NO
0
6
Typ daty
dateValue
NO
Date
NO
-
-
Data
documentDate
NO
Date
NO
-
-
Data dokumentu
documentNumber
NO
String
NO
0
31
Number dokumentu
cash
NO
Float
NO
-2147483647
2147483647
Kwota
payed
NO
Float
NO
-2147483647
2147483647
Zapłacono
toPay
NO
Float
NO
-2147483647
2147483647
Pozostało do zapłaty
currency
YES
currency
YES
-
-
Waluta
payKind
YES
payKind
YES
-
-
Sposób płatności
payTime
YES
payTime
YES
-
-
Termin płatności
positions
YES
Array (NotecashPosition)
NO
-
-
Pozycje
exchangeCurrency
NO
currency
YES
-
-
Druga waluta
exchangeRate
NO
Float
NO
0
2147483647
Kurs waluty
exchangeMulti
NO
Float
NO
1
2147483647
Mnożnik waluty
exchangeDate
NO
Date
NO
-
-
Data kursu
exchangeNumber
NO
String
NO
0
31
Numer kursu
Nagłówki
afakturyToken=1234567890123456789012345678901234567890
afakturyId=12345678901;afakturyKey=12346567890abcdef
Akcje
Metoda:
GET
URL:
https://faktura/api/noteCash
Przykładowe dane:
{
"hash": "12345678ab"
}
Metoda:
POST
URL:
https://faktura/api/noteCash
Przykładowe dane:
{
"dateCreate": "2018-01-01",
"number": "1\/01\/2018",
"place": "Warsaw",
"dateKind": 0,
"dateValue": "2018-01-01",
"documentNumber": "1\/01\/2018",
"documentDate": "2018-01-01",
"language": "pl",
"payKind": 1,
"payTime": 1,
"currency": 1,
"payed": 100,
"personBuy": {
"name": "Buyer",
"address": "Address",
"nipKind": 0,
"nip": "1234567890",
"alternativeHeader": 0,
"isVATPayer": 1,
"phone": "012-1234567",
"fax": "012-1234567",
"mail": "address@mail.com",
"www": "http:\/\/address.com",
"krs": "1234567890",
"regon": "1234567890",
"bankAccountFirstNumber": "01 2345 6789 0123 4567 8901 2345",
"bankAccountFirstName": "National Bank",
"bankAccountFirstBic": "BIC",
"bankAccountFirstDescription": "Main account",
"bankAccountSecondNumber": "01 2345 6789 0123 4567 8901 2345",
"bankAccountSecondName": "National Bank",
"bankAccountSecondBic": "BIC",
"bankAccountSecondDescription": "Second account",
"bankAccountThirdNumber": "01 2345 6789 0123 4567 8901 2345",
"bankAccountThirdName": "National Bank",
"bankAccountThirdBic": "BIC",
"bankAccountThirdDescription": "Third account",
"idcardNo": "AAA123456",
"idcardDate": "2018-01-01",
"idcardAuth": "Goverment",
"pesel": "12345678901"
},
"personSell": {
"name": "Seller",
"address": "Address",
"nipKind": 0,
"nip": "1234567890",
"alternativeHeader": 0,
"isVATPayer": 1,
"phone": "012-1234567",
"fax": "012-1234567",
"mail": "address@mail.com",
"www": "http:\/\/address.com",
"krs": "1234567890",
"regon": "1234567890",
"bankAccountFirstNumber": "01 2345 6789 0123 4567 8901 2345",
"bankAccountFirstName": "National Bank",
"bankAccountFirstBic": "BIC",
"bankAccountFirstDescription": "Main account",
"bankAccountSecondNumber": "01 2345 6789 0123 4567 8901 2345",
"bankAccountSecondName": "National Bank",
"bankAccountSecondBic": "BIC",
"bankAccountSecondDescription": "Second account",
"bankAccountThirdNumber": "01 2345 6789 0123 4567 8901 2345",
"bankAccountThirdName": "National Bank",
"bankAccountThirdBic": "BIC",
"bankAccountThirdDescription": "Third account",
"idcardNo": "AAA123456",
"idcardDate": "2018-01-01",
"idcardAuth": "Goverment",
"pesel": "12345678901"
},
"positions": [
{
"name": "Product 1",
"cash": 100
},
{
"name": "Product 2",
"cash": 250
}
],
"personPut": "Issuing",
"personGet": "Receiving",
"annotation": "annotation",
"info": "info",
"footer": "footer",
"footerIconPath1": "file\/footer\/icon1.jpg",
"footerIconPath2": "file\/footer\/icon1.jpg",
"footerIconPath3": "file\/footer\/icon1.jpg",
"documentHeader": "document header",
"documentFooter": "document footer",
"documentInfo": "document info",
"logoPath": "file\/account\/logo.jpg",
"signPath": "file\/account\/sign.jpg",
"client": 1,
"data": 1,
"postscript": 1,
"status": 1,
"exchangeCurrency": 2,
"exchangeRate": 4.1709,
"exchangeMulti": 1,
"exchangeDate": "2017-12-29",
"exchangeNumber": "251\/A\/NBP\/2017"
}
Metoda:
PUT
URL:
https://faktura/api/noteCash
Przykładowe dane:
{
"hash": "abcdefghij",
"dateCreate": "2018-01-01",
"number": "1\/01\/2018",
"place": "Warsaw",
"dateKind": 0,
"dateValue": "2018-01-01",
"documentNumber": "1\/01\/2018",
"documentDate": "2018-01-01",
"language": "pl",
"payKind": 1,
"payTime": 1,
"currency": 1,
"payed": 100,
"personBuy": {
"name": "Buyer",
"address": "Address",
"nipKind": 0,
"nip": "1234567890",
"alternativeHeader": 0,
"isVATPayer": 1,
"phone": "012-1234567",
"fax": "012-1234567",
"mail": "address@mail.com",
"www": "http:\/\/address.com",
"krs": "1234567890",
"regon": "1234567890",
"bankAccountFirstNumber": "01 2345 6789 0123 4567 8901 2345",
"bankAccountFirstName": "National Bank",
"bankAccountFirstBic": "BIC",
"bankAccountFirstDescription": "Main account",
"bankAccountSecondNumber": "01 2345 6789 0123 4567 8901 2345",
"bankAccountSecondName": "National Bank",
"bankAccountSecondBic": "BIC",
"bankAccountSecondDescription": "Second account",
"bankAccountThirdNumber": "01 2345 6789 0123 4567 8901 2345",
"bankAccountThirdName": "National Bank",
"bankAccountThirdBic": "BIC",
"bankAccountThirdDescription": "Third account",
"idcardNo": "AAA123456",
"idcardDate": "2018-01-01",
"idcardAuth": "Goverment",
"pesel": "12345678901"
},
"personSell": {
"name": "Seller",
"address": "Address",
"nipKind": 0,
"nip": "1234567890",
"alternativeHeader": 0,
"isVATPayer": 1,
"phone": "012-1234567",
"fax": "012-1234567",
"mail": "address@mail.com",
"www": "http:\/\/address.com",
"krs": "1234567890",
"regon": "1234567890",
"bankAccountFirstNumber": "01 2345 6789 0123 4567 8901 2345",
"bankAccountFirstName": "National Bank",
"bankAccountFirstBic": "BIC",
"bankAccountFirstDescription": "Main account",
"bankAccountSecondNumber": "01 2345 6789 0123 4567 8901 2345",
"bankAccountSecondName": "National Bank",
"bankAccountSecondBic": "BIC",
"bankAccountSecondDescription": "Second account",
"bankAccountThirdNumber": "01 2345 6789 0123 4567 8901 2345",
"bankAccountThirdName": "National Bank",
"bankAccountThirdBic": "BIC",
"bankAccountThirdDescription": "Third account",
"idcardNo": "AAA123456",
"idcardDate": "2018-01-01",
"idcardAuth": "Goverment",
"pesel": "12345678901"
},
"positions": [
{
"name": "Product 1",
"cash": 100
},
{
"name": "Product 2",
"cash": 250
}
],
"personPut": "Issuing",
"personGet": "Receiving",
"annotation": "annotation",
"info": "info",
"footer": "footer",
"footerIconPath1": "file\/footer\/icon1.jpg",
"footerIconPath2": "file\/footer\/icon1.jpg",
"footerIconPath3": "file\/footer\/icon1.jpg",
"documentHeader": "document header",
"documentFooter": "document footer",
"documentInfo": "document info",
"logoPath": "file\/account\/logo.jpg",
"signPath": "file\/account\/sign.jpg",
"client": 1,
"data": 1,
"postscript": 1,
"status": 1,
"exchangeCurrency": 2,
"exchangeRate": 4.1709,
"exchangeMulti": 1,
"exchangeDate": "2017-12-29",
"exchangeNumber": "251\/A\/NBP\/2017"
}
Metoda:
DELETE
URL:
https://faktura/api/noteCash
Przykładowe dane:
{
"hash": "abcdefghij",
}
Metoda:
GET
URL:
https://faktura/api/noteCash/list
Przykładowe dane:
{
"page": 1,
"count": 25,
"sortItem": 0,
"sortDir": "a",
"letter": "a",
"phrase": "phrase",
"dateBegin": "2018-01-01",
"dateEnd": "2018-12-30",
"year": 2018,
"month": 5,
"product": "product",
"payedKind": 0,
"client": 1,
"payKind": 1,
"currency": 1,
"data": 1,
"user": 1
}
page:
page number
count:
records per page
sortItem:
sort by item
sortDir:
sort order, possible values: a - order ascending, d - order descending
letter:
first letter
phrase:
searching phrase
dateBegin:
begin date of period
dateEnd:
end date of period
year:
year of period (not use with dateBegin and dateEnd)
month:
month of period (use with year)
product:
product searching phrase
payedKind:
payed status, posible: 0 - all, 1 - paid, 2 - not paid, 3 - outdate
client:
client ID
payKind:
pay kind ID
currency:
currency ID
data:
account data ID
user:
user ID
Metoda:
GET
URL:
https://faktura/api/noteCash/pdf
Przykładowe dane:
{
"hash": "abcdefghij",
"kind": 1,
"tpl": "std",
"lang": "pl",
"configPrint": {
"showPrice": 1,
"visibleSign": 1,
"visibleQrcode": 1,
"visiblePayTime": 1,
"visiblePkwiu": 1,
"visibleCashWord": 1,
"visibleDoubleCash": 1,
"visibleDelivery": 1,
"visiblePreventiveSeal": 1,
"visibleCurrency": 1,
"visibleConversion": 1,
"visibleBankAccount": 1,
"visibleVATPayer": 1,
"visiblePaydate": 1,
"visiblePayment": 1
}
}
kind:
print kind: 1 - one copy, 2 - two copies, 3 - duplicate
tpl:
template name, avaliable: std, pro
lang:
language code (ISO639-1)
configPrint:
print configuration
Metoda:
PUT
URL:
https://faktura/api/noteCash/pay
Przykładowe dane:
{
"hash": "abcdefghij",
"cash": 100,
"date": "2018-01-01 12:00:00"
}
date:
ISO8601 format
Metoda:
PUT
URL:
https://faktura/api/noteCash/payzero
Przykładowe dane:
{
"hash": "abcdefghij"
}
Metoda:
PUT
URL:
https://faktura/api/noteCash/sendmail
Przykładowe dane:
{
"hash": "abcdefghij",
"title": "E-mail subject",
"body": "E-mail body",
"mail": "adres@mail.pl",
"kind": 1,
"lang": "pl",
"sendToMe": 1,
"configPrint": {
"showPrice": 1,
"visibleSign": 1,
"visibleQrcode": 1,
"visiblePayTime": 1,
"visiblePkwiu": 1,
"visibleCashWord": 1,
"visibleDoubleCash": 1,
"visibleDelivery": 1,
"visiblePreventiveSeal": 1,
"visibleCurrency": 1,
"visibleConversion": 1,
"visibleBankAccount": 1,
"visibleVATPayer": 1,
"visiblePaydate": 1,
"visiblePayment": 1
}
}
kind:
print kind: 1 - one copy, 2 - two copies, 3 - duplicate
lang:
language code (ISO639-1)
sendToMe:
send message copy to me
configPrint:
print configuration