Create Product

  • Through this service; You can sell your products in Modanisa.
  • One product must be sent for each request.
  • Color is required for product attribute.
  • Size or number must be entered for the Variant attribute.
  • Each color of the products must be sent as a separate item.
  • Each color of the products must be sent as a separate item.
  • For cosmetics category products, it is possible to send volume as an attribute. It is not mandatory. The corresponding attribute_id value is 14.
  • If you have the weight information of your products, it should be sent.
    • POST https://marketplace-stg.modanisa.com/api/marketplace/create-product
    Parameter Explanation Data Type Compulsory
    product_id Product code (minimum 2 , maximum 50 characters) string Yes
    product_name Product name (minimum 10 , maximum 255 characters) string Yes
    description Product description string Yes
    brand_id Brand ID taken from Modanisa service integer Yes
    category_id Brand ID taken from Modanisa service integer Yes
    origin_country_id Origin country ID from Modanisa service integer Yes
    stock_code Stock code string Yes
    tax_rate VAT information (must be one of the values 8, 18 and values from Tax Rates service should be used) integer Yes
    season_id Season id taken from Modanisa service integer Yes
    Fabric information array-list Yes
    Parameter Explanation Data Type Compulsory
    fabric_id Fabric id purchased from Modanisa service integer Yes
    percentage Percentage of Fabric ( no more than 100 ) integer Yes
    Mannequin information array-list No
    Parameter Explanation Data Type Compulsory
    size Body size string Yes
    waist Waist size (cm) integer Yes
    length Height (cm) integer Yes
    hip Hip size (cm) integer Yes
    chest Chest size (cm) integer Yes
    Images array-list Yes
    Parameter Explanation Data Type Compulsory
    url Visual link (must have http or https protocol and one of jpg, jpeg or png extensions). Visual dimensions should be at least 800(w) x 1080(h) px and in vertical format. string Yes
    Product breakdowns array-list Yes
    Parameter Explanation Data Type Compulsory
    variant_id Refraction id string Yes
    barcode Barcode (must not contain Turkish and special characters) string Yes
    Refractive characteristics array-list Yes

    The variant should be added according to the variant property of the category.

    Parameter Explanation Data Type Compulsory
    attribute_id Breakdown feature taken from Modanisa service integer Yes
    attribute_value_id Breakdown feature value taken from Modanisa service integer Yes
    Alternative barcodes array-list No
    Parameter Explanation Data Type Compulsory
    barcode Barcode (Turkish and must not contain special characters ) string Yes
    Product features array-list Yes

    Only color is required, other properties are not.

    Parameter Explanation Data Type Compulsory
    attribute_id Product feature taken from Modanisa service integer Yes
    attribute_value_id Product attribute value received from Modanisa service integer Yes
    weight Product weight (kilogram - For example, 0.05 should be sent for 50 grams) float No
    Request:
    {
    "product_id": "ID123",
    "product_name": "Siyah Spor Ayakkabı",
    "description": "Konforlu siyah spor ayakkabı ile ayaklarınız artık çok rahat",
    "brand_id": 2018,
    "category_id": 1269,
    "origin_country_id": 220,
    "stock_code": "123ASD",
    "tax_rate": 18,
    "season_id": 98,
    "weight":0.05,
    "fabrics": [
        {
            "fabric_id": 3,
            "percentage": 50
        },
        {
            "fabric_id": 18,
            "percentage": 50
        }
    ],
    "models": [
        {
            "size": 38,
            "waist": 62,
            "length": 212,
            "hip": 92,
            "chest": 87
        }
    ],
    "images": [
        {
            "url": "https://www.image.png"
        },
        {
            "url": "http://www.image-2.jpg"
        }
    ],
    "variants": [
        {
            "variant_id": "12345",
            "barcode": "BARCODE1",
            "attributes": [
                {
                    "attribute_id": 34,
                    "attribute_value_id": 705
                }
            ],
            "alternative_barcodes": [
                {
                    "barcode": "ABARCODE1"
                },
                {
                    "barcode": "ABARCODE2"
                }
            ]
        },
        {
            "variant_id": "12345678",
            "barcode": "BARCODE2",
            "attributes": [
                {
                    "attribute_id": 34,
                    "attribute_value_id": 1319
                }
            ]
        }
    ],
    "attributes": [
        {
            "attribute_id": 23,
            "attribute_value_id": 363
        },
        {
            "attribute_id": 46,
            "attribute_value_id": 630
        }
    ]
}
    Success Response:
    {
    "success": true,
    "data": {
        "message": "Product is Saved",
        "request_id": 719655
    },
    "errors": null
}
    Answer Parameters:
    Parameter Explanation
    request_id The tracking code given to query the product
    Error Message If Product Already Exists:
    {
    "success": false,
    "data": [],
    "errors": "This Product Already Exists. You can only update the product!"
}
    Product Create Failed Error Message:
    {
    "success": false,
    "data": [],
    "errors": "Product is Not Saved"
}