Konto REST API

Authentication

Authenticate test

Test auth with konto api

GEThttps://konto.is/api/v1/hello

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is TRUE then messge will "Connection succeeded"
if status is FALSE then messge will describe this error
name string
registration_no string
vat_no string
Example
HideShow
curl -k -X GET -F username=testuser -F api_key=3a62cd2568635f115c975b8bd1317e3d https://konto.is/api/v1/hello

Customer

Customer detail

Customer detail example json

Customer Object
HideShow
Parameter Type Example Description
guid string
output_select string 2: Send e-invoice to a particular Trading Partner ID, 3: Do not send e-invoice(XML), 4: Print - Do not send email
address string
zip string
city string
registration_no string
email string
term string
photo base64string
due_date integer
settlement_date integer
trading_partner_id string
phone_number string
vat string
lang string is or en
currency string ISK,EUR,USD,DKK,NOK,SEK,JPY,GBP,AUD,PLN,CAD,CHF,CNY,NZD,MXN,SGD,HKD,KRW,TRY,RUB,INR,VND,BRL,ZAR,UAH,CZK
tax_exempt boolean
updated_timestamp string
is_claim boolean Only available If user has active claim subscription
is_discount boolean Only available If user has active discount subscription

List Customers

Get list customers with konto api

GEThttps://konto.is/api/v1/get-customers

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
search string (optional) search key with name customer
limit integer (optional) item per page default all customer
page integer (optional) page number
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
result object if status is TRUE is show list customer
Example
HideShow
curl -k -X GET -F username=testuser -F api_key=3a62cd2568635f115c975b8bd1317e3d https://konto.is/api/v1/get-customers

Count Customers

Get count customers with konto api

GEThttps://konto.is/api/v1/get-count-customers

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
search string (optional) search key with name customer
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
result integer if status is TRUE is show count customer
Example
HideShow
curl -k -X GET -F username=testuser -F api_key=3a62cd2568635f115c975b8bd1317e3d https://konto.is/api/v1/get-count-customers

Get Customer

Get detail customer with konto api

GEThttps://konto.is/api/v1/get-customer

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
guid string required
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
result json if status is TRUE is detail customer
Example
HideShow
curl -k -X GET -F username=testuser -F api_key=3a62cd2568635f115c975b8bd1317e3d -F guid=5a140a1c-13c6-11e7-9914-408d5c6208bc https://konto.is/api/v1/get-customer

Create Customer

Create a customer with konto api

POSThttps://konto.is/api/v1/create-customer

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
data json

							    {
							    "output_select" :  "3"
								"registration_no" :  "11111111"
								"name"  :  "Test"
								"address" :  "Abc"
								"zip"  :  "104"	
								"city"  :  "Abc"	
								"email"  :  "xxxx@gmail.com"	
								"lang"  :  "is"	
								"currency"  :  "ISK"	
								}
							
(required) json of detail customer
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
result integer if status is TRUE is GUID of customer
Example
HideShow
curl -k -X POST -F username="testuser" -F api_key="3a62cd2568635f115c975b8bd1317e3d" -F data="{\"output_select\":3,\"registration_no\":\"1111111111\",\"name\":\"Test\",\"address\":\"Abc\",\"zip\":\"104\",\"city\":\"Abc\",\"email\":\"xxxx@gmail.com\",\"lang\":\"is\",\"currency\":\"ISK\"}" https://konto.is/api/v1/create-customer

Update Customer

Update a customer with konto api

POSThttps://konto.is/api/v1/update-customer

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
guid string required
data json

							    {
							    "output_select" :  "3"
								"registration_no" :  "11111111"
								"name"  :  "Test"
								"address" :  "Abc"
								"zip"  :  "104"	
								"city"  :  "Abc"	
								"email"  :  "xxxx@gmail.com"	
								"lang"  :  "is"	
								"currency"  :  "ISK"	
								}
							
(required) json of detail customer
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
result integer if status is TRUE is GUID of customer
Example
HideShow
curl -k -X POST -F username="testuser" -F api_key="3a62cd2568635f115c975b8bd1317e3d" -F guid="614669f6-3560-11e7-8d19-408d5c6208bc" -F data="{\"output_select\":3,\"registration_no\":\"1111111111\",\"name\":\"Test\",\"address\":\"Abc\",\"zip\":\"104\",\"city\":\"Abc\",\"email\":\"xxxx@gmail.com\",\"lang\":\"is\",\"currency\":\"ISK\"}" https://konto.is/api/v1/update-customer

