Goto APIs

Account API

General:

Basics:

Base-URL: https://capi.lagerkoll.com/v1/account/
Parameters in the url should all be encoded and all data sent should be UTF-8

MAX number of requests per minute is set to 200.
When the limit is hit an error with code 429 is returned, with the header "Retry-After" containing the number of seconds you have to wait for your next request.

Headers:

There are 2 ways to be authenticated when using this API. in both ways you add headers to the request.
1) Use an API-key together with store-id. This would be used when communicating machine to machine and no real person is involved. The API-key is available from where you activated the API. The store-id is also available in the same place.
2) Use a user_id and user_token together with a store-id. You get these values from the login-request. The values are connected to a person and are gained when an actual login to the system has been made.
store: <<STORE>>
user_id: <<USER_ID>>
user_token: <<USER_TOKEN>>
api_key: <<API_KEY>>
Accept: application/json
Content-Type: application/json

Errors:

Code Description
900001 Credentials don't match
900101 Common error
900429 Too many requests
901011 Error when getting license-url
901012 Error when creating account
901112 Error when creating integration
901212 Error when creating status message
901222 Error when logging in
901232 Error when verifying account
901242 Error when updating account
901251 Error when getting invoice
901261 Error when getting api settings
901262 Error when updating api settings
901272 Error when updating email settings
901273 Error when verifying email settings
901282 Error when sending support
{
  "errorCode" : 900101,
  "errorMessage" : "Something went wrong on the server",
  "errorField" : null,
  "errorData" : null
}

Account API:

Company Account

Get next invoice

GETUrl: /invoices/next
Headers:
Accept: application/json or application/xml
Get next invoice for account
Body:
Successfull response:

{ "invoiceExpireDate": 1713419392356, "invoiceDays": 8600, "invoicePaidDate": 1713419392356, "invoiceId": 1588, "state": "state", "invoiceDate": 1713419392356, "paymentDate": 1713419392356, "rows": [{ "articleName": "articleName", "discountPercent": 7078.951750219965, "articleVat": 1970.469564746612, "articleId": "articleId", "articlePrice": 2410.307366319254 }], "serverId": 348, "invoicePeriodInMonths": 4383 }

Get email settings

GETUrl: /email/settings
Headers:
Accept: application/json or application/xml
Other headers: user_id, user_token
Get email settings
Body:
Successfull response:

{ "password": "password", "auth": "false", "verified": false, "outgoingAddress": "outgoingAddress", "tls": "false", "ssl": "false", "email": "email", "outgoingPort": 2802, "username": "username" }

Get invoices

GETUrl: /invoices
Headers:
Accept: application/json or application/xml
Get list of invoices for account
Body:
Successfull response:

{"invoices": [{ "invoiceExpireDate": 1713419392358, "invoiceDays": 3473, "invoicePaidDate": 1713419392358, "invoiceId": 4370, "state": "state", "invoiceDate": 1713419392358, "paymentDate": 1713419392358, "rows": [{ "articleName": "articleName", "discountPercent": 9623.252492290969, "articleVat": 5396.067682135599, "articleId": "articleId", "articlePrice": 5220.351990080682 }], "serverId": 4888, "invoicePeriodInMonths": 1802 }]}

Get license

GETUrl: /license
Headers:
Accept: application/json or application/xml
Other headers: Open request, no identification-headers needed
Get link to license. This must be displayed to user before he/she is allowed to register

Valid parameters:

Parameter Description Default value Allowed values
promotion_code

Body:
Successfull response:

{ "models": [{ "maxUsers": 3718, "maxArticles": 5072, "reseller": false, "vismaAccess": 1098, "maxCustomers": 8987, "fortnoxAccess": 9979, "paymentType": 7357, "discountPercentage": 4590.914492482009, "premium": true, "batchAccess": 979, "price": 7034.230883766949, "name": "name", "maxStocks": 3182, "id": 2222, "peAccess": 3845 }], "eula": "eula" }

Get invoice by id

GETUrl: /invoices/{invoice_id}
Headers:
Accept: application/json or application/xml
Get single invoice by id for account
Body:
Successfull response:

{ "invoiceExpireDate": 1713419392359, "invoiceDays": 6425, "invoicePaidDate": 1713419392359, "invoiceId": 8361, "state": "state", "invoiceDate": 1713419392359, "paymentDate": 1713419392359, "rows": [{ "articleName": "articleName", "discountPercent": 6553.075133663953, "articleVat": 8327.703048188772, "articleId": "articleId", "articlePrice": 8625.579147390217 }], "serverId": 7227, "invoicePeriodInMonths": 7863 }

Get invoice file

GETUrl: /invoices/{invoice_id}/print
Headers:
Accept: application/pdf or application/json
Get invoice binary file by id for account

Valid parameters:

Parameter Description Default value Allowed values
credit
store

Body:
Successfull response:

Get company account

GETUrl:
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Get information about the company account and master stock. This is not to be confused with a user account.
Body:
Successfull response:

{ "invoiceZip": "invoiceZip", "country": "country", "visma": false, "fieldsSettings": {"fields": {}}, "city": "city", "rules": { "canCreateCostCenters": false, "canCreateSupplierDeliveryTerm": true, "maxUsers": 9475, "defaultCategory": { "name": "name", "id": 1720, "articles": 2064 }, "articleNameMaxLength": 5328, "showVATAccount": false, "canCreateCustomerOrderInvoice": false, "canChangeCustomerOnOrderStateStart": 7486, "canCancelCustomerOrder": false, "allowZeroSumCustomerOrders": false, "customerOrderReservedStateEnd": 627, "canCreateCustomerDeliveryTerm": true, "canCreateVAT": true, "customerOrderReservedStateStart": 3879, "defaultUnitType": { "name": "name", "externalId": "externalId", "id": 5176 }, "defaultVAT": { "isDefault": false, "code": "code", "vat": 9864.15536168626, "description": "description", "id": 1025, "account": 1966 }, "supportsCustomerOrderFees": true, "doesVATControllArticleType": true, "canCreatePaymentTerm": true, "canSetCostCentersOnCustomerOrder": false, "maxArticles": 2161, "allowNegativeOrderedSumInCustomerOrder": false, "canCreateWayOfDelivery": true, "maxCustomers": 1376, "maxIntegrationDecimals": 3698, "canSetDefaultPricelist": true, "supportsBracketPricing": true, "allowRestCustomerOrder": false, "customerTypeSetsVAT": false, "batchAccess": false, "maxStocks": 8409, "supportsNoVAT": true, "canSetStock": true, "canCreateUnit": true, "increaseStockOnReceiveForPickNPack": false, "canChangeCustomerOnOrderStateEnd": 7942, "supportsInvoiceTypes": false }, "invoiceAddress": "invoiceAddress", "invoiceEmail": "invoiceEmail", "fortnox": false, "paymentType": 8180, "masterStoreId": 8517, "features": [{ "image": "image", "server": true, "roles": [{}], "icon": "icon", "description": {}, "version": "version", "credits": "credits", "price": 5582.968702852541, "name": {}, "annual": true, "publisher": "publisher", "files": [{ "filename": "filename", "menuTitle": {}, "index": 4321 }], "id": "id", "category": [{}], "dashboard": "dashboard" }], "deactivateDate": 9004, "storeGroupId": 6702, "countryCode": "countryCode", "barcodePrintingFieldsSettings": {}, "customerOrderSettings": {}, "currency": "currency", "storeName": "storeName", "orgNumber": "orgNumber", "email": "email", "zip": "zip", "settings": { "cashInvoicePaymentWay": "cashInvoicePaymentWay", "truncateArticleName": false, "automaticBundling": true, "weeklyStatus": false, "projectInvoicePaymentWay": "projectInvoicePaymentWay", "decimals": 8609, "automaticDailyExport": true, "customerOrderNotification": true, "defaultTemplate": 9375, "defaultFortnoxVATId": 9770, "language": "language", "lowStockWarning": true }, "address": "address", "invoiceCountry": "invoiceCountry", "customerPortalSettings": { "showOtherPurchasedArticles": false, "showSerials": true, "showName": true, "welcomeTitle": {}, "welcomeText": {}, "showImage": true, "showArticleId": false, "orderArticlesNotInStock": true, "showWebshop": true, "showDescription": false, "showPrice": true, "showArticleStockStatus": false, "showBatches": true }, "purchaseOrderSettings": {}, "address2": "address2", "contactName": "contactName", "articleSuffix": "articleSuffix", "fortnoxV2": false, "salesPriceIncludesVAT": false, "invoiceAddress2": "invoiceAddress2", "storeId": 6961, "invoiceCity": "invoiceCity", "phone": "phone", "name": "name", "invoiceCountryCode": "invoiceCountryCode" }

