Pricing

Update customiser pricing

Copy page

Replace all pricing configuration for a customiser.

PUT /api/v2/customisers/{customiser}/pricing

Update customiser pricing

Replace all pricing configuration for a customiser.

Update customiser pricing

Authorisation

Bearer token required. Include in the Authorization header.

Path parameters

customiser string path required

The customiser ID.

Example: 1

Request body

pricing object body

Request body example

{
  "pricing": {
    "pricing_model": "FIXED_WIDTH",
    "sizes": [
      {
        "size_id": 1,
        "client_key": "small",
        "name": "Small",
        "description": "Up to 50cm wide",
        "sort_order": 1,
        "char_limit": 20,
        "line_limit": 3,
        "min_char": 1,
        "width_cm": 50,
        "line_height_cm": 12,
        "height_strategy": "WIDTH"
      }
    ],
    "base_pricing": {
      "mode": "included_in_price_lists",
      "rows": [
        {
          "size_id": 1,
          "base_price": {
            "line_1": 1000,
            "line_2": 1200,
            "line_3": 1400
          },
          "width_limit_cm": 100,
          "height_limit_cm": 50
        }
      ]
    },
    "price_lists": [
      {
        "pricing_id": 10,
        "name": "Standard",
        "letter_pricing_method": "material_length",
        "shipping": {
          "calculation": "physical",
          "add_weight_to_product": false
        },
        "rows": [
          {
            "size_id": 1,
            "base_price": {
              "line_1": 1000,
              "line_2": 1200,
              "line_3": 1400
            },
            "letter_price": {
              "line_1": 100,
              "line_2": 120,
              "line_3": 140
            },
            "price_per_cm": 0.5,
            "max_price_multiplier": 3,
            "width_limit_cm": 100,
            "height_limit_cm": 50,
            "price_per_sq_cm": 0.05,
            "width_modifier": 1,
            "height_modifier": 1,
            "length_modifier": 1
          }
        ]
      }
    ]
  }
}

Update customiser pricing

curl https://web.signcustomiser.com/api/v2/customisers/1/pricing \
  --request PUT \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "pricing": {
    "pricing_model": "FIXED_WIDTH",
    "sizes": [
      {
        "size_id": 1,
        "client_key": "small",
        "name": "Small",
        "description": "Up to 50cm wide",
        "sort_order": 1,
        "char_limit": 20,
        "line_limit": 3,
        "min_char": 1,
        "width_cm": 50,
        "line_height_cm": 12,
        "height_strategy": "WIDTH"
      }
    ],
    "base_pricing": {
      "mode": "included_in_price_lists",
      "rows": [
        {
          "size_id": 1,
          "base_price": {
            "line_1": 1000,
            "line_2": 1200,
            "line_3": 1400
          },
          "width_limit_cm": 100,
          "height_limit_cm": 50
        }
      ]
    },
    "price_lists": [
      {
        "pricing_id": 10,
        "name": "Standard",
        "letter_pricing_method": "material_length",
        "shipping": {
          "calculation": "physical",
          "add_weight_to_product": false
        },
        "rows": [
          {
            "size_id": 1,
            "base_price": {
              "line_1": 1000,
              "line_2": 1200,
              "line_3": 1400
            },
            "letter_price": {
              "line_1": 100,
              "line_2": 120,
              "line_3": 140
            },
            "price_per_cm": 0.5,
            "max_price_multiplier": 3,
            "width_limit_cm": 100,
            "height_limit_cm": 50,
            "price_per_sq_cm": 0.05,
            "width_modifier": 1,
            "height_modifier": 1,
            "length_modifier": 1
          }
        ]
      }
    ]
  }
}'

{
  "pricing": {
    "customiser_id": 1,
    "pricing_model": "FIXED_WIDTH",
    "value_units": {
      "base_price": "minor_currency_units",
      "letter_price": "minor_currency_units",
      "price_per_letter": "minor_currency_units",
      "price_per_cm": "currency_units_per_cm",
      "price_per_sq_cm": "currency_units_per_sq_cm_or_weight_unit"
    },
    "sizes": [],
    "base_pricing": {
      "mode": "included_in_price_lists",
      "rows": []
    },
    "price_lists": []
  }
}