Update a charge

PUT /api/v1/charge/{uuid}

Headers

  • X-PLANNR-ACCOUNT-UUID string

Path parameters

  • uuid string Required
application/json

Body Required

  • seller_uuid string

    Employee that will be earning the revenue for this charge

  • payment_origin string

    Who is expected to pay this charge. Possible values are: client, provider and unknown

  • type string

    Expectation type. Possible values are: fee and commission

  • category string

    Expectation category. Possible values are: adhoc, administration, adjustment, bond_renewal, clawback, dss_rebate, fund, indemnity, initial_fee, level, non_indemnity, one_off, ongoing_fee, other_fee, procuration_fee, protected_rights, renewal, switch and unknown

  • recurring string

    Whether or not this charge recurring on a frequent basis

  • frequency string

    Expected charge frequency from the given start date. Valid frequencies are: daily, weekly, fortnightly, four_weekly, monthly, bimonthly, quarterly, biannually, and annually

  • start_date date

    Date the recurring charge starts from.

  • end_date date

    Date the recurring statement transactions will stop. Leave blank for indefinitely or until charge schedule is deleted.

  • amount integer

    The fixed amount value as an integer in pennies. Required when not providing a percentage or when chargeable_type is client.

  • percentage number

    Percentage of plans value as a charge. Required when not providing a fixed amount. Cannot use percentage for a client chargeable_type.

  • percentage_frequency string

    Frequency that describes what the percentage is calculated from. Valid frequencies are: daily, weekly, fortnightly, four_weekly, monthly, bimonthly, quarterly, biannually, and annually

  • tax_exempt boolean

    Denotes whether the charge is exempt from tax.

  • tax number Required

    Percentage tax to be added on to net amount of charge. Will use fims default tax rate if not provided and charge is not tax exempt.

  • exclude_from_rmar string

    Whether or not to exclude this charge and its expectations from RMAR reporting.

  • advice_type string

    Advice type for the charge. Possible values are: independent and restricted

  • service_type string

    Service type for the charge. Possible values are: initial, one_off and ongoing. Recurring charges must be "ongoing"

  • rmar_type string

    RMAR type for the charge. Can only be set for adjustments and unknown charge categories. All other categories are automatically calculated. Possible values are: adviser_charge, clawback, commission, other_fee and unknown. Recurring charges must be "ongoing"

  • advice_area array[string]

    RMAR advice area values. All advice types are required when updating amounts or advice area amounts for charges made directly on a client. All amounts are in pennies and must total the charge net amount.

PUT /api/v1/charge/{uuid}
curl \
 --request PUT 'https://api.plannrcrm.com/api/v1/charge/6ff8f7f6-1eb3-3525-be4a-3932c805afed' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}" \
 --data '{"seller_uuid":"ac3db946-3271-4748-bf4e-6ffde63fd602","payment_origin":"provider","type":"fee","category":"commission","recurring":"1","frequency":"monthly","start_date":"2025-03-26","end_date":"2026-04-26","amount":10000,"percentage":0.75,"percentage_frequency":"annually","tax_exempt":true,"tax":0.0,"exclude_from_rmar":"string","advice_type":"independent","service_type":"ongoing","rmar_type":"adviser_charge","advice_area":[{"deposit":7500,"unknown":0,"non_rmar":0,"non_regulated":0,"retail_investment":0,"regulated_mortgage":2500,"other_fca_regulated":0,"non_investment_insurance":0}]}'
Request examples
# Headers
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}

# Payload
{
  "seller_uuid": "ac3db946-3271-4748-bf4e-6ffde63fd602",
  "payment_origin": "provider",
  "type": "fee",
  "category": "commission",
  "recurring": "1",
  "frequency": "monthly",
  "start_date": "2025-03-26",
  "end_date": "2026-04-26",
  "amount": 10000,
  "percentage": 0.75,
  "percentage_frequency": "annually",
  "tax_exempt": true,
  "tax": 0.0,
  "exclude_from_rmar": "string",
  "advice_type": "independent",
  "service_type": "ongoing",
  "rmar_type": "adviser_charge",
  "advice_area": [
    {
      "deposit": 7500,
      "unknown": 0,
      "non_rmar": 0,
      "non_regulated": 0,
      "retail_investment": 0,
      "regulated_mortgage": 2500,
      "other_fca_regulated": 0,
      "non_investment_insurance": 0
    }
  ]
}