Get API component settings

GETUrl: /api/settings
Headers:
Accept: application/json or application/xml
Other headers: user_id, user_token
Get API component settings for all of the company accounts
Body:
Successfull response:

{ "integrationSuccessfull": false, "integrationName": "integrationName", "stores": [{}], "apiKeys": [{ "name": "name", "requests": [{ "path": "path", "method": "method" }], "key": "key" }], "callbackUrl": "callbackUrl" }

Get Events component settings

GETUrl: /events/settings
Headers:
Accept: application/json or application/xml
Other headers: user_id, user_token
Get Scheduled Events component settings for all of the company accounts
Body:
Successfull response:

{ "bestBeforeTrigger": 13, "purchaseOrdersReminder": false }

Get Report component settings

GETUrl: /reports/settings
Headers:
Accept: application/json or application/xml
Other headers: user_id, user_token
Get Report component settings for all of the company accounts
Body:
Successfull response:

{ "tobaccoEUCustomerTag": { "name": "name", "externalId": "externalId", "id": 3646, "desc": "desc" }, "tobaccoNoTaxCustomerTag": { "name": "name", "externalId": "externalId", "id": 9003, "desc": "desc" }, "tobaccoSWCustomerTag": { "name": "name", "externalId": "externalId", "id": 6469, "desc": "desc" } }

Register company account

POSTUrl: /register
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Register a new company account. Before user is allowed to do this, he/she must first view and accept the license agreement.
Body:

{ "zip": "zip", "country": "country", "address": "address", "notes": "notes", "city": "city", "licenceAccepted": "false", "companyName": "companyName", "promotionCode": "promotionCode", "contactPerson": "contactPerson", "language": "en", "paymentType": 3802, "features": [{}], "password": "password", "phone": "phone", "currency": "currency", "orgNumber": "orgNumber", "email": "email", "bankIDOrderRef": "bankIDOrderRef" }
Successfull response:

{ "invoiceZip": "invoiceZip", "country": "country", "visma": true, "fieldsSettings": {"fields": {}}, "city": "city", "rules": { "canCreateCostCenters": true, "canCreateSupplierDeliveryTerm": false, "maxUsers": 9762, "defaultCategory": { "name": "name", "id": 1009, "articles": 2072 }, "articleNameMaxLength": 9589, "showVATAccount": false, "canCreateCustomerOrderInvoice": true, "canChangeCustomerOnOrderStateStart": 6133, "canCancelCustomerOrder": true, "allowZeroSumCustomerOrders": true, "customerOrderReservedStateEnd": 3395, "canCreateCustomerDeliveryTerm": false, "canCreateVAT": true, "customerOrderReservedStateStart": 3908, "defaultUnitType": { "name": "name", "externalId": "externalId", "id": 4191 }, "defaultVAT": { "isDefault": false, "code": "code", "vat": 8688.955341104716, "description": "description", "id": 903, "account": 482 }, "supportsCustomerOrderFees": false, "doesVATControllArticleType": false, "canCreatePaymentTerm": true, "canSetCostCentersOnCustomerOrder": false, "maxArticles": 7037, "allowNegativeOrderedSumInCustomerOrder": true, "canCreateWayOfDelivery": false, "maxCustomers": 3291, "maxIntegrationDecimals": 5579, "canSetDefaultPricelist": false, "supportsBracketPricing": true, "allowRestCustomerOrder": false, "customerTypeSetsVAT": false, "batchAccess": true, "maxStocks": 98, "supportsNoVAT": true, "canSetStock": true, "canCreateUnit": true, "increaseStockOnReceiveForPickNPack": true, "canChangeCustomerOnOrderStateEnd": 5820, "supportsInvoiceTypes": true }, "invoiceAddress": "invoiceAddress", "invoiceEmail": "invoiceEmail", "fortnox": false, "paymentType": 4497, "masterStoreId": 9489, "features": [{ "image": "image", "server": true, "roles": [{}], "icon": "icon", "description": {}, "version": "version", "credits": "credits", "price": 4132.915933042603, "name": {}, "annual": true, "publisher": "publisher", "files": [{ "filename": "filename", "menuTitle": {}, "index": 3315 }], "id": "id", "category": [{}], "dashboard": "dashboard" }], "deactivateDate": 993, "storeGroupId": 3087, "countryCode": "countryCode", "barcodePrintingFieldsSettings": {}, "customerOrderSettings": {}, "currency": "currency", "storeName": "storeName", "orgNumber": "orgNumber", "email": "email", "zip": "zip", "settings": { "cashInvoicePaymentWay": "cashInvoicePaymentWay", "truncateArticleName": true, "automaticBundling": true, "weeklyStatus": false, "projectInvoicePaymentWay": "projectInvoicePaymentWay", "decimals": 794, "automaticDailyExport": false, "customerOrderNotification": false, "defaultTemplate": 1880, "defaultFortnoxVATId": 1598, "language": "language", "lowStockWarning": true }, "address": "address", "invoiceCountry": "invoiceCountry", "customerPortalSettings": { "showOtherPurchasedArticles": false, "showSerials": false, "showName": false, "welcomeTitle": {}, "welcomeText": {}, "showImage": false, "showArticleId": true, "orderArticlesNotInStock": true, "showWebshop": false, "showDescription": true, "showPrice": true, "showArticleStockStatus": false, "showBatches": true }, "purchaseOrderSettings": {}, "address2": "address2", "contactName": "contactName", "articleSuffix": "articleSuffix", "fortnoxV2": false, "salesPriceIncludesVAT": false, "invoiceAddress2": "invoiceAddress2", "storeId": 4758, "invoiceCity": "invoiceCity", "phone": "phone", "name": "name", "invoiceCountryCode": "invoiceCountryCode" }

Invite new company to Lagerkoll

POSTUrl: /promotion/invite
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Invite a new company to use Lagerkoll and get a discount on the next invoice
Body:

{"email": "email"}
Successfull response:

Send email

POSTUrl: /email/send
Headers:
Accept: application/json or application/xml
Content-type: multipart/form-data
Other headers: user_id, user_token
Send email to an email address

Valid parameters:

Parameter Description Default value Allowed values
file
file
toAddress Email to receiver
subject Subject of email
message Message of email

Body:
Successfull response:

Send support

POSTUrl: /support
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Send support mail to Lagerkoll
Body:

{ "subject": "subject", "message": "message" }
Successfull response:

Status

Get unread status messages count

GETUrl: /status/count
Headers:
Accept: application/json or application/xml
Other headers: user_id, user_token
Get number of unread status messages.
Body:
Successfull response:

{"count": 4299}

Get status messages

GETUrl: /status
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Get a list of the latest status messages saved for the store

Valid parameters:

Parameter Description Default value Allowed values
page 0
limit 100

Body:
Successfull response:

{ "pages": 619, "pageSize": 4701, "messages": [{ "integrationType": "integrationType", "created": 8944, "technicalMessage": "technicalMessage", "action": "action", "messageId": "messageId", "progress": 8949, "type": "type", "message": "message" }], "page": 9350, "messagesCount": 7802 }

Send status message

POSTUrl: /status
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Send a status-message to Lagerkoll. INFO and ERRORs are stored and can be viewed when user loggs in, PROGRESS and PROGRESS_DONE are only showed for logged in users
Body:

{ "integrationType": "integrationType", "action": "action", "messageId": "messageId", "progress": 2738, "type": "type", "message": "message" }
Successfull response:

User Account

Get user account settings

GETUrl: /settings
Headers:
Accept: application/json or application/xml
Other headers: user_id, user_token
Get user account settings
Body:
Successfull response:

