Invoices API
General:
Basics:
Base-URL: https://capi.lagerkoll.com/v1/invoices/
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.
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.
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 |
901801 | Error when getting invoice draft |
901802 | Error when adding invoice draft |
901803 | Error when updating invoice draft |
901804 | Error when deleting invoice draft |
901805 | Error when invoicing draft |
{ "errorCode" : 900101, "errorMessage" : "Something went wrong on the server", "errorField" : null, "errorData" : null }
Invoices API:
Invoice drafts
Get invoice drafts
GETUrl: /drafts
Headers:
Accept: application/json or application/xml
Get a list of invoice drafts
Valid parameters:
Parameter | Description | Default value | Allowed values |
---|---|---|---|
query | |||
type | ALL | ALL, PROJECT, CUSTOMER_ORDER | |
return_invoiced_rows | true | ||
page | 0 | ||
limit | 100 | ||
sort_column | created | type, article_id, article_name, user, created | |
sort_order | desc | asc,desc |
Body:
Successfull response:
{ "invoiceDrafts": [{ "createdByName": "createdByName", "amount": 7600.030470339255, "articleName": "articleName", "pricelistId": 4572, "endDate": 1752610479089, "rentalAmount": 5524.0710042986175, "created": 1752610479089, "dataType": "dataType", "articleId": "articleId", "isInvoiced": false, "rentalCurrency": "rentalCurrency", "dataId": 5186, "price": 7189.811207661224, "isProcessed": false, "dataArticleId": 6254, "currency": "currency", "comment": "comment", "invoiceId": "invoiceId", "id": 2872, "startDate": 1752610479089, "createdById": 143 }], "ordersCount": 9484, "pages": 3860, "pageSize": 6406, "page": 1887 }
Create invoice draft
POSTUrl: /drafts/customer_order/{order_id}
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Create invoice drafts for articles in customer order
Body:
Successfull response:
{ "invoiceDrafts": [{ "createdByName": "createdByName", "amount": 4641.079849143609, "articleName": "articleName", "pricelistId": 9095, "endDate": 1752610479090, "rentalAmount": 1174.300159965902, "created": 1752610479090, "dataType": "dataType", "articleId": "articleId", "isInvoiced": false, "rentalCurrency": "rentalCurrency", "dataId": 3816, "price": 4529.699365367129, "isProcessed": false, "dataArticleId": 542, "currency": "currency", "comment": "comment", "invoiceId": "invoiceId", "id": 9466, "startDate": 1752610479090, "createdById": 7420 }], "ordersCount": 2623, "pages": 7719, "pageSize": 5524, "page": 2888 }
Invoice drafts
PUTUrl: /drafts/invoice
Headers:
Accept: application/json or application/xml
Content-type: application/json or application/xml
Content-type: application/json or application/xml
Send existing invoice drafts to external integrations and sets the draft to invoiced
Body:
{ "type": "type", "invoiceDraftIds": [{}] }
Successfull response:
{ "invoiceDrafts": [{ "createdByName": "createdByName", "amount": 6945.737618660365, "articleName": "articleName", "pricelistId": 8872, "endDate": 1752610479090, "rentalAmount": 8660.176217940834, "created": 1752610479090, "dataType": "dataType", "articleId": "articleId", "isInvoiced": true, "rentalCurrency": "rentalCurrency", "dataId": 7831, "price": 1130.354800377682, "isProcessed": false, "dataArticleId": 7995, "currency": "currency", "comment": "comment", "invoiceId": "invoiceId", "id": 3233, "startDate": 1752610479090, "createdById": 4852 }], "articles": [{ "articleName": "articleName", "snId": "snId", "invoicedAmount": 8537.024448115792, "batchSnBestBefore": 7580, "accountName": "accountName", "articleId": "articleId", "priceListId": 5296, "purchasePrice": 3803.860623157155, "batchId": "batchId", "rental": false, "rentalCurrency": "rentalCurrency", "accountId": 558, "checkoutDate": 3138, "price": 5571.618638784618, "comment": "comment", "id": 2718, "projectId": 4136, "checkoutAmount": 959.2594718829439, "events": [{ "date": 1752610479090, "amount": 8846.882953221117, "type": "type" }], "checkinConsumeDate": 1752610479090, "checkinAmount": 1462.7586817560311, "consumedAmount": 6852.077955442913 }] }
Classes:
InvoiceDraftDto
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
id | long | R | |||||
dataType | String | R | |||||
dataId | Long | R | |||||
dataArticleId | Long | R | |||||
articleId | String | R | |||||
articleName | String | R | |||||
amount | Double | R | |||||
price | Double | R | |||||
pricelistId | long | R | |||||
currency | String | R | |||||
rentalCurrency | String | R | |||||
startDate | Date | R | |||||
endDate | Date | R | |||||
rentalAmount | Double | R | |||||
comment | String | R | |||||
isInvoiced | boolean | Indicates if row has been marked as invoiced | R | ||||
isProcessed | boolean | Indicates if row has been completely processed as invoiced | R | ||||
invoiceId | String | If row has been invoiced, this is id of the created invoice | R | ||||
createdById | Long | R | |||||
createdByName | String | R | |||||
created | Date | R |
InvoiceDraftIdsRequestDto
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
invoiceDraftIds | List | R,W | |||||
type | String | invoice, cash, card, ag | R |
InvoiceDraftsResponseDto
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
page | int | R | |||||
pages | int | R | |||||
pageSize | int | R | |||||
ordersCount | int | R | |||||
invoiceDrafts | List | R |
InvoiceProjectArticlesResponseDto
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
articles | List | R | |||||
invoiceDrafts | List | R |
ProjectArticleDto
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
id | long | R,W | |||||
projectId | long | R,W | |||||
articleId | String | R,W | |||||
articleName | String | R,W | |||||
batchId | String | R,W | |||||
snId | String | R,W | |||||
batchSnBestBefore | Long | R,W | |||||
checkoutAmount | Double | R,W | |||||
checkinAmount | Double | R,W | |||||
consumedAmount | Double | R,W | |||||
invoicedAmount | Double | R,W | |||||
priceListId | long | R,W | |||||
rental | boolean | R,W | |||||
price | double | R,W | |||||
rentalCurrency | String | R,W | |||||
comment | String | R,W | |||||
purchasePrice | Double | R,W | |||||
events | List | R,W | |||||
accountId | long | R,W | |||||
accountName | String | R,W | |||||
checkoutDate | Long | R,W | |||||
checkinConsumeDate | Date | R,W |
ProjectArticleEventDto
Field | Type | Description | Default | Mandatory | Accepted values | Example values | Access |
---|---|---|---|---|---|---|---|
type | String | R,W | |||||
amount | double | R,W | |||||
date | Date | R,W |