Item

Item detail

Item detail example json

Item Object
HideShow
Parameter Type Example Description
guid string
item_number string Auto generate by konto
description string
uom string Unit of measure (C62,KGS,MTR,LTR,MTK,MTQ,TNE,KWH,DAY,HUR,MIN,KTM)
tax string S,AA,Z
unit_price float
category string
active boolean
updated_timestamp string

List Items

Get list items with konto api

GEThttps://konto.is/api/v1/get-items

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
limit integer (optional) item per page default all customer
page integer (optional) page number
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
result object if status is TRUE is show list item
Example
HideShow
curl -k -X GET -F username=testuser -F api_key=3a62cd2568635f115c975b8bd1317e3d https://konto.is/api/v1/get-items

Count Items

Get count items with konto api

GEThttps://konto.is/api/v1/get-count-items

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
result integer if status is TRUE is show count item
Example
HideShow
curl -k -X GET -F username=testuser -F api_key=3a62cd2568635f115c975b8bd1317e3d https://konto.is/api/v1/get-count-items

Get Item

Get detail item with konto api

GEThttps://konto.is/api/v1/get-item

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
guid string required
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
result json if status is TRUE is detail item
Example
HideShow
curl -k -X GET -F username=testuser -F api_key=3a62cd2568635f115c975b8bd1317e3d -F guid=f120bb56-f080-11e6-a96f-0050560102f2 https://konto.is/api/v1/get-item

Create Item

Create a item with konto api

POSThttps://konto.is/api/v1/create-item

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
data json

							    {
								"description" :  "Test"
								"uom"  :  "KGS"
								"tax" :  "AA"
								"unit_price"  :  "200"	
								"category"  :  ""
								"active"  :  "1"
								}
							
(required) json of detail item
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
result integer if status is TRUE is GUID of item
Example
HideShow
curl -k -X POST -F username=testuser -F api_key=3a62cd2568635f115c975b8bd1317e3d -F data="{\"description\":\"Test\",\"uom\":\"KGS\",\"tax\":\"AA\",\"unit_price\":\"200\",\"category\":\"\",\"active\":\"1\"}" https://konto.is/api/v1/create-item

Update Item

Update a item with konto api

POSThttps://konto.is/api/v1/update-item

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
guid string required
data json

							    {
								"description" :  "Test"
								"uom"  :  "KGS"
								"tax" :  "AA"
								"unit_price"  :  "200"	
								"category"  :  ""
								"active"  :  "1"
								}
							
(required) json of detail item
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
result integer if status is TRUE is GUID of item
Example
HideShow
curl -k -X POST -F username=testuser -F api_key=3a62cd2568635f115c975b8bd1317e3d -F guid=053a639f-3565-11e7-8d19-408d5c6208bc -F data="{\"description\":\"Test\",\"uom\":\"KGS\",\"tax\":\"AA\",\"unit_price\":\"200\",\"category\":\"\",\"active\":\"1\"}" https://konto.is/api/v1/update-item

Invoice

Invoice detail

Invoice detail example json

Invoice Object
HideShow
Parameter Type Example Description
guid string
number string
amount float
currency string ISK,EUR,USD,DKK,NOK,SEK,JPY,GBP,AUD,PLN,CAD,CHF,CNY,NZD,MXN,SGD,HKD,KRW,TRY,RUB,INR,VND,BRL,ZAR,UAH,CZK,
status string Saved, Sent, Cancelled, Paid
issue_date datetime Format (Y-m-d)
due_date datetime Format (Y-m-d)
settlement_date datetime Format (Y-m-d)
description string
booking string
cost_provide string
delivery_date datetime Format (Y-m-d)
terms string
type string invoice,credit
refer_guid string
accounting_status string Created,Posted,Skipped,Error
accounting_message string
updated_timestamp string
items string list invoice item
customer string invoice customer

Invoice item detail

Invoice item detail example json

Invoice item Object
HideShow
Parameter Type Example Description
guid string
item_number string
description string
qty integer
uom string Unit of measure (C62,KGS,MTR,LTR,MTK,MTQ,TNE,KWH,DAY,HUR,MIN,KTM)
tax string S,AA,Z
unit_price float
discount float
discount_type boolean 1: %, 0: price

Invoice customer detail

Invoice customer detail example json