{ "productSortOrder": "productSortOrder", "storeArticleSortData": {}, "supplierArticleSettings": {}, "projectSortData": [{ "column": "column", "state": 1497, "order": "order" }], "showWelcome": true, "language": "language", "multiPickData": {}, "reportsSettings": {}, "customerSortData": {}, "articleSortData": {}, "pickingListSortData": {}, "projectArticleSortData": {}, "storeGroupId": 9945, "pickingListSortColumn": "pickingListSortColumn", "customerOrderSortData": [{ "column": "column", "state": 18, "order": "order" }], "productSortColumn": "productSortColumn", "productionOrderSortData": [{ "column": "column", "state": 4229, "order": "order" }], "warnedArticlesSortData": {}, "systemAccountSortData": {}, "lastReadStatusMessages": 1686, "invoiceDraftSortData": {}, "stocktakeArticleSortData": {}, "pickingListSortOrder": "pickingListSortOrder", "orderedArticlesSortData": {}, "accountSortData": {}, "supplierSortData": {}, "productionOrderData": {}, "openPurchaseOrderSortData": {}, "priceListSortData": {}, "storeId": 6357, "purchaseOrderSortData": [{ "column": "column", "state": 8733, "order": "order" }], "systemUserSortData": {}, "helpSectionsCollapsed": {}, "viewedReleaseNotesVersion": "viewedReleaseNotesVersion", "invoiceSortData": {} }

Get logged in user

GETUrl: /login
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Get logged in user, same response as in login
Body:
Successfull response:

{ "systemAdmin": true, "settings": { "productSortOrder": "productSortOrder", "storeArticleSortData": {}, "supplierArticleSettings": {}, "projectSortData": [{ "column": "column", "state": 6167, "order": "order" }], "showWelcome": true, "language": "language", "multiPickData": {}, "reportsSettings": {}, "customerSortData": {}, "articleSortData": {}, "pickingListSortData": {}, "projectArticleSortData": {}, "storeGroupId": 3215, "pickingListSortColumn": "pickingListSortColumn", "customerOrderSortData": [{ "column": "column", "state": 4820, "order": "order" }], "productSortColumn": "productSortColumn", "productionOrderSortData": [{ "column": "column", "state": 8824, "order": "order" }], "warnedArticlesSortData": {}, "systemAccountSortData": {}, "lastReadStatusMessages": 8208, "invoiceDraftSortData": {}, "stocktakeArticleSortData": {}, "pickingListSortOrder": "pickingListSortOrder", "orderedArticlesSortData": {}, "accountSortData": {}, "supplierSortData": {}, "productionOrderData": {}, "openPurchaseOrderSortData": {}, "priceListSortData": {}, "storeId": 3482, "purchaseOrderSortData": [{ "column": "column", "state": 5873, "order": "order" }], "systemUserSortData": {}, "helpSectionsCollapsed": {}, "viewedReleaseNotesVersion": "viewedReleaseNotesVersion", "invoiceSortData": {} }, "apiKey": "apiKey", "phone": "phone", "name": "name", "storeGroups": [{ "stores": 5566, "groupId": 7014, "name": "name", "integration": "integration", "storePermissions": [{ "role": { "storeGroupId": 2258, "paths": [{ "path": "path", "action": "action" }], "name": "name", "id": 4517, "fields": {}, "portal": "portal", "users": 6664 }, "capabilities": [{}], "storeGroupId": 9242, "isMaster": true, "name": "name", "currency": "currency", "language": "language", "storeId": 4100 }] }], "admin": true, "delayedInvoicesMessage": "delayedInvoicesMessage", "userId": 691, "email": "email" }

Get unread web messages

GETUrl: /webmessages
Headers:
Accept: application/json or application/xml
Other headers: user_id, user_token
Get list of unread web messages. This request will return a list of unread messages and then mark them as read. The messages will only be returned once

Valid parameters:

Parameter Description Default value Allowed values
statistics false

Body:
Successfull response:

{"messages": [{ "data": { "action": "action", "params": {} }, "action": "action", "responseCode": 9616 }]}

Get user

GETUrl: /users/{id}
Headers:
Accept: application/json or application/xml
Other headers: user_id, user_token
Get a user by id
Body:
Successfull response:

{ "systemAdmin": true, "bankID": false, "notes": "notes", "role": { "storeGroupId": 9795, "paths": [{ "path": "path", "action": "action" }], "name": "name", "id": 5126, "fields": {}, "portal": "portal", "users": 8060 }, "phone": "phone", "name": "name", "emailInvalid": false, "admin": false, "lastLoggedIn": 2269, "id": 8525, "email": "email", "customer": true }

Verify user account

POSTUrl: /verify
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Verify the user account. If successful the account is activated and can be used to login with
Body:

{"verification": "verification"}
Successfull response:

{"username": "username"}

Update user settings

PUTUrl: /settings
Headers:
Accept: application/json or application/xml
Other headers: user_id, user_token
Update user account settings for the fields provided
Body:

{ "productSortOrder": "productSortOrder", "storeArticleSortData": {}, "supplierArticleSettings": {}, "projectSortData": [{ "column": "column", "state": 8478, "order": "order" }], "showWelcome": true, "language": "language", "multiPickData": {}, "reportsSettings": {}, "customerSortData": {}, "articleSortData": {}, "pickingListSortData": {}, "projectArticleSortData": {}, "storeGroupId": 9060, "pickingListSortColumn": "pickingListSortColumn", "customerOrderSortData": [{ "column": "column", "state": 4326, "order": "order" }], "productSortColumn": "productSortColumn", "productionOrderSortData": [{ "column": "column", "state": 5497, "order": "order" }], "warnedArticlesSortData": {}, "systemAccountSortData": {}, "lastReadStatusMessages": 3535, "invoiceDraftSortData": {}, "stocktakeArticleSortData": {}, "pickingListSortOrder": "pickingListSortOrder", "orderedArticlesSortData": {}, "accountSortData": {}, "supplierSortData": {}, "productionOrderData": {}, "openPurchaseOrderSortData": {}, "priceListSortData": {}, "storeId": 4953, "purchaseOrderSortData": [{ "column": "column", "state": 6888, "order": "order" }], "systemUserSortData": {}, "helpSectionsCollapsed": {}, "viewedReleaseNotesVersion": "viewedReleaseNotesVersion", "invoiceSortData": {} }
Successfull response:

{ "productSortOrder": "productSortOrder", "storeArticleSortData": {}, "supplierArticleSettings": {}, "projectSortData": [{ "column": "column", "state": 2052, "order": "order" }], "showWelcome": false, "language": "language", "multiPickData": {}, "reportsSettings": {}, "customerSortData": {}, "articleSortData": {}, "pickingListSortData": {}, "projectArticleSortData": {}, "storeGroupId": 6358, "pickingListSortColumn": "pickingListSortColumn", "customerOrderSortData": [{ "column": "column", "state": 9404, "order": "order" }], "productSortColumn": "productSortColumn", "productionOrderSortData": [{ "column": "column", "state": 1950, "order": "order" }], "warnedArticlesSortData": {}, "systemAccountSortData": {}, "lastReadStatusMessages": 24, "invoiceDraftSortData": {}, "stocktakeArticleSortData": {}, "pickingListSortOrder": "pickingListSortOrder", "orderedArticlesSortData": {}, "accountSortData": {}, "supplierSortData": {}, "productionOrderData": {}, "openPurchaseOrderSortData": {}, "priceListSortData": {}, "storeId": 4595, "purchaseOrderSortData": [{ "column": "column", "state": 776, "order": "order" }], "systemUserSortData": {}, "helpSectionsCollapsed": {}, "viewedReleaseNotesVersion": "viewedReleaseNotesVersion", "invoiceSortData": {} }

Remove SSO

DELETEUrl: /sso/{type}
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Remove Single Sign On from user
Body:
Successfull response:

Log in with SSO

POSTUrl: /login/sso
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Login to your Lagerkoll user account and connect your SSO user with your Lagerkoll user
Body:

{ "password": "password", "externalId": "externalId", "type": "type", "username": "username" }
Successfull response:

{ "systemAdmin": false, "settings": { "productSortOrder": "productSortOrder", "storeArticleSortData": {}, "supplierArticleSettings": {}, "projectSortData": [{ "column": "column", "state": 1493, "order": "order" }], "showWelcome": true, "language": "language", "multiPickData": {}, "reportsSettings": {}, "customerSortData": {}, "articleSortData": {}, "pickingListSortData": {}, "projectArticleSortData": {}, "storeGroupId": 203, "pickingListSortColumn": "pickingListSortColumn", "customerOrderSortData": [{ "column": "column", "state": 379, "order": "order" }], "productSortColumn": "productSortColumn", "productionOrderSortData": [{ "column": "column", "state": 9370, "order": "order" }], "warnedArticlesSortData": {}, "systemAccountSortData": {}, "lastReadStatusMessages": 5126, "invoiceDraftSortData": {}, "stocktakeArticleSortData": {}, "pickingListSortOrder": "pickingListSortOrder", "orderedArticlesSortData": {}, "accountSortData": {}, "supplierSortData": {}, "productionOrderData": {}, "openPurchaseOrderSortData": {}, "priceListSortData": {}, "storeId": 9756, "purchaseOrderSortData": [{ "column": "column", "state": 1753, "order": "order" }], "systemUserSortData": {}, "helpSectionsCollapsed": {}, "viewedReleaseNotesVersion": "viewedReleaseNotesVersion", "invoiceSortData": {} }, "apiKey": "apiKey", "phone": "phone", "name": "name", "storeGroups": [{ "stores": 661, "groupId": 5868, "name": "name", "integration": "integration", "storePermissions": [{ "role": { "storeGroupId": 3051, "paths": [{ "path": "path", "action": "action" }], "name": "name", "id": 8101, "fields": {}, "portal": "portal", "users": 4041 }, "capabilities": [{}], "storeGroupId": 1602, "isMaster": true, "name": "name", "currency": "currency", "language": "language", "storeId": 6912 }] }], "admin": true, "delayedInvoicesMessage": "delayedInvoicesMessage", "userId": 209, "email": "email" }

Log in with webtoken

POSTUrl: /login/webtoken/{web_token}
Headers:
Accept: application/json or application/xml
Login to your user account using a valid webtoken
Body:
Successfull response:

{ "systemAdmin": true, "settings": { "productSortOrder": "productSortOrder", "storeArticleSortData": {}, "supplierArticleSettings": {}, "projectSortData": [{ "column": "column", "state": 7389, "order": "order" }], "showWelcome": true, "language": "language", "multiPickData": {}, "reportsSettings": {}, "customerSortData": {}, "articleSortData": {}, "pickingListSortData": {}, "projectArticleSortData": {}, "storeGroupId": 8177, "pickingListSortColumn": "pickingListSortColumn", "customerOrderSortData": [{ "column": "column", "state": 1103, "order": "order" }], "productSortColumn": "productSortColumn", "productionOrderSortData": [{ "column": "column", "state": 5408, "order": "order" }], "warnedArticlesSortData": {}, "systemAccountSortData": {}, "lastReadStatusMessages": 6001, "invoiceDraftSortData": {}, "stocktakeArticleSortData": {}, "pickingListSortOrder": "pickingListSortOrder", "orderedArticlesSortData": {}, "accountSortData": {}, "supplierSortData": {}, "productionOrderData": {}, "openPurchaseOrderSortData": {}, "priceListSortData": {}, "storeId": 1965, "purchaseOrderSortData": [{ "column": "column", "state": 9061, "order": "order" }], "systemUserSortData": {}, "helpSectionsCollapsed": {}, "viewedReleaseNotesVersion": "viewedReleaseNotesVersion", "invoiceSortData": {} }, "apiKey": "apiKey", "phone": "phone", "name": "name", "storeGroups": [{ "stores": 4501, "groupId": 5328, "name": "name", "integration": "integration", "storePermissions": [{ "role": { "storeGroupId": 9664, "paths": [{ "path": "path", "action": "action" }], "name": "name", "id": 3030, "fields": {}, "portal": "portal", "users": 6955 }, "capabilities": [{}], "storeGroupId": 1356, "isMaster": false, "name": "name", "currency": "currency", "language": "language", "storeId": 9481 }] }], "admin": false, "delayedInvoicesMessage": "delayedInvoicesMessage", "userId": 1681, "email": "email" }

Invite user

POSTUrl: /users/invite
Headers:
Accept: application/json or application/xml
Other headers: user_id, user_token
Invite user to store
Body:

{ "notes": "notes", "role": { "paths": [{ "path": "path", "action": "action" }], "name": "name", "fields": {}, "portal": "portal" }, "phone": "phone", "name": "name", "email": "email" }
Successfull response:

{ "systemAdmin": false, "bankID": true, "notes": "notes", "role": { "storeGroupId": 1699, "paths": [{ "path": "path", "action": "action" }], "name": "name", "id": 3932, "fields": {}, "portal": "portal", "users": 1581 }, "phone": "phone", "name": "name", "emailInvalid": false, "admin": true, "lastLoggedIn": 543, "id": 868, "email": "email", "customer": false }

Company Account

Update company account

PUTUrl:
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Update information on the company account. This is not to be confused with a user account.
Body:

{ "invoiceZip": "invoiceZip", "country": "country", "visma": false, "fieldsSettings": {"fields": {}}, "city": "city", "rules": { "canCreateCostCenters": true, "canCreateSupplierDeliveryTerm": true, "maxUsers": 3350, "defaultCategory": { "name": "name", "id": 8123, "articles": 6550 }, "articleNameMaxLength": 469, "showVATAccount": false, "canCreateCustomerOrderInvoice": true, "canChangeCustomerOnOrderStateStart": 4501, "canCancelCustomerOrder": false, "allowZeroSumCustomerOrders": true, "customerOrderReservedStateEnd": 5344, "canCreateCustomerDeliveryTerm": false, "canCreateVAT": true, "customerOrderReservedStateStart": 5711, "defaultUnitType": { "name": "name", "externalId": "externalId", "id": 679 }, "defaultVAT": { "isDefault": true, "code": "code", "vat": 3484.8246006765416, "description": "description", "id": 4346, "account": 9969 }, "supportsCustomerOrderFees": true, "doesVATControllArticleType": true, "canCreatePaymentTerm": true, "canSetCostCentersOnCustomerOrder": true, "maxArticles": 2106, "allowNegativeOrderedSumInCustomerOrder": false, "canCreateWayOfDelivery": false, "maxCustomers": 1921, "maxIntegrationDecimals": 1813, "canSetDefaultPricelist": true, "supportsBracketPricing": true, "allowRestCustomerOrder": true, "customerTypeSetsVAT": false, "batchAccess": true, "maxStocks": 2428, "supportsNoVAT": true, "canSetStock": true, "canCreateUnit": true, "increaseStockOnReceiveForPickNPack": true, "canChangeCustomerOnOrderStateEnd": 1553, "supportsInvoiceTypes": false }, "invoiceAddress": "invoiceAddress", "invoiceEmail": "invoiceEmail", "fortnox": false, "paymentType": 8152, "masterStoreId": 8172, "features": [{ "image": "image", "server": false, "roles": [{}], "icon": "icon", "description": {}, "version": "version", "credits": "credits", "price": 9811.014661890007, "name": {}, "annual": false, "publisher": "publisher", "files": [{ "filename": "filename", "menuTitle": {}, "index": 1646 }], "id": "id", "category": [{}], "dashboard": "dashboard" }], "deactivateDate": 5534, "storeGroupId": 4635, "countryCode": "countryCode", "barcodePrintingFieldsSettings": {}, "customerOrderSettings": {}, "currency": "currency", "storeName": "storeName", "orgNumber": "orgNumber", "email": "email", "zip": "zip", "settings": { "cashInvoicePaymentWay": "cashInvoicePaymentWay", "truncateArticleName": true, "automaticBundling": true, "weeklyStatus": true, "projectInvoicePaymentWay": "projectInvoicePaymentWay", "decimals": 6911, "automaticDailyExport": true, "customerOrderNotification": false, "defaultTemplate": 1553, "defaultFortnoxVATId": 6827, "language": "language", "lowStockWarning": false }, "address": "address", "invoiceCountry": "invoiceCountry", "customerPortalSettings": { "showOtherPurchasedArticles": false, "showSerials": false, "showName": false, "welcomeTitle": {}, "welcomeText": {}, "showImage": true, "showArticleId": false, "orderArticlesNotInStock": false, "showWebshop": true, "showDescription": true, "showPrice": true, "showArticleStockStatus": false, "showBatches": true }, "purchaseOrderSettings": {}, "address2": "address2", "contactName": "contactName", "articleSuffix": "articleSuffix", "fortnoxV2": true, "salesPriceIncludesVAT": false, "invoiceAddress2": "invoiceAddress2", "storeId": 4338, "invoiceCity": "invoiceCity", "phone": "phone", "name": "name", "invoiceCountryCode": "invoiceCountryCode" }
Successfull response:

