Get started
Integrations
Use cases
API reference
- Accounting
- Overview
- Accounts
- Async Task
- Contacts
- Customers
- Expenses
- Files
- Invoices
- Invoice Lines
- Items
- Journals
- Offers
- Offer Lines
- Projects
- Sales Orders
- Sales Order Lines
- Suppliers
- Tracking categories
- Transactions
- Authentication
- Tenant Management
- User
Create item
curl --request POST \
--url https://api.maesn.dev/accounting/items \
--header 'Content-Type: application/json' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--data '{
"name": "Item name",
"itemNumber": "12345-A",
"stockCount": "11",
"type": "PRODUCT",
"unitName": "PIECE",
"unitPurchasePrice": "10",
"unitSalesPrice": "20.5",
"priceIncludesTax": false,
"incomeAccountRef": "123",
"expenseAccountRef": "123",
"inventoryStartDate": "2021-01-01",
"assetAccountRef": "123"
}'
{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 123,
"perPage": 123,
"currentPage": 123,
"totalPages": 123
}
},
"data": {
"id": "Item id",
"name": "Item name",
"itemNumber": "12345-A",
"stockCount": "11",
"type": "PRODUCT",
"unitName": "PIECE",
"unitPurchasePrice": "10",
"unitSalesPrice": "20.5",
"priceIncludesTax": true
}
}
Test Api token:
663222ee
Test Account token:
85b30b51
Field support per integration
Please ensure the query parameters environmentName
and companyId
are accurately populated with the appropriate environment and company ID.
You can obtain these values by using the GET Environments
and GET Companies
endpoints available under the Authentication section.
Supported Request Parameters:
Available options: PRODUCT
, SERVICE
Available options: PIECE
, HOUR
, KILOGRAM
, STÜCK
Please ensure the query parameters environmentName and companyId are accurately filled with the respective environment and company id to which the item belongs.
You can obtain these values by using the GET Environments
and GET Companies
endpoints available under the Authentication section.
Please use the id field as the companyId and the environmentId field as the environmentName.
Supported Request Parameters:
Available options: PRODUCT
, SERVICE
Body
PRODUCT
, SERVICE
PIECE
, HOUR
, KILOGRAM
Response
Was this page helpful?
curl --request POST \
--url https://api.maesn.dev/accounting/items \
--header 'Content-Type: application/json' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--data '{
"name": "Item name",
"itemNumber": "12345-A",
"stockCount": "11",
"type": "PRODUCT",
"unitName": "PIECE",
"unitPurchasePrice": "10",
"unitSalesPrice": "20.5",
"priceIncludesTax": false,
"incomeAccountRef": "123",
"expenseAccountRef": "123",
"inventoryStartDate": "2021-01-01",
"assetAccountRef": "123"
}'
{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 123,
"perPage": 123,
"currentPage": 123,
"totalPages": 123
}
},
"data": {
"id": "Item id",
"name": "Item name",
"itemNumber": "12345-A",
"stockCount": "11",
"type": "PRODUCT",
"unitName": "PIECE",
"unitPurchasePrice": "10",
"unitSalesPrice": "20.5",
"priceIncludesTax": true
}
}