Data Import REST API Changelog
This page shows recent changes to Data Import REST API.
31 July 2026 - Latest
New
{
"x-enum-descriptions": {
"promo_25_test_tc": "PROMO TEST TOPC"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"PROMO TEST TOPC": "PROMO TEST TOPC"
}
}Old
{
"x-enum-descriptions": {}
}30 July 2026
New
{
"x-enum-descriptions": {
"lg": "Large Gas, non-commercial elec"
}
}Old
{
"x-enum-descriptions": {
"lg": "Large Gas"
}
}New
{
"x-enum-descriptions": {
"Large Gas, non-commercial elec": "Large Gas, non-commercial elec"
}
}Old
{
"x-enum-descriptions": {
"Large Gas": "Large Gas"
}
}New
{
"x-enum-descriptions": {
"SB_PREPAY_DEBT_ADJUSTMENT": "SB_PREPAY_DEBT_ADJUSTMENT",
"RESI_PREPAY_DEBT_ADJUSTMENT": "RESI_PREPAY_DEBT_ADJUSTMENT"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"SB_PREPAY_DEBT_ADJUSTMENT": "SB_PREPAY_DEBT_ADJUSTMENT",
"RESI_PREPAY_DEBT_ADJUSTMENT": "RESI_PREPAY_DEBT_ADJUSTMENT"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"lg": "Large Gas"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Large Gas": "Large Gas"
}
}Old
{
"x-enum-descriptions": {}
}27 July 2026
New
{
"x-enum-descriptions": {
"spc_in_progress": "Class/MRF Change in Progress"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Class/MRF Change in Progress": "Class/MRF Change in Progress"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"solar_shift_v3_email2": "Solar Shift V3 Send 2"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Solar Shift V3 Send 2": "Solar Shift V3 Send 2"
}
}Old
{
"x-enum-descriptions": {}
}24 July 2026
New
{
"x-enum-descriptions": {
"SWEB": "EDF Energy Customers Ltd (SWEB)"
}
}Old
{
"x-enum-descriptions": {}
}22 July 2026
New
{
"x-validators": [
{
"name": "Validate that each child has a unique combination of values for the <code>\u2068payment_date, payment_type\u2069</code> fields",
"description": "Validate that each child has a unique combination of values for the <code>\u2068payment_date, payment_type\u2069</code> fields.",
"possible_errors": [
"children_with_duplicate_values"
]
}
]
}Old
{
"x-validators": [
{
"name": "Validate that each child has unique values for the <code>\u2068payment_date\u2069</code> field",
"description": "Validate that each child has unique values for the <code>\u2068payment_date\u2069</code> field.",
"possible_errors": [
"children_with_duplicate_values"
]
}
]
}New
{
"x-enum-descriptions": {
"e7_low_night_legacy": "E7 Low Night Usage Legacy",
"e7_low_night_smart_v2": "E7 Low Night Usage Smart v2"
}
}Old
{
"x-enum-descriptions": {
"e7_low_night": "Economy 7 Low Night Usage"
}
}New
{
"x-enum-descriptions": {
"E7 Low Night Usage Legacy": "E7 Low Night Usage Legacy",
"E7 Low Night Usage Smart v2": "E7 Low Night Usage Smart v2"
}
}Old
{
"x-enum-descriptions": {
"Economy 7 Low Night Usage": "Economy 7 Low Night Usage"
}
}New
{
"x-enum-descriptions": {
"e7_low_night": "Economy 7 Low Night Usage"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Economy 7 Low Night Usage": "Economy 7 Low Night Usage"
}
}Old
{
"x-enum-descriptions": {}
}21 July 2026
No attributes to display
New
{
"x-enum-descriptions": {
"SBEXTRANEWACQ75": "SBEXTRANEWACQ75"
}
}Old
{
"x-enum-descriptions": {}
}20 July 2026
New
{
"x-enum-descriptions": {
"naa": "NAA"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"NAA": "NAA"
}
}Old
{
"x-enum-descriptions": {}
}17 July 2026
No attributes to display
16 July 2026
No attributes to display
Old
{
"x-validators": [
{
"name": "Validate alternative phone number is not in kraken",
"description": "Validate the alternative phone number provided does not exist in the database.",
"possible_errors": [
"alternative_phone_numbers_already_exists"
]
}
]
}New
[
{
"name": "Validate account type is valid",
"description": "Validate that only one account type is specified in the payload.",
"possible_errors": [
"multiple_account_types_selected"
]
},
{
"name": "Derive occupier billing address from supply address",
"description": "When an occupier account has no explicit billing address and exactly one supply address is provided, copy the supply address into the billing address fields.",
"possible_errors": []
},
{
"name": "Validate billing address fields",
"description": "If a legacy billing address is provided, validate that it is in the correct format.",
"possible_errors": [
"invalid_address"
]
},
{
"name": "Validate customer family name",
"description": "Validate the family name is provided for all customers on a domestic account. For Business accounts, set the family name to 'Business' if it is not provided.",
"possible_errors": [
"customer_family_name_required"
]
},
{
"name": "Validate metadata",
"description": "Validate that metadata, which is a list of key value pairs, does not contain duplicate keys.",
"possible_errors": [
"metadata_has_duplicate_keys"
]
},
{
"name": "Validate unique property external identifiers",
"description": "Ensures that <code>property_external_identifier</code> is not repeated across <code>supply_addresses</code> and <code>properties</code>.",
"possible_errors": [
"duplicate_property_external_identifiers"
]
},
{
"name": "Validate managed account type is allowed",
"description": "Validate that this instance of Kraken allows managed account types.",
"possible_errors": [
"managed_accounts_are_not_allowed"
]
},
{
"name": "Validate only portfolio lead has portfolio setting",
"description": "Validates that if portfolio settings are provided, then the account is marked as the portfolio lead.",
"possible_errors": [
"portfolio_settings_included_when_not_lead"
]
},
{
"name": "Validate business type and company number not provided for domestic accounts",
"description": "Validate that neither a business type or company number are provided for domestic accounts.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate no customers for unknown occupier",
"description": "Validate that no customers are provided for an unknown occupier.",
"possible_errors": [
"customer_with_unknown_occupier"
]
},
{
"name": "Validate that a customer given name is provided for business accounts",
"description": "Validate that a given name is provided for all customers on a business account. Note that this validation only applies if Kraken is configured to send registration flows for this import supplier.",
"possible_errors": [
"customer_given_name_required"
]
},
{
"name": "Validate portfolio reference provided correctly",
"description": "Validate that a portfolio reference is provided if portfolio settings have been provided and that a portfolio reference is not provided if the import supplier is set to create new portfolios.",
"possible_errors": [
"portfolio_references_missing",
"portfolio_references_provided"
]
},
{
"name": "Validate billing address style",
"description": "Validate that a legacy billing address (<code>billing_address1</code> etc.) and new-style billing address (<code>billing_address</code> object) are not both provided.",
"possible_errors": [
"billing_address_new_style_and_legacy"
]
},
{
"name": "Validate agreements are consecutive per supply point",
"description": "Validate that the agreements provided in the payload are consecutive per supply point i.e. there are no gaps or overlaps. The exception to this is for agreements provided before the current supply period for the supply point. Agreements provided before the <code>supply_start_date</code> are allowed gaps since they represent historic periods of supply and cannot be used for billing in Kraken.",
"possible_errors": [
"gaps_or_overlaps_in_agreement_dates"
]
},
{
"name": "Validate supply charge line items covered by a single agreement",
"description": "Validate each supply charge has a single agreement with matching product code that covers the period defined by it's line items minimum <code>start_date</code> to maximum <code>end_date</code>.",
"possible_errors": [
"supply_charge_line_items_not_covered_by_single_agreement"
]
},
{
"name": "Validate historical statement period end must not be in the future",
"description": "Ensures that the historical statement period end date (last_statement_closing_date or latest transaction_date) is not set in the future.",
"possible_errors": [
"historical_statement_period_end_in_future"
]
},
{
"name": "Validate that terms with supply type matches a supply point supply type",
"description": "Validate that for terms containing a <code>supply_type</code> field that there is a supply point in the payload with a matching <code>supply_type</code>.",
"possible_errors": [
"term_supply_type_mismatch"
]
},
{
"name": "Validate that supply addresses and supply points are provided if account contracts are provided",
"description": "Validate that if <code>account_contracts</code> have been provided that a supply address with supply points has been provided under <code>supply_addresses</code>",
"possible_errors": [
"account_contracts_without_supply_points"
]
},
{
"name": "Validate historical statement billing document identifier presence",
"description": "Ensure that billing document identifiers are only provided for historical statement transactions and only when the relevant feature flag is enabled.",
"possible_errors": [
"historical_statement_billing_document_identifier_missing",
"historical_statement_billing_document_identifier_not_allowed_when_feature_flag_disabled"
]
},
{
"name": "Validate current statement transactions do not provide <code>billing_document_identifier</code>",
"description": "Validate that none of the current statement transactions include a <code>billing_document_identifier</code>, as this field is only applicable to historical statement transactions.",
"possible_errors": [
"billing_document_identifier_not_allowed_for_current_statement_transactions"
]
},
{
"name": "Validate historical statement transaction billing document identifier",
"description": "Ensure that the billing document identifier is the same for all historical statement transactions.",
"possible_errors": [
"historical_statement_billing_document_identifier_mismatch"
]
},
{
"name": "Validate that contract terms' product codes are part of supply agreements",
"description": "Ensure that any contract terms with product references have corresponding products in supply addresses.",
"possible_errors": [
"contract_term_product_code_not_in_agreements"
]
},
{
"name": "Validate that business is provided if enforcing business contracts",
"description": "Validate that the business field is provided if <code>enforce_business_contracts_exist</code> is set to True on the import supplier configuration.",
"possible_errors": [
"business_field_required"
]
},
{
"name": "Validate agreement business contract identifier is declared",
"description": "Validates that an agreement's <code>business_contract_identifier</code>, if provided, is one of the account's declared <code>business_contract_identifiers</code>.",
"possible_errors": [
"agreement_business_contract_identifier_not_declared"
]
},
{
"name": "Validate that the sum of ledger balances equals the transfer balance",
"description": "Validate that the sum of all <code>ledger_balance</code> provided for each ledger in <code>ledgers</code> equals the account-level <code>transfer_balance</code>.",
"possible_errors": [
"ledger_balances_not_equal_to_transfer_balance"
]
},
{
"name": "Validate business user info against customer info",
"description": "Validates that business user information matches the corresponding customer information for basic fields.",
"possible_errors": [
"customer_details_and_user_details_both_provided"
]
},
{
"name": "Validate payment preference <code>ledger_identifier</code>",
"description": "Ensure that the <code>ledger_identifier</code> provided has an equivalent <code>ledger</code> object with the same <code>ledger_identifier</code> .",
"possible_errors": [
"invalid_payment_preference_ledger_identifier"
]
},
{
"name": "Validate that referenced ledgers are unique in payment preferences",
"description": "Ensure that each ledger is referenced in at most one payment preference.",
"possible_errors": [
"duplicate_ledger_in_payment_preferences"
]
},
{
"name": "Validate that valid instruction_identifier provided for <code>ACTIVE_NEW</code> payment preference",
"description": "Ensure that <code>ACTIVE_NEW</code> payment preference has instruction_identifier from </code>payment_instructions</code> object.",
"possible_errors": [
"active_new_payment_preference_invalid_instruction_identifier"
]
},
{
"name": "Validate that the transactions for a voucher do not exceed its value",
"description": "Validate that the sum of all transaction values for a voucher is not greater than the value of the voucher.",
"possible_errors": [
"voucher_transactions_sum_greater_than_voucher_value"
]
},
{
"name": "Validate that each voucher charge transaction id has a matching transaction id within a transaction of type CHARGE",
"description": "Validate that each <code>voucher</code> <code>charge_transaction_id</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CHARGE in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_charge_transaction_id_not_found"
]
},
{
"name": "Validate that each voucher redemption credit transaction id has a matching transaction id within a transaction of type CREDIT",
"description": "Validate that every <code>credit_transaction_id</code> in all <code>voucher_redemptions</code> in every <code>voucher</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CREDIT in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_redemption_credit_transaction_id_not_found"
]
},
{
"name": "Validate parent property references exist",
"description": "Validates that all <code>parent_property_reference</code> values in <code>supply_addresses</code> and <code>properties</code> correspond to a <code>property_external_identifier</code> in the payload. This ensures the property hierarchy is valid.",
"possible_errors": [
"parent_property_reference_not_found"
]
},
{
"name": "Validate that a portfolio lead account has no supply address since it makes no sense for it to have one",
"description": "Validate that a portfolio lead account has no supply address.",
"possible_errors": [
"portfolio_lead_has_a_supply_address"
]
},
{
"name": "Validate that a system account has no supply address",
"description": "Validate that a system account has no supply address",
"possible_errors": [
"system_account_has_a_supply_address"
]
},
{
"name": "Validate auto allocation of operations team",
"description": "Validate that operations_team_name is provided if auto allocation is not configured.",
"possible_errors": [
"operations_team_provided_when_using_auto_allocation",
"operations_team_should_be_provided"
]
},
{
"name": "Validate that Kraken can calculate when to start billing the account",
"description": "Validate that Kraken can calculate when to start billing the account. This is determined based on the existence of last billed to date, last statement closing date, and agreements.",
"possible_errors": [
"cannot_determine_responsible_for_billing_from_date"
]
},
{
"name": "Validate that if historical statement transaction are provided then so is a last statement closing date or last billed to date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided in the payload then either a <code>last_statement_closing_date</code> or <code>last_billed_to_date</code> is also provided. If a <code>last_statement_closing_date</code> is not provided then the earliest <code>last_billed_to_date</code> on the account or supply points is used to determine when the last statement should have closed.",
"possible_errors": [
"historical_statement_transactions_without_last_statement_closing_date_or_last_billed_to_date"
]
},
{
"name": "Validate unique transaction IDs",
"description": "Validate that all transaction IDs provided are unique.",
"possible_errors": [
"duplicate_transaction_ids",
"missing_transaction_id"
]
},
{
"name": "Validate current statement transactions are after historical statement transactions",
"description": "Validate that all current statement transactions are dated after all current historical statement transactions.",
"possible_errors": [
"historical_statement_transaction_after_current_statement_transaction"
]
},
{
"name": "Validate that there are no historical statement transactions after the last statement closing date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided then none are later than the <code>last_statement_closing_date</code>. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"historical_statement_transaction_after_last_statement_closing_date"
]
},
{
"name": "Validate that the last statement issue date is on or after the last statement closing date",
"description": "Validate that the <code>last_statement_issue_date</code>, if given, is on or after the <code>last_statement_closing_date</code> given. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"last_statement_issued_before_closing_date"
]
},
{
"name": "Validate no duplicated ledgers are provided",
"description": "Validate no duplicated ledger codes are in `ledgers` section.",
"possible_errors": [
"duplicate_ledger_entries_found"
]
},
{
"name": "Validate identifiers are unique in ledgers",
"description": "Validate identifier is not declared twice in ledgers.",
"possible_errors": [
"duplicate_identifiers_entries_found"
]
},
{
"name": "Validate ledger identifiers are known",
"description": "Validate ledger identifiers are among supply point identifiers.",
"possible_errors": [
"unknown_ledger_identifiers"
]
},
{
"name": "Validate payment adequacy changes or last payment review date not both",
"description": "Validate that only one of <code>payment_adequacy_changes</code> or <code>last_payment_review_date</code> is provided in the payload.",
"possible_errors": [
"payment_adequacy_changes_and_last_payment_review_date_provided"
]
},
{
"name": "Validate that payment plans and payment schedules for the same ledger are not both in payload",
"description": "Validate that if there are payment plans in the payload, there are not also payment schedules on the same ledger because payment plans create a schedule containing all of the planned payments.",
"possible_errors": [
"payment_plan_and_payment_schedule_not_allowed_on_same_ledger"
]
},
{
"name": "Validate no more than one property for unknown occupier",
"description": "Validate that no more than one property is provided for an unknown occupier account.",
"possible_errors": [
"occupier_account_with_multiple_supply_addresses"
]
},
{
"name": "Validate no direct debit reference for the occupier",
"description": "Validate that if any customer is identified as an occupier, then no <code>dd_reference</code> is provided for the account. If a <code>dd_reference</code> is provided, then it implies that there is a known occupier for the account.",
"possible_errors": [
"dd_reference_for_occupier_account"
]
},
{
"name": "Validate no unbilled period on former supply addresses",
"description": "Validate that if a customer is no longer at the given supply address they have been fully billed. This check is performed if we are importing supply address history.",
"possible_errors": [
"unbilled_former_supply_address"
]
},
{
"name": "Validate that agreements cover the last billed to date",
"description": "Validate that there is an agreement covering the last billed to date for each supply point.",
"possible_errors": [
"no_agreement_covering_last_billed_to_date"
]
},
{
"name": "Validate debt and debts",
"description": "Validates that both debt and debts are not specified in the payload.",
"possible_errors": [
"debt_and_debts_are_defined"
]
},
{
"name": "Validate that a last billed to date has been provided correctly",
"description": "Validate that, for each meter, a last billed to date has been provided in the appropriate place. For electricity meters, it must be provided on each of the meter's settlement registers. For gas meters, it must be provided on the meter. This validation does not apply to meters with half-hourly billing, or meters that have been exchanged where the new meter has already been billed. This validation is skipped if the account has not yet been billed and therefore has no historical statement data.",
"possible_errors": [
"last_billed_to_date_not_found"
]
},
{
"name": "Validate that current statement transactions are not before the current statement opening date",
"description": "Validate that all <code>current_statement_transactions</code>, if provided, are not before the current statement opening date. This date is one day after the last statement closing date if provided, otherwise it is based on the last billed to date. Note that any prepay vend transactions are not included in the above check.",
"possible_errors": [
"current_statement_transaction_before_current_statement_opening_date"
]
},
{
"name": "Validate <code>last_statement_balance</code> plus/minus <code>current_statement_transactions</code> equal <code>transfer_balance</code>",
"description": "Validate that the sum of <code>current_statement_transactions</code> plus the <code>last_statement_balance</code> is equal to the <code>transfer_balance</code>. For example, if a <code>last_statement_balance</code> of 100 is provided, and the <code>current_statement_transactions</code> include one payment of 50, then the expected <code>transfer_balance</code> would 150. Transactions that are payments or credits add to the balance. Transactions that are repayments or charges subtract from the balance. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"balance_mismatch_on_transfer_balance"
]
},
{
"name": "Validate that the summed historical statement transactions match the last statement balance",
"description": "Validate that the sum of the <code>historical_statement_transactions</code> equals the <code>last_statement_balance</code>. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"historical_statement_transactions_balance_mismatch"
]
},
{
"name": "Validate next bill due date provided for quarterly billing",
"description": "Validate that if <code>use_industry_billing</code> is false in the account billing options and the <code>period_length</code> is <code>QUARTERLY</code>, then a <code>next_bill_due_date</code> is provided.",
"possible_errors": [
"next_bill_to_date_not_provided_for_quarterly_billing"
]
},
{
"name": "Validate account billing options",
"description": "Validate that account billing options have only been provided for business accounts.",
"possible_errors": [
"account_billing_options_provided_for_domestic_accounts"
]
},
{
"name": "Validate that prepay transactions target initialised prepay meters",
"description": "Validate that if <code>current_statement_transactions</code> or <code>historical_statement_transactions</code> target a prepay meter (i.e. has the <code>to_prepay_meter_serial_number</code> field), then a prepay meter with that serial number exists in the payload. A prepay meter is identified in the payload by the presence of <code>prepay_details</code>.",
"possible_errors": [
"transactions_target_non_initialised_prepay_meter"
]
},
{
"name": "Validate tax exemption for appropriate account type",
"description": "Validate that the tax exemption is only in place for business accounts.",
"possible_errors": [
"tax_exemptions_provided_for_domestic_account"
]
},
{
"name": "Validate prepay transfer vend read dates match last billed to date",
"description": "Validate that the transfer vend read dates match the last billed to date. This only applies to prepay meters.The last billed to date can be either at the account level or the at the meter/register level. Last billed to dates at the meter/register level take precedent over the account level date if both are provided.",
"possible_errors": [
"prepay_details_on_fully_billed_meter",
"transfer_vend_read_date_must_match_last_billed_to_date"
]
},
{
"name": "Validate that the tariff type and meter point type match",
"description": "Validate that the tariff we have on a given contract matches the meter point type. For example, check eco7 (2-rate) meter points don't have single-rate tariffs or vice versa.",
"possible_errors": [
"tariff_type_does_not_match_meter_point_type"
]
},
{
"name": "Validate bespoke rates",
"description": "Validate that if bespoke rates have been set the account is business.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate billing address provided",
"description": "Validate <code>billing_address1</code> and <code>billing_postcode</code> are provided for non-occupier accounts.",
"possible_errors": [
"billing_address_not_provided"
]
},
{
"name": "Validate current AQ for billable meter point",
"description": "Check that we have a currently valid AQ for a billable MPRN.",
"possible_errors": [
"no_current_or_future_aq_entry_found"
]
},
{
"name": "Validate all billable meter points are covered by agreements in the payload",
"description": "Validate that agreements have been provided for all billable meter points and vice versa for the period covered by Kraken from a billing perspective. A billable meter point is one that has an open-ended or future dated supply end date.",
"possible_errors": [
"meter_point_with_no_agreement",
"meterpoint_with_agreement_not_on_supply"
]
},
{
"name": "Validate transfer readings exist on active gas meters",
"description": "Validate that each active gas meter has a single transfer reading provided.",
"possible_errors": [
"active_gas_meter_with_multiple_transfer_readings",
"active_gas_meter_without_transfer_reading",
"reading_meter_fully_billed"
]
},
{
"name": "Validate EACs provided for active registers",
"description": "Validate that EACs are provided in the <code>eac_history</code> array for each active electricity register. EACs are matched to registers using the <code>tpr</code> field present on both the EAC and register objects.",
"possible_errors": [
"missing_eacs_for_active_register_tpr"
]
},
{
"name": "Validate that prepay meters are matched to agreements of the correct type",
"description": "Validate that each prepay meter has a matching agreement on a prepay tariff, and similarly non-prepay meters on non-prepay tariffs. Note that this validation only applies for active meters and agreements.",
"possible_errors": [
"tariff_type_does_not_match_meter_type"
]
},
{
"name": "Validate each agreement is not effective before the product is available",
"description": "Ensures that the agreement <code>effective_from</code> is not before the datetime the agreement's product is available from. We check this if Kraken will be responsible for billing before the product is available and the product is a variable or tracker product.",
"possible_errors": [
"agreement_effective_from_before_product_available_from"
]
},
{
"name": "Validate that all variable products on a contract have start dates after the product start date",
"description": "Validate that any variable products that are part of a contract only become effective after the product is available.",
"possible_errors": [
"agreement_cannot_start_before_product_available"
]
},
{
"name": "Validate that no meter points are ending supply in the future",
"description": "Ensure that all meters points have either ended supply or are not planned for supply to end.",
"possible_errors": [
"future_supply_end_date"
]
},
{
"name": "Validate that all off supply meter points with meters have a final reading",
"description": "Ensure that all off supply meter points which have meters have a final reading on their end date.",
"possible_errors": [
"no_reading_on_supply_end_date"
]
},
{
"name": "Validate that no billable meter points are starting supply in the future",
"description": "Validate that no billable meter points are set to start supply in the future.",
"possible_errors": [
"future_supply_start_date"
]
},
{
"name": "Validate that all billable meter points have active meters",
"description": "Ensure that all meter points that are billable have active meters or have an unmetered measurement class provided in the payload.",
"possible_errors": [
"meter_point_with_no_meters"
]
},
{
"name": "Validate that at least one of the meter points needs billing",
"description": "Ensure that at least one of the meter points for this account are billable.",
"possible_errors": [
"no_supply_point_on_supply"
]
},
{
"name": "Validate that a domestic account does not have any business only supply points",
"description": "Validate that a domestic account does not have supply points with supply types <code>REGOS_EXPORT_CERTIFICATES</code> or <code>ROCS_EXPORT_CERTIFICATES</code> which are business only supply types.",
"possible_errors": [
"business_supply_type_on_domestic_account"
]
},
{
"name": "Validate business account has account billing options with <code>period_start_day</code> and <code>period_length</code>",
"description": "Validate that business account's <code>account_billing_options</code> include period start day and period length if <code>account_billing_options</code> is being provided. If <code>account_billing_options</code> is not provided then the defaults of 1 for <code>period_start_day</code> and \"MONTHLY\" for <code>period_length</code> will be used.",
"possible_errors": [
"business_account_missing_billing_options"
]
},
{
"name": "Validate that customers provided for business accounts",
"description": "Validate that at least one customer is provided for business accounts. Customers are needed for business accounts to ensure that meter points can be successfully registered for supply.",
"possible_errors": [
"business_account_missing_customers"
]
},
{
"name": "Validate current statement transactions are not before <code>last_billed_to_date</code>",
"description": "Validate that there are no current statement transactions that occurred before the <code>last_billed_to_date</code> (this includes the supply point-level <code>last_billed_to_date</code>, as well as any meter- or register-level dates where applicable).",
"possible_errors": [
"current_statement_transaction_before_last_billed_to_date"
]
},
{
"name": "Validate transfer readings exist on active electricity registers",
"description": "Validate that each active electricity meter register has a single transfer reading provided.",
"possible_errors": [
"missing_transfer_reading_for_register",
"multiple_transfer_readings_for_register"
]
}
]Old
[
{
"name": "Validate account type is valid",
"description": "Validate that only one account type is specified in the payload.",
"possible_errors": [
"multiple_account_types_selected"
]
},
{
"name": "Derive occupier billing address from supply address",
"description": "When an occupier account has no explicit billing address and exactly one supply address is provided, copy the supply address into the billing address fields.",
"possible_errors": []
},
{
"name": "Validate billing address fields",
"description": "If a legacy billing address is provided, validate that it is in the correct format.",
"possible_errors": [
"invalid_address"
]
},
{
"name": "Validate customer family name",
"description": "Validate the family name is provided for all customers on a domestic account. For Business accounts, set the family name to 'Business' if it is not provided.",
"possible_errors": [
"customer_family_name_required"
]
},
{
"name": "Validate metadata",
"description": "Validate that metadata, which is a list of key value pairs, does not contain duplicate keys.",
"possible_errors": [
"metadata_has_duplicate_keys"
]
},
{
"name": "Validate unique property external identifiers",
"description": "Ensures that <code>property_external_identifier</code> is not repeated across <code>supply_addresses</code> and <code>properties</code>.",
"possible_errors": [
"duplicate_property_external_identifiers"
]
},
{
"name": "Validate managed account type is allowed",
"description": "Validate that this instance of Kraken allows managed account types.",
"possible_errors": [
"managed_accounts_are_not_allowed"
]
},
{
"name": "Validate only portfolio lead has portfolio setting",
"description": "Validates that if portfolio settings are provided, then the account is marked as the portfolio lead.",
"possible_errors": [
"portfolio_settings_included_when_not_lead"
]
},
{
"name": "Validate business type and company number not provided for domestic accounts",
"description": "Validate that neither a business type or company number are provided for domestic accounts.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate no customers for unknown occupier",
"description": "Validate that no customers are provided for an unknown occupier.",
"possible_errors": [
"customer_with_unknown_occupier"
]
},
{
"name": "Validate that a customer given name is provided for business accounts",
"description": "Validate that a given name is provided for all customers on a business account. Note that this validation only applies if Kraken is configured to send registration flows for this import supplier.",
"possible_errors": [
"customer_given_name_required"
]
},
{
"name": "Validate portfolio reference provided correctly",
"description": "Validate that a portfolio reference is provided if portfolio settings have been provided and that a portfolio reference is not provided if the import supplier is set to create new portfolios.",
"possible_errors": [
"portfolio_references_missing",
"portfolio_references_provided"
]
},
{
"name": "Validate billing address style",
"description": "Validate that a legacy billing address (<code>billing_address1</code> etc.) and new-style billing address (<code>billing_address</code> object) are not both provided.",
"possible_errors": [
"billing_address_new_style_and_legacy"
]
},
{
"name": "Validate agreements are consecutive per supply point",
"description": "Validate that the agreements provided in the payload are consecutive per supply point i.e. there are no gaps or overlaps. The exception to this is for agreements provided before the current supply period for the supply point. Agreements provided before the <code>supply_start_date</code> are allowed gaps since they represent historic periods of supply and cannot be used for billing in Kraken.",
"possible_errors": [
"gaps_or_overlaps_in_agreement_dates"
]
},
{
"name": "Validate supply charge line items covered by a single agreement",
"description": "Validate each supply charge has a single agreement with matching product code that covers the period defined by it's line items minimum <code>start_date</code> to maximum <code>end_date</code>.",
"possible_errors": [
"supply_charge_line_items_not_covered_by_single_agreement"
]
},
{
"name": "Validate historical statement period end must not be in the future",
"description": "Ensures that the historical statement period end date (last_statement_closing_date or latest transaction_date) is not set in the future.",
"possible_errors": [
"historical_statement_period_end_in_future"
]
},
{
"name": "Validate that terms with supply type matches a supply point supply type",
"description": "Validate that for terms containing a <code>supply_type</code> field that there is a supply point in the payload with a matching <code>supply_type</code>.",
"possible_errors": [
"term_supply_type_mismatch"
]
},
{
"name": "Validate that supply addresses and supply points are provided if account contracts are provided",
"description": "Validate that if <code>account_contracts</code> have been provided that a supply address with supply points has been provided under <code>supply_addresses</code>",
"possible_errors": [
"account_contracts_without_supply_points"
]
},
{
"name": "Validate historical statement billing document identifier presence",
"description": "Ensure that billing document identifiers are only provided for historical statement transactions and only when the relevant feature flag is enabled.",
"possible_errors": [
"historical_statement_billing_document_identifier_missing",
"historical_statement_billing_document_identifier_not_allowed_when_feature_flag_disabled"
]
},
{
"name": "Validate current statement transactions do not provide <code>billing_document_identifier</code>",
"description": "Validate that none of the current statement transactions include a <code>billing_document_identifier</code>, as this field is only applicable to historical statement transactions.",
"possible_errors": [
"billing_document_identifier_not_allowed_for_current_statement_transactions"
]
},
{
"name": "Validate historical statement transaction billing document identifier",
"description": "Ensure that the billing document identifier is the same for all historical statement transactions.",
"possible_errors": [
"historical_statement_billing_document_identifier_mismatch"
]
},
{
"name": "Validate that contract terms' product codes are part of supply agreements",
"description": "Ensure that any contract terms with product references have corresponding products in supply addresses.",
"possible_errors": [
"contract_term_product_code_not_in_agreements"
]
},
{
"name": "Validate that business is provided if enforcing business contracts",
"description": "Validate that the business field is provided if <code>enforce_business_contracts_exist</code> is set to True on the import supplier configuration.",
"possible_errors": [
"business_field_required"
]
},
{
"name": "Validate agreement business contract identifier is declared",
"description": "Validates that an agreement's <code>business_contract_identifier</code>, if provided, is one of the account's declared <code>business_contract_identifiers</code>.",
"possible_errors": [
"agreement_business_contract_identifier_not_declared"
]
},
{
"name": "Validate that the sum of ledger balances equals the transfer balance",
"description": "Validate that the sum of all <code>ledger_balance</code> provided for each ledger in <code>ledgers</code> equals the account-level <code>transfer_balance</code>.",
"possible_errors": [
"ledger_balances_not_equal_to_transfer_balance"
]
},
{
"name": "Validate business user info against customer info",
"description": "Validates that business user information matches the corresponding customer information for basic fields.",
"possible_errors": [
"customer_details_and_user_details_both_provided"
]
},
{
"name": "Validate payment preference <code>ledger_identifier</code>",
"description": "Ensure that the <code>ledger_identifier</code> provided has an equivalent <code>ledger</code> object with the same <code>ledger_identifier</code> .",
"possible_errors": [
"invalid_payment_preference_ledger_identifier"
]
},
{
"name": "Validate that referenced ledgers are unique in payment preferences",
"description": "Ensure that each ledger is referenced in at most one payment preference.",
"possible_errors": [
"duplicate_ledger_in_payment_preferences"
]
},
{
"name": "Validate that valid instruction_identifier provided for <code>ACTIVE_NEW</code> payment preference",
"description": "Ensure that <code>ACTIVE_NEW</code> payment preference has instruction_identifier from </code>payment_instructions</code> object.",
"possible_errors": [
"active_new_payment_preference_invalid_instruction_identifier"
]
},
{
"name": "Validate that the transactions for a voucher do not exceed its value",
"description": "Validate that the sum of all transaction values for a voucher is not greater than the value of the voucher.",
"possible_errors": [
"voucher_transactions_sum_greater_than_voucher_value"
]
},
{
"name": "Validate that each voucher charge transaction id has a matching transaction id within a transaction of type CHARGE",
"description": "Validate that each <code>voucher</code> <code>charge_transaction_id</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CHARGE in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_charge_transaction_id_not_found"
]
},
{
"name": "Validate that each voucher redemption credit transaction id has a matching transaction id within a transaction of type CREDIT",
"description": "Validate that every <code>credit_transaction_id</code> in all <code>voucher_redemptions</code> in every <code>voucher</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CREDIT in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_redemption_credit_transaction_id_not_found"
]
},
{
"name": "Validate parent property references exist",
"description": "Validates that all <code>parent_property_reference</code> values in <code>supply_addresses</code> and <code>properties</code> correspond to a <code>property_external_identifier</code> in the payload. This ensures the property hierarchy is valid.",
"possible_errors": [
"parent_property_reference_not_found"
]
},
{
"name": "Validate that a portfolio lead account has no supply address since it makes no sense for it to have one",
"description": "Validate that a portfolio lead account has no supply address.",
"possible_errors": [
"portfolio_lead_has_a_supply_address"
]
},
{
"name": "Validate that a system account has no supply address",
"description": "Validate that a system account has no supply address",
"possible_errors": [
"system_account_has_a_supply_address"
]
},
{
"name": "Validate auto allocation of operations team",
"description": "Validate that operations_team_name is provided if auto allocation is not configured.",
"possible_errors": [
"operations_team_provided_when_using_auto_allocation",
"operations_team_should_be_provided"
]
},
{
"name": "Validate that Kraken can calculate when to start billing the account",
"description": "Validate that Kraken can calculate when to start billing the account. This is determined based on the existence of last billed to date, last statement closing date, and agreements.",
"possible_errors": [
"cannot_determine_responsible_for_billing_from_date"
]
},
{
"name": "Validate that if historical statement transaction are provided then so is a last statement closing date or last billed to date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided in the payload then either a <code>last_statement_closing_date</code> or <code>last_billed_to_date</code> is also provided. If a <code>last_statement_closing_date</code> is not provided then the earliest <code>last_billed_to_date</code> on the account or supply points is used to determine when the last statement should have closed.",
"possible_errors": [
"historical_statement_transactions_without_last_statement_closing_date_or_last_billed_to_date"
]
},
{
"name": "Validate unique transaction IDs",
"description": "Validate that all transaction IDs provided are unique.",
"possible_errors": [
"duplicate_transaction_ids",
"missing_transaction_id"
]
},
{
"name": "Validate current statement transactions are after historical statement transactions",
"description": "Validate that all current statement transactions are dated after all current historical statement transactions.",
"possible_errors": [
"historical_statement_transaction_after_current_statement_transaction"
]
},
{
"name": "Validate that there are no historical statement transactions after the last statement closing date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided then none are later than the <code>last_statement_closing_date</code>. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"historical_statement_transaction_after_last_statement_closing_date"
]
},
{
"name": "Validate that the last statement issue date is on or after the last statement closing date",
"description": "Validate that the <code>last_statement_issue_date</code>, if given, is on or after the <code>last_statement_closing_date</code> given. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"last_statement_issued_before_closing_date"
]
},
{
"name": "Validate no duplicated ledgers are provided",
"description": "Validate no duplicated ledger codes are in `ledgers` section.",
"possible_errors": [
"duplicate_ledger_entries_found"
]
},
{
"name": "Validate identifiers are unique in ledgers",
"description": "Validate identifier is not declared twice in ledgers.",
"possible_errors": [
"duplicate_identifiers_entries_found"
]
},
{
"name": "Validate ledger identifiers are known",
"description": "Validate ledger identifiers are among supply point identifiers.",
"possible_errors": [
"unknown_ledger_identifiers"
]
},
{
"name": "Validate payment adequacy changes or last payment review date not both",
"description": "Validate that only one of <code>payment_adequacy_changes</code> or <code>last_payment_review_date</code> is provided in the payload.",
"possible_errors": [
"payment_adequacy_changes_and_last_payment_review_date_provided"
]
},
{
"name": "Validate that payment plans and payment schedules for the same ledger are not both in payload",
"description": "Validate that if there are payment plans in the payload, there are not also payment schedules on the same ledger because payment plans create a schedule containing all of the planned payments.",
"possible_errors": [
"payment_plan_and_payment_schedule_not_allowed_on_same_ledger"
]
},
{
"name": "Validate no more than one property for unknown occupier",
"description": "Validate that no more than one property is provided for an unknown occupier account.",
"possible_errors": [
"occupier_account_with_multiple_supply_addresses"
]
},
{
"name": "Validate no direct debit reference for the occupier",
"description": "Validate that if any customer is identified as an occupier, then no <code>dd_reference</code> is provided for the account. If a <code>dd_reference</code> is provided, then it implies that there is a known occupier for the account.",
"possible_errors": [
"dd_reference_for_occupier_account"
]
},
{
"name": "Validate no unbilled period on former supply addresses",
"description": "Validate that if a customer is no longer at the given supply address they have been fully billed. This check is performed if we are importing supply address history.",
"possible_errors": [
"unbilled_former_supply_address"
]
},
{
"name": "Validate that agreements cover the last billed to date",
"description": "Validate that there is an agreement covering the last billed to date for each supply point.",
"possible_errors": [
"no_agreement_covering_last_billed_to_date"
]
},
{
"name": "Validate debt and debts",
"description": "Validates that both debt and debts are not specified in the payload.",
"possible_errors": [
"debt_and_debts_are_defined"
]
},
{
"name": "Validate that a last billed to date has been provided correctly",
"description": "Validate that, for each meter, a last billed to date has been provided in the appropriate place. For electricity meters, it must be provided on each of the meter's settlement registers. For gas meters, it must be provided on the meter. This validation does not apply to meters with half-hourly billing, or meters that have been exchanged where the new meter has already been billed. This validation is skipped if the account has not yet been billed and therefore has no historical statement data.",
"possible_errors": [
"last_billed_to_date_not_found"
]
},
{
"name": "Validate that current statement transactions are not before the current statement opening date",
"description": "Validate that all <code>current_statement_transactions</code>, if provided, are not before the current statement opening date. This date is one day after the last statement closing date if provided, otherwise it is based on the last billed to date. Note that any prepay vend transactions are not included in the above check.",
"possible_errors": [
"current_statement_transaction_before_current_statement_opening_date"
]
},
{
"name": "Validate <code>last_statement_balance</code> plus/minus <code>current_statement_transactions</code> equal <code>transfer_balance</code>",
"description": "Validate that the sum of <code>current_statement_transactions</code> plus the <code>last_statement_balance</code> is equal to the <code>transfer_balance</code>. For example, if a <code>last_statement_balance</code> of 100 is provided, and the <code>current_statement_transactions</code> include one payment of 50, then the expected <code>transfer_balance</code> would 150. Transactions that are payments or credits add to the balance. Transactions that are repayments or charges subtract from the balance. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"balance_mismatch_on_transfer_balance"
]
},
{
"name": "Validate that the summed historical statement transactions match the last statement balance",
"description": "Validate that the sum of the <code>historical_statement_transactions</code> equals the <code>last_statement_balance</code>. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"historical_statement_transactions_balance_mismatch"
]
},
{
"name": "Validate next bill due date provided for quarterly billing",
"description": "Validate that if <code>use_industry_billing</code> is false in the account billing options and the <code>period_length</code> is <code>QUARTERLY</code>, then a <code>next_bill_due_date</code> is provided.",
"possible_errors": [
"next_bill_to_date_not_provided_for_quarterly_billing"
]
},
{
"name": "Validate account billing options",
"description": "Validate that account billing options have only been provided for business accounts.",
"possible_errors": [
"account_billing_options_provided_for_domestic_accounts"
]
},
{
"name": "Validate alternative phone number is unique",
"description": "Validate customers defined in the payload do not have the same alternative phone numbers.",
"possible_errors": [
"duplicated_alternative_phone_numbers"
]
},
{
"name": "Validate that prepay transactions target initialised prepay meters",
"description": "Validate that if <code>current_statement_transactions</code> or <code>historical_statement_transactions</code> target a prepay meter (i.e. has the <code>to_prepay_meter_serial_number</code> field), then a prepay meter with that serial number exists in the payload. A prepay meter is identified in the payload by the presence of <code>prepay_details</code>.",
"possible_errors": [
"transactions_target_non_initialised_prepay_meter"
]
},
{
"name": "Validate tax exemption for appropriate account type",
"description": "Validate that the tax exemption is only in place for business accounts.",
"possible_errors": [
"tax_exemptions_provided_for_domestic_account"
]
},
{
"name": "Validate prepay transfer vend read dates match last billed to date",
"description": "Validate that the transfer vend read dates match the last billed to date. This only applies to prepay meters.The last billed to date can be either at the account level or the at the meter/register level. Last billed to dates at the meter/register level take precedent over the account level date if both are provided.",
"possible_errors": [
"prepay_details_on_fully_billed_meter",
"transfer_vend_read_date_must_match_last_billed_to_date"
]
},
{
"name": "Validate that the tariff type and meter point type match",
"description": "Validate that the tariff we have on a given contract matches the meter point type. For example, check eco7 (2-rate) meter points don't have single-rate tariffs or vice versa.",
"possible_errors": [
"tariff_type_does_not_match_meter_point_type"
]
},
{
"name": "Validate bespoke rates",
"description": "Validate that if bespoke rates have been set the account is business.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate billing address provided",
"description": "Validate <code>billing_address1</code> and <code>billing_postcode</code> are provided for non-occupier accounts.",
"possible_errors": [
"billing_address_not_provided"
]
},
{
"name": "Validate current AQ for billable meter point",
"description": "Check that we have a currently valid AQ for a billable MPRN.",
"possible_errors": [
"no_current_or_future_aq_entry_found"
]
},
{
"name": "Validate all billable meter points are covered by agreements in the payload",
"description": "Validate that agreements have been provided for all billable meter points and vice versa for the period covered by Kraken from a billing perspective. A billable meter point is one that has an open-ended or future dated supply end date.",
"possible_errors": [
"meter_point_with_no_agreement",
"meterpoint_with_agreement_not_on_supply"
]
},
{
"name": "Validate transfer readings exist on active gas meters",
"description": "Validate that each active gas meter has a single transfer reading provided.",
"possible_errors": [
"active_gas_meter_with_multiple_transfer_readings",
"active_gas_meter_without_transfer_reading",
"reading_meter_fully_billed"
]
},
{
"name": "Validate EACs provided for active registers",
"description": "Validate that EACs are provided in the <code>eac_history</code> array for each active electricity register. EACs are matched to registers using the <code>tpr</code> field present on both the EAC and register objects.",
"possible_errors": [
"missing_eacs_for_active_register_tpr"
]
},
{
"name": "Validate that prepay meters are matched to agreements of the correct type",
"description": "Validate that each prepay meter has a matching agreement on a prepay tariff, and similarly non-prepay meters on non-prepay tariffs. Note that this validation only applies for active meters and agreements.",
"possible_errors": [
"tariff_type_does_not_match_meter_type"
]
},
{
"name": "Validate each agreement is not effective before the product is available",
"description": "Ensures that the agreement <code>effective_from</code> is not before the datetime the agreement's product is available from. We check this if Kraken will be responsible for billing before the product is available and the product is a variable or tracker product.",
"possible_errors": [
"agreement_effective_from_before_product_available_from"
]
},
{
"name": "Validate that all variable products on a contract have start dates after the product start date",
"description": "Validate that any variable products that are part of a contract only become effective after the product is available.",
"possible_errors": [
"agreement_cannot_start_before_product_available"
]
},
{
"name": "Validate that no meter points are ending supply in the future",
"description": "Ensure that all meters points have either ended supply or are not planned for supply to end.",
"possible_errors": [
"future_supply_end_date"
]
},
{
"name": "Validate that all off supply meter points with meters have a final reading",
"description": "Ensure that all off supply meter points which have meters have a final reading on their end date.",
"possible_errors": [
"no_reading_on_supply_end_date"
]
},
{
"name": "Validate that no billable meter points are starting supply in the future",
"description": "Validate that no billable meter points are set to start supply in the future.",
"possible_errors": [
"future_supply_start_date"
]
},
{
"name": "Validate that all billable meter points have active meters",
"description": "Ensure that all meter points that are billable have active meters or have an unmetered measurement class provided in the payload.",
"possible_errors": [
"meter_point_with_no_meters"
]
},
{
"name": "Validate that at least one of the meter points needs billing",
"description": "Ensure that at least one of the meter points for this account are billable.",
"possible_errors": [
"no_supply_point_on_supply"
]
},
{
"name": "Validate that a domestic account does not have any business only supply points",
"description": "Validate that a domestic account does not have supply points with supply types <code>REGOS_EXPORT_CERTIFICATES</code> or <code>ROCS_EXPORT_CERTIFICATES</code> which are business only supply types.",
"possible_errors": [
"business_supply_type_on_domestic_account"
]
},
{
"name": "Validate business account has account billing options with <code>period_start_day</code> and <code>period_length</code>",
"description": "Validate that business account's <code>account_billing_options</code> include period start day and period length if <code>account_billing_options</code> is being provided. If <code>account_billing_options</code> is not provided then the defaults of 1 for <code>period_start_day</code> and \"MONTHLY\" for <code>period_length</code> will be used.",
"possible_errors": [
"business_account_missing_billing_options"
]
},
{
"name": "Validate that customers provided for business accounts",
"description": "Validate that at least one customer is provided for business accounts. Customers are needed for business accounts to ensure that meter points can be successfully registered for supply.",
"possible_errors": [
"business_account_missing_customers"
]
},
{
"name": "Validate current statement transactions are not before <code>last_billed_to_date</code>",
"description": "Validate that there are no current statement transactions that occurred before the <code>last_billed_to_date</code> (this includes the supply point-level <code>last_billed_to_date</code>, as well as any meter- or register-level dates where applicable).",
"possible_errors": [
"current_statement_transaction_before_last_billed_to_date"
]
},
{
"name": "Validate transfer readings exist on active electricity registers",
"description": "Validate that each active electricity meter register has a single transfer reading provided.",
"possible_errors": [
"missing_transfer_reading_for_register",
"multiple_transfer_readings_for_register"
]
}
]Old
{
"x-validators": [
{
"name": "Validate alternative phone number is not in kraken",
"description": "Validate the alternative phone number provided does not exist in the database.",
"possible_errors": [
"alternative_phone_numbers_already_exists"
]
}
]
}New
{
"x-enum-descriptions": {
"ESSENTIAL_WATER_FIELD": "Essential Water Field Services"
}
}Old
{
"x-enum-descriptions": {}
}15 July 2026
New
{
"x-enum-descriptions": {
"debt_management_plan_active": "DEBT_MANAGEMENT_PLAN_ACTIVE",
"debt_arrangement_scheme_active": "DEBT_ARRANGEMENT_SCHEME_ACTIVE"
}
}Old
{
"x-enum-descriptions": {
"debt_management_plan_active": "Debt Management Plan Active",
"debt_arrangement_scheme_active": "Debt Arrangement Scheme Active"
}
}New
{
"x-enum-descriptions": {
"DEBT_MANAGEMENT_PLAN_ACTIVE": "DEBT_MANAGEMENT_PLAN_ACTIVE",
"DEBT_ARRANGEMENT_SCHEME_ACTIVE": "DEBT_ARRANGEMENT_SCHEME_ACTIVE"
}
}Old
{
"x-enum-descriptions": {
"Debt Management Plan Active": "Debt Management Plan Active",
"Debt Arrangement Scheme Active": "Debt Arrangement Scheme Active"
}
}New
{
"x-enum-descriptions": {
"sb_high_value_renewals": "SB High Value Renewals"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"SB High Value Renewals": "SB High Value Renewals"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {}
}Old
{
"x-enum-descriptions": {
"ESSENTIAL_WATER_FIELD": "Essential Water Field Services"
}
}New
{
"x-enum-descriptions": {
"ESSENTIAL_WATER_FIELD": "Essential Water Field Services"
}
}Old
{
"x-enum-descriptions": {}
}New
[
{
"name": "Validate <code>\u2068end_date\u2069</code> not before <code>\u2068start_date\u2069</code>",
"description": "Validates that <code>\u2068end_date\u2069</code>, if given, is on or later than <code>\u2068start_date\u2069</code>.",
"possible_errors": [
"start_date_later_than_end_date"
]
},
{
"name": "Validate fixed payment schedule has amount",
"description": "Validates that a fixed payment schedule has an non zero amount provided in the payload. A fixed schedule is defined as a payment schedule with a trigger that is not type BILL.",
"possible_errors": [
"zero_payment_schedule_amount"
]
},
{
"name": "Validate regular payment schedule frequency provided",
"description": "Validates that a fixed regular payment schedule has a frequency provided in the payload.",
"possible_errors": [
"fixed_payment_schedule_missing_frequency"
]
},
{
"name": "Validate payment schedule balance threshold provided",
"description": "Validates that a payment schedule with a balance trigger has a balance threshold provided in the payload. This balance threshold is the amount the ledger balance must drop below to trigger a payment.",
"possible_errors": [
"balance_triggered_schedule_missing_threshold"
]
},
{
"name": "Validate debt repayment end date provided",
"description": "Validates that a debt repayment end date is provided in the payload if a debt repayment element is provided.",
"possible_errors": [
"debt_repayment_missing_end_date"
]
},
{
"name": "Validate debt repayment end date is not later than schedule end date",
"description": "Validates that a debt repayment end date is not later than the payment schedule end date if both are provided.",
"possible_errors": [
"debt_repayment_end_date_after_schedule_end_date"
]
},
{
"name": "Validate exempt from payment adequacy is applied only to regular schedule",
"description": "Validates that only a regular payment schedule is marked as exempted from payment adequacy, so as to create a fixed regular payment schedule.",
"possible_errors": [
"invalid_payment_schedule_to_exempt_from_payment_adequacy"
]
},
{
"name": "Validate fixed payment schedule has payment day",
"description": "Validates that a fixed payment schedule has a day of month in the payload. A fixed schedule is defined as a payment schedule with a trigger of type REGULAR.",
"possible_errors": [
"fixed_payment_schedule_missing_day_of_month"
]
},
{
"name": "Validate instalments is provided if trigger is PLAN",
"description": "Validate that the instalment field is not empty if payment schedule trigger is PLAN.",
"possible_errors": [
"payment_instalments_not_provided"
]
},
{
"name": "Validate instalment payment amounts sum to total amount",
"description": "Validate instalment payment amounts sum to total amount given.",
"possible_errors": [
"payment_instalments_do_not_sum_to_total"
]
},
{
"name": "Validate instalment payment date is within payment schedule active period",
"description": "Validate instalment payment date is within the period between start date and end date provided.",
"possible_errors": [
"payment_instalments_date_outside_of_payment_schedule_active_period"
]
},
{
"name": "Validate that the delayer days is set if delayer strategy is set",
"description": "Validate that the delayer days is set if delayer strategy is set",
"possible_errors": [
"payment_schedule_delay_must_have_bill_trigger",
"payment_schedule_delay_strategy_missing_delay_days"
]
},
{
"name": "Validate that the payment amount for fixed payment schedules is within the minor currency unit range of \u20680\u2069 - \u2068upper_bound\u2069",
"description": "Validate that the payment amount for any fixed payment schedule is within the major currency unit range of \u2068lower_limit\u2069 - \u2068UNLIMITED\u2069.",
"possible_errors": [
"fixed_payment_schedule_amount_out_of_range"
]
},
{
"name": "Standalone payment request method code is unexpected",
"description": "Validates that standalone_payment_request_method_code is only provided for MANUAL payment schedules.",
"possible_errors": [
"standalone_payment_request_method_code_unexpected"
]
},
{
"name": "Standalone payment request method code is valid",
"description": "Validates that standalone_payment_request_method_code matches a registered method.",
"possible_errors": [
"standalone_payment_request_method_code_invalid"
]
}
]Old
[
{
"name": "Validate <code>\u2068end_date\u2069</code> not before <code>\u2068start_date\u2069</code>",
"description": "Validates that <code>\u2068end_date\u2069</code>, if given, is on or later than <code>\u2068start_date\u2069</code>.",
"possible_errors": [
"start_date_later_than_end_date"
]
},
{
"name": "Validate fixed payment schedule has amount",
"description": "Validates that a fixed payment schedule has an non zero amount provided in the payload. A fixed schedule is defined as a payment schedule with a trigger that is not type BILL.",
"possible_errors": [
"zero_payment_schedule_amount"
]
},
{
"name": "Validate regular payment schedule frequency provided",
"description": "Validates that a fixed regular payment schedule has a frequency provided in the payload.",
"possible_errors": [
"fixed_payment_schedule_missing_frequency"
]
},
{
"name": "Validate payment schedule balance threshold provided",
"description": "Validates that a payment schedule with a balance trigger has a balance threshold provided in the payload. This balance threshold is the amount the ledger balance must drop below to trigger a payment.",
"possible_errors": [
"balance_triggered_schedule_missing_threshold"
]
},
{
"name": "Validate debt repayment end date provided",
"description": "Validates that a debt repayment end date is provided in the payload if a debt repayment element is provided.",
"possible_errors": [
"debt_repayment_missing_end_date"
]
},
{
"name": "Validate debt repayment end date is not later than schedule end date",
"description": "Validates that a debt repayment end date is not later than the payment schedule end date if both are provided.",
"possible_errors": [
"debt_repayment_end_date_after_schedule_end_date"
]
},
{
"name": "Validate exempt from payment adequacy is applied only to regular schedule",
"description": "Validates that only a regular payment schedule is marked as exempted from payment adequacy, so as to create a fixed regular payment schedule.",
"possible_errors": [
"invalid_payment_schedule_to_exempt_from_payment_adequacy"
]
},
{
"name": "Validate fixed payment schedule has payment day",
"description": "Validates that a fixed payment schedule has a day of month in the payload. A fixed schedule is defined as a payment schedule with a trigger of type REGULAR.",
"possible_errors": [
"fixed_payment_schedule_missing_day_of_month"
]
},
{
"name": "Validate instalments is provided if trigger is PLAN",
"description": "Validate that the instalment field is not empty if payment schedule trigger is PLAN.",
"possible_errors": [
"payment_instalments_not_provided"
]
},
{
"name": "Validate instalment payment amounts sum to total amount",
"description": "Validate instalment payment amounts sum to total amount given.",
"possible_errors": [
"payment_instalments_do_not_sum_to_total"
]
},
{
"name": "Validate instalment payment date is within payment schedule active period",
"description": "Validate instalment payment date is within the period between start date and end date provided.",
"possible_errors": [
"payment_instalments_date_outside_of_payment_schedule_active_period"
]
},
{
"name": "Validate that the delayer days is set if delayer strategy is set",
"description": "Validate that the delayer days is set if delayer strategy is set",
"possible_errors": [
"payment_schedule_delay_must_have_bill_trigger",
"payment_schedule_delay_strategy_missing_delay_days"
]
},
{
"name": "Validate that the payment amount for fixed payment schedules is within the minor currency unit range of \u20680\u2069 - \u2068upper_bound\u2069",
"description": "Validate that the payment amount for any fixed payment schedule is within the major currency unit range of \u2068lower_limit\u2069 - \u2068UNLIMITED\u2069.",
"possible_errors": [
"fixed_payment_schedule_amount_out_of_range"
]
}
]14 July 2026
New
{
"x-enum-descriptions": {
"CARER": "CARER",
"EXECUTOR": "EXECUTOR",
"NEIGHBOUR": "NEIGHBOUR",
"LOA_LEVEL_1": "LOA_LEVEL_1",
"LOA_LEVEL_2": "LOA_LEVEL_2",
"LOA_LEVEL_3": "LOA_LEVEL_3",
"STUDENT_HOUSE": "STUDENT_HOUSE",
"POWER_OF_ATTORNEY": "POWER_OF_ATTORNEY",
"FRIEND_FAMILY_MEMBER": "FRIEND_FAMILY_MEMBER"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"items": {
"x-enum-descriptions": {
"CARER": "CARER",
"EXECUTOR": "EXECUTOR",
"NEIGHBOUR": "NEIGHBOUR",
"LOA_LEVEL_1": "LOA_LEVEL_1",
"LOA_LEVEL_2": "LOA_LEVEL_2",
"LOA_LEVEL_3": "LOA_LEVEL_3",
"STUDENT_HOUSE": "STUDENT_HOUSE",
"POWER_OF_ATTORNEY": "POWER_OF_ATTORNEY",
"FRIEND_FAMILY_MEMBER": "FRIEND_FAMILY_MEMBER"
}
}
}Old
{
"items": {
"x-enum-descriptions": {}
}
}New
{
"items": {
"x-enum-descriptions": {
"CARER": "CARER",
"EXECUTOR": "EXECUTOR",
"NEIGHBOUR": "NEIGHBOUR",
"LOA_LEVEL_1": "LOA_LEVEL_1",
"LOA_LEVEL_2": "LOA_LEVEL_2",
"LOA_LEVEL_3": "LOA_LEVEL_3",
"STUDENT_HOUSE": "STUDENT_HOUSE",
"POWER_OF_ATTORNEY": "POWER_OF_ATTORNEY",
"FRIEND_FAMILY_MEMBER": "FRIEND_FAMILY_MEMBER"
}
}
}Old
{
"items": {
"x-enum-descriptions": {}
}
}New
{
"items": {
"x-enum-descriptions": {
"CARER": "CARER",
"EXECUTOR": "EXECUTOR",
"NEIGHBOUR": "NEIGHBOUR",
"LOA_LEVEL_1": "LOA_LEVEL_1",
"LOA_LEVEL_2": "LOA_LEVEL_2",
"LOA_LEVEL_3": "LOA_LEVEL_3",
"STUDENT_HOUSE": "STUDENT_HOUSE",
"POWER_OF_ATTORNEY": "POWER_OF_ATTORNEY",
"FRIEND_FAMILY_MEMBER": "FRIEND_FAMILY_MEMBER"
}
}
}Old
{
"items": {
"x-enum-descriptions": {}
}
}New
{
"x-enum-descriptions": {
"flextras_customer": "Registered for Flextras"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Registered for Flextras": "Registered for Flextras"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"debt_365": "Debt 365"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Debt 365": "Debt 365"
}
}Old
{
"x-enum-descriptions": {}
}13 July 2026
New
{
"x-enum-descriptions": {
"promo_50_august_renew": "Promo 50 August Renew",
"promo_100_august_renew": "Promo 100 August Renew",
"promo_150_august_renew": "Promo 150 August Renew",
"promo_200_august_renew": "Promo 200 August Renew"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Promo 50 August Renew": "Promo 50 August Renew",
"Promo 100 August Renew": "Promo 100 August Renew",
"Promo 150 August Renew": "Promo 150 August Renew",
"Promo 200 August Renew": "Promo 200 August Renew"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"final_bill_issued": "FINAL_BILL_ISSUED"
}
}Old
{
"x-enum-descriptions": {
"final_bill_issued": "Final Bill Issued"
}
}New
{
"x-enum-descriptions": {
"FINAL_BILL_ISSUED": "FINAL_BILL_ISSUED"
}
}Old
{
"x-enum-descriptions": {
"Final Bill Issued": "Final Bill Issued"
}
}New
{
"x-enum-descriptions": {
"broker_no_dd": "Broker_no_dd"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Broker_no_dd": "Broker_no_dd"
}
}Old
{
"x-enum-descriptions": {}
}10 July 2026
New
{
"x-enum-descriptions": {
"smh_calisen_live": "SMH Calisen Live",
"smh_calisen_other": "SMH Calisen Other"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"SMH Calisen Live": "SMH Calisen Live",
"SMH Calisen Other": "SMH Calisen Other"
}
}Old
{
"x-enum-descriptions": {}
}9 July 2026
New
{
"x-enum-descriptions": {
"heatwave_relief_pack_requested": "Heatwave Relief Pack - Requested"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Heatwave Relief Pack - Requested": "Heatwave Relief Pack - Requested"
}
}Old
{
"x-enum-descriptions": {}
}
No attributes to display
New
{
"x-enum-descriptions": {
"final_bill_issued": "Final Bill Issued"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Final Bill Issued": "Final Bill Issued"
}
}Old
{
"x-enum-descriptions": {}
}New
[
{
"name": "Validate account type is valid",
"description": "Validate that only one account type is specified in the payload.",
"possible_errors": [
"multiple_account_types_selected"
]
},
{
"name": "Derive occupier billing address from supply address",
"description": "When an occupier account has no explicit billing address and exactly one supply address is provided, copy the supply address into the billing address fields.",
"possible_errors": []
},
{
"name": "Validate billing address fields",
"description": "If a legacy billing address is provided, validate that it is in the correct format.",
"possible_errors": [
"invalid_address"
]
},
{
"name": "Validate customer family name",
"description": "Validate the family name is provided for all customers on a domestic account. For Business accounts, set the family name to 'Business' if it is not provided.",
"possible_errors": [
"customer_family_name_required"
]
},
{
"name": "Validate metadata",
"description": "Validate that metadata, which is a list of key value pairs, does not contain duplicate keys.",
"possible_errors": [
"metadata_has_duplicate_keys"
]
},
{
"name": "Validate unique property external identifiers",
"description": "Ensures that <code>property_external_identifier</code> is not repeated across <code>supply_addresses</code> and <code>properties</code>.",
"possible_errors": [
"duplicate_property_external_identifiers"
]
},
{
"name": "Validate managed account type is allowed",
"description": "Validate that this instance of Kraken allows managed account types.",
"possible_errors": [
"managed_accounts_are_not_allowed"
]
},
{
"name": "Validate only portfolio lead has portfolio setting",
"description": "Validates that if portfolio settings are provided, then the account is marked as the portfolio lead.",
"possible_errors": [
"portfolio_settings_included_when_not_lead"
]
},
{
"name": "Validate business type and company number not provided for domestic accounts",
"description": "Validate that neither a business type or company number are provided for domestic accounts.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate no customers for unknown occupier",
"description": "Validate that no customers are provided for an unknown occupier.",
"possible_errors": [
"customer_with_unknown_occupier"
]
},
{
"name": "Validate that a customer given name is provided for business accounts",
"description": "Validate that a given name is provided for all customers on a business account. Note that this validation only applies if Kraken is configured to send registration flows for this import supplier.",
"possible_errors": [
"customer_given_name_required"
]
},
{
"name": "Validate portfolio reference provided correctly",
"description": "Validate that a portfolio reference is provided if portfolio settings have been provided and that a portfolio reference is not provided if the import supplier is set to create new portfolios.",
"possible_errors": [
"portfolio_references_missing",
"portfolio_references_provided"
]
},
{
"name": "Validate billing address style",
"description": "Validate that a legacy billing address (<code>billing_address1</code> etc.) and new-style billing address (<code>billing_address</code> object) are not both provided.",
"possible_errors": [
"billing_address_new_style_and_legacy"
]
},
{
"name": "Validate agreements are consecutive per supply point",
"description": "Validate that the agreements provided in the payload are consecutive per supply point i.e. there are no gaps or overlaps. The exception to this is for agreements provided before the current supply period for the supply point. Agreements provided before the <code>supply_start_date</code> are allowed gaps since they represent historic periods of supply and cannot be used for billing in Kraken.",
"possible_errors": [
"gaps_or_overlaps_in_agreement_dates"
]
},
{
"name": "Validate supply charge line items covered by a single agreement",
"description": "Validate each supply charge has a single agreement with matching product code that covers the period defined by it's line items minimum <code>start_date</code> to maximum <code>end_date</code>.",
"possible_errors": [
"supply_charge_line_items_not_covered_by_single_agreement"
]
},
{
"name": "Validate historical statement period end must not be in the future",
"description": "Ensures that the historical statement period end date (last_statement_closing_date or latest transaction_date) is not set in the future.",
"possible_errors": [
"historical_statement_period_end_in_future"
]
},
{
"name": "Validate that terms with supply type matches a supply point supply type",
"description": "Validate that for terms containing a <code>supply_type</code> field that there is a supply point in the payload with a matching <code>supply_type</code>.",
"possible_errors": [
"term_supply_type_mismatch"
]
},
{
"name": "Validate that supply addresses and supply points are provided if account contracts are provided",
"description": "Validate that if <code>account_contracts</code> have been provided that a supply address with supply points has been provided under <code>supply_addresses</code>",
"possible_errors": [
"account_contracts_without_supply_points"
]
},
{
"name": "Validate historical statement billing document identifier presence",
"description": "Ensure that billing document identifiers are only provided for historical statement transactions and only when the relevant feature flag is enabled.",
"possible_errors": [
"historical_statement_billing_document_identifier_missing",
"historical_statement_billing_document_identifier_not_allowed_when_feature_flag_disabled"
]
},
{
"name": "Validate current statement transactions do not provide <code>billing_document_identifier</code>",
"description": "Validate that none of the current statement transactions include a <code>billing_document_identifier</code>, as this field is only applicable to historical statement transactions.",
"possible_errors": [
"billing_document_identifier_not_allowed_for_current_statement_transactions"
]
},
{
"name": "Validate historical statement transaction billing document identifier",
"description": "Ensure that the billing document identifier is the same for all historical statement transactions.",
"possible_errors": [
"historical_statement_billing_document_identifier_mismatch"
]
},
{
"name": "Validate that contract terms' product codes are part of supply agreements",
"description": "Ensure that any contract terms with product references have corresponding products in supply addresses.",
"possible_errors": [
"contract_term_product_code_not_in_agreements"
]
},
{
"name": "Validate that business is provided if enforcing business contracts",
"description": "Validate that the business field is provided if <code>enforce_business_contracts_exist</code> is set to True on the import supplier configuration.",
"possible_errors": [
"business_field_required"
]
},
{
"name": "Validate agreement business contract identifier is declared",
"description": "Validates that an agreement's <code>business_contract_identifier</code>, if provided, is one of the account's declared <code>business_contract_identifiers</code>.",
"possible_errors": [
"agreement_business_contract_identifier_not_declared"
]
},
{
"name": "Validate that the sum of ledger balances equals the transfer balance",
"description": "Validate that the sum of all <code>ledger_balance</code> provided for each ledger in <code>ledgers</code> equals the account-level <code>transfer_balance</code>.",
"possible_errors": [
"ledger_balances_not_equal_to_transfer_balance"
]
},
{
"name": "Validate business user info against customer info",
"description": "Validates that business user information matches the corresponding customer information for basic fields.",
"possible_errors": [
"customer_details_and_user_details_both_provided"
]
},
{
"name": "Validate payment preference <code>ledger_identifier</code>",
"description": "Ensure that the <code>ledger_identifier</code> provided has an equivalent <code>ledger</code> object with the same <code>ledger_identifier</code> .",
"possible_errors": [
"invalid_payment_preference_ledger_identifier"
]
},
{
"name": "Validate that referenced ledgers are unique in payment preferences",
"description": "Ensure that each ledger is referenced in at most one payment preference.",
"possible_errors": [
"duplicate_ledger_in_payment_preferences"
]
},
{
"name": "Validate that valid instruction_identifier provided for <code>ACTIVE_NEW</code> payment preference",
"description": "Ensure that <code>ACTIVE_NEW</code> payment preference has instruction_identifier from </code>payment_instructions</code> object.",
"possible_errors": [
"active_new_payment_preference_invalid_instruction_identifier"
]
},
{
"name": "Validate that the transactions for a voucher do not exceed its value",
"description": "Validate that the sum of all transaction values for a voucher is not greater than the value of the voucher.",
"possible_errors": [
"voucher_transactions_sum_greater_than_voucher_value"
]
},
{
"name": "Validate that each voucher charge transaction id has a matching transaction id within a transaction of type CHARGE",
"description": "Validate that each <code>voucher</code> <code>charge_transaction_id</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CHARGE in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_charge_transaction_id_not_found"
]
},
{
"name": "Validate that each voucher redemption credit transaction id has a matching transaction id within a transaction of type CREDIT",
"description": "Validate that every <code>credit_transaction_id</code> in all <code>voucher_redemptions</code> in every <code>voucher</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CREDIT in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_redemption_credit_transaction_id_not_found"
]
},
{
"name": "Validate parent property references exist",
"description": "Validates that all <code>parent_property_reference</code> values in <code>supply_addresses</code> and <code>properties</code> correspond to a <code>property_external_identifier</code> in the payload. This ensures the property hierarchy is valid.",
"possible_errors": [
"parent_property_reference_not_found"
]
},
{
"name": "Validate that a portfolio lead account has no supply address since it makes no sense for it to have one",
"description": "Validate that a portfolio lead account has no supply address.",
"possible_errors": [
"portfolio_lead_has_a_supply_address"
]
},
{
"name": "Validate that a system account has no supply address",
"description": "Validate that a system account has no supply address",
"possible_errors": [
"system_account_has_a_supply_address"
]
},
{
"name": "Validate auto allocation of operations team",
"description": "Validate that operations_team_name is provided if auto allocation is not configured.",
"possible_errors": [
"operations_team_provided_when_using_auto_allocation",
"operations_team_should_be_provided"
]
},
{
"name": "Validate that Kraken can calculate when to start billing the account",
"description": "Validate that Kraken can calculate when to start billing the account. This is determined based on the existence of last billed to date, last statement closing date, and agreements.",
"possible_errors": [
"cannot_determine_responsible_for_billing_from_date"
]
},
{
"name": "Validate that if historical statement transaction are provided then so is a last statement closing date or last billed to date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided in the payload then either a <code>last_statement_closing_date</code> or <code>last_billed_to_date</code> is also provided. If a <code>last_statement_closing_date</code> is not provided then the earliest <code>last_billed_to_date</code> on the account or supply points is used to determine when the last statement should have closed.",
"possible_errors": [
"historical_statement_transactions_without_last_statement_closing_date_or_last_billed_to_date"
]
},
{
"name": "Validate unique transaction IDs",
"description": "Validate that all transaction IDs provided are unique.",
"possible_errors": [
"duplicate_transaction_ids",
"missing_transaction_id"
]
},
{
"name": "Validate current statement transactions are after historical statement transactions",
"description": "Validate that all current statement transactions are dated after all current historical statement transactions.",
"possible_errors": [
"historical_statement_transaction_after_current_statement_transaction"
]
},
{
"name": "Validate that there are no historical statement transactions after the last statement closing date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided then none are later than the <code>last_statement_closing_date</code>. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"historical_statement_transaction_after_last_statement_closing_date"
]
},
{
"name": "Validate that the last statement issue date is on or after the last statement closing date",
"description": "Validate that the <code>last_statement_issue_date</code>, if given, is on or after the <code>last_statement_closing_date</code> given. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"last_statement_issued_before_closing_date"
]
},
{
"name": "Validate no duplicated ledgers are provided",
"description": "Validate no duplicated ledger codes are in `ledgers` section.",
"possible_errors": [
"duplicate_ledger_entries_found"
]
},
{
"name": "Validate identifiers are unique in ledgers",
"description": "Validate identifier is not declared twice in ledgers.",
"possible_errors": [
"duplicate_identifiers_entries_found"
]
},
{
"name": "Validate ledger identifiers are known",
"description": "Validate ledger identifiers are among supply point identifiers.",
"possible_errors": [
"unknown_ledger_identifiers"
]
},
{
"name": "Validate payment adequacy changes or last payment review date not both",
"description": "Validate that only one of <code>payment_adequacy_changes</code> or <code>last_payment_review_date</code> is provided in the payload.",
"possible_errors": [
"payment_adequacy_changes_and_last_payment_review_date_provided"
]
},
{
"name": "Validate that payment plans and payment schedules for the same ledger are not both in payload",
"description": "Validate that if there are payment plans in the payload, there are not also payment schedules on the same ledger because payment plans create a schedule containing all of the planned payments.",
"possible_errors": [
"payment_plan_and_payment_schedule_not_allowed_on_same_ledger"
]
},
{
"name": "Validate no more than one property for unknown occupier",
"description": "Validate that no more than one property is provided for an unknown occupier account.",
"possible_errors": [
"occupier_account_with_multiple_supply_addresses"
]
},
{
"name": "Validate no direct debit reference for the occupier",
"description": "Validate that if any customer is identified as an occupier, then no <code>dd_reference</code> is provided for the account. If a <code>dd_reference</code> is provided, then it implies that there is a known occupier for the account.",
"possible_errors": [
"dd_reference_for_occupier_account"
]
},
{
"name": "Validate no unbilled period on former supply addresses",
"description": "Validate that if a customer is no longer at the given supply address they have been fully billed. This check is performed if we are importing supply address history.",
"possible_errors": [
"unbilled_former_supply_address"
]
},
{
"name": "Validate that agreements cover the last billed to date",
"description": "Validate that there is an agreement covering the last billed to date for each supply point.",
"possible_errors": [
"no_agreement_covering_last_billed_to_date"
]
},
{
"name": "Validate debt and debts",
"description": "Validates that both debt and debts are not specified in the payload.",
"possible_errors": [
"debt_and_debts_are_defined"
]
},
{
"name": "Validate that a last billed to date has been provided correctly",
"description": "Validate that, for each meter, a last billed to date has been provided in the appropriate place. For electricity meters, it must be provided on each of the meter's settlement registers. For gas meters, it must be provided on the meter. This validation does not apply to meters with half-hourly billing, or meters that have been exchanged where the new meter has already been billed. This validation is skipped if the account has not yet been billed and therefore has no historical statement data.",
"possible_errors": [
"last_billed_to_date_not_found"
]
},
{
"name": "Validate that current statement transactions are not before the current statement opening date",
"description": "Validate that all <code>current_statement_transactions</code>, if provided, are not before the current statement opening date. This date is one day after the last statement closing date if provided, otherwise it is based on the last billed to date. Note that any prepay vend transactions are not included in the above check.",
"possible_errors": [
"current_statement_transaction_before_current_statement_opening_date"
]
},
{
"name": "Validate <code>last_statement_balance</code> plus/minus <code>current_statement_transactions</code> equal <code>transfer_balance</code>",
"description": "Validate that the sum of <code>current_statement_transactions</code> plus the <code>last_statement_balance</code> is equal to the <code>transfer_balance</code>. For example, if a <code>last_statement_balance</code> of 100 is provided, and the <code>current_statement_transactions</code> include one payment of 50, then the expected <code>transfer_balance</code> would 150. Transactions that are payments or credits add to the balance. Transactions that are repayments or charges subtract from the balance. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"balance_mismatch_on_transfer_balance"
]
},
{
"name": "Validate that the summed historical statement transactions match the last statement balance",
"description": "Validate that the sum of the <code>historical_statement_transactions</code> equals the <code>last_statement_balance</code>. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"historical_statement_transactions_balance_mismatch"
]
},
{
"name": "Validate next bill due date provided for quarterly billing",
"description": "Validate that if <code>use_industry_billing</code> is false in the account billing options and the <code>period_length</code> is <code>QUARTERLY</code>, then a <code>next_bill_due_date</code> is provided.",
"possible_errors": [
"next_bill_to_date_not_provided_for_quarterly_billing"
]
},
{
"name": "Validate account billing options",
"description": "Validate that account billing options have only been provided for business accounts.",
"possible_errors": [
"account_billing_options_provided_for_domestic_accounts"
]
},
{
"name": "Validate alternative phone number is unique",
"description": "Validate customers defined in the payload do not have the same alternative phone numbers.",
"possible_errors": [
"duplicated_alternative_phone_numbers"
]
},
{
"name": "Validate that prepay transactions target initialised prepay meters",
"description": "Validate that if <code>current_statement_transactions</code> or <code>historical_statement_transactions</code> target a prepay meter (i.e. has the <code>to_prepay_meter_serial_number</code> field), then a prepay meter with that serial number exists in the payload. A prepay meter is identified in the payload by the presence of <code>prepay_details</code>.",
"possible_errors": [
"transactions_target_non_initialised_prepay_meter"
]
},
{
"name": "Validate tax exemption for appropriate account type",
"description": "Validate that the tax exemption is only in place for business accounts.",
"possible_errors": [
"tax_exemptions_provided_for_domestic_account"
]
},
{
"name": "Validate prepay transfer vend read dates match last billed to date",
"description": "Validate that the transfer vend read dates match the last billed to date. This only applies to prepay meters.The last billed to date can be either at the account level or the at the meter/register level. Last billed to dates at the meter/register level take precedent over the account level date if both are provided.",
"possible_errors": [
"prepay_details_on_fully_billed_meter",
"transfer_vend_read_date_must_match_last_billed_to_date"
]
},
{
"name": "Validate that the tariff type and meter point type match",
"description": "Validate that the tariff we have on a given contract matches the meter point type. For example, check eco7 (2-rate) meter points don't have single-rate tariffs or vice versa.",
"possible_errors": [
"tariff_type_does_not_match_meter_point_type"
]
},
{
"name": "Validate bespoke rates",
"description": "Validate that if bespoke rates have been set the account is business.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate billing address provided",
"description": "Validate <code>billing_address1</code> and <code>billing_postcode</code> are provided for non-occupier accounts.",
"possible_errors": [
"billing_address_not_provided"
]
},
{
"name": "Validate current AQ for billable meter point",
"description": "Check that we have a currently valid AQ for a billable MPRN.",
"possible_errors": [
"no_current_or_future_aq_entry_found"
]
},
{
"name": "Validate all billable meter points are covered by agreements in the payload",
"description": "Validate that agreements have been provided for all billable meter points and vice versa for the period covered by Kraken from a billing perspective. A billable meter point is one that has an open-ended or future dated supply end date.",
"possible_errors": [
"meter_point_with_no_agreement",
"meterpoint_with_agreement_not_on_supply"
]
},
{
"name": "Validate transfer readings exist on active gas meters",
"description": "Validate that each active gas meter has a single transfer reading provided.",
"possible_errors": [
"active_gas_meter_with_multiple_transfer_readings",
"active_gas_meter_without_transfer_reading",
"reading_meter_fully_billed"
]
},
{
"name": "Validate EACs provided for active registers",
"description": "Validate that EACs are provided in the <code>eac_history</code> array for each active electricity register. EACs are matched to registers using the <code>tpr</code> field present on both the EAC and register objects.",
"possible_errors": [
"missing_eacs_for_active_register_tpr"
]
},
{
"name": "Validate that prepay meters are matched to agreements of the correct type",
"description": "Validate that each prepay meter has a matching agreement on a prepay tariff, and similarly non-prepay meters on non-prepay tariffs. Note that this validation only applies for active meters and agreements.",
"possible_errors": [
"tariff_type_does_not_match_meter_type"
]
},
{
"name": "Validate each agreement is not effective before the product is available",
"description": "Ensures that the agreement <code>effective_from</code> is not before the datetime the agreement's product is available from. We check this if Kraken will be responsible for billing before the product is available and the product is a variable or tracker product.",
"possible_errors": [
"agreement_effective_from_before_product_available_from"
]
},
{
"name": "Validate that all variable products on a contract have start dates after the product start date",
"description": "Validate that any variable products that are part of a contract only become effective after the product is available.",
"possible_errors": [
"agreement_cannot_start_before_product_available"
]
},
{
"name": "Validate that no meter points are ending supply in the future",
"description": "Ensure that all meters points have either ended supply or are not planned for supply to end.",
"possible_errors": [
"future_supply_end_date"
]
},
{
"name": "Validate that all off supply meter points with meters have a final reading",
"description": "Ensure that all off supply meter points which have meters have a final reading on their end date.",
"possible_errors": [
"no_reading_on_supply_end_date"
]
},
{
"name": "Validate that no billable meter points are starting supply in the future",
"description": "Validate that no billable meter points are set to start supply in the future.",
"possible_errors": [
"future_supply_start_date"
]
},
{
"name": "Validate that all billable meter points have active meters",
"description": "Ensure that all meter points that are billable have active meters or have an unmetered measurement class provided in the payload.",
"possible_errors": [
"meter_point_with_no_meters"
]
},
{
"name": "Validate that at least one of the meter points needs billing",
"description": "Ensure that at least one of the meter points for this account are billable.",
"possible_errors": [
"no_supply_point_on_supply"
]
},
{
"name": "Validate that a domestic account does not have any business only supply points",
"description": "Validate that a domestic account does not have supply points with supply types <code>REGOS_EXPORT_CERTIFICATES</code> or <code>ROCS_EXPORT_CERTIFICATES</code> which are business only supply types.",
"possible_errors": [
"business_supply_type_on_domestic_account"
]
},
{
"name": "Validate business account has account billing options with <code>period_start_day</code> and <code>period_length</code>",
"description": "Validate that business account's <code>account_billing_options</code> include period start day and period length if <code>account_billing_options</code> is being provided. If <code>account_billing_options</code> is not provided then the defaults of 1 for <code>period_start_day</code> and \"MONTHLY\" for <code>period_length</code> will be used.",
"possible_errors": [
"business_account_missing_billing_options"
]
},
{
"name": "Validate that customers provided for business accounts",
"description": "Validate that at least one customer is provided for business accounts. Customers are needed for business accounts to ensure that meter points can be successfully registered for supply.",
"possible_errors": [
"business_account_missing_customers"
]
},
{
"name": "Validate current statement transactions are not before <code>last_billed_to_date</code>",
"description": "Validate that there are no current statement transactions that occurred before the <code>last_billed_to_date</code> (this includes the supply point-level <code>last_billed_to_date</code>, as well as any meter- or register-level dates where applicable).",
"possible_errors": [
"current_statement_transaction_before_last_billed_to_date"
]
},
{
"name": "Validate transfer readings exist on active electricity registers",
"description": "Validate that each active electricity meter register has a single transfer reading provided.",
"possible_errors": [
"missing_transfer_reading_for_register",
"multiple_transfer_readings_for_register"
]
}
]Old
[
{
"name": "Validate account type is valid",
"description": "Validate that only one account type is specified in the payload.",
"possible_errors": [
"multiple_account_types_selected"
]
},
{
"name": "Validate billing address fields",
"description": "If a legacy billing address is provided, validate that it is in the correct format.",
"possible_errors": [
"invalid_address"
]
},
{
"name": "Validate customer family name",
"description": "Validate the family name is provided for all customers on a domestic account. For Business accounts, set the family name to 'Business' if it is not provided.",
"possible_errors": [
"customer_family_name_required"
]
},
{
"name": "Validate metadata",
"description": "Validate that metadata, which is a list of key value pairs, does not contain duplicate keys.",
"possible_errors": [
"metadata_has_duplicate_keys"
]
},
{
"name": "Validate unique property external identifiers",
"description": "Ensures that <code>property_external_identifier</code> is not repeated across <code>supply_addresses</code> and <code>properties</code>.",
"possible_errors": [
"duplicate_property_external_identifiers"
]
},
{
"name": "Validate managed account type is allowed",
"description": "Validate that this instance of Kraken allows managed account types.",
"possible_errors": [
"managed_accounts_are_not_allowed"
]
},
{
"name": "Validate only portfolio lead has portfolio setting",
"description": "Validates that if portfolio settings are provided, then the account is marked as the portfolio lead.",
"possible_errors": [
"portfolio_settings_included_when_not_lead"
]
},
{
"name": "Validate business type and company number not provided for domestic accounts",
"description": "Validate that neither a business type or company number are provided for domestic accounts.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate no customers for unknown occupier",
"description": "Validate that no customers are provided for an unknown occupier.",
"possible_errors": [
"customer_with_unknown_occupier"
]
},
{
"name": "Validate that a customer given name is provided for business accounts",
"description": "Validate that a given name is provided for all customers on a business account. Note that this validation only applies if Kraken is configured to send registration flows for this import supplier.",
"possible_errors": [
"customer_given_name_required"
]
},
{
"name": "Validate portfolio reference provided correctly",
"description": "Validate that a portfolio reference is provided if portfolio settings have been provided and that a portfolio reference is not provided if the import supplier is set to create new portfolios.",
"possible_errors": [
"portfolio_references_missing",
"portfolio_references_provided"
]
},
{
"name": "Validate billing address style",
"description": "Validate that a legacy billing address (<code>billing_address1</code> etc.) and new-style billing address (<code>billing_address</code> object) are not both provided.",
"possible_errors": [
"billing_address_new_style_and_legacy"
]
},
{
"name": "Validate agreements are consecutive per supply point",
"description": "Validate that the agreements provided in the payload are consecutive per supply point i.e. there are no gaps or overlaps. The exception to this is for agreements provided before the current supply period for the supply point. Agreements provided before the <code>supply_start_date</code> are allowed gaps since they represent historic periods of supply and cannot be used for billing in Kraken.",
"possible_errors": [
"gaps_or_overlaps_in_agreement_dates"
]
},
{
"name": "Validate supply charge line items covered by a single agreement",
"description": "Validate each supply charge has a single agreement with matching product code that covers the period defined by it's line items minimum <code>start_date</code> to maximum <code>end_date</code>.",
"possible_errors": [
"supply_charge_line_items_not_covered_by_single_agreement"
]
},
{
"name": "Validate historical statement period end must not be in the future",
"description": "Ensures that the historical statement period end date (last_statement_closing_date or latest transaction_date) is not set in the future.",
"possible_errors": [
"historical_statement_period_end_in_future"
]
},
{
"name": "Validate that terms with supply type matches a supply point supply type",
"description": "Validate that for terms containing a <code>supply_type</code> field that there is a supply point in the payload with a matching <code>supply_type</code>.",
"possible_errors": [
"term_supply_type_mismatch"
]
},
{
"name": "Validate that supply addresses and supply points are provided if account contracts are provided",
"description": "Validate that if <code>account_contracts</code> have been provided that a supply address with supply points has been provided under <code>supply_addresses</code>",
"possible_errors": [
"account_contracts_without_supply_points"
]
},
{
"name": "Validate historical statement billing document identifier presence",
"description": "Ensure that billing document identifiers are only provided for historical statement transactions and only when the relevant feature flag is enabled.",
"possible_errors": [
"historical_statement_billing_document_identifier_missing",
"historical_statement_billing_document_identifier_not_allowed_when_feature_flag_disabled"
]
},
{
"name": "Validate current statement transactions do not provide <code>billing_document_identifier</code>",
"description": "Validate that none of the current statement transactions include a <code>billing_document_identifier</code>, as this field is only applicable to historical statement transactions.",
"possible_errors": [
"billing_document_identifier_not_allowed_for_current_statement_transactions"
]
},
{
"name": "Validate historical statement transaction billing document identifier",
"description": "Ensure that the billing document identifier is the same for all historical statement transactions.",
"possible_errors": [
"historical_statement_billing_document_identifier_mismatch"
]
},
{
"name": "Validate that contract terms' product codes are part of supply agreements",
"description": "Ensure that any contract terms with product references have corresponding products in supply addresses.",
"possible_errors": [
"contract_term_product_code_not_in_agreements"
]
},
{
"name": "Validate that business is provided if enforcing business contracts",
"description": "Validate that the business field is provided if <code>enforce_business_contracts_exist</code> is set to True on the import supplier configuration.",
"possible_errors": [
"business_field_required"
]
},
{
"name": "Validate agreement business contract identifier is declared",
"description": "Validates that an agreement's <code>business_contract_identifier</code>, if provided, is one of the account's declared <code>business_contract_identifiers</code>.",
"possible_errors": [
"agreement_business_contract_identifier_not_declared"
]
},
{
"name": "Validate that the sum of ledger balances equals the transfer balance",
"description": "Validate that the sum of all <code>ledger_balance</code> provided for each ledger in <code>ledgers</code> equals the account-level <code>transfer_balance</code>.",
"possible_errors": [
"ledger_balances_not_equal_to_transfer_balance"
]
},
{
"name": "Validate business user info against customer info",
"description": "Validates that business user information matches the corresponding customer information for basic fields.",
"possible_errors": [
"customer_details_and_user_details_both_provided"
]
},
{
"name": "Validate payment preference <code>ledger_identifier</code>",
"description": "Ensure that the <code>ledger_identifier</code> provided has an equivalent <code>ledger</code> object with the same <code>ledger_identifier</code> .",
"possible_errors": [
"invalid_payment_preference_ledger_identifier"
]
},
{
"name": "Validate that referenced ledgers are unique in payment preferences",
"description": "Ensure that each ledger is referenced in at most one payment preference.",
"possible_errors": [
"duplicate_ledger_in_payment_preferences"
]
},
{
"name": "Validate that valid instruction_identifier provided for <code>ACTIVE_NEW</code> payment preference",
"description": "Ensure that <code>ACTIVE_NEW</code> payment preference has instruction_identifier from </code>payment_instructions</code> object.",
"possible_errors": [
"active_new_payment_preference_invalid_instruction_identifier"
]
},
{
"name": "Validate that the transactions for a voucher do not exceed its value",
"description": "Validate that the sum of all transaction values for a voucher is not greater than the value of the voucher.",
"possible_errors": [
"voucher_transactions_sum_greater_than_voucher_value"
]
},
{
"name": "Validate that each voucher charge transaction id has a matching transaction id within a transaction of type CHARGE",
"description": "Validate that each <code>voucher</code> <code>charge_transaction_id</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CHARGE in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_charge_transaction_id_not_found"
]
},
{
"name": "Validate that each voucher redemption credit transaction id has a matching transaction id within a transaction of type CREDIT",
"description": "Validate that every <code>credit_transaction_id</code> in all <code>voucher_redemptions</code> in every <code>voucher</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CREDIT in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_redemption_credit_transaction_id_not_found"
]
},
{
"name": "Validate parent property references exist",
"description": "Validates that all <code>parent_property_reference</code> values in <code>supply_addresses</code> and <code>properties</code> correspond to a <code>property_external_identifier</code> in the payload. This ensures the property hierarchy is valid.",
"possible_errors": [
"parent_property_reference_not_found"
]
},
{
"name": "Validate that a portfolio lead account has no supply address since it makes no sense for it to have one",
"description": "Validate that a portfolio lead account has no supply address.",
"possible_errors": [
"portfolio_lead_has_a_supply_address"
]
},
{
"name": "Validate that a system account has no supply address",
"description": "Validate that a system account has no supply address",
"possible_errors": [
"system_account_has_a_supply_address"
]
},
{
"name": "Validate auto allocation of operations team",
"description": "Validate that operations_team_name is provided if auto allocation is not configured.",
"possible_errors": [
"operations_team_provided_when_using_auto_allocation",
"operations_team_should_be_provided"
]
},
{
"name": "Validate that Kraken can calculate when to start billing the account",
"description": "Validate that Kraken can calculate when to start billing the account. This is determined based on the existence of last billed to date, last statement closing date, and agreements.",
"possible_errors": [
"cannot_determine_responsible_for_billing_from_date"
]
},
{
"name": "Validate that if historical statement transaction are provided then so is a last statement closing date or last billed to date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided in the payload then either a <code>last_statement_closing_date</code> or <code>last_billed_to_date</code> is also provided. If a <code>last_statement_closing_date</code> is not provided then the earliest <code>last_billed_to_date</code> on the account or supply points is used to determine when the last statement should have closed.",
"possible_errors": [
"historical_statement_transactions_without_last_statement_closing_date_or_last_billed_to_date"
]
},
{
"name": "Validate unique transaction IDs",
"description": "Validate that all transaction IDs provided are unique.",
"possible_errors": [
"duplicate_transaction_ids",
"missing_transaction_id"
]
},
{
"name": "Validate current statement transactions are after historical statement transactions",
"description": "Validate that all current statement transactions are dated after all current historical statement transactions.",
"possible_errors": [
"historical_statement_transaction_after_current_statement_transaction"
]
},
{
"name": "Validate that there are no historical statement transactions after the last statement closing date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided then none are later than the <code>last_statement_closing_date</code>. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"historical_statement_transaction_after_last_statement_closing_date"
]
},
{
"name": "Validate that the last statement issue date is on or after the last statement closing date",
"description": "Validate that the <code>last_statement_issue_date</code>, if given, is on or after the <code>last_statement_closing_date</code> given. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"last_statement_issued_before_closing_date"
]
},
{
"name": "Validate no duplicated ledgers are provided",
"description": "Validate no duplicated ledger codes are in `ledgers` section.",
"possible_errors": [
"duplicate_ledger_entries_found"
]
},
{
"name": "Validate identifiers are unique in ledgers",
"description": "Validate identifier is not declared twice in ledgers.",
"possible_errors": [
"duplicate_identifiers_entries_found"
]
},
{
"name": "Validate ledger identifiers are known",
"description": "Validate ledger identifiers are among supply point identifiers.",
"possible_errors": [
"unknown_ledger_identifiers"
]
},
{
"name": "Validate payment adequacy changes or last payment review date not both",
"description": "Validate that only one of <code>payment_adequacy_changes</code> or <code>last_payment_review_date</code> is provided in the payload.",
"possible_errors": [
"payment_adequacy_changes_and_last_payment_review_date_provided"
]
},
{
"name": "Validate that payment plans and payment schedules for the same ledger are not both in payload",
"description": "Validate that if there are payment plans in the payload, there are not also payment schedules on the same ledger because payment plans create a schedule containing all of the planned payments.",
"possible_errors": [
"payment_plan_and_payment_schedule_not_allowed_on_same_ledger"
]
},
{
"name": "Validate no more than one property for unknown occupier",
"description": "Validate that no more than one property is provided for an unknown occupier account.",
"possible_errors": [
"occupier_account_with_multiple_supply_addresses"
]
},
{
"name": "Validate no direct debit reference for the occupier",
"description": "Validate that if any customer is identified as an occupier, then no <code>dd_reference</code> is provided for the account. If a <code>dd_reference</code> is provided, then it implies that there is a known occupier for the account.",
"possible_errors": [
"dd_reference_for_occupier_account"
]
},
{
"name": "Validate no unbilled period on former supply addresses",
"description": "Validate that if a customer is no longer at the given supply address they have been fully billed. This check is performed if we are importing supply address history.",
"possible_errors": [
"unbilled_former_supply_address"
]
},
{
"name": "Validate that agreements cover the last billed to date",
"description": "Validate that there is an agreement covering the last billed to date for each supply point.",
"possible_errors": [
"no_agreement_covering_last_billed_to_date"
]
},
{
"name": "Validate debt and debts",
"description": "Validates that both debt and debts are not specified in the payload.",
"possible_errors": [
"debt_and_debts_are_defined"
]
},
{
"name": "Validate that a last billed to date has been provided correctly",
"description": "Validate that, for each meter, a last billed to date has been provided in the appropriate place. For electricity meters, it must be provided on each of the meter's settlement registers. For gas meters, it must be provided on the meter. This validation does not apply to meters with half-hourly billing, or meters that have been exchanged where the new meter has already been billed. This validation is skipped if the account has not yet been billed and therefore has no historical statement data.",
"possible_errors": [
"last_billed_to_date_not_found"
]
},
{
"name": "Validate that current statement transactions are not before the current statement opening date",
"description": "Validate that all <code>current_statement_transactions</code>, if provided, are not before the current statement opening date. This date is one day after the last statement closing date if provided, otherwise it is based on the last billed to date. Note that any prepay vend transactions are not included in the above check.",
"possible_errors": [
"current_statement_transaction_before_current_statement_opening_date"
]
},
{
"name": "Validate <code>last_statement_balance</code> plus/minus <code>current_statement_transactions</code> equal <code>transfer_balance</code>",
"description": "Validate that the sum of <code>current_statement_transactions</code> plus the <code>last_statement_balance</code> is equal to the <code>transfer_balance</code>. For example, if a <code>last_statement_balance</code> of 100 is provided, and the <code>current_statement_transactions</code> include one payment of 50, then the expected <code>transfer_balance</code> would 150. Transactions that are payments or credits add to the balance. Transactions that are repayments or charges subtract from the balance. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"balance_mismatch_on_transfer_balance"
]
},
{
"name": "Validate that the summed historical statement transactions match the last statement balance",
"description": "Validate that the sum of the <code>historical_statement_transactions</code> equals the <code>last_statement_balance</code>. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"historical_statement_transactions_balance_mismatch"
]
},
{
"name": "Validate next bill due date provided for quarterly billing",
"description": "Validate that if <code>use_industry_billing</code> is false in the account billing options and the <code>period_length</code> is <code>QUARTERLY</code>, then a <code>next_bill_due_date</code> is provided.",
"possible_errors": [
"next_bill_to_date_not_provided_for_quarterly_billing"
]
},
{
"name": "Validate account billing options",
"description": "Validate that account billing options have only been provided for business accounts.",
"possible_errors": [
"account_billing_options_provided_for_domestic_accounts"
]
},
{
"name": "Validate alternative phone number is unique",
"description": "Validate customers defined in the payload do not have the same alternative phone numbers.",
"possible_errors": [
"duplicated_alternative_phone_numbers"
]
},
{
"name": "Validate that prepay transactions target initialised prepay meters",
"description": "Validate that if <code>current_statement_transactions</code> or <code>historical_statement_transactions</code> target a prepay meter (i.e. has the <code>to_prepay_meter_serial_number</code> field), then a prepay meter with that serial number exists in the payload. A prepay meter is identified in the payload by the presence of <code>prepay_details</code>.",
"possible_errors": [
"transactions_target_non_initialised_prepay_meter"
]
},
{
"name": "Validate tax exemption for appropriate account type",
"description": "Validate that the tax exemption is only in place for business accounts.",
"possible_errors": [
"tax_exemptions_provided_for_domestic_account"
]
},
{
"name": "Validate prepay transfer vend read dates match last billed to date",
"description": "Validate that the transfer vend read dates match the last billed to date. This only applies to prepay meters.The last billed to date can be either at the account level or the at the meter/register level. Last billed to dates at the meter/register level take precedent over the account level date if both are provided.",
"possible_errors": [
"prepay_details_on_fully_billed_meter",
"transfer_vend_read_date_must_match_last_billed_to_date"
]
},
{
"name": "Validate that the tariff type and meter point type match",
"description": "Validate that the tariff we have on a given contract matches the meter point type. For example, check eco7 (2-rate) meter points don't have single-rate tariffs or vice versa.",
"possible_errors": [
"tariff_type_does_not_match_meter_point_type"
]
},
{
"name": "Validate bespoke rates",
"description": "Validate that if bespoke rates have been set the account is business.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate billing address provided",
"description": "Validate <code>billing_address1</code> and <code>billing_postcode</code> are provided for non-occupier accounts.",
"possible_errors": [
"billing_address_not_provided"
]
},
{
"name": "Validate current AQ for billable meter point",
"description": "Check that we have a currently valid AQ for a billable MPRN.",
"possible_errors": [
"no_current_or_future_aq_entry_found"
]
},
{
"name": "Validate all billable meter points are covered by agreements in the payload",
"description": "Validate that agreements have been provided for all billable meter points and vice versa for the period covered by Kraken from a billing perspective. A billable meter point is one that has an open-ended or future dated supply end date.",
"possible_errors": [
"meter_point_with_no_agreement",
"meterpoint_with_agreement_not_on_supply"
]
},
{
"name": "Validate transfer readings exist on active gas meters",
"description": "Validate that each active gas meter has a single transfer reading provided.",
"possible_errors": [
"active_gas_meter_with_multiple_transfer_readings",
"active_gas_meter_without_transfer_reading",
"reading_meter_fully_billed"
]
},
{
"name": "Validate EACs provided for active registers",
"description": "Validate that EACs are provided in the <code>eac_history</code> array for each active electricity register. EACs are matched to registers using the <code>tpr</code> field present on both the EAC and register objects.",
"possible_errors": [
"missing_eacs_for_active_register_tpr"
]
},
{
"name": "Validate that prepay meters are matched to agreements of the correct type",
"description": "Validate that each prepay meter has a matching agreement on a prepay tariff, and similarly non-prepay meters on non-prepay tariffs. Note that this validation only applies for active meters and agreements.",
"possible_errors": [
"tariff_type_does_not_match_meter_type"
]
},
{
"name": "Validate each agreement is not effective before the product is available",
"description": "Ensures that the agreement <code>effective_from</code> is not before the datetime the agreement's product is available from. We check this if Kraken will be responsible for billing before the product is available and the product is a variable or tracker product.",
"possible_errors": [
"agreement_effective_from_before_product_available_from"
]
},
{
"name": "Validate that all variable products on a contract have start dates after the product start date",
"description": "Validate that any variable products that are part of a contract only become effective after the product is available.",
"possible_errors": [
"agreement_cannot_start_before_product_available"
]
},
{
"name": "Validate that no meter points are ending supply in the future",
"description": "Ensure that all meters points have either ended supply or are not planned for supply to end.",
"possible_errors": [
"future_supply_end_date"
]
},
{
"name": "Validate that all off supply meter points with meters have a final reading",
"description": "Ensure that all off supply meter points which have meters have a final reading on their end date.",
"possible_errors": [
"no_reading_on_supply_end_date"
]
},
{
"name": "Validate that no billable meter points are starting supply in the future",
"description": "Validate that no billable meter points are set to start supply in the future.",
"possible_errors": [
"future_supply_start_date"
]
},
{
"name": "Validate that all billable meter points have active meters",
"description": "Ensure that all meter points that are billable have active meters or have an unmetered measurement class provided in the payload.",
"possible_errors": [
"meter_point_with_no_meters"
]
},
{
"name": "Validate that at least one of the meter points needs billing",
"description": "Ensure that at least one of the meter points for this account are billable.",
"possible_errors": [
"no_supply_point_on_supply"
]
},
{
"name": "Validate that a domestic account does not have any business only supply points",
"description": "Validate that a domestic account does not have supply points with supply types <code>REGOS_EXPORT_CERTIFICATES</code> or <code>ROCS_EXPORT_CERTIFICATES</code> which are business only supply types.",
"possible_errors": [
"business_supply_type_on_domestic_account"
]
},
{
"name": "Validate business account has account billing options with <code>period_start_day</code> and <code>period_length</code>",
"description": "Validate that business account's <code>account_billing_options</code> include period start day and period length if <code>account_billing_options</code> is being provided. If <code>account_billing_options</code> is not provided then the defaults of 1 for <code>period_start_day</code> and \"MONTHLY\" for <code>period_length</code> will be used.",
"possible_errors": [
"business_account_missing_billing_options"
]
},
{
"name": "Validate that customers provided for business accounts",
"description": "Validate that at least one customer is provided for business accounts. Customers are needed for business accounts to ensure that meter points can be successfully registered for supply.",
"possible_errors": [
"business_account_missing_customers"
]
},
{
"name": "Validate current statement transactions are not before <code>last_billed_to_date</code>",
"description": "Validate that there are no current statement transactions that occurred before the <code>last_billed_to_date</code> (this includes the supply point-level <code>last_billed_to_date</code>, as well as any meter- or register-level dates where applicable).",
"possible_errors": [
"current_statement_transaction_before_last_billed_to_date"
]
},
{
"name": "Validate transfer readings exist on active electricity registers",
"description": "Validate that each active electricity meter register has a single transfer reading provided.",
"possible_errors": [
"missing_transfer_reading_for_register",
"multiple_transfer_readings_for_register"
]
}
]8 July 2026
New
{
"x-enum-descriptions": {
"potential_exchange_to_4g_comms_hub": "Potential Exchange to 4G Comms Hub"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Potential Exchange to 4G Comms Hub": "Potential Exchange to 4G Comms Hub"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"jul26_renewal_exclusive_payg": "Jul26 Renewal Exclusive PAYG"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Jul26 Renewal Exclusive PAYG": "Jul26 Renewal Exclusive PAYG"
}
}Old
{
"x-enum-descriptions": {}
}7 July 2026
New
{
"x-enum-descriptions": {
"SBEXTRANEWACQ25": "SBEXTRANEWACQ25",
"SBEXTRANEWACQ50": "SBEXTRANEWACQ50",
"SBEXTRANEWACQ100": "SBEXTRANEWACQ100",
"SBEXTRANEWACQ150": "SBEXTRANEWACQ150"
}
}Old
{
"x-enum-descriptions": {}
}6 July 2026
New
{
"x-enum-descriptions": {
"calisen_smart_meter_health_site_visit": "Calisen Smart Meter Health Site Visit"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Calisen Smart Meter Health Site Visit": "Calisen Smart Meter Health Site Visit"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"sb_hh_opt_out": "SB HH Opt outs",
"customer_support_fund_engaged": "CUSTOMER_SUPPORT_FUND_ENGAGED"
}
}Old
{
"x-enum-descriptions": {
"customer_support_fund_engaged": "Customer Support Fund \u2013 engaged"
}
}New
{
"x-enum-descriptions": {
"SB HH Opt outs": "SB HH Opt outs",
"CUSTOMER_SUPPORT_FUND_ENGAGED": "CUSTOMER_SUPPORT_FUND_ENGAGED"
}
}Old
{
"x-enum-descriptions": {
"Customer Support Fund \u2013 engaged": "Customer Support Fund \u2013 engaged"
}
}3 July 2026
New
{
"x-enum-descriptions": {
"incomemax_engaged": "INCOMEMAX_ENGAGED",
"jul26_renewal_exclusive": "Jul26 Renewal Exclusive"
}
}Old
{
"x-enum-descriptions": {
"incomemax_engaged": "IncomeMax \u2013 engaged"
}
}New
{
"x-enum-descriptions": {
"INCOMEMAX_ENGAGED": "INCOMEMAX_ENGAGED",
"Jul26 Renewal Exclusive": "Jul26 Renewal Exclusive"
}
}Old
{
"x-enum-descriptions": {
"IncomeMax \u2013 engaged": "IncomeMax \u2013 engaged"
}
}New
{
"x-enum-descriptions": {
"ca_plymouth_engaged": "CA_PLYMOUTH_ENGAGED"
}
}Old
{
"x-enum-descriptions": {
"ca_plymouth_engaged": "CA Plymouth \u2013 engaged"
}
}New
{
"x-enum-descriptions": {
"CA_PLYMOUTH_ENGAGED": "CA_PLYMOUTH_ENGAGED"
}
}Old
{
"x-enum-descriptions": {
"CA Plymouth \u2013 engaged": "CA Plymouth \u2013 engaged"
}
}New
{
"x-enum-descriptions": {
"lgos": "Large Gas on Site"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Large Gas on Site": "Large Gas on Site"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"rp_migration_porob": "RP Migration POROB"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"RP Migration POROB": "RP Migration POROB"
}
}Old
{
"x-enum-descriptions": {}
}2 July 2026
New
{
"x-enum-descriptions": {
"debt_arrangement_scheme_active": "Debt Arrangement Scheme Active"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Debt Arrangement Scheme Active": "Debt Arrangement Scheme Active"
}
}Old
{
"x-enum-descriptions": {}
}Old
{
"maxItems": 1
}30 June 2026
No attributes to display
New
[
{
"name": "Ensures only <code>user_details</code> or <code>details</code> are provided",
"description": "Ensures that only <code>user_details</code> or <code>details</code> are provided, not both.",
"possible_errors": [
"customer_details_and_user_details_both_provided"
]
},
{
"name": "Validate no contact details for occupier",
"description": "Validates that a customer identified as \"The Occupier\" does not have contact details. If contact details are provided it implies that the identity of the customer is known, and it therefore not an unknown occupier.",
"possible_errors": [
"contact_details_for_occupier"
]
},
{
"name": "Validate that the customer's name is not \"The Occupier\"",
"description": "Validate that the customer's name is not \"The Occupier\". To indicate an occupier account, use the <code>unknown_occupier</code> flag at the account-level.",
"possible_errors": [
"customer_may_not_be_named_the_occupier"
]
},
{
"name": "Validate metadata",
"description": "Validate that metadata, which is a list of key value pairs, does not contain duplicate keys.",
"possible_errors": [
"metadata_has_duplicate_keys"
]
},
{
"name": "Validate user role",
"description": "Validates that at least one user role is provided through <code>portfolio_roles</code> or <code>account_roles</code>.",
"possible_errors": [
"required_user_role"
]
},
{
"name": "Validate exclusive role assignment",
"description": "Validates that an exclusively-assignable role is not assigned to a user alongside any other role, whether in the same payload or already held by the user.",
"possible_errors": [
"customer_has_exclusive_role_conflict"
]
},
{
"name": "Validate that <code>\u2068customer_preferences\u2069</code> and <code>\u2068consents\u2069</code> are not both provided",
"description": "Validate that \u2068customer_preferences\u2069 and \u2068consents\u2069 are not both provided.",
"possible_errors": [
"fields_are_mutually_exclusive"
]
}
]Old
[
{
"name": "Ensures only <code>user_details</code> or <code>details</code> are provided",
"description": "Ensures that only <code>user_details</code> or <code>details</code> are provided, not both.",
"possible_errors": [
"customer_details_and_user_details_both_provided"
]
},
{
"name": "Validate no contact details for occupier",
"description": "Validates that a customer identified as \"The Occupier\" does not have contact details. If contact details are provided it implies that the identity of the customer is known, and it therefore not an unknown occupier.",
"possible_errors": [
"contact_details_for_occupier"
]
},
{
"name": "Validate that the customer's name is not \"The Occupier\"",
"description": "Validate that the customer's name is not \"The Occupier\". To indicate an occupier account, use the <code>unknown_occupier</code> flag at the account-level.",
"possible_errors": [
"customer_may_not_be_named_the_occupier"
]
},
{
"name": "Validate metadata",
"description": "Validate that metadata, which is a list of key value pairs, does not contain duplicate keys.",
"possible_errors": [
"metadata_has_duplicate_keys"
]
},
{
"name": "Validate user role",
"description": "Validates that at least one user role is provided through <code>portfolio_roles</code> or <code>account_roles</code>.",
"possible_errors": [
"required_user_role"
]
},
{
"name": "Validate that <code>\u2068customer_preferences\u2069</code> and <code>\u2068consents\u2069</code> are not both provided",
"description": "Validate that \u2068customer_preferences\u2069 and \u2068consents\u2069 are not both provided.",
"possible_errors": [
"fields_are_mutually_exclusive"
]
}
]
No attributes to display
No attributes to display
29 June 2026
New
{
"x-enum-descriptions": {
"fme": "FM eligible"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"FM eligible": "FM eligible"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"fmi": "FM Ineligible",
"fmtii": "FM Temp ineligible \u2013 investigate",
"fmtiea": "FM Temp ineligible - external action",
"fmtiedfa": "FM Temp ineligible - EDF action"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"FM Ineligible": "FM Ineligible",
"FM Temp ineligible - EDF action": "FM Temp ineligible - EDF action",
"FM Temp ineligible \u2013 investigate": "FM Temp ineligible \u2013 investigate",
"FM Temp ineligible - external action": "FM Temp ineligible - external action"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"fm_grc": "FM Generic Rebook Comms",
"fmtica": "FM Temp ineligible \u2013 customer action"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"FM Generic Rebook Comms": "FM Generic Rebook Comms",
"FM Temp ineligible \u2013 customer action": "FM Temp ineligible \u2013 customer action"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"smart_campaign_exclusion_mmhs": "Smart Campaign Exclusion MMHS"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Smart Campaign Exclusion MMHS": "Smart Campaign Exclusion MMHS"
}
}Old
{
"x-enum-descriptions": {}
}26 June 2026
New
{
"x-enum-descriptions": {
"solar_nb_cs": "Solar Nil Bill Case Study",
"sunday_saver_interest_capture_from_august26": "Sunday Saver Interest for August 26"
}
}Old
{
"x-enum-descriptions": {
"solar_nb_case_study": "Solar NilBill Case Study"
}
}New
{
"x-enum-descriptions": {
"Solar Nil Bill Case Study": "Solar Nil Bill Case Study",
"Sunday Saver Interest for August 26": "Sunday Saver Interest for August 26"
}
}Old
{
"x-enum-descriptions": {
"Solar NilBill Case Study": "Solar NilBill Case Study"
}
}New
{
"x-enum-descriptions": {
"solar_nb_case_study": "Solar NilBill Case Study"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Solar NilBill Case Study": "Solar NilBill Case Study"
}
}Old
{
"x-enum-descriptions": {}
}New
[
{
"name": "Validate portfolio reference provided correctly",
"description": "Validate that a portfolio reference is provided if portfolio settings have been provided and that a portfolio reference is not provided if the import supplier is set to create new portfolios.",
"possible_errors": [
"portfolio_references_missing",
"portfolio_references_provided"
]
},
{
"name": "Validate no duplicate portfolio reference namespaces",
"description": "Validate that there are no duplicate portfolio reference namespaces in the payload.",
"possible_errors": [
"duplicate_portfolio_references"
]
}
]Old
[
{
"name": "Validate portfolio reference provided correctly",
"description": "Validate that a portfolio reference is provided if portfolio settings have been provided and that a portfolio reference is not provided if the import supplier is set to create new portfolios.",
"possible_errors": [
"portfolio_references_missing",
"portfolio_references_provided"
]
}
]New
[
{
"name": "Validate portfolio reference provided correctly",
"description": "Validate that a portfolio reference is provided if portfolio settings have been provided and that a portfolio reference is not provided if the import supplier is set to create new portfolios.",
"possible_errors": [
"portfolio_references_missing",
"portfolio_references_provided"
]
},
{
"name": "Validate no duplicate portfolio reference namespaces",
"description": "Validate that there are no duplicate portfolio reference namespaces in the payload.",
"possible_errors": [
"duplicate_portfolio_references"
]
}
]Old
[
{
"name": "Validate portfolio reference provided correctly",
"description": "Validate that a portfolio reference is provided if portfolio settings have been provided and that a portfolio reference is not provided if the import supplier is set to create new portfolios.",
"possible_errors": [
"portfolio_references_missing",
"portfolio_references_provided"
]
}
]25 June 2026
New
{
"x-enum-descriptions": {
"solar_shift_v3_email": "Solar Shift V3"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Solar Shift V3": "Solar Shift V3"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"unhealthy_smart_meter_exchange_required": "Unhealthy Smart meter - exchange required"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Unhealthy Smart meter - exchange required": "Unhealthy Smart meter - exchange required"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"vm02_switch_off": "VM02 switch off"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"VM02 switch off": "VM02 switch off"
}
}Old
{
"x-enum-descriptions": {}
}23 June 2026
No attributes to display
22 June 2026
New
[
{
"name": "Validate that business information is provided if not linking account to business with contract",
"description": "Validate that business information is provided for the business to link the account to if <code>link_account_to_business_with_contract</code> is false for the given import supplier.",
"possible_errors": [
"business_information_required_if_not_linking_via_contract"
]
},
{
"name": "Validate that business information is not provided if linking an account to the business of the business contract.",
"description": "Validate that business information is not provided for the business to link the account to if <code>link_account_to_business_with_contract</code> is true for the given import supplier.",
"possible_errors": [
"business_information_not_required_if_linking_via_contract"
]
},
{
"name": "Validate that at least one contract identifier is provided for import",
"description": "Validate that at least one of <code>business_contract_identifiers</code> or <code>business_contract_identifier</code> is provided in the payload.",
"possible_errors": [
"missing_contract_identifier"
]
}
]Old
[
{
"name": "Validate that values are unique in Kraken for unique registered keys",
"description": "Validate that keys with unique constraints do not already have provided value in Kraken.",
"possible_errors": [
"business_detail_value_exists_for_unique_key"
]
},
{
"name": "Validate that business information is provided if not linking account to business with contract",
"description": "Validate that business information is provided for the business to link the account to if <code>link_account_to_business_with_contract</code> is false for the given import supplier.",
"possible_errors": [
"business_information_required_if_not_linking_via_contract"
]
},
{
"name": "Validate that business information is not provided if linking an account to the business of the business contract.",
"description": "Validate that business information is not provided for the business to link the account to if <code>link_account_to_business_with_contract</code> is true for the given import supplier.",
"possible_errors": [
"business_information_not_required_if_linking_via_contract"
]
},
{
"name": "Validate that at least one contract identifier is provided for import",
"description": "Validate that at least one of <code>business_contract_identifiers</code> or <code>business_contract_identifier</code> is provided in the payload.",
"possible_errors": [
"missing_contract_identifier"
]
}
]
No attributes to display
19 June 2026
No attributes to display
New
{
"x-enum-descriptions": {
"post_lapse_svt": "Post Lapse SVT",
"dm_debt_payment_required": "DM Debt Payment Required"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Post Lapse SVT": "Post Lapse SVT",
"DM Debt Payment Required": "DM Debt Payment Required"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"warm_home_discount_prepay_voucher_non_redeemer": "WHD - Non redeemer - Prepay Voucher"
}
}Old
{
"x-enum-descriptions": {
"whd_nr_pp": "WHD - Non redeemer - Prepay Vouchers"
}
}New
{
"x-enum-descriptions": {
"WHD - Non redeemer - Prepay Voucher": "WHD - Non redeemer - Prepay Voucher"
}
}Old
{
"x-enum-descriptions": {
"WHD - Non redeemer - Prepay Vouchers": "WHD - Non redeemer - Prepay Vouchers"
}
}New
{
"x-enum-descriptions": {
"write_off": "Write-off"
}
}Old
{
"x-enum-descriptions": {
"write_off": "Write-Off"
}
}New
{
"x-enum-descriptions": {
"Write-off": "Write-off"
}
}Old
{
"x-enum-descriptions": {
"Write-Off": "Write-Off"
}
}18 June 2026
No attributes to display
New
{
"gbr-gas.payment-method": "#/components/schemas/Gbr-gas.payment-methodCharacteristic"
}New
[
{
"$ref": "#/components/schemas/Gbr-electricity.meter-rate-profileCharacteristic"
},
{
"$ref": "#/components/schemas/Gbr-gas.payment-methodCharacteristic"
},
{
"$ref": "#/components/schemas/Gbr-gas.meter-point-grid-supply-point-equivalentCharacteristic"
},
{
"$ref": "#/components/schemas/Gbr-electricity.payment-methodCharacteristic"
},
{
"$ref": "#/components/schemas/SalesChannelCharacteristic"
}
]Old
[
{
"$ref": "#/components/schemas/Gbr-electricity.meter-rate-profileCharacteristic"
},
{
"$ref": "#/components/schemas/SalesChannelCharacteristic"
},
{
"$ref": "#/components/schemas/Gbr-gas.meter-point-grid-supply-point-equivalentCharacteristic"
},
{
"$ref": "#/components/schemas/Gbr-electricity.payment-methodCharacteristic"
}
]New
{
"x-enum-descriptions": {
"bill_vat": "Bill VAT"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Bill VAT": "Bill VAT"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"final_rts": "Final RTS"
}
}Old
{
"x-enum-descriptions": {
"rts_exotic_meter_on_site": "RTS_Exotic Meter on site",
"rts_meter_on_site_current_off_peak_times_can_be_matched": "RTS Meter on site - current off peak times can be matched",
"rts_meter_on_site_current_off_peak_times_can_not_be_matched": "RTS Meter on site - current off peak times can not be matched"
}
}New
{
"x-enum-descriptions": {
"Final RTS": "Final RTS"
}
}Old
{
"x-enum-descriptions": {
"RTS_Exotic Meter on site": "RTS_Exotic Meter on site",
"RTS Meter on site - current off peak times can be matched": "RTS Meter on site - current off peak times can be matched",
"RTS Meter on site - current off peak times can not be matched": "RTS Meter on site - current off peak times can not be matched"
}
}New
{
"x-enum-descriptions": {
"live_aged_debt_write_off": "Live Aged Debt Write-off"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Live Aged Debt Write-off": "Live Aged Debt Write-off"
}
}Old
{
"x-enum-descriptions": {}
}
No attributes to display
New
{
"gbr-gas.meter-point-grid-supply-point-equivalent": "#/components/schemas/Gbr-gas.meter-point-grid-supply-point-equivalentCharacteristic"
}New
[
{
"$ref": "#/components/schemas/Gbr-gas.meter-point-grid-supply-point-equivalentCharacteristic"
},
{
"$ref": "#/components/schemas/Gbr-electricity.meter-rate-profileCharacteristic"
},
{
"$ref": "#/components/schemas/SalesChannelCharacteristic"
},
{
"$ref": "#/components/schemas/Gbr-electricity.payment-methodCharacteristic"
}
]Old
[
{
"$ref": "#/components/schemas/Gbr-electricity.meter-rate-profileCharacteristic"
},
{
"$ref": "#/components/schemas/Gbr-electricity.payment-methodCharacteristic"
},
{
"$ref": "#/components/schemas/SalesChannelCharacteristic"
}
]17 June 2026
No attributes to display
New
{
"x-enum-descriptions": {
"dnc_dm_debt_payment_required_bo_only": "DNC DM Debt Payment Required BO only"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"DNC DM Debt Payment Required BO only": "DNC DM Debt Payment Required BO only"
}
}Old
{
"x-enum-descriptions": {}
}15 June 2026
No attributes to display
New
[
{
"name": "Validate account type is valid",
"description": "Validate that only one account type is specified in the payload.",
"possible_errors": [
"multiple_account_types_selected"
]
},
{
"name": "Validate billing address fields",
"description": "If a legacy billing address is provided, validate that it is in the correct format.",
"possible_errors": [
"invalid_address"
]
},
{
"name": "Validate customer family name",
"description": "Validate the family name is provided for all customers on a domestic account. For Business accounts, set the family name to 'Business' if it is not provided.",
"possible_errors": [
"customer_family_name_required"
]
},
{
"name": "Validate metadata",
"description": "Validate that metadata, which is a list of key value pairs, does not contain duplicate keys.",
"possible_errors": [
"metadata_has_duplicate_keys"
]
},
{
"name": "Validate unique property external identifiers",
"description": "Ensures that <code>property_external_identifier</code> is not repeated across <code>supply_addresses</code> and <code>properties</code>.",
"possible_errors": [
"duplicate_property_external_identifiers"
]
},
{
"name": "Validate managed account type is allowed",
"description": "Validate that this instance of Kraken allows managed account types.",
"possible_errors": [
"managed_accounts_are_not_allowed"
]
},
{
"name": "Validate only portfolio lead has portfolio setting",
"description": "Validates that if portfolio settings are provided, then the account is marked as the portfolio lead.",
"possible_errors": [
"portfolio_settings_included_when_not_lead"
]
},
{
"name": "Validate business type and company number not provided for domestic accounts",
"description": "Validate that neither a business type or company number are provided for domestic accounts.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate no customers for unknown occupier",
"description": "Validate that no customers are provided for an unknown occupier.",
"possible_errors": [
"customer_with_unknown_occupier"
]
},
{
"name": "Validate that a customer given name is provided for business accounts",
"description": "Validate that a given name is provided for all customers on a business account. Note that this validation only applies if Kraken is configured to send registration flows for this import supplier.",
"possible_errors": [
"customer_given_name_required"
]
},
{
"name": "Validate portfolio reference provided correctly",
"description": "Validate that a portfolio reference is provided if portfolio settings have been provided and that a portfolio reference is not provided if the import supplier is set to create new portfolios.",
"possible_errors": [
"portfolio_references_missing",
"portfolio_references_provided"
]
},
{
"name": "Validate billing address style",
"description": "Validate that a legacy billing address (<code>billing_address1</code> etc.) and new-style billing address (<code>billing_address</code> object) are not both provided.",
"possible_errors": [
"billing_address_new_style_and_legacy"
]
},
{
"name": "Validate agreements are consecutive per supply point",
"description": "Validate that the agreements provided in the payload are consecutive per supply point i.e. there are no gaps or overlaps. The exception to this is for agreements provided before the current supply period for the supply point. Agreements provided before the <code>supply_start_date</code> are allowed gaps since they represent historic periods of supply and cannot be used for billing in Kraken.",
"possible_errors": [
"gaps_or_overlaps_in_agreement_dates"
]
},
{
"name": "Validate supply charge line items covered by a single agreement",
"description": "Validate each supply charge has a single agreement with matching product code that covers the period defined by it's line items minimum <code>start_date</code> to maximum <code>end_date</code>.",
"possible_errors": [
"supply_charge_line_items_not_covered_by_single_agreement"
]
},
{
"name": "Validate historical statement period end must not be in the future",
"description": "Ensures that the historical statement period end date (last_statement_closing_date or latest transaction_date) is not set in the future.",
"possible_errors": [
"historical_statement_period_end_in_future"
]
},
{
"name": "Validate that terms with supply type matches a supply point supply type",
"description": "Validate that for terms containing a <code>supply_type</code> field that there is a supply point in the payload with a matching <code>supply_type</code>.",
"possible_errors": [
"term_supply_type_mismatch"
]
},
{
"name": "Validate that supply addresses and supply points are provided if account contracts are provided",
"description": "Validate that if <code>account_contracts</code> have been provided that a supply address with supply points has been provided under <code>supply_addresses</code>",
"possible_errors": [
"account_contracts_without_supply_points"
]
},
{
"name": "Validate historical statement billing document identifier presence",
"description": "Ensure that billing document identifiers are only provided for historical statement transactions and only when the relevant feature flag is enabled.",
"possible_errors": [
"historical_statement_billing_document_identifier_missing",
"historical_statement_billing_document_identifier_not_allowed_when_feature_flag_disabled"
]
},
{
"name": "Validate current statement transactions do not provide <code>billing_document_identifier</code>",
"description": "Validate that none of the current statement transactions include a <code>billing_document_identifier</code>, as this field is only applicable to historical statement transactions.",
"possible_errors": [
"billing_document_identifier_not_allowed_for_current_statement_transactions"
]
},
{
"name": "Validate historical statement transaction billing document identifier",
"description": "Ensure that the billing document identifier is the same for all historical statement transactions.",
"possible_errors": [
"historical_statement_billing_document_identifier_mismatch"
]
},
{
"name": "Validate that contract terms' product codes are part of supply agreements",
"description": "Ensure that any contract terms with product references have corresponding products in supply addresses.",
"possible_errors": [
"contract_term_product_code_not_in_agreements"
]
},
{
"name": "Validate that business is provided if enforcing business contracts",
"description": "Validate that the business field is provided if <code>enforce_business_contracts_exist</code> is set to True on the import supplier configuration.",
"possible_errors": [
"business_field_required"
]
},
{
"name": "Validate agreement business contract identifier is declared",
"description": "Validates that an agreement's <code>business_contract_identifier</code>, if provided, is one of the account's declared <code>business_contract_identifiers</code>.",
"possible_errors": [
"agreement_business_contract_identifier_not_declared"
]
},
{
"name": "Validate that the sum of ledger balances equals the transfer balance",
"description": "Validate that the sum of all <code>ledger_balance</code> provided for each ledger in <code>ledgers</code> equals the account-level <code>transfer_balance</code>.",
"possible_errors": [
"ledger_balances_not_equal_to_transfer_balance"
]
},
{
"name": "Validate business user info against customer info",
"description": "Validates that business user information matches the corresponding customer information for basic fields.",
"possible_errors": [
"customer_details_and_user_details_both_provided"
]
},
{
"name": "Validate payment preference <code>ledger_identifier</code>",
"description": "Ensure that the <code>ledger_identifier</code> provided has an equivalent <code>ledger</code> object with the same <code>ledger_identifier</code> .",
"possible_errors": [
"invalid_payment_preference_ledger_identifier"
]
},
{
"name": "Validate that referenced ledgers are unique in payment preferences",
"description": "Ensure that each ledger is referenced in at most one payment preference.",
"possible_errors": [
"duplicate_ledger_in_payment_preferences"
]
},
{
"name": "Validate that valid instruction_identifier provided for <code>ACTIVE_NEW</code> payment preference",
"description": "Ensure that <code>ACTIVE_NEW</code> payment preference has instruction_identifier from </code>payment_instructions</code> object.",
"possible_errors": [
"active_new_payment_preference_invalid_instruction_identifier"
]
},
{
"name": "Validate that the transactions for a voucher do not exceed its value",
"description": "Validate that the sum of all transaction values for a voucher is not greater than the value of the voucher.",
"possible_errors": [
"voucher_transactions_sum_greater_than_voucher_value"
]
},
{
"name": "Validate that each voucher charge transaction id has a matching transaction id within a transaction of type CHARGE",
"description": "Validate that each <code>voucher</code> <code>charge_transaction_id</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CHARGE in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_charge_transaction_id_not_found"
]
},
{
"name": "Validate that each voucher redemption credit transaction id has a matching transaction id within a transaction of type CREDIT",
"description": "Validate that every <code>credit_transaction_id</code> in all <code>voucher_redemptions</code> in every <code>voucher</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CREDIT in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_redemption_credit_transaction_id_not_found"
]
},
{
"name": "Validate parent property references exist",
"description": "Validates that all <code>parent_property_reference</code> values in <code>supply_addresses</code> and <code>properties</code> correspond to a <code>property_external_identifier</code> in the payload. This ensures the property hierarchy is valid.",
"possible_errors": [
"parent_property_reference_not_found"
]
},
{
"name": "Validate that a portfolio lead account has no supply address since it makes no sense for it to have one",
"description": "Validate that a portfolio lead account has no supply address.",
"possible_errors": [
"portfolio_lead_has_a_supply_address"
]
},
{
"name": "Validate that a system account has no supply address",
"description": "Validate that a system account has no supply address",
"possible_errors": [
"system_account_has_a_supply_address"
]
},
{
"name": "Validate auto allocation of operations team",
"description": "Validate that operations_team_name is provided if auto allocation is not configured.",
"possible_errors": [
"operations_team_provided_when_using_auto_allocation",
"operations_team_should_be_provided"
]
},
{
"name": "Validate that Kraken can calculate when to start billing the account",
"description": "Validate that Kraken can calculate when to start billing the account. This is determined based on the existence of last billed to date, last statement closing date, and agreements.",
"possible_errors": [
"cannot_determine_responsible_for_billing_from_date"
]
},
{
"name": "Validate that if historical statement transaction are provided then so is a last statement closing date or last billed to date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided in the payload then either a <code>last_statement_closing_date</code> or <code>last_billed_to_date</code> is also provided. If a <code>last_statement_closing_date</code> is not provided then the earliest <code>last_billed_to_date</code> on the account or supply points is used to determine when the last statement should have closed.",
"possible_errors": [
"historical_statement_transactions_without_last_statement_closing_date_or_last_billed_to_date"
]
},
{
"name": "Validate unique transaction IDs",
"description": "Validate that all transaction IDs provided are unique.",
"possible_errors": [
"duplicate_transaction_ids",
"missing_transaction_id"
]
},
{
"name": "Validate current statement transactions are after historical statement transactions",
"description": "Validate that all current statement transactions are dated after all current historical statement transactions.",
"possible_errors": [
"historical_statement_transaction_after_current_statement_transaction"
]
},
{
"name": "Validate that there are no historical statement transactions after the last statement closing date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided then none are later than the <code>last_statement_closing_date</code>. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"historical_statement_transaction_after_last_statement_closing_date"
]
},
{
"name": "Validate that the last statement issue date is on or after the last statement closing date",
"description": "Validate that the <code>last_statement_issue_date</code>, if given, is on or after the <code>last_statement_closing_date</code> given. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"last_statement_issued_before_closing_date"
]
},
{
"name": "Validate no duplicated ledgers are provided",
"description": "Validate no duplicated ledger codes are in `ledgers` section.",
"possible_errors": [
"duplicate_ledger_entries_found"
]
},
{
"name": "Validate identifiers are unique in ledgers",
"description": "Validate identifier is not declared twice in ledgers.",
"possible_errors": [
"duplicate_identifiers_entries_found"
]
},
{
"name": "Validate ledger identifiers are known",
"description": "Validate ledger identifiers are among supply point identifiers.",
"possible_errors": [
"unknown_ledger_identifiers"
]
},
{
"name": "Validate payment adequacy changes or last payment review date not both",
"description": "Validate that only one of <code>payment_adequacy_changes</code> or <code>last_payment_review_date</code> is provided in the payload.",
"possible_errors": [
"payment_adequacy_changes_and_last_payment_review_date_provided"
]
},
{
"name": "Validate that payment plans and payment schedules for the same ledger are not both in payload",
"description": "Validate that if there are payment plans in the payload, there are not also payment schedules on the same ledger because payment plans create a schedule containing all of the planned payments.",
"possible_errors": [
"payment_plan_and_payment_schedule_not_allowed_on_same_ledger"
]
},
{
"name": "Validate no more than one property for unknown occupier",
"description": "Validate that no more than one property is provided for an unknown occupier account.",
"possible_errors": [
"occupier_account_with_multiple_supply_addresses"
]
},
{
"name": "Validate no direct debit reference for the occupier",
"description": "Validate that if any customer is identified as an occupier, then no <code>dd_reference</code> is provided for the account. If a <code>dd_reference</code> is provided, then it implies that there is a known occupier for the account.",
"possible_errors": [
"dd_reference_for_occupier_account"
]
},
{
"name": "Validate no unbilled period on former supply addresses",
"description": "Validate that if a customer is no longer at the given supply address they have been fully billed. This check is performed if we are importing supply address history.",
"possible_errors": [
"unbilled_former_supply_address"
]
},
{
"name": "Validate that agreements cover the last billed to date",
"description": "Validate that there is an agreement covering the last billed to date for each supply point.",
"possible_errors": [
"no_agreement_covering_last_billed_to_date"
]
},
{
"name": "Validate debt and debts",
"description": "Validates that both debt and debts are not specified in the payload.",
"possible_errors": [
"debt_and_debts_are_defined"
]
},
{
"name": "Validate that a last billed to date has been provided correctly",
"description": "Validate that, for each meter, a last billed to date has been provided in the appropriate place. For electricity meters, it must be provided on each of the meter's settlement registers. For gas meters, it must be provided on the meter. This validation does not apply to meters with half-hourly billing, or meters that have been exchanged where the new meter has already been billed. This validation is skipped if the account has not yet been billed and therefore has no historical statement data.",
"possible_errors": [
"last_billed_to_date_not_found"
]
},
{
"name": "Validate that current statement transactions are not before the current statement opening date",
"description": "Validate that all <code>current_statement_transactions</code>, if provided, are not before the current statement opening date. This date is one day after the last statement closing date if provided, otherwise it is based on the last billed to date. Note that any prepay vend transactions are not included in the above check.",
"possible_errors": [
"current_statement_transaction_before_current_statement_opening_date"
]
},
{
"name": "Validate <code>last_statement_balance</code> plus/minus <code>current_statement_transactions</code> equal <code>transfer_balance</code>",
"description": "Validate that the sum of <code>current_statement_transactions</code> plus the <code>last_statement_balance</code> is equal to the <code>transfer_balance</code>. For example, if a <code>last_statement_balance</code> of 100 is provided, and the <code>current_statement_transactions</code> include one payment of 50, then the expected <code>transfer_balance</code> would 150. Transactions that are payments or credits add to the balance. Transactions that are repayments or charges subtract from the balance. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"balance_mismatch_on_transfer_balance"
]
},
{
"name": "Validate that the summed historical statement transactions match the last statement balance",
"description": "Validate that the sum of the <code>historical_statement_transactions</code> equals the <code>last_statement_balance</code>. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"historical_statement_transactions_balance_mismatch"
]
},
{
"name": "Validate next bill due date provided for quarterly billing",
"description": "Validate that if <code>use_industry_billing</code> is false in the account billing options and the <code>period_length</code> is <code>QUARTERLY</code>, then a <code>next_bill_due_date</code> is provided.",
"possible_errors": [
"next_bill_to_date_not_provided_for_quarterly_billing"
]
},
{
"name": "Validate account billing options",
"description": "Validate that account billing options have only been provided for business accounts.",
"possible_errors": [
"account_billing_options_provided_for_domestic_accounts"
]
},
{
"name": "Validate alternative phone number is unique",
"description": "Validate customers defined in the payload do not have the same alternative phone numbers.",
"possible_errors": [
"duplicated_alternative_phone_numbers"
]
},
{
"name": "Validate that prepay transactions target initialised prepay meters",
"description": "Validate that if <code>current_statement_transactions</code> or <code>historical_statement_transactions</code> target a prepay meter (i.e. has the <code>to_prepay_meter_serial_number</code> field), then a prepay meter with that serial number exists in the payload. A prepay meter is identified in the payload by the presence of <code>prepay_details</code>.",
"possible_errors": [
"transactions_target_non_initialised_prepay_meter"
]
},
{
"name": "Validate tax exemption for appropriate account type",
"description": "Validate that the tax exemption is only in place for business accounts.",
"possible_errors": [
"tax_exemptions_provided_for_domestic_account"
]
},
{
"name": "Validate prepay transfer vend read dates match last billed to date",
"description": "Validate that the transfer vend read dates match the last billed to date. This only applies to prepay meters.The last billed to date can be either at the account level or the at the meter/register level. Last billed to dates at the meter/register level take precedent over the account level date if both are provided.",
"possible_errors": [
"prepay_details_on_fully_billed_meter",
"transfer_vend_read_date_must_match_last_billed_to_date"
]
},
{
"name": "Validate that the tariff type and meter point type match",
"description": "Validate that the tariff we have on a given contract matches the meter point type. For example, check eco7 (2-rate) meter points don't have single-rate tariffs or vice versa.",
"possible_errors": [
"tariff_type_does_not_match_meter_point_type"
]
},
{
"name": "Validate bespoke rates",
"description": "Validate that if bespoke rates have been set the account is business.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate billing address provided",
"description": "Validate <code>billing_address1</code> and <code>billing_postcode</code> are provided for non-occupier accounts.",
"possible_errors": [
"billing_address_not_provided"
]
},
{
"name": "Validate current AQ for billable meter point",
"description": "Check that we have a currently valid AQ for a billable MPRN.",
"possible_errors": [
"no_current_or_future_aq_entry_found"
]
},
{
"name": "Validate all billable meter points are covered by agreements in the payload",
"description": "Validate that agreements have been provided for all billable meter points and vice versa for the period covered by Kraken from a billing perspective. A billable meter point is one that has an open-ended or future dated supply end date.",
"possible_errors": [
"meter_point_with_no_agreement",
"meterpoint_with_agreement_not_on_supply"
]
},
{
"name": "Validate transfer readings exist on active gas meters",
"description": "Validate that each active gas meter has a single transfer reading provided.",
"possible_errors": [
"active_gas_meter_with_multiple_transfer_readings",
"active_gas_meter_without_transfer_reading",
"reading_meter_fully_billed"
]
},
{
"name": "Validate EACs provided for active registers",
"description": "Validate that EACs are provided in the <code>eac_history</code> array for each active electricity register. EACs are matched to registers using the <code>tpr</code> field present on both the EAC and register objects.",
"possible_errors": [
"missing_eacs_for_active_register_tpr"
]
},
{
"name": "Validate that prepay meters are matched to agreements of the correct type",
"description": "Validate that each prepay meter has a matching agreement on a prepay tariff, and similarly non-prepay meters on non-prepay tariffs. Note that this validation only applies for active meters and agreements.",
"possible_errors": [
"tariff_type_does_not_match_meter_type"
]
},
{
"name": "Validate each agreement is not effective before the product is available",
"description": "Ensures that the agreement <code>effective_from</code> is not before the datetime the agreement's product is available from. We check this if Kraken will be responsible for billing before the product is available and the product is a variable or tracker product.",
"possible_errors": [
"agreement_effective_from_before_product_available_from"
]
},
{
"name": "Validate that all variable products on a contract have start dates after the product start date",
"description": "Validate that any variable products that are part of a contract only become effective after the product is available.",
"possible_errors": [
"agreement_cannot_start_before_product_available"
]
},
{
"name": "Validate that no meter points are ending supply in the future",
"description": "Ensure that all meters points have either ended supply or are not planned for supply to end.",
"possible_errors": [
"future_supply_end_date"
]
},
{
"name": "Validate that all off supply meter points with meters have a final reading",
"description": "Ensure that all off supply meter points which have meters have a final reading on their end date.",
"possible_errors": [
"no_reading_on_supply_end_date"
]
},
{
"name": "Validate that no billable meter points are starting supply in the future",
"description": "Validate that no billable meter points are set to start supply in the future.",
"possible_errors": [
"future_supply_start_date"
]
},
{
"name": "Validate that all billable meter points have active meters",
"description": "Ensure that all meter points that are billable have active meters or have an unmetered measurement class provided in the payload.",
"possible_errors": [
"meter_point_with_no_meters"
]
},
{
"name": "Validate that at least one of the meter points needs billing",
"description": "Ensure that at least one of the meter points for this account are billable.",
"possible_errors": [
"no_supply_point_on_supply"
]
},
{
"name": "Validate that a domestic account does not have any business only supply points",
"description": "Validate that a domestic account does not have supply points with supply types <code>REGOS_EXPORT_CERTIFICATES</code> or <code>ROCS_EXPORT_CERTIFICATES</code> which are business only supply types.",
"possible_errors": [
"business_supply_type_on_domestic_account"
]
},
{
"name": "Validate business account has account billing options with <code>period_start_day</code> and <code>period_length</code>",
"description": "Validate that business account's <code>account_billing_options</code> include period start day and period length if <code>account_billing_options</code> is being provided. If <code>account_billing_options</code> is not provided then the defaults of 1 for <code>period_start_day</code> and \"MONTHLY\" for <code>period_length</code> will be used.",
"possible_errors": [
"business_account_missing_billing_options"
]
},
{
"name": "Validate that customers provided for business accounts",
"description": "Validate that at least one customer is provided for business accounts. Customers are needed for business accounts to ensure that meter points can be successfully registered for supply.",
"possible_errors": [
"business_account_missing_customers"
]
},
{
"name": "Validate current statement transactions are not before <code>last_billed_to_date</code>",
"description": "Validate that there are no current statement transactions that occurred before the <code>last_billed_to_date</code> (this includes the supply point-level <code>last_billed_to_date</code>, as well as any meter- or register-level dates where applicable).",
"possible_errors": [
"current_statement_transaction_before_last_billed_to_date"
]
},
{
"name": "Validate transfer readings exist on active electricity registers",
"description": "Validate that each active electricity meter register has a single transfer reading provided.",
"possible_errors": [
"missing_transfer_reading_for_register",
"multiple_transfer_readings_for_register"
]
}
]Old
[
{
"name": "Validate account type is valid",
"description": "Validate that only one account type is specified in the payload.",
"possible_errors": [
"multiple_account_types_selected"
]
},
{
"name": "Validate billing address fields",
"description": "If a legacy billing address is provided, validate that it is in the correct format.",
"possible_errors": [
"invalid_address"
]
},
{
"name": "Validate customer family name",
"description": "Validate the family name is provided for all customers on a domestic account. For Business accounts, set the family name to 'Business' if it is not provided.",
"possible_errors": [
"customer_family_name_required"
]
},
{
"name": "Validate metadata",
"description": "Validate that metadata, which is a list of key value pairs, does not contain duplicate keys.",
"possible_errors": [
"metadata_has_duplicate_keys"
]
},
{
"name": "Validate unique property external identifiers",
"description": "Ensures that <code>property_external_identifier</code> is not repeated across <code>supply_addresses</code> and <code>properties</code>.",
"possible_errors": [
"duplicate_property_external_identifiers"
]
},
{
"name": "Validate managed account type is allowed",
"description": "Validate that this instance of Kraken allows managed account types.",
"possible_errors": [
"managed_accounts_are_not_allowed"
]
},
{
"name": "Validate only portfolio lead has portfolio setting",
"description": "Validates that if portfolio settings are provided, then the account is marked as the portfolio lead.",
"possible_errors": [
"portfolio_settings_included_when_not_lead"
]
},
{
"name": "Validate business type and company number not provided for domestic accounts",
"description": "Validate that neither a business type or company number are provided for domestic accounts.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate no customers for unknown occupier",
"description": "Validate that no customers are provided for an unknown occupier.",
"possible_errors": [
"customer_with_unknown_occupier"
]
},
{
"name": "Validate that a customer given name is provided for business accounts",
"description": "Validate that a given name is provided for all customers on a business account. Note that this validation only applies if Kraken is configured to send registration flows for this import supplier.",
"possible_errors": [
"customer_given_name_required"
]
},
{
"name": "Validate portfolio reference provided correctly",
"description": "Validate that a portfolio reference is provided if portfolio settings have been provided and that a portfolio reference is not provided if the import supplier is set to create new portfolios.",
"possible_errors": [
"portfolio_references_missing",
"portfolio_references_provided"
]
},
{
"name": "Validate billing address style",
"description": "Validate that a legacy billing address (<code>billing_address1</code> etc.) and new-style billing address (<code>billing_address</code> object) are not both provided.",
"possible_errors": [
"billing_address_new_style_and_legacy"
]
},
{
"name": "Validate agreements are consecutive per supply point",
"description": "Validate that the agreements provided in the payload are consecutive per supply point i.e. there are no gaps or overlaps. The exception to this is for agreements provided before the current supply period for the supply point. Agreements provided before the <code>supply_start_date</code> are allowed gaps since they represent historic periods of supply and cannot be used for billing in Kraken.",
"possible_errors": [
"gaps_or_overlaps_in_agreement_dates"
]
},
{
"name": "Validate supply charge line items covered by a single agreement",
"description": "Validate each supply charge has a single agreement with matching product code that covers the period defined by it's line items minimum <code>start_date</code> to maximum <code>end_date</code>.",
"possible_errors": [
"supply_charge_line_items_not_covered_by_single_agreement"
]
},
{
"name": "Validate historical statement period end must not be in the future",
"description": "Ensures that the historical statement period end date (last_statement_closing_date or latest transaction_date) is not set in the future.",
"possible_errors": [
"historical_statement_period_end_in_future"
]
},
{
"name": "Validate that terms with supply type matches a supply point supply type",
"description": "Validate that for terms containing a <code>supply_type</code> field that there is a supply point in the payload with a matching <code>supply_type</code>.",
"possible_errors": [
"term_supply_type_mismatch"
]
},
{
"name": "Validate that supply addresses and supply points are provided if account contracts are provided",
"description": "Validate that if <code>account_contracts</code> have been provided that a supply address with supply points has been provided under <code>supply_addresses</code>",
"possible_errors": [
"account_contracts_without_supply_points"
]
},
{
"name": "Validate historical statement billing document identifier presence",
"description": "Ensure that billing document identifiers are only provided for historical statement transactions and only when the relevant feature flag is enabled.",
"possible_errors": [
"historical_statement_billing_document_identifier_missing",
"historical_statement_billing_document_identifier_not_allowed_when_feature_flag_disabled"
]
},
{
"name": "Validate current statement transactions do not provide <code>billing_document_identifier</code>",
"description": "Validate that none of the current statement transactions include a <code>billing_document_identifier</code>, as this field is only applicable to historical statement transactions.",
"possible_errors": [
"billing_document_identifier_not_allowed_for_current_statement_transactions"
]
},
{
"name": "Validate historical statement transaction billing document identifier",
"description": "Ensure that the billing document identifier is the same for all historical statement transactions.",
"possible_errors": [
"historical_statement_billing_document_identifier_mismatch"
]
},
{
"name": "Validate that contract terms' product codes are part of supply agreements",
"description": "Ensure that any contract terms with product references have corresponding products in supply addresses.",
"possible_errors": [
"contract_term_product_code_not_in_agreements"
]
},
{
"name": "Validate that business is provided if enforcing business contracts",
"description": "Validate that the business field is provided if <code>enforce_business_contracts_exist</code> is set to True on the import supplier configuration.",
"possible_errors": [
"business_field_required"
]
},
{
"name": "Validate that the sum of ledger balances equals the transfer balance",
"description": "Validate that the sum of all <code>ledger_balance</code> provided for each ledger in <code>ledgers</code> equals the account-level <code>transfer_balance</code>.",
"possible_errors": [
"ledger_balances_not_equal_to_transfer_balance"
]
},
{
"name": "Validate business user info against customer info",
"description": "Validates that business user information matches the corresponding customer information for basic fields.",
"possible_errors": [
"customer_details_and_user_details_both_provided"
]
},
{
"name": "Validate payment preference <code>ledger_identifier</code>",
"description": "Ensure that the <code>ledger_identifier</code> provided has an equivalent <code>ledger</code> object with the same <code>ledger_identifier</code> .",
"possible_errors": [
"invalid_payment_preference_ledger_identifier"
]
},
{
"name": "Validate that referenced ledgers are unique in payment preferences",
"description": "Ensure that each ledger is referenced in at most one payment preference.",
"possible_errors": [
"duplicate_ledger_in_payment_preferences"
]
},
{
"name": "Validate that valid instruction_identifier provided for <code>ACTIVE_NEW</code> payment preference",
"description": "Ensure that <code>ACTIVE_NEW</code> payment preference has instruction_identifier from </code>payment_instructions</code> object.",
"possible_errors": [
"active_new_payment_preference_invalid_instruction_identifier"
]
},
{
"name": "Validate that the transactions for a voucher do not exceed its value",
"description": "Validate that the sum of all transaction values for a voucher is not greater than the value of the voucher.",
"possible_errors": [
"voucher_transactions_sum_greater_than_voucher_value"
]
},
{
"name": "Validate that each voucher charge transaction id has a matching transaction id within a transaction of type CHARGE",
"description": "Validate that each <code>voucher</code> <code>charge_transaction_id</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CHARGE in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_charge_transaction_id_not_found"
]
},
{
"name": "Validate that each voucher redemption credit transaction id has a matching transaction id within a transaction of type CREDIT",
"description": "Validate that every <code>credit_transaction_id</code> in all <code>voucher_redemptions</code> in every <code>voucher</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CREDIT in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_redemption_credit_transaction_id_not_found"
]
},
{
"name": "Validate parent property references exist",
"description": "Validates that all <code>parent_property_reference</code> values in <code>supply_addresses</code> and <code>properties</code> correspond to a <code>property_external_identifier</code> in the payload. This ensures the property hierarchy is valid.",
"possible_errors": [
"parent_property_reference_not_found"
]
},
{
"name": "Validate that a portfolio lead account has no supply address since it makes no sense for it to have one",
"description": "Validate that a portfolio lead account has no supply address.",
"possible_errors": [
"portfolio_lead_has_a_supply_address"
]
},
{
"name": "Validate that a system account has no supply address",
"description": "Validate that a system account has no supply address",
"possible_errors": [
"system_account_has_a_supply_address"
]
},
{
"name": "Validate auto allocation of operations team",
"description": "Validate that operations_team_name is provided if auto allocation is not configured.",
"possible_errors": [
"operations_team_provided_when_using_auto_allocation",
"operations_team_should_be_provided"
]
},
{
"name": "Validate that Kraken can calculate when to start billing the account",
"description": "Validate that Kraken can calculate when to start billing the account. This is determined based on the existence of last billed to date, last statement closing date, and agreements.",
"possible_errors": [
"cannot_determine_responsible_for_billing_from_date"
]
},
{
"name": "Validate that if historical statement transaction are provided then so is a last statement closing date or last billed to date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided in the payload then either a <code>last_statement_closing_date</code> or <code>last_billed_to_date</code> is also provided. If a <code>last_statement_closing_date</code> is not provided then the earliest <code>last_billed_to_date</code> on the account or supply points is used to determine when the last statement should have closed.",
"possible_errors": [
"historical_statement_transactions_without_last_statement_closing_date_or_last_billed_to_date"
]
},
{
"name": "Validate unique transaction IDs",
"description": "Validate that all transaction IDs provided are unique.",
"possible_errors": [
"duplicate_transaction_ids",
"missing_transaction_id"
]
},
{
"name": "Validate current statement transactions are after historical statement transactions",
"description": "Validate that all current statement transactions are dated after all current historical statement transactions.",
"possible_errors": [
"historical_statement_transaction_after_current_statement_transaction"
]
},
{
"name": "Validate that there are no historical statement transactions after the last statement closing date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided then none are later than the <code>last_statement_closing_date</code>. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"historical_statement_transaction_after_last_statement_closing_date"
]
},
{
"name": "Validate that the last statement issue date is on or after the last statement closing date",
"description": "Validate that the <code>last_statement_issue_date</code>, if given, is on or after the <code>last_statement_closing_date</code> given. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"last_statement_issued_before_closing_date"
]
},
{
"name": "Validate no duplicated ledgers are provided",
"description": "Validate no duplicated ledger codes are in `ledgers` section.",
"possible_errors": [
"duplicate_ledger_entries_found"
]
},
{
"name": "Validate identifiers are unique in ledgers",
"description": "Validate identifier is not declared twice in ledgers.",
"possible_errors": [
"duplicate_identifiers_entries_found"
]
},
{
"name": "Validate ledger identifiers are known",
"description": "Validate ledger identifiers are among supply point identifiers.",
"possible_errors": [
"unknown_ledger_identifiers"
]
},
{
"name": "Validate payment adequacy changes or last payment review date not both",
"description": "Validate that only one of <code>payment_adequacy_changes</code> or <code>last_payment_review_date</code> is provided in the payload.",
"possible_errors": [
"payment_adequacy_changes_and_last_payment_review_date_provided"
]
},
{
"name": "Validate that payment plans and payment schedules for the same ledger are not both in payload",
"description": "Validate that if there are payment plans in the payload, there are not also payment schedules on the same ledger because payment plans create a schedule containing all of the planned payments.",
"possible_errors": [
"payment_plan_and_payment_schedule_not_allowed_on_same_ledger"
]
},
{
"name": "Validate no more than one property for unknown occupier",
"description": "Validate that no more than one property is provided for an unknown occupier account.",
"possible_errors": [
"occupier_account_with_multiple_supply_addresses"
]
},
{
"name": "Validate no direct debit reference for the occupier",
"description": "Validate that if any customer is identified as an occupier, then no <code>dd_reference</code> is provided for the account. If a <code>dd_reference</code> is provided, then it implies that there is a known occupier for the account.",
"possible_errors": [
"dd_reference_for_occupier_account"
]
},
{
"name": "Validate no unbilled period on former supply addresses",
"description": "Validate that if a customer is no longer at the given supply address they have been fully billed. This check is performed if we are importing supply address history.",
"possible_errors": [
"unbilled_former_supply_address"
]
},
{
"name": "Validate that agreements cover the last billed to date",
"description": "Validate that there is an agreement covering the last billed to date for each supply point.",
"possible_errors": [
"no_agreement_covering_last_billed_to_date"
]
},
{
"name": "Validate debt and debts",
"description": "Validates that both debt and debts are not specified in the payload.",
"possible_errors": [
"debt_and_debts_are_defined"
]
},
{
"name": "Validate that a last billed to date has been provided correctly",
"description": "Validate that, for each meter, a last billed to date has been provided in the appropriate place. For electricity meters, it must be provided on each of the meter's settlement registers. For gas meters, it must be provided on the meter. This validation does not apply to meters with half-hourly billing, or meters that have been exchanged where the new meter has already been billed. This validation is skipped if the account has not yet been billed and therefore has no historical statement data.",
"possible_errors": [
"last_billed_to_date_not_found"
]
},
{
"name": "Validate that current statement transactions are not before the current statement opening date",
"description": "Validate that all <code>current_statement_transactions</code>, if provided, are not before the current statement opening date. This date is one day after the last statement closing date if provided, otherwise it is based on the last billed to date. Note that any prepay vend transactions are not included in the above check.",
"possible_errors": [
"current_statement_transaction_before_current_statement_opening_date"
]
},
{
"name": "Validate <code>last_statement_balance</code> plus/minus <code>current_statement_transactions</code> equal <code>transfer_balance</code>",
"description": "Validate that the sum of <code>current_statement_transactions</code> plus the <code>last_statement_balance</code> is equal to the <code>transfer_balance</code>. For example, if a <code>last_statement_balance</code> of 100 is provided, and the <code>current_statement_transactions</code> include one payment of 50, then the expected <code>transfer_balance</code> would 150. Transactions that are payments or credits add to the balance. Transactions that are repayments or charges subtract from the balance. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"balance_mismatch_on_transfer_balance"
]
},
{
"name": "Validate that the summed historical statement transactions match the last statement balance",
"description": "Validate that the sum of the <code>historical_statement_transactions</code> equals the <code>last_statement_balance</code>. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"historical_statement_transactions_balance_mismatch"
]
},
{
"name": "Validate next bill due date provided for quarterly billing",
"description": "Validate that if <code>use_industry_billing</code> is false in the account billing options and the <code>period_length</code> is <code>QUARTERLY</code>, then a <code>next_bill_due_date</code> is provided.",
"possible_errors": [
"next_bill_to_date_not_provided_for_quarterly_billing"
]
},
{
"name": "Validate account billing options",
"description": "Validate that account billing options have only been provided for business accounts.",
"possible_errors": [
"account_billing_options_provided_for_domestic_accounts"
]
},
{
"name": "Validate alternative phone number is unique",
"description": "Validate customers defined in the payload do not have the same alternative phone numbers.",
"possible_errors": [
"duplicated_alternative_phone_numbers"
]
},
{
"name": "Validate that prepay transactions target initialised prepay meters",
"description": "Validate that if <code>current_statement_transactions</code> or <code>historical_statement_transactions</code> target a prepay meter (i.e. has the <code>to_prepay_meter_serial_number</code> field), then a prepay meter with that serial number exists in the payload. A prepay meter is identified in the payload by the presence of <code>prepay_details</code>.",
"possible_errors": [
"transactions_target_non_initialised_prepay_meter"
]
},
{
"name": "Validate tax exemption for appropriate account type",
"description": "Validate that the tax exemption is only in place for business accounts.",
"possible_errors": [
"tax_exemptions_provided_for_domestic_account"
]
},
{
"name": "Validate prepay transfer vend read dates match last billed to date",
"description": "Validate that the transfer vend read dates match the last billed to date. This only applies to prepay meters.The last billed to date can be either at the account level or the at the meter/register level. Last billed to dates at the meter/register level take precedent over the account level date if both are provided.",
"possible_errors": [
"prepay_details_on_fully_billed_meter",
"transfer_vend_read_date_must_match_last_billed_to_date"
]
},
{
"name": "Validate that the tariff type and meter point type match",
"description": "Validate that the tariff we have on a given contract matches the meter point type. For example, check eco7 (2-rate) meter points don't have single-rate tariffs or vice versa.",
"possible_errors": [
"tariff_type_does_not_match_meter_point_type"
]
},
{
"name": "Validate bespoke rates",
"description": "Validate that if bespoke rates have been set the account is business.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate billing address provided",
"description": "Validate <code>billing_address1</code> and <code>billing_postcode</code> are provided for non-occupier accounts.",
"possible_errors": [
"billing_address_not_provided"
]
},
{
"name": "Validate current AQ for billable meter point",
"description": "Check that we have a currently valid AQ for a billable MPRN.",
"possible_errors": [
"no_current_or_future_aq_entry_found"
]
},
{
"name": "Validate all billable meter points are covered by agreements in the payload",
"description": "Validate that agreements have been provided for all billable meter points and vice versa for the period covered by Kraken from a billing perspective. A billable meter point is one that has an open-ended or future dated supply end date.",
"possible_errors": [
"meter_point_with_no_agreement",
"meterpoint_with_agreement_not_on_supply"
]
},
{
"name": "Validate transfer readings exist on active gas meters",
"description": "Validate that each active gas meter has a single transfer reading provided.",
"possible_errors": [
"active_gas_meter_with_multiple_transfer_readings",
"active_gas_meter_without_transfer_reading",
"reading_meter_fully_billed"
]
},
{
"name": "Validate EACs provided for active registers",
"description": "Validate that EACs are provided in the <code>eac_history</code> array for each active electricity register. EACs are matched to registers using the <code>tpr</code> field present on both the EAC and register objects.",
"possible_errors": [
"missing_eacs_for_active_register_tpr"
]
},
{
"name": "Validate that prepay meters are matched to agreements of the correct type",
"description": "Validate that each prepay meter has a matching agreement on a prepay tariff, and similarly non-prepay meters on non-prepay tariffs. Note that this validation only applies for active meters and agreements.",
"possible_errors": [
"tariff_type_does_not_match_meter_type"
]
},
{
"name": "Validate each agreement is not effective before the product is available",
"description": "Ensures that the agreement <code>effective_from</code> is not before the datetime the agreement's product is available from. We check this if Kraken will be responsible for billing before the product is available and the product is a variable or tracker product.",
"possible_errors": [
"agreement_effective_from_before_product_available_from"
]
},
{
"name": "Validate that all variable products on a contract have start dates after the product start date",
"description": "Validate that any variable products that are part of a contract only become effective after the product is available.",
"possible_errors": [
"agreement_cannot_start_before_product_available"
]
},
{
"name": "Validate that no meter points are ending supply in the future",
"description": "Ensure that all meters points have either ended supply or are not planned for supply to end.",
"possible_errors": [
"future_supply_end_date"
]
},
{
"name": "Validate that all off supply meter points with meters have a final reading",
"description": "Ensure that all off supply meter points which have meters have a final reading on their end date.",
"possible_errors": [
"no_reading_on_supply_end_date"
]
},
{
"name": "Validate that no billable meter points are starting supply in the future",
"description": "Validate that no billable meter points are set to start supply in the future.",
"possible_errors": [
"future_supply_start_date"
]
},
{
"name": "Validate that all billable meter points have active meters",
"description": "Ensure that all meter points that are billable have active meters or have an unmetered measurement class provided in the payload.",
"possible_errors": [
"meter_point_with_no_meters"
]
},
{
"name": "Validate that at least one of the meter points needs billing",
"description": "Ensure that at least one of the meter points for this account are billable.",
"possible_errors": [
"no_supply_point_on_supply"
]
},
{
"name": "Validate that a domestic account does not have any business only supply points",
"description": "Validate that a domestic account does not have supply points with supply types <code>REGOS_EXPORT_CERTIFICATES</code> or <code>ROCS_EXPORT_CERTIFICATES</code> which are business only supply types.",
"possible_errors": [
"business_supply_type_on_domestic_account"
]
},
{
"name": "Validate business account has account billing options with <code>period_start_day</code> and <code>period_length</code>",
"description": "Validate that business account's <code>account_billing_options</code> include period start day and period length if <code>account_billing_options</code> is being provided. If <code>account_billing_options</code> is not provided then the defaults of 1 for <code>period_start_day</code> and \"MONTHLY\" for <code>period_length</code> will be used.",
"possible_errors": [
"business_account_missing_billing_options"
]
},
{
"name": "Validate that customers provided for business accounts",
"description": "Validate that at least one customer is provided for business accounts. Customers are needed for business accounts to ensure that meter points can be successfully registered for supply.",
"possible_errors": [
"business_account_missing_customers"
]
},
{
"name": "Validate current statement transactions are not before <code>last_billed_to_date</code>",
"description": "Validate that there are no current statement transactions that occurred before the <code>last_billed_to_date</code> (this includes the supply point-level <code>last_billed_to_date</code>, as well as any meter- or register-level dates where applicable).",
"possible_errors": [
"current_statement_transaction_before_last_billed_to_date"
]
},
{
"name": "Validate transfer readings exist on active electricity registers",
"description": "Validate that each active electricity meter register has a single transfer reading provided.",
"possible_errors": [
"missing_transfer_reading_for_register",
"multiple_transfer_readings_for_register"
]
}
]
No attributes to display
12 June 2026
New
{
"x-enum-descriptions": {
"SB_FREE_ENERGY": "SB_FREE_ENERGY"
}
}Old
{
"x-enum-descriptions": {}
}
No attributes to display
No attributes to display
11 June 2026
New
{
"x-enum-descriptions": {
"customer_support_fund_engaged": "Customer Support Fund \u2013 engaged"
}
}Old
{
"x-enum-descriptions": {
"customer_support_fund_engaged": "Customer Support Fund Engaged"
}
}New
{
"x-enum-descriptions": {
"Customer Support Fund \u2013 engaged": "Customer Support Fund \u2013 engaged"
}
}Old
{
"x-enum-descriptions": {
"Customer Support Fund Engaged": "Customer Support Fund Engaged"
}
}10 June 2026
New
{
"x-enum-descriptions": {
"promo_50_july_renew": "Promo 50 July Renew",
"promo_100_july_renew": "Promo 100 July Renew",
"promo_150_july_renew": "Promo 150 July Renew",
"promo_200_july_renew": "Promo 200 July Renew"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Promo 50 July Renew": "Promo 50 July Renew",
"Promo 100 July Renew": "Promo 100 July Renew",
"Promo 150 July Renew": "Promo 150 July Renew",
"Promo 200 July Renew": "Promo 200 July Renew"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"incomemax_engaged": "IncomeMax \u2013 engaged"
}
}Old
{
"x-enum-descriptions": {
"incomemax_engaged": "IncomeMax Engaged"
}
}New
{
"x-enum-descriptions": {
"IncomeMax \u2013 engaged": "IncomeMax \u2013 engaged"
}
}Old
{
"x-enum-descriptions": {
"IncomeMax Engaged": "IncomeMax Engaged"
}
}New
{
"x-enum-descriptions": {
"ca_plymouth_engaged": "CA Plymouth \u2013 engaged"
}
}Old
{
"x-enum-descriptions": {
"ca_plymouth_engaged": "CA Plymouth - Engaged Customer"
}
}New
{
"x-enum-descriptions": {
"CA Plymouth \u2013 engaged": "CA Plymouth \u2013 engaged"
}
}Old
{
"x-enum-descriptions": {
"CA Plymouth - Engaged Customer": "CA Plymouth - Engaged Customer"
}
}5 June 2026
New
{
"x-enum-descriptions": {
"sb_large_capacity_meter_disconnection": "SB Large Capacity Meter Disconnection"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"SB Large Capacity Meter Disconnection": "SB Large Capacity Meter Disconnection"
}
}Old
{
"x-enum-descriptions": {}
}4 June 2026
New
{
"x-enum-descriptions": {
"jun26_renew_exclusive": "June26 Renewal Exclusive"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"June26 Renewal Exclusive": "June26 Renewal Exclusive"
}
}Old
{
"x-enum-descriptions": {}
}
No attributes to display
No attributes to display
New
[
{
"name": "Validate account type is valid",
"description": "Validate that only one account type is specified in the payload.",
"possible_errors": [
"multiple_account_types_selected"
]
},
{
"name": "Validate billing address fields",
"description": "If a legacy billing address is provided, validate that it is in the correct format.",
"possible_errors": [
"invalid_address"
]
},
{
"name": "Validate customer family name",
"description": "Validate the family name is provided for all customers on a domestic account. For Business accounts, set the family name to 'Business' if it is not provided.",
"possible_errors": [
"customer_family_name_required"
]
},
{
"name": "Validate metadata",
"description": "Validate that metadata, which is a list of key value pairs, does not contain duplicate keys.",
"possible_errors": [
"metadata_has_duplicate_keys"
]
},
{
"name": "Validate unique property external identifiers",
"description": "Ensures that <code>property_external_identifier</code> is not repeated across <code>supply_addresses</code> and <code>properties</code>.",
"possible_errors": [
"duplicate_property_external_identifiers"
]
},
{
"name": "Validate managed account type is allowed",
"description": "Validate that this instance of Kraken allows managed account types.",
"possible_errors": [
"managed_accounts_are_not_allowed"
]
},
{
"name": "Validate only portfolio lead has portfolio setting",
"description": "Validates that if portfolio settings are provided, then the account is marked as the portfolio lead.",
"possible_errors": [
"portfolio_settings_included_when_not_lead"
]
},
{
"name": "Validate business type and company number not provided for domestic accounts",
"description": "Validate that neither a business type or company number are provided for domestic accounts.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate no customers for unknown occupier",
"description": "Validate that no customers are provided for an unknown occupier.",
"possible_errors": [
"customer_with_unknown_occupier"
]
},
{
"name": "Validate that a customer given name is provided for business accounts",
"description": "Validate that a given name is provided for all customers on a business account. Note that this validation only applies if Kraken is configured to send registration flows for this import supplier.",
"possible_errors": [
"customer_given_name_required"
]
},
{
"name": "Validate portfolio reference provided correctly",
"description": "Validate that a portfolio reference is provided if portfolio settings have been provided and that a portfolio reference is not provided if the import supplier is set to create new portfolios.",
"possible_errors": [
"portfolio_references_missing",
"portfolio_references_provided"
]
},
{
"name": "Validate billing address style",
"description": "Validate that a legacy billing address (<code>billing_address1</code> etc.) and new-style billing address (<code>billing_address</code> object) are not both provided.",
"possible_errors": [
"billing_address_new_style_and_legacy"
]
},
{
"name": "Validate agreements are consecutive per supply point",
"description": "Validate that the agreements provided in the payload are consecutive per supply point i.e. there are no gaps or overlaps. The exception to this is for agreements provided before the current supply period for the supply point. Agreements provided before the <code>supply_start_date</code> are allowed gaps since they represent historic periods of supply and cannot be used for billing in Kraken.",
"possible_errors": [
"gaps_or_overlaps_in_agreement_dates"
]
},
{
"name": "Validate supply charge line items covered by a single agreement",
"description": "Validate each supply charge has a single agreement with matching product code that covers the period defined by it's line items minimum <code>start_date</code> to maximum <code>end_date</code>.",
"possible_errors": [
"supply_charge_line_items_not_covered_by_single_agreement"
]
},
{
"name": "Validate historical statement period end must not be in the future",
"description": "Ensures that the historical statement period end date (last_statement_closing_date or latest transaction_date) is not set in the future.",
"possible_errors": [
"historical_statement_period_end_in_future"
]
},
{
"name": "Validate that terms with supply type matches a supply point supply type",
"description": "Validate that for terms containing a <code>supply_type</code> field that there is a supply point in the payload with a matching <code>supply_type</code>.",
"possible_errors": [
"term_supply_type_mismatch"
]
},
{
"name": "Validate that supply addresses and supply points are provided if account contracts are provided",
"description": "Validate that if <code>account_contracts</code> have been provided that a supply address with supply points has been provided under <code>supply_addresses</code>",
"possible_errors": [
"account_contracts_without_supply_points"
]
},
{
"name": "Validate historical statement billing document identifier presence",
"description": "Ensure that billing document identifiers are only provided for historical statement transactions and only when the relevant feature flag is enabled.",
"possible_errors": [
"historical_statement_billing_document_identifier_missing",
"historical_statement_billing_document_identifier_not_allowed_when_feature_flag_disabled"
]
},
{
"name": "Validate current statement transactions do not provide <code>billing_document_identifier</code>",
"description": "Validate that none of the current statement transactions include a <code>billing_document_identifier</code>, as this field is only applicable to historical statement transactions.",
"possible_errors": [
"billing_document_identifier_not_allowed_for_current_statement_transactions"
]
},
{
"name": "Validate historical statement transaction billing document identifier",
"description": "Ensure that the billing document identifier is the same for all historical statement transactions.",
"possible_errors": [
"historical_statement_billing_document_identifier_mismatch"
]
},
{
"name": "Validate that contract terms' product codes are part of supply agreements",
"description": "Ensure that any contract terms with product references have corresponding products in supply addresses.",
"possible_errors": [
"contract_term_product_code_not_in_agreements"
]
},
{
"name": "Validate that business is provided if enforcing business contracts",
"description": "Validate that the business field is provided if <code>enforce_business_contracts_exist</code> is set to True on the import supplier configuration.",
"possible_errors": [
"business_field_required"
]
},
{
"name": "Validate that the sum of ledger balances equals the transfer balance",
"description": "Validate that the sum of all <code>ledger_balance</code> provided for each ledger in <code>ledgers</code> equals the account-level <code>transfer_balance</code>.",
"possible_errors": [
"ledger_balances_not_equal_to_transfer_balance"
]
},
{
"name": "Validate business user info against customer info",
"description": "Validates that business user information matches the corresponding customer information for basic fields.",
"possible_errors": [
"customer_details_and_user_details_both_provided"
]
},
{
"name": "Validate payment preference <code>ledger_identifier</code>",
"description": "Ensure that the <code>ledger_identifier</code> provided has an equivalent <code>ledger</code> object with the same <code>ledger_identifier</code> .",
"possible_errors": [
"invalid_payment_preference_ledger_identifier"
]
},
{
"name": "Validate that referenced ledgers are unique in payment preferences",
"description": "Ensure that each ledger is referenced in at most one payment preference.",
"possible_errors": [
"duplicate_ledger_in_payment_preferences"
]
},
{
"name": "Validate that valid instruction_identifier provided for <code>ACTIVE_NEW</code> payment preference",
"description": "Ensure that <code>ACTIVE_NEW</code> payment preference has instruction_identifier from </code>payment_instructions</code> object.",
"possible_errors": [
"active_new_payment_preference_invalid_instruction_identifier"
]
},
{
"name": "Validate that the transactions for a voucher do not exceed its value",
"description": "Validate that the sum of all transaction values for a voucher is not greater than the value of the voucher.",
"possible_errors": [
"voucher_transactions_sum_greater_than_voucher_value"
]
},
{
"name": "Validate that each voucher charge transaction id has a matching transaction id within a transaction of type CHARGE",
"description": "Validate that each <code>voucher</code> <code>charge_transaction_id</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CHARGE in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_charge_transaction_id_not_found"
]
},
{
"name": "Validate that each voucher redemption credit transaction id has a matching transaction id within a transaction of type CREDIT",
"description": "Validate that every <code>credit_transaction_id</code> in all <code>voucher_redemptions</code> in every <code>voucher</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CREDIT in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_redemption_credit_transaction_id_not_found"
]
},
{
"name": "Validate parent property references exist",
"description": "Validates that all <code>parent_property_reference</code> values in <code>supply_addresses</code> and <code>properties</code> correspond to a <code>property_external_identifier</code> in the payload. This ensures the property hierarchy is valid.",
"possible_errors": [
"parent_property_reference_not_found"
]
},
{
"name": "Validate that a portfolio lead account has no supply address since it makes no sense for it to have one",
"description": "Validate that a portfolio lead account has no supply address.",
"possible_errors": [
"portfolio_lead_has_a_supply_address"
]
},
{
"name": "Validate that a system account has no supply address",
"description": "Validate that a system account has no supply address",
"possible_errors": [
"system_account_has_a_supply_address"
]
},
{
"name": "Validate auto allocation of operations team",
"description": "Validate that operations_team_name is provided if auto allocation is not configured.",
"possible_errors": [
"operations_team_provided_when_using_auto_allocation",
"operations_team_should_be_provided"
]
},
{
"name": "Validate that Kraken can calculate when to start billing the account",
"description": "Validate that Kraken can calculate when to start billing the account. This is determined based on the existence of last billed to date, last statement closing date, and agreements.",
"possible_errors": [
"cannot_determine_responsible_for_billing_from_date"
]
},
{
"name": "Validate that if historical statement transaction are provided then so is a last statement closing date or last billed to date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided in the payload then either a <code>last_statement_closing_date</code> or <code>last_billed_to_date</code> is also provided. If a <code>last_statement_closing_date</code> is not provided then the earliest <code>last_billed_to_date</code> on the account or supply points is used to determine when the last statement should have closed.",
"possible_errors": [
"historical_statement_transactions_without_last_statement_closing_date_or_last_billed_to_date"
]
},
{
"name": "Validate unique transaction IDs",
"description": "Validate that all transaction IDs provided are unique.",
"possible_errors": [
"duplicate_transaction_ids",
"missing_transaction_id"
]
},
{
"name": "Validate current statement transactions are after historical statement transactions",
"description": "Validate that all current statement transactions are dated after all current historical statement transactions.",
"possible_errors": [
"historical_statement_transaction_after_current_statement_transaction"
]
},
{
"name": "Validate that there are no historical statement transactions after the last statement closing date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided then none are later than the <code>last_statement_closing_date</code>. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"historical_statement_transaction_after_last_statement_closing_date"
]
},
{
"name": "Validate that the last statement issue date is on or after the last statement closing date",
"description": "Validate that the <code>last_statement_issue_date</code>, if given, is on or after the <code>last_statement_closing_date</code> given. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"last_statement_issued_before_closing_date"
]
},
{
"name": "Validate no duplicated ledgers are provided",
"description": "Validate no duplicated ledger codes are in `ledgers` section.",
"possible_errors": [
"duplicate_ledger_entries_found"
]
},
{
"name": "Validate identifiers are unique in ledgers",
"description": "Validate identifier is not declared twice in ledgers.",
"possible_errors": [
"duplicate_identifiers_entries_found"
]
},
{
"name": "Validate ledger identifiers are known",
"description": "Validate ledger identifiers are among supply point identifiers.",
"possible_errors": [
"unknown_ledger_identifiers"
]
},
{
"name": "Validate payment adequacy changes or last payment review date not both",
"description": "Validate that only one of <code>payment_adequacy_changes</code> or <code>last_payment_review_date</code> is provided in the payload.",
"possible_errors": [
"payment_adequacy_changes_and_last_payment_review_date_provided"
]
},
{
"name": "Validate that payment plans and payment schedules for the same ledger are not both in payload",
"description": "Validate that if there are payment plans in the payload, there are not also payment schedules on the same ledger because payment plans create a schedule containing all of the planned payments.",
"possible_errors": [
"payment_plan_and_payment_schedule_not_allowed_on_same_ledger"
]
},
{
"name": "Validate no more than one property for unknown occupier",
"description": "Validate that no more than one property is provided for an unknown occupier account.",
"possible_errors": [
"occupier_account_with_multiple_supply_addresses"
]
},
{
"name": "Validate no direct debit reference for the occupier",
"description": "Validate that if any customer is identified as an occupier, then no <code>dd_reference</code> is provided for the account. If a <code>dd_reference</code> is provided, then it implies that there is a known occupier for the account.",
"possible_errors": [
"dd_reference_for_occupier_account"
]
},
{
"name": "Validate no unbilled period on former supply addresses",
"description": "Validate that if a customer is no longer at the given supply address they have been fully billed. This check is performed if we are importing supply address history.",
"possible_errors": [
"unbilled_former_supply_address"
]
},
{
"name": "Validate that agreements cover the last billed to date",
"description": "Validate that there is an agreement covering the last billed to date for each supply point.",
"possible_errors": [
"no_agreement_covering_last_billed_to_date"
]
},
{
"name": "Validate debt and debts",
"description": "Validates that both debt and debts are not specified in the payload.",
"possible_errors": [
"debt_and_debts_are_defined"
]
},
{
"name": "Validate that a last billed to date has been provided correctly",
"description": "Validate that, for each meter, a last billed to date has been provided in the appropriate place. For electricity meters, it must be provided on each of the meter's settlement registers. For gas meters, it must be provided on the meter. This validation does not apply to meters with half-hourly billing, or meters that have been exchanged where the new meter has already been billed. This validation is skipped if the account has not yet been billed and therefore has no historical statement data.",
"possible_errors": [
"last_billed_to_date_not_found"
]
},
{
"name": "Validate that current statement transactions are not before the current statement opening date",
"description": "Validate that all <code>current_statement_transactions</code>, if provided, are not before the current statement opening date. This date is one day after the last statement closing date if provided, otherwise it is based on the last billed to date. Note that any prepay vend transactions are not included in the above check.",
"possible_errors": [
"current_statement_transaction_before_current_statement_opening_date"
]
},
{
"name": "Validate <code>last_statement_balance</code> plus/minus <code>current_statement_transactions</code> equal <code>transfer_balance</code>",
"description": "Validate that the sum of <code>current_statement_transactions</code> plus the <code>last_statement_balance</code> is equal to the <code>transfer_balance</code>. For example, if a <code>last_statement_balance</code> of 100 is provided, and the <code>current_statement_transactions</code> include one payment of 50, then the expected <code>transfer_balance</code> would 150. Transactions that are payments or credits add to the balance. Transactions that are repayments or charges subtract from the balance. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"balance_mismatch_on_transfer_balance"
]
},
{
"name": "Validate that the summed historical statement transactions match the last statement balance",
"description": "Validate that the sum of the <code>historical_statement_transactions</code> equals the <code>last_statement_balance</code>. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"historical_statement_transactions_balance_mismatch"
]
},
{
"name": "Validate next bill due date provided for quarterly billing",
"description": "Validate that if <code>use_industry_billing</code> is false in the account billing options and the <code>period_length</code> is <code>QUARTERLY</code>, then a <code>next_bill_due_date</code> is provided.",
"possible_errors": [
"next_bill_to_date_not_provided_for_quarterly_billing"
]
},
{
"name": "Validate account billing options",
"description": "Validate that account billing options have only been provided for business accounts.",
"possible_errors": [
"account_billing_options_provided_for_domestic_accounts"
]
},
{
"name": "Validate alternative phone number is unique",
"description": "Validate customers defined in the payload do not have the same alternative phone numbers.",
"possible_errors": [
"duplicated_alternative_phone_numbers"
]
},
{
"name": "Validate that prepay transactions target initialised prepay meters",
"description": "Validate that if <code>current_statement_transactions</code> or <code>historical_statement_transactions</code> target a prepay meter (i.e. has the <code>to_prepay_meter_serial_number</code> field), then a prepay meter with that serial number exists in the payload. A prepay meter is identified in the payload by the presence of <code>prepay_details</code>.",
"possible_errors": [
"transactions_target_non_initialised_prepay_meter"
]
},
{
"name": "Validate tax exemption for appropriate account type",
"description": "Validate that the tax exemption is only in place for business accounts.",
"possible_errors": [
"tax_exemptions_provided_for_domestic_account"
]
},
{
"name": "Validate prepay transfer vend read dates match last billed to date",
"description": "Validate that the transfer vend read dates match the last billed to date. This only applies to prepay meters.The last billed to date can be either at the account level or the at the meter/register level. Last billed to dates at the meter/register level take precedent over the account level date if both are provided.",
"possible_errors": [
"prepay_details_on_fully_billed_meter",
"transfer_vend_read_date_must_match_last_billed_to_date"
]
},
{
"name": "Validate that the tariff type and meter point type match",
"description": "Validate that the tariff we have on a given contract matches the meter point type. For example, check eco7 (2-rate) meter points don't have single-rate tariffs or vice versa.",
"possible_errors": [
"tariff_type_does_not_match_meter_point_type"
]
},
{
"name": "Validate bespoke rates",
"description": "Validate that if bespoke rates have been set the account is business.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate billing address provided",
"description": "Validate <code>billing_address1</code> and <code>billing_postcode</code> are provided for non-occupier accounts.",
"possible_errors": [
"billing_address_not_provided"
]
},
{
"name": "Validate current AQ for billable meter point",
"description": "Check that we have a currently valid AQ for a billable MPRN.",
"possible_errors": [
"no_current_or_future_aq_entry_found"
]
},
{
"name": "Validate all billable meter points are covered by agreements in the payload",
"description": "Validate that agreements have been provided for all billable meter points and vice versa for the period covered by Kraken from a billing perspective. A billable meter point is one that has an open-ended or future dated supply end date.",
"possible_errors": [
"meter_point_with_no_agreement",
"meterpoint_with_agreement_not_on_supply"
]
},
{
"name": "Validate transfer readings exist on active gas meters",
"description": "Validate that each active gas meter has a single transfer reading provided.",
"possible_errors": [
"active_gas_meter_with_multiple_transfer_readings",
"active_gas_meter_without_transfer_reading",
"reading_meter_fully_billed"
]
},
{
"name": "Validate EACs provided for active registers",
"description": "Validate that EACs are provided in the <code>eac_history</code> array for each active electricity register. EACs are matched to registers using the <code>tpr</code> field present on both the EAC and register objects.",
"possible_errors": [
"missing_eacs_for_active_register_tpr"
]
},
{
"name": "Validate that prepay meters are matched to agreements of the correct type",
"description": "Validate that each prepay meter has a matching agreement on a prepay tariff, and similarly non-prepay meters on non-prepay tariffs. Note that this validation only applies for active meters and agreements.",
"possible_errors": [
"tariff_type_does_not_match_meter_type"
]
},
{
"name": "Validate each agreement is not effective before the product is available",
"description": "Ensures that the agreement <code>effective_from</code> is not before the datetime the agreement's product is available from. We check this if Kraken will be responsible for billing before the product is available and the product is a variable or tracker product.",
"possible_errors": [
"agreement_effective_from_before_product_available_from"
]
},
{
"name": "Validate that all variable products on a contract have start dates after the product start date",
"description": "Validate that any variable products that are part of a contract only become effective after the product is available.",
"possible_errors": [
"agreement_cannot_start_before_product_available"
]
},
{
"name": "Validate that no meter points are ending supply in the future",
"description": "Ensure that all meters points have either ended supply or are not planned for supply to end.",
"possible_errors": [
"future_supply_end_date"
]
},
{
"name": "Validate that all off supply meter points with meters have a final reading",
"description": "Ensure that all off supply meter points which have meters have a final reading on their end date.",
"possible_errors": [
"no_reading_on_supply_end_date"
]
},
{
"name": "Validate that no billable meter points are starting supply in the future",
"description": "Validate that no billable meter points are set to start supply in the future.",
"possible_errors": [
"future_supply_start_date"
]
},
{
"name": "Validate that all billable meter points have active meters",
"description": "Ensure that all meter points that are billable have active meters or have an unmetered measurement class provided in the payload.",
"possible_errors": [
"meter_point_with_no_meters"
]
},
{
"name": "Validate that at least one of the meter points needs billing",
"description": "Ensure that at least one of the meter points for this account are billable.",
"possible_errors": [
"no_supply_point_on_supply"
]
},
{
"name": "Validate that a domestic account does not have any business only supply points",
"description": "Validate that a domestic account does not have supply points with supply types <code>REGOS_EXPORT_CERTIFICATES</code> or <code>ROCS_EXPORT_CERTIFICATES</code> which are business only supply types.",
"possible_errors": [
"business_supply_type_on_domestic_account"
]
},
{
"name": "Validate business account has account billing options with <code>period_start_day</code> and <code>period_length</code>",
"description": "Validate that business account's <code>account_billing_options</code> include period start day and period length if <code>account_billing_options</code> is being provided. If <code>account_billing_options</code> is not provided then the defaults of 1 for <code>period_start_day</code> and \"MONTHLY\" for <code>period_length</code> will be used.",
"possible_errors": [
"business_account_missing_billing_options"
]
},
{
"name": "Validate that customers provided for business accounts",
"description": "Validate that at least one customer is provided for business accounts. Customers are needed for business accounts to ensure that meter points can be successfully registered for supply.",
"possible_errors": [
"business_account_missing_customers"
]
},
{
"name": "Validate current statement transactions are not before <code>last_billed_to_date</code>",
"description": "Validate that there are no current statement transactions that occurred before the <code>last_billed_to_date</code> (this includes the supply point-level <code>last_billed_to_date</code>, as well as any meter- or register-level dates where applicable).",
"possible_errors": [
"current_statement_transaction_before_last_billed_to_date"
]
},
{
"name": "Validate transfer readings exist on active electricity registers",
"description": "Validate that each active electricity meter register has a single transfer reading provided.",
"possible_errors": [
"missing_transfer_reading_for_register",
"multiple_transfer_readings_for_register"
]
}
]Old
[
{
"name": "Validate account type is valid",
"description": "Validate that only one account type is specified in the payload.",
"possible_errors": [
"multiple_account_types_selected"
]
},
{
"name": "Validate billing address fields",
"description": "If a legacy billing address is provided, validate that it is in the correct format.",
"possible_errors": [
"invalid_address"
]
},
{
"name": "Validate customer family name",
"description": "Validate the family name is provided for all customers on a domestic account. For Business accounts, set the family name to 'Business' if it is not provided.",
"possible_errors": [
"customer_family_name_required"
]
},
{
"name": "Validate metadata",
"description": "Validate that metadata, which is a list of key value pairs, does not contain duplicate keys.",
"possible_errors": [
"metadata_has_duplicate_keys"
]
},
{
"name": "Validate unique property external identifiers",
"description": "Ensures that <code>property_external_identifier</code> is not repeated across <code>supply_addresses</code> and <code>properties</code>.",
"possible_errors": [
"duplicate_property_external_identifiers"
]
},
{
"name": "Validate managed account type is allowed",
"description": "Validate that this instance of Kraken allows managed account types.",
"possible_errors": [
"managed_accounts_are_not_allowed"
]
},
{
"name": "Validate only portfolio lead has portfolio setting",
"description": "Validates that if portfolio settings are provided, then the account is marked as the portfolio lead.",
"possible_errors": [
"portfolio_settings_included_when_not_lead"
]
},
{
"name": "Validate business type and company number not provided for domestic accounts",
"description": "Validate that neither a business type or company number are provided for domestic accounts.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate no customers for unknown occupier",
"description": "Validate that no customers are provided for an unknown occupier.",
"possible_errors": [
"customer_with_unknown_occupier"
]
},
{
"name": "Validate that a customer given name is provided for business accounts",
"description": "Validate that a given name is provided for all customers on a business account. Note that this validation only applies if Kraken is configured to send registration flows for this import supplier.",
"possible_errors": [
"customer_given_name_required"
]
},
{
"name": "Validate portfolio reference provided correctly",
"description": "Validate that a portfolio reference is provided if portfolio settings have been provided and that a portfolio reference is not provided if the import supplier is set to create new portfolios.",
"possible_errors": [
"portfolio_references_missing",
"portfolio_references_provided"
]
},
{
"name": "Validate billing address style",
"description": "Validate that a legacy billing address (<code>billing_address1</code> etc.) and new-style billing address (<code>billing_address</code> object) are not both provided.",
"possible_errors": [
"billing_address_new_style_and_legacy"
]
},
{
"name": "Validate agreements are consecutive per supply point",
"description": "Validate that the agreements provided in the payload are consecutive per supply point i.e. there are no gaps or overlaps. The exception to this is for agreements provided before the current supply period for the supply point. Agreements provided before the <code>supply_start_date</code> are allowed gaps since they represent historic periods of supply and cannot be used for billing in Kraken.",
"possible_errors": [
"gaps_or_overlaps_in_agreement_dates"
]
},
{
"name": "Validate supply charge line items covered by a single agreement",
"description": "Validate each supply charge has a single agreement with matching product code that covers the period defined by it's line items minimum <code>start_date</code> to maximum <code>end_date</code>.",
"possible_errors": [
"supply_charge_line_items_not_covered_by_single_agreement"
]
},
{
"name": "Validate historical statement period end must not be in the future",
"description": "Ensures that the historical statement period end date (last_statement_closing_date or latest transaction_date) is not set in the future.",
"possible_errors": [
"historical_statement_period_end_in_future"
]
},
{
"name": "Validate that terms with supply type matches a supply point supply type",
"description": "Validate that for terms containing a <code>supply_type</code> field that there is a supply point in the payload with a matching <code>supply_type</code>.",
"possible_errors": [
"term_supply_type_mismatch"
]
},
{
"name": "Validate that supply addresses and supply points are provided if account contracts are provided",
"description": "Validate that if <code>account_contracts</code> have been provided that a supply address with supply points has been provided under <code>supply_addresses</code>",
"possible_errors": [
"account_contracts_without_supply_points"
]
},
{
"name": "Validate historical statement billing document identifier presence",
"description": "Ensure that billing document identifiers are only provided for historical statement transactions and only when the relevant feature flag is enabled.",
"possible_errors": [
"historical_statement_billing_document_identifier_missing",
"historical_statement_billing_document_identifier_not_allowed_when_feature_flag_disabled"
]
},
{
"name": "Validate current statement transactions do not provide <code>billing_document_identifier</code>",
"description": "Validate that none of the current statement transactions include a <code>billing_document_identifier</code>, as this field is only applicable to historical statement transactions.",
"possible_errors": [
"billing_document_identifier_not_allowed_for_current_statement_transactions"
]
},
{
"name": "Validate historical statement transaction billing document identifier",
"description": "Ensure that the billing document identifier is the same for all historical statement transactions.",
"possible_errors": [
"historical_statement_billing_document_identifier_mismatch"
]
},
{
"name": "Validate that contract terms' product codes are part of supply agreements",
"description": "Ensure that any contract terms with product references have corresponding products in supply addresses.",
"possible_errors": [
"contract_term_product_code_not_in_agreements"
]
},
{
"name": "Validate that business is provided if enforcing business contracts",
"description": "Validate that the business field is provided if <code>enforce_business_contracts_exist</code> is set to True on the import supplier configuration.",
"possible_errors": [
"business_field_required"
]
},
{
"name": "Validate that the sum of ledger balances equals the transfer balance",
"description": "Validate that the sum of all <code>ledger_balance</code> provided for each ledger in <code>ledgers</code> equals the account-level <code>transfer_balance</code>.",
"possible_errors": [
"ledger_balances_not_equal_to_transfer_balance"
]
},
{
"name": "Validate business user info against customer info",
"description": "Validates that business user information matches the corresponding customer information for basic fields.",
"possible_errors": [
"customer_details_and_user_details_both_provided"
]
},
{
"name": "Validate payment preference <code>ledger_identifier</code>",
"description": "Ensure that the <code>ledger_identifier</code> provided has an equivalent <code>ledger</code> object with the same <code>ledger_identifier</code> .",
"possible_errors": [
"invalid_payment_preference_ledger_identifier"
]
},
{
"name": "Validate that referenced ledgers are unique in payment preferences",
"description": "Ensure that each ledger is referenced in at most one payment preference.",
"possible_errors": [
"duplicate_ledger_in_payment_preferences"
]
},
{
"name": "Validate that valid instruction_identifier provided for <code>ACTIVE_NEW</code> payment preference",
"description": "Ensure that <code>ACTIVE_NEW</code> payment preference has instruction_identifier from </code>payment_instructions</code> object.",
"possible_errors": [
"active_new_payment_preference_invalid_instruction_identifier"
]
},
{
"name": "Validate that the transactions for a voucher do not exceed its value",
"description": "Validate that the sum of all transaction values for a voucher is not greater than the value of the voucher.",
"possible_errors": [
"voucher_transactions_sum_greater_than_voucher_value"
]
},
{
"name": "Validate that each voucher charge transaction id has a matching transaction id within a transaction of type CHARGE",
"description": "Validate that each <code>voucher</code> <code>charge_transaction_id</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CHARGE in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_charge_transaction_id_not_found"
]
},
{
"name": "Validate that each voucher redemption credit transaction id has a matching transaction id within a transaction of type CREDIT",
"description": "Validate that every <code>credit_transaction_id</code> in all <code>voucher_redemptions</code> in every <code>voucher</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CREDIT in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_redemption_credit_transaction_id_not_found"
]
},
{
"name": "Validate parent property references exist",
"description": "Validates that all <code>parent_property_reference</code> values in <code>supply_addresses</code> and <code>properties</code> correspond to a <code>property_external_identifier</code> in the payload. This ensures the property hierarchy is valid.",
"possible_errors": [
"parent_property_reference_not_found"
]
},
{
"name": "Validate auto allocation of operations team",
"description": "Validate that operations_team_name is provided if auto allocation is not configured.",
"possible_errors": [
"operations_team_provided_when_using_auto_allocation",
"operations_team_should_be_provided"
]
},
{
"name": "Validate that Kraken can calculate when to start billing the account",
"description": "Validate that Kraken can calculate when to start billing the account. This is determined based on the existence of last billed to date, last statement closing date, and agreements.",
"possible_errors": [
"cannot_determine_responsible_for_billing_from_date"
]
},
{
"name": "Validate that if historical statement transaction are provided then so is a last statement closing date or last billed to date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided in the payload then either a <code>last_statement_closing_date</code> or <code>last_billed_to_date</code> is also provided. If a <code>last_statement_closing_date</code> is not provided then the earliest <code>last_billed_to_date</code> on the account or supply points is used to determine when the last statement should have closed.",
"possible_errors": [
"historical_statement_transactions_without_last_statement_closing_date_or_last_billed_to_date"
]
},
{
"name": "Validate unique transaction IDs",
"description": "Validate that all transaction IDs provided are unique.",
"possible_errors": [
"duplicate_transaction_ids",
"missing_transaction_id"
]
},
{
"name": "Validate current statement transactions are after historical statement transactions",
"description": "Validate that all current statement transactions are dated after all current historical statement transactions.",
"possible_errors": [
"historical_statement_transaction_after_current_statement_transaction"
]
},
{
"name": "Validate that there are no historical statement transactions after the last statement closing date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided then none are later than the <code>last_statement_closing_date</code>. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"historical_statement_transaction_after_last_statement_closing_date"
]
},
{
"name": "Validate that the last statement issue date is on or after the last statement closing date",
"description": "Validate that the <code>last_statement_issue_date</code>, if given, is on or after the <code>last_statement_closing_date</code> given. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"last_statement_issued_before_closing_date"
]
},
{
"name": "Validate no duplicated ledgers are provided",
"description": "Validate no duplicated ledger codes are in `ledgers` section.",
"possible_errors": [
"duplicate_ledger_entries_found"
]
},
{
"name": "Validate identifiers are unique in ledgers",
"description": "Validate identifier is not declared twice in ledgers.",
"possible_errors": [
"duplicate_identifiers_entries_found"
]
},
{
"name": "Validate ledger identifiers are known",
"description": "Validate ledger identifiers are among supply point identifiers.",
"possible_errors": [
"unknown_ledger_identifiers"
]
},
{
"name": "Validate payment adequacy changes or last payment review date not both",
"description": "Validate that only one of <code>payment_adequacy_changes</code> or <code>last_payment_review_date</code> is provided in the payload.",
"possible_errors": [
"payment_adequacy_changes_and_last_payment_review_date_provided"
]
},
{
"name": "Validate that payment plans and payment schedules for the same ledger are not both in payload",
"description": "Validate that if there are payment plans in the payload, there are not also payment schedules on the same ledger because payment plans create a schedule containing all of the planned payments.",
"possible_errors": [
"payment_plan_and_payment_schedule_not_allowed_on_same_ledger"
]
},
{
"name": "Validate no more than one property for unknown occupier",
"description": "Validate that no more than one property is provided for an unknown occupier account.",
"possible_errors": [
"occupier_account_with_multiple_supply_addresses"
]
},
{
"name": "Validate no direct debit reference for the occupier",
"description": "Validate that if any customer is identified as an occupier, then no <code>dd_reference</code> is provided for the account. If a <code>dd_reference</code> is provided, then it implies that there is a known occupier for the account.",
"possible_errors": [
"dd_reference_for_occupier_account"
]
},
{
"name": "Validate no unbilled period on former supply addresses",
"description": "Validate that if a customer is no longer at the given supply address they have been fully billed. This check is performed if we are importing supply address history.",
"possible_errors": [
"unbilled_former_supply_address"
]
},
{
"name": "Validate that agreements cover the last billed to date",
"description": "Validate that there is an agreement covering the last billed to date for each supply point.",
"possible_errors": [
"no_agreement_covering_last_billed_to_date"
]
},
{
"name": "Validate debt and debts",
"description": "Validates that both debt and debts are not specified in the payload.",
"possible_errors": [
"debt_and_debts_are_defined"
]
},
{
"name": "Validate that a last billed to date has been provided correctly",
"description": "Validate that, for each meter, a last billed to date has been provided in the appropriate place. For electricity meters, it must be provided on each of the meter's settlement registers. For gas meters, it must be provided on the meter. This validation does not apply to meters with half-hourly billing, or meters that have been exchanged where the new meter has already been billed. This validation is skipped if the account has not yet been billed and therefore has no historical statement data.",
"possible_errors": [
"last_billed_to_date_not_found"
]
},
{
"name": "Validate that current statement transactions are not before the current statement opening date",
"description": "Validate that all <code>current_statement_transactions</code>, if provided, are not before the current statement opening date. This date is one day after the last statement closing date if provided, otherwise it is based on the last billed to date. Note that any prepay vend transactions are not included in the above check.",
"possible_errors": [
"current_statement_transaction_before_current_statement_opening_date"
]
},
{
"name": "Validate <code>last_statement_balance</code> plus/minus <code>current_statement_transactions</code> equal <code>transfer_balance</code>",
"description": "Validate that the sum of <code>current_statement_transactions</code> plus the <code>last_statement_balance</code> is equal to the <code>transfer_balance</code>. For example, if a <code>last_statement_balance</code> of 100 is provided, and the <code>current_statement_transactions</code> include one payment of 50, then the expected <code>transfer_balance</code> would 150. Transactions that are payments or credits add to the balance. Transactions that are repayments or charges subtract from the balance. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"balance_mismatch_on_transfer_balance"
]
},
{
"name": "Validate that the summed historical statement transactions match the last statement balance",
"description": "Validate that the sum of the <code>historical_statement_transactions</code> equals the <code>last_statement_balance</code>. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"historical_statement_transactions_balance_mismatch"
]
},
{
"name": "Validate next bill due date provided for quarterly billing",
"description": "Validate that if <code>use_industry_billing</code> is false in the account billing options and the <code>period_length</code> is <code>QUARTERLY</code>, then a <code>next_bill_due_date</code> is provided.",
"possible_errors": [
"next_bill_to_date_not_provided_for_quarterly_billing"
]
},
{
"name": "Validate account billing options",
"description": "Validate that account billing options have only been provided for business accounts.",
"possible_errors": [
"account_billing_options_provided_for_domestic_accounts"
]
},
{
"name": "Validate alternative phone number is unique",
"description": "Validate customers defined in the payload do not have the same alternative phone numbers.",
"possible_errors": [
"duplicated_alternative_phone_numbers"
]
},
{
"name": "Validate that prepay transactions target initialised prepay meters",
"description": "Validate that if <code>current_statement_transactions</code> or <code>historical_statement_transactions</code> target a prepay meter (i.e. has the <code>to_prepay_meter_serial_number</code> field), then a prepay meter with that serial number exists in the payload. A prepay meter is identified in the payload by the presence of <code>prepay_details</code>.",
"possible_errors": [
"transactions_target_non_initialised_prepay_meter"
]
},
{
"name": "Validate tax exemption for appropriate account type",
"description": "Validate that the tax exemption is only in place for business accounts.",
"possible_errors": [
"tax_exemptions_provided_for_domestic_account"
]
},
{
"name": "Validate prepay transfer vend read dates match last billed to date",
"description": "Validate that the transfer vend read dates match the last billed to date. This only applies to prepay meters.The last billed to date can be either at the account level or the at the meter/register level. Last billed to dates at the meter/register level take precedent over the account level date if both are provided.",
"possible_errors": [
"prepay_details_on_fully_billed_meter",
"transfer_vend_read_date_must_match_last_billed_to_date"
]
},
{
"name": "Validate that the tariff type and meter point type match",
"description": "Validate that the tariff we have on a given contract matches the meter point type. For example, check eco7 (2-rate) meter points don't have single-rate tariffs or vice versa.",
"possible_errors": [
"tariff_type_does_not_match_meter_point_type"
]
},
{
"name": "Validate bespoke rates",
"description": "Validate that if bespoke rates have been set the account is business.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate billing address provided",
"description": "Validate <code>billing_address1</code> and <code>billing_postcode</code> are provided for non-occupier accounts.",
"possible_errors": [
"billing_address_not_provided"
]
},
{
"name": "Validate current AQ for billable meter point",
"description": "Check that we have a currently valid AQ for a billable MPRN.",
"possible_errors": [
"no_current_or_future_aq_entry_found"
]
},
{
"name": "Validate all billable meter points are covered by agreements in the payload",
"description": "Validate that agreements have been provided for all billable meter points and vice versa for the period covered by Kraken from a billing perspective. A billable meter point is one that has an open-ended or future dated supply end date.",
"possible_errors": [
"meter_point_with_no_agreement",
"meterpoint_with_agreement_not_on_supply"
]
},
{
"name": "Validate transfer readings exist on active gas meters",
"description": "Validate that each active gas meter has a single transfer reading provided.",
"possible_errors": [
"active_gas_meter_with_multiple_transfer_readings",
"active_gas_meter_without_transfer_reading",
"reading_meter_fully_billed"
]
},
{
"name": "Validate EACs provided for active registers",
"description": "Validate that EACs are provided in the <code>eac_history</code> array for each active electricity register. EACs are matched to registers using the <code>tpr</code> field present on both the EAC and register objects.",
"possible_errors": [
"missing_eacs_for_active_register_tpr"
]
},
{
"name": "Validate that prepay meters are matched to agreements of the correct type",
"description": "Validate that each prepay meter has a matching agreement on a prepay tariff, and similarly non-prepay meters on non-prepay tariffs. Note that this validation only applies for active meters and agreements.",
"possible_errors": [
"tariff_type_does_not_match_meter_type"
]
},
{
"name": "Validate each agreement is not effective before the product is available",
"description": "Ensures that the agreement <code>effective_from</code> is not before the datetime the agreement's product is available from. We check this if Kraken will be responsible for billing before the product is available and the product is a variable or tracker product.",
"possible_errors": [
"agreement_effective_from_before_product_available_from"
]
},
{
"name": "Validate that all variable products on a contract have start dates after the product start date",
"description": "Validate that any variable products that are part of a contract only become effective after the product is available.",
"possible_errors": [
"agreement_cannot_start_before_product_available"
]
},
{
"name": "Validate that no meter points are ending supply in the future",
"description": "Ensure that all meters points have either ended supply or are not planned for supply to end.",
"possible_errors": [
"future_supply_end_date"
]
},
{
"name": "Validate that all off supply meter points with meters have a final reading",
"description": "Ensure that all off supply meter points which have meters have a final reading on their end date.",
"possible_errors": [
"no_reading_on_supply_end_date"
]
},
{
"name": "Validate that no billable meter points are starting supply in the future",
"description": "Validate that no billable meter points are set to start supply in the future.",
"possible_errors": [
"future_supply_start_date"
]
},
{
"name": "Validate that all billable meter points have active meters",
"description": "Ensure that all meter points that are billable have active meters or have an unmetered measurement class provided in the payload.",
"possible_errors": [
"meter_point_with_no_meters"
]
},
{
"name": "Validate that at least one of the meter points needs billing",
"description": "Ensure that at least one of the meter points for this account are billable.",
"possible_errors": [
"no_supply_point_on_supply"
]
},
{
"name": "Validate that a domestic account does not have any business only supply points",
"description": "Validate that a domestic account does not have supply points with supply types <code>REGOS_EXPORT_CERTIFICATES</code> or <code>ROCS_EXPORT_CERTIFICATES</code> which are business only supply types.",
"possible_errors": [
"business_supply_type_on_domestic_account"
]
},
{
"name": "Validate business account has account billing options with <code>period_start_day</code> and <code>period_length</code>",
"description": "Validate that business account's <code>account_billing_options</code> include period start day and period length if <code>account_billing_options</code> is being provided. If <code>account_billing_options</code> is not provided then the defaults of 1 for <code>period_start_day</code> and \"MONTHLY\" for <code>period_length</code> will be used.",
"possible_errors": [
"business_account_missing_billing_options"
]
},
{
"name": "Validate that customers provided for business accounts",
"description": "Validate that at least one customer is provided for business accounts. Customers are needed for business accounts to ensure that meter points can be successfully registered for supply.",
"possible_errors": [
"business_account_missing_customers"
]
},
{
"name": "Validate current statement transactions are not before <code>last_billed_to_date</code>",
"description": "Validate that there are no current statement transactions that occurred before the <code>last_billed_to_date</code> (this includes the supply point-level <code>last_billed_to_date</code>, as well as any meter- or register-level dates where applicable).",
"possible_errors": [
"current_statement_transaction_before_last_billed_to_date"
]
},
{
"name": "Validate transfer readings exist on active electricity registers",
"description": "Validate that each active electricity meter register has a single transfer reading provided.",
"possible_errors": [
"missing_transfer_reading_for_register",
"multiple_transfer_readings_for_register"
]
}
]New
{
"x-enum-descriptions": {
"SYSTEM": "System"
}
}Old
{
"x-enum-descriptions": {}
}2 June 2026
New
{
"x-enum-descriptions": {
"official_complaint": "Official Complaint"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Official Complaint": "Official Complaint"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-validators": [
{
"name": "Validate that the market participant exists",
"description": "Validate that the market participant ID passed in the payload exists in Kraken.",
"possible_errors": [
"market_participant_not_found",
"supply_type_not_recognised"
]
}
]
}1 June 2026
New
{
"x-enum-descriptions": {
"high_value_debt_validation": "High Value Debt Validation"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"High Value Debt Validation": "High Value Debt Validation"
}
}Old
{
"x-enum-descriptions": {}
}31 May 2026
New
{
"x-enum-descriptions": {
"sb_no_room_for_hot_shoe": "SB - No Room for Hot shoe",
"sb_warrant_dno_required": "SB Warrant - DNO Required",
"sb_warrant_technical_meter_issues": "SB Warrant - Technical Meter Issues",
"sb_warrant_locksmith_or_shutter_engineer": "SB Warrant - Locksmith or Shutter Engineer"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"SB - No Room for Hot shoe": "SB - No Room for Hot shoe",
"SB Warrant - DNO Required": "SB Warrant - DNO Required",
"SB Warrant - Technical Meter Issues": "SB Warrant - Technical Meter Issues",
"SB Warrant - Locksmith or Shutter Engineer": "SB Warrant - Locksmith or Shutter Engineer"
}
}Old
{
"x-enum-descriptions": {}
}28 May 2026
New
{
"x-enum-descriptions": {
"missing_comms_hub_guid_required": "Missing Comms Hub GUID - Request from customer"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Missing Comms Hub GUID - Request from customer": "Missing Comms Hub GUID - Request from customer"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {}
}Old
{
"x-enum-descriptions": {
"missing_chf_guid_required": "Missing CHF GUID - Request from customer"
}
}New
{
"x-enum-descriptions": {}
}Old
{
"x-enum-descriptions": {
"Missing CHF GUID - Request from customer": "Missing CHF GUID - Request from customer"
}
}27 May 2026
New
{
"x-enum-descriptions": {
"whd_nr_pp": "WHD - Non redeemer - Prepay Vouchers",
"whd_nr_cheque": "WHD - Non redeemer - Cheques"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"WHD - Non redeemer - Cheques": "WHD - Non redeemer - Cheques",
"WHD - Non redeemer - Prepay Vouchers": "WHD - Non redeemer - Prepay Vouchers"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"FOOTBALL_CREDIT": "FOOTBALL_CREDIT"
}
}Old
{
"x-enum-descriptions": {
"WORLD_CUP_CREDIT": "WORLD_CUP_CREDIT"
}
}26 May 2026
New
{
"x-enum-descriptions": {
"missing_meter_and_chf_guid": "Missing Meter and CHF GUID - Request both from customer"
}
}Old
{
"x-enum-descriptions": {
"missing_guid_required": "Missing GUID - Request from customer"
}
}New
{
"x-enum-descriptions": {
"Missing Meter and CHF GUID - Request both from customer": "Missing Meter and CHF GUID - Request both from customer"
}
}Old
{
"x-enum-descriptions": {
"Missing GUID - Request from customer": "Missing GUID - Request from customer"
}
}New
{
"x-enum-descriptions": {
"UUEDF26": "UUEDF26"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"united_utilities_staff": "United Utilities Staff"
}
}Old
{
"x-enum-descriptions": {
"field_meter_read_visit_outcome_meter_removed": "Field Meter Read Visit Outcome_Meter Removed"
}
}New
{
"x-enum-descriptions": {
"United Utilities Staff": "United Utilities Staff"
}
}Old
{
"x-enum-descriptions": {
"Field Meter Read Visit Outcome_Meter Removed": "Field Meter Read Visit Outcome_Meter Removed"
}
}New
{
"x-enum-descriptions": {
"promo_50_svt_may26": "Promo 50 SVT May26"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Promo 50 SVT May26": "Promo 50 SVT May26"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"sb_bb_debt_payment_required": "SB BB Debt Payment Required"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"SB BB Debt Payment Required": "SB BB Debt Payment Required"
}
}Old
{
"x-enum-descriptions": {}
}24 May 2026
No attributes to display
No attributes to display
No attributes to display
21 May 2026
No attributes to display
New
[
{
"name": "Validate account type is valid",
"description": "Validate that only one account type is specified in the payload.",
"possible_errors": [
"multiple_account_types_selected"
]
},
{
"name": "Validate billing address fields",
"description": "If a legacy billing address is provided, validate that it is in the correct format.",
"possible_errors": [
"invalid_address"
]
},
{
"name": "Validate customer family name",
"description": "Validate the family name is provided for all customers on a domestic account. For Business accounts, set the family name to 'Business' if it is not provided.",
"possible_errors": [
"customer_family_name_required"
]
},
{
"name": "Validate metadata",
"description": "Validate that metadata, which is a list of key value pairs, does not contain duplicate keys.",
"possible_errors": [
"metadata_has_duplicate_keys"
]
},
{
"name": "Validate unique property external identifiers",
"description": "Ensures that <code>property_external_identifier</code> is not repeated across <code>supply_addresses</code> and <code>properties</code>.",
"possible_errors": [
"duplicate_property_external_identifiers"
]
},
{
"name": "Validate managed account type is allowed",
"description": "Validate that this instance of Kraken allows managed account types.",
"possible_errors": [
"managed_accounts_are_not_allowed"
]
},
{
"name": "Validate only portfolio lead has portfolio setting",
"description": "Validates that if portfolio settings are provided, then the account is marked as the portfolio lead.",
"possible_errors": [
"portfolio_settings_included_when_not_lead"
]
},
{
"name": "Validate business type and company number not provided for domestic accounts",
"description": "Validate that neither a business type or company number are provided for domestic accounts.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate no customers for unknown occupier",
"description": "Validate that no customers are provided for an unknown occupier.",
"possible_errors": [
"customer_with_unknown_occupier"
]
},
{
"name": "Validate that a customer given name is provided for business accounts",
"description": "Validate that a given name is provided for all customers on a business account. Note that this validation only applies if Kraken is configured to send registration flows for this import supplier.",
"possible_errors": [
"customer_given_name_required"
]
},
{
"name": "Validate portfolio reference provided correctly",
"description": "Validate that a portfolio reference is provided if portfolio settings have been provided and that a portfolio reference is not provided if the import supplier is set to create new portfolios.",
"possible_errors": [
"portfolio_references_missing",
"portfolio_references_provided"
]
},
{
"name": "Validate billing address style",
"description": "Validate that a legacy billing address (<code>billing_address1</code> etc.) and new-style billing address (<code>billing_address</code> object) are not both provided.",
"possible_errors": [
"billing_address_new_style_and_legacy"
]
},
{
"name": "Validate agreements are consecutive per supply point",
"description": "Validate that the agreements provided in the payload are consecutive per supply point i.e. there are no gaps or overlaps. The exception to this is for agreements provided before the current supply period for the supply point. Agreements provided before the <code>supply_start_date</code> are allowed gaps since they represent historic periods of supply and cannot be used for billing in Kraken.",
"possible_errors": [
"gaps_or_overlaps_in_agreement_dates"
]
},
{
"name": "Validate supply charge line items covered by a single agreement",
"description": "Validate each supply charge has a single agreement with matching product code that covers the period defined by it's line items minimum <code>start_date</code> to maximum <code>end_date</code>.",
"possible_errors": [
"supply_charge_line_items_not_covered_by_single_agreement"
]
},
{
"name": "Validate historical statement period end must not be in the future",
"description": "Ensures that the historical statement period end date (last_statement_closing_date or latest transaction_date) is not set in the future.",
"possible_errors": [
"historical_statement_period_end_in_future"
]
},
{
"name": "Validate that terms with supply type matches a supply point supply type",
"description": "Validate that for terms containing a <code>supply_type</code> field that there is a supply point in the payload with a matching <code>supply_type</code>.",
"possible_errors": [
"term_supply_type_mismatch"
]
},
{
"name": "Validate that supply addresses and supply points are provided if account contracts are provided",
"description": "Validate that if <code>account_contracts</code> have been provided that a supply address with supply points has been provided under <code>supply_addresses</code>",
"possible_errors": [
"account_contracts_without_supply_points"
]
},
{
"name": "Validate historical statement billing document identifier presence",
"description": "Ensure that billing document identifiers are only provided for historical statement transactions and only when the relevant feature flag is enabled.",
"possible_errors": [
"historical_statement_billing_document_identifier_missing",
"historical_statement_billing_document_identifier_not_allowed_when_feature_flag_disabled"
]
},
{
"name": "Validate current statement transactions do not provide <code>billing_document_identifier</code>",
"description": "Validate that none of the current statement transactions include a <code>billing_document_identifier</code>, as this field is only applicable to historical statement transactions.",
"possible_errors": [
"billing_document_identifier_not_allowed_for_current_statement_transactions"
]
},
{
"name": "Validate historical statement transaction billing document identifier",
"description": "Ensure that the billing document identifier is the same for all historical statement transactions.",
"possible_errors": [
"historical_statement_billing_document_identifier_mismatch"
]
},
{
"name": "Validate that contract terms' product codes are part of supply agreements",
"description": "Ensure that any contract terms with product references have corresponding products in supply addresses.",
"possible_errors": [
"contract_term_product_code_not_in_agreements"
]
},
{
"name": "Validate that business is provided if enforcing business contracts",
"description": "Validate that the business field is provided if <code>enforce_business_contracts_exist</code> is set to True on the import supplier configuration.",
"possible_errors": [
"business_field_required"
]
},
{
"name": "Validate that the sum of ledger balances equals the transfer balance",
"description": "Validate that the sum of all <code>ledger_balance</code> provided for each ledger in <code>ledgers</code> equals the account-level <code>transfer_balance</code>.",
"possible_errors": [
"ledger_balances_not_equal_to_transfer_balance"
]
},
{
"name": "Validate business user info against customer info",
"description": "Validates that business user information matches the corresponding customer information for basic fields.",
"possible_errors": [
"customer_details_and_user_details_both_provided"
]
},
{
"name": "Validate payment preference <code>ledger_identifier</code>",
"description": "Ensure that the <code>ledger_identifier</code> provided has an equivalent <code>ledger</code> object with the same <code>ledger_identifier</code> .",
"possible_errors": [
"invalid_payment_preference_ledger_identifier"
]
},
{
"name": "Validate that referenced ledgers are unique in payment preferences",
"description": "Ensure that each ledger is referenced in at most one payment preference.",
"possible_errors": [
"duplicate_ledger_in_payment_preferences"
]
},
{
"name": "Validate that valid instruction_identifier provided for <code>ACTIVE_NEW</code> payment preference",
"description": "Ensure that <code>ACTIVE_NEW</code> payment preference has instruction_identifier from </code>payment_instructions</code> object.",
"possible_errors": [
"active_new_payment_preference_invalid_instruction_identifier"
]
},
{
"name": "Validate that the transactions for a voucher do not exceed its value",
"description": "Validate that the sum of all transaction values for a voucher is not greater than the value of the voucher.",
"possible_errors": [
"voucher_transactions_sum_greater_than_voucher_value"
]
},
{
"name": "Validate that each voucher charge transaction id has a matching transaction id within a transaction of type CHARGE",
"description": "Validate that each <code>voucher</code> <code>charge_transaction_id</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CHARGE in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_charge_transaction_id_not_found"
]
},
{
"name": "Validate that each voucher redemption credit transaction id has a matching transaction id within a transaction of type CREDIT",
"description": "Validate that every <code>credit_transaction_id</code> in all <code>voucher_redemptions</code> in every <code>voucher</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CREDIT in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_redemption_credit_transaction_id_not_found"
]
},
{
"name": "Validate parent property references exist",
"description": "Validates that all <code>parent_property_reference</code> values in <code>supply_addresses</code> and <code>properties</code> correspond to a <code>property_external_identifier</code> in the payload. This ensures the property hierarchy is valid.",
"possible_errors": [
"parent_property_reference_not_found"
]
},
{
"name": "Validate auto allocation of operations team",
"description": "Validate that operations_team_name is provided if auto allocation is not configured.",
"possible_errors": [
"operations_team_provided_when_using_auto_allocation",
"operations_team_should_be_provided"
]
},
{
"name": "Validate that Kraken can calculate when to start billing the account",
"description": "Validate that Kraken can calculate when to start billing the account. This is determined based on the existence of last billed to date, last statement closing date, and agreements.",
"possible_errors": [
"cannot_determine_responsible_for_billing_from_date"
]
},
{
"name": "Validate that if historical statement transaction are provided then so is a last statement closing date or last billed to date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided in the payload then either a <code>last_statement_closing_date</code> or <code>last_billed_to_date</code> is also provided. If a <code>last_statement_closing_date</code> is not provided then the earliest <code>last_billed_to_date</code> on the account or supply points is used to determine when the last statement should have closed.",
"possible_errors": [
"historical_statement_transactions_without_last_statement_closing_date_or_last_billed_to_date"
]
},
{
"name": "Validate unique transaction IDs",
"description": "Validate that all transaction IDs provided are unique.",
"possible_errors": [
"duplicate_transaction_ids",
"missing_transaction_id"
]
},
{
"name": "Validate current statement transactions are after historical statement transactions",
"description": "Validate that all current statement transactions are dated after all current historical statement transactions.",
"possible_errors": [
"historical_statement_transaction_after_current_statement_transaction"
]
},
{
"name": "Validate that there are no historical statement transactions after the last statement closing date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided then none are later than the <code>last_statement_closing_date</code>. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"historical_statement_transaction_after_last_statement_closing_date"
]
},
{
"name": "Validate that the last statement issue date is on or after the last statement closing date",
"description": "Validate that the <code>last_statement_issue_date</code>, if given, is on or after the <code>last_statement_closing_date</code> given. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"last_statement_issued_before_closing_date"
]
},
{
"name": "Validate no duplicated ledgers are provided",
"description": "Validate no duplicated ledger codes are in `ledgers` section.",
"possible_errors": [
"duplicate_ledger_entries_found"
]
},
{
"name": "Validate identifiers are unique in ledgers",
"description": "Validate identifier is not declared twice in ledgers.",
"possible_errors": [
"duplicate_identifiers_entries_found"
]
},
{
"name": "Validate ledger identifiers are known",
"description": "Validate ledger identifiers are among supply point identifiers.",
"possible_errors": [
"unknown_ledger_identifiers"
]
},
{
"name": "Validate payment adequacy changes or last payment review date not both",
"description": "Validate that only one of <code>payment_adequacy_changes</code> or <code>last_payment_review_date</code> is provided in the payload.",
"possible_errors": [
"payment_adequacy_changes_and_last_payment_review_date_provided"
]
},
{
"name": "Validate that payment plans and payment schedules for the same ledger are not both in payload",
"description": "Validate that if there are payment plans in the payload, there are not also payment schedules on the same ledger because payment plans create a schedule containing all of the planned payments.",
"possible_errors": [
"payment_plan_and_payment_schedule_not_allowed_on_same_ledger"
]
},
{
"name": "Validate no more than one property for unknown occupier",
"description": "Validate that no more than one property is provided for an unknown occupier account.",
"possible_errors": [
"occupier_account_with_multiple_supply_addresses"
]
},
{
"name": "Validate no direct debit reference for the occupier",
"description": "Validate that if any customer is identified as an occupier, then no <code>dd_reference</code> is provided for the account. If a <code>dd_reference</code> is provided, then it implies that there is a known occupier for the account.",
"possible_errors": [
"dd_reference_for_occupier_account"
]
},
{
"name": "Validate no unbilled period on former supply addresses",
"description": "Validate that if a customer is no longer at the given supply address they have been fully billed. This check is performed if we are importing supply address history.",
"possible_errors": [
"unbilled_former_supply_address"
]
},
{
"name": "Validate that agreements cover the last billed to date",
"description": "Validate that there is an agreement covering the last billed to date for each supply point.",
"possible_errors": [
"no_agreement_covering_last_billed_to_date"
]
},
{
"name": "Validate debt and debts",
"description": "Validates that both debt and debts are not specified in the payload.",
"possible_errors": [
"debt_and_debts_are_defined"
]
},
{
"name": "Validate that a last billed to date has been provided correctly",
"description": "Validate that, for each meter, a last billed to date has been provided in the appropriate place. For electricity meters, it must be provided on each of the meter's settlement registers. For gas meters, it must be provided on the meter. This validation does not apply to meters with half-hourly billing, or meters that have been exchanged where the new meter has already been billed. This validation is skipped if the account has not yet been billed and therefore has no historical statement data.",
"possible_errors": [
"last_billed_to_date_not_found"
]
},
{
"name": "Validate that current statement transactions are not before the current statement opening date",
"description": "Validate that all <code>current_statement_transactions</code>, if provided, are not before the current statement opening date. This date is one day after the last statement closing date if provided, otherwise it is based on the last billed to date. Note that any prepay vend transactions are not included in the above check.",
"possible_errors": [
"current_statement_transaction_before_current_statement_opening_date"
]
},
{
"name": "Validate <code>last_statement_balance</code> plus/minus <code>current_statement_transactions</code> equal <code>transfer_balance</code>",
"description": "Validate that the sum of <code>current_statement_transactions</code> plus the <code>last_statement_balance</code> is equal to the <code>transfer_balance</code>. For example, if a <code>last_statement_balance</code> of 100 is provided, and the <code>current_statement_transactions</code> include one payment of 50, then the expected <code>transfer_balance</code> would 150. Transactions that are payments or credits add to the balance. Transactions that are repayments or charges subtract from the balance. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"balance_mismatch_on_transfer_balance"
]
},
{
"name": "Validate that the summed historical statement transactions match the last statement balance",
"description": "Validate that the sum of the <code>historical_statement_transactions</code> equals the <code>last_statement_balance</code>. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"historical_statement_transactions_balance_mismatch"
]
},
{
"name": "Validate next bill due date provided for quarterly billing",
"description": "Validate that if <code>use_industry_billing</code> is false in the account billing options and the <code>period_length</code> is <code>QUARTERLY</code>, then a <code>next_bill_due_date</code> is provided.",
"possible_errors": [
"next_bill_to_date_not_provided_for_quarterly_billing"
]
},
{
"name": "Validate account billing options",
"description": "Validate that account billing options have only been provided for business accounts.",
"possible_errors": [
"account_billing_options_provided_for_domestic_accounts"
]
},
{
"name": "Validate alternative phone number is unique",
"description": "Validate customers defined in the payload do not have the same alternative phone numbers.",
"possible_errors": [
"duplicated_alternative_phone_numbers"
]
},
{
"name": "Validate that prepay transactions target initialised prepay meters",
"description": "Validate that if <code>current_statement_transactions</code> or <code>historical_statement_transactions</code> target a prepay meter (i.e. has the <code>to_prepay_meter_serial_number</code> field), then a prepay meter with that serial number exists in the payload. A prepay meter is identified in the payload by the presence of <code>prepay_details</code>.",
"possible_errors": [
"transactions_target_non_initialised_prepay_meter"
]
},
{
"name": "Validate tax exemption for appropriate account type",
"description": "Validate that the tax exemption is only in place for business accounts.",
"possible_errors": [
"tax_exemptions_provided_for_domestic_account"
]
},
{
"name": "Validate prepay transfer vend read dates match last billed to date",
"description": "Validate that the transfer vend read dates match the last billed to date. This only applies to prepay meters.The last billed to date can be either at the account level or the at the meter/register level. Last billed to dates at the meter/register level take precedent over the account level date if both are provided.",
"possible_errors": [
"prepay_details_on_fully_billed_meter",
"transfer_vend_read_date_must_match_last_billed_to_date"
]
},
{
"name": "Validate that the tariff type and meter point type match",
"description": "Validate that the tariff we have on a given contract matches the meter point type. For example, check eco7 (2-rate) meter points don't have single-rate tariffs or vice versa.",
"possible_errors": [
"tariff_type_does_not_match_meter_point_type"
]
},
{
"name": "Validate bespoke rates",
"description": "Validate that if bespoke rates have been set the account is business.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate billing address provided",
"description": "Validate <code>billing_address1</code> and <code>billing_postcode</code> are provided for non-occupier accounts.",
"possible_errors": [
"billing_address_not_provided"
]
},
{
"name": "Validate current AQ for billable meter point",
"description": "Check that we have a currently valid AQ for a billable MPRN.",
"possible_errors": [
"no_current_or_future_aq_entry_found"
]
},
{
"name": "Validate all billable meter points are covered by agreements in the payload",
"description": "Validate that agreements have been provided for all billable meter points and vice versa for the period covered by Kraken from a billing perspective. A billable meter point is one that has an open-ended or future dated supply end date.",
"possible_errors": [
"meter_point_with_no_agreement",
"meterpoint_with_agreement_not_on_supply"
]
},
{
"name": "Validate transfer readings exist on active gas meters",
"description": "Validate that each active gas meter has a single transfer reading provided.",
"possible_errors": [
"active_gas_meter_with_multiple_transfer_readings",
"active_gas_meter_without_transfer_reading",
"reading_meter_fully_billed"
]
},
{
"name": "Validate EACs provided for active registers",
"description": "Validate that EACs are provided in the <code>eac_history</code> array for each active electricity register. EACs are matched to registers using the <code>tpr</code> field present on both the EAC and register objects.",
"possible_errors": [
"missing_eacs_for_active_register_tpr"
]
},
{
"name": "Validate that prepay meters are matched to agreements of the correct type",
"description": "Validate that each prepay meter has a matching agreement on a prepay tariff, and similarly non-prepay meters on non-prepay tariffs. Note that this validation only applies for active meters and agreements.",
"possible_errors": [
"tariff_type_does_not_match_meter_type"
]
},
{
"name": "Validate each agreement is not effective before the product is available",
"description": "Ensures that the agreement <code>effective_from</code> is not before the datetime the agreement's product is available from. We check this if Kraken will be responsible for billing before the product is available and the product is a variable or tracker product.",
"possible_errors": [
"agreement_effective_from_before_product_available_from"
]
},
{
"name": "Validate that all variable products on a contract have start dates after the product start date",
"description": "Validate that any variable products that are part of a contract only become effective after the product is available.",
"possible_errors": [
"agreement_cannot_start_before_product_available"
]
},
{
"name": "Validate that no meter points are ending supply in the future",
"description": "Ensure that all meters points have either ended supply or are not planned for supply to end.",
"possible_errors": [
"future_supply_end_date"
]
},
{
"name": "Validate that all off supply meter points with meters have a final reading",
"description": "Ensure that all off supply meter points which have meters have a final reading on their end date.",
"possible_errors": [
"no_reading_on_supply_end_date"
]
},
{
"name": "Validate that no billable meter points are starting supply in the future",
"description": "Validate that no billable meter points are set to start supply in the future.",
"possible_errors": [
"future_supply_start_date"
]
},
{
"name": "Validate that all billable meter points have active meters",
"description": "Ensure that all meter points that are billable have active meters or have an unmetered measurement class provided in the payload.",
"possible_errors": [
"meter_point_with_no_meters"
]
},
{
"name": "Validate that at least one of the meter points needs billing",
"description": "Ensure that at least one of the meter points for this account are billable.",
"possible_errors": [
"no_supply_point_on_supply"
]
},
{
"name": "Validate that a domestic account does not have any business only supply points",
"description": "Validate that a domestic account does not have supply points with supply types <code>REGOS_EXPORT_CERTIFICATES</code> or <code>ROCS_EXPORT_CERTIFICATES</code> which are business only supply types.",
"possible_errors": [
"business_supply_type_on_domestic_account"
]
},
{
"name": "Validate business account has account billing options with <code>period_start_day</code> and <code>period_length</code>",
"description": "Validate that business account's <code>account_billing_options</code> include period start day and period length if <code>account_billing_options</code> is being provided. If <code>account_billing_options</code> is not provided then the defaults of 1 for <code>period_start_day</code> and \"MONTHLY\" for <code>period_length</code> will be used.",
"possible_errors": [
"business_account_missing_billing_options"
]
},
{
"name": "Validate that customers provided for business accounts",
"description": "Validate that at least one customer is provided for business accounts. Customers are needed for business accounts to ensure that meter points can be successfully registered for supply.",
"possible_errors": [
"business_account_missing_customers"
]
},
{
"name": "Validate current statement transactions are not before <code>last_billed_to_date</code>",
"description": "Validate that there are no current statement transactions that occurred before the <code>last_billed_to_date</code> (this includes the supply point-level <code>last_billed_to_date</code>, as well as any meter- or register-level dates where applicable).",
"possible_errors": [
"current_statement_transaction_before_last_billed_to_date"
]
},
{
"name": "Validate transfer readings exist on active electricity registers",
"description": "Validate that each active electricity meter register has a single transfer reading provided.",
"possible_errors": [
"missing_transfer_reading_for_register",
"multiple_transfer_readings_for_register"
]
}
]Old
[
{
"name": "Validate account type is valid",
"description": "Validate that only one account type is specified in the payload.",
"possible_errors": [
"multiple_account_types_selected"
]
},
{
"name": "Validate billing address fields",
"description": "If a legacy billing address is provided, validate that it is in the correct format.",
"possible_errors": [
"invalid_address"
]
},
{
"name": "Validate customer family name",
"description": "Validate the family name is provided for all customers on a domestic account. For Business accounts, set the family name to 'Business' if it is not provided.",
"possible_errors": [
"customer_family_name_required"
]
},
{
"name": "Validate metadata",
"description": "Validate that metadata, which is a list of key value pairs, does not contain duplicate keys.",
"possible_errors": [
"metadata_has_duplicate_keys"
]
},
{
"name": "Validate unique property external identifiers",
"description": "Ensures that <code>property_external_identifier</code> is not repeated across <code>supply_addresses</code> and <code>properties</code>.",
"possible_errors": [
"duplicate_property_external_identifiers"
]
},
{
"name": "Validate managed account type is allowed",
"description": "Validate that this instance of Kraken allows managed account types.",
"possible_errors": [
"managed_accounts_are_not_allowed"
]
},
{
"name": "Validate only portfolio lead has portfolio setting",
"description": "Validates that if portfolio settings are provided, then the account is marked as the portfolio lead.",
"possible_errors": [
"portfolio_settings_included_when_not_lead"
]
},
{
"name": "Validate business type and company number not provided for domestic accounts",
"description": "Validate that neither a business type or company number are provided for domestic accounts.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate no customers for unknown occupier",
"description": "Validate that no customers are provided for an unknown occupier.",
"possible_errors": [
"customer_with_unknown_occupier"
]
},
{
"name": "Validate that a customer given name is provided for business accounts",
"description": "Validate that a given name is provided for all customers on a business account. Note that this validation only applies if Kraken is configured to send registration flows for this import supplier.",
"possible_errors": [
"customer_given_name_required"
]
},
{
"name": "Validate portfolio reference provided correctly",
"description": "Validate that a portfolio reference is provided if portfolio settings have been provided and that a portfolio reference is not provided if the import supplier is set to create new portfolios.",
"possible_errors": [
"portfolio_references_missing",
"portfolio_references_provided"
]
},
{
"name": "Validate billing address style",
"description": "Validate that a legacy billing address (<code>billing_address1</code> etc.) and new-style billing address (<code>billing_address</code> object) are not both provided.",
"possible_errors": [
"billing_address_new_style_and_legacy"
]
},
{
"name": "Validate agreements are consecutive per supply point",
"description": "Validate that the agreements provided in the payload are consecutive per supply point i.e. there are no gaps or overlaps. The exception to this is for agreements provided before the current supply period for the supply point. Agreements provided before the <code>supply_start_date</code> are allowed gaps since they represent historic periods of supply and cannot be used for billing in Kraken.",
"possible_errors": [
"gaps_or_overlaps_in_agreement_dates"
]
},
{
"name": "Validate supply charge line items covered by a single agreement",
"description": "Validate each supply charge has a single agreement with matching product code that covers the period defined by it's line items minimum <code>start_date</code> to maximum <code>end_date</code>.",
"possible_errors": [
"supply_charge_line_items_not_covered_by_single_agreement"
]
},
{
"name": "Validate historical statement period end must not be in the future",
"description": "Ensures that the historical statement period end date (last_statement_closing_date or latest transaction_date) is not set in the future.",
"possible_errors": [
"historical_statement_period_end_in_future"
]
},
{
"name": "Validate that terms with supply type matches a supply point supply type",
"description": "Validate that for terms containing a <code>supply_type</code> field that there is a supply point in the payload with a matching <code>supply_type</code>.",
"possible_errors": [
"term_supply_type_mismatch"
]
},
{
"name": "Validate that supply addresses and supply points are provided if account contracts are provided",
"description": "Validate that if <code>account_contracts</code> have been provided that a supply address with supply points has been provided under <code>supply_addresses</code>",
"possible_errors": [
"account_contracts_without_supply_points"
]
},
{
"name": "Validate historical statement billing document identifier presence",
"description": "Ensure that billing document identifiers are only provided for historical statement transactions and only when the relevant feature flag is enabled.",
"possible_errors": [
"historical_statement_billing_document_identifier_missing",
"historical_statement_billing_document_identifier_not_allowed_when_feature_flag_disabled"
]
},
{
"name": "Validate current statement transactions do not provide <code>billing_document_identifier</code>",
"description": "Validate that none of the current statement transactions include a <code>billing_document_identifier</code>, as this field is only applicable to historical statement transactions.",
"possible_errors": [
"billing_document_identifier_not_allowed_for_current_statement_transactions"
]
},
{
"name": "Validate historical statement transaction billing document identifier",
"description": "Ensure that the billing document identifier is the same for all historical statement transactions.",
"possible_errors": [
"historical_statement_billing_document_identifier_mismatch"
]
},
{
"name": "Validate that contract terms' product codes are part of supply agreements",
"description": "Ensure that any contract terms with product references have corresponding products in supply addresses.",
"possible_errors": [
"contract_term_product_code_not_in_agreements"
]
},
{
"name": "Validate that business is provided if enforcing business contracts",
"description": "Validate that the business field is provided if <code>enforce_business_contracts_exist</code> is set to True on the import supplier configuration.",
"possible_errors": [
"business_field_required"
]
},
{
"name": "Validate that the sum of ledger balances equals the transfer balance",
"description": "Validate that the sum of all <code>ledger_balance</code> provided for each ledger in <code>ledgers</code> equals the account-level <code>transfer_balance</code>.",
"possible_errors": [
"ledger_balances_not_equal_to_transfer_balance"
]
},
{
"name": "Validate business user info against customer info",
"description": "Validates that business user information matches the corresponding customer information for basic fields.",
"possible_errors": [
"customer_details_and_user_details_both_provided"
]
},
{
"name": "Validate payment preference <code>ledger_identifier</code>",
"description": "Ensure that the <code>ledger_identifier</code> provided has an equivalent <code>ledger</code> object with the same <code>ledger_identifier</code> .",
"possible_errors": [
"invalid_payment_preference_ledger_identifier"
]
},
{
"name": "Validate that referenced ledgers are unique in payment preferences",
"description": "Ensure that each ledger is referenced in at most one payment preference.",
"possible_errors": [
"duplicate_ledger_in_payment_preferences"
]
},
{
"name": "Validate that valid instruction_identifier provided for <code>ACTIVE_NEW</code> payment preference",
"description": "Ensure that <code>ACTIVE_NEW</code> payment preference has instruction_identifier from </code>payment_instructions</code> object.",
"possible_errors": [
"active_new_payment_preference_invalid_instruction_identifier"
]
},
{
"name": "Validate that the transactions for a voucher do not exceed its value",
"description": "Validate that the sum of all transaction values for a voucher is not greater than the value of the voucher.",
"possible_errors": [
"voucher_transactions_sum_greater_than_voucher_value"
]
},
{
"name": "Validate that each voucher charge transaction id has a matching transaction id within a transaction of type CHARGE",
"description": "Validate that each <code>voucher</code> <code>charge_transaction_id</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CHARGE in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_charge_transaction_id_not_found"
]
},
{
"name": "Validate that each voucher redemption credit transaction id has a matching transaction id within a transaction of type CREDIT",
"description": "Validate that every <code>credit_transaction_id</code> in all <code>voucher_redemptions</code> in every <code>voucher</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CREDIT in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_redemption_credit_transaction_id_not_found"
]
},
{
"name": "Validate auto allocation of operations team",
"description": "Validate that operations_team_name is provided if auto allocation is not configured.",
"possible_errors": [
"operations_team_provided_when_using_auto_allocation",
"operations_team_should_be_provided"
]
},
{
"name": "Validate that Kraken can calculate when to start billing the account",
"description": "Validate that Kraken can calculate when to start billing the account. This is determined based on the existence of last billed to date, last statement closing date, and agreements.",
"possible_errors": [
"cannot_determine_responsible_for_billing_from_date"
]
},
{
"name": "Validate that if historical statement transaction are provided then so is a last statement closing date or last billed to date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided in the payload then either a <code>last_statement_closing_date</code> or <code>last_billed_to_date</code> is also provided. If a <code>last_statement_closing_date</code> is not provided then the earliest <code>last_billed_to_date</code> on the account or supply points is used to determine when the last statement should have closed.",
"possible_errors": [
"historical_statement_transactions_without_last_statement_closing_date_or_last_billed_to_date"
]
},
{
"name": "Validate unique transaction IDs",
"description": "Validate that all transaction IDs provided are unique.",
"possible_errors": [
"duplicate_transaction_ids",
"missing_transaction_id"
]
},
{
"name": "Validate current statement transactions are after historical statement transactions",
"description": "Validate that all current statement transactions are dated after all current historical statement transactions.",
"possible_errors": [
"historical_statement_transaction_after_current_statement_transaction"
]
},
{
"name": "Validate that there are no historical statement transactions after the last statement closing date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided then none are later than the <code>last_statement_closing_date</code>. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"historical_statement_transaction_after_last_statement_closing_date"
]
},
{
"name": "Validate that the last statement issue date is on or after the last statement closing date",
"description": "Validate that the <code>last_statement_issue_date</code>, if given, is on or after the <code>last_statement_closing_date</code> given. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"last_statement_issued_before_closing_date"
]
},
{
"name": "Validate no duplicated ledgers are provided",
"description": "Validate no duplicated ledger codes are in `ledgers` section.",
"possible_errors": [
"duplicate_ledger_entries_found"
]
},
{
"name": "Validate identifiers are unique in ledgers",
"description": "Validate identifier is not declared twice in ledgers.",
"possible_errors": [
"duplicate_identifiers_entries_found"
]
},
{
"name": "Validate ledger identifiers are known",
"description": "Validate ledger identifiers are among supply point identifiers.",
"possible_errors": [
"unknown_ledger_identifiers"
]
},
{
"name": "Validate payment adequacy changes or last payment review date not both",
"description": "Validate that only one of <code>payment_adequacy_changes</code> or <code>last_payment_review_date</code> is provided in the payload.",
"possible_errors": [
"payment_adequacy_changes_and_last_payment_review_date_provided"
]
},
{
"name": "Validate that payment plans and payment schedules for the same ledger are not both in payload",
"description": "Validate that if there are payment plans in the payload, there are not also payment schedules on the same ledger because payment plans create a schedule containing all of the planned payments.",
"possible_errors": [
"payment_plan_and_payment_schedule_not_allowed_on_same_ledger"
]
},
{
"name": "Validate no more than one property for unknown occupier",
"description": "Validate that no more than one property is provided for an unknown occupier account.",
"possible_errors": [
"occupier_account_with_multiple_supply_addresses"
]
},
{
"name": "Validate no direct debit reference for the occupier",
"description": "Validate that if any customer is identified as an occupier, then no <code>dd_reference</code> is provided for the account. If a <code>dd_reference</code> is provided, then it implies that there is a known occupier for the account.",
"possible_errors": [
"dd_reference_for_occupier_account"
]
},
{
"name": "Validate no unbilled period on former supply addresses",
"description": "Validate that if a customer is no longer at the given supply address they have been fully billed. This check is performed if we are importing supply address history.",
"possible_errors": [
"unbilled_former_supply_address"
]
},
{
"name": "Validate that agreements cover the last billed to date",
"description": "Validate that there is an agreement covering the last billed to date for each supply point.",
"possible_errors": [
"no_agreement_covering_last_billed_to_date"
]
},
{
"name": "Validate debt and debts",
"description": "Validates that both debt and debts are not specified in the payload.",
"possible_errors": [
"debt_and_debts_are_defined"
]
},
{
"name": "Validate that a last billed to date has been provided correctly",
"description": "Validate that, for each meter, a last billed to date has been provided in the appropriate place. For electricity meters, it must be provided on each of the meter's settlement registers. For gas meters, it must be provided on the meter. This validation does not apply to meters with half-hourly billing, or meters that have been exchanged where the new meter has already been billed. This validation is skipped if the account has not yet been billed and therefore has no historical statement data.",
"possible_errors": [
"last_billed_to_date_not_found"
]
},
{
"name": "Validate that current statement transactions are not before the current statement opening date",
"description": "Validate that all <code>current_statement_transactions</code>, if provided, are not before the current statement opening date. This date is one day after the last statement closing date if provided, otherwise it is based on the last billed to date. Note that any prepay vend transactions are not included in the above check.",
"possible_errors": [
"current_statement_transaction_before_current_statement_opening_date"
]
},
{
"name": "Validate <code>last_statement_balance</code> plus/minus <code>current_statement_transactions</code> equal <code>transfer_balance</code>",
"description": "Validate that the sum of <code>current_statement_transactions</code> plus the <code>last_statement_balance</code> is equal to the <code>transfer_balance</code>. For example, if a <code>last_statement_balance</code> of 100 is provided, and the <code>current_statement_transactions</code> include one payment of 50, then the expected <code>transfer_balance</code> would 150. Transactions that are payments or credits add to the balance. Transactions that are repayments or charges subtract from the balance. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"balance_mismatch_on_transfer_balance"
]
},
{
"name": "Validate that the summed historical statement transactions match the last statement balance",
"description": "Validate that the sum of the <code>historical_statement_transactions</code> equals the <code>last_statement_balance</code>. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"historical_statement_transactions_balance_mismatch"
]
},
{
"name": "Validate next bill due date provided for quarterly billing",
"description": "Validate that if <code>use_industry_billing</code> is false in the account billing options and the <code>period_length</code> is <code>QUARTERLY</code>, then a <code>next_bill_due_date</code> is provided.",
"possible_errors": [
"next_bill_to_date_not_provided_for_quarterly_billing"
]
},
{
"name": "Validate account billing options",
"description": "Validate that account billing options have only been provided for business accounts.",
"possible_errors": [
"account_billing_options_provided_for_domestic_accounts"
]
},
{
"name": "Validate alternative phone number is unique",
"description": "Validate customers defined in the payload do not have the same alternative phone numbers.",
"possible_errors": [
"duplicated_alternative_phone_numbers"
]
},
{
"name": "Validate that prepay transactions target initialised prepay meters",
"description": "Validate that if <code>current_statement_transactions</code> or <code>historical_statement_transactions</code> target a prepay meter (i.e. has the <code>to_prepay_meter_serial_number</code> field), then a prepay meter with that serial number exists in the payload. A prepay meter is identified in the payload by the presence of <code>prepay_details</code>.",
"possible_errors": [
"transactions_target_non_initialised_prepay_meter"
]
},
{
"name": "Validate tax exemption for appropriate account type",
"description": "Validate that the tax exemption is only in place for business accounts.",
"possible_errors": [
"tax_exemptions_provided_for_domestic_account"
]
},
{
"name": "Validate prepay transfer vend read dates match last billed to date",
"description": "Validate that the transfer vend read dates match the last billed to date. This only applies to prepay meters.The last billed to date can be either at the account level or the at the meter/register level. Last billed to dates at the meter/register level take precedent over the account level date if both are provided.",
"possible_errors": [
"prepay_details_on_fully_billed_meter",
"transfer_vend_read_date_must_match_last_billed_to_date"
]
},
{
"name": "Validate that the tariff type and meter point type match",
"description": "Validate that the tariff we have on a given contract matches the meter point type. For example, check eco7 (2-rate) meter points don't have single-rate tariffs or vice versa.",
"possible_errors": [
"tariff_type_does_not_match_meter_point_type"
]
},
{
"name": "Validate bespoke rates",
"description": "Validate that if bespoke rates have been set the account is business.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate billing address provided",
"description": "Validate <code>billing_address1</code> and <code>billing_postcode</code> are provided for non-occupier accounts.",
"possible_errors": [
"billing_address_not_provided"
]
},
{
"name": "Validate current AQ for billable meter point",
"description": "Check that we have a currently valid AQ for a billable MPRN.",
"possible_errors": [
"no_current_or_future_aq_entry_found"
]
},
{
"name": "Validate all billable meter points are covered by agreements in the payload",
"description": "Validate that agreements have been provided for all billable meter points and vice versa for the period covered by Kraken from a billing perspective. A billable meter point is one that has an open-ended or future dated supply end date.",
"possible_errors": [
"meter_point_with_no_agreement",
"meterpoint_with_agreement_not_on_supply"
]
},
{
"name": "Validate transfer readings exist on active gas meters",
"description": "Validate that each active gas meter has a single transfer reading provided.",
"possible_errors": [
"active_gas_meter_with_multiple_transfer_readings",
"active_gas_meter_without_transfer_reading",
"reading_meter_fully_billed"
]
},
{
"name": "Validate EACs provided for active registers",
"description": "Validate that EACs are provided in the <code>eac_history</code> array for each active electricity register. EACs are matched to registers using the <code>tpr</code> field present on both the EAC and register objects.",
"possible_errors": [
"missing_eacs_for_active_register_tpr"
]
},
{
"name": "Validate that prepay meters are matched to agreements of the correct type",
"description": "Validate that each prepay meter has a matching agreement on a prepay tariff, and similarly non-prepay meters on non-prepay tariffs. Note that this validation only applies for active meters and agreements.",
"possible_errors": [
"tariff_type_does_not_match_meter_type"
]
},
{
"name": "Validate each agreement is not effective before the product is available",
"description": "Ensures that the agreement <code>effective_from</code> is not before the datetime the agreement's product is available from. We check this if Kraken will be responsible for billing before the product is available and the product is a variable or tracker product.",
"possible_errors": [
"agreement_effective_from_before_product_available_from"
]
},
{
"name": "Validate that all variable products on a contract have start dates after the product start date",
"description": "Validate that any variable products that are part of a contract only become effective after the product is available.",
"possible_errors": [
"agreement_cannot_start_before_product_available"
]
},
{
"name": "Validate that no meter points are ending supply in the future",
"description": "Ensure that all meters points have either ended supply or are not planned for supply to end.",
"possible_errors": [
"future_supply_end_date"
]
},
{
"name": "Validate that all off supply meter points with meters have a final reading",
"description": "Ensure that all off supply meter points which have meters have a final reading on their end date.",
"possible_errors": [
"no_reading_on_supply_end_date"
]
},
{
"name": "Validate that no billable meter points are starting supply in the future",
"description": "Validate that no billable meter points are set to start supply in the future.",
"possible_errors": [
"future_supply_start_date"
]
},
{
"name": "Validate that all billable meter points have active meters",
"description": "Ensure that all meter points that are billable have active meters or have an unmetered measurement class provided in the payload.",
"possible_errors": [
"meter_point_with_no_meters"
]
},
{
"name": "Validate that at least one of the meter points needs billing",
"description": "Ensure that at least one of the meter points for this account are billable.",
"possible_errors": [
"no_supply_point_on_supply"
]
},
{
"name": "Validate that a domestic account does not have any business only supply points",
"description": "Validate that a domestic account does not have supply points with supply types <code>REGOS_EXPORT_CERTIFICATES</code> or <code>ROCS_EXPORT_CERTIFICATES</code> which are business only supply types.",
"possible_errors": [
"business_supply_type_on_domestic_account"
]
},
{
"name": "Validate business account has account billing options with <code>period_start_day</code> and <code>period_length</code>",
"description": "Validate that business account's <code>account_billing_options</code> include period start day and period length if <code>account_billing_options</code> is being provided. If <code>account_billing_options</code> is not provided then the defaults of 1 for <code>period_start_day</code> and \"MONTHLY\" for <code>period_length</code> will be used.",
"possible_errors": [
"business_account_missing_billing_options"
]
},
{
"name": "Validate that customers provided for business accounts",
"description": "Validate that at least one customer is provided for business accounts. Customers are needed for business accounts to ensure that meter points can be successfully registered for supply.",
"possible_errors": [
"business_account_missing_customers"
]
},
{
"name": "Validate current statement transactions are not before <code>last_billed_to_date</code>",
"description": "Validate that there are no current statement transactions that occurred before the <code>last_billed_to_date</code> (this includes the supply point-level <code>last_billed_to_date</code>, as well as any meter- or register-level dates where applicable).",
"possible_errors": [
"current_statement_transaction_before_last_billed_to_date"
]
},
{
"name": "Validate transfer readings exist on active electricity registers",
"description": "Validate that each active electricity meter register has a single transfer reading provided.",
"possible_errors": [
"missing_transfer_reading_for_register",
"multiple_transfer_readings_for_register"
]
}
]Old
{
"maxItems": 1
}19 May 2026
No attributes to display
No attributes to display
New
{
"x-enum-descriptions": {
"sunday_saver_interest_capture_from_july26": "Sunday Saver Interest for July 26"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Sunday Saver Interest for July 26": "Sunday Saver Interest for July 26"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"NEWACQGAS200": "NEWACQGAS200",
"LOW_STANDING_CHARGE_TRIAL_GAS": "LOW_STANDING_CHARGE_TRIAL_GAS",
"LOW_STANDING_CHARGE_TRIAL_ELECTRICITY": "LOW_STANDING_CHARGE_TRIAL_ELECTRICITY"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"payg_payment_holiday_gas": "PAYG payment holiday gas",
"payg_payment_holiday_elec": "PAYG payment holiday elec"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"PAYG payment holiday gas": "PAYG payment holiday gas",
"PAYG payment holiday elec": "PAYG payment holiday elec"
}
}Old
{
"x-enum-descriptions": {}
}18 May 2026
New
{
"x-enum-descriptions": {
"low_standing_charge_trial": "Low Standing Charge Trial"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Low Standing Charge Trial": "Low Standing Charge Trial"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"sanctioned_customer": "Sanctioned customer"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Sanctioned customer": "Sanctioned customer"
}
}Old
{
"x-enum-descriptions": {}
}14 May 2026
New
{
"x-enum-descriptions": {
"missing_guid_required": "Missing GUID - Request from customer",
"missing_chf_guid_required": "Missing CHF GUID - Request from customer"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Missing GUID - Request from customer": "Missing GUID - Request from customer",
"Missing CHF GUID - Request from customer": "Missing CHF GUID - Request from customer"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"economy_9_fixed": "Economy 9 Fixed",
"economy_9_exceptions": "Economy 9 Exceptions",
"economy_9_migrations": "Economy 9 Migrations"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Economy 9 Fixed": "Economy 9 Fixed",
"Economy 9 Exceptions": "Economy 9 Exceptions",
"Economy 9 Migrations": "Economy 9 Migrations"
}
}Old
{
"x-enum-descriptions": {}
}
No attributes to display
13 May 2026
New
{
"x-enum-descriptions": {
"gsop4_dcc_mitigation": "GSOP4 DCC Mitigation",
"gsop4_external_partner_mitigation": "GSOP4 External Partner Mitigation"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"GSOP4 DCC Mitigation": "GSOP4 DCC Mitigation",
"GSOP4 External Partner Mitigation": "GSOP4 External Partner Mitigation"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"CHARGEBACK": "Chargeback"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"bb_debt_payment_required": "BB Debt Payment Required"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"BB Debt Payment Required": "BB Debt Payment Required"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"economy_9_migration_pot": "Economy 9 Migration Pot"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Economy 9 Migration Pot": "Economy 9 Migration Pot"
}
}Old
{
"x-enum-descriptions": {}
}New
[
{
"name": "Validate account type is valid",
"description": "Validate that only one account type is specified in the payload.",
"possible_errors": [
"multiple_account_types_selected"
]
},
{
"name": "Validate billing address fields",
"description": "If a legacy billing address is provided, validate that it is in the correct format.",
"possible_errors": [
"invalid_address"
]
},
{
"name": "Validate customer family name",
"description": "Validate the family name is provided for all customers on a domestic account. For Business accounts, set the family name to 'Business' if it is not provided.",
"possible_errors": [
"customer_family_name_required"
]
},
{
"name": "Validate metadata",
"description": "Validate that metadata, which is a list of key value pairs, does not contain duplicate keys.",
"possible_errors": [
"metadata_has_duplicate_keys"
]
},
{
"name": "Validate unique property external identifiers",
"description": "Ensures that <code>property_external_identifier</code> is not repeated across <code>supply_addresses</code> and <code>properties</code>.",
"possible_errors": [
"duplicate_property_external_identifiers"
]
},
{
"name": "Validate managed account type is allowed",
"description": "Validate that this instance of Kraken allows managed account types.",
"possible_errors": [
"managed_accounts_are_not_allowed"
]
},
{
"name": "Validate only portfolio lead has portfolio setting",
"description": "Validates that if portfolio settings are provided, then the account is marked as the portfolio lead.",
"possible_errors": [
"portfolio_settings_included_when_not_lead"
]
},
{
"name": "Validate business type and company number not provided for domestic accounts",
"description": "Validate that neither a business type or company number are provided for domestic accounts.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate no customers for unknown occupier",
"description": "Validate that no customers are provided for an unknown occupier.",
"possible_errors": [
"customer_with_unknown_occupier"
]
},
{
"name": "Validate that a customer given name is provided for business accounts",
"description": "Validate that a given name is provided for all customers on a business account. Note that this validation only applies if Kraken is configured to send registration flows for this import supplier.",
"possible_errors": [
"customer_given_name_required"
]
},
{
"name": "Validate portfolio reference provided correctly",
"description": "Validate that a portfolio reference is provided if portfolio settings have been provided and that a portfolio reference is not provided if the import supplier is set to create new portfolios.",
"possible_errors": [
"portfolio_references_missing",
"portfolio_references_provided"
]
},
{
"name": "Validate billing address style",
"description": "Validate that a legacy billing address (<code>billing_address1</code> etc.) and new-style billing address (<code>billing_address</code> object) are not both provided.",
"possible_errors": [
"billing_address_new_style_and_legacy"
]
},
{
"name": "Validate agreements are consecutive per supply point",
"description": "Validate that the agreements provided in the payload are consecutive per supply point i.e. there are no gaps or overlaps. The exception to this is for agreements provided before the current supply period for the supply point. Agreements provided before the <code>supply_start_date</code> are allowed gaps since they represent historic periods of supply and cannot be used for billing in Kraken.",
"possible_errors": [
"gaps_or_overlaps_in_agreement_dates"
]
},
{
"name": "Validate supply charge line items covered by a single agreement",
"description": "Validate each supply charge has a single agreement with matching product code that covers the period defined by it's line items minimum <code>start_date</code> to maximum <code>end_date</code>.",
"possible_errors": [
"supply_charge_line_items_not_covered_by_single_agreement"
]
},
{
"name": "Validate historical statement period end must not be in the future",
"description": "Ensures that the historical statement period end date (last_statement_closing_date or latest transaction_date) is not set in the future.",
"possible_errors": [
"historical_statement_period_end_in_future"
]
},
{
"name": "Validate that terms with supply type matches a supply point supply type",
"description": "Validate that for terms containing a <code>supply_type</code> field that there is a supply point in the payload with a matching <code>supply_type</code>.",
"possible_errors": [
"term_supply_type_mismatch"
]
},
{
"name": "Validate that supply addresses and supply points are provided if account contracts are provided",
"description": "Validate that if <code>account_contracts</code> have been provided that a supply address with supply points has been provided under <code>supply_addresses</code>",
"possible_errors": [
"account_contracts_without_supply_points"
]
},
{
"name": "Validate historical statement billing document identifier presence",
"description": "Ensure that billing document identifiers are only provided for historical statement transactions and only when the relevant feature flag is enabled.",
"possible_errors": [
"historical_statement_billing_document_identifier_missing",
"historical_statement_billing_document_identifier_not_allowed_when_feature_flag_disabled"
]
},
{
"name": "Validate current statement transactions do not provide <code>billing_document_identifier</code>",
"description": "Validate that none of the current statement transactions include a <code>billing_document_identifier</code>, as this field is only applicable to historical statement transactions.",
"possible_errors": [
"billing_document_identifier_not_allowed_for_current_statement_transactions"
]
},
{
"name": "Validate historical statement transaction billing document identifier",
"description": "Ensure that the billing document identifier is the same for all historical statement transactions.",
"possible_errors": [
"historical_statement_billing_document_identifier_mismatch"
]
},
{
"name": "Validate that contract terms' product codes are part of supply agreements",
"description": "Ensure that any contract terms with product references have corresponding products in supply addresses.",
"possible_errors": [
"contract_term_product_code_not_in_agreements"
]
},
{
"name": "Validate that business is provided if enforcing business contracts",
"description": "Validate that the business field is provided if <code>enforce_business_contracts_exist</code> is set to True on the import supplier configuration.",
"possible_errors": [
"business_field_required"
]
},
{
"name": "Validate that the sum of ledger balances equals the transfer balance",
"description": "Validate that the sum of all <code>ledger_balance</code> provided for each ledger in <code>ledgers</code> equals the account-level <code>transfer_balance</code>.",
"possible_errors": [
"ledger_balances_not_equal_to_transfer_balance"
]
},
{
"name": "Validate business user info against customer info",
"description": "Validates that business user information matches the corresponding customer information for basic fields.",
"possible_errors": [
"customer_details_and_user_details_both_provided"
]
},
{
"name": "Validate payment preference <code>ledger_identifier</code>",
"description": "Ensure that the <code>ledger_identifier</code> provided has an equivalent <code>ledger</code> object with the same <code>ledger_identifier</code> .",
"possible_errors": [
"invalid_payment_preference_ledger_identifier"
]
},
{
"name": "Validate that referenced ledgers are unique in payment preferences",
"description": "Ensure that each ledger is referenced in at most one payment preference.",
"possible_errors": [
"duplicate_ledger_in_payment_preferences"
]
},
{
"name": "Validate that valid instruction_identifier provided for <code>ACTIVE_NEW</code> payment preference",
"description": "Ensure that <code>ACTIVE_NEW</code> payment preference has instruction_identifier from </code>payment_instructions</code> object.",
"possible_errors": [
"active_new_payment_preference_invalid_instruction_identifier"
]
},
{
"name": "Validate that the transactions for a voucher do not exceed its value",
"description": "Validate that the sum of all transaction values for a voucher is not greater than the value of the voucher.",
"possible_errors": [
"voucher_transactions_sum_greater_than_voucher_value"
]
},
{
"name": "Validate that each voucher charge transaction id has a matching transaction id within a transaction of type CHARGE",
"description": "Validate that each <code>voucher</code> <code>charge_transaction_id</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CHARGE in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_charge_transaction_id_not_found"
]
},
{
"name": "Validate that each voucher redemption credit transaction id has a matching transaction id within a transaction of type CREDIT",
"description": "Validate that every <code>credit_transaction_id</code> in all <code>voucher_redemptions</code> in every <code>voucher</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CREDIT in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_redemption_credit_transaction_id_not_found"
]
},
{
"name": "Validate auto allocation of operations team",
"description": "Validate that operations_team_name is provided if auto allocation is not configured.",
"possible_errors": [
"operations_team_provided_when_using_auto_allocation",
"operations_team_should_be_provided"
]
},
{
"name": "Validate that Kraken can calculate when to start billing the account",
"description": "Validate that Kraken can calculate when to start billing the account. This is determined based on the existence of last billed to date, last statement closing date, and agreements.",
"possible_errors": [
"cannot_determine_responsible_for_billing_from_date"
]
},
{
"name": "Validate that if historical statement transaction are provided then so is a last statement closing date or last billed to date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided in the payload then either a <code>last_statement_closing_date</code> or <code>last_billed_to_date</code> is also provided. If a <code>last_statement_closing_date</code> is not provided then the earliest <code>last_billed_to_date</code> on the account or supply points is used to determine when the last statement should have closed.",
"possible_errors": [
"historical_statement_transactions_without_last_statement_closing_date_or_last_billed_to_date"
]
},
{
"name": "Validate unique transaction IDs",
"description": "Validate that all transaction IDs provided are unique.",
"possible_errors": [
"duplicate_transaction_ids",
"missing_transaction_id"
]
},
{
"name": "Validate current statement transactions are after historical statement transactions",
"description": "Validate that all current statement transactions are dated after all current historical statement transactions.",
"possible_errors": [
"historical_statement_transaction_after_current_statement_transaction"
]
},
{
"name": "Validate that there are no historical statement transactions after the last statement closing date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided then none are later than the <code>last_statement_closing_date</code>. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"historical_statement_transaction_after_last_statement_closing_date"
]
},
{
"name": "Validate that the last statement issue date is on or after the last statement closing date",
"description": "Validate that the <code>last_statement_issue_date</code>, if given, is on or after the <code>last_statement_closing_date</code> given. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"last_statement_issued_before_closing_date"
]
},
{
"name": "Validate no duplicated ledgers are provided",
"description": "Validate no duplicated ledger codes are in `ledgers` section.",
"possible_errors": [
"duplicate_ledger_entries_found"
]
},
{
"name": "Validate identifiers are unique in ledgers",
"description": "Validate identifier is not declared twice in ledgers.",
"possible_errors": [
"duplicate_identifiers_entries_found"
]
},
{
"name": "Validate ledger identifiers are known",
"description": "Validate ledger identifiers are among supply point identifiers.",
"possible_errors": [
"unknown_ledger_identifiers"
]
},
{
"name": "Validate payment adequacy changes or last payment review date not both",
"description": "Validate that only one of <code>payment_adequacy_changes</code> or <code>last_payment_review_date</code> is provided in the payload.",
"possible_errors": [
"payment_adequacy_changes_and_last_payment_review_date_provided"
]
},
{
"name": "Validate that payment plans and payment schedules for the same ledger are not both in payload",
"description": "Validate that if there are payment plans in the payload, there are not also payment schedules on the same ledger because payment plans create a schedule containing all of the planned payments.",
"possible_errors": [
"payment_plan_and_payment_schedule_not_allowed_on_same_ledger"
]
},
{
"name": "Validate no more than one property for unknown occupier",
"description": "Validate that no more than one property is provided for an unknown occupier account.",
"possible_errors": [
"occupier_account_with_multiple_supply_addresses"
]
},
{
"name": "Validate no direct debit reference for the occupier",
"description": "Validate that if any customer is identified as an occupier, then no <code>dd_reference</code> is provided for the account. If a <code>dd_reference</code> is provided, then it implies that there is a known occupier for the account.",
"possible_errors": [
"dd_reference_for_occupier_account"
]
},
{
"name": "Validate no unbilled period on former supply addresses",
"description": "Validate that if a customer is no longer at the given supply address they have been fully billed. This check is performed if we are importing supply address history.",
"possible_errors": [
"unbilled_former_supply_address"
]
},
{
"name": "Validate that agreements cover the last billed to date",
"description": "Validate that there is an agreement covering the last billed to date for each supply point.",
"possible_errors": [
"no_agreement_covering_last_billed_to_date"
]
},
{
"name": "Validate debt and debts",
"description": "Validates that both debt and debts are not specified in the payload.",
"possible_errors": [
"debt_and_debts_are_defined"
]
},
{
"name": "Validate that a last billed to date has been provided correctly",
"description": "Validate that, for each meter, a last billed to date has been provided in the appropriate place. For electricity meters, it must be provided on each of the meter's settlement registers. For gas meters, it must be provided on the meter. This validation does not apply to meters with half-hourly billing, or meters that have been exchanged where the new meter has already been billed. This validation is skipped if the account has not yet been billed and therefore has no historical statement data.",
"possible_errors": [
"last_billed_to_date_not_found"
]
},
{
"name": "Validate that current statement transactions are not before the current statement opening date",
"description": "Validate that all <code>current_statement_transactions</code>, if provided, are not before the current statement opening date. This date is one day after the last statement closing date if provided, otherwise it is based on the last billed to date. Note that any prepay vend transactions are not included in the above check.",
"possible_errors": [
"current_statement_transaction_before_current_statement_opening_date"
]
},
{
"name": "Validate <code>last_statement_balance</code> plus/minus <code>current_statement_transactions</code> equal <code>transfer_balance</code>",
"description": "Validate that the sum of <code>current_statement_transactions</code> plus the <code>last_statement_balance</code> is equal to the <code>transfer_balance</code>. For example, if a <code>last_statement_balance</code> of 100 is provided, and the <code>current_statement_transactions</code> include one payment of 50, then the expected <code>transfer_balance</code> would 150. Transactions that are payments or credits add to the balance. Transactions that are repayments or charges subtract from the balance. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"balance_mismatch_on_transfer_balance"
]
},
{
"name": "Validate that the summed historical statement transactions match the last statement balance",
"description": "Validate that the sum of the <code>historical_statement_transactions</code> equals the <code>last_statement_balance</code>. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"historical_statement_transactions_balance_mismatch"
]
},
{
"name": "Validate next bill due date provided for quarterly billing",
"description": "Validate that if <code>use_industry_billing</code> is false in the account billing options and the <code>period_length</code> is <code>QUARTERLY</code>, then a <code>next_bill_due_date</code> is provided.",
"possible_errors": [
"next_bill_to_date_not_provided_for_quarterly_billing"
]
},
{
"name": "Validate account billing options",
"description": "Validate that account billing options have only been provided for business accounts.",
"possible_errors": [
"account_billing_options_provided_for_domestic_accounts"
]
},
{
"name": "Validate alternative phone number is unique",
"description": "Validate customers defined in the payload do not have the same alternative phone numbers.",
"possible_errors": [
"duplicated_alternative_phone_numbers"
]
},
{
"name": "Validate that prepay transactions target initialised prepay meters",
"description": "Validate that if <code>current_statement_transactions</code> or <code>historical_statement_transactions</code> target a prepay meter (i.e. has the <code>to_prepay_meter_serial_number</code> field), then a prepay meter with that serial number exists in the payload. A prepay meter is identified in the payload by the presence of <code>prepay_details</code>.",
"possible_errors": [
"transactions_target_non_initialised_prepay_meter"
]
},
{
"name": "Validate tax exemption for appropriate account type",
"description": "Validate that the tax exemption is only in place for business accounts.",
"possible_errors": [
"tax_exemptions_provided_for_domestic_account"
]
},
{
"name": "Validate prepay transfer vend read dates match last billed to date",
"description": "Validate that the transfer vend read dates match the last billed to date. This only applies to prepay meters.The last billed to date can be either at the account level or the at the meter/register level. Last billed to dates at the meter/register level take precedent over the account level date if both are provided.",
"possible_errors": [
"prepay_details_on_fully_billed_meter",
"transfer_vend_read_date_must_match_last_billed_to_date"
]
},
{
"name": "Validate that the tariff type and meter point type match",
"description": "Validate that the tariff we have on a given contract matches the meter point type. For example, check eco7 (2-rate) meter points don't have single-rate tariffs or vice versa.",
"possible_errors": [
"tariff_type_does_not_match_meter_point_type"
]
},
{
"name": "Validate bespoke rates",
"description": "Validate that if bespoke rates have been set the account is business.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate billing address provided",
"description": "Validate <code>billing_address1</code> and <code>billing_postcode</code> are provided for non-occupier accounts.",
"possible_errors": [
"billing_address_not_provided"
]
},
{
"name": "Validate current AQ for billable meter point",
"description": "Check that we have a currently valid AQ for a billable MPRN.",
"possible_errors": [
"no_current_or_future_aq_entry_found"
]
},
{
"name": "Validate all billable meter points are covered by agreements in the payload",
"description": "Validate that agreements have been provided for all billable meter points and vice versa for the period covered by Kraken from a billing perspective. A billable meter point is one that has an open-ended or future dated supply end date.",
"possible_errors": [
"meter_point_with_no_agreement",
"meterpoint_with_agreement_not_on_supply"
]
},
{
"name": "Validate transfer readings exist on active gas meters",
"description": "Validate that each active gas meter has a single transfer reading provided.",
"possible_errors": [
"active_gas_meter_with_multiple_transfer_readings",
"active_gas_meter_without_transfer_reading",
"reading_meter_fully_billed"
]
},
{
"name": "Validate EACs provided for active registers",
"description": "Validate that EACs are provided in the <code>eac_history</code> array for each active electricity register. EACs are matched to registers using the <code>tpr</code> field present on both the EAC and register objects.",
"possible_errors": [
"missing_eacs_for_active_register_tpr"
]
},
{
"name": "Validate that prepay meters are matched to agreements of the correct type",
"description": "Validate that each prepay meter has a matching agreement on a prepay tariff, and similarly non-prepay meters on non-prepay tariffs. Note that this validation only applies for active meters and agreements.",
"possible_errors": [
"tariff_type_does_not_match_meter_type"
]
},
{
"name": "Validate each agreement is not effective before the product is available",
"description": "Ensures that the agreement <code>effective_from</code> is not before the datetime the agreement's product is available from. We check this if Kraken will be responsible for billing before the product is available and the product is a variable or tracker product.",
"possible_errors": [
"agreement_effective_from_before_product_available_from"
]
},
{
"name": "Validate that all variable products on a contract have start dates after the product start date",
"description": "Validate that any variable products that are part of a contract only become effective after the product is available.",
"possible_errors": [
"agreement_cannot_start_before_product_available"
]
},
{
"name": "Validate that no meter points are ending supply in the future",
"description": "Ensure that all meters points have either ended supply or are not planned for supply to end.",
"possible_errors": [
"future_supply_end_date"
]
},
{
"name": "Validate that all off supply meter points with meters have a final reading",
"description": "Ensure that all off supply meter points which have meters have a final reading on their end date.",
"possible_errors": [
"no_reading_on_supply_end_date"
]
},
{
"name": "Validate that no billable meter points are starting supply in the future",
"description": "Validate that no billable meter points are set to start supply in the future.",
"possible_errors": [
"future_supply_start_date"
]
},
{
"name": "Validate that all billable meter points have active meters",
"description": "Ensure that all meter points that are billable have active meters or have an unmetered measurement class provided in the payload.",
"possible_errors": [
"meter_point_with_no_meters"
]
},
{
"name": "Validate that at least one of the meter points needs billing",
"description": "Ensure that at least one of the meter points for this account are billable.",
"possible_errors": [
"no_supply_point_on_supply"
]
},
{
"name": "Validate that a domestic account does not have any business only supply points",
"description": "Validate that a domestic account does not have supply points with supply types <code>REGOS_EXPORT_CERTIFICATES</code> or <code>ROCS_EXPORT_CERTIFICATES</code> which are business only supply types.",
"possible_errors": [
"business_supply_type_on_domestic_account"
]
},
{
"name": "Validate business account has account billing options with <code>period_start_day</code> and <code>period_length</code>",
"description": "Validate that business account's <code>account_billing_options</code> include period start day and period length if <code>account_billing_options</code> is being provided. If <code>account_billing_options</code> is not provided then the defaults of 1 for <code>period_start_day</code> and \"MONTHLY\" for <code>period_length</code> will be used.",
"possible_errors": [
"business_account_missing_billing_options"
]
},
{
"name": "Validate that customers provided for business accounts",
"description": "Validate that at least one customer is provided for business accounts. Customers are needed for business accounts to ensure that meter points can be successfully registered for supply.",
"possible_errors": [
"business_account_missing_customers"
]
},
{
"name": "Validate current statement transactions are not before <code>last_billed_to_date</code>",
"description": "Validate that there are no current statement transactions that occurred before the <code>last_billed_to_date</code> (this includes the supply point-level <code>last_billed_to_date</code>, as well as any meter- or register-level dates where applicable).",
"possible_errors": [
"current_statement_transaction_before_last_billed_to_date"
]
},
{
"name": "Validate transfer readings exist on active electricity registers",
"description": "Validate that each active electricity meter register has a single transfer reading provided.",
"possible_errors": [
"missing_transfer_reading_for_register",
"multiple_transfer_readings_for_register"
]
}
]Old
[
{
"name": "Validate account type is valid",
"description": "Validate that only one account type is specified in the payload.",
"possible_errors": [
"multiple_account_types_selected"
]
},
{
"name": "Validate billing address fields",
"description": "If a legacy billing address is provided, validate that it is in the correct format.",
"possible_errors": [
"invalid_address"
]
},
{
"name": "Validate customer family name",
"description": "Validate the family name is provided for all customers on a domestic account. For Business accounts, set the family name to 'Business' if it is not provided.",
"possible_errors": [
"customer_family_name_required"
]
},
{
"name": "Validate metadata",
"description": "Validate that metadata, which is a list of key value pairs, does not contain duplicate keys.",
"possible_errors": [
"metadata_has_duplicate_keys"
]
},
{
"name": "Validate managed account type is allowed",
"description": "Validate that this instance of Kraken allows managed account types.",
"possible_errors": [
"managed_accounts_are_not_allowed"
]
},
{
"name": "Validate only portfolio lead has portfolio setting",
"description": "Validates that if portfolio settings are provided, then the account is marked as the portfolio lead.",
"possible_errors": [
"portfolio_settings_included_when_not_lead"
]
},
{
"name": "Validate business type and company number not provided for domestic accounts",
"description": "Validate that neither a business type or company number are provided for domestic accounts.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate no customers for unknown occupier",
"description": "Validate that no customers are provided for an unknown occupier.",
"possible_errors": [
"customer_with_unknown_occupier"
]
},
{
"name": "Validate that a customer given name is provided for business accounts",
"description": "Validate that a given name is provided for all customers on a business account. Note that this validation only applies if Kraken is configured to send registration flows for this import supplier.",
"possible_errors": [
"customer_given_name_required"
]
},
{
"name": "Validate portfolio reference provided correctly",
"description": "Validate that a portfolio reference is provided if portfolio settings have been provided and that a portfolio reference is not provided if the import supplier is set to create new portfolios.",
"possible_errors": [
"portfolio_references_missing",
"portfolio_references_provided"
]
},
{
"name": "Validate billing address style",
"description": "Validate that a legacy billing address (<code>billing_address1</code> etc.) and new-style billing address (<code>billing_address</code> object) are not both provided.",
"possible_errors": [
"billing_address_new_style_and_legacy"
]
},
{
"name": "Validate agreements are consecutive per supply point",
"description": "Validate that the agreements provided in the payload are consecutive per supply point i.e. there are no gaps or overlaps. The exception to this is for agreements provided before the current supply period for the supply point. Agreements provided before the <code>supply_start_date</code> are allowed gaps since they represent historic periods of supply and cannot be used for billing in Kraken.",
"possible_errors": [
"gaps_or_overlaps_in_agreement_dates"
]
},
{
"name": "Validate supply charge line items covered by a single agreement",
"description": "Validate each supply charge has a single agreement with matching product code that covers the period defined by it's line items minimum <code>start_date</code> to maximum <code>end_date</code>.",
"possible_errors": [
"supply_charge_line_items_not_covered_by_single_agreement"
]
},
{
"name": "Validate historical statement period end must not be in the future",
"description": "Ensures that the historical statement period end date (last_statement_closing_date or latest transaction_date) is not set in the future.",
"possible_errors": [
"historical_statement_period_end_in_future"
]
},
{
"name": "Validate that terms with supply type matches a supply point supply type",
"description": "Validate that for terms containing a <code>supply_type</code> field that there is a supply point in the payload with a matching <code>supply_type</code>.",
"possible_errors": [
"term_supply_type_mismatch"
]
},
{
"name": "Validate that supply addresses and supply points are provided if account contracts are provided",
"description": "Validate that if <code>account_contracts</code> have been provided that a supply address with supply points has been provided under <code>supply_addresses</code>",
"possible_errors": [
"account_contracts_without_supply_points"
]
},
{
"name": "Validate historical statement billing document identifier presence",
"description": "Ensure that billing document identifiers are only provided for historical statement transactions and only when the relevant feature flag is enabled.",
"possible_errors": [
"historical_statement_billing_document_identifier_missing",
"historical_statement_billing_document_identifier_not_allowed_when_feature_flag_disabled"
]
},
{
"name": "Validate current statement transactions do not provide <code>billing_document_identifier</code>",
"description": "Validate that none of the current statement transactions include a <code>billing_document_identifier</code>, as this field is only applicable to historical statement transactions.",
"possible_errors": [
"billing_document_identifier_not_allowed_for_current_statement_transactions"
]
},
{
"name": "Validate historical statement transaction billing document identifier",
"description": "Ensure that the billing document identifier is the same for all historical statement transactions.",
"possible_errors": [
"historical_statement_billing_document_identifier_mismatch"
]
},
{
"name": "Validate that contract terms' product codes are part of supply agreements",
"description": "Ensure that any contract terms with product references have corresponding products in supply addresses.",
"possible_errors": [
"contract_term_product_code_not_in_agreements"
]
},
{
"name": "Validate that business is provided if enforcing business contracts",
"description": "Validate that the business field is provided if <code>enforce_business_contracts_exist</code> is set to True on the import supplier configuration.",
"possible_errors": [
"business_field_required"
]
},
{
"name": "Validate that the sum of ledger balances equals the transfer balance",
"description": "Validate that the sum of all <code>ledger_balance</code> provided for each ledger in <code>ledgers</code> equals the account-level <code>transfer_balance</code>.",
"possible_errors": [
"ledger_balances_not_equal_to_transfer_balance"
]
},
{
"name": "Validate business user info against customer info",
"description": "Validates that business user information matches the corresponding customer information for basic fields.",
"possible_errors": [
"customer_details_and_user_details_both_provided"
]
},
{
"name": "Validate payment preference <code>ledger_identifier</code>",
"description": "Ensure that the <code>ledger_identifier</code> provided has an equivalent <code>ledger</code> object with the same <code>ledger_identifier</code> .",
"possible_errors": [
"invalid_payment_preference_ledger_identifier"
]
},
{
"name": "Validate that referenced ledgers are unique in payment preferences",
"description": "Ensure that each ledger is referenced in at most one payment preference.",
"possible_errors": [
"duplicate_ledger_in_payment_preferences"
]
},
{
"name": "Validate that valid instruction_identifier provided for <code>ACTIVE_NEW</code> payment preference",
"description": "Ensure that <code>ACTIVE_NEW</code> payment preference has instruction_identifier from </code>payment_instructions</code> object.",
"possible_errors": [
"active_new_payment_preference_invalid_instruction_identifier"
]
},
{
"name": "Validate that the transactions for a voucher do not exceed its value",
"description": "Validate that the sum of all transaction values for a voucher is not greater than the value of the voucher.",
"possible_errors": [
"voucher_transactions_sum_greater_than_voucher_value"
]
},
{
"name": "Validate that each voucher charge transaction id has a matching transaction id within a transaction of type CHARGE",
"description": "Validate that each <code>voucher</code> <code>charge_transaction_id</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CHARGE in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_charge_transaction_id_not_found"
]
},
{
"name": "Validate that each voucher redemption credit transaction id has a matching transaction id within a transaction of type CREDIT",
"description": "Validate that every <code>credit_transaction_id</code> in all <code>voucher_redemptions</code> in every <code>voucher</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CREDIT in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_redemption_credit_transaction_id_not_found"
]
},
{
"name": "Validate auto allocation of operations team",
"description": "Validate that operations_team_name is provided if auto allocation is not configured.",
"possible_errors": [
"operations_team_provided_when_using_auto_allocation",
"operations_team_should_be_provided"
]
},
{
"name": "Validate that Kraken can calculate when to start billing the account",
"description": "Validate that Kraken can calculate when to start billing the account. This is determined based on the existence of last billed to date, last statement closing date, and agreements.",
"possible_errors": [
"cannot_determine_responsible_for_billing_from_date"
]
},
{
"name": "Validate that if historical statement transaction are provided then so is a last statement closing date or last billed to date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided in the payload then either a <code>last_statement_closing_date</code> or <code>last_billed_to_date</code> is also provided. If a <code>last_statement_closing_date</code> is not provided then the earliest <code>last_billed_to_date</code> on the account or supply points is used to determine when the last statement should have closed.",
"possible_errors": [
"historical_statement_transactions_without_last_statement_closing_date_or_last_billed_to_date"
]
},
{
"name": "Validate unique transaction IDs",
"description": "Validate that all transaction IDs provided are unique.",
"possible_errors": [
"duplicate_transaction_ids",
"missing_transaction_id"
]
},
{
"name": "Validate current statement transactions are after historical statement transactions",
"description": "Validate that all current statement transactions are dated after all current historical statement transactions.",
"possible_errors": [
"historical_statement_transaction_after_current_statement_transaction"
]
},
{
"name": "Validate that there are no historical statement transactions after the last statement closing date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided then none are later than the <code>last_statement_closing_date</code>. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"historical_statement_transaction_after_last_statement_closing_date"
]
},
{
"name": "Validate that the last statement issue date is on or after the last statement closing date",
"description": "Validate that the <code>last_statement_issue_date</code>, if given, is on or after the <code>last_statement_closing_date</code> given. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"last_statement_issued_before_closing_date"
]
},
{
"name": "Validate no duplicated ledgers are provided",
"description": "Validate no duplicated ledger codes are in `ledgers` section.",
"possible_errors": [
"duplicate_ledger_entries_found"
]
},
{
"name": "Validate identifiers are unique in ledgers",
"description": "Validate identifier is not declared twice in ledgers.",
"possible_errors": [
"duplicate_identifiers_entries_found"
]
},
{
"name": "Validate ledger identifiers are known",
"description": "Validate ledger identifiers are among supply point identifiers.",
"possible_errors": [
"unknown_ledger_identifiers"
]
},
{
"name": "Validate payment adequacy changes or last payment review date not both",
"description": "Validate that only one of <code>payment_adequacy_changes</code> or <code>last_payment_review_date</code> is provided in the payload.",
"possible_errors": [
"payment_adequacy_changes_and_last_payment_review_date_provided"
]
},
{
"name": "Validate that payment plans and payment schedules for the same ledger are not both in payload",
"description": "Validate that if there are payment plans in the payload, there are not also payment schedules on the same ledger because payment plans create a schedule containing all of the planned payments.",
"possible_errors": [
"payment_plan_and_payment_schedule_not_allowed_on_same_ledger"
]
},
{
"name": "Validate no more than one property for unknown occupier",
"description": "Validate that no more than one property is provided for an unknown occupier account.",
"possible_errors": [
"occupier_account_with_multiple_supply_addresses"
]
},
{
"name": "Validate no direct debit reference for the occupier",
"description": "Validate that if any customer is identified as an occupier, then no <code>dd_reference</code> is provided for the account. If a <code>dd_reference</code> is provided, then it implies that there is a known occupier for the account.",
"possible_errors": [
"dd_reference_for_occupier_account"
]
},
{
"name": "Validate no unbilled period on former supply addresses",
"description": "Validate that if a customer is no longer at the given supply address they have been fully billed. This check is performed if we are importing supply address history.",
"possible_errors": [
"unbilled_former_supply_address"
]
},
{
"name": "Validate that agreements cover the last billed to date",
"description": "Validate that there is an agreement covering the last billed to date for each supply point.",
"possible_errors": [
"no_agreement_covering_last_billed_to_date"
]
},
{
"name": "Validate debt and debts",
"description": "Validates that both debt and debts are not specified in the payload.",
"possible_errors": [
"debt_and_debts_are_defined"
]
},
{
"name": "Validate that a last billed to date has been provided correctly",
"description": "Validate that, for each meter, a last billed to date has been provided in the appropriate place. For electricity meters, it must be provided on each of the meter's settlement registers. For gas meters, it must be provided on the meter. This validation does not apply to meters with half-hourly billing, or meters that have been exchanged where the new meter has already been billed. This validation is skipped if the account has not yet been billed and therefore has no historical statement data.",
"possible_errors": [
"last_billed_to_date_not_found"
]
},
{
"name": "Validate that current statement transactions are not before the current statement opening date",
"description": "Validate that all <code>current_statement_transactions</code>, if provided, are not before the current statement opening date. This date is one day after the last statement closing date if provided, otherwise it is based on the last billed to date. Note that any prepay vend transactions are not included in the above check.",
"possible_errors": [
"current_statement_transaction_before_current_statement_opening_date"
]
},
{
"name": "Validate <code>last_statement_balance</code> plus/minus <code>current_statement_transactions</code> equal <code>transfer_balance</code>",
"description": "Validate that the sum of <code>current_statement_transactions</code> plus the <code>last_statement_balance</code> is equal to the <code>transfer_balance</code>. For example, if a <code>last_statement_balance</code> of 100 is provided, and the <code>current_statement_transactions</code> include one payment of 50, then the expected <code>transfer_balance</code> would 150. Transactions that are payments or credits add to the balance. Transactions that are repayments or charges subtract from the balance. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"balance_mismatch_on_transfer_balance"
]
},
{
"name": "Validate that the summed historical statement transactions match the last statement balance",
"description": "Validate that the sum of the <code>historical_statement_transactions</code> equals the <code>last_statement_balance</code>. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"historical_statement_transactions_balance_mismatch"
]
},
{
"name": "Validate next bill due date provided for quarterly billing",
"description": "Validate that if <code>use_industry_billing</code> is false in the account billing options and the <code>period_length</code> is <code>QUARTERLY</code>, then a <code>next_bill_due_date</code> is provided.",
"possible_errors": [
"next_bill_to_date_not_provided_for_quarterly_billing"
]
},
{
"name": "Validate account billing options",
"description": "Validate that account billing options have only been provided for business accounts.",
"possible_errors": [
"account_billing_options_provided_for_domestic_accounts"
]
},
{
"name": "Validate alternative phone number is unique",
"description": "Validate customers defined in the payload do not have the same alternative phone numbers.",
"possible_errors": [
"duplicated_alternative_phone_numbers"
]
},
{
"name": "Validate that prepay transactions target initialised prepay meters",
"description": "Validate that if <code>current_statement_transactions</code> or <code>historical_statement_transactions</code> target a prepay meter (i.e. has the <code>to_prepay_meter_serial_number</code> field), then a prepay meter with that serial number exists in the payload. A prepay meter is identified in the payload by the presence of <code>prepay_details</code>.",
"possible_errors": [
"transactions_target_non_initialised_prepay_meter"
]
},
{
"name": "Validate tax exemption for appropriate account type",
"description": "Validate that the tax exemption is only in place for business accounts.",
"possible_errors": [
"tax_exemptions_provided_for_domestic_account"
]
},
{
"name": "Validate prepay transfer vend read dates match last billed to date",
"description": "Validate that the transfer vend read dates match the last billed to date. This only applies to prepay meters.The last billed to date can be either at the account level or the at the meter/register level. Last billed to dates at the meter/register level take precedent over the account level date if both are provided.",
"possible_errors": [
"prepay_details_on_fully_billed_meter",
"transfer_vend_read_date_must_match_last_billed_to_date"
]
},
{
"name": "Validate that the tariff type and meter point type match",
"description": "Validate that the tariff we have on a given contract matches the meter point type. For example, check eco7 (2-rate) meter points don't have single-rate tariffs or vice versa.",
"possible_errors": [
"tariff_type_does_not_match_meter_point_type"
]
},
{
"name": "Validate bespoke rates",
"description": "Validate that if bespoke rates have been set the account is business.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate billing address provided",
"description": "Validate <code>billing_address1</code> and <code>billing_postcode</code> are provided for non-occupier accounts.",
"possible_errors": [
"billing_address_not_provided"
]
},
{
"name": "Validate current AQ for billable meter point",
"description": "Check that we have a currently valid AQ for a billable MPRN.",
"possible_errors": [
"no_current_or_future_aq_entry_found"
]
},
{
"name": "Validate all billable meter points are covered by agreements in the payload",
"description": "Validate that agreements have been provided for all billable meter points and vice versa for the period covered by Kraken from a billing perspective. A billable meter point is one that has an open-ended or future dated supply end date.",
"possible_errors": [
"meter_point_with_no_agreement",
"meterpoint_with_agreement_not_on_supply"
]
},
{
"name": "Validate transfer readings exist on active gas meters",
"description": "Validate that each active gas meter has a single transfer reading provided.",
"possible_errors": [
"active_gas_meter_with_multiple_transfer_readings",
"active_gas_meter_without_transfer_reading",
"reading_meter_fully_billed"
]
},
{
"name": "Validate EACs provided for active registers",
"description": "Validate that EACs are provided in the <code>eac_history</code> array for each active electricity register. EACs are matched to registers using the <code>tpr</code> field present on both the EAC and register objects.",
"possible_errors": [
"missing_eacs_for_active_register_tpr"
]
},
{
"name": "Validate that prepay meters are matched to agreements of the correct type",
"description": "Validate that each prepay meter has a matching agreement on a prepay tariff, and similarly non-prepay meters on non-prepay tariffs. Note that this validation only applies for active meters and agreements.",
"possible_errors": [
"tariff_type_does_not_match_meter_type"
]
},
{
"name": "Validate each agreement is not effective before the product is available",
"description": "Ensures that the agreement <code>effective_from</code> is not before the datetime the agreement's product is available from. We check this if Kraken will be responsible for billing before the product is available and the product is a variable or tracker product.",
"possible_errors": [
"agreement_effective_from_before_product_available_from"
]
},
{
"name": "Validate that all variable products on a contract have start dates after the product start date",
"description": "Validate that any variable products that are part of a contract only become effective after the product is available.",
"possible_errors": [
"agreement_cannot_start_before_product_available"
]
},
{
"name": "Validate that no meter points are ending supply in the future",
"description": "Ensure that all meters points have either ended supply or are not planned for supply to end.",
"possible_errors": [
"future_supply_end_date"
]
},
{
"name": "Validate that all off supply meter points with meters have a final reading",
"description": "Ensure that all off supply meter points which have meters have a final reading on their end date.",
"possible_errors": [
"no_reading_on_supply_end_date"
]
},
{
"name": "Validate that no billable meter points are starting supply in the future",
"description": "Validate that no billable meter points are set to start supply in the future.",
"possible_errors": [
"future_supply_start_date"
]
},
{
"name": "Validate that all billable meter points have active meters",
"description": "Ensure that all meter points that are billable have active meters or have an unmetered measurement class provided in the payload.",
"possible_errors": [
"meter_point_with_no_meters"
]
},
{
"name": "Validate that at least one of the meter points needs billing",
"description": "Ensure that at least one of the meter points for this account are billable.",
"possible_errors": [
"no_supply_point_on_supply"
]
},
{
"name": "Validate that a domestic account does not have any business only supply points",
"description": "Validate that a domestic account does not have supply points with supply types <code>REGOS_EXPORT_CERTIFICATES</code> or <code>ROCS_EXPORT_CERTIFICATES</code> which are business only supply types.",
"possible_errors": [
"business_supply_type_on_domestic_account"
]
},
{
"name": "Validate business account has account billing options with <code>period_start_day</code> and <code>period_length</code>",
"description": "Validate that business account's <code>account_billing_options</code> include period start day and period length if <code>account_billing_options</code> is being provided. If <code>account_billing_options</code> is not provided then the defaults of 1 for <code>period_start_day</code> and \"MONTHLY\" for <code>period_length</code> will be used.",
"possible_errors": [
"business_account_missing_billing_options"
]
},
{
"name": "Validate that customers provided for business accounts",
"description": "Validate that at least one customer is provided for business accounts. Customers are needed for business accounts to ensure that meter points can be successfully registered for supply.",
"possible_errors": [
"business_account_missing_customers"
]
},
{
"name": "Validate current statement transactions are not before <code>last_billed_to_date</code>",
"description": "Validate that there are no current statement transactions that occurred before the <code>last_billed_to_date</code> (this includes the supply point-level <code>last_billed_to_date</code>, as well as any meter- or register-level dates where applicable).",
"possible_errors": [
"current_statement_transaction_before_last_billed_to_date"
]
},
{
"name": "Validate transfer readings exist on active electricity registers",
"description": "Validate that each active electricity meter register has a single transfer reading provided.",
"possible_errors": [
"missing_transfer_reading_for_register",
"multiple_transfer_readings_for_register"
]
}
]12 May 2026
New
{
"x-enum-descriptions": {
"interest_capture_world_cup": "Football Free Event Interest Capture"
}
}Old
{
"x-enum-descriptions": {
"interest_capture_world_cup": "World Cup Interest Capture"
}
}New
{
"x-enum-descriptions": {
"Football Free Event Interest Capture": "Football Free Event Interest Capture"
}
}Old
{
"x-enum-descriptions": {
"World Cup Interest Capture": "World Cup Interest Capture"
}
}New
{
"x-enum-descriptions": {
"promo_50_june_renew": "Promo 50 June Renew",
"promo_75_june_renew": "Promo 75 June Renew",
"promo_100_june_renew": "Promo 100 June Renew",
"promo_125_june_renew": "Promo 125 June Renew",
"promo_150_june_renew": "Promo 150 June Renew",
"promo_175_june_renew": "Promo 175 June Renew",
"promo_200_june_renew": "Promo 200 June Renew"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Promo 50 June Renew": "Promo 50 June Renew",
"Promo 75 June Renew": "Promo 75 June Renew",
"Promo 100 June Renew": "Promo 100 June Renew",
"Promo 125 June Renew": "Promo 125 June Renew",
"Promo 150 June Renew": "Promo 150 June Renew",
"Promo 175 June Renew": "Promo 175 June Renew",
"Promo 200 June Renew": "Promo 200 June Renew"
}
}Old
{
"x-enum-descriptions": {}
}11 May 2026
New
{
"x-enum-descriptions": {
"HMC_GUARANTEE_FULL": "Hourly Matching Credit Guarantee Full rate (pence per kWh) for business tariffs",
"HMC_GUARANTEE_ADVANCE": "Hourly Matching Credit Guarantee Advance rate (pence per kWh) for business tariffs"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"ADDITIONAL_SOP_FINAL_BILL_REFUND_OVERDUE": "ADDITIONAL_SOP_FINAL_BILL_REFUND_OVERDUE"
}
}Old
{
"x-enum-descriptions": {}
}
No attributes to display
8 May 2026
New
{
"x-removal-date": "2026-05-25"
}
No attributes to display
No attributes to display
New
{
"x-enum-descriptions": {
"gas_summer_campaign": "PAYG/PPM Gas Summer"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"PAYG/PPM Gas Summer": "PAYG/PPM Gas Summer"
}
}Old
{
"x-enum-descriptions": {}
}7 May 2026
New
{
"x-enum-descriptions": {
"wrr_ie_received": "WRR IE Received"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"WRR IE Received": "WRR IE Received"
}
}Old
{
"x-enum-descriptions": {}
}
No attributes to display
No attributes to display
New
{
"x-enum-descriptions": {
"promohm_50_home_move_retention": "Promo HM 50 Home Move Retention"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Promo HM 50 Home Move Retention": "Promo HM 50 Home Move Retention"
}
}Old
{
"x-enum-descriptions": {}
}
No attributes to display
6 May 2026
New
{
"x-enum-descriptions": {
"mhhs_in_progress": "MHHS in Progress"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"MHHS in Progress": "MHHS in Progress"
}
}Old
{
"x-enum-descriptions": {}
}
No attributes to display
No attributes to display
5 May 2026
New
{
"x-enum-descriptions": {
"interest_capture_world_cup": "World Cup Interest Capture"
}
}Old
{
"x-enum-descriptions": {
"sunday_saver_interest_capture_world_cup": "Sunday Saver World Cup"
}
}New
{
"x-enum-descriptions": {
"World Cup Interest Capture": "World Cup Interest Capture"
}
}Old
{
"x-enum-descriptions": {
"Sunday Saver World Cup": "Sunday Saver World Cup"
}
}New
{
"x-enum-descriptions": {
"sunday_saver_interest_capture_world_cup": "Sunday Saver World Cup"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Sunday Saver World Cup": "Sunday Saver World Cup"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"SAP": "SAP"
}
}Old
{
"x-enum-descriptions": {}
}29 April 2026
New
{
"x-enum-descriptions": {
"rp_migration_multiple": "RP Migration Multiple"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"RP Migration Multiple": "RP Migration Multiple"
}
}Old
{
"x-enum-descriptions": {}
}
No attributes to display
No attributes to display
28 April 2026
No attributes to display
No attributes to display
24 April 2026
No attributes to display
New
{
"gbr-electricity.payment-method": "#/components/schemas/Gbr-electricity.payment-methodCharacteristic"
}New
[
{
"$ref": "#/components/schemas/Gbr-electricity.payment-methodCharacteristic"
},
{
"$ref": "#/components/schemas/SalesChannelCharacteristic"
},
{
"$ref": "#/components/schemas/Gbr-electricity.meter-rate-profileCharacteristic"
}
]Old
[
{
"$ref": "#/components/schemas/SalesChannelCharacteristic"
},
{
"$ref": "#/components/schemas/Gbr-electricity.meter-rate-profileCharacteristic"
}
]New
{
"x-enum-descriptions": {
"vwan": "VWAN"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"VWAN": "VWAN"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"customer_support_fund_engaged": "Customer Support Fund Engaged",
"customer_support_fund_application_received": "Customer Support Fund Application Received"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Customer Support Fund Engaged": "Customer Support Fund Engaged",
"Customer Support Fund Application Received": "Customer Support Fund Application Received"
}
}Old
{
"x-enum-descriptions": {}
}23 April 2026
Old
{
"gbr-electricity.payment-method": "#/components/schemas/Gbr-electricity.payment-methodCharacteristic"
}New
[
{
"$ref": "#/components/schemas/Gbr-electricity.meter-rate-profileCharacteristic"
},
{
"$ref": "#/components/schemas/SalesChannelCharacteristic"
}
]Old
[
{
"$ref": "#/components/schemas/Gbr-electricity.meter-rate-profileCharacteristic"
},
{
"$ref": "#/components/schemas/SalesChannelCharacteristic"
},
{
"$ref": "#/components/schemas/Gbr-electricity.payment-methodCharacteristic"
}
]
No attributes to display
22 April 2026
New
{
"x-enum-descriptions": {}
}Old
{
"x-enum-descriptions": {
"GBE": "National Grid GBE"
}
}New
{
"x-enum-descriptions": {
"incomemax_engaged": "IncomeMax Engaged"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"IncomeMax Engaged": "IncomeMax Engaged"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"sb_commerical_size_meter": "SB Commercial Size Meter"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"SB Commercial Size Meter": "SB Commercial Size Meter"
}
}Old
{
"x-enum-descriptions": {}
}20 April 2026
New
{
"x-enum-descriptions": {
"WORLD_CUP_CREDIT": "WORLD_CUP_CREDIT"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-removal-date": "2026-05-20"
}New
{
"x-removal-date": "2026-05-20"
}Old
{
"nullable": true
}17 April 2026
No attributes to display
No attributes to display
16 April 2026
New
{
"x-enum-descriptions": {
"promo_50_may_renew": "May renew 50",
"promo_75_may_renew": "May renew 75",
"promo_100_may_renew": "May renew 100",
"promo_125_may_renew": "May renew 125",
"promo_150_may_renew": "May renew 150",
"promo_175_may_renew": "May renew 175",
"promo_200_may_renew": "May renew 200"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"May renew 50": "May renew 50",
"May renew 75": "May renew 75",
"May renew 100": "May renew 100",
"May renew 125": "May renew 125",
"May renew 150": "May renew 150",
"May renew 175": "May renew 175",
"May renew 200": "May renew 200"
}
}Old
{
"x-enum-descriptions": {}
}15 April 2026
New
{
"x-enum-descriptions": {
"sb_remote_disconnection": "SB Remote Disconnection"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"SB Remote Disconnection": "SB Remote Disconnection"
}
}Old
{
"x-enum-descriptions": {}
}
No attributes to display
14 April 2026
New
{
"x-enum-descriptions": {
"field_debt_hold_legal": "Field Debt Hold - Legal"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Field Debt Hold - Legal": "Field Debt Hold - Legal"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"bdc_norebook": "BDC_NoRebook"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"BDC_NoRebook": "BDC_NoRebook"
}
}Old
{
"x-enum-descriptions": {}
}9 April 2026
New
{
"x-enum-descriptions": {
"sunday_saver_interest_capture_from_may26": "Sunday Saver Interest for May 26",
"sunday_saver_interest_capture_from_june26": "Sunday Saver Interest for June 26"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Sunday Saver Interest for May 26": "Sunday Saver Interest for May 26",
"Sunday Saver Interest for June 26": "Sunday Saver Interest for June 26"
}
}Old
{
"x-enum-descriptions": {}
}8 April 2026
New
{
"x-enum-descriptions": {
"rms_sms": "RMS SMS"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"RMS SMS": "RMS SMS"
}
}Old
{
"x-enum-descriptions": {}
}2 April 2026
New
{
"x-enum-descriptions": {
"medium_pressure_gas": "MPG"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"MPG": "MPG"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"ca_plymouth_engaged": "CA Plymouth - Engaged Customer"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"CA Plymouth - Engaged Customer": "CA Plymouth - Engaged Customer"
}
}Old
{
"x-enum-descriptions": {}
}1 April 2026
New
{
"x-enum-descriptions": {
"IFS": "IFS"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"health_and_safety_officer_assault": "Field Debt Hold Officer Assaulted"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Field Debt Hold Officer Assaulted": "Field Debt Hold Officer Assaulted"
}
}Old
{
"x-enum-descriptions": {}
}31 March 2026
New
{
"x-enum-descriptions": {
"amr": "AMR",
"amr_mlv": "AMR - MLV"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"AMR": "AMR",
"AMR - MLV": "AMR - MLV"
}
}Old
{
"x-enum-descriptions": {}
}30 March 2026
New
{
"x-enum-descriptions": {
"RESI_DEBT_WRITTEN_OFF_DEBT_RECOVERY_ACTION_CONTINUING": "RESI_DEBT_WRITTEN_OFF_DEBT_RECOVERY_ACTION_CONTINUING",
"SB_DEBT_WRITTEN_OFF_DEBT_RECOVERY_ACTION_CONTINUING_20": "SB_DEBT_WRITTEN_OFF_DEBT_RECOVERY_ACTION_CONTINUING_20",
"SB_DEBT_WRITTEN_OFF_DEBT_RECOVERY_ACTION_CONTINUING_5_VAT": "SB_DEBT_WRITTEN_OFF_DEBT_RECOVERY_ACTION_CONTINUING_5_VAT"
}
}Old
{
"x-enum-descriptions": {}
}
No attributes to display
No attributes to display
27 March 2026
New
{
"x-enum-descriptions": {
"CUSTOM": "Custom"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"CUSTOM": "Custom"
}
}Old
{
"x-enum-descriptions": {}
}26 March 2026
New
{
"x-enum-descriptions": {
"nkc_lkc_emails": "NKC/LKC emails"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"NKC/LKC emails": "NKC/LKC emails"
}
}Old
{
"x-enum-descriptions": {}
}25 March 2026
New
{
"x-enum-descriptions": {
"drs_eligible_debt": "DRS Eligible Debt",
"drs_phase_1_applied": "DRS Phase 1 Applied",
"drs_phase_1_eligible": "DRS Phase 1 Eligible",
"drs_phase_1_qualified": "DRS Phase 1 Qualified"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"DRS Eligible Debt": "DRS Eligible Debt",
"DRS Phase 1 Applied": "DRS Phase 1 Applied",
"DRS Phase 1 Eligible": "DRS Phase 1 Eligible",
"DRS Phase 1 Qualified": "DRS Phase 1 Qualified"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"field_meter_read_visit_outcome_vacant": "Field Meter Read Visit Outcome_Vacant",
"field_meter_read_visit_outcome_cancelled": "Field Meter Read Visit Outcome_Cancelled",
"field_meter_read_visit_outcome_demolished": "Field Meter Read Visit Outcome_Demolished",
"field_meter_read_visit_outcome_meter_faulty": "Field Meter Read Visit Outcome_Meter Faulty",
"field_meter_read_visit_outcome_meter_blocked": "Field Meter Read Visit Outcome_Meter Blocked",
"field_meter_read_visit_outcome_meter_removed": "Field Meter Read Visit Outcome_Meter Removed",
"field_meter_read_visit_outcome_read_received": "Field Meter Read Visit Outcome_Read Received",
"field_meter_read_visit_outcome_access_refused": "Field Meter Read Visit Outcome_Access Refused",
"field_meter_read_visit_outcome_unsafe_premises": "Field Meter Read Visit Outcome_Unsafe Premises",
"field_meter_read_visit_outcome_meter_de_energised": "Field Meter Read Visit Outcome_Meter De_Energised",
"field_meter_read_visit_outcome_meter_perm_blocked": "Field Meter Read Visit Outcome_Meter Perm Blocked",
"field_meter_read_visit_outcome_meter_temp_blocked": "Field Meter Read Visit Outcome_Meter Temp Blocked",
"field_meter_read_visit_outcome_insufficient_address": "Field Meter Read Visit Outcome_Insufficient Address",
"field_meter_read_visit_outcome_no_access_keycode_unavailable": "Field Meter Read Visit Outcome_No Access_KeyCode Unavailable",
"field_meter_read_visit_outcome_insufficient_address_missing_town": "Field Meter Read Visit Outcome_Insufficient Address_Missing Town",
"field_meter_read_visit_outcome_access_refused_appointment_required": "Field Meter Read Visit Outcome_Access Refused_Appointment Required",
"field_meter_read_visit_outcome_insufficient_address_incorrect_postcode": "Field Meter Read Visit Outcome_Insufficient Address_Incorrect Postcode",
"field_meter_read_visit_outcome_meter_temp_blocked_key_or_code_required": "Field Meter Read Visit Outcome_Meter Temp Blocked_Key or Code Required",
"field_meter_read_visit_outcome_insufficient_address_missing_street_name": "Field Meter Read Visit Outcome_Insufficient Address_Missing Street Name",
"field_meter_read_visit_outcome_insufficient_address_missing_business_name": "Field Meter Read Visit Outcome_Insufficient Address_Missing Business Name",
"field_meter_read_visit_outcome_access_refused_password_required_for_access": "Field Meter Read Visit Outcome_Access Refused_Password Required for Access",
"field_meter_read_visit_outcome_insufficient_address_missing_house_name_or_no": "Field Meter Read Visit Outcome_Insufficient Address_Missing House Name or No"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Field Meter Read Visit Outcome_Vacant": "Field Meter Read Visit Outcome_Vacant",
"Field Meter Read Visit Outcome_Cancelled": "Field Meter Read Visit Outcome_Cancelled",
"Field Meter Read Visit Outcome_Demolished": "Field Meter Read Visit Outcome_Demolished",
"Field Meter Read Visit Outcome_Meter Faulty": "Field Meter Read Visit Outcome_Meter Faulty",
"Field Meter Read Visit Outcome_Meter Blocked": "Field Meter Read Visit Outcome_Meter Blocked",
"Field Meter Read Visit Outcome_Meter Removed": "Field Meter Read Visit Outcome_Meter Removed",
"Field Meter Read Visit Outcome_Read Received": "Field Meter Read Visit Outcome_Read Received",
"Field Meter Read Visit Outcome_Access Refused": "Field Meter Read Visit Outcome_Access Refused",
"Field Meter Read Visit Outcome_Unsafe Premises": "Field Meter Read Visit Outcome_Unsafe Premises",
"Field Meter Read Visit Outcome_Meter De_Energised": "Field Meter Read Visit Outcome_Meter De_Energised",
"Field Meter Read Visit Outcome_Meter Perm Blocked": "Field Meter Read Visit Outcome_Meter Perm Blocked",
"Field Meter Read Visit Outcome_Meter Temp Blocked": "Field Meter Read Visit Outcome_Meter Temp Blocked",
"Field Meter Read Visit Outcome_Insufficient Address": "Field Meter Read Visit Outcome_Insufficient Address",
"Field Meter Read Visit Outcome_No Access_KeyCode Unavailable": "Field Meter Read Visit Outcome_No Access_KeyCode Unavailable",
"Field Meter Read Visit Outcome_Insufficient Address_Missing Town": "Field Meter Read Visit Outcome_Insufficient Address_Missing Town",
"Field Meter Read Visit Outcome_Access Refused_Appointment Required": "Field Meter Read Visit Outcome_Access Refused_Appointment Required",
"Field Meter Read Visit Outcome_Insufficient Address_Incorrect Postcode": "Field Meter Read Visit Outcome_Insufficient Address_Incorrect Postcode",
"Field Meter Read Visit Outcome_Meter Temp Blocked_Key or Code Required": "Field Meter Read Visit Outcome_Meter Temp Blocked_Key or Code Required",
"Field Meter Read Visit Outcome_Insufficient Address_Missing Street Name": "Field Meter Read Visit Outcome_Insufficient Address_Missing Street Name",
"Field Meter Read Visit Outcome_Insufficient Address_Missing Business Name": "Field Meter Read Visit Outcome_Insufficient Address_Missing Business Name",
"Field Meter Read Visit Outcome_Access Refused_Password Required for Access": "Field Meter Read Visit Outcome_Access Refused_Password Required for Access",
"Field Meter Read Visit Outcome_Insufficient Address_Missing House Name or No": "Field Meter Read Visit Outcome_Insufficient Address_Missing House Name or No"
}
}Old
{
"x-enum-descriptions": {}
}24 March 2026
New
{
"x-removal-date": "2026-04-29"
}23 March 2026
New
{
"x-enum-descriptions": {
"dd_refund_campaign": "DD Refund Campaign"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"DD Refund Campaign": "DD Refund Campaign"
}
}Old
{
"x-enum-descriptions": {}
}19 March 2026
New
{
"items": {
"x-enum-descriptions": {}
}
}Old
{
"items": {
"x-enum-descriptions": {
"BALOG4O": "BALOG4O"
}
}
}New
{
"items": {
"x-enum-descriptions": {}
}
}Old
{
"items": {
"x-enum-descriptions": {
"BALOG4O": "BALOG4O"
}
}
}New
{
"x-enum-descriptions": {}
}Old
{
"x-enum-descriptions": {
"BALOG4O": "BALOG4O"
}
}New
{
"items": {
"x-enum-descriptions": {}
}
}Old
{
"items": {
"x-enum-descriptions": {
"BALOG4O": "BALOG4O"
}
}
}18 March 2026
New
{
"x-enum-descriptions": {
"OFGEM_DEBT_RELIEF_SCHEME_GROUP_1": "OFGEM_DEBT_RELIEF_SCHEME_GROUP_1",
"OFGEM_DEBT_RELIEF_SCHEME_GROUP_2": "OFGEM_DEBT_RELIEF_SCHEME_GROUP_2"
}
}Old
{
"x-enum-descriptions": {
"DEBT_RELIEF_SCHEME_GROUP_1": "DEBT_RELIEF_SCHEME_GROUP_1",
"DEBT_RELIEF_SCHEME_GROUP_2": "DEBT_RELIEF_SCHEME_GROUP_2"
}
}17 March 2026
New
{
"x-enum-descriptions": {
"smart_apology": "Smart_Apology"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Smart_Apology": "Smart_Apology"
}
}Old
{
"x-enum-descriptions": {}
}16 March 2026
New
{
"x-enum-descriptions": {
"cos_auto_objection_removal": "Cos auto objection removal"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Cos auto objection removal": "Cos auto objection removal"
}
}Old
{
"x-enum-descriptions": {}
}
No attributes to display
New
{
"gbr-electricity.meter-rate-profile": "#/components/schemas/Gbr-electricity.meter-rate-profileCharacteristic"
}New
[
{
"$ref": "#/components/schemas/Gbr-electricity.payment-methodCharacteristic"
},
{
"$ref": "#/components/schemas/SalesChannelCharacteristic"
},
{
"$ref": "#/components/schemas/Gbr-electricity.meter-rate-profileCharacteristic"
}
]Old
[
{
"$ref": "#/components/schemas/Gbr-electricity.payment-methodCharacteristic"
},
{
"$ref": "#/components/schemas/SalesChannelCharacteristic"
}
]13 March 2026
New
{
"x-enum-descriptions": {
"GBE": "National Grid GBE"
}
}Old
{
"x-enum-descriptions": {}
}11 March 2026
New
{
"x-enum-descriptions": {
"ia": "Insufficient Address",
"meter_blocked": "Meter Blocked",
"ra-obstructive": "Refused Access - Obstructive",
"refused_access": "Refused Access - Appointment Letter",
"refused_access_cor": "Refused Access - CoR"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Meter Blocked": "Meter Blocked",
"Insufficient Address": "Insufficient Address",
"Refused Access - CoR": "Refused Access - CoR",
"Refused Access - Obstructive": "Refused Access - Obstructive",
"Refused Access - Appointment Letter": "Refused Access - Appointment Letter"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"deemedcampaign1": "DeemedCampaign1",
"deemedcampaign2": "DeemedCampaign2"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"DeemedCampaign1": "DeemedCampaign1",
"DeemedCampaign2": "DeemedCampaign2"
}
}Old
{
"x-enum-descriptions": {}
}9 March 2026
New
{
"x-enum-descriptions": {
"apologydnc": "Apology DNC",
"whd_nr_2026": "Warm Home Discount NR 2026"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Apology DNC": "Apology DNC",
"Warm Home Discount NR 2026": "Warm Home Discount NR 2026"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"tempdnc": "Temp DNC"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Temp DNC": "Temp DNC"
}
}Old
{
"x-enum-descriptions": {}
}5 March 2026
New
{
"x-enum-descriptions": {}
}Old
{
"x-enum-descriptions": {
"TPD_GAS_PAYMENTS": "TPD_GAS_PAYMENTS",
"TPD_ELEC_PAYMENTS": "TPD_ELEC_PAYMENTS"
}
}New
{
"x-enum-descriptions": {
"fuel_direct_arrears_only": "Fuel Direct arrears only"
}
}Old
{
"x-enum-descriptions": {
"fuel_direct_vulnerable": "Fuel Direct Vulnerable"
}
}New
{
"x-enum-descriptions": {
"Fuel Direct arrears only": "Fuel Direct arrears only"
}
}Old
{
"x-enum-descriptions": {
"Fuel Direct Vulnerable": "Fuel Direct Vulnerable"
}
}New
{
"x-enum-descriptions": {
"TPD_GAS_PAYMENTS": "TPD_GAS_PAYMENTS",
"TPD_ELEC_PAYMENTS": "TPD_ELEC_PAYMENTS"
}
}Old
{
"x-enum-descriptions": {}
}2 March 2026
New
{
"x-enum-descriptions": {
"OVERDALES_DEBT_WRITE_OFF": "OVERDALES_DEBT_WRITE_OFF"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"sunday_saver_interest_capture_from_april26": "Sunday Saver Interest for April 26"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Sunday Saver Interest for April 26": "Sunday Saver Interest for April 26"
}
}Old
{
"x-enum-descriptions": {}
}27 February 2026
New
{
"x-enum-descriptions": {
"rp_migration": "RP Migration"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"RP Migration": "RP Migration"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-validators": [
{
"name": "Validate <code>organisation_number</code>",
"description": "Validate that the given <code>organisation_number</code> has a corresponding organisation registered in the database.",
"possible_errors": [
"partner_organisation_does_not_exist"
]
}
]
}24 February 2026
New
{
"x-enum-descriptions": {
"heaters_for_rts_psr_customers": "Heaters for RTS PSR Customers"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Heaters for RTS PSR Customers": "Heaters for RTS PSR Customers"
}
}Old
{
"x-enum-descriptions": {}
}
No attributes to display
19 February 2026
New
[
{
"name": "Validate account type is valid",
"description": "Validate that only one account type is specified in the payload.",
"possible_errors": [
"multiple_account_types_selected"
]
},
{
"name": "Validate billing address fields",
"description": "If a legacy billing address is provided, validate that it is in the correct format.",
"possible_errors": [
"invalid_address"
]
},
{
"name": "Validate customer family name",
"description": "Validate the family name is provided for all customers on a domestic account. For Business accounts, set the family name to 'Business' if it is not provided.",
"possible_errors": [
"customer_family_name_required"
]
},
{
"name": "Validate metadata",
"description": "Validate that metadata, which is a list of key value pairs, does not contain duplicate keys.",
"possible_errors": [
"metadata_has_duplicate_keys"
]
},
{
"name": "Validate managed account type is allowed",
"description": "Validate that this instance of Kraken allows managed account types.",
"possible_errors": [
"managed_accounts_are_not_allowed"
]
},
{
"name": "Validate only portfolio lead has portfolio setting",
"description": "Validates that if portfolio settings are provided, then the account is marked as the portfolio lead.",
"possible_errors": [
"portfolio_settings_included_when_not_lead"
]
},
{
"name": "Validate business type and company number not provided for domestic accounts",
"description": "Validate that neither a business type or company number are provided for domestic accounts.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate no customers for unknown occupier",
"description": "Validate that no customers are provided for an unknown occupier.",
"possible_errors": [
"customer_with_unknown_occupier"
]
},
{
"name": "Validate that a customer given name is provided for business accounts",
"description": "Validate that a given name is provided for all customers on a business account. Note that this validation only applies if Kraken is configured to send registration flows for this import supplier.",
"possible_errors": [
"customer_given_name_required"
]
},
{
"name": "Validate portfolio reference provided correctly",
"description": "Validate that a portfolio reference is provided if portfolio settings have been provided and that a portfolio reference is not provided if the import supplier is set to create new portfolios.",
"possible_errors": [
"portfolio_references_missing",
"portfolio_references_provided"
]
},
{
"name": "Validate billing address style",
"description": "Validate that a legacy billing address (<code>billing_address1</code> etc.) and new-style billing address (<code>billing_address</code> object) are not both provided.",
"possible_errors": [
"billing_address_new_style_and_legacy"
]
},
{
"name": "Validate agreements are consecutive per supply point",
"description": "Validate that the agreements provided in the payload are consecutive per supply point i.e. there are no gaps or overlaps. The exception to this is for agreements provided before the current supply period for the supply point. Agreements provided before the <code>supply_start_date</code> are allowed gaps since they represent historic periods of supply and cannot be used for billing in Kraken.",
"possible_errors": [
"gaps_or_overlaps_in_agreement_dates"
]
},
{
"name": "Validate supply charge line items covered by a single agreement",
"description": "Validate each supply charge has a single agreement with matching product code that covers the period defined by it's line items minimum <code>start_date</code> to maximum <code>end_date</code>.",
"possible_errors": [
"supply_charge_line_items_not_covered_by_single_agreement"
]
},
{
"name": "Validate historical statement period end must not be in the future",
"description": "Ensures that the historical statement period end date (last_statement_closing_date or latest transaction_date) is not set in the future.",
"possible_errors": [
"historical_statement_period_end_in_future"
]
},
{
"name": "Validate that terms with supply type matches a supply point supply type",
"description": "Validate that for terms containing a <code>supply_type</code> field that there is a supply point in the payload with a matching <code>supply_type</code>.",
"possible_errors": [
"term_supply_type_mismatch"
]
},
{
"name": "Validate that supply addresses and supply points are provided if account contracts are provided",
"description": "Validate that if <code>account_contracts</code> have been provided that a supply address with supply points has been provided under <code>supply_addresses</code>",
"possible_errors": [
"account_contracts_without_supply_points"
]
},
{
"name": "Validate historical statement billing document identifier presence",
"description": "Ensure that billing document identifiers are only provided for historical statement transactions and only when the relevant feature flag is enabled.",
"possible_errors": [
"historical_statement_billing_document_identifier_missing",
"historical_statement_billing_document_identifier_not_allowed_when_feature_flag_disabled"
]
},
{
"name": "Validate current statement transactions do not provide <code>billing_document_identifier</code>",
"description": "Validate that none of the current statement transactions include a <code>billing_document_identifier</code>, as this field is only applicable to historical statement transactions.",
"possible_errors": [
"billing_document_identifier_not_allowed_for_current_statement_transactions"
]
},
{
"name": "Validate historical statement transaction billing document identifier",
"description": "Ensure that the billing document identifier is the same for all historical statement transactions.",
"possible_errors": [
"historical_statement_billing_document_identifier_mismatch"
]
},
{
"name": "Validate that contract terms' product codes are part of supply agreements",
"description": "Ensure that any contract terms with product references have corresponding products in supply addresses.",
"possible_errors": [
"contract_term_product_code_not_in_agreements"
]
},
{
"name": "Validate that business is provided if enforcing business contracts",
"description": "Validate that the business field is provided if <code>enforce_business_contracts_exist</code> is set to True on the import supplier configuration.",
"possible_errors": [
"business_field_required"
]
},
{
"name": "Validate that the sum of ledger balances equals the transfer balance",
"description": "Validate that the sum of all <code>ledger_balance</code> provided for each ledger in <code>ledgers</code> equals the account-level <code>transfer_balance</code>.",
"possible_errors": [
"ledger_balances_not_equal_to_transfer_balance"
]
},
{
"name": "Validate business user info against customer info",
"description": "Validates that business user information matches the corresponding customer information for basic fields.",
"possible_errors": [
"customer_details_and_user_details_both_provided"
]
},
{
"name": "Validate payment preference <code>ledger_identifier</code>",
"description": "Ensure that the <code>ledger_identifier</code> provided has an equivalent <code>ledger</code> object with the same <code>ledger_identifier</code> .",
"possible_errors": [
"invalid_payment_preference_ledger_identifier"
]
},
{
"name": "Validate that referenced ledgers are unique in payment preferences",
"description": "Ensure that each ledger is referenced in at most one payment preference.",
"possible_errors": [
"duplicate_ledger_in_payment_preferences"
]
},
{
"name": "Validate that valid instruction_identifier provided for <code>ACTIVE_NEW</code> payment preference",
"description": "Ensure that <code>ACTIVE_NEW</code> payment preference has instruction_identifier from </code>payment_instructions</code> object.",
"possible_errors": [
"active_new_payment_preference_invalid_instruction_identifier"
]
},
{
"name": "Validate that the transactions for a voucher do not exceed its value",
"description": "Validate that the sum of all transaction values for a voucher is not greater than the value of the voucher.",
"possible_errors": [
"voucher_transactions_sum_greater_than_voucher_value"
]
},
{
"name": "Validate that each voucher charge transaction id has a matching transaction id within a transaction of type CHARGE",
"description": "Validate that each <code>voucher</code> <code>charge_transaction_id</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CHARGE in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_charge_transaction_id_not_found"
]
},
{
"name": "Validate that each voucher redemption credit transaction id has a matching transaction id within a transaction of type CREDIT",
"description": "Validate that every <code>credit_transaction_id</code> in all <code>voucher_redemptions</code> in every <code>voucher</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CREDIT in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_redemption_credit_transaction_id_not_found"
]
},
{
"name": "Validate auto allocation of operations team",
"description": "Validate that operations_team_name is provided if auto allocation is not configured.",
"possible_errors": [
"operations_team_provided_when_using_auto_allocation",
"operations_team_should_be_provided"
]
},
{
"name": "Validate that Kraken can calculate when to start billing the account",
"description": "Validate that Kraken can calculate when to start billing the account. This is determined based on the existence of last billed to date, last statement closing date, and agreements.",
"possible_errors": [
"cannot_determine_responsible_for_billing_from_date"
]
},
{
"name": "Validate that if historical statement transaction are provided then so is a last statement closing date or last billed to date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided in the payload then either a <code>last_statement_closing_date</code> or <code>last_billed_to_date</code> is also provided. If a <code>last_statement_closing_date</code> is not provided then the earliest <code>last_billed_to_date</code> on the account or supply points is used to determine when the last statement should have closed.",
"possible_errors": [
"historical_statement_transactions_without_last_statement_closing_date_or_last_billed_to_date"
]
},
{
"name": "Validate unique transaction IDs",
"description": "Validate that all transaction IDs provided are unique.",
"possible_errors": [
"duplicate_transaction_ids",
"missing_transaction_id"
]
},
{
"name": "Validate current statement transactions are after historical statement transactions",
"description": "Validate that all current statement transactions are dated after all current historical statement transactions.",
"possible_errors": [
"historical_statement_transaction_after_current_statement_transaction"
]
},
{
"name": "Validate that there are no historical statement transactions after the last statement closing date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided then none are later than the <code>last_statement_closing_date</code>. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"historical_statement_transaction_after_last_statement_closing_date"
]
},
{
"name": "Validate that the last statement issue date is on or after the last statement closing date",
"description": "Validate that the <code>last_statement_issue_date</code>, if given, is on or after the <code>last_statement_closing_date</code> given. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"last_statement_issued_before_closing_date"
]
},
{
"name": "Validate no duplicated ledgers are provided",
"description": "Validate no duplicated ledger codes are in `ledgers` section.",
"possible_errors": [
"duplicate_ledger_entries_found"
]
},
{
"name": "Validate identifiers are unique in ledgers",
"description": "Validate identifier is not declared twice in ledgers.",
"possible_errors": [
"duplicate_identifiers_entries_found"
]
},
{
"name": "Validate ledger identifiers are known",
"description": "Validate ledger identifiers are among supply point identifiers.",
"possible_errors": [
"unknown_ledger_identifiers"
]
},
{
"name": "Validate payment adequacy changes or last payment review date not both",
"description": "Validate that only one of <code>payment_adequacy_changes</code> or <code>last_payment_review_date</code> is provided in the payload.",
"possible_errors": [
"payment_adequacy_changes_and_last_payment_review_date_provided"
]
},
{
"name": "Validate that payment plans and payment schedules for the same ledger are not both in payload",
"description": "Validate that if there are payment plans in the payload, there are not also payment schedules on the same ledger because payment plans create a schedule containing all of the planned payments.",
"possible_errors": [
"payment_plan_and_payment_schedule_not_allowed_on_same_ledger"
]
},
{
"name": "Validate no more than one property for unknown occupier",
"description": "Validate that no more than one property is provided for an unknown occupier account.",
"possible_errors": [
"occupier_account_with_multiple_supply_addresses"
]
},
{
"name": "Validate no direct debit reference for the occupier",
"description": "Validate that if any customer is identified as an occupier, then no <code>dd_reference</code> is provided for the account. If a <code>dd_reference</code> is provided, then it implies that there is a known occupier for the account.",
"possible_errors": [
"dd_reference_for_occupier_account"
]
},
{
"name": "Validate no unbilled period on former supply addresses",
"description": "Validate that if a customer is no longer at the given supply address they have been fully billed. This check is performed if we are importing supply address history.",
"possible_errors": [
"unbilled_former_supply_address"
]
},
{
"name": "Validate that agreements cover the last billed to date",
"description": "Validate that there is an agreement covering the last billed to date for each supply point.",
"possible_errors": [
"no_agreement_covering_last_billed_to_date"
]
},
{
"name": "Validate debt and debts",
"description": "Validates that both debt and debts are not specified in the payload.",
"possible_errors": [
"debt_and_debts_are_defined"
]
},
{
"name": "Validate that a last billed to date has been provided correctly",
"description": "Validate that, for each meter, a last billed to date has been provided in the appropriate place. For electricity meters, it must be provided on each of the meter's settlement registers. For gas meters, it must be provided on the meter. This validation does not apply to meters with half-hourly billing, or meters that have been exchanged where the new meter has already been billed. This validation is skipped if the account has not yet been billed and therefore has no historical statement data.",
"possible_errors": [
"last_billed_to_date_not_found"
]
},
{
"name": "Validate that current statement transactions are not before the current statement opening date",
"description": "Validate that all <code>current_statement_transactions</code>, if provided, are not before the current statement opening date. This date is one day after the last statement closing date if provided, otherwise it is based on the last billed to date. Note that any prepay vend transactions are not included in the above check.",
"possible_errors": [
"current_statement_transaction_before_current_statement_opening_date"
]
},
{
"name": "Validate <code>last_statement_balance</code> plus/minus <code>current_statement_transactions</code> equal <code>transfer_balance</code>",
"description": "Validate that the sum of <code>current_statement_transactions</code> plus the <code>last_statement_balance</code> is equal to the <code>transfer_balance</code>. For example, if a <code>last_statement_balance</code> of 100 is provided, and the <code>current_statement_transactions</code> include one payment of 50, then the expected <code>transfer_balance</code> would 150. Transactions that are payments or credits add to the balance. Transactions that are repayments or charges subtract from the balance. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"balance_mismatch_on_transfer_balance"
]
},
{
"name": "Validate that the summed historical statement transactions match the last statement balance",
"description": "Validate that the sum of the <code>historical_statement_transactions</code> equals the <code>last_statement_balance</code>. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"historical_statement_transactions_balance_mismatch"
]
},
{
"name": "Validate next bill due date provided for quarterly billing",
"description": "Validate that if <code>use_industry_billing</code> is false in the account billing options and the <code>period_length</code> is <code>QUARTERLY</code>, then a <code>next_bill_due_date</code> is provided.",
"possible_errors": [
"next_bill_to_date_not_provided_for_quarterly_billing"
]
},
{
"name": "Validate account billing options",
"description": "Validate that account billing options have only been provided for business accounts.",
"possible_errors": [
"account_billing_options_provided_for_domestic_accounts"
]
},
{
"name": "Validate alternative phone number is unique",
"description": "Validate customers defined in the payload do not have the same alternative phone numbers.",
"possible_errors": [
"duplicated_alternative_phone_numbers"
]
},
{
"name": "Validate that prepay transactions target initialised prepay meters",
"description": "Validate that if <code>current_statement_transactions</code> or <code>historical_statement_transactions</code> target a prepay meter (i.e. has the <code>to_prepay_meter_serial_number</code> field), then a prepay meter with that serial number exists in the payload. A prepay meter is identified in the payload by the presence of <code>prepay_details</code>.",
"possible_errors": [
"transactions_target_non_initialised_prepay_meter"
]
},
{
"name": "Validate tax exemption for appropriate account type",
"description": "Validate that the tax exemption is only in place for business accounts.",
"possible_errors": [
"tax_exemptions_provided_for_domestic_account"
]
},
{
"name": "Validate prepay transfer vend read dates match last billed to date",
"description": "Validate that the transfer vend read dates match the last billed to date. This only applies to prepay meters.The last billed to date can be either at the account level or the at the meter/register level. Last billed to dates at the meter/register level take precedent over the account level date if both are provided.",
"possible_errors": [
"prepay_details_on_fully_billed_meter",
"transfer_vend_read_date_must_match_last_billed_to_date"
]
},
{
"name": "Validate that the tariff type and meter point type match",
"description": "Validate that the tariff we have on a given contract matches the meter point type. For example, check eco7 (2-rate) meter points don't have single-rate tariffs or vice versa.",
"possible_errors": [
"tariff_type_does_not_match_meter_point_type"
]
},
{
"name": "Validate bespoke rates",
"description": "Validate that if bespoke rates have been set the account is business.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate billing address provided",
"description": "Validate <code>billing_address1</code> and <code>billing_postcode</code> are provided for non-occupier accounts.",
"possible_errors": [
"billing_address_not_provided"
]
},
{
"name": "Validate current AQ for billable meter point",
"description": "Check that we have a currently valid AQ for a billable MPRN.",
"possible_errors": [
"no_current_or_future_aq_entry_found"
]
},
{
"name": "Validate all billable meter points are covered by agreements in the payload",
"description": "Validate that agreements have been provided for all billable meter points and vice versa for the period covered by Kraken from a billing perspective. A billable meter point is one that has an open-ended or future dated supply end date.",
"possible_errors": [
"meter_point_with_no_agreement",
"meterpoint_with_agreement_not_on_supply"
]
},
{
"name": "Validate transfer readings exist on active gas meters",
"description": "Validate that each active gas meter has a single transfer reading provided.",
"possible_errors": [
"active_gas_meter_with_multiple_transfer_readings",
"active_gas_meter_without_transfer_reading",
"reading_meter_fully_billed"
]
},
{
"name": "Validate EACs provided for active registers",
"description": "Validate that EACs are provided in the <code>eac_history</code> array for each active electricity register. EACs are matched to registers using the <code>tpr</code> field present on both the EAC and register objects.",
"possible_errors": [
"missing_eacs_for_active_register_tpr"
]
},
{
"name": "Validate that prepay meters are matched to agreements of the correct type",
"description": "Validate that each prepay meter has a matching agreement on a prepay tariff, and similarly non-prepay meters on non-prepay tariffs. Note that this validation only applies for active meters and agreements.",
"possible_errors": [
"tariff_type_does_not_match_meter_type"
]
},
{
"name": "Validate each agreement is not effective before the product is available",
"description": "Ensures that the agreement <code>effective_from</code> is not before the datetime the agreement's product is available from. We check this if Kraken will be responsible for billing before the product is available and the product is a variable or tracker product.",
"possible_errors": [
"agreement_effective_from_before_product_available_from"
]
},
{
"name": "Validate that all variable products on a contract have start dates after the product start date",
"description": "Validate that any variable products that are part of a contract only become effective after the product is available.",
"possible_errors": [
"agreement_cannot_start_before_product_available"
]
},
{
"name": "Validate that no meter points are ending supply in the future",
"description": "Ensure that all meters points have either ended supply or are not planned for supply to end.",
"possible_errors": [
"future_supply_end_date"
]
},
{
"name": "Validate that all off supply meter points with meters have a final reading",
"description": "Ensure that all off supply meter points which have meters have a final reading on their end date.",
"possible_errors": [
"no_reading_on_supply_end_date"
]
},
{
"name": "Validate that no billable meter points are starting supply in the future",
"description": "Validate that no billable meter points are set to start supply in the future.",
"possible_errors": [
"future_supply_start_date"
]
},
{
"name": "Validate that all billable meter points have active meters",
"description": "Ensure that all meter points that are billable have active meters or have an unmetered measurement class provided in the payload.",
"possible_errors": [
"meter_point_with_no_meters"
]
},
{
"name": "Validate that at least one of the meter points needs billing",
"description": "Ensure that at least one of the meter points for this account are billable.",
"possible_errors": [
"no_supply_point_on_supply"
]
},
{
"name": "Validate that a domestic account does not have any business only supply points",
"description": "Validate that a domestic account does not have supply points with supply types <code>REGOS_EXPORT_CERTIFICATES</code> or <code>ROCS_EXPORT_CERTIFICATES</code> which are business only supply types.",
"possible_errors": [
"business_supply_type_on_domestic_account"
]
},
{
"name": "Validate business account has account billing options with <code>period_start_day</code> and <code>period_length</code>",
"description": "Validate that business account's <code>account_billing_options</code> include period start day and period length if <code>account_billing_options</code> is being provided. If <code>account_billing_options</code> is not provided then the defaults of 1 for <code>period_start_day</code> and \"MONTHLY\" for <code>period_length</code> will be used.",
"possible_errors": [
"business_account_missing_billing_options"
]
},
{
"name": "Validate that customers provided for business accounts",
"description": "Validate that at least one customer is provided for business accounts. Customers are needed for business accounts to ensure that meter points can be successfully registered for supply.",
"possible_errors": [
"business_account_missing_customers"
]
},
{
"name": "Validate current statement transactions are not before <code>last_billed_to_date</code>",
"description": "Validate that there are no current statement transactions that occurred before the <code>last_billed_to_date</code> (this includes the supply point-level <code>last_billed_to_date</code>, as well as any meter- or register-level dates where applicable).",
"possible_errors": [
"current_statement_transaction_before_last_billed_to_date"
]
},
{
"name": "Validate transfer readings exist on active electricity registers",
"description": "Validate that each active electricity meter register has a single transfer reading provided.",
"possible_errors": [
"missing_transfer_reading_for_register",
"multiple_transfer_readings_for_register"
]
}
]Old
[
{
"name": "Validate account type is valid",
"description": "Validate that only one account type is specified in the payload.",
"possible_errors": [
"multiple_account_types_selected"
]
},
{
"name": "Validate billing address fields",
"description": "If a legacy billing address is provided, validate that it is in the correct format.",
"possible_errors": [
"invalid_address"
]
},
{
"name": "Validate customer family name",
"description": "Validate the family name is provided for all customers on a domestic account. For Business accounts, set the family name to 'Business' if it is not provided.",
"possible_errors": [
"customer_family_name_required"
]
},
{
"name": "Validate metadata",
"description": "Validate that metadata, which is a list of key value pairs, does not contain duplicate keys.",
"possible_errors": [
"metadata_has_duplicate_keys"
]
},
{
"name": "Validate managed account type is allowed",
"description": "Validate that this instance of Kraken allows managed account types.",
"possible_errors": [
"managed_accounts_are_not_allowed"
]
},
{
"name": "Validate only portfolio lead has portfolio setting",
"description": "Validates that if portfolio settings are provided, then the account is marked as the portfolio lead.",
"possible_errors": [
"portfolio_settings_included_when_not_lead"
]
},
{
"name": "Validate business type and company number not provided for domestic accounts",
"description": "Validate that neither a business type or company number are provided for domestic accounts.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate no customers for unknown occupier",
"description": "Validate that no customers are provided for an unknown occupier.",
"possible_errors": [
"customer_with_unknown_occupier"
]
},
{
"name": "Validate that a customer given name is provided for business accounts",
"description": "Validate that a given name is provided for all customers on a business account. Note that this validation only applies if Kraken is configured to send registration flows for this import supplier.",
"possible_errors": [
"customer_given_name_required"
]
},
{
"name": "Validate portfolio reference provided correctly",
"description": "Validate that a portfolio reference is provided if portfolio settings have been provided and that a portfolio reference is not provided if the import supplier is set to create new portfolios.",
"possible_errors": [
"portfolio_references_missing",
"portfolio_references_provided"
]
},
{
"name": "Validate billing address style",
"description": "Validate that a legacy billing address (<code>billing_address1</code> etc.) and new-style billing address (<code>billing_address</code> object) are not both provided.",
"possible_errors": [
"billing_address_new_style_and_legacy"
]
},
{
"name": "Validate contracts are consecutive per supply point",
"description": "Validate that the contracts provided in the payload are consecutive per supply point i.e. there are no gaps or overlaps. The exception to this is for contracts provided before the current supply period for the supply point. Contracts provided before the <code>supply_start_date</code> are allowed gaps since they represent historic periods of supply and cannot be used for billing in Kraken.",
"possible_errors": [
"gaps_or_overlaps_in_agreement_dates"
]
},
{
"name": "Validate supply charge line items covered by a single agreement",
"description": "Validate each supply charge has a single agreement with matching product code that covers the period defined by it's line items minimum <code>start_date</code> to maximum <code>end_date</code>.",
"possible_errors": [
"supply_charge_line_items_not_covered_by_single_agreement"
]
},
{
"name": "Validate historical statement period end must not be in the future",
"description": "Ensures that the historical statement period end date (last_statement_closing_date or latest transaction_date) is not set in the future.",
"possible_errors": [
"historical_statement_period_end_in_future"
]
},
{
"name": "Validate that terms with supply type matches a supply point supply type",
"description": "Validate that for terms containing a <code>supply_type</code> field that there is a supply point in the payload with a matching <code>supply_type</code>.",
"possible_errors": [
"term_supply_type_mismatch"
]
},
{
"name": "Validate that supply addresses and supply points are provided if account contracts are provided",
"description": "Validate that if <code>account_contracts</code> have been provided that a supply address with supply points has been provided under <code>supply_addresses</code>",
"possible_errors": [
"account_contracts_without_supply_points"
]
},
{
"name": "Validate historical statement billing document identifier presence",
"description": "Ensure that billing document identifiers are only provided for historical statement transactions and only when the relevant feature flag is enabled.",
"possible_errors": [
"historical_statement_billing_document_identifier_missing",
"historical_statement_billing_document_identifier_not_allowed_when_feature_flag_disabled"
]
},
{
"name": "Validate current statement transactions do not provide <code>billing_document_identifier</code>",
"description": "Validate that none of the current statement transactions include a <code>billing_document_identifier</code>, as this field is only applicable to historical statement transactions.",
"possible_errors": [
"billing_document_identifier_not_allowed_for_current_statement_transactions"
]
},
{
"name": "Validate historical statement transaction billing document identifier",
"description": "Ensure that the billing document identifier is the same for all historical statement transactions.",
"possible_errors": [
"historical_statement_billing_document_identifier_mismatch"
]
},
{
"name": "Validate that contract terms' product codes are part of supply agreements",
"description": "Ensure that any contract terms with product references have corresponding products in supply addresses.",
"possible_errors": [
"contract_term_product_code_not_in_agreements"
]
},
{
"name": "Validate that business is provided if enforcing business contracts",
"description": "Validate that the business field is provided if <code>enforce_business_contracts_exist</code> is set to True on the import supplier configuration.",
"possible_errors": [
"business_field_required"
]
},
{
"name": "Validate that the sum of ledger balances equals the transfer balance",
"description": "Validate that the sum of all <code>ledger_balance</code> provided for each ledger in <code>ledgers</code> equals the account-level <code>transfer_balance</code>.",
"possible_errors": [
"ledger_balances_not_equal_to_transfer_balance"
]
},
{
"name": "Validate business user info against customer info",
"description": "Validates that business user information matches the corresponding customer information for basic fields.",
"possible_errors": [
"customer_details_and_user_details_both_provided"
]
},
{
"name": "Validate payment preference <code>ledger_identifier</code>",
"description": "Ensure that the <code>ledger_identifier</code> provided has an equivalent <code>ledger</code> object with the same <code>ledger_identifier</code> .",
"possible_errors": [
"invalid_payment_preference_ledger_identifier"
]
},
{
"name": "Validate that referenced ledgers are unique in payment preferences",
"description": "Ensure that each ledger is referenced in at most one payment preference.",
"possible_errors": [
"duplicate_ledger_in_payment_preferences"
]
},
{
"name": "Validate that valid instruction_identifier provided for <code>ACTIVE_NEW</code> payment preference",
"description": "Ensure that <code>ACTIVE_NEW</code> payment preference has instruction_identifier from </code>payment_instructions</code> object.",
"possible_errors": [
"active_new_payment_preference_invalid_instruction_identifier"
]
},
{
"name": "Validate that the transactions for a voucher do not exceed its value",
"description": "Validate that the sum of all transaction values for a voucher is not greater than the value of the voucher.",
"possible_errors": [
"voucher_transactions_sum_greater_than_voucher_value"
]
},
{
"name": "Validate that each voucher charge transaction id has a matching transaction id within a transaction of type CHARGE",
"description": "Validate that each <code>voucher</code> <code>charge_transaction_id</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CHARGE in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_charge_transaction_id_not_found"
]
},
{
"name": "Validate that each voucher redemption credit transaction id has a matching transaction id within a transaction of type CREDIT",
"description": "Validate that every <code>credit_transaction_id</code> in all <code>voucher_redemptions</code> in every <code>voucher</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CREDIT in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_redemption_credit_transaction_id_not_found"
]
},
{
"name": "Validate auto allocation of operations team",
"description": "Validate that operations_team_name is provided if auto allocation is not configured.",
"possible_errors": [
"operations_team_provided_when_using_auto_allocation",
"operations_team_should_be_provided"
]
},
{
"name": "Validate that Kraken can calculate when to start billing the account",
"description": "Validate that Kraken can calculate when to start billing the account. This is determined based on the existence of last billed to date, last statement closing date, and agreements.",
"possible_errors": [
"cannot_determine_responsible_for_billing_from_date"
]
},
{
"name": "Validate that if historical statement transaction are provided then so is a last statement closing date or last billed to date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided in the payload then either a <code>last_statement_closing_date</code> or <code>last_billed_to_date</code> is also provided. If a <code>last_statement_closing_date</code> is not provided then the earliest <code>last_billed_to_date</code> on the account or supply points is used to determine when the last statement should have closed.",
"possible_errors": [
"historical_statement_transactions_without_last_statement_closing_date_or_last_billed_to_date"
]
},
{
"name": "Validate unique transaction IDs",
"description": "Validate that all transaction IDs provided are unique.",
"possible_errors": [
"duplicate_transaction_ids",
"missing_transaction_id"
]
},
{
"name": "Validate current statement transactions are after historical statement transactions",
"description": "Validate that all current statement transactions are dated after all current historical statement transactions.",
"possible_errors": [
"historical_statement_transaction_after_current_statement_transaction"
]
},
{
"name": "Validate that there are no historical statement transactions after the last statement closing date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided then none are later than the <code>last_statement_closing_date</code>. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"historical_statement_transaction_after_last_statement_closing_date"
]
},
{
"name": "Validate that the last statement issue date is on or after the last statement closing date",
"description": "Validate that the <code>last_statement_issue_date</code>, if given, is on or after the <code>last_statement_closing_date</code> given. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"last_statement_issued_before_closing_date"
]
},
{
"name": "Validate no duplicated ledgers are provided",
"description": "Validate no duplicated ledger codes are in `ledgers` section.",
"possible_errors": [
"duplicate_ledger_entries_found"
]
},
{
"name": "Validate identifiers are unique in ledgers",
"description": "Validate identifier is not declared twice in ledgers.",
"possible_errors": [
"duplicate_identifiers_entries_found"
]
},
{
"name": "Validate ledger identifiers are known",
"description": "Validate ledger identifiers are among supply point identifiers.",
"possible_errors": [
"unknown_ledger_identifiers"
]
},
{
"name": "Validate payment adequacy changes or last payment review date not both",
"description": "Validate that only one of <code>payment_adequacy_changes</code> or <code>last_payment_review_date</code> is provided in the payload.",
"possible_errors": [
"payment_adequacy_changes_and_last_payment_review_date_provided"
]
},
{
"name": "Validate that payment plans and payment schedules for the same ledger are not both in payload",
"description": "Validate that if there are payment plans in the payload, there are not also payment schedules on the same ledger because payment plans create a schedule containing all of the planned payments.",
"possible_errors": [
"payment_plan_and_payment_schedule_not_allowed_on_same_ledger"
]
},
{
"name": "Validate no more than one property for unknown occupier",
"description": "Validate that no more than one property is provided for an unknown occupier account.",
"possible_errors": [
"occupier_account_with_multiple_supply_addresses"
]
},
{
"name": "Validate no direct debit reference for the occupier",
"description": "Validate that if any customer is identified as an occupier, then no <code>dd_reference</code> is provided for the account. If a <code>dd_reference</code> is provided, then it implies that there is a known occupier for the account.",
"possible_errors": [
"dd_reference_for_occupier_account"
]
},
{
"name": "Validate no unbilled period on former supply addresses",
"description": "Validate that if a customer is no longer at the given supply address they have been fully billed. This check is performed if we are importing supply address history.",
"possible_errors": [
"unbilled_former_supply_address"
]
},
{
"name": "Validate that agreements cover the last billed to date",
"description": "Validate that there is an agreement covering the last billed to date for each supply point.",
"possible_errors": [
"no_agreement_covering_last_billed_to_date"
]
},
{
"name": "Validate debt and debts",
"description": "Validates that both debt and debts are not specified in the payload.",
"possible_errors": [
"debt_and_debts_are_defined"
]
},
{
"name": "Validate that a last billed to date has been provided correctly",
"description": "Validate that, for each meter, a last billed to date has been provided in the appropriate place. For electricity meters, it must be provided on each of the meter's settlement registers. For gas meters, it must be provided on the meter. This validation does not apply to meters with half-hourly billing, or meters that have been exchanged where the new meter has already been billed. This validation is skipped if the account has not yet been billed and therefore has no historical statement data.",
"possible_errors": [
"last_billed_to_date_not_found"
]
},
{
"name": "Validate that current statement transactions are not before the current statement opening date",
"description": "Validate that all <code>current_statement_transactions</code>, if provided, are not before the current statement opening date. This date is one day after the last statement closing date if provided, otherwise it is based on the last billed to date. Note that any prepay vend transactions are not included in the above check.",
"possible_errors": [
"current_statement_transaction_before_current_statement_opening_date"
]
},
{
"name": "Validate <code>last_statement_balance</code> plus/minus <code>current_statement_transactions</code> equal <code>transfer_balance</code>",
"description": "Validate that the sum of <code>current_statement_transactions</code> plus the <code>last_statement_balance</code> is equal to the <code>transfer_balance</code>. For example, if a <code>last_statement_balance</code> of 100 is provided, and the <code>current_statement_transactions</code> include one payment of 50, then the expected <code>transfer_balance</code> would 150. Transactions that are payments or credits add to the balance. Transactions that are repayments or charges subtract from the balance. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"balance_mismatch_on_transfer_balance"
]
},
{
"name": "Validate that the summed historical statement transactions match the last statement balance",
"description": "Validate that the sum of the <code>historical_statement_transactions</code> equals the <code>last_statement_balance</code>. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"historical_statement_transactions_balance_mismatch"
]
},
{
"name": "Validate next bill due date provided for quarterly billing",
"description": "Validate that if <code>use_industry_billing</code> is false in the account billing options and the <code>period_length</code> is <code>QUARTERLY</code>, then a <code>next_bill_due_date</code> is provided.",
"possible_errors": [
"next_bill_to_date_not_provided_for_quarterly_billing"
]
},
{
"name": "Validate account billing options",
"description": "Validate that account billing options have only been provided for business accounts.",
"possible_errors": [
"account_billing_options_provided_for_domestic_accounts"
]
},
{
"name": "Validate alternative phone number is unique",
"description": "Validate customers defined in the payload do not have the same alternative phone numbers.",
"possible_errors": [
"duplicated_alternative_phone_numbers"
]
},
{
"name": "Validate that prepay transactions target initialised prepay meters",
"description": "Validate that if <code>current_statement_transactions</code> or <code>historical_statement_transactions</code> target a prepay meter (i.e. has the <code>to_prepay_meter_serial_number</code> field), then a prepay meter with that serial number exists in the payload. A prepay meter is identified in the payload by the presence of <code>prepay_details</code>.",
"possible_errors": [
"transactions_target_non_initialised_prepay_meter"
]
},
{
"name": "Validate tax exemption for appropriate account type",
"description": "Validate that the tax exemption is only in place for business accounts.",
"possible_errors": [
"tax_exemptions_provided_for_domestic_account"
]
},
{
"name": "Validate prepay transfer vend read dates match last billed to date",
"description": "Validate that the transfer vend read dates match the last billed to date. This only applies to prepay meters.The last billed to date can be either at the account level or the at the meter/register level. Last billed to dates at the meter/register level take precedent over the account level date if both are provided.",
"possible_errors": [
"prepay_details_on_fully_billed_meter",
"transfer_vend_read_date_must_match_last_billed_to_date"
]
},
{
"name": "Validate that the tariff type and meter point type match",
"description": "Validate that the tariff we have on a given contract matches the meter point type. For example, check eco7 (2-rate) meter points don't have single-rate tariffs or vice versa.",
"possible_errors": [
"tariff_type_does_not_match_meter_point_type"
]
},
{
"name": "Validate bespoke rates",
"description": "Validate that if bespoke rates have been set the account is business.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate billing address provided",
"description": "Validate <code>billing_address1</code> and <code>billing_postcode</code> are provided for non-occupier accounts.",
"possible_errors": [
"billing_address_not_provided"
]
},
{
"name": "Validate current AQ for billable meter point",
"description": "Check that we have a currently valid AQ for a billable MPRN.",
"possible_errors": [
"no_current_or_future_aq_entry_found"
]
},
{
"name": "Validate all billable meter points are covered by agreements in the payload",
"description": "Validate that agreements have been provided for all billable meter points and vice versa for the period covered by Kraken from a billing perspective. A billable meter point is one that has an open-ended or future dated supply end date.",
"possible_errors": [
"meter_point_with_no_agreement",
"meterpoint_with_agreement_not_on_supply"
]
},
{
"name": "Validate transfer readings exist on active gas meters",
"description": "Validate that each active gas meter has a single transfer reading provided.",
"possible_errors": [
"active_gas_meter_with_multiple_transfer_readings",
"active_gas_meter_without_transfer_reading",
"reading_meter_fully_billed"
]
},
{
"name": "Validate EACs provided for active registers",
"description": "Validate that EACs are provided in the <code>eac_history</code> array for each active electricity register. EACs are matched to registers using the <code>tpr</code> field present on both the EAC and register objects.",
"possible_errors": [
"missing_eacs_for_active_register_tpr"
]
},
{
"name": "Validate that prepay meters are matched to agreements of the correct type",
"description": "Validate that each prepay meter has a matching agreement on a prepay tariff, and similarly non-prepay meters on non-prepay tariffs. Note that this validation only applies for active meters and agreements.",
"possible_errors": [
"tariff_type_does_not_match_meter_type"
]
},
{
"name": "Validate each agreement is not effective before the product is available",
"description": "Ensures that the agreement <code>effective_from</code> is not before the datetime the agreement's product is available from. We check this if Kraken will be responsible for billing before the product is available and the product is a variable or tracker product.",
"possible_errors": [
"agreement_effective_from_before_product_available_from"
]
},
{
"name": "Validate that all variable products on a contract have start dates after the product start date",
"description": "Validate that any variable products that are part of a contract only become effective after the product is available.",
"possible_errors": [
"agreement_cannot_start_before_product_available"
]
},
{
"name": "Validate that no meter points are ending supply in the future",
"description": "Ensure that all meters points have either ended supply or are not planned for supply to end.",
"possible_errors": [
"future_supply_end_date"
]
},
{
"name": "Validate that all off supply meter points with meters have a final reading",
"description": "Ensure that all off supply meter points which have meters have a final reading on their end date.",
"possible_errors": [
"no_reading_on_supply_end_date"
]
},
{
"name": "Validate that no billable meter points are starting supply in the future",
"description": "Validate that no billable meter points are set to start supply in the future.",
"possible_errors": [
"future_supply_start_date"
]
},
{
"name": "Validate that all billable meter points have active meters",
"description": "Ensure that all meter points that are billable have active meters or have an unmetered measurement class provided in the payload.",
"possible_errors": [
"meter_point_with_no_meters"
]
},
{
"name": "Validate that at least one of the meter points needs billing",
"description": "Ensure that at least one of the meter points for this account are billable.",
"possible_errors": [
"no_supply_point_on_supply"
]
},
{
"name": "Validate that a domestic account does not have any business only supply points",
"description": "Validate that a domestic account does not have supply points with supply types <code>REGOS_EXPORT_CERTIFICATES</code> or <code>ROCS_EXPORT_CERTIFICATES</code> which are business only supply types.",
"possible_errors": [
"business_supply_type_on_domestic_account"
]
},
{
"name": "Validate business account has account billing options with <code>period_start_day</code> and <code>period_length</code>",
"description": "Validate that business account's <code>account_billing_options</code> include period start day and period length if <code>account_billing_options</code> is being provided. If <code>account_billing_options</code> is not provided then the defaults of 1 for <code>period_start_day</code> and \"MONTHLY\" for <code>period_length</code> will be used.",
"possible_errors": [
"business_account_missing_billing_options"
]
},
{
"name": "Validate that customers provided for business accounts",
"description": "Validate that at least one customer is provided for business accounts. Customers are needed for business accounts to ensure that meter points can be successfully registered for supply.",
"possible_errors": [
"business_account_missing_customers"
]
},
{
"name": "Validate current statement transactions are not before <code>last_billed_to_date</code>",
"description": "Validate that there are no current statement transactions that occurred before the <code>last_billed_to_date</code> (this includes the supply point-level <code>last_billed_to_date</code>, as well as any meter- or register-level dates where applicable).",
"possible_errors": [
"current_statement_transaction_before_last_billed_to_date"
]
},
{
"name": "Validate transfer readings exist on active electricity registers",
"description": "Validate that each active electricity meter register has a single transfer reading provided.",
"possible_errors": [
"missing_transfer_reading_for_register",
"multiple_transfer_readings_for_register"
]
}
]New
[
{
"name": "Validate account type is valid",
"description": "Validate that only one account type is specified in the payload.",
"possible_errors": [
"multiple_account_types_selected"
]
},
{
"name": "Validate billing address fields",
"description": "If a legacy billing address is provided, validate that it is in the correct format.",
"possible_errors": [
"invalid_address"
]
},
{
"name": "Validate customer family name",
"description": "Validate the family name is provided for all customers on a domestic account. For Business accounts, set the family name to 'Business' if it is not provided.",
"possible_errors": [
"customer_family_name_required"
]
},
{
"name": "Validate metadata",
"description": "Validate that metadata, which is a list of key value pairs, does not contain duplicate keys.",
"possible_errors": [
"metadata_has_duplicate_keys"
]
},
{
"name": "Validate managed account type is allowed",
"description": "Validate that this instance of Kraken allows managed account types.",
"possible_errors": [
"managed_accounts_are_not_allowed"
]
},
{
"name": "Validate only portfolio lead has portfolio setting",
"description": "Validates that if portfolio settings are provided, then the account is marked as the portfolio lead.",
"possible_errors": [
"portfolio_settings_included_when_not_lead"
]
},
{
"name": "Validate business type and company number not provided for domestic accounts",
"description": "Validate that neither a business type or company number are provided for domestic accounts.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate no customers for unknown occupier",
"description": "Validate that no customers are provided for an unknown occupier.",
"possible_errors": [
"customer_with_unknown_occupier"
]
},
{
"name": "Validate that a customer given name is provided for business accounts",
"description": "Validate that a given name is provided for all customers on a business account. Note that this validation only applies if Kraken is configured to send registration flows for this import supplier.",
"possible_errors": [
"customer_given_name_required"
]
},
{
"name": "Validate portfolio reference provided correctly",
"description": "Validate that a portfolio reference is provided if portfolio settings have been provided and that a portfolio reference is not provided if the import supplier is set to create new portfolios.",
"possible_errors": [
"portfolio_references_missing",
"portfolio_references_provided"
]
},
{
"name": "Validate billing address style",
"description": "Validate that a legacy billing address (<code>billing_address1</code> etc.) and new-style billing address (<code>billing_address</code> object) are not both provided.",
"possible_errors": [
"billing_address_new_style_and_legacy"
]
},
{
"name": "Validate contracts are consecutive per supply point",
"description": "Validate that the contracts provided in the payload are consecutive per supply point i.e. there are no gaps or overlaps. The exception to this is for contracts provided before the current supply period for the supply point. Contracts provided before the <code>supply_start_date</code> are allowed gaps since they represent historic periods of supply and cannot be used for billing in Kraken.",
"possible_errors": [
"gaps_or_overlaps_in_agreement_dates"
]
},
{
"name": "Validate supply charge line items covered by a single agreement",
"description": "Validate each supply charge has a single agreement with matching product code that covers the period defined by it's line items minimum <code>start_date</code> to maximum <code>end_date</code>.",
"possible_errors": [
"supply_charge_line_items_not_covered_by_single_agreement"
]
},
{
"name": "Validate historical statement period end must not be in the future",
"description": "Ensures that the historical statement period end date (last_statement_closing_date or latest transaction_date) is not set in the future.",
"possible_errors": [
"historical_statement_period_end_in_future"
]
},
{
"name": "Validate that terms with supply type matches a supply point supply type",
"description": "Validate that for terms containing a <code>supply_type</code> field that there is a supply point in the payload with a matching <code>supply_type</code>.",
"possible_errors": [
"term_supply_type_mismatch"
]
},
{
"name": "Validate that supply addresses and supply points are provided if account contracts are provided",
"description": "Validate that if <code>account_contracts</code> have been provided that a supply address with supply points has been provided under <code>supply_addresses</code>",
"possible_errors": [
"account_contracts_without_supply_points"
]
},
{
"name": "Validate historical statement billing document identifier presence",
"description": "Ensure that billing document identifiers are only provided for historical statement transactions and only when the relevant feature flag is enabled.",
"possible_errors": [
"historical_statement_billing_document_identifier_missing",
"historical_statement_billing_document_identifier_not_allowed_when_feature_flag_disabled"
]
},
{
"name": "Validate current statement transactions do not provide <code>billing_document_identifier</code>",
"description": "Validate that none of the current statement transactions include a <code>billing_document_identifier</code>, as this field is only applicable to historical statement transactions.",
"possible_errors": [
"billing_document_identifier_not_allowed_for_current_statement_transactions"
]
},
{
"name": "Validate historical statement transaction billing document identifier",
"description": "Ensure that the billing document identifier is the same for all historical statement transactions.",
"possible_errors": [
"historical_statement_billing_document_identifier_mismatch"
]
},
{
"name": "Validate that contract terms' product codes are part of supply agreements",
"description": "Ensure that any contract terms with product references have corresponding products in supply addresses.",
"possible_errors": [
"contract_term_product_code_not_in_agreements"
]
},
{
"name": "Validate that business is provided if enforcing business contracts",
"description": "Validate that the business field is provided if <code>enforce_business_contracts_exist</code> is set to True on the import supplier configuration.",
"possible_errors": [
"business_field_required"
]
},
{
"name": "Validate that the sum of ledger balances equals the transfer balance",
"description": "Validate that the sum of all <code>ledger_balance</code> provided for each ledger in <code>ledgers</code> equals the account-level <code>transfer_balance</code>.",
"possible_errors": [
"ledger_balances_not_equal_to_transfer_balance"
]
},
{
"name": "Validate business user info against customer info",
"description": "Validates that business user information matches the corresponding customer information for basic fields.",
"possible_errors": [
"customer_details_and_user_details_both_provided"
]
},
{
"name": "Validate payment preference <code>ledger_identifier</code>",
"description": "Ensure that the <code>ledger_identifier</code> provided has an equivalent <code>ledger</code> object with the same <code>ledger_identifier</code> .",
"possible_errors": [
"invalid_payment_preference_ledger_identifier"
]
},
{
"name": "Validate that referenced ledgers are unique in payment preferences",
"description": "Ensure that each ledger is referenced in at most one payment preference.",
"possible_errors": [
"duplicate_ledger_in_payment_preferences"
]
},
{
"name": "Validate that valid instruction_identifier provided for <code>ACTIVE_NEW</code> payment preference",
"description": "Ensure that <code>ACTIVE_NEW</code> payment preference has instruction_identifier from </code>payment_instructions</code> object.",
"possible_errors": [
"active_new_payment_preference_invalid_instruction_identifier"
]
},
{
"name": "Validate that the transactions for a voucher do not exceed its value",
"description": "Validate that the sum of all transaction values for a voucher is not greater than the value of the voucher.",
"possible_errors": [
"voucher_transactions_sum_greater_than_voucher_value"
]
},
{
"name": "Validate that each voucher charge transaction id has a matching transaction id within a transaction of type CHARGE",
"description": "Validate that each <code>voucher</code> <code>charge_transaction_id</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CHARGE in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_charge_transaction_id_not_found"
]
},
{
"name": "Validate that each voucher redemption credit transaction id has a matching transaction id within a transaction of type CREDIT",
"description": "Validate that every <code>credit_transaction_id</code> in all <code>voucher_redemptions</code> in every <code>voucher</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CREDIT in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_redemption_credit_transaction_id_not_found"
]
},
{
"name": "Validate auto allocation of operations team",
"description": "Validate that operations_team_name is provided if auto allocation is not configured.",
"possible_errors": [
"operations_team_provided_when_using_auto_allocation",
"operations_team_should_be_provided"
]
},
{
"name": "Validate that Kraken can calculate when to start billing the account",
"description": "Validate that Kraken can calculate when to start billing the account. This is determined based on the existence of last billed to date, last statement closing date, and agreements.",
"possible_errors": [
"cannot_determine_responsible_for_billing_from_date"
]
},
{
"name": "Validate that if historical statement transaction are provided then so is a last statement closing date or last billed to date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided in the payload then either a <code>last_statement_closing_date</code> or <code>last_billed_to_date</code> is also provided. If a <code>last_statement_closing_date</code> is not provided then the earliest <code>last_billed_to_date</code> on the account or supply points is used to determine when the last statement should have closed.",
"possible_errors": [
"historical_statement_transactions_without_last_statement_closing_date_or_last_billed_to_date"
]
},
{
"name": "Validate unique transaction IDs",
"description": "Validate that all transaction IDs provided are unique.",
"possible_errors": [
"duplicate_transaction_ids",
"missing_transaction_id"
]
},
{
"name": "Validate current statement transactions are after historical statement transactions",
"description": "Validate that all current statement transactions are dated after all current historical statement transactions.",
"possible_errors": [
"historical_statement_transaction_after_current_statement_transaction"
]
},
{
"name": "Validate that there are no historical statement transactions after the last statement closing date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided then none are later than the <code>last_statement_closing_date</code>. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"historical_statement_transaction_after_last_statement_closing_date"
]
},
{
"name": "Validate that the last statement issue date is on or after the last statement closing date",
"description": "Validate that the <code>last_statement_issue_date</code>, if given, is on or after the <code>last_statement_closing_date</code> given. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"last_statement_issued_before_closing_date"
]
},
{
"name": "Validate no duplicated ledgers are provided",
"description": "Validate no duplicated ledger codes are in `ledgers` section.",
"possible_errors": [
"duplicate_ledger_entries_found"
]
},
{
"name": "Validate identifiers are unique in ledgers",
"description": "Validate identifier is not declared twice in ledgers.",
"possible_errors": [
"duplicate_identifiers_entries_found"
]
},
{
"name": "Validate ledger identifiers are known",
"description": "Validate ledger identifiers are among supply point identifiers.",
"possible_errors": [
"unknown_ledger_identifiers"
]
},
{
"name": "Validate payment adequacy changes or last payment review date not both",
"description": "Validate that only one of <code>payment_adequacy_changes</code> or <code>last_payment_review_date</code> is provided in the payload.",
"possible_errors": [
"payment_adequacy_changes_and_last_payment_review_date_provided"
]
},
{
"name": "Validate that payment plans and payment schedules for the same ledger are not both in payload",
"description": "Validate that if there are payment plans in the payload, there are not also payment schedules on the same ledger because payment plans create a schedule containing all of the planned payments.",
"possible_errors": [
"payment_plan_and_payment_schedule_not_allowed_on_same_ledger"
]
},
{
"name": "Validate no more than one property for unknown occupier",
"description": "Validate that no more than one property is provided for an unknown occupier account.",
"possible_errors": [
"occupier_account_with_multiple_supply_addresses"
]
},
{
"name": "Validate no direct debit reference for the occupier",
"description": "Validate that if any customer is identified as an occupier, then no <code>dd_reference</code> is provided for the account. If a <code>dd_reference</code> is provided, then it implies that there is a known occupier for the account.",
"possible_errors": [
"dd_reference_for_occupier_account"
]
},
{
"name": "Validate no unbilled period on former supply addresses",
"description": "Validate that if a customer is no longer at the given supply address they have been fully billed. This check is performed if we are importing supply address history.",
"possible_errors": [
"unbilled_former_supply_address"
]
},
{
"name": "Validate that agreements cover the last billed to date",
"description": "Validate that there is an agreement covering the last billed to date for each supply point.",
"possible_errors": [
"no_agreement_covering_last_billed_to_date"
]
},
{
"name": "Validate debt and debts",
"description": "Validates that both debt and debts are not specified in the payload.",
"possible_errors": [
"debt_and_debts_are_defined"
]
},
{
"name": "Validate that a last billed to date has been provided correctly",
"description": "Validate that, for each meter, a last billed to date has been provided in the appropriate place. For electricity meters, it must be provided on each of the meter's settlement registers. For gas meters, it must be provided on the meter. This validation does not apply to meters with half-hourly billing, or meters that have been exchanged where the new meter has already been billed. This validation is skipped if the account has not yet been billed and therefore has no historical statement data.",
"possible_errors": [
"last_billed_to_date_not_found"
]
},
{
"name": "Validate that current statement transactions are not before the current statement opening date",
"description": "Validate that all <code>current_statement_transactions</code>, if provided, are not before the current statement opening date. This date is one day after the last statement closing date if provided, otherwise it is based on the last billed to date. Note that any prepay vend transactions are not included in the above check.",
"possible_errors": [
"current_statement_transaction_before_current_statement_opening_date"
]
},
{
"name": "Validate <code>last_statement_balance</code> plus/minus <code>current_statement_transactions</code> equal <code>transfer_balance</code>",
"description": "Validate that the sum of <code>current_statement_transactions</code> plus the <code>last_statement_balance</code> is equal to the <code>transfer_balance</code>. For example, if a <code>last_statement_balance</code> of 100 is provided, and the <code>current_statement_transactions</code> include one payment of 50, then the expected <code>transfer_balance</code> would 150. Transactions that are payments or credits add to the balance. Transactions that are repayments or charges subtract from the balance. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"balance_mismatch_on_transfer_balance"
]
},
{
"name": "Validate that the summed historical statement transactions match the last statement balance",
"description": "Validate that the sum of the <code>historical_statement_transactions</code> equals the <code>last_statement_balance</code>. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"historical_statement_transactions_balance_mismatch"
]
},
{
"name": "Validate next bill due date provided for quarterly billing",
"description": "Validate that if <code>use_industry_billing</code> is false in the account billing options and the <code>period_length</code> is <code>QUARTERLY</code>, then a <code>next_bill_due_date</code> is provided.",
"possible_errors": [
"next_bill_to_date_not_provided_for_quarterly_billing"
]
},
{
"name": "Validate account billing options",
"description": "Validate that account billing options have only been provided for business accounts.",
"possible_errors": [
"account_billing_options_provided_for_domestic_accounts"
]
},
{
"name": "Validate alternative phone number is unique",
"description": "Validate customers defined in the payload do not have the same alternative phone numbers.",
"possible_errors": [
"duplicated_alternative_phone_numbers"
]
},
{
"name": "Validate that prepay transactions target initialised prepay meters",
"description": "Validate that if <code>current_statement_transactions</code> or <code>historical_statement_transactions</code> target a prepay meter (i.e. has the <code>to_prepay_meter_serial_number</code> field), then a prepay meter with that serial number exists in the payload. A prepay meter is identified in the payload by the presence of <code>prepay_details</code>.",
"possible_errors": [
"transactions_target_non_initialised_prepay_meter"
]
},
{
"name": "Validate tax exemption for appropriate account type",
"description": "Validate that the tax exemption is only in place for business accounts.",
"possible_errors": [
"tax_exemptions_provided_for_domestic_account"
]
},
{
"name": "Validate prepay transfer vend read dates match last billed to date",
"description": "Validate that the transfer vend read dates match the last billed to date. This only applies to prepay meters.The last billed to date can be either at the account level or the at the meter/register level. Last billed to dates at the meter/register level take precedent over the account level date if both are provided.",
"possible_errors": [
"prepay_details_on_fully_billed_meter",
"transfer_vend_read_date_must_match_last_billed_to_date"
]
},
{
"name": "Validate that the tariff type and meter point type match",
"description": "Validate that the tariff we have on a given contract matches the meter point type. For example, check eco7 (2-rate) meter points don't have single-rate tariffs or vice versa.",
"possible_errors": [
"tariff_type_does_not_match_meter_point_type"
]
},
{
"name": "Validate bespoke rates",
"description": "Validate that if bespoke rates have been set the account is business.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate billing address provided",
"description": "Validate <code>billing_address1</code> and <code>billing_postcode</code> are provided for non-occupier accounts.",
"possible_errors": [
"billing_address_not_provided"
]
},
{
"name": "Validate current AQ for billable meter point",
"description": "Check that we have a currently valid AQ for a billable MPRN.",
"possible_errors": [
"no_current_or_future_aq_entry_found"
]
},
{
"name": "Validate all billable meter points are covered by agreements in the payload",
"description": "Validate that agreements have been provided for all billable meter points and vice versa for the period covered by Kraken from a billing perspective. A billable meter point is one that has an open-ended or future dated supply end date.",
"possible_errors": [
"meter_point_with_no_agreement",
"meterpoint_with_agreement_not_on_supply"
]
},
{
"name": "Validate transfer readings exist on active gas meters",
"description": "Validate that each active gas meter has a single transfer reading provided.",
"possible_errors": [
"active_gas_meter_with_multiple_transfer_readings",
"active_gas_meter_without_transfer_reading",
"reading_meter_fully_billed"
]
},
{
"name": "Validate EACs provided for active registers",
"description": "Validate that EACs are provided in the <code>eac_history</code> array for each active electricity register. EACs are matched to registers using the <code>tpr</code> field present on both the EAC and register objects.",
"possible_errors": [
"missing_eacs_for_active_register_tpr"
]
},
{
"name": "Validate that prepay meters are matched to agreements of the correct type",
"description": "Validate that each prepay meter has a matching agreement on a prepay tariff, and similarly non-prepay meters on non-prepay tariffs. Note that this validation only applies for active meters and agreements.",
"possible_errors": [
"tariff_type_does_not_match_meter_type"
]
},
{
"name": "Validate each agreement is not effective before the product is available",
"description": "Ensures that the agreement <code>effective_from</code> is not before the datetime the agreement's product is available from. We check this if Kraken will be responsible for billing before the product is available and the product is a variable or tracker product.",
"possible_errors": [
"agreement_effective_from_before_product_available_from"
]
},
{
"name": "Validate that all variable products on a contract have start dates after the product start date",
"description": "Validate that any variable products that are part of a contract only become effective after the product is available.",
"possible_errors": [
"agreement_cannot_start_before_product_available"
]
},
{
"name": "Validate that no meter points are ending supply in the future",
"description": "Ensure that all meters points have either ended supply or are not planned for supply to end.",
"possible_errors": [
"future_supply_end_date"
]
},
{
"name": "Validate that all off supply meter points with meters have a final reading",
"description": "Ensure that all off supply meter points which have meters have a final reading on their end date.",
"possible_errors": [
"no_reading_on_supply_end_date"
]
},
{
"name": "Validate that no billable meter points are starting supply in the future",
"description": "Validate that no billable meter points are set to start supply in the future.",
"possible_errors": [
"future_supply_start_date"
]
},
{
"name": "Validate that all billable meter points have active meters",
"description": "Ensure that all meter points that are billable have active meters or have an unmetered measurement class provided in the payload.",
"possible_errors": [
"meter_point_with_no_meters"
]
},
{
"name": "Validate that at least one of the meter points needs billing",
"description": "Ensure that at least one of the meter points for this account are billable.",
"possible_errors": [
"no_supply_point_on_supply"
]
},
{
"name": "Validate that a domestic account does not have any business only supply points",
"description": "Validate that a domestic account does not have supply points with supply types <code>REGOS_EXPORT_CERTIFICATES</code> or <code>ROCS_EXPORT_CERTIFICATES</code> which are business only supply types.",
"possible_errors": [
"business_supply_type_on_domestic_account"
]
},
{
"name": "Validate business account has account billing options with <code>period_start_day</code> and <code>period_length</code>",
"description": "Validate that business account's <code>account_billing_options</code> include period start day and period length if <code>account_billing_options</code> is being provided. If <code>account_billing_options</code> is not provided then the defaults of 1 for <code>period_start_day</code> and \"MONTHLY\" for <code>period_length</code> will be used.",
"possible_errors": [
"business_account_missing_billing_options"
]
},
{
"name": "Validate that customers provided for business accounts",
"description": "Validate that at least one customer is provided for business accounts. Customers are needed for business accounts to ensure that meter points can be successfully registered for supply.",
"possible_errors": [
"business_account_missing_customers"
]
},
{
"name": "Validate current statement transactions are not before <code>last_billed_to_date</code>",
"description": "Validate that there are no current statement transactions that occurred before the <code>last_billed_to_date</code> (this includes the supply point-level <code>last_billed_to_date</code>, as well as any meter- or register-level dates where applicable).",
"possible_errors": [
"current_statement_transaction_before_last_billed_to_date"
]
},
{
"name": "Validate transfer readings exist on active electricity registers",
"description": "Validate that each active electricity meter register has a single transfer reading provided.",
"possible_errors": [
"missing_transfer_reading_for_register",
"multiple_transfer_readings_for_register"
]
}
]Old
[
{
"name": "Validate account type is valid",
"description": "Validate that only one account type is specified in the payload.",
"possible_errors": [
"multiple_account_types_selected"
]
},
{
"name": "Validate billing address fields",
"description": "If a legacy billing address is provided, validate that it is in the correct format.",
"possible_errors": [
"invalid_address"
]
},
{
"name": "Validate customer family name",
"description": "Validate the family name is provided for all customers on a domestic account. For Business accounts, set the family name to 'Business' if it is not provided.",
"possible_errors": [
"customer_family_name_required"
]
},
{
"name": "Validate metadata",
"description": "Validate that metadata, which is a list of key value pairs, does not contain duplicate keys.",
"possible_errors": [
"metadata_has_duplicate_keys"
]
},
{
"name": "Validate managed account type is allowed",
"description": "Validate that this instance of Kraken allows managed account types.",
"possible_errors": [
"managed_accounts_are_not_allowed"
]
},
{
"name": "Validate only portfolio lead has portfolio setting",
"description": "Validates that if portfolio settings are provided, then the account is marked as the portfolio lead.",
"possible_errors": [
"portfolio_settings_included_when_not_lead"
]
},
{
"name": "Validate business type and company number not provided for domestic accounts",
"description": "Validate that neither a business type or company number are provided for domestic accounts.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate no customers for unknown occupier",
"description": "Validate that no customers are provided for an unknown occupier.",
"possible_errors": [
"customer_with_unknown_occupier"
]
},
{
"name": "Validate that a customer given name is provided for business accounts",
"description": "Validate that a given name is provided for all customers on a business account. Note that this validation only applies if Kraken is configured to send registration flows for this import supplier.",
"possible_errors": [
"customer_given_name_required"
]
},
{
"name": "Validate portfolio reference provided correctly",
"description": "Validate that a portfolio reference is provided if portfolio settings have been provided and that a portfolio reference is not provided if the import supplier is set to create new portfolios.",
"possible_errors": [
"portfolio_references_missing",
"portfolio_references_provided"
]
},
{
"name": "Validate billing address style",
"description": "Validate that a legacy billing address (<code>billing_address1</code> etc.) and new-style billing address (<code>billing_address</code> object) are not both provided.",
"possible_errors": [
"billing_address_new_style_and_legacy"
]
},
{
"name": "Validate contracts are consecutive per supply point",
"description": "Validate that the contracts provided in the payload are consecutive per supply point i.e. there are no gaps or overlaps. The exception to this is for contracts provided before the current supply period for the supply point. Contracts provided before the <code>supply_start_date</code> are allowed gaps since they represent historic periods of supply and cannot be used for billing in Kraken.",
"possible_errors": [
"gaps_or_overlaps_in_agreement_dates"
]
},
{
"name": "Validate supply charge line items covered by a single agreement",
"description": "Validate each supply charge has a single agreement with matching product code that covers the period defined by it's line items minimum <code>start_date</code> to maximum <code>end_date</code>.",
"possible_errors": [
"supply_charge_line_items_not_covered_by_single_agreement"
]
},
{
"name": "Validate historical statement period end must not be in the future",
"description": "Ensures that the historical statement period end date (last_statement_closing_date or latest transaction_date) is not set in the future.",
"possible_errors": [
"historical_statement_period_end_in_future"
]
},
{
"name": "Validate that terms with supply type matches a supply point supply type",
"description": "Validate that for terms containing a <code>supply_type</code> field that there is a supply point in the payload with a matching <code>supply_type</code>.",
"possible_errors": [
"term_supply_type_mismatch"
]
},
{
"name": "Validate that supply addresses and supply points are provided if account contracts are provided",
"description": "Validate that if <code>account_contracts</code> have been provided that a supply address with supply points has been provided under <code>supply_addresses</code>",
"possible_errors": [
"account_contracts_without_supply_points"
]
},
{
"name": "Validate historical statement billing document identifier presence",
"description": "Ensure that billing document identifiers are only provided for historical statement transactions and only when the relevant feature flag is enabled.",
"possible_errors": [
"historical_statement_billing_document_identifier_missing",
"historical_statement_billing_document_identifier_not_allowed_when_feature_flag_disabled"
]
},
{
"name": "Validate current statement transactions do not provide <code>billing_document_identifier</code>",
"description": "Validate that none of the current statement transactions include a <code>billing_document_identifier</code>, as this field is only applicable to historical statement transactions.",
"possible_errors": [
"billing_document_identifier_not_allowed_for_current_statement_transactions"
]
},
{
"name": "Validate historical statement transaction billing document identifier",
"description": "Ensure that the billing document identifier is the same for all historical statement transactions.",
"possible_errors": [
"historical_statement_billing_document_identifier_mismatch"
]
},
{
"name": "Validate that contract terms' product codes are part of supply agreements",
"description": "Ensure that any contract terms with product references have corresponding products in supply addresses.",
"possible_errors": [
"contract_term_product_code_not_in_agreements"
]
},
{
"name": "Validate that business is provided if enforcing business contracts",
"description": "Validate that the business field is provided if <code>enforce_business_contracts_exist</code> is set to True on the import supplier configuration.",
"possible_errors": [
"business_field_required"
]
},
{
"name": "Validate that the sum of ledger balances equals the transfer balance",
"description": "Validate that the sum of all <code>ledger_balance</code> provided for each ledger in <code>ledgers</code> equals the account-level <code>transfer_balance</code>.",
"possible_errors": [
"ledger_balances_not_equal_to_transfer_balance"
]
},
{
"name": "Validate business user info against customer info",
"description": "Validates that business user information matches the corresponding customer information for basic fields.",
"possible_errors": [
"customer_details_and_user_details_both_provided"
]
},
{
"name": "Validate payment preference <code>ledger_identifier</code>",
"description": "Ensure that the <code>ledger_identifier</code> provided has an equivalent <code>ledger</code> object with the same <code>ledger_identifier</code> .",
"possible_errors": [
"invalid_payment_preference_ledger_identifier"
]
},
{
"name": "Validate that referenced ledgers are unique in payment preferences",
"description": "Ensure that each ledger is referenced in at most one payment preference.",
"possible_errors": [
"duplicate_ledger_in_payment_preferences"
]
},
{
"name": "Validate that valid instruction_identifier provided for <code>ACTIVE_NEW</code> payment preference",
"description": "Ensure that <code>ACTIVE_NEW</code> payment preference has instruction_identifier from </code>payment_instructions</code> object.",
"possible_errors": [
"active_new_payment_preference_invalid_instruction_identifier"
]
},
{
"name": "Validate that the transactions for a voucher do not exceed its value",
"description": "Validate that the sum of all transaction values for a voucher is not greater than the value of the voucher.",
"possible_errors": [
"voucher_transactions_sum_greater_than_voucher_value"
]
},
{
"name": "Validate that each voucher charge transaction id has a matching transaction id within a transaction of type CHARGE",
"description": "Validate that each <code>voucher</code> <code>charge_transaction_id</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CHARGE in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_charge_transaction_id_not_found"
]
},
{
"name": "Validate that each voucher redemption credit transaction id has a matching transaction id within a transaction of type CREDIT",
"description": "Validate that every <code>credit_transaction_id</code> in all <code>voucher_redemptions</code> in every <code>voucher</code> has a matching <code>transaction_id</code> within a transaction of <code>type</code> CREDIT in <code>current_statement_transactions</code>, <code>historical_statement_transactions</code> or <code>historical_billing_documents</code>.",
"possible_errors": [
"voucher_redemption_credit_transaction_id_not_found"
]
},
{
"name": "Validate auto allocation of operations team",
"description": "Validate that operations_team_name is provided if auto allocation is not configured.",
"possible_errors": [
"operations_team_provided_when_using_auto_allocation",
"operations_team_should_be_provided"
]
},
{
"name": "Validate that Kraken can calculate when to start billing the account",
"description": "Validate that Kraken can calculate when to start billing the account. This is determined based on the existence of last billed to date, last statement closing date, and agreements.",
"possible_errors": [
"cannot_determine_responsible_for_billing_from_date"
]
},
{
"name": "Validate all contracts have supply points",
"description": "Validates that contracts provided in the payload have a corresponding supply point.",
"possible_errors": [
"agreement_has_no_matching_meter_point"
]
},
{
"name": "Validate that if historical statement transaction are provided then so is a last statement closing date or last billed to date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided in the payload then either a <code>last_statement_closing_date</code> or <code>last_billed_to_date</code> is also provided. If a <code>last_statement_closing_date</code> is not provided then the earliest <code>last_billed_to_date</code> on the account or supply points is used to determine when the last statement should have closed.",
"possible_errors": [
"historical_statement_transactions_without_last_statement_closing_date_or_last_billed_to_date"
]
},
{
"name": "Validate unique transaction IDs",
"description": "Validate that all transaction IDs provided are unique.",
"possible_errors": [
"duplicate_transaction_ids",
"missing_transaction_id"
]
},
{
"name": "Validate current statement transactions are after historical statement transactions",
"description": "Validate that all current statement transactions are dated after all current historical statement transactions.",
"possible_errors": [
"historical_statement_transaction_after_current_statement_transaction"
]
},
{
"name": "Validate that there are no historical statement transactions after the last statement closing date",
"description": "Validate that if <code>historical_statement_transactions</code> are provided then none are later than the <code>last_statement_closing_date</code>. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"historical_statement_transaction_after_last_statement_closing_date"
]
},
{
"name": "Validate that the last statement issue date is on or after the last statement closing date",
"description": "Validate that the <code>last_statement_issue_date</code>, if given, is on or after the <code>last_statement_closing_date</code> given. If a <code>last_statement_closing_date</code> is not provided then this is inferred from the earliest <code>last_billed_to_date</code> on the account or supply points.",
"possible_errors": [
"last_statement_issued_before_closing_date"
]
},
{
"name": "Validate no duplicated ledgers are provided",
"description": "Validate no duplicated ledger codes are in `ledgers` section.",
"possible_errors": [
"duplicate_ledger_entries_found"
]
},
{
"name": "Validate identifiers are unique in ledgers",
"description": "Validate identifier is not declared twice in ledgers.",
"possible_errors": [
"duplicate_identifiers_entries_found"
]
},
{
"name": "Validate ledger identifiers are known",
"description": "Validate ledger identifiers are among supply point identifiers.",
"possible_errors": [
"unknown_ledger_identifiers"
]
},
{
"name": "Validate payment adequacy changes or last payment review date not both",
"description": "Validate that only one of <code>payment_adequacy_changes</code> or <code>last_payment_review_date</code> is provided in the payload.",
"possible_errors": [
"payment_adequacy_changes_and_last_payment_review_date_provided"
]
},
{
"name": "Validate that payment plans and payment schedules for the same ledger are not both in payload",
"description": "Validate that if there are payment plans in the payload, there are not also payment schedules on the same ledger because payment plans create a schedule containing all of the planned payments.",
"possible_errors": [
"payment_plan_and_payment_schedule_not_allowed_on_same_ledger"
]
},
{
"name": "Validate no more than one property for unknown occupier",
"description": "Validate that no more than one property is provided for an unknown occupier account.",
"possible_errors": [
"occupier_account_with_multiple_supply_addresses"
]
},
{
"name": "Validate no direct debit reference for the occupier",
"description": "Validate that if any customer is identified as an occupier, then no <code>dd_reference</code> is provided for the account. If a <code>dd_reference</code> is provided, then it implies that there is a known occupier for the account.",
"possible_errors": [
"dd_reference_for_occupier_account"
]
},
{
"name": "Validate no unbilled period on former supply addresses",
"description": "Validate that if a customer is no longer at the given supply address they have been fully billed. This check is performed if we are importing supply address history.",
"possible_errors": [
"unbilled_former_supply_address"
]
},
{
"name": "Validate that agreements cover the last billed to date",
"description": "Validate that there is an agreement covering the last billed to date for each supply point.",
"possible_errors": [
"no_agreement_covering_last_billed_to_date"
]
},
{
"name": "Validate debt and debts",
"description": "Validates that both debt and debts are not specified in the payload.",
"possible_errors": [
"debt_and_debts_are_defined"
]
},
{
"name": "Validate that a last billed to date has been provided correctly",
"description": "Validate that, for each meter, a last billed to date has been provided in the appropriate place. For electricity meters, it must be provided on each of the meter's settlement registers. For gas meters, it must be provided on the meter. This validation does not apply to meters with half-hourly billing, or meters that have been exchanged where the new meter has already been billed. This validation is skipped if the account has not yet been billed and therefore has no historical statement data.",
"possible_errors": [
"last_billed_to_date_not_found"
]
},
{
"name": "Validate that current statement transactions are not before the current statement opening date",
"description": "Validate that all <code>current_statement_transactions</code>, if provided, are not before the current statement opening date. This date is one day after the last statement closing date if provided, otherwise it is based on the last billed to date. Note that any prepay vend transactions are not included in the above check.",
"possible_errors": [
"current_statement_transaction_before_current_statement_opening_date"
]
},
{
"name": "Validate <code>last_statement_balance</code> plus/minus <code>current_statement_transactions</code> equal <code>transfer_balance</code>",
"description": "Validate that the sum of <code>current_statement_transactions</code> plus the <code>last_statement_balance</code> is equal to the <code>transfer_balance</code>. For example, if a <code>last_statement_balance</code> of 100 is provided, and the <code>current_statement_transactions</code> include one payment of 50, then the expected <code>transfer_balance</code> would 150. Transactions that are payments or credits add to the balance. Transactions that are repayments or charges subtract from the balance. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"balance_mismatch_on_transfer_balance"
]
},
{
"name": "Validate that the summed historical statement transactions match the last statement balance",
"description": "Validate that the sum of the <code>historical_statement_transactions</code> equals the <code>last_statement_balance</code>. Prepay transactions (those with the <code>to_prepay_meter_serial_number</code> field on the transaction) are filtered out as these are treated separately during account creation.",
"possible_errors": [
"historical_statement_transactions_balance_mismatch"
]
},
{
"name": "Validate next bill due date provided for quarterly billing",
"description": "Validate that if <code>use_industry_billing</code> is false in the account billing options and the <code>period_length</code> is <code>QUARTERLY</code>, then a <code>next_bill_due_date</code> is provided.",
"possible_errors": [
"next_bill_to_date_not_provided_for_quarterly_billing"
]
},
{
"name": "Validate account billing options",
"description": "Validate that account billing options have only been provided for business accounts.",
"possible_errors": [
"account_billing_options_provided_for_domestic_accounts"
]
},
{
"name": "Validate alternative phone number is unique",
"description": "Validate customers defined in the payload do not have the same alternative phone numbers.",
"possible_errors": [
"duplicated_alternative_phone_numbers"
]
},
{
"name": "Validate that prepay transactions target initialised prepay meters",
"description": "Validate that if <code>current_statement_transactions</code> or <code>historical_statement_transactions</code> target a prepay meter (i.e. has the <code>to_prepay_meter_serial_number</code> field), then a prepay meter with that serial number exists in the payload. A prepay meter is identified in the payload by the presence of <code>prepay_details</code>.",
"possible_errors": [
"transactions_target_non_initialised_prepay_meter"
]
},
{
"name": "Validate tax exemption for appropriate account type",
"description": "Validate that the tax exemption is only in place for business accounts.",
"possible_errors": [
"tax_exemptions_provided_for_domestic_account"
]
},
{
"name": "Validate prepay transfer vend read dates match last billed to date",
"description": "Validate that the transfer vend read dates match the last billed to date. This only applies to prepay meters.The last billed to date can be either at the account level or the at the meter/register level. Last billed to dates at the meter/register level take precedent over the account level date if both are provided.",
"possible_errors": [
"prepay_details_on_fully_billed_meter",
"transfer_vend_read_date_must_match_last_billed_to_date"
]
},
{
"name": "Validate that the tariff type and meter point type match",
"description": "Validate that the tariff we have on a given contract matches the meter point type. For example, check eco7 (2-rate) meter points don't have single-rate tariffs or vice versa.",
"possible_errors": [
"tariff_type_does_not_match_meter_point_type"
]
},
{
"name": "Validate bespoke rates",
"description": "Validate that if bespoke rates have been set the account is business.",
"possible_errors": [
"business_fields_provided_for_domestic_accounts"
]
},
{
"name": "Validate billing address provided",
"description": "Validate <code>billing_address1</code> and <code>billing_postcode</code> are provided for non-occupier accounts.",
"possible_errors": [
"billing_address_not_provided"
]
},
{
"name": "Validate current AQ for billable meter point",
"description": "Check that we have a currently valid AQ for a billable MPRN.",
"possible_errors": [
"no_current_or_future_aq_entry_found"
]
},
{
"name": "Validate all billable meter points are covered by agreements in the payload",
"description": "Validate that agreements have been provided for all billable meter points and vice versa for the period covered by Kraken from a billing perspective. A billable meter point is one that has an open-ended or future dated supply end date.",
"possible_errors": [
"meter_point_with_no_agreement",
"meterpoint_with_agreement_not_on_supply"
]
},
{
"name": "Validate transfer readings exist on active gas meters",
"description": "Validate that each active gas meter has a single transfer reading provided.",
"possible_errors": [
"active_gas_meter_with_multiple_transfer_readings",
"active_gas_meter_without_transfer_reading",
"reading_meter_fully_billed"
]
},
{
"name": "Validate EACs provided for active registers",
"description": "Validate that EACs are provided in the <code>eac_history</code> array for each active electricity register. EACs are matched to registers using the <code>tpr</code> field present on both the EAC and register objects.",
"possible_errors": [
"missing_eacs_for_active_register_tpr"
]
},
{
"name": "Validate that prepay meters are matched to agreements of the correct type",
"description": "Validate that each prepay meter has a matching agreement on a prepay tariff, and similarly non-prepay meters on non-prepay tariffs. Note that this validation only applies for active meters and agreements.",
"possible_errors": [
"tariff_type_does_not_match_meter_type"
]
},
{
"name": "Validate each agreement is not effective before the product is available",
"description": "Ensures that the agreement <code>effective_from</code> is not before the datetime the agreement's product is available from. We check this if Kraken will be responsible for billing before the product is available and the product is a variable or tracker product.",
"possible_errors": [
"agreement_effective_from_before_product_available_from"
]
},
{
"name": "Validate that all variable products on a contract have start dates after the product start date",
"description": "Validate that any variable products that are part of a contract only become effective after the product is available.",
"possible_errors": [
"agreement_cannot_start_before_product_available"
]
},
{
"name": "Validate that no meter points are ending supply in the future",
"description": "Ensure that all meters points have either ended supply or are not planned for supply to end.",
"possible_errors": [
"future_supply_end_date"
]
},
{
"name": "Validate that all off supply meter points with meters have a final reading",
"description": "Ensure that all off supply meter points which have meters have a final reading on their end date.",
"possible_errors": [
"no_reading_on_supply_end_date"
]
},
{
"name": "Validate that no billable meter points are starting supply in the future",
"description": "Validate that no billable meter points are set to start supply in the future.",
"possible_errors": [
"future_supply_start_date"
]
},
{
"name": "Validate that all billable meter points have active meters",
"description": "Ensure that all meter points that are billable have active meters or have an unmetered measurement class provided in the payload.",
"possible_errors": [
"meter_point_with_no_meters"
]
},
{
"name": "Validate that at least one of the meter points needs billing",
"description": "Ensure that at least one of the meter points for this account are billable.",
"possible_errors": [
"no_supply_point_on_supply"
]
},
{
"name": "Validate that a domestic account does not have any business only supply points",
"description": "Validate that a domestic account does not have supply points with supply types <code>REGOS_EXPORT_CERTIFICATES</code> or <code>ROCS_EXPORT_CERTIFICATES</code> which are business only supply types.",
"possible_errors": [
"business_supply_type_on_domestic_account"
]
},
{
"name": "Validate business account has account billing options with <code>period_start_day</code> and <code>period_length</code>",
"description": "Validate that business account's <code>account_billing_options</code> include period start day and period length if <code>account_billing_options</code> is being provided. If <code>account_billing_options</code> is not provided then the defaults of 1 for <code>period_start_day</code> and \"MONTHLY\" for <code>period_length</code> will be used.",
"possible_errors": [
"business_account_missing_billing_options"
]
},
{
"name": "Validate that customers provided for business accounts",
"description": "Validate that at least one customer is provided for business accounts. Customers are needed for business accounts to ensure that meter points can be successfully registered for supply.",
"possible_errors": [
"business_account_missing_customers"
]
},
{
"name": "Validate current statement transactions are not before <code>last_billed_to_date</code>",
"description": "Validate that there are no current statement transactions that occurred before the <code>last_billed_to_date</code> (this includes the supply point-level <code>last_billed_to_date</code>, as well as any meter- or register-level dates where applicable).",
"possible_errors": [
"current_statement_transaction_before_last_billed_to_date"
]
},
{
"name": "Validate transfer readings exist on active electricity registers",
"description": "Validate that each active electricity meter register has a single transfer reading provided.",
"possible_errors": [
"missing_transfer_reading_for_register",
"multiple_transfer_readings_for_register"
]
}
]New
{
"x-enum-descriptions": {
"appointment_cancellation": "Appointment Cancellation"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Appointment Cancellation": "Appointment Cancellation"
}
}Old
{
"x-enum-descriptions": {}
}