{ "invoiceZip": "invoiceZip", "country": "country", "visma": true, "fieldsSettings": {"fields": {}}, "city": "city", "rules": { "canCreateCostCenters": false, "canCreateSupplierDeliveryTerm": true, "maxUsers": 5174, "defaultCategory": { "name": "name", "id": 1271, "articles": 793 }, "articleNameMaxLength": 6831, "showVATAccount": false, "canCreateCustomerOrderInvoice": true, "canChangeCustomerOnOrderStateStart": 8985, "canCancelCustomerOrder": false, "allowZeroSumCustomerOrders": true, "customerOrderReservedStateEnd": 8878, "canCreateCustomerDeliveryTerm": false, "canCreateVAT": true, "customerOrderReservedStateStart": 2045, "defaultUnitType": { "name": "name", "externalId": "externalId", "id": 6722 }, "defaultVAT": { "isDefault": true, "code": "code", "vat": 4323.502675091392, "description": "description", "id": 1490, "account": 6029 }, "supportsCustomerOrderFees": true, "doesVATControllArticleType": true, "canCreatePaymentTerm": true, "canSetCostCentersOnCustomerOrder": false, "maxArticles": 7415, "allowNegativeOrderedSumInCustomerOrder": false, "canCreateWayOfDelivery": true, "maxCustomers": 9669, "maxIntegrationDecimals": 3024, "canSetDefaultPricelist": true, "supportsBracketPricing": true, "allowRestCustomerOrder": true, "customerTypeSetsVAT": true, "batchAccess": false, "maxStocks": 6672, "supportsNoVAT": false, "canSetStock": false, "canCreateUnit": true, "increaseStockOnReceiveForPickNPack": false, "canChangeCustomerOnOrderStateEnd": 4455, "supportsInvoiceTypes": true }, "invoiceAddress": "invoiceAddress", "invoiceEmail": "invoiceEmail", "fortnox": false, "paymentType": 1572, "masterStoreId": 1568, "features": [{ "image": "image", "server": false, "roles": [{}], "icon": "icon", "description": {}, "version": "version", "credits": "credits", "price": 5373.2555205795725, "name": {}, "annual": true, "publisher": "publisher", "files": [{ "filename": "filename", "menuTitle": {}, "index": 1790 }], "id": "id", "category": [{}], "dashboard": "dashboard" }], "deactivateDate": 57, "storeGroupId": 3259, "countryCode": "countryCode", "barcodePrintingFieldsSettings": {}, "customerOrderSettings": {}, "currency": "currency", "storeName": "storeName", "orgNumber": "orgNumber", "email": "email", "zip": "zip", "settings": { "cashInvoicePaymentWay": "cashInvoicePaymentWay", "truncateArticleName": true, "automaticBundling": true, "weeklyStatus": false, "projectInvoicePaymentWay": "projectInvoicePaymentWay", "decimals": 5959, "automaticDailyExport": true, "customerOrderNotification": true, "defaultTemplate": 7962, "defaultFortnoxVATId": 1751, "language": "language", "lowStockWarning": false }, "address": "address", "invoiceCountry": "invoiceCountry", "customerPortalSettings": { "showOtherPurchasedArticles": false, "showSerials": true, "showName": true, "welcomeTitle": {}, "welcomeText": {}, "showImage": true, "showArticleId": true, "orderArticlesNotInStock": false, "showWebshop": true, "showDescription": true, "showPrice": true, "showArticleStockStatus": true, "showBatches": false }, "purchaseOrderSettings": {}, "address2": "address2", "contactName": "contactName", "articleSuffix": "articleSuffix", "fortnoxV2": false, "salesPriceIncludesVAT": true, "invoiceAddress2": "invoiceAddress2", "storeId": 318, "invoiceCity": "invoiceCity", "phone": "phone", "name": "name", "invoiceCountryCode": "invoiceCountryCode" }

Upgrade premium

PUTUrl: /premium/{payment_type}
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Upgrade to a premium account. This can only be done if the account is a free account. If you wish to upgrade or downgrade please contact us on support@lagerkoll.com
Body:
Successfull response:

{ "invoiceZip": "invoiceZip", "country": "country", "visma": true, "fieldsSettings": {"fields": {}}, "city": "city", "rules": { "canCreateCostCenters": true, "canCreateSupplierDeliveryTerm": true, "maxUsers": 1169, "defaultCategory": { "name": "name", "id": 9030, "articles": 3364 }, "articleNameMaxLength": 9649, "showVATAccount": true, "canCreateCustomerOrderInvoice": true, "canChangeCustomerOnOrderStateStart": 5854, "canCancelCustomerOrder": false, "allowZeroSumCustomerOrders": true, "customerOrderReservedStateEnd": 2146, "canCreateCustomerDeliveryTerm": false, "canCreateVAT": true, "customerOrderReservedStateStart": 2925, "defaultUnitType": { "name": "name", "externalId": "externalId", "id": 1538 }, "defaultVAT": { "isDefault": false, "code": "code", "vat": 1835.100905588314, "description": "description", "id": 6340, "account": 3228 }, "supportsCustomerOrderFees": true, "doesVATControllArticleType": false, "canCreatePaymentTerm": true, "canSetCostCentersOnCustomerOrder": true, "maxArticles": 4253, "allowNegativeOrderedSumInCustomerOrder": false, "canCreateWayOfDelivery": true, "maxCustomers": 120, "maxIntegrationDecimals": 6295, "canSetDefaultPricelist": true, "supportsBracketPricing": false, "allowRestCustomerOrder": true, "customerTypeSetsVAT": false, "batchAccess": false, "maxStocks": 4111, "supportsNoVAT": true, "canSetStock": true, "canCreateUnit": false, "increaseStockOnReceiveForPickNPack": true, "canChangeCustomerOnOrderStateEnd": 2109, "supportsInvoiceTypes": true }, "invoiceAddress": "invoiceAddress", "invoiceEmail": "invoiceEmail", "fortnox": true, "paymentType": 3220, "masterStoreId": 7760, "features": [{ "image": "image", "server": false, "roles": [{}], "icon": "icon", "description": {}, "version": "version", "credits": "credits", "price": 5229.998123888111, "name": {}, "annual": false, "publisher": "publisher", "files": [{ "filename": "filename", "menuTitle": {}, "index": 1044 }], "id": "id", "category": [{}], "dashboard": "dashboard" }], "deactivateDate": 4115, "storeGroupId": 6935, "countryCode": "countryCode", "barcodePrintingFieldsSettings": {}, "customerOrderSettings": {}, "currency": "currency", "storeName": "storeName", "orgNumber": "orgNumber", "email": "email", "zip": "zip", "settings": { "cashInvoicePaymentWay": "cashInvoicePaymentWay", "truncateArticleName": false, "automaticBundling": false, "weeklyStatus": false, "projectInvoicePaymentWay": "projectInvoicePaymentWay", "decimals": 7901, "automaticDailyExport": false, "customerOrderNotification": true, "defaultTemplate": 8900, "defaultFortnoxVATId": 317, "language": "language", "lowStockWarning": true }, "address": "address", "invoiceCountry": "invoiceCountry", "customerPortalSettings": { "showOtherPurchasedArticles": false, "showSerials": false, "showName": true, "welcomeTitle": {}, "welcomeText": {}, "showImage": false, "showArticleId": false, "orderArticlesNotInStock": false, "showWebshop": true, "showDescription": false, "showPrice": false, "showArticleStockStatus": false, "showBatches": true }, "purchaseOrderSettings": {}, "address2": "address2", "contactName": "contactName", "articleSuffix": "articleSuffix", "fortnoxV2": false, "salesPriceIncludesVAT": true, "invoiceAddress2": "invoiceAddress2", "storeId": 4116, "invoiceCity": "invoiceCity", "phone": "phone", "name": "name", "invoiceCountryCode": "invoiceCountryCode" }

User Account

Update user

PUTUrl: /users/{id}
Headers:
Accept: application/json or application/xml
Other headers: user_id, user_token
Update user account for the fields provided
Body:

{ "systemAdmin": true, "bankID": true, "notes": "notes", "role": { "storeGroupId": 464, "paths": [{ "path": "path", "action": "action" }], "name": "name", "id": 3920, "fields": {}, "portal": "portal", "users": 8529 }, "phone": "phone", "name": "name", "emailInvalid": true, "admin": false, "lastLoggedIn": 1410, "id": 1538, "email": "email", "customer": false }
Successfull response:

