Validate product rows before import

POST

/api/v1/core/products/import/preview

Roles: staff, tenant_admin, super_admin. Max 500 rows.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Preview result per row

Bodyapplication/json

🟠400ValidationError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/core/products/import/preview' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "rows": [
        {
            "rowIndex": 0,
            "productCode": "string",
            "productName": "string",
            "typeId": "Goods",
            "unitName": "string",
            "price": 0,
            "vatTypeId": "VAT",
            "whtTypeId": "1",
            "description": "string"
        }
    ]
}'

Response Example

200 - Example 1

{
    "success": true,
    "error": null,
    "data": {
        "rows": [
            {
                "rowIndex": 0,
                "status": "valid",
                "errors": [
                    "string"
                ],
                "existingProductId": "string"
            }
        ],
        "summary": {
            "valid": 0,
            "duplicate": 0,
            "error": 0
        }
    }
}

Modified at 2026-06-18 10:47:09

Download product Excel import template

Commit validated product rows to database