Add Product Variation catalog.product.offer.add

curl -X POST \
        -H "Content-Type: application/json" \
        -H "Accept: application/json" \
        -d '{"fields":{"iblockId":27,"name":"Red T-shirt, M","parentId":7603,"active":"Y","code":"tshirt-red-m","xmlId":"tshirt-red-m","sort":100,"measure":9,"vatId":3,"vatIncluded":"Y","purchasingPrice":800,"purchasingCurrency":"EUR","quantity":25,"weight":200,"width":500,"length":700,"height":20,"previewText":"100% cotton","previewPicture":{"fileData":["tshirt-red.png","iVBORw0KGgo..."]},"property907":1603,"property891":"Red"},"auth":"**put_access_token_here**"}' \
        https://**put_your_bitrix24_address**/rest/catalog.product.offer.add
        

// This snippet is an ES module: top-level await requires type="module" or a bundler.
        // $b24 is an already-initialized SDK instance (see the SDK "Get started" guide).
        import { Text } from '@bitrix24/b24jssdk'
        import type { B24Frame, ISODate } from '@bitrix24/b24jssdk'
        
        declare const $b24: B24Frame
        
        type OfferProperty = {
          value: string
          valueId: string
          valueEnum?: string
        }
        
        type OfferFile = {
          id: string
          url: string
          urlMachine: string
        }
        
        // Shape of the offer returned in result (match the "response handling" section of the page)
        type Offer = {
          id: number
          iblockId: number
          name: string
          active: string
          code: string | null
          xmlId: string
          sort: number | null
          type: number
          available: string
          parentId: OfferProperty | null
          quantity: number | null
          purchasingPrice?: string | null
          purchasingCurrency?: string | null
          previewPicture: OfferFile | null
          detailPicture: OfferFile | null
          dateCreate: ISODate
          timestampX: ISODate
          [key: `property${number}`]: OfferProperty | OfferProperty[] | null
        }
        
        try {
          const response = await $b24.actions.v2.call.make<{ offer: Offer }>({
            method: 'catalog.product.offer.add',
            params: {
              fields: {
                iblockId: 27,
                name: 'Red T-shirt, M',
                parentId: 7603,
                active: 'Y',
                code: 'tshirt-red-m',
                xmlId: 'tshirt-red-m',
                sort: 100,
                measure: 9,
                vatId: 3,
                vatIncluded: 'Y',
                purchasingPrice: 800,
                purchasingCurrency: 'EUR',
                quantity: 25,
                weight: 200,
                width: 500,
                length: 700,
                height: 20,
                previewText: '100% cotton',
                previewPicture: {
                  fileData: ['tshirt-red.png', 'iVBORw0KGgo...'],
                },
                property907: 1603,
                property891: 'Red',
              },
            },
            requestId: Text.getUuidRfc4122()
          })
        
          // The payload is available only on a successful response
          if (!response.isSuccess) {
            console.error(response.getErrorMessages().join('; '))
          } else {
            const result = response.getData()!.result
            console.info('Added offer:', result.offer.id, result.offer.name)
          }
        } catch (error) {
          // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
          console.error(error)
        }
        

<!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
        <script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
        <script>
          async function addOffer() {
            try {
              // Initialize the SDK inside a Bitrix24 frame
              const $b24 = await B24Js.initializeB24Frame()
        
              const response = await $b24.actions.v2.call.make({
                method: 'catalog.product.offer.add',
                params: {
                      fields: {
                        iblockId: 27,
                        name: 'Red T-shirt, M',
                        parentId: 7603,
                        active: 'Y',
                        code: 'tshirt-red-m',
                        xmlId: 'tshirt-red-m',
                        sort: 100,
                        measure: 9,
                        vatId: 3,
                        vatIncluded: 'Y',
                        purchasingPrice: 800,
                        purchasingCurrency: 'EUR',
                        quantity: 25,
                        weight: 200,
                        width: 500,
                        length: 700,
                        height: 20,
                        previewText: '100% cotton',
                        previewPicture: {
                          fileData: ['tshirt-red.png', 'iVBORw0KGgo...'],
                        },
                        property907: 1603,
                        property891: 'Red',
                      },
                    },
                requestId: B24Js.Text.getUuidRfc4122()
              })
        
              // The payload is available only on a successful response
              if (!response.isSuccess) {
                console.error(response.getErrorMessages().join('; '))
                return
              }
        
              const result = response.getData().result
              console.info('Added offer:', result.offer.id, result.offer.name)
            } catch (error) {
              // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
              console.error(error)
            }
          }
        
          document.addEventListener('DOMContentLoaded', addOffer)
        </script>
        

from b24pysdk.errors import BitrixAPIError, BitrixSDKException
        
        try:
            bitrix_response = client.catalog.product.offer.add(
                fields={
                    "iblockId": 27,
                    "name": "Red T-shirt, M",
                    "parentId": 7603,
                    "active": "Y",
                    "code": "tshirt-red-m",
                    "xmlId": "tshirt-red-m",
                    "sort": 100,
                    "measure": 9,
                    "vatId": 3,
                    "vatIncluded": "Y",
                    "purchasingPrice": 800,
                    "purchasingCurrency": "EUR",
                    "quantity": 25,
                    "weight": 200,
                    "width": 500,
                    "length": 700,
                    "height": 20,
                    "previewText": "100% cotton",
                    "previewPicture": {
                        "fileData": ["tshirt-red.png", "iVBORw0KGgo..."],
                    },
                    "property907": 1603,
                    "property891": "Red",
                },
            ).response
            result = bitrix_response.result
            print(result)
        except BitrixAPIError as error:
            print(
                "Bitrix API error",
                f"error: {error.error}",
                f"error_description: {error.error_description}",
                sep="\n",
            )
        except BitrixSDKException as error:
            print(f"Bitrix SDK error: {error.message}")
        except Exception as error:
            print(f"Unexpected error: {error}")
        

