Update a product | Solvimon

Requires the PRODUCT.UPDATE permission.

Authentication

X-API-KEYstring

API Key authentication via header

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

versionstringRequiredDefaults to 1

version

resourceIdOrReferencestringRequiredDefaults to

The ID of the resource for which the action is posted.

Query parameters

align_product_item_statusbooleanOptional

Updates the status of product items to the status of the Product, e.g. if theDD Product is Activated, the product items are activated

Request

This endpoint expects an object.

category_idstringRequired

The resource ID of the product category, that belongs to the product.

namestringRequiredformat: "^.*$"0-256 characters

referencestringRequiredformat: "^\S+$"0-256 characters

product_typeenumRequired

Allowed values:

categoryobject or nullOptional

parent_product_idstring or nullOptional

The resource ID of the original product, to which the product will belong to.

descriptionstring or nullOptionalformat: "^.*$"0-256 characters

statusenum or nullOptional

The status of the product.

Allowed values:

tax_categoryenum or nullOptional

The default tax category applied to the product.

Allowed values:

featureslist of objects or nullOptional

The features associated with the product.

custom_fieldslist of objects or nullOptional

display_orderinteger or nullOptional

Determines the order in which products are displayed on overview pages and invoices. The lowest number gets the highest priority.

linked_integrationslist of objects or nullOptional

billing_entity_idstring or nullOptional

The resource ID of the billing entity linked to this product.

Response

category_idstring

The resource ID of the product category, that belongs to the product.

namestringformat: "^.*$"0-256 characters

referencestringformat: "^\S+$"0-256 characters

product_typeenum

Allowed values:

object_typestring or nullRead-only

idstring or nullRead-only

categoryobject or null

parent_product_idstring or null

The resource ID of the original product, to which the product will belong to.

descriptionstring or nullformat: "^.*$"0-256 characters

statusenum or null

The status of the product.

Allowed values:

tax_categoryenum or null

The default tax category applied to the product.

Allowed values:

featureslist of objects or null

The features associated with the product.

custom_fieldslist of objects or null

display_orderinteger or null

Determines the order in which products are displayed on overview pages and invoices. The lowest number gets the highest priority.

linked_integrationslist of objects or null

billing_entity_idstring or null

The resource ID of the billing entity linked to this product.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error

1	curl -X PATCH https://test.api.solvimon.com/v1/products/ \
2	-H "X-API-KEY: <apiKey>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"category_id": "proc_iwDeeN0tvaMQ3nAies1C",
6	"name": "Receipt Scanning",
7	"reference": "receipt-scanning-2024",
8	"product_type": "DEFAULT",
9	"description": "Giving customer employees the possibility to scan receipts.",
10	"status": "ACTIVE",
11	"tax_category": "STANDARD",
12	"display_order": 1
13	}'

1	{
2	"category_id": "proc_iwDeeN0tvaMQ3nAies1C",
3	"name": "Receipt Scanning",
4	"reference": "receipt-scanning-2024",
5	"product_type": "DEFAULT",
6	"object_type": "product",
7	"id": "prod_9f8b7c6d5e4a3b2c1d0e",
8	"category": {
9	"name": "Document Services",
10	"reference": "doc-services",
11	"object_type": "product_category",
12	"id": "cat_4a3b2c1d0e9f8b7c6d5e",
13	"description": "Services related to document processing and management.",
14	"tax_category": "STANDARD",
15	"display_order": 2
16	},
17	"parent_product_id": "prod_1234567890abcdef1234",
18	"description": "Giving customer employees the possibility to scan receipts.",
19	"status": "ACTIVE",
20	"tax_category": "STANDARD",
21	"features": [
22	{
23	"reference": "optical-character-recognition",
24	"id": "feat_00112233445566778899"
25	}
26	],
27	"custom_fields": [
28	{
29	"id": "cf_99887766554433221100",
30	"reference": "scan-resolution",
31	"value": "300dpi",
32	"values": [
33	"150dpi",
34	"300dpi",
35	"600dpi"
36	],
37	"integration_details": {
38	"payment_gateway_variant": "ADYEN",
39	"id": "int_abcdef1234567890abcd",
40	"reference": "payment-gateway-integration",
41	"adyen": {
42	"recurring_detail_reference": "recurring_adyen_001"
43	},
44	"stripe": {
45	"payment_method_id": "pm_1GqIC8Lz0qyl6XeWzXxYzZbA"
46	}
47	}
48	}
49	],
50	"display_order": 1,
51	"linked_integrations": [
52	{
53	"id": "link_123abc456def789ghi012",
54	"link_details": [
55	{
56	"url": "https://integration.example.com/receipt-scanning",
57	"custom_field_name": "integration_endpoint"
58	}
59	]
60	}
61	],
62	"billing_entity_id": "bill_ent_789xyz456uvw123rst"
63	}

Authentication

Path parameters

Headers

Query parameters

Request

Response

Errors