Update a charge

PUT /api/v1/charge/{uuid}

Path parameters

application/json

Body

  • 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.

  • tax_exempt boolean

    Denotes whether the charge is exempt from tax.

  • 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 \
 -X PUT https://api.plannrcrm.com/api/v1/charge/uuid \
 -H "Authorization: Bearer {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}" \
 -H "Content-Type: application/json" \
 -H "Accept: application/json" \
 -H "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}" \
 -d '{"seller_uuid":"a1069cbc-88dc-4b61-ae90-ea64d5b332a4","payment_origin":"provider","type":"fee","category":"commission","recurring":"1","frequency":"monthly","start_date":"2024-08-20","end_date":"2025-09-20","amount":10000,"percentage":0.75,"tax_exempt":true,"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
Authorization: Bearer {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}
Content-Type: application/json
Accept: application/json
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}

# Payload
{
  "seller_uuid": "a1069cbc-88dc-4b61-ae90-ea64d5b332a4",
  "payment_origin": "provider",
  "type": "fee",
  "category": "commission",
  "recurring": "1",
  "frequency": "monthly",
  "start_date": "2024-08-20",
  "end_date": "2025-09-20",
  "amount": 10000,
  "percentage": 0.75,
  "tax_exempt": true,
  "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
    }
  ]
}