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
mark_paid boolean

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
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
								"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
								}]
								
								
(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,\"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

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,Other
file base64string
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 all 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
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
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