Create a product | Solvimon

curl -X POST https://test.api.solvimon.com/v1/products \
     -H "X-API-KEY: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "category_id": "proc_iwDeeN0tvaMQ3nAies1C",
  "name": "Receipt Scanning",
  "reference": "receipt_scanning_001",
  "product_type": "DEFAULT",
  "description": "Giving customer employees the possibility to scan receipts.",
  "tax_category": "STANDARD"
}'

{
  "category_id": "proc_iwDeeN0tvaMQ3nAies1C",
  "name": "Receipt Scanning",
  "reference": "receipt_scanning_001",
  "product_type": "DEFAULT",
  "object_type": "PRODUCT",
  "id": "prod_9f8b7c6d5e4a3b2c1d0e",
  "category": {
    "name": "Document Services",
    "reference": "doc_services",
    "object_type": "PRODUCT_CATEGORY",
    "id": "proc_iwDeeN0tvaMQ3nAies1C",
    "description": "Services related to document processing and management.",
    "tax_category": "STANDARD",
    "display_order": 10
  },
  "parent_product_id": "prod_1234567890abcdef1234",
  "description": "Giving customer employees the possibility to scan receipts.",
  "status": "ACTIVE",
  "tax_category": "STANDARD",
  "features": [
    {
      "reference": "optical_character_recognition",
      "id": "feat_abc123def456"
    }
  ],
  "custom_fields": [
    {
      "id": "cf_001122334455",
      "reference": "scan_quality",
      "value": "high",
      "values": [
        "low",
        "medium",
        "high"
      ],
      "integration_details": {
        "payment_gateway_variant": "ADYEN",
        "id": "int_7890abcd1234",
        "reference": "payment_gateway_integration",
        "adyen": {
          "recurring_detail_reference": "recurring_adyen_001"
        },
        "stripe": {
          "payment_method_id": "pm_1GqIC8Lz0qyl6XeWzXxYz123"
        }
      }
    }
  ],
  "display_order": 5,
  "linked_integrations": [
    {
      "id": "int_5678efgh9012",
      "link_details": [
        {
          "url": "https://integration.example.com/receipt_scanning",
          "custom_field_name": "integration_endpoint"
        }
      ]
    }
  ],
  "billing_entity_id": "bill_ent_3344556677"
}

Requires the PRODUCT.CREATE 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

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

Created

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

409

Conflict Error

500

Internal Server Error

Authentication

Path parameters

Headers

Request

Response

Errors