Update SKU

Definition

https://sandbox.bluesnap.com/services/2/catalog/skus/:sku-id

Documentation

The Update SKU request enables you to update the settings of an existing SKU (contract) in your account.

Request Content

catalog-sku    required, contains the following properties (see catalog-sku):
     contract-name string    optional
     product-id long    required
     sku-status string    optional
     sku-type string    required
     pricing-settings container    required (see pricing-settings)
     sku-image string    optional
     sku-quantity-policy container    optional (see sku-quantity-policy)
     collect-shipping-address boolean    optional
     sku-effective-dates container    optional (see sku-effective-dates)
     sku-coupon-settings container    optional (see sku-coupon-settings)
     sku-custom-parameters container    optional (see sku-custom-parameters)

Response Details

If successful, the response HTTP status code is 204 No Content.
There is no content in the response body.
For details about possible errors, see: General Errors and Catalog Errors.

Examples

Request Examples

curl -v -X PUT https://sandbox.bluesnap.com/services/2/catalog/skus/307634 \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<catalog-sku xmlns="http://ws.plimus.com">
  <product-id>307634</product-id>
  <sku-type>DIGITAL</sku-type>
  <pricing-settings>
    <charge-policy-type>ONE TIME PAYMENT</charge-policy-type>
    <charge-policy>
      <one-time-charge>
        <catalog-prices>
          <catalog-price>
            <base-price>true</base-price>
            <currency>USD</currency>
            <amount>100.00</amount>
          </catalog-price>
        </catalog-prices>
      </one-time-charge>
    </charge-policy>
  </pricing-settings>
</catalog-sku>'

curl -v -X PUT https://sandbox.bluesnap.com/services/2/catalog/skus/2181160 \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<catalog-sku xmlns="http://ws.plimus.com">
  <product-id>307634</product-id>
  <sku-type>DIGITAL</sku-type>
  <pricing-settings>
    <charge-policy-type>STANDARD SUBSCRIPTION</charge-policy-type>
    <charge-policy>
      <recurring-period>
        <catalog-prices>
          <catalog-price>
            <base-price>true</base-price>
            <currency>USD</currency>
            <amount>10.00</amount>
          </catalog-price>
        </catalog-prices>
        <period-frequency>DAILY</period-frequency>
      </recurring-period>
    </charge-policy>
    <recurring-plan-settings />
  </pricing-settings>
</catalog-sku>'

curl -v -X PUT https://sandbox.bluesnap.com/services/2/catalog/skus/2181160 \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<catalog-sku xmlns="http://ws.plimus.com">
   <sku-name>new CRUD API product Standard monthly SUB - base currency USD</sku-name>
   <contract-name>Standard monthly SUB - base currency USD</contract-name>
   <product-id>307634</product-id>
   <sku-status>D</sku-status>
   <sku-type>DIGITAL</sku-type>
   <pricing-settings>
      <charge-policy-type>STANDARD SUBSCRIPTION</charge-policy-type>
      <charge-policy>
         <recurring-period>
            <catalog-prices>
               <catalog-price>
                  <base-price>true</base-price>
                  <currency>USD</currency>
                  <amount>10.00</amount>
               </catalog-price>
            </catalog-prices>
            <period-frequency>DAILY</period-frequency>
         </recurring-period>
      </charge-policy>
      <recurring-plan-settings>
         <charge-upon-plan-change>false</charge-upon-plan-change>
         <grace-period-length>99999</grace-period-length>
         <plan-charge-amount-limit>
            <currency>USD</currency>
            <amount>10.00</amount>
         </plan-charge-amount-limit>
      </recurring-plan-settings>
   </pricing-settings>
</catalog-sku>'

Response Examples

HTTP/ 1.1 204 No Content

Example Descriptions

Update SKU: change SKU settings (one-time charge or subscription)

This example shows how to update product settings. Simply include the fields that you want to update in the request, with the new values.

Update SKU: delete SKU

This example shows how to delete a SKU by entering D in the sku-status field.