try {
            $response = $b24Service
                ->core
                ->call(
                    'catalog.product.offer.add',
                    [
                        'fields' => [
                            'iblockId'           => 27,
                            'name'               => 'Red T-shirt, M',
                            'parentId'           => 7603,
                            'active'             => 'Y',
                            'code'               => 'tshirt-red-m',
                            'xmlId'              => 'tshirt-red-m',
                            'sort'               => 100,
                            'measure'            => 9,
                            'vatId'              => 3,
                            'vatIncluded'        => 'Y',
                            'purchasingPrice'    => 800,
                            'purchasingCurrency' => 'EUR',
                            'quantity'           => 25,
                            'weight'             => 200,
                            'width'              => 500,
                            'length'             => 700,
                            'height'             => 20,
                            'previewText'        => '100% cotton',
                            'previewPicture'     => [
                                'fileData' => ['tshirt-red.png', 'iVBORw0KGgo...'],
                            ],
                            'property907'        => 1603,
                            'property891'        => 'Red',
                        ],
                    ]
                );
        
            $result = $response
                ->getResponseData()
                ->getResult();
        
            print_r($result);
        } catch (Throwable $e) {
            echo $e->getMessage();
        }
        

BX24.callMethod(
            'catalog.product.offer.add',
            {
                fields: {
                    iblockId: 27,
                    name: 'Red T-shirt, M',
                    parentId: 7603,
                    active: 'Y',
                    code: 'tshirt-red-m',
                    xmlId: 'tshirt-red-m',
                    sort: 100,
                    measure: 9,
                    vatId: 3,
                    vatIncluded: 'Y',
                    purchasingPrice: 800,
                    purchasingCurrency: 'EUR',
                    quantity: 25,
                    weight: 200,
                    width: 500,
                    length: 700,
                    height: 20,
                    previewText: '100% cotton',
                    previewPicture: {
                        fileData: ['tshirt-red.png', 'iVBORw0KGgo...'],
                    },
                    property907: 1603,
                    property891: 'Red',
                },
            },
            function(result)
            {
                if (result.error())
                    console.error(result.error());
                else
                    console.log(result.data());
            }
        );
        

require_once('crest.php');
        
        $result = CRest::call(
            'catalog.product.offer.add',
            [
                'fields' => [
                    'iblockId' => 27,
                    'name' => 'Red T-shirt, M',
                    'parentId' => 7603,
                    'active' => 'Y',
                    'code' => 'tshirt-red-m',
                    'xmlId' => 'tshirt-red-m',
                    'sort' => 100,
                    'measure' => 9,
                    'vatId' => 3,
                    'vatIncluded' => 'Y',
                    'purchasingPrice' => 800,
                    'purchasingCurrency' => 'EUR',
                    'quantity' => 25,
                    'weight' => 200,
                    'width' => 500,
                    'length' => 700,
                    'height' => 20,
                    'previewText' => '100% cotton',
                    'previewPicture' => [
                        'fileData' => ['tshirt-red.png', 'iVBORw0KGgo...'],
                    ],
                    'property907' => 1603,
                    'property891' => 'Red',
                ],
            ]
        );
        
        echo '<PRE>';
        print_r($result);
        echo '</PRE>';
        

// client and ctx are already created — see the Go SDK section
        res, err := client.Core().Call(ctx, "catalog.product.offer.add", b24.Params{
        	"fields": b24.Params{
        		"iblockId":           27,
        		"name":               "Red T-shirt, M",
        		"parentId":           7603,
        		"active":             "Y",
        		"code":               "tshirt-red-m",
        		"xmlId":              "tshirt-red-m",
        		"sort":               100,
        		"measure":            9,
        		"vatId":              3,
        		"vatIncluded":        "Y",
        		"purchasingPrice":    800,
        		"purchasingCurrency": "EUR",
        		"quantity":           25,
        		"weight":             200,
        		"width":              500,
        		"length":             700,
        		"height":             20,
        		"previewText":        "100% cotton",
        		"previewPicture":     b24.Params{
        			"fileData": []string{"tshirt-red.png", "iVBORw0KGgo..."},
        		},
        		"property907":        1603,
        		"property891":        "Red",
        	},
        })
        if err != nil {
        	return fmt.Errorf("catalog.product.offer.add: %w", err)
        }
        
        // The method wraps the response in an object with the "offer" key.
        raw, ok := b24.Unwrap(res.Result, "offer")
        if !ok {
        	return fmt.Errorf("the response has no offer key")
        }
        
        // Optional fields can be null, so pointers are used for them.
        var item struct {
        	ID              b24.ID   `json:"id"`
        	IblockID        int      `json:"iblockId"`
        	Name            string   `json:"name"`
        	Active          string   `json:"active"`
        	Code            *string  `json:"code"`
        	Sort            *int     `json:"sort"`
        	Type            int      `json:"type"`
        	Quantity        *float64 `json:"quantity"`
        	PurchasingPrice *string  `json:"purchasingPrice"`
        	ParentID        *struct {
        		Value   string `json:"value"`
        		ValueID string `json:"valueId"`
        	} `json:"parentId"`
        	PreviewPicture *struct {
        		ID  string `json:"id"`
        		URL string `json:"url"`
        	} `json:"previewPicture"`
        }
        if err := json.Unmarshal(raw, &item); err != nil {
        	return fmt.Errorf("parse response: %w", err)
        }
        fmt.Println(item.ID, item.Name)