{ "systemAdmin": false, "bankID": true, "notes": "notes", "role": { "storeGroupId": 5416, "paths": [{ "path": "path", "action": "action" }], "name": "name", "id": 3771, "fields": {}, "portal": "portal", "users": 1995 }, "phone": "phone", "name": "name", "emailInvalid": true, "admin": false, "lastLoggedIn": 8717, "id": 985, "email": "email", "customer": false }

Prepare change user password

PUTUrl: /users/password/reset
Headers:
Accept: application/json or application/xml
Other headers: user_id, user_token
Sends out an email with a reset-url for the given user
Body:

{"username": "username"}
Successfull response:

Change user password

PUTUrl: /users/{id}/password
Headers:
Accept: application/json or application/xml
Other headers: user_id, user_token
Update user password from a reset key
Body:

{ "password": "password", "confirmPassword": "confirmPassword", "resetKey": "resetKey" }
Successfull response:

Company Account

Update API component settings

PUTUrl: /api/settings
Headers:
Accept: application/json or application/xml
Other headers: user_id, user_token
Update API component settings for all of the company accounts
Body:

{ "integrationSuccessfull": false, "integrationName": "integrationName", "stores": [{}], "apiKeys": [{ "name": "name", "requests": [{ "path": "path", "method": "method" }], "key": "key" }], "callbackUrl": "callbackUrl" }
Successfull response:

{ "integrationSuccessfull": false, "integrationName": "integrationName", "stores": [{}], "apiKeys": [{ "name": "name", "requests": [{ "path": "path", "method": "method" }], "key": "key" }], "callbackUrl": "callbackUrl" }

Update Events component settings

PUTUrl: /events/settings
Headers:
Accept: application/json or application/xml
Other headers: user_id, user_token
Update Scheduled Events component settings for all of the company accounts
Body:

{ "bestBeforeTrigger": 9164, "purchaseOrdersReminder": true }
Successfull response:

{ "bestBeforeTrigger": 7227, "purchaseOrdersReminder": false }

Update Report component settings

PUTUrl: /reports/settings
Headers:
Accept: application/json or application/xml
Other headers: user_id, user_token
Update Report component settings for all of the company accounts
Body:

{ "tobaccoEUCustomerTag": { "name": "name", "externalId": "externalId", "id": 3945, "desc": "desc" }, "tobaccoNoTaxCustomerTag": { "name": "name", "externalId": "externalId", "id": 9890, "desc": "desc" }, "tobaccoSWCustomerTag": { "name": "name", "externalId": "externalId", "id": 2001, "desc": "desc" } }
Successfull response:

{ "tobaccoEUCustomerTag": { "name": "name", "externalId": "externalId", "id": 9124, "desc": "desc" }, "tobaccoNoTaxCustomerTag": { "name": "name", "externalId": "externalId", "id": 336, "desc": "desc" }, "tobaccoSWCustomerTag": { "name": "name", "externalId": "externalId", "id": 984, "desc": "desc" } }

Update barcode settings

PUTUrl: /barcode/settings
Headers:
Accept: application/json or application/xml
Other headers: user_id, user_token
Update barcode settings for company account
Body:

{"barcodePrintingFieldsSettings": {}}
Successfull response:

{"barcodePrintingFieldsSettings": {}}

Update email settings

PUTUrl: /email/settings
Headers:
Accept: application/json or application/xml
Other headers: user_id, user_token
Update email settings to start using another email service than Lagerkoll´s when sending emails
Body:

{ "password": "password", "auth": "false", "verified": true, "outgoingAddress": "outgoingAddress", "tls": "false", "ssl": "false", "email": "email", "outgoingPort": 4128, "username": "username" }
Successfull response:

{ "password": "password", "auth": "false", "verified": true, "outgoingAddress": "outgoingAddress", "tls": "false", "ssl": "false", "email": "email", "outgoingPort": 6827, "username": "username" }

Verify email settings

PUTUrl: /email/verify
Headers:
Accept: application/json or application/xml
Other headers: user_id, user_token
Verify email settings and activates them on success
Body:

{ "storeId": 3562, "verification": "verification" }
Successfull response:

User Account

Delete user

DELETEUrl: /users/{id}
Headers:
Accept: application/json or application/xml
Other headers: user_id, user_token
Delete existing user account
Body:
Successfull response:

Company Account

Remove email settings

DELETEUrl: /email/settings
Headers:
Accept: application/json or application/xml
Other headers: user_id, user_token
Remove email settings and start using Lagerkoll´s email server again when sending emails
Body:
Successfull response:

Status

Remove all messages

DELETEUrl: /status
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Remove all status messages for the store
Body:
Successfull response:

User Account

Get users

GETUrl: /users
Headers:
Accept: application/json or application/xml
Other headers: user_id, user_token
Get list of users connected to company account

Valid parameters:

Parameter Description Default value Allowed values
query
since 0
page 0
limit 100
filter_customers false

Body:
Successfull response:

{ "pages": 1118, "pageSize": 2120, "usersCount": 3912, "page": 5785, "users": [{ "systemAdmin": true, "bankID": true, "notes": "notes", "role": { "storeGroupId": 5132, "paths": [{ "path": "path", "action": "action" }], "name": "name", "id": 5758, "fields": {}, "portal": "portal", "users": 5130 }, "phone": "phone", "name": "name", "emailInvalid": false, "admin": true, "lastLoggedIn": 54, "id": 3146, "email": "email", "customer": true }], "since": 8127 }

Log in

POSTUrl: /login
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Login to your Lagerkoll user account to get a valid user token to be used for other requests
Body:

{ "password": "password", "username": "username" }
Successfull response:

{ "systemAdmin": false, "settings": { "productSortOrder": "productSortOrder", "storeArticleSortData": {}, "supplierArticleSettings": {}, "projectSortData": [{ "column": "column", "state": 9112, "order": "order" }], "showWelcome": false, "language": "language", "multiPickData": {}, "reportsSettings": {}, "customerSortData": {}, "articleSortData": {}, "pickingListSortData": {}, "projectArticleSortData": {}, "storeGroupId": 2312, "pickingListSortColumn": "pickingListSortColumn", "customerOrderSortData": [{ "column": "column", "state": 6243, "order": "order" }], "productSortColumn": "productSortColumn", "productionOrderSortData": [{ "column": "column", "state": 4746, "order": "order" }], "warnedArticlesSortData": {}, "systemAccountSortData": {}, "lastReadStatusMessages": 2973, "invoiceDraftSortData": {}, "stocktakeArticleSortData": {}, "pickingListSortOrder": "pickingListSortOrder", "orderedArticlesSortData": {}, "accountSortData": {}, "supplierSortData": {}, "productionOrderData": {}, "openPurchaseOrderSortData": {}, "priceListSortData": {}, "storeId": 258, "purchaseOrderSortData": [{ "column": "column", "state": 7566, "order": "order" }], "systemUserSortData": {}, "helpSectionsCollapsed": {}, "viewedReleaseNotesVersion": "viewedReleaseNotesVersion", "invoiceSortData": {} }, "apiKey": "apiKey", "phone": "phone", "name": "name", "storeGroups": [{ "stores": 2298, "groupId": 8528, "name": "name", "integration": "integration", "storePermissions": [{ "role": { "storeGroupId": 3927, "paths": [{ "path": "path", "action": "action" }], "name": "name", "id": 5230, "fields": {}, "portal": "portal", "users": 2581 }, "capabilities": [{}], "storeGroupId": 6069, "isMaster": true, "name": "name", "currency": "currency", "language": "language", "storeId": 6290 }] }], "admin": false, "delayedInvoicesMessage": "delayedInvoicesMessage", "userId": 7742, "email": "email" }

Classes:

Account

Field Type Description Default Mandatory Accepted values Example values Access
companyName String true R,W
orgNumber String true R,W
address String R,W
city String R,W
zip String R,W
country String true Two letter codes for country, ISO alpha-2. SE for Sweden, DK for Denmark... For more codes, see http://www.nationsonline.org/oneworld/country_code_list.htm R,W
language String en en, sv R,W
contactPerson String true R,W
email String true R,W
phone String R,W
notes String R,W
currency String Currency used for sales true 3 letter codes for currencies. SEK for Swedish krona, DKK for Danish krone... For more codes, see http://www.nationsonline.org/oneworld/currencies.htm R,W
password String Either bankIDOrderRef or password Length must be 8 or more characters R,W
bankIDOrderRef String If user registers with BankID, this is the orderRef from a successfully authenticated user from BankID Either bankIDOrderRef or password R,W
paymentType Integer true Free account = 0, Small account = 1, Medium account = 2, Large account = 3 R,W
licenceAccepted Boolean The license agreement must be displayed to the user. It can be fetched by the /account/license request false true true, false R,W
promotionCode String Promotion code to get discount on next invoice R,W
features List List of feature ids that should be pre installed and part of the invoice when registering a new account R,W