Invoice customer Object
HideShow
Parameter Type Example Description
guid string
name string
address string
zip string
city string
registration_no string
email string

Invoice item detail for create

Invoice item detail for create example json

Invoice item Object
HideShow
Parameter Type Example Description
guid string
item_number string required
description string required
qty integer required
uom string required Unit of measure (C62,KGS,MTR,LTR,MTK,MTQ,TNE,KWH,DAY,HUR,MIN,KTM)
unit_price float required
tax string required S,AA,Z
discount float
discount_type boolean 1: %, 0: price

Invoice customer detail for create

Invoice customer detail for create example json

Invoice customer Object
HideShow
Parameter Type Example Description
output_select string 2: Send e-invoice to a particular Trading Partner ID, 3: Do not send e-invoice(XML), 4: Print - Do not send email
guid string
name string
address string
zip string
city string
registration_no string
email string
term string
photo base64string
due_date integer
settlement_date integer
trading_partner_id string
lang string is or en
currency string ISK,EUR,USD,DKK,NOK,SEK,JPY,GBP,AUD,PLN,CAD,CHF,CNY,NZD,MXN,SGD,HKD,KRW,TRY,RUB,INR,VND,BRL,ZAR,UAH,CZK
tax_exempt boolean
updated_timestamp string
phone_number string
vat string
is_claim boolean Only available If user has active claim subscription
is_discount boolean Only available If user has active discount subscription

Invoice detail for create

Invoice detail for create example json

Invoice Object
HideShow
Parameter Type Example Description
amount float required
currency string required ISK,EUR,USD,DKK,NOK,SEK,JPY,GBP,AUD,PLN,CAD,CHF,CNY,NZD,MXN,SGD,HKD,KRW,TRY,RUB,INR,VND,BRL,ZAR,UAH,CZK
issue_date datetime required Format (Y-m-d)
due_date datetime required Format (Y-m-d)
settlement_date datetime required Format (Y-m-d)
description string
booking string
cost_provide string
delivery_date datetime Format (Y-m-d)
terms string
type string required invoice,credit
items string required list invoice item
customer string required invoice customer
trading_partner_id string
is_claim boolean
is_discount boolean
discount_type boolean 1: %, 0: price
discount_value float
payment_fee float
mark_paid boolean
files string 1111,1222 Id get from api upload
save boolean Use for save invoice

List Invoices

Get list invoices with konto api

GEThttps://konto.is/api/v1/get-invoices

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
accounting_status string (optional) list accounting status. Example: "Created,Error" or "Skipped" or "Created,Posted,Skipped"
limit integer (optional) item per page default all invoice
page integer (optional) page number
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
result object if status is TRUE is show list invoice
Example
HideShow
curl -k -X GET -F username=testuser -F api_key=3a62cd2568635f115c975b8bd1317e3d https://konto.is/api/v1/get-invoices

Count Invoices

Get count invoices with konto api

GEThttps://konto.is/api/v1/get-count-invoices

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
accounting_status string (optional) list accounting status. Example: "Created,Error" or "Skipped" or "Created,Posted,Skipped"
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
result integer if status is TRUE is show count invoices
Example
HideShow
curl -k -X GET -F username=testuser -F api_key=3a62cd2568635f115c975b8bd1317e3d https://konto.is/api/v1/get-count-invoices

Get Invoice

Get detail invoice with konto api

GEThttps://konto.is/api/v1/get-invoice

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
guid string required
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
result json if status is TRUE is detail invoice
Example
HideShow
curl -k -X GET -F username=testuser -F api_key=3a62cd2568635f115c975b8bd1317e3d -F guid=f110ef1e-f080-11e6-a96f-0050560102f2 https://konto.is/api/v1/get-invoice

Update Invoice

Update a invoice with konto api

POSThttps://konto.is/api/v1/update-invoice

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
guid string required
data json

							    {
								"accounting_status" :  "Skipped"
								"accounting_message"  :  "Test"
								}
							
(required)
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
result integer if status is TRUE is GUID of invoice
Example
HideShow
curl -k -X POST -F username=testuser -F api_key=3a62cd2568635f115c975b8bd1317e3d -F guid=f110ef1e-f080-11e6-a96f-0050560102f2 -F data="{\"accounting_status\":\"Skipped\",\"accounting_message\":\"Test\"}" https://konto.is/api/v1/update-invoice

Create Invoice

Create invoice with konto api

