• API-сұратуды Postman, Insomnia, Paw, Swagger, SoapUI сияқты кез келген сервис арқылы жіберіңіз немесе сіздің есеп жүйеңізбен біріктіріңіз.  

     

     Параметр

    Мәні

    masterSku

    Kaspi.kz-тегі Магазиндегі тауар коды

    barcode

    штрихкод (8–14 таңба)

     

    Атрибут

    Мәні

    status

    күйі

    OK

    сәтті тіркелді

    ALREADY_ADDED

    штрихкод бұл тауарға қосылған

    FOUND_MULTIPLE

    НКТ базасында бұл штрихкодқа  бірнеше тауар тіркелген

    INCORRECT_BARCODE

    8-ден аз немесе 14-тен көп таңба енгізілген

    EMPTY_MASTER_SKU

    тауардың қате коды енгізілген

    NOT_FOUND

    штрихкод НКТ базасында табылмады. Оған уақытша код беріледі.

    MASTER_SKU_NOT_FOUND

    тауар коды табылған жоқ

    NON_UNIQUE_MASTER_SKU

    тауардың бірегей емес коды жіберілген

     

     
    Сұратудың үлгісін қарау

     

    https://kaspi.kz/shop/api/v2/nct

    POST /api/v2/nct

    HTTP/1.1

    Host: kaspi.kz/shop

    Content-Type: application/vnd.api+json

    X-Auth-Token:token

    {

      "items": [

        {

          "masterSku": "100039335",

          "barcode": "0745125484556"

        },

        {

          "masterSku": "128000782",

          "barcode": "4820072970485"

        },

         {

          "masterSku": "101475172",

          "barcode": "0200055613402"

        }

      ]

    }

     

     

     

    Ответ

    {

        "merchantUid": "190072",

        "items": [

            {

                "masterSku": "101475172",

                "barcode": "0200055613402",

                "status": "ALREADY_ADDED"

            },

            {

                "masterSku": "128000782",

                "barcode": "4820072970485",

                "status": "OK"

            },

            {

                "masterSku": "100039335",

                "barcode": "0745125484556",

                "status": "FOUND_MULTIPLE"

            },

            {

                "masterSku": "100039335",

                "barcode": "0200055613402",

                "status": "OK"

            }

        ]

    }

     

     

    Ответ в случае ошибки

    {

        "merchantUid": "190072",

        "items": [

            {

                "masterSku": "100039335",

                "barcode": "0745125484556",

                "status": "MASTER_SKU_NOT_FOUND"

            },

            {

                "masterSku": "128000782",

                "barcode": "0745125484556",

                "status": "MASTER_SKU_NOT_FOUND"

            },

            {

                "masterSku": "101475172",

                "barcode": "0745125484556",

                "status": "MASTER_SKU_NOT_FOUND"

            }

        ]

    }

     

    Жаңартылды 24.07.2026

    Қолданушылардың 100% жауапты пайдалы деді

    Жауап пайдалы болды ма?