AccountModel

Field Type Description Default Mandatory Accepted values Example values Access
id int R
paymentType int 0 = Free account, 1 = Small account, 2 = Medium account, 3 = Large account R
premium boolean Is this model premium or free R
reseller boolean Is this model for resellers R
name String R
price double Invoice price annually R
discountPercentage double Discount invoice price annually R
maxUsers int Max number of active users that can log in to Lagerkoll R
maxCustomers int When customer portal is active, max number of invited customers R
maxStocks int Max number of stores R
maxArticles int Max number of articles per store R
fortnoxAccess int 0 = Not available, 1 = Available, 2 = Included R
vismaAccess int 0 = Not available, 1 = Available, 2 = Included R
peAccess int 0 = Not available, 1 = Available, 2 = Included R
batchAccess int 0 = Not available, 1 = Available, 2 = Included R

AccountResponse

Field Type Description Default Mandatory Accepted values Example values Access
storeId Long Id of the requested store R
masterStoreId Long Id of master-store in the store-group R
storeGroupId Long R
name String R
orgNumber String R
paymentType Integer Free account = 0, Small account = 1, Medium account = 2, Large account = 3 R
deactivateDate Long If account is marked for deactivation, the date will tell when it will be deactivated R
fortnox Boolean Is Fortnox integration active? R
fortnoxV2 Boolean Is Fortnox V2 integration active? R
visma Boolean Is Visma integration active? R
settings StoreSettings Settings for store R,W
customerPortalSettings CustomerPortalSettings Settings for customer portal R,W
fieldsSettings FieldsSettings Settings for different fields R,W
purchaseOrderSettings HashMap Settings for purchase orders R,W
customerOrderSettings HashMap Settings for customer orders R,W
barcodePrintingFieldsSettings HashMap Settings for barcode labels R,W
rules Rules Set of rules for this account R
currency String R
salesPriceIncludesVAT Boolean Flag to indicate if salesprices include VAT R,W
contactName String R,W
address String R,W
address2 String R,W
zip String R,W
city String R,W
countryCode String R,W
country String R,W
invoiceAddress String R,W
invoiceAddress2 String R,W
invoiceZip String R,W
invoiceCity String R,W
invoiceCountryCode String R,W
invoiceCountry String R,W
phone String R,W
email String R,W
invoiceEmail String Email-address used to send invoices from Lagerkoll R
storeName String The name of the store R
articleSuffix String R
features List List of uploaded features R

AccountSettings

Field Type Description Default Mandatory Accepted values Example values Access
language String selected language sv, en R,W
storeGroupId Long selected storegroup id R
storeId Long selected store id R,W
showWelcome Boolean is it first time the user is logging in R,W
productSortColumn String sort column for articles R,W
productSortOrder String sort order for articles R,W
pickingListSortColumn String sort column for articles in customer order pickinglist R,W
pickingListSortOrder String sort order for articles in customer order pickinglist R,W
lastReadStatusMessages long timestamp of last read status message R,W
supplierArticleSettings HashMap last selected supplier in Supplier article R,W
supplierSortData HashMap sort column and order for suppliers R,W
openPurchaseOrderSortData HashMap sort column and order for open purchase order R,W
customerSortData HashMap sort column and order for customers R,W
articleSortData HashMap sort column and order for articles R,W
storeArticleSortData HashMap sort column and order for articles in all stores R,W
pickingListSortData HashMap sort column and order for picking list R,W
priceListSortData HashMap sort column and order for price list R,W
orderedArticlesSortData HashMap sort column and order for ordered articles R,W
warnedArticlesSortData HashMap sort column and order for warned articles R,W
accountSortData HashMap sort column and order for accounts R,W
stocktakeArticleSortData HashMap sort column and order for stocktake articles R,W
systemAccountSortData HashMap sort column and order for account R,W
systemUserSortData HashMap sort column and order for users R,W
helpSectionsCollapsed HashMap a map of what helpsections in Webapp that is collapsed R,W
reportsSettings HashMap settings for reports R,W
customerOrderSortData List sort column and order for customer orders based on order state R,W
purchaseOrderSortData List sort column and order for purchase orders based on order state R,W
productionOrderSortData List sort column and order for production orders based on order state R,W
productionOrderData HashMap settings for production order R,W
projectSortData List sort column and order for project based on order state R,W
projectArticleSortData HashMap sort column and order for project article based on order state R,W
invoiceDraftSortData HashMap sort column and order for invoice draft R,W
invoiceSortData HashMap sort column and order for invoice R,W
viewedReleaseNotesVersion String last viewed version of release notes R,W
multiPickData HashMap settings for multipick feature R,W

APIKey

Field Type Description Default Mandatory Accepted values Example values Access
name String Name of api key R,W
key String API key used for external integrations R,W
requests List API requests supported for the api key R,W

APIRequest

Field Type Description Default Mandatory Accepted values Example values Access
method String Allowed methods for this request GET, POST, PUT, DELETE, * R,W
path String Path for the request R,W

APISettings

Field Type Description Default Mandatory Accepted values Example values Access
apiKeys List API keys used for external integrations R,W
stores List List of store ids where the API key can be used. For all stores use * R,W
callbackUrl String Callback url used when there is an update made in Lagerkoll R,W
integrationName String Name of external integration R
integrationSuccessfull boolean Flag to indicate if integration to external system was successfull R

BarcodeSettings

Field Type Description Default Mandatory Accepted values Example values Access
barcodePrintingFieldsSettings HashMap Settings for barcode labels R,W

Category

Field Type Description Default Mandatory Accepted values Example values Access
id long R
name String Name of category R,W
articles Integer Number of articles that include this category R

Count

Field Type Description Default Mandatory Accepted values Example values Access
count int R

CustomerPortalSettings

Field Type Description Default Mandatory Accepted values Example values Access
showArticleStockStatus Boolean R
orderArticlesNotInStock Boolean R
showWebshop Boolean R
showArticleId Boolean R
showName Boolean R
showDescription Boolean R
showImage Boolean R
showPrice Boolean R
showBatches Boolean R
showSerials Boolean R
showOtherPurchasedArticles Boolean R
welcomeTitle HashMap R,W
welcomeText HashMap R,W

CustomerTag

Field Type Description Default Mandatory Accepted values Example values Access
id Long Write only with POST Post R,W
externalId String R,W
name String Post R,W
desc String Post R,W

EmailSettings

Field Type Description Default Mandatory Accepted values Example values Access
username String Username for email account. If missing email address will be used W
email String Email address W
password String Password for email account W
outgoingAddress String Outgoing address for email server, SMTP W
outgoingPort Integer Outgoing port for email server W
auth Boolean Should auth be used when connecting to email server false W
tls Boolean Should tls be used when connecting to email server false W
ssl Boolean Should ssl be used when connecting to email server false W
verified Boolean Flag to indicate if settings have been verified or not R

EmailVerification

Field Type Description Default Mandatory Accepted values Example values Access
verification String Verification key for email settings W
storeId Long Store id to verify email settings W

EventsSettings

Field Type Description Default Mandatory Accepted values Example values Access
bestBeforeTrigger Integer Number of week before the best before date expires R,W
purchaseOrdersReminder Boolean Activate delayed deliveries of purchase orders R,W

FeatureFile

Field Type Description Default Mandatory Accepted values Example values Access
index int If file should have its own link in the menu, this will be rendered according to ascending index R,W
filename String Filename R
menuTitle HashMap If file should have its own link in the menu, this will be the title R,W

FeatureResponse

Field Type Description Default Mandatory Accepted values Example values Access
id String Id of feature R
name HashMap Name of feature R
roles List List of roles needed to access the feature R,W
icon String Icon (Font Awesome v.5.15.4) to be rendered in the menu R
image String Name if image-file bundled in zip-file R
description HashMap Description of feature R
publisher String Name responsible person for this feature R
credits String Credits to people involved with this feature R
price Double Price for this feature R
annual Boolean Indicates if price is annual or onetime R
dashboard String Name of the function that renders data in the dashboard in Lagerkoll R
version String Version of feature R
files List List of files in the feature R
server Boolean Indicates if this feature has event callbacks R
category List List of categories for this feature R