POSThttps://konto.is/api/v1/create-invoice

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
data string

							    {
								"amount" :  2
								"currency"  :  "USD"
								"customer"  :  {
										"guid" :  "5a14796e-13c6-11e7-9914-408d5c6208bc"										
								}
								"settlement_date"  :  "2017-5-20"	
								"due_date"  :  "2017-5-20"
								"issue_date"  :  "2017-5-20"
								"type"  :  "invoice"
								"description"  :  "Test"
								"booking"  :  "Test"
								"cost_provide"  :  "Test"
								"terms"  :  "Test"
								"delivery_date"  :  ""
								"is_claim"  :  1
								"is_discount"  :  0
								"discount_type"  :  0
								"discount_value"  :  0
								"payment_fee"  :  0
								"mark_paid"  :  0
								"save"  :  0
								"items"  :  [{
										"item_number": "1",
										"description": "111"
										"qty": 1
										"uom": "C62"
										"tax": "Z"
										"unit_price": 1
										"discount": 0
										"discount_type": 0
										"add_new": 1
								},
								{
										"guid": 43521ec8-3413-11e7-b148-408d5c6208bc
										"qty": 1
										"discount": 0
										"discount_type": 0
								}]
								
								
(required) json of detail invoice
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
result integer if status is TRUE is GUID of invoice
Example
HideShow
curl -k -X POST -F username=testuser -F api_key=3a62cd2568635f115c975b8bd1317e3d -F data="{\"amount\":2,\"currency\":\"USD\",\"customer\":{\"guid\":\"5a14796e-13c6-11e7-9914-408d5c6208bc\"},\"settlement_date\":\"2017-5-20\",\"due_date\":\"2017-5-20\",\"issue_date\":\"2017-5-20\",\"type\":\"invoice\",\"description\":\"Test\",\"booking\":\"Test\",\"cost_provide\":\"Test\",\"terms\":\"Test\",\"delivery_date\":\"\",\"is_claim\":1,\"mark_paid\":0,\"is_discount\":0,\"discount_type\":0,\"discount_value\":0,\"items\":[{\"item_number\":\"1\",\"description\":\"111\",\"qty\":1,\"uom\":\"C62\",\"tax\":\"Z\",\"unit_price\":1,\"discount\":0,\"save\":0,\"discount_type\":0,\"add_new\":1},{\"guid\":\"43521ec8-3413-11e7-b148-408d5c6208bc\",\"qty\":1,\"discount\":0,\"discount_type\":0}]}" https://konto.is/api/v1/create-invoice

Create Recurring Invoice

Create recurring invoice with konto api

POSThttps://konto.is/api/v1/create-recurring-invoice

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
data string

							    {
							    "recurring_name" :  Recurring test
							    "recurring_max_invoice" :  3
							    "recurring_interval" :  quarterly // 'weekly','monthly','quarterly','annuall'
							    "recurring_start_date" :  2018-10-10
							    "recurring_link_national" :  0
								"amount" :  2
								"currency"  :  "USD"
								"customer"  :  {
									"guid" :  "5a14796e-13c6-11e7-9914-408d5c6208bc"										
								}
								"settlement_date"  :  "2018-10-10"	
								"due_date"  :  "2018-10-10"
								"issue_date"  :  "2018-09-30"
								"description"  :  "Test"
								"booking"  :  "Test"
								"cost_provide"  :  "Test"
								"terms"  :  "Test"
								"delivery_date"  :  ""
								"is_claim"  :  1
								"is_discount"  :  0
								"discount_type"  :  0
								"discount_value"  :  0
								"items"  :  [{
										"item_number": "1",
										"description": "111"
										"qty": 1
										"uom": "C62"
										"tax": "Z"
										"unit_price": 1
										"discount": 0
										"discount_type": 0
										"add_new": 1
								},
								{
										"guid": 43521ec8-3413-11e7-b148-408d5c6208bc
										"qty": 1
										"discount": 0
										"discount_type": 0
								}]
								}
																
								
(required) json of detail invoice
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
result integer if status is TRUE is GUID of invoice
Example
HideShow
curl -k -X POST -F username=testuser -F api_key=3a62cd2568635f115c975b8bd1317e3d -F data="{\"recurring_name\" : \"Recurring test\",\"recurring_max_invoice\" : 3,\"recurring_interval\" : \"quarterly\",\"recurring_start_date\" : \"2018-10-10\",\"recurring_link_national\" : 0,\"amount\" : 2,\"currency\" : \"USD\",\"customer\" : {\"guid\" : \"5a14796e-13c6-11e7-9914-408d5c6208bc\"},\"settlement_date\" : \"2018-10-10\",\"due_date\" : \"2018-10-10\",\"issue_date\" : \"2018-09-30\",\"description\" : \"Test\",\"booking\" : \"Test\",\"cost_provide\" : \"Test\",\"terms\" : \"Test\",\"delivery_date\" : \"\",\"is_claim\" : 1,\"is_discount\" : 0,\"discount_type\" : 0,\"discount_value\" : 0,\"mark_paid\" : 0,\"items\" : [{\"item_number\": \"1\",\"description\": \"111\",\"qty\": 1,\"uom\": \"C62\",\"tax\": \"Z\",\"unit_price\": 1,\"discount\": 0,\"discount_type\": 0,\"add_new\": 1},{\"guid\": \"43521ec8-3413-11e7-b148-408d5c6208bc\",\"qty\": 1,\"discount\": 0,\"discount_type\": 0}]}" https://konto.is/api/v1/create-recurring-invoice

Attachment Invoice

add attachment to invoice with konto api

POSThttps://konto.is/api/v1/upload-file?username={username}&api_key={api_key}

Fields
HideShow
Parameter Type Example Description
file file required
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
result integer if status is TRUE is file id of invoice
Example
HideShow
curl -X POST "https://konto.is/api/v1/create-recurring-invoice?username=testuser&api_key=3a62cd2568635f115c975b8bd1317e3d" -H "content-type: multipart/form-data" -F "file=@10121.pdf"

Cost

Cost detail

Cost detail example json

Cost Object
HideShow
Parameter Type Example Description
guid string
description string
vat_no string
amount float
vat_AA float
vat_S float
cost_code string Items,Service,Travel,Sales,Finance,RawMaterial,Other,3028,2173,3033,3085,3090,2093,2243,2193,2423,2443,2353,2383,2403,2263,3163,2333,3140,2283,2533,2633,3653,5028,2153,3080
how_paid integer
1: Í reikning
2: Debitkort/Bankareikningur
3: Kreditkort
4: Eigandi/Starfsmaður greiddi
file base64string
posting_date datetime Format (Y-m-d)
xml base64string
accounting_status string Created,Posted,Skipped,Error
updated_timestamp datetime Format (Y-m-d)

List Costs

Get list costs with konto api

GEThttps://konto.is/api/v1/get-costs

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
accounting_status string (optional) list accounting status. Example: "Created,Error" or "Skipped" or "Created,Posted,Skipped"
limit integer (optional) item per page default 10 cost
page integer (optional) page number
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
result object if status is TRUE is show list cost
hasMore boolean if true it has more items
limit integer item per page
page integer page number
next_url string url next items
Example
HideShow
curl -k -X GET -F username=testuser -F api_key=3a62cd2568635f115c975b8bd1317e3d https://konto.is/api/v1/get-costs

Count Costs

Get count costs with konto api

GEThttps://konto.is/api/v1/get-count-costs

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
accounting_status string (optional) list accounting status. Example: "Created,Error" or "Skipped" or "Created,Posted,Skipped"
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
result integer if status is TRUE is show count costs
Example
HideShow
curl -k -X GET -F username=testuser -F api_key=3a62cd2568635f115c975b8bd1317e3d https://konto.is/api/v1/get-count-costs

Get Cost

Get detail cost with konto api

GEThttps://konto.is/api/v1/get-cost

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
guid string required
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
result json if status is TRUE is detail cost
Example
HideShow
curl -k -X GET -F username=testuser -F api_key=3a62cd2568635f115c975b8bd1317e3d -F guid=f110ef1e-f080-11e6-a96f-0050560102f2 https://konto.is/api/v1/get-cost

Cost Invoice

Update a cost with konto api

POSThttps://konto.is/api/v1/update-cost

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
guid string required
data json

							    {
								"accounting_status" :  "Skipped"
								}
							
(required)
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
result integer if status is TRUE is GUID of cost
Example
HideShow
curl -k -X POST -F username=testuser -F api_key=3a62cd2568635f115c975b8bd1317e3d -F guid=f110ef1e-f080-11e6-a96f-0050560102f2 -F data="{\"accounting_status\":\"Skipped\",\"accounting_message\":\"Test\"}" https://konto.is/api/v1/update-cost

Bookkeeper

Bookkeeper detail

Bookkeeper detail example json

Bookkeeper Object
HideShow
Parameter Type Example Description
guid string
name string
username string
registration_no string
vat_no string
email string
service_provider_guid string
status String Registered,Active,Inactive
count_of_bookkeepers integer
instance_config json

Tenant detail

Tenant detail example json

Tenant Object
HideShow
Parameter Type Example Description
guid string
name string
username string
api_key string
registration_no string
vat_no string
email string
address string
zip string
city string
phone_number string
bank_account string
bank_provider string
claim_identifier string
bank_username string
bank_password string
claim_branch string
bookkeeper_guid string
active_plan string
count_of_payusers integer
active_item string

Get Bookkeeper

Get detail bookkeeper with konto api

GEThttps://konto.is/api/v1/get-bookkeeper

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
guid string required
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
result json if status is TRUE is detail bookkeeper
Example
HideShow
curl -k -X GET -F username=testuser -F api_key=3a62cd2568635f115c975b8bd1317e3d -F guid=f110ef1e-f080-11e6-a96f-0050560102f2 https://konto.is/api/v1/get-bookkeeper

Get Tenant

Get detail tenant with konto api

GEThttps://konto.is/api/v1/get-tenant

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
guid string required
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
result json if status is TRUE is detail tenant
Example
HideShow
curl -k -X GET -F username=testuser -F api_key=3a62cd2568635f115c975b8bd1317e3d -F guid=f110ef1e-f080-11e6-a96f-0050560102f2 https://konto.is/api/v1/get-tenant

Bookkeeper

Update a bookkeeper with konto api

POSThttps://konto.is/api/v1/update-bookkeeper

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
guid string required
status string Registered,Active,Inactive
count_of_bookkeepers integer
instance_config json
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
result integer if status is TRUE is GUID of bookkeeper
Example
HideShow
curl -k -X POST -F username=testuser -F api_key=3a62cd2568635f115c975b8bd1317e3d -F guid=f110ef1e-f080-11e6-a96f-0050560102f2 -F status=Active https://konto.is/api/v1/update-bookkeeper

Bill-to-Invoices

Invoice detail for create save

Invoice detail for create save example json

Invoice save Object
HideShow
Parameter Type Example Description
amount float required
currency string required ISK,EUR,USD,DKK,NOK,SEK,JPY,GBP,AUD,PLN,CAD,CHF,CNY,NZD,MXN,SGD,HKD,KRW,TRY,RUB,INR,VND,BRL,ZAR,UAH,CZK
issue_date datetime required Format (Y-m-d)
due_date datetime required Format (Y-m-d)
settlement_date datetime required Format (Y-m-d)
description string
booking string
cost_provide string
delivery_date datetime Format (Y-m-d)
terms string
type string required invoice,credit
items string required list invoice item
trading_partner_id string
is_claim boolean
is_discount boolean
discount_type boolean 1: %, 0: price
discount_value float
mark_paid boolean
create_type string required user,email
kennitala string required if create_type is user
email string required if create_type is email

Create Save Invoice

Create save invoice with konto api

POSThttps://konto.is/api/v1/create-save-invoice

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
data string

						{
						"amount" :  2
						"currency"  :  "USD"
						"settlement_date"  :  "2017-5-20"	
						"due_date"  :  "2017-5-20"
						"issue_date"  :  "2017-5-20"
						"type"  :  "invoice"
						"description"  :  "Test"
						"booking"  :  "Test"
						"cost_provide"  :  "Test"
						"terms"  :  "Test"
						"delivery_date"  :  ""
						"is_claim"  :  1
						"is_discount"  :  0
						"discount_type"  :  0
						"discount_value"  :  0
						"mark_paid"  :  0
						"create_type"  :  user
						"kennitala"  :  4444444444
						"items"  :  [{
								"item_number": "1",
								"description": "111"
								"qty": 1
								"uom": "C62"
								"tax": "Z"
								"unit_price": 1
								"discount": 0
								"discount_type": 0
								"add_new": 1
						},
						{
								"guid": 43521ec8-3413-11e7-b148-408d5c6208bc
								"qty": 1
								"discount": 0
								"discount_type": 0
						}]
						
						
(required) json of detail invoice
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
result integer This is GUID of invoice if create_type is "user" and status is "TRUE"
Example
HideShow
curl -k -X POST -F username=testuser -F api_key=3a62cd2568635f115c975b8bd1317e3d -F data="{\"amount\":\"2095.6\",\"currency\":\"ISK\",\"create_type\":\"user\",\"kennitala\":\"4444444444\",\"settlement_date\":\"2021-06-09\",\"due_date\":\"2021-06-09\",\"issue_date\":\"2021-06-07\",\"type\":\"invoice\",\"items\":[{\"guid\":\"6be71e6c-d7dd-11e7-b836-005056c00001\",\"qty\":1}]}" https://konto.is/api/v1/create-save-invoice

Order Invoices

Order invoice detail

Order invoice example json

Invoice Object
HideShow
Parameter Type Example Description
guid string
number string
amount float
issue_date datetime Format (Y-m-d)

Invoice detail for create save

Invoice detail for create save example json

Invoice save Object
HideShow
Parameter Type Example Description
amount float required
currency string required ISK,EUR,USD,DKK,NOK,SEK,JPY,GBP,AUD,PLN,CAD,CHF,CNY,NZD,MXN,SGD,HKD,KRW,TRY,RUB,INR,VND,BRL,ZAR,UAH,CZK
settlement_date number required
description string
booking string required
cost_provide string
delivery_date datetime Format (Y-m-d)
terms string
items string required list invoice item
trading_partner_id string
is_claim boolean
is_discount boolean
discount_type boolean 1: %, 0: price
discount_value float
mark_paid boolean
kennitala string required

Invoice detail for update order

Invoice detail for update order example json

Invoice update Object
HideShow
Parameter Type Example Description
amount float
currency string ISK,EUR,USD,DKK,NOK,SEK,JPY,GBP,AUD,PLN,CAD,CHF,CNY,NZD,MXN,SGD,HKD,KRW,TRY,RUB,INR,VND,BRL,ZAR,UAH,CZK
settlement_date number
description string
booking string
cost_provide string
delivery_date datetime Format (Y-m-d)
terms string
items string list invoice item
trading_partner_id string
is_claim boolean
is_discount boolean
discount_type boolean 1: %, 0: price
discount_value float
mark_paid boolean
kennitala string

Create Order Invoice

Create order invoice with konto api

POSThttps://konto.is/api/v1/create-order-invoice

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
data string

						{
						"amount" :  2
						"currency"  :  "USD"
						"settlement_date"  :  10
						"description"  :  "Test"
						"booking"  :  "Test"
						"cost_provide"  :  "Test"
						"terms"  :  "Test"
						"delivery_date"  :  ""
						"is_claim"  :  1
						"is_discount"  :  0
						"discount_type"  :  0
						"discount_value"  :  0
						"mark_paid"  :  0
						"kennitala"  :  4444444444
						"items"  :  [{
								"item_number": "1",
								"description": "111"
								"qty": 1
								"uom": "C62"
								"tax": "Z"
								"unit_price": 1
								"discount": 0
								"discount_type": 0
								"add_new": 1
						},
						{
								"guid": 43521ec8-3413-11e7-b148-408d5c6208bc
								"qty": 1
								"discount": 0
								"discount_type": 0
						}]
						
						
(required) json of detail invoice
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
result integer if status is TRUE is GUID of invoice
Example
HideShow
curl -k -X POST -F username=testuser -F api_key=3a62cd2568635f115c975b8bd1317e3d -F data="{\"amount\":\"2095.6\",\"currency\":\"ISK\",\"kennitala\":\"4444444444\",\"booking\":\"test\",\"settlement_date\":\"10\",\"items\":[{\"guid\":\"6be71e6c-d7dd-11e7-b836-005056c00001\",\"qty\":1}]}" https://konto.is/api/v1/create-order-invoice

Update Order Invoice

Update order invoice with konto api

POSThttps://konto.is/api/v1/update-order-invoice

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
guid string required
data string

						{
						"amount" :  2
						"currency"  :  "USD"
						"settlement_date"  :  "10"
						"description"  :  "Test"
						"booking"  :  "Test"
						"cost_provide"  :  "Test"
						"terms"  :  "Test"
						"delivery_date"  :  ""
						"is_claim"  :  1
						"is_discount"  :  0
						"discount_type"  :  0
						"discount_value"  :  0
						"mark_paid"  :  0
						"kennitala"  :  4444444444
						"items"  :  [{
								"item_number": "1",
								"description": "111"
								"qty": 1
								"uom": "C62"
								"tax": "Z"
								"unit_price": 1
								"discount": 0
								"discount_type": 0
								"add_new": 1
						},
						{
								"guid": 43521ec8-3413-11e7-b148-408d5c6208bc
								"qty": 1
								"discount": 0
								"discount_type": 0
						}]
						
						
(required) json of detail invoice
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
result integer if status is TRUE is GUID of invoice
Example
HideShow
curl -k -X POST -F username=testuser -F api_key=3a62cd2568635f115c975b8bd1317e3d -F guid=f110ef1e-f080-11e6-a96f-0050560102f2 -F data="{\"amount\":\"2095.6\",\"currency\":\"ISK\",\"kennitala\":\"4444444444\",\"settlement_date\":\"10\",\"items\":[{\"guid\":\"6be71e6c-d7dd-11e7-b836-005056c00001\",\"qty\":1}]}" https://konto.is/api/v1/update-order-invoice

Delete Order Invoice

Delete order invoice with konto api

POSThttps://konto.is/api/v1/delete-order-invoice

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
guid string required
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
Example
HideShow
curl -k -X POST -F username=testuser -F api_key=3a62cd2568635f115c975b8bd1317e3d -F guid=f110ef1e-f080-11e6-a96f-0050560102f2 https://konto.is/api/v1/delete-order-invoice

Get Invoice From Order

Get list invoice from order with konto api

POSThttps://konto.is/api/v1/get-invoices-from-order

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
guid string required
limit integer (optional) item per page default all invoice
page integer (optional) page number
Response  200
HideShow
Parameter Type Example Description
status boolean Return TRUE when success
message string if status is FALSE then messge will describe this error
result object if status is TRUE is show list invoice
Example
HideShow
curl -k -X POST -F username=testuser -F api_key=3a62cd2568635f115c975b8bd1317e3d -F guid=f110ef1e-f080-11e6-a96f-0050560102f2 https://konto.is/api/v1/get-invoices-from-order

Dashboard Data

Invoice detail

Invoice detail example json

Invoice Object
HideShow
Parameter Type Example Description
invoice_creator_username string The unique username from Konto system
invoice_issue_date date Format (Y-m-d)
invoice_number string The unique invoice number
invoice_status string Invoice can be either Paid or Not Paid
customer_number string Value from the customer profile (other information) - does not have to be unique - used to group users
customer_name string Customer name - from customer profile
customer_guid string Unique ID for this customer profile
invoice_description string The description value from this invoice
document_type string "Invoice" or "Credit Note"
invoice_booking_information string The booking information value from this invoice
invoice_order_reference string The order reference value from this invoice
invoice_cost_location string The Cost location value selected for this invoice
invoice_total_excluding_vat string Invoice total amount, excluding VAT
invoice_vat_total string Total amount of VAT for this invoice
invoice_total_discount string Total amount discounted from this invoice
invoice_total_including_vat string Invoice total amount, including VAT
items string list invoice item

Invoice item detail

Invoice item detail example json

Invoice item Object
HideShow
Parameter Type Example Description
number string The given Product number
name string The given Product Name
description string Product Description
qty integer Quantity
uom string Unit of measure (C62,KGS,MTR,LTR,MTK,MTQ,TNE,KWH,DAY,HUR,MIN,KTM)
vat_code string S,AA,Z
category_code string Registered value on Product in item-list
guid string Unique ID for this product
product_cost string Product cost value used to calculate the margin and profit
total_excluding_vat float Item line total, excluding the VAT
total_vat float Total VAT on the item-line
total_including_vat float Item line total, including VAT
total_discount float Total amount discounted for this item line (including VAT)
profit number Total amount (excluding VAT) minus the Product cost
margin number Ratio of Product cost and Sales amount

Get data

Get list invoice for dashboard data konto api

POSThttps://konto.is/api/v1/get-dashboard-data

Fields
HideShow
Parameter Type Example Description
username string required
api_key string required
start_date date (optional) Format (Y-m-d)
end_date date (optional) Format (Y-m-d)
limit integer (optional) item per page default all invoice
page integer (optional) page number
Response  200
HideShow
list invoice
Example
HideShow
curl -k -X POST -F username=testuser -F api_key=3a62cd2568635f115c975b8bd1317e3d -F guid=f110ef1e-f080-11e6-a96f-0050560102f2 https://konto.is/api/v1/get-dashboard-data