FieldsSettings

Field Type Description Default Mandatory Accepted values Example values Access
fields HashMap R

Invoice

Field Type Description Default Mandatory Accepted values Example values Access
invoiceId Long R
serverId long R
invoiceDate Date R
invoiceDays int R
paymentDate Date R
invoicePeriodInMonths int R
rows List R
invoiceExpireDate Date R
state String R
invoicePaidDate Date R

InvoiceRow

Field Type Description Default Mandatory Accepted values Example values Access
articleId String R
articleName String R
articlePrice double R
articleVat double R
discountPercent double R

InvoicesResponse

Field Type Description Default Mandatory Accepted values Example values Access
invoices List R

License

Field Type Description Default Mandatory Accepted values Example values Access
eula String License agreement R
models List List of account models with information about price and limitations R

Login

Field Type Description Default Mandatory Accepted values Example values Access
username String true R,W
password String true R,W

LoginResponse

Field Type Description Default Mandatory Accepted values Example values Access
userId long R
apiKey String R
name String R
email String R
phone String R
storeGroups List R
systemAdmin Boolean R
admin Boolean R
settings AccountSettings R
delayedInvoicesMessage String If account is premium and has delayed invoices R

LoginSSO

Field Type Description Default Mandatory Accepted values Example values Access
username String true R,W
password String true R,W
type String true visma, bankid R,W
externalId String true R,W

Password

Field Type Description Default Mandatory Accepted values Example values Access
resetKey String Reset key is sent out in an email when requesting to change password W
password String New password W
confirmPassword String Confirm password W

PrepareResetPassword

Field Type Description Default Mandatory Accepted values Example values Access
username String Username to reset password for true W

PromotionCodeInviteRequest

Field Type Description Default Mandatory Accepted values Example values Access
email String Email for the invited user true W

Role

Field Type Description Default Mandatory Accepted values Example values Access
id Long R
storeGroupId Long R
name String R,W
paths List List of paths role has access to R,W
fields HashMap List of objects and fields that is filtered out when sending data to api and request data from api R,W
portal String What part of Lagerkoll is the role used ADMIN, SHOP R,W
users int Number of users connected to role R

Rules

Field Type Description Default Mandatory Accepted values Example values Access
articleNameMaxLength int R
canCreateVAT boolean R
supportsNoVAT boolean R
canCreateWayOfDelivery boolean R
canCreateSupplierDeliveryTerm boolean R
canCreateCustomerDeliveryTerm boolean R
canCreatePaymentTerm boolean R
canCreateUnit boolean R
canSetDefaultPricelist boolean R
supportsBracketPricing boolean R
showVATAccount boolean R
canCreateCustomerOrderInvoice boolean R
canCancelCustomerOrder boolean R
customerTypeSetsVAT boolean R
customerOrderReservedStateStart int R
customerOrderReservedStateEnd int R
defaultVAT VAT R
defaultUnitType Unit R
defaultCategory Category R
maxIntegrationDecimals int If account is connected to an integration (Fortnox or Visma), this field indicates the max number of decimals that system supports R
supportsCustomerOrderFees boolean R
doesVATControllArticleType boolean R
canCreateCostCenters boolean R
canSetCostCentersOnCustomerOrder boolean R
canSetStock boolean R
increaseStockOnReceiveForPickNPack boolean R
allowZeroSumCustomerOrders boolean R
allowNegativeOrderedSumInCustomerOrder boolean R
maxUsers int R
maxCustomers int R
maxStocks int R
maxArticles int R
batchAccess boolean R
allowRestCustomerOrder boolean R
supportsInvoiceTypes boolean R
canChangeCustomerOnOrderStateStart int R
canChangeCustomerOnOrderStateEnd int R

SortData

Field Type Description Default Mandatory Accepted values Example values Access
state Integer R
column String R
order String R

StatusMessage

Field Type Description Default Mandatory Accepted values Example values Access
type String What kind of message is this true info, error, progress, progress_done R,W
action String What action is this message connected to true get, add, update, delete R,W
messageId String Message id R,W
message String Message true R,W
technicalMessage String Technical message R
progress Integer If type is progress this value reflects the progress 1 - 100 R,W
integrationType String What kind of integration is this for. Default is Webshop fortnox, visma_v2, webshop, import, email R,W
created Long Created date R

StatusMessagesResponse

Field Type Description Default Mandatory Accepted values Example values Access
pages int Total pages R
page int Current page R
pageSize int Message per page R
messagesCount int Total amount of messages R
messages List R

StoreGroup

Field Type Description Default Mandatory Accepted values Example values Access
groupId long R
name String R
stores int R
storePermissions List R
integration String R

StoreGroupReportsSettings

Field Type Description Default Mandatory Accepted values Example values Access
tobaccoSWCustomerTag CustomerTag R,W
tobaccoEUCustomerTag CustomerTag R,W
tobaccoNoTaxCustomerTag CustomerTag R,W

StorePermission

Field Type Description Default Mandatory Accepted values Example values Access
storeId long R
storeGroupId long R
name String R
currency String R
language String R
role Role Role current user has access to R
capabilities List List of capabilities current user has access to MAIN_INVENTORY(1), INVENTORY_CREATE_NEW(101), INVENTORY_FINISH_LIST(102), MAIN_PRODUCT(2), PRODUCT_CREATE_NEW(201), PRODUCT_EDIT_EXISTING(202), PRODUCT_VIEW_PRICES(203), PRODUCT_UNIT_CREATE_NEW(204), MAIN_ORDER(5), ORDER_CREATE_NEW(501), MAIN_DELIVERY(6), DELIVERY_CLOSE_ORDER(601), MAIN_PICKING_LISTS(7), PICKING_LISTS_PICK(701), PICKING_LISTS_FINISH(702), MAIN_CHECKOUT(8), CHECKOUT(801), CHECKIN(802), MAIN_CUSTOMER_ORDER(9), CUSTOMER_ORDER_CREATE_NEW(901), BATCHES(1001) R
isMaster Boolean True if this is the master stock R

StoreSettings

Field Type Description Default Mandatory Accepted values Example values Access
decimals Integer R
weeklyStatus Boolean R
lowStockWarning Boolean R
customerOrderNotification Boolean R
truncateArticleName Boolean R
automaticBundling Boolean R
defaultTemplate Long R
automaticDailyExport Boolean R
language String R
cashInvoicePaymentWay String R
projectInvoicePaymentWay String R
defaultFortnoxVATId Long R

Support

Field Type Description Default Mandatory Accepted values Example values Access
subject String true R,W
message String true R,W

Unit

Field Type Description Default Mandatory Accepted values Example values Access
id Long R,W
externalId String R
name String Name of unit R,W

User

Field Type Description Default Mandatory Accepted values Example values Access
id Long R
customer boolean flag to indicate if user has customer privileges R
admin boolean flag to indicate if user has admin privileges R
systemAdmin boolean flag to indicate if user has system admin privileges R
name String R,W
email String R,W
phone String R,W
notes String R,W
emailInvalid boolean If this flag is set to true, Lagerkoll has detected on multiple occassions that it cannot send emails to this address R
role Role Role of the current user. Admins can update permissions on other users, but a user cannot update his own permissions R,W
lastLoggedIn Long Timestamp when this user was last logged in R
bankID Boolean If user has activated login with BankID R

UsersResponse

Field Type Description Default Mandatory Accepted values Example values Access
page int R
pages int R
pageSize int R
usersCount int R
since long R
users List R

VAT

Field Type Description Default Mandatory Accepted values Example values Access
id long R
vat double VAT value in percentage R
account int sales account R
code String vat code R
description String description of vat R
isDefault Boolean default vat R

Verification

Field Type Description Default Mandatory Accepted values Example values Access
verification String code to verify account true R,W

VerificationResponse

Field Type Description Default Mandatory Accepted values Example values Access
username String account username R,W

WebMessage

Field Type Description Default Mandatory Accepted values Example values Access
params HashMap R
action String R

WebMessagesResponse

Field Type Description Default Mandatory Accepted values Example values Access
messages List R

WebMessageStatus

Field Type Description Default Mandatory Accepted values Example values Access
action String R
responseCode int R
data WebMessage R