Data Import REST API Changelog
This page shows recent changes to Data Import REST API.
13 April 2026 - Latest
New
{
"x-enum-descriptions": {
"DIRECTA__TELESALES__OUTBOUND_MIXTO__LATAM_M": "DIRECTA__TELESALES__OUTBOUND_MIXTO__LATAM_M"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"DIRECTA__TELESALES__OUTBOUND_MIXTO__LATAM_M": "DIRECTA -> TELESALES -> OUTBOUND MIXTO -> LATAM M"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"DIRECTA__TELESALES__OUTBOUND_MIXTO__LATAM_M": "DIRECTA -> TELESALES -> OUTBOUND MIXTO -> LATAM M"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"natural_disaster": "Natural Disaster"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Natural Disaster": "Natural Disaster"
}
}Old
{
"x-enum-descriptions": {}
}10 April 2026
New
{
"x-enum-descriptions": {
"DIRECTA__PLENITUDE__ENERGY_SPECIALIST__SANTANDER": "DIRECTA__PLENITUDE__ENERGY_SPECIALIST__SANTANDER"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"DIRECTA__PLENITUDE__ENERGY_SPECIALIST__SANTANDER": "DIRECTA -> PLENITUDE -> ENERGY SPECIALIST -> SANTANDER"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"DIRECTA__PLENITUDE__ENERGY_SPECIALIST__SANTANDER": "DIRECTA -> PLENITUDE -> ENERGY SPECIALIST -> SANTANDER"
}
}Old
{
"x-enum-descriptions": {}
}9 April 2026
New
{
"x-enum-descriptions": {
"POLE": "Pole",
"LIGHT": "Light"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"POLE": "Pole",
"LIGHT": "Light"
}
}Old
{
"x-enum-descriptions": {}
}
No attributes to display
No attributes to display
New
[
{
"name": "Validate <code>\u2068supply_end_date\u2069</code> not before <code>\u2068supply_start_date\u2069</code>",
"description": "Validates that <code>\u2068supply_end_date\u2069</code>, if given, is on or later than <code>\u2068supply_start_date\u2069</code>.",
"possible_errors": [
"start_date_later_than_end_date"
]
},
{
"name": "Requested supply start date has COS gain processing window",
"description": "Ensures that the COS_GAIN_PROCESSING_WINDOW application setting is configured when a requested_supply_start_date is provided.",
"possible_errors": [
"cos_gain_processing_window_not_configured"
]
},
{
"name": "Validate agreements do not start before supply start date",
"description": "Validate that agreements do not start before the supply point's supply start date, if provided.",
"possible_errors": [
"agreement_start_date_before_supply_start_date"
]
},
{
"name": "Validate that exactly one active agreement is provided",
"description": "Validate that exactly one active agreement is provided for the supply point if it is already on supply. If the <code>supply_start_date</code> is in the future or the <code>supply_end_date</code> is in the past then we do not check for an active agreement.",
"possible_errors": [
"exactly_one_active_agreement_required"
]
},
{
"name": "Validate that a future agreement provided if supply start date is in the future",
"description": "Validate that exactly one future agreement is provided if the supply start date is in the future. This future agreement must start on the supply start date.",
"possible_errors": [
"future_agreement_required"
]
},
{
"name": "Validate that the supply point does not exist in Kraken",
"description": "Validate that if a supply point has be provided with agreements in the payload, that the supply point does not already exist in Kraken.",
"possible_errors": [
"supply_point_already_exists"
]
}
]Old
[
{
"name": "Validate <code>\u2068supply_end_date\u2069</code> not before <code>\u2068supply_start_date\u2069</code>",
"description": "Validates that <code>\u2068supply_end_date\u2069</code>, if given, is on or later than <code>\u2068supply_start_date\u2069</code>.",
"possible_errors": [
"start_date_later_than_end_date"
]
},
{
"name": "Validate agreements do not start before supply start date",
"description": "Validate that agreements do not start before the supply point's supply start date, if provided.",
"possible_errors": [
"agreement_start_date_before_supply_start_date"
]
},
{
"name": "Validate that exactly one active agreement is provided",
"description": "Validate that exactly one active agreement is provided for the supply point if it is already on supply. If the <code>supply_start_date</code> is in the future or the <code>supply_end_date</code> is in the past then we do not check for an active agreement.",
"possible_errors": [
"exactly_one_active_agreement_required"
]
},
{
"name": "Validate that a future agreement provided if supply start date is in the future",
"description": "Validate that exactly one future agreement is provided if the supply start date is in the future. This future agreement must start on the supply start date.",
"possible_errors": [
"future_agreement_required"
]
},
{
"name": "Validate that the supply point does not exist in Kraken",
"description": "Validate that if a supply point has be provided with agreements in the payload, that the supply point does not already exist in Kraken.",
"possible_errors": [
"supply_point_already_exists"
]
}
]
No attributes to display
New
[
{
"name": "Validate <code>\u2068supply_end_date\u2069</code> not before <code>\u2068supply_start_date\u2069</code>",
"description": "Validates that <code>\u2068supply_end_date\u2069</code>, if given, is on or later than <code>\u2068supply_start_date\u2069</code>.",
"possible_errors": [
"start_date_later_than_end_date"
]
},
{
"name": "Requested supply start date has COS gain processing window",
"description": "Ensures that the COS_GAIN_PROCESSING_WINDOW application setting is configured when a requested_supply_start_date is provided.",
"possible_errors": [
"cos_gain_processing_window_not_configured"
]
},
{
"name": "Validate agreements do not start before supply start date",
"description": "Validate that agreements do not start before the supply point's supply start date, if provided.",
"possible_errors": [
"agreement_start_date_before_supply_start_date"
]
},
{
"name": "Validate that exactly one active agreement is provided",
"description": "Validate that exactly one active agreement is provided for the supply point if it is already on supply. If the <code>supply_start_date</code> is in the future or the <code>supply_end_date</code> is in the past then we do not check for an active agreement.",
"possible_errors": [
"exactly_one_active_agreement_required"
]
},
{
"name": "Validate that a future agreement provided if supply start date is in the future",
"description": "Validate that exactly one future agreement is provided if the supply start date is in the future. This future agreement must start on the supply start date.",
"possible_errors": [
"future_agreement_required"
]
},
{
"name": "Validate that the supply point does not exist in Kraken",
"description": "Validate that if a supply point has be provided with agreements in the payload, that the supply point does not already exist in Kraken.",
"possible_errors": [
"supply_point_already_exists"
]
}
]Old
[
{
"name": "Validate <code>\u2068supply_end_date\u2069</code> not before <code>\u2068supply_start_date\u2069</code>",
"description": "Validates that <code>\u2068supply_end_date\u2069</code>, if given, is on or later than <code>\u2068supply_start_date\u2069</code>.",
"possible_errors": [
"start_date_later_than_end_date"
]
},
{
"name": "Validate agreements do not start before supply start date",
"description": "Validate that agreements do not start before the supply point's supply start date, if provided.",
"possible_errors": [
"agreement_start_date_before_supply_start_date"
]
},
{
"name": "Validate that exactly one active agreement is provided",
"description": "Validate that exactly one active agreement is provided for the supply point if it is already on supply. If the <code>supply_start_date</code> is in the future or the <code>supply_end_date</code> is in the past then we do not check for an active agreement.",
"possible_errors": [
"exactly_one_active_agreement_required"
]
},
{
"name": "Validate that a future agreement provided if supply start date is in the future",
"description": "Validate that exactly one future agreement is provided if the supply start date is in the future. This future agreement must start on the supply start date.",
"possible_errors": [
"future_agreement_required"
]
},
{
"name": "Validate that the supply point does not exist in Kraken",
"description": "Validate that if a supply point has be provided with agreements in the payload, that the supply point does not already exist in Kraken.",
"possible_errors": [
"supply_point_already_exists"
]
}
]
No attributes to display
7 April 2026
New
{
"x-enum-descriptions": {}
}Old
{
"x-enum-descriptions": {
"DIRECTA__PLENITUDE__ENERGY_SPECIALIST__SANTANDER": "DIRECTA__PLENITUDE__ENERGY_SPECIALIST__SANTANDER"
}
}New
{
"x-enum-descriptions": {}
}Old
{
"x-enum-descriptions": {
"DIRECTA__PLENITUDE__ENERGY_SPECIALIST__SANTANDER": "DIRECTA -> PLENITUDE -> ENERGY SPECIALIST -> SANTANDER"
}
}New
{
"x-enum-descriptions": {}
}Old
{
"x-enum-descriptions": {
"DIRECTA__PLENITUDE__ENERGY_SPECIALIST__SANTANDER": "DIRECTA -> PLENITUDE -> ENERGY SPECIALIST -> SANTANDER"
}
}New
{
"x-enum-descriptions": {
"DIRECTA__BROKERS__BROKERS": "DIRECTA -> BROKERS -> BROKERS B"
}
}Old
{
"x-enum-descriptions": {
"DIRECTA__BROKERS__BROKERS": "DIRECTA -> BROKERS -> BROKERS"
}
}New
{
"x-enum-descriptions": {
"DIRECTA__BROKERS__BROKERS": "DIRECTA -> BROKERS -> BROKERS B"
}
}Old
{
"x-enum-descriptions": {
"DIRECTA__BROKERS__BROKERS": "DIRECTA -> BROKERS -> BROKERS"
}
}6 April 2026
New
{
"x-enum-descriptions": {
"PLENITUDE_ES_WEKIWI": "Eni Plenitude ES Import supplier - Wekiwi"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"PLENITUDE_ES_WEKIWI": "Eni Plenitude ES Import supplier - Wekiwi"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"PLENITUDE_ES_WEKIWI": "Eni Plenitude ES Import supplier - Wekiwi"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"PLENITUDE_ES_WEKIWI": "Eni Plenitude ES Import supplier - Wekiwi"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"PLENITUDE_ES_WEKIWI": "Eni Plenitude ES Import supplier - Wekiwi"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"PLENITUDE_ES_WEKIWI": "Eni Plenitude ES Import supplier - Wekiwi"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"PLENITUDE_ES_WEKIWI": "Eni Plenitude ES Import supplier - Wekiwi"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"PLENITUDE_ES_WEKIWI": "Eni Plenitude ES Import supplier - Wekiwi"
}
}Old
{
"x-enum-descriptions": {}
}31 March 2026
New
{
"items": {
"$ref": "#/components/schemas/EspLedgerRecordWithBillingDocuments"
}
}Old
{
"items": {
"$ref": "#/components/schemas/EspLedgerRecordWithTransactions"
}
}New
{
"x-enum-descriptions": {
"INDIRECTA__TRADICIONAL__MIXTO": "INDIRECTA__TRADICIONAL__MIXTO",
"INDIRECTA__ALIANZAS__CAMBIO_DE_CARTERA_A": "INDIRECTA__ALIANZAS__CAMBIO_DE_CARTERA_A",
"INDIRECTA__ALIANZAS__CAMBIO_DE_CARTERA_A_C2C": "INDIRECTA__ALIANZAS__CAMBIO_DE_CARTERA_A_C2C"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"INDIRECTA__TRADICIONAL__MIXTO": "INDIRECTA -> TRADICIONAL -> MIXTO",
"INDIRECTA__ALIANZAS__CAMBIO_DE_CARTERA_A": "INDIRECTA -> ALIANZAS -> CAMBIO DE CARTERA A",
"INDIRECTA__ALIANZAS__CAMBIO_DE_CARTERA_A_C2C": "INDIRECTA -> ALIANZAS -> CAMBIO DE CARTERA A C2C"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"INDIRECTA__TRADICIONAL__MIXTO": "INDIRECTA -> TRADICIONAL -> MIXTO",
"INDIRECTA__ALIANZAS__CAMBIO_DE_CARTERA_A": "INDIRECTA -> ALIANZAS -> CAMBIO DE CARTERA A",
"INDIRECTA__ALIANZAS__CAMBIO_DE_CARTERA_A_C2C": "INDIRECTA -> ALIANZAS -> CAMBIO DE CARTERA A C2C"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"INDIRECTA__TRADICIONAL__CALL_CENTER": "INDIRECTA__TRADICIONAL__CALL_CENTER",
"INDIRECTA__TRADICIONAL__CAMBIO_DE_CARTERA_T": "INDIRECTA__TRADICIONAL__CAMBIO_DE_CARTERA_T"
}
}Old
{
"x-enum-descriptions": {
"DIRECTA__ALIANZAS": "DIRECTA__ALIANZAS",
"DIRECTA__TRADICIONAL": "DIRECTA__TRADICIONAL",
"DIRECTA__TRADICIONAL__MIXTO": "DIRECTA__TRADICIONAL__MIXTO",
"DIRECTA__TRADICIONAL__CALL_CENTER": "DIRECTA__TRADICIONAL__CALL_CENTER",
"DIRECTA__ALIANZAS__CAMBIO_DE_CARTERA_A": "DIRECTA__ALIANZAS__CAMBIO_DE_CARTERA_A",
"DIRECTA__TRADICIONAL__CAMBIO_DE_CARTERA_T": "DIRECTA__TRADICIONAL__CAMBIO_DE_CARTERA_T",
"DIRECTA__ALIANZAS__CAMBIO_DE_CARTERA_A_C2C": "DIRECTA__ALIANZAS__CAMBIO_DE_CARTERA_A_C2C"
}
}New
{
"x-enum-descriptions": {
"INDIRECTA__TRADICIONAL__CALL_CENTER": "INDIRECTA -> TRADICIONAL -> CALL CENTER",
"INDIRECTA__TRADICIONAL__CAMBIO_DE_CARTERA_T": "INDIRECTA -> TRADICIONAL -> CAMBIO DE CARTERA T"
}
}Old
{
"x-enum-descriptions": {
"DIRECTA__ALIANZAS": "DIRECTA -> ALIANZAS",
"DIRECTA__TRADICIONAL": "DIRECTA -> TRADICIONAL",
"DIRECTA__TRADICIONAL__MIXTO": "DIRECTA -> TRADICIONAL -> MIXTO",
"DIRECTA__TRADICIONAL__CALL_CENTER": "DIRECTA -> TRADICIONAL -> CALL CENTER",
"DIRECTA__ALIANZAS__CAMBIO_DE_CARTERA_A": "DIRECTA -> ALIANZAS -> CAMBIO DE CARTERA A",
"DIRECTA__TRADICIONAL__CAMBIO_DE_CARTERA_T": "DIRECTA -> TRADICIONAL -> CAMBIO DE CARTERA T",
"DIRECTA__ALIANZAS__CAMBIO_DE_CARTERA_A_C2C": "DIRECTA -> ALIANZAS -> CAMBIO DE CARTERA A C2C"
}
}New
{
"x-enum-descriptions": {
"INDIRECTA__TRADICIONAL__CALL_CENTER": "INDIRECTA -> TRADICIONAL -> CALL CENTER",
"INDIRECTA__TRADICIONAL__CAMBIO_DE_CARTERA_T": "INDIRECTA -> TRADICIONAL -> CAMBIO DE CARTERA T"
}
}Old
{
"x-enum-descriptions": {
"DIRECTA__ALIANZAS": "DIRECTA -> ALIANZAS",
"DIRECTA__TRADICIONAL": "DIRECTA -> TRADICIONAL",
"DIRECTA__TRADICIONAL__MIXTO": "DIRECTA -> TRADICIONAL -> MIXTO",
"DIRECTA__TRADICIONAL__CALL_CENTER": "DIRECTA -> TRADICIONAL -> CALL CENTER",
"DIRECTA__ALIANZAS__CAMBIO_DE_CARTERA_A": "DIRECTA -> ALIANZAS -> CAMBIO DE CARTERA A",
"DIRECTA__TRADICIONAL__CAMBIO_DE_CARTERA_T": "DIRECTA -> TRADICIONAL -> CAMBIO DE CARTERA T",
"DIRECTA__ALIANZAS__CAMBIO_DE_CARTERA_A_C2C": "DIRECTA -> ALIANZAS -> CAMBIO DE CARTERA A C2C"
}
}New
{
"x-enum-descriptions": {
"DIRECTA__BROKERS": "DIRECTA__BROKERS",
"DIRECTA__BROKERS__API": "DIRECTA__BROKERS__API",
"DIRECTA__BROKERS__BROKERS": "DIRECTA__BROKERS__BROKERS",
"DIRECTA__TELESALES__OUTBOUND_EXITO_M": "DIRECTA__TELESALES__OUTBOUND_EXITO_M",
"DIRECTA__TELESALES__OUTBOUND_MIXTO_CP": "DIRECTA__TELESALES__OUTBOUND_MIXTO_CP",
"DIRECTA__TELESALES__OUTBOUND_EXITO__TUNEZ": "DIRECTA__TELESALES__OUTBOUND_EXITO__TUNEZ",
"DIRECTA__TELESALES__OUTBOUND_EXITO_M__LATAM": "DIRECTA__TELESALES__OUTBOUND_EXITO_M__LATAM"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"DIRECTA__BROKERS": "DIRECTA -> BROKERS",
"DIRECTA__BROKERS__API": "DIRECTA -> BROKERS -> API",
"DIRECTA__BROKERS__BROKERS": "DIRECTA -> BROKERS -> BROKERS",
"DIRECTA__TELESALES__OUTBOUND_EXITO_M": "DIRECTA -> TELESALES -> OUTBOUND EXITO M",
"DIRECTA__TELESALES__OUTBOUND_MIXTO_CP": "DIRECTA -> TELESALES -> OUTBOUND MIXTO CP",
"DIRECTA__TELESALES__OUTBOUND_EXITO__TUNEZ": "DIRECTA -> TELESALES -> OUTBOUND EXITO -> TUNEZ",
"DIRECTA__TELESALES__OUTBOUND_EXITO_M__LATAM": "DIRECTA -> TELESALES -> OUTBOUND EXITO M -> LATAM"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"DIRECTA__BROKERS": "DIRECTA -> BROKERS",
"DIRECTA__BROKERS__API": "DIRECTA -> BROKERS -> API",
"DIRECTA__BROKERS__BROKERS": "DIRECTA -> BROKERS -> BROKERS",
"DIRECTA__TELESALES__OUTBOUND_EXITO_M": "DIRECTA -> TELESALES -> OUTBOUND EXITO M",
"DIRECTA__TELESALES__OUTBOUND_MIXTO_CP": "DIRECTA -> TELESALES -> OUTBOUND MIXTO CP",
"DIRECTA__TELESALES__OUTBOUND_EXITO__TUNEZ": "DIRECTA -> TELESALES -> OUTBOUND EXITO -> TUNEZ",
"DIRECTA__TELESALES__OUTBOUND_EXITO_M__LATAM": "DIRECTA -> TELESALES -> OUTBOUND EXITO M -> LATAM"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"INDIRECTA": "INDIRECTA",
"DIRECTA__ALIANZAS": "DIRECTA__ALIANZAS",
"DIRECTA__ASSISTED": "DIRECTA__ASSISTED",
"DIRECTA__PLENITUDE": "DIRECTA__PLENITUDE",
"DIRECTA__TELESALES": "DIRECTA__TELESALES",
"INDIRECTA__ALIANZAS": "INDIRECTA__ALIANZAS",
"DIRECTA__TRADICIONAL": "DIRECTA__TRADICIONAL",
"DIRECTA__ASSISTED__C2C": "DIRECTA__ASSISTED__C2C",
"INDIRECTA__TRADICIONAL": "INDIRECTA__TRADICIONAL",
"DIRECTA__TELESALES__WINBACK": "DIRECTA__TELESALES__WINBACK",
"DIRECTA__TRADICIONAL__MIXTO": "DIRECTA__TRADICIONAL__MIXTO",
"INDIRECTA__TRADICIONAL__API": "INDIRECTA__TRADICIONAL__API",
"DIRECTA__TELESALES__OLD_WINBACK": "DIRECTA__TELESALES__OLD_WINBACK",
"DIRECTA__TELESALES__CROSS_SELLING": "DIRECTA__TELESALES__CROSS_SELLING",
"DIRECTA__TRADICIONAL__CALL_CENTER": "DIRECTA__TRADICIONAL__CALL_CENTER",
"DIRECTA__TELESALES__OUTBOUND_EXITO": "DIRECTA__TELESALES__OUTBOUND_EXITO",
"DIRECTA__TELESALES__OUTBOUND_MIXTO": "DIRECTA__TELESALES__OUTBOUND_MIXTO",
"DIRECTA__PLENITUDE__ENERGY_SPECIALIST": "DIRECTA__PLENITUDE__ENERGY_SPECIALIST",
"DIRECTA__TELESALES__OLD_WINBACK__LEON": "DIRECTA__TELESALES__OLD_WINBACK__LEON",
"INDIRECTA__ALIANZAS__DISTRIBUIDORES_A": "INDIRECTA__ALIANZAS__DISTRIBUIDORES_A",
"DIRECTA__ALIANZAS__CAMBIO_DE_CARTERA_A": "DIRECTA__ALIANZAS__CAMBIO_DE_CARTERA_A",
"DIRECTA__TELESALES__CROSS_SELLING__LEON": "DIRECTA__TELESALES__CROSS_SELLING__LEON",
"DIRECTA__TELESALES__WINBACK__VALLADOLID": "DIRECTA__TELESALES__WINBACK__VALLADOLID",
"INDIRECTA__TRADICIONAL__DISTRIBUIDORES_T": "INDIRECTA__TRADICIONAL__DISTRIBUIDORES_T",
"DIRECTA__TELESALES__OUTBOUND_EXITO__LATAM": "DIRECTA__TELESALES__OUTBOUND_EXITO__LATAM",
"DIRECTA__TELESALES__OUTBOUND_MIXTO__LATAM": "DIRECTA__TELESALES__OUTBOUND_MIXTO__LATAM",
"DIRECTA__TRADICIONAL__CAMBIO_DE_CARTERA_T": "DIRECTA__TRADICIONAL__CAMBIO_DE_CARTERA_T",
"DIRECTA__ALIANZAS__CAMBIO_DE_CARTERA_A_C2C": "DIRECTA__ALIANZAS__CAMBIO_DE_CARTERA_A_C2C",
"DIRECTA__TELESALES__OLD_WINBACK__VALLADOLID": "DIRECTA__TELESALES__OLD_WINBACK__VALLADOLID",
"DIRECTA__PLENITUDE__ENERGY_SPECIALIST__SANTANDER": "DIRECTA__PLENITUDE__ENERGY_SPECIALIST__SANTANDER"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"items": {
"$ref": "#/components/schemas/EspLedgerRecordWithTransactions"
}
}Old
{
"items": {
"$ref": "#/components/schemas/EspLedgerRecordWithBillingDocuments"
}
}New
{
"x-enum-descriptions": {
"INDIRECTA": "INDIRECTA",
"DIRECTA__ALIANZAS": "DIRECTA -> ALIANZAS",
"DIRECTA__ASSISTED": "DIRECTA -> ASSISTED",
"DIRECTA__PLENITUDE": "DIRECTA -> PLENITUDE",
"DIRECTA__TELESALES": "DIRECTA -> TELESALES",
"INDIRECTA__ALIANZAS": "INDIRECTA -> ALIANZAS",
"DIRECTA__TRADICIONAL": "DIRECTA -> TRADICIONAL",
"DIRECTA__ASSISTED__C2C": "DIRECTA -> ASSISTED -> C2C",
"INDIRECTA__TRADICIONAL": "INDIRECTA -> TRADICIONAL",
"DIRECTA__TELESALES__WINBACK": "DIRECTA -> TELESALES -> WINBACK",
"DIRECTA__TRADICIONAL__MIXTO": "DIRECTA -> TRADICIONAL -> MIXTO",
"INDIRECTA__TRADICIONAL__API": "INDIRECTA -> TRADICIONAL -> API",
"DIRECTA__TELESALES__OLD_WINBACK": "DIRECTA -> TELESALES -> OLD WINBACK",
"DIRECTA__TELESALES__CROSS_SELLING": "DIRECTA -> TELESALES -> CROSS SELLING",
"DIRECTA__TRADICIONAL__CALL_CENTER": "DIRECTA -> TRADICIONAL -> CALL CENTER",
"DIRECTA__TELESALES__OUTBOUND_EXITO": "DIRECTA -> TELESALES -> OUTBOUND EXITO",
"DIRECTA__TELESALES__OUTBOUND_MIXTO": "DIRECTA -> TELESALES -> OUTBOUND MIXTO",
"DIRECTA__PLENITUDE__ENERGY_SPECIALIST": "DIRECTA -> PLENITUDE -> ENERGY SPECIALIST",
"DIRECTA__TELESALES__OLD_WINBACK__LEON": "DIRECTA -> TELESALES -> OLD WINBACK -> LEON",
"INDIRECTA__ALIANZAS__DISTRIBUIDORES_A": "INDIRECTA -> ALIANZAS -> DISTRIBUIDORES A",
"DIRECTA__ALIANZAS__CAMBIO_DE_CARTERA_A": "DIRECTA -> ALIANZAS -> CAMBIO DE CARTERA A",
"DIRECTA__TELESALES__CROSS_SELLING__LEON": "DIRECTA -> TELESALES -> CROSS SELLING -> LEON",
"DIRECTA__TELESALES__WINBACK__VALLADOLID": "DIRECTA -> TELESALES -> WINBACK -> VALLADOLID",
"INDIRECTA__TRADICIONAL__DISTRIBUIDORES_T": "INDIRECTA -> TRADICIONAL -> DISTRIBUIDORES T",
"DIRECTA__TELESALES__OUTBOUND_EXITO__LATAM": "DIRECTA -> TELESALES -> OUTBOUND EXITO -> LATAM",
"DIRECTA__TELESALES__OUTBOUND_MIXTO__LATAM": "DIRECTA -> TELESALES -> OUTBOUND MIXTO -> LATAM",
"DIRECTA__TRADICIONAL__CAMBIO_DE_CARTERA_T": "DIRECTA -> TRADICIONAL -> CAMBIO DE CARTERA T",
"DIRECTA__ALIANZAS__CAMBIO_DE_CARTERA_A_C2C": "DIRECTA -> ALIANZAS -> CAMBIO DE CARTERA A C2C",
"DIRECTA__TELESALES__OLD_WINBACK__VALLADOLID": "DIRECTA -> TELESALES -> OLD WINBACK -> VALLADOLID",
"DIRECTA__PLENITUDE__ENERGY_SPECIALIST__SANTANDER": "DIRECTA -> PLENITUDE -> ENERGY SPECIALIST -> SANTANDER"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"INDIRECTA": "INDIRECTA",
"DIRECTA__ALIANZAS": "DIRECTA -> ALIANZAS",
"DIRECTA__ASSISTED": "DIRECTA -> ASSISTED",
"DIRECTA__PLENITUDE": "DIRECTA -> PLENITUDE",
"DIRECTA__TELESALES": "DIRECTA -> TELESALES",
"INDIRECTA__ALIANZAS": "INDIRECTA -> ALIANZAS",
"DIRECTA__TRADICIONAL": "DIRECTA -> TRADICIONAL",
"DIRECTA__ASSISTED__C2C": "DIRECTA -> ASSISTED -> C2C",
"INDIRECTA__TRADICIONAL": "INDIRECTA -> TRADICIONAL",
"DIRECTA__TELESALES__WINBACK": "DIRECTA -> TELESALES -> WINBACK",
"DIRECTA__TRADICIONAL__MIXTO": "DIRECTA -> TRADICIONAL -> MIXTO",
"INDIRECTA__TRADICIONAL__API": "INDIRECTA -> TRADICIONAL -> API",
"DIRECTA__TELESALES__OLD_WINBACK": "DIRECTA -> TELESALES -> OLD WINBACK",
"DIRECTA__TELESALES__CROSS_SELLING": "DIRECTA -> TELESALES -> CROSS SELLING",
"DIRECTA__TRADICIONAL__CALL_CENTER": "DIRECTA -> TRADICIONAL -> CALL CENTER",
"DIRECTA__TELESALES__OUTBOUND_EXITO": "DIRECTA -> TELESALES -> OUTBOUND EXITO",
"DIRECTA__TELESALES__OUTBOUND_MIXTO": "DIRECTA -> TELESALES -> OUTBOUND MIXTO",
"DIRECTA__PLENITUDE__ENERGY_SPECIALIST": "DIRECTA -> PLENITUDE -> ENERGY SPECIALIST",
"DIRECTA__TELESALES__OLD_WINBACK__LEON": "DIRECTA -> TELESALES -> OLD WINBACK -> LEON",
"INDIRECTA__ALIANZAS__DISTRIBUIDORES_A": "INDIRECTA -> ALIANZAS -> DISTRIBUIDORES A",
"DIRECTA__ALIANZAS__CAMBIO_DE_CARTERA_A": "DIRECTA -> ALIANZAS -> CAMBIO DE CARTERA A",
"DIRECTA__TELESALES__CROSS_SELLING__LEON": "DIRECTA -> TELESALES -> CROSS SELLING -> LEON",
"DIRECTA__TELESALES__WINBACK__VALLADOLID": "DIRECTA -> TELESALES -> WINBACK -> VALLADOLID",
"INDIRECTA__TRADICIONAL__DISTRIBUIDORES_T": "INDIRECTA -> TRADICIONAL -> DISTRIBUIDORES T",
"DIRECTA__TELESALES__OUTBOUND_EXITO__LATAM": "DIRECTA -> TELESALES -> OUTBOUND EXITO -> LATAM",
"DIRECTA__TELESALES__OUTBOUND_MIXTO__LATAM": "DIRECTA -> TELESALES -> OUTBOUND MIXTO -> LATAM",
"DIRECTA__TRADICIONAL__CAMBIO_DE_CARTERA_T": "DIRECTA -> TRADICIONAL -> CAMBIO DE CARTERA T",
"DIRECTA__ALIANZAS__CAMBIO_DE_CARTERA_A_C2C": "DIRECTA -> ALIANZAS -> CAMBIO DE CARTERA A C2C",
"DIRECTA__TELESALES__OLD_WINBACK__VALLADOLID": "DIRECTA -> TELESALES -> OLD WINBACK -> VALLADOLID",
"DIRECTA__PLENITUDE__ENERGY_SPECIALIST__SANTANDER": "DIRECTA -> PLENITUDE -> ENERGY SPECIALIST -> SANTANDER"
}
}Old
{
"x-enum-descriptions": {}
}30 March 2026
No attributes to display
No attributes to display
No attributes to display
New
{
"x-enum-descriptions": {
"CUSTOM": "Custom"
}
}Old
{
"x-enum-descriptions": {}
}
No attributes to display
New
{
"x-enum-descriptions": {
"CUSTOM": "Custom"
}
}Old
{
"x-enum-descriptions": {}
}
No attributes to display
26 March 2026
New
[
{
"name": "Validate that current statement transactions are after the last statement closing date",
"description": "Validate that all <code>current_statement_transactions</code>, if provided, are after the <code>last_statement_closing_date</code>, if this date is given.",
"possible_errors": [
"current_statement_transaction_before_last_statement_closing_date"
]
},
{
"name": "Validate that there are no current statement transactions for unbillable ledger",
"description": "Validate that transactions for ledgers that will never issue any bills are only in <code>historical_statement_transactions</code>.",
"possible_errors": [
"unbillable_ledger_transactions_in_current_statement_transactions"
]
},
{
"name": "Validate unique transaction IDs",
"description": "Validate that all transaction IDs provided are unique.",
"possible_errors": [
"duplicate_transaction_ids",
"missing_transaction_id"
]
},
{
"name": "Validate billing document type matches provided historical billing documents' type",
"description": "Validate that the provided <code>billing_document_type</code> matches the type of all provided historical billing documents.",
"possible_errors": [
"billing_document_type_does_not_match_historical_billing_documents_type"
]
},
{
"name": "Validate additional transaction billing document identifiers match billing documents",
"description": "Validate that any <code>billing_document_identifier</code> provided on additional historical transactions matches an identifier in the provided historical billing documents.",
"possible_errors": [
"additional_transaction_billing_document_identifier_mismatch"
]
},
{
"name": "Validate that the sum of all transactions matches the ledger balance",
"description": "Validate that the sum of all transactions in <code>historical_billing_documents</code> plus <code>current_statement_transactions</code> plus <code>additional_historical_transactions</code> equals the <code>ledger_balance</code>.",
"possible_errors": [
"historical_billing_documents_balance_mismatch"
]
},
{
"name": "Validate line item periods in all transactions",
"description": "Validate that no line items overlap (checked per supply point, product, and rate band combination) or have gaps (checked per supply point only) for all supply charge transactions in <code>historical_billing_documents</code> and <code>additional_historical_transactions</code>.",
"possible_errors": [
"gaps_or_overlaps_in_periods"
]
}
]Old
[
{
"name": "Validate that current statement transactions are after the last statement closing date",
"description": "Validate that all <code>current_statement_transactions</code>, if provided, are after the <code>last_statement_closing_date</code>, if this date is given.",
"possible_errors": [
"current_statement_transaction_before_last_statement_closing_date"
]
},
{
"name": "Validate that there are no current statement transactions for unbillable ledger",
"description": "Validate that transactions for ledgers that will never issue any bills are only in <code>historical_statement_transactions</code>.",
"possible_errors": [
"unbillable_ledger_transactions_in_current_statement_transactions"
]
},
{
"name": "Validate unique transaction IDs",
"description": "Validate that all transaction IDs provided are unique.",
"possible_errors": [
"duplicate_transaction_ids",
"missing_transaction_id"
]
},
{
"name": "Validate billing document type matches provided historical billing documents' type",
"description": "Validate that the provided <code>billing_document_type</code> matches the type of all provided historical billing documents.",
"possible_errors": [
"billing_document_type_does_not_match_historical_billing_documents_type"
]
},
{
"name": "Validate that the sum of all transactions matches the ledger balance",
"description": "Validate that the sum of all transactions in <code>historical_billing_documents</code> plus <code>current_statement_transactions</code> plus <code>additional_historical_transactions</code> equals the <code>ledger_balance</code>.",
"possible_errors": [
"historical_billing_documents_balance_mismatch"
]
},
{
"name": "Validate line item periods in all transactions",
"description": "Validate that no line items overlap (checked per supply point, product, and rate band combination) or have gaps (checked per supply point only) for all supply charge transactions in <code>historical_billing_documents</code> and <code>additional_historical_transactions</code>.",
"possible_errors": [
"gaps_or_overlaps_in_periods"
]
}
]24 March 2026
New
{
"x-removal-date": "2026-04-29"
}18 March 2026
New
{
"x-enum-descriptions": {
"026": "6.2TDVE",
"027": "3.0TDVE-Embarcaciones",
"028": "6.1TDVE-Embarcaciones",
"029": "6.2TDVE-Embarcaciones"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"026": "6.2TDVE",
"027": "3.0TDVE-Embarcaciones",
"028": "6.1TDVE-Embarcaciones",
"029": "6.2TDVE-Embarcaciones"
}
}Old
{
"x-enum-descriptions": {}
}17 March 2026
No attributes to display
No attributes to display
16 March 2026
New
{
"x-enum-descriptions": {
"DIRECTA__DIRECT__SELFWEB": "DIRECTA__DIRECT__SELFWEB"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"DIRECTA__DIRECT__SELFWEB": "DIRECTA -> DIRECT -> SelfWeb"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"DIRECTA__DIRECT__SELFWEB": "DIRECTA -> DIRECT -> SelfWeb"
}
}Old
{
"x-enum-descriptions": {}
}13 March 2026
New
{
"GREEN": "#/components/schemas/GreenCharacteristic"
}New
[
{
"$ref": "#/components/schemas/GreenCharacteristic"
},
{
"$ref": "#/components/schemas/TelemetryApTestCharacteristic"
},
{
"$ref": "#/components/schemas/SalesChannelCharacteristic"
},
{
"$ref": "#/components/schemas/ServicioLuzHogarCharacteristic"
},
{
"$ref": "#/components/schemas/CgFeeCharacteristic"
},
{
"$ref": "#/components/schemas/PowerConsLimitCharacteristic"
},
{
"$ref": "#/components/schemas/TelemetryCharacteristic"
}
]Old
[
{
"$ref": "#/components/schemas/SalesChannelCharacteristic"
},
{
"$ref": "#/components/schemas/TelemetryApTestCharacteristic"
},
{
"$ref": "#/components/schemas/TelemetryCharacteristic"
},
{
"$ref": "#/components/schemas/ServicioLuzHogarCharacteristic"
},
{
"$ref": "#/components/schemas/CgFeeCharacteristic"
},
{
"$ref": "#/components/schemas/PowerConsLimitCharacteristic"
}
]New
{
"enum": [
"SME",
"C&I"
],
"type": "string",
"x-spec-enum-id": "92e2454b83692d52",
"x-enum-descriptions": {
"C&I": "C&I",
"SME": "SME"
}
}Old
{
"x-comment": "Choices for this field are dynamic, once appropriate values have been configured they will be rendered here.",
"x-spec-enum-id": "4f53cda18c2baa0c"
}New
{
"enum": [
"SME",
"C&I"
],
"type": "string",
"x-spec-enum-id": "92e2454b83692d52",
"x-enum-descriptions": {
"C&I": "C&I",
"SME": "SME"
}
}Old
{
"x-comment": "Choices for this field are dynamic, once appropriate values have been configured they will be rendered here.",
"x-spec-enum-id": "4f53cda18c2baa0c"
}New
{
"enum": [
"SME",
"C&I"
],
"type": "string",
"x-spec-enum-id": "92e2454b83692d52",
"x-enum-descriptions": {
"C&I": "C&I",
"SME": "SME"
}
}Old
{
"x-comment": "Choices for this field are dynamic, once appropriate values have been configured they will be rendered here.",
"x-spec-enum-id": "4f53cda18c2baa0c"
}
No attributes to display
12 March 2026
New
{
"x-enum-descriptions": {
"PLENITUDE_ES_SME": "PLENITUDE_ES_SME"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"PLENITUDE_ES_SME": "PLENITUDE_ES_SME"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"PLENITUDE_ES_SME": "PLENITUDE_ES_SME"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"PLENITUDE_ES_SME": "PLENITUDE_ES_SME"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"PLENITUDE_ES_SME": "PLENITUDE_ES_SME"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"PLENITUDE_ES_SME": "PLENITUDE_ES_SME"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"PLENITUDE_ES_SME": "PLENITUDE_ES_SME"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"PLENITUDE_ES_SME": "PLENITUDE_ES_SME"
}
}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 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 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 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 exactly one property for service agreement property association",
"description": "Validates that exactly one supply address is provided when there are service agreements with products that require property association.",
"possible_errors": [
"service_agreement_requires_supply_address"
]
},
{
"name": "Validate ledger identifiers are known",
"description": "Validate ledger identifiers are among supply point identifiers.",
"possible_errors": [
"unknown_ledger_identifiers"
]
},
{
"name": "Validate identifiers are unique in ledgers",
"description": "Validate identifier is not declared twice in ledgers.",
"possible_errors": [
"duplicate_identifiers_entries_found"
]
},
{
"name": "Validate agreements cover last statement closing date",
"description": "Validate that there is an agreement for each supply point covering each ledger's <code>last_statement_closing_date</code>.",
"possible_errors": [
"no_agreement_covering_last_statement_closing_date"
]
},
{
"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 company number provided for business account",
"description": "Validate that a business account has company number provided.",
"possible_errors": [
"company_number_required_for_business_account"
]
}
]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 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 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 ledger identifiers are known",
"description": "Validate ledger identifiers are among supply point identifiers.",
"possible_errors": [
"unknown_ledger_identifiers"
]
},
{
"name": "Validate identifiers are unique in ledgers",
"description": "Validate identifier is not declared twice in ledgers.",
"possible_errors": [
"duplicate_identifiers_entries_found"
]
},
{
"name": "Validate agreements cover last statement closing date",
"description": "Validate that there is an agreement for each supply point covering each ledger's <code>last_statement_closing_date</code>.",
"possible_errors": [
"no_agreement_covering_last_statement_closing_date"
]
},
{
"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 company number provided for business account",
"description": "Validate that a business account has company number provided.",
"possible_errors": [
"company_number_required_for_business_account"
]
}
]
No attributes to display
11 March 2026
New
{
"x-comment": "Choices for this field are dynamic, once appropriate values have been configured they will be rendered here.",
"x-spec-enum-id": "4f53cda18c2baa0c"
}Old
{
"enum": [
"AUTONOMOS"
],
"type": "string",
"x-spec-enum-id": "97269b739dd5f367",
"x-enum-descriptions": {
"AUTONOMOS": "AUTONOMOS"
}
}New
{
"x-comment": "Choices for this field are dynamic, once appropriate values have been configured they will be rendered here.",
"x-spec-enum-id": "4f53cda18c2baa0c"
}Old
{
"enum": [
"AUTONOMOS"
],
"type": "string",
"x-spec-enum-id": "97269b739dd5f367",
"x-enum-descriptions": {
"AUTONOMOS": "AUTONOMOS"
}
}New
{
"x-comment": "Choices for this field are dynamic, once appropriate values have been configured they will be rendered here.",
"x-spec-enum-id": "4f53cda18c2baa0c"
}Old
{
"enum": [
"AUTONOMOS"
],
"type": "string",
"x-spec-enum-id": "97269b739dd5f367",
"x-enum-descriptions": {
"AUTONOMOS": "AUTONOMOS"
}
}10 March 2026
New
{
"x-enum-descriptions": {
"PLENITUDEES_IMPORT_SUPPLIER_B2B": "Eni Plenitude ES Import supplier B2B"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"PLENITUDEES_IMPORT_SUPPLIER_B2B": "Eni Plenitude ES Import supplier B2B"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"PLENITUDEES_IMPORT_SUPPLIER_B2B": "Eni Plenitude ES Import supplier B2B"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"PLENITUDEES_IMPORT_SUPPLIER_B2B": "Eni Plenitude ES Import supplier B2B"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"PLENITUDEES_IMPORT_SUPPLIER_B2B": "Eni Plenitude ES Import supplier B2B"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"PLENITUDEES_IMPORT_SUPPLIER_B2B": "Eni Plenitude ES Import supplier B2B"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"enum": [
"AUTONOMOS"
],
"type": "string",
"x-spec-enum-id": "97269b739dd5f367",
"x-enum-descriptions": {
"AUTONOMOS": "AUTONOMOS"
}
}Old
{
"x-comment": "Choices for this field are dynamic, once appropriate values have been configured they will be rendered here.",
"x-spec-enum-id": "4f53cda18c2baa0c"
}New
{
"enum": [
"AUTONOMOS"
],
"type": "string",
"x-spec-enum-id": "97269b739dd5f367",
"x-enum-descriptions": {
"AUTONOMOS": "AUTONOMOS"
}
}Old
{
"x-comment": "Choices for this field are dynamic, once appropriate values have been configured they will be rendered here.",
"x-spec-enum-id": "4f53cda18c2baa0c"
}New
{
"x-enum-descriptions": {
"PLENITUDEES_IMPORT_SUPPLIER_B2B": "Eni Plenitude ES Import supplier B2B"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"enum": [
"AUTONOMOS"
],
"type": "string",
"x-spec-enum-id": "97269b739dd5f367",
"x-enum-descriptions": {
"AUTONOMOS": "AUTONOMOS"
}
}Old
{
"x-comment": "Choices for this field are dynamic, once appropriate values have been configured they will be rendered here.",
"x-spec-enum-id": "4f53cda18c2baa0c"
}New
{
"x-enum-descriptions": {
"PLENITUDEES_IMPORT_SUPPLIER_B2B": "Eni Plenitude ES Import supplier B2B"
}
}Old
{
"x-enum-descriptions": {}
}5 March 2026
New
{
"items": {
"$ref": "#/components/schemas/EspLedgerRecordWithBillingDocuments"
}
}Old
{
"items": {
"$ref": "#/components/schemas/EspLedgerRecordWithTransactions"
}
}New
{
"DELAYER_DAYS": "#/components/schemas/DelayerDays",
"BILL_DUE_DATE": "#/components/schemas/BillDueDate",
"TERMINATION_FEE": "#/components/schemas/TerminationFee",
"CONTRACT_METADATA": "#/components/schemas/ContractMetaData",
"LATE_PAYMENT_FEES": "#/components/schemas/LatePaymentFees",
"ISSUANCE_FREQUENCY": "#/components/schemas/BillingDocumentIssuanceFrequencyTerm",
"COLLATERAL_REQUIRED": "#/components/schemas/CollateralRequired",
"PAYS_BY_DIRECT_DEBIT": "#/components/schemas/PaysByDirectDebitTerm",
"PROMOTION_ASSIGNMENT": "#/components/schemas/PromotionAssignmentTerm",
"RATE_GROUP_ELIGIBILITY": "#/components/schemas/RateGroupEligibilityConfiguration",
"CHARACTERISTIC_OVERRIDE": "#/components/schemas/CharacteristicOverrideConfiguration",
"MINIMUM_CONTRACT_LENGTH": "#/components/schemas/MinimumContractLength",
"BESPOKE_RATE_CONFIGURATION": "#/components/schemas/BespokeRateConfiguration",
"TAX_ADJUSTMENT_CONFIGURATION": "#/components/schemas/TaxAdjustmentConfiguration",
"PRODUCT_RATE_OVERRIDE_SCHEDULE": "#/components/schemas/ProductRateOverrideConfiguration",
"CONTRACTED_VOLUME_CONFIGURATION": "#/components/schemas/ContractedVolumeConfiguration",
"GUARANTEE_OF_ORIGIN_CONFIGURATION": "#/components/schemas/GuaranteeOfOriginConfiguration"
}New
[
{
"$ref": "#/components/schemas/BespokeRateConfiguration"
},
{
"$ref": "#/components/schemas/BillDueDate"
},
{
"$ref": "#/components/schemas/BillingDocumentIssuanceFrequencyTerm"
},
{
"$ref": "#/components/schemas/CharacteristicOverrideConfiguration"
},
{
"$ref": "#/components/schemas/CollateralRequired"
},
{
"$ref": "#/components/schemas/ContractMetaData"
},
{
"$ref": "#/components/schemas/ContractedVolumeConfiguration"
},
{
"$ref": "#/components/schemas/DelayerDays"
},
{
"$ref": "#/components/schemas/GuaranteeOfOriginConfiguration"
},
{
"$ref": "#/components/schemas/LatePaymentFees"
},
{
"$ref": "#/components/schemas/MinimumContractLength"
},
{
"$ref": "#/components/schemas/PaysByDirectDebitTerm"
},
{
"$ref": "#/components/schemas/ProductRateOverrideConfiguration"
},
{
"$ref": "#/components/schemas/PromotionAssignmentTerm"
},
{
"$ref": "#/components/schemas/RateGroupEligibilityConfiguration"
},
{
"$ref": "#/components/schemas/TaxAdjustmentConfiguration"
},
{
"$ref": "#/components/schemas/TerminationFee"
}
]New
{
"x-enum-descriptions": {
"AE": "AE",
"AM": "AM",
"AP": "AP",
"AQ": "AQ",
"AT": "AT",
"AZ": "AZ",
"BE": "BE",
"BR": "BR",
"BU": "BU",
"CB": "CB",
"CE": "CE",
"DA": "DA",
"DM": "DM",
"DR": "DR",
"EA": "EA",
"EI": "EI",
"GE": "GE",
"GO": "GO",
"HO": "HO",
"ID": "ID",
"IS": "IS",
"KA": "KA",
"KL": "KL",
"KR": "KR",
"LL": "LL",
"LO": "LO",
"LR": "LR",
"MI": "MI",
"NA": "NA",
"NR": "NR",
"NY": "NY",
"OR": "OR",
"OS": "OS",
"PF": "PF",
"RB": "RB",
"RT": "RT",
"RW": "RW",
"SR": "SR",
"SV": "SV",
"TI": "TI",
"TJ": "TJ",
"TL": "TL",
"VE": "VE",
"VL": "VL",
"VY": "VY",
"ZA": "ZA"
}
}Old
{
"x-enum-descriptions": {}
}
No attributes to display
Old
{
"DELAYER_DAYS": "#/components/schemas/DelayerDays",
"BILL_DUE_DATE": "#/components/schemas/BillDueDate",
"TERMINATION_FEE": "#/components/schemas/TerminationFee",
"CONTRACT_METADATA": "#/components/schemas/ContractMetaData",
"LATE_PAYMENT_FEES": "#/components/schemas/LatePaymentFees",
"ISSUANCE_FREQUENCY": "#/components/schemas/BillingDocumentIssuanceFrequencyTerm",
"COLLATERAL_REQUIRED": "#/components/schemas/CollateralRequired",
"PAYS_BY_DIRECT_DEBIT": "#/components/schemas/PaysByDirectDebitTerm",
"PROMOTION_ASSIGNMENT": "#/components/schemas/PromotionAssignmentTerm",
"RATE_GROUP_ELIGIBILITY": "#/components/schemas/RateGroupEligibilityConfiguration",
"CHARACTERISTIC_OVERRIDE": "#/components/schemas/CharacteristicOverrideConfiguration",
"MINIMUM_CONTRACT_LENGTH": "#/components/schemas/MinimumContractLength",
"BESPOKE_RATE_CONFIGURATION": "#/components/schemas/BespokeRateConfiguration",
"TAX_ADJUSTMENT_CONFIGURATION": "#/components/schemas/TaxAdjustmentConfiguration",
"PRODUCT_RATE_OVERRIDE_SCHEDULE": "#/components/schemas/ProductRateOverrideConfiguration",
"CONTRACTED_VOLUME_CONFIGURATION": "#/components/schemas/ContractedVolumeConfiguration",
"GUARANTEE_OF_ORIGIN_CONFIGURATION": "#/components/schemas/GuaranteeOfOriginConfiguration"
}Old
[
{
"$ref": "#/components/schemas/BespokeRateConfiguration"
},
{
"$ref": "#/components/schemas/BillDueDate"
},
{
"$ref": "#/components/schemas/BillingDocumentIssuanceFrequencyTerm"
},
{
"$ref": "#/components/schemas/CharacteristicOverrideConfiguration"
},
{
"$ref": "#/components/schemas/CollateralRequired"
},
{
"$ref": "#/components/schemas/ContractMetaData"
},
{
"$ref": "#/components/schemas/ContractedVolumeConfiguration"
},
{
"$ref": "#/components/schemas/DelayerDays"
},
{
"$ref": "#/components/schemas/GuaranteeOfOriginConfiguration"
},
{
"$ref": "#/components/schemas/LatePaymentFees"
},
{
"$ref": "#/components/schemas/MinimumContractLength"
},
{
"$ref": "#/components/schemas/PaysByDirectDebitTerm"
},
{
"$ref": "#/components/schemas/ProductRateOverrideConfiguration"
},
{
"$ref": "#/components/schemas/PromotionAssignmentTerm"
},
{
"$ref": "#/components/schemas/RateGroupEligibilityConfiguration"
},
{
"$ref": "#/components/schemas/TaxAdjustmentConfiguration"
},
{
"$ref": "#/components/schemas/TerminationFee"
}
]New
{
"x-enum-descriptions": {}
}Old
{
"x-enum-descriptions": {
"AE": "AE",
"AM": "AM",
"AP": "AP",
"AQ": "AQ",
"AT": "AT",
"AZ": "AZ",
"BE": "BE",
"BR": "BR",
"BU": "BU",
"CB": "CB",
"CE": "CE",
"DA": "DA",
"DM": "DM",
"DR": "DR",
"EA": "EA",
"EI": "EI",
"GE": "GE",
"GO": "GO",
"HO": "HO",
"ID": "ID",
"IS": "IS",
"KA": "KA",
"KL": "KL",
"KR": "KR",
"LL": "LL",
"LO": "LO",
"LR": "LR",
"MI": "MI",
"NA": "NA",
"NR": "NR",
"NY": "NY",
"OR": "OR",
"OS": "OS",
"PF": "PF",
"RB": "RB",
"RT": "RT",
"RW": "RW",
"SR": "SR",
"SV": "SV",
"TI": "TI",
"TJ": "TJ",
"TL": "TL",
"VE": "VE",
"VL": "VL",
"VY": "VY",
"ZA": "ZA"
}
}
No attributes to display
4 March 2026
New
{
"DELAYER_DAYS": "#/components/schemas/DelayerDays",
"BILL_DUE_DATE": "#/components/schemas/BillDueDate",
"TERMINATION_FEE": "#/components/schemas/TerminationFee",
"CONTRACT_METADATA": "#/components/schemas/ContractMetaData",
"LATE_PAYMENT_FEES": "#/components/schemas/LatePaymentFees",
"ISSUANCE_FREQUENCY": "#/components/schemas/BillingDocumentIssuanceFrequencyTerm",
"COLLATERAL_REQUIRED": "#/components/schemas/CollateralRequired",
"PAYS_BY_DIRECT_DEBIT": "#/components/schemas/PaysByDirectDebitTerm",
"PROMOTION_ASSIGNMENT": "#/components/schemas/PromotionAssignmentTerm",
"RATE_GROUP_ELIGIBILITY": "#/components/schemas/RateGroupEligibilityConfiguration",
"CHARACTERISTIC_OVERRIDE": "#/components/schemas/CharacteristicOverrideConfiguration",
"MINIMUM_CONTRACT_LENGTH": "#/components/schemas/MinimumContractLength",
"BESPOKE_RATE_CONFIGURATION": "#/components/schemas/BespokeRateConfiguration",
"TAX_ADJUSTMENT_CONFIGURATION": "#/components/schemas/TaxAdjustmentConfiguration",
"PRODUCT_RATE_OVERRIDE_SCHEDULE": "#/components/schemas/ProductRateOverrideConfiguration",
"CONTRACTED_VOLUME_CONFIGURATION": "#/components/schemas/ContractedVolumeConfiguration",
"GUARANTEE_OF_ORIGIN_CONFIGURATION": "#/components/schemas/GuaranteeOfOriginConfiguration"
}New
[
{
"$ref": "#/components/schemas/BespokeRateConfiguration"
},
{
"$ref": "#/components/schemas/BillDueDate"
},
{
"$ref": "#/components/schemas/BillingDocumentIssuanceFrequencyTerm"
},
{
"$ref": "#/components/schemas/CharacteristicOverrideConfiguration"
},
{
"$ref": "#/components/schemas/CollateralRequired"
},
{
"$ref": "#/components/schemas/ContractMetaData"
},
{
"$ref": "#/components/schemas/ContractedVolumeConfiguration"
},
{
"$ref": "#/components/schemas/DelayerDays"
},
{
"$ref": "#/components/schemas/GuaranteeOfOriginConfiguration"
},
{
"$ref": "#/components/schemas/LatePaymentFees"
},
{
"$ref": "#/components/schemas/MinimumContractLength"
},
{
"$ref": "#/components/schemas/PaysByDirectDebitTerm"
},
{
"$ref": "#/components/schemas/ProductRateOverrideConfiguration"
},
{
"$ref": "#/components/schemas/PromotionAssignmentTerm"
},
{
"$ref": "#/components/schemas/RateGroupEligibilityConfiguration"
},
{
"$ref": "#/components/schemas/TaxAdjustmentConfiguration"
},
{
"$ref": "#/components/schemas/TerminationFee"
}
]New
{
"x-enum-descriptions": {
"DIRECT": "DIRECT",
"DIRECTA__SELF": "DIRECTA__SELF",
"DIRECTA__SELF__DIRECTO": "DIRECTA__SELF__DIRECTO"
}
}Old
{
"x-enum-descriptions": {
"DIRECTA__DIRECT": "DIRECTA__DIRECT"
}
}
No attributes to display
New
{
"x-enum-descriptions": {
"DIRECT": "DIRECT",
"DIRECTA__SELF": "DIRECTA -> SELF",
"DIRECTA__SELF__DIRECTO": "DIRECTA -> SELF -> DIRECTO"
}
}Old
{
"x-enum-descriptions": {
"DIRECTA__DIRECT": "DIRECTA -> DIRECT"
}
}New
{
"x-enum-descriptions": {
"DIRECT": "DIRECT",
"DIRECTA__SELF": "DIRECTA -> SELF",
"DIRECTA__SELF__DIRECTO": "DIRECTA -> SELF -> DIRECTO"
}
}Old
{
"x-enum-descriptions": {
"DIRECTA__DIRECT": "DIRECTA -> DIRECT"
}
}New
{
"x-enum-descriptions": {}
}Old
{
"x-enum-descriptions": {
"SELF": "SELF",
"DIRECTO": "DIRECTO"
}
}New
{
"x-enum-descriptions": {}
}Old
{
"x-enum-descriptions": {
"SELF": "SELF",
"DIRECTO": "DIRECTO"
}
}New
{
"x-enum-descriptions": {}
}Old
{
"x-enum-descriptions": {
"SELF": "SELF",
"DIRECTO": "DIRECTO"
}
}New
{
"x-enum-descriptions": {
"AE": "AE",
"AM": "AM",
"AP": "AP",
"AQ": "AQ",
"AT": "AT",
"AZ": "AZ",
"BE": "BE",
"BR": "BR",
"BU": "BU",
"CB": "CB",
"CE": "CE",
"DA": "DA",
"DM": "DM",
"DR": "DR",
"EA": "EA",
"EI": "EI",
"GE": "GE",
"GO": "GO",
"HO": "HO",
"ID": "ID",
"IS": "IS",
"KA": "KA",
"KL": "KL",
"KR": "KR",
"LL": "LL",
"LO": "LO",
"LR": "LR",
"MI": "MI",
"NA": "NA",
"NR": "NR",
"NY": "NY",
"OR": "OR",
"OS": "OS",
"PF": "PF",
"RB": "RB",
"RT": "RT",
"RW": "RW",
"SR": "SR",
"SV": "SV",
"TI": "TI",
"TJ": "TJ",
"TL": "TL",
"VE": "VE",
"VL": "VL",
"VY": "VY",
"ZA": "ZA"
}
}Old
{
"x-enum-descriptions": {}
}3 March 2026
New
{
"x-enum-descriptions": {
"SELF": "SELF",
"BROKER": "BROKER",
"DIRECTO": "DIRECTO",
"AFFILIATE": "AFFILIATE",
"ACQUISITION": "ACQUISITION",
"PARTNERSHIPS": "PARTNERSHIPS",
"DIGI_TELESALES": "DIGI_TELESALES"
}
}Old
{
"x-enum-descriptions": {
"INDIRECTA": "INDIRECTA",
"DIRECTA__ASSITED": "DIRECTA__ASSITED",
"DIRECTA__ALIANZAS": "DIRECTA__ALIANZAS",
"DIRECTA__TELESALES": "DIRECTA__TELESALES",
"INDIRECTA__TRADICIONAL": "INDIRECTA__TRADICIONAL",
"DIRECTA__DIRECT__SELFWEB": "DIRECTA__DIRECT__SELFWEB",
"DIRECTA__ASSITED__ASSITED": "DIRECTA__ASSITED__ASSITED",
"DIRECTA__TELESALES__WINBACK": "DIRECTA__TELESALES__WINBACK",
"DIRECTA__TELESALES__OLD_WINDBACK": "DIRECTA__TELESALES__OLD_WINDBACK",
"DIRECTA__ALIANZAS__CAMBIO_CARTERA": "DIRECTA__ALIANZAS__CAMBIO_CARTERA",
"DIRECTA__DIRECT__ENERGYSPECIALIST": "DIRECTA__DIRECT__ENERGYSPECIALIST",
"DIRECTA__TELESALES__CROSS_SELLING": "DIRECTA__TELESALES__CROSS_SELLING",
"DIRECTA__TELESALES__OUTBOUND_EXITO": "DIRECTA__TELESALES__OUTBOUND_EXITO",
"DIRECTA__TELESALES__OUTBOUND_MIXTO": "DIRECTA__TELESALES__OUTBOUND_MIXTO",
"DIRECTA__TELESALES__CROSS_SELLING__LEON": "DIRECTA__TELESALES__CROSS_SELLING__LEON",
"DIRECTA__DIRECT__ENERGYSPECIALIST__SANTANDER": "DIRECTA__DIRECT__ENERGYSPECIALIST__SANTANDER"
}
}New
{
"x-enum-descriptions": {
"SELF": "SELF",
"BROKER": "BROKER",
"DIRECTO": "DIRECTO",
"AFFILIATE": "AFFILIATE",
"ACQUISITION": "ACQUISITION",
"PARTNERSHIPS": "PARTNERSHIPS",
"DIGI_TELESALES": "DIGI TELESALES"
}
}Old
{
"x-enum-descriptions": {
"INDIRECTA": "INDIRECTA",
"DIRECTA__ASSITED": "DIRECTA -> ASSITED",
"DIRECTA__ALIANZAS": "DIRECTA -> ALIANZAS",
"DIRECTA__TELESALES": "DIRECTA -> TELESALES",
"INDIRECTA__TRADICIONAL": "INDIRECTA -> TRADICIONAL",
"DIRECTA__DIRECT__SELFWEB": "DIRECTA -> DIRECT -> SelfWeb",
"DIRECTA__ASSITED__ASSITED": "DIRECTA -> ASSITED -> ASSITED",
"DIRECTA__TELESALES__WINBACK": "DIRECTA -> TELESALES -> WINBACK",
"DIRECTA__TELESALES__OLD_WINDBACK": "DIRECTA -> TELESALES -> OLD WINDBACK",
"DIRECTA__ALIANZAS__CAMBIO_CARTERA": "DIRECTA -> ALIANZAS -> CAMBIO CARTERA",
"DIRECTA__DIRECT__ENERGYSPECIALIST": "DIRECTA -> DIRECT -> EnergySpecialist",
"DIRECTA__TELESALES__CROSS_SELLING": "DIRECTA -> TELESALES -> CROSS SELLING",
"DIRECTA__TELESALES__OUTBOUND_EXITO": "DIRECTA -> TELESALES -> OUTBOUND EXITO",
"DIRECTA__TELESALES__OUTBOUND_MIXTO": "DIRECTA -> TELESALES -> OUTBOUND MIXTO",
"DIRECTA__TELESALES__CROSS_SELLING__LEON": "DIRECTA -> TELESALES -> CROSS SELLING -> LEON",
"DIRECTA__DIRECT__ENERGYSPECIALIST__SANTANDER": "DIRECTA -> DIRECT -> EnergySpecialist -> Santander"
}
}New
{
"x-enum-descriptions": {
"SELF": "SELF",
"BROKER": "BROKER",
"DIRECTO": "DIRECTO",
"AFFILIATE": "AFFILIATE",
"ACQUISITION": "ACQUISITION",
"PARTNERSHIPS": "PARTNERSHIPS",
"DIGI_TELESALES": "DIGI TELESALES"
}
}Old
{
"x-enum-descriptions": {
"INDIRECTA": "INDIRECTA",
"DIRECTA__ASSITED": "DIRECTA -> ASSITED",
"DIRECTA__ALIANZAS": "DIRECTA -> ALIANZAS",
"DIRECTA__TELESALES": "DIRECTA -> TELESALES",
"INDIRECTA__TRADICIONAL": "INDIRECTA -> TRADICIONAL",
"DIRECTA__DIRECT__SELFWEB": "DIRECTA -> DIRECT -> SelfWeb",
"DIRECTA__ASSITED__ASSITED": "DIRECTA -> ASSITED -> ASSITED",
"DIRECTA__TELESALES__WINBACK": "DIRECTA -> TELESALES -> WINBACK",
"DIRECTA__TELESALES__OLD_WINDBACK": "DIRECTA -> TELESALES -> OLD WINDBACK",
"DIRECTA__ALIANZAS__CAMBIO_CARTERA": "DIRECTA -> ALIANZAS -> CAMBIO CARTERA",
"DIRECTA__DIRECT__ENERGYSPECIALIST": "DIRECTA -> DIRECT -> EnergySpecialist",
"DIRECTA__TELESALES__CROSS_SELLING": "DIRECTA -> TELESALES -> CROSS SELLING",
"DIRECTA__TELESALES__OUTBOUND_EXITO": "DIRECTA -> TELESALES -> OUTBOUND EXITO",
"DIRECTA__TELESALES__OUTBOUND_MIXTO": "DIRECTA -> TELESALES -> OUTBOUND MIXTO",
"DIRECTA__TELESALES__CROSS_SELLING__LEON": "DIRECTA -> TELESALES -> CROSS SELLING -> LEON",
"DIRECTA__DIRECT__ENERGYSPECIALIST__SANTANDER": "DIRECTA -> DIRECT -> EnergySpecialist -> Santander"
}
}New
{
"x-enum-descriptions": {
"ATENCIONES_COMERCIALES": "ATENCIONES_COMERCIALES"
}
}Old
{
"x-enum-descriptions": {
"COMM_ATTENTIONS": "COMM_ATTENTIONS"
}
}New
{
"x-enum-descriptions": {
"GASTOS_DEUDA": "GASTOS_DEUDA"
}
}Old
{
"x-enum-descriptions": {
"DEBT_EXPENSES": "DEBT_EXPENSES"
}
}2 March 2026
New
{
"x-enum-descriptions": {
"DIRECTA__TELESALES__CROSS_SELLING__LEON": "DIRECTA__TELESALES__CROSS_SELLING__LEON"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"DIRECTA__TELESALES__CROSS_SELLING__LEON": "DIRECTA -> TELESALES -> CROSS SELLING -> LEON"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"COMP_EXCEDENTES": "COMP_EXCEDENTES"
}
}Old
{
"x-enum-descriptions": {
"COMP_EXEDENTES": "COMP_EXEDENTES"
}
}New
{
"x-enum-descriptions": {
"DIRECTA__TELESALES__CROSS_SELLING__LEON": "DIRECTA -> TELESALES -> CROSS SELLING -> LEON"
}
}Old
{
"x-enum-descriptions": {}
}27 February 2026
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"
]
}
]
}26 February 2026
New
{
"items": {
"$ref": "#/components/schemas/EspLedgerRecordWithTransactions"
}
}Old
{
"items": {
"$ref": "#/components/schemas/EspLedgerRecordWithBillingDocuments"
}
}24 February 2026
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 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 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 ledger identifiers are known",
"description": "Validate ledger identifiers are among supply point identifiers.",
"possible_errors": [
"unknown_ledger_identifiers"
]
},
{
"name": "Validate identifiers are unique in ledgers",
"description": "Validate identifier is not declared twice in ledgers.",
"possible_errors": [
"duplicate_identifiers_entries_found"
]
},
{
"name": "Validate agreements cover last statement closing date",
"description": "Validate that there is an agreement for each supply point covering each ledger's <code>last_statement_closing_date</code>.",
"possible_errors": [
"no_agreement_covering_last_statement_closing_date"
]
},
{
"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 company number provided for business account",
"description": "Validate that a business account has company number provided.",
"possible_errors": [
"company_number_required_for_business_account"
]
}
]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 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 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 ledger identifiers are known",
"description": "Validate ledger identifiers are among supply point identifiers.",
"possible_errors": [
"unknown_ledger_identifiers"
]
},
{
"name": "Validate identifiers are unique in ledgers",
"description": "Validate identifier is not declared twice in ledgers.",
"possible_errors": [
"duplicate_identifiers_entries_found"
]
},
{
"name": "Validate agreements cover last statement closing date",
"description": "Validate that there is an agreement for each supply point covering each ledger's <code>last_statement_closing_date</code>.",
"possible_errors": [
"no_agreement_covering_last_statement_closing_date"
]
},
{
"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 company number provided for business account",
"description": "Validate that a business account has company number provided.",
"possible_errors": [
"company_number_required_for_business_account"
]
}
]New
{
"x-enum-descriptions": {
"INDIRECTA": "INDIRECTA",
"DIRECTA__ASSITED": "DIRECTA__ASSITED",
"DIRECTA__ALIANZAS": "DIRECTA__ALIANZAS",
"INDIRECTA__TRADICIONAL": "INDIRECTA__TRADICIONAL",
"DIRECTA__ASSITED__ASSITED": "DIRECTA__ASSITED__ASSITED",
"DIRECTA__TELESALES__WINBACK": "DIRECTA__TELESALES__WINBACK",
"DIRECTA__TELESALES__OLD_WINDBACK": "DIRECTA__TELESALES__OLD_WINDBACK",
"DIRECTA__ALIANZAS__CAMBIO_CARTERA": "DIRECTA__ALIANZAS__CAMBIO_CARTERA",
"DIRECTA__TELESALES__CROSS_SELLING": "DIRECTA__TELESALES__CROSS_SELLING",
"DIRECTA__TELESALES__OUTBOUND_MIXTO": "DIRECTA__TELESALES__OUTBOUND_MIXTO"
}
}Old
{
"x-enum-descriptions": {
"PLENITUDE": "PLENITUDE",
"ACQUISITION": "ACQUISITION",
"PROPRIETARY": "PROPRIETARY",
"PROPRIETARY__BROKERS": "PROPRIETARY__BROKERS",
"PROPRIETARY__TELESALES": "PROPRIETARY__TELESALES",
"PROPRIETARY__DIGITAL_SELF": "PROPRIETARY__DIGITAL_SELF",
"PLENITUDE__CUSTOMER_PORTAL": "PLENITUDE__CUSTOMER_PORTAL",
"PROPRIETARY__DIGITAL_ASSISTED": "PROPRIETARY__DIGITAL_ASSISTED"
}
}New
{
"x-enum-descriptions": {
"INDIRECTA": "INDIRECTA",
"DIRECTA__ASSITED": "DIRECTA -> ASSITED",
"DIRECTA__ALIANZAS": "DIRECTA -> ALIANZAS",
"INDIRECTA__TRADICIONAL": "INDIRECTA -> TRADICIONAL",
"DIRECTA__ASSITED__ASSITED": "DIRECTA -> ASSITED -> ASSITED",
"DIRECTA__TELESALES__WINBACK": "DIRECTA -> TELESALES -> WINBACK",
"DIRECTA__TELESALES__OLD_WINDBACK": "DIRECTA -> TELESALES -> OLD WINDBACK",
"DIRECTA__ALIANZAS__CAMBIO_CARTERA": "DIRECTA -> ALIANZAS -> CAMBIO CARTERA",
"DIRECTA__TELESALES__CROSS_SELLING": "DIRECTA -> TELESALES -> CROSS SELLING",
"DIRECTA__TELESALES__OUTBOUND_MIXTO": "DIRECTA -> TELESALES -> OUTBOUND MIXTO"
}
}Old
{
"x-enum-descriptions": {
"PLENITUDE": "Plenitude",
"ACQUISITION": "ACQUISITION",
"PROPRIETARY": "Proprietary",
"PROPRIETARY__BROKERS": "Proprietary -> Brokers",
"PROPRIETARY__TELESALES": "Proprietary -> Telesales",
"PROPRIETARY__DIGITAL_SELF": "Proprietary -> Digital Self",
"PLENITUDE__CUSTOMER_PORTAL": "Plenitude -> Customer Portal",
"PROPRIETARY__DIGITAL_ASSISTED": "Proprietary -> Digital Assisted"
}
}New
{
"x-enum-descriptions": {
"INDIRECTA": "INDIRECTA",
"DIRECTA__ASSITED": "DIRECTA -> ASSITED",
"DIRECTA__ALIANZAS": "DIRECTA -> ALIANZAS",
"INDIRECTA__TRADICIONAL": "INDIRECTA -> TRADICIONAL",
"DIRECTA__ASSITED__ASSITED": "DIRECTA -> ASSITED -> ASSITED",
"DIRECTA__TELESALES__WINBACK": "DIRECTA -> TELESALES -> WINBACK",
"DIRECTA__TELESALES__OLD_WINDBACK": "DIRECTA -> TELESALES -> OLD WINDBACK",
"DIRECTA__ALIANZAS__CAMBIO_CARTERA": "DIRECTA -> ALIANZAS -> CAMBIO CARTERA",
"DIRECTA__TELESALES__CROSS_SELLING": "DIRECTA -> TELESALES -> CROSS SELLING",
"DIRECTA__TELESALES__OUTBOUND_MIXTO": "DIRECTA -> TELESALES -> OUTBOUND MIXTO"
}
}Old
{
"x-enum-descriptions": {
"PLENITUDE": "Plenitude",
"ACQUISITION": "ACQUISITION",
"PROPRIETARY": "Proprietary",
"PROPRIETARY__BROKERS": "Proprietary -> Brokers",
"PROPRIETARY__TELESALES": "Proprietary -> Telesales",
"PROPRIETARY__DIGITAL_SELF": "Proprietary -> Digital Self",
"PLENITUDE__CUSTOMER_PORTAL": "Plenitude -> Customer Portal",
"PROPRIETARY__DIGITAL_ASSISTED": "Proprietary -> Digital Assisted"
}
}New
{
"x-enum-descriptions": {
"DIRECTA__TELESALES": "DIRECTA__TELESALES",
"DIRECTA__TELESALES__OUTBOUND_EXITO": "DIRECTA__TELESALES__OUTBOUND_EXITO"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"DIRECTA__TELESALES": "DIRECTA -> TELESALES",
"DIRECTA__TELESALES__OUTBOUND_EXITO": "DIRECTA -> TELESALES -> OUTBOUND EXITO"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"DIRECTA__TELESALES": "DIRECTA -> TELESALES",
"DIRECTA__TELESALES__OUTBOUND_EXITO": "DIRECTA -> TELESALES -> OUTBOUND EXITO"
}
}Old
{
"x-enum-descriptions": {}
}18 February 2026
Old
{
"x-validators": [
{
"name": "Validate line item periods",
"description": "Validate that no line items overlap (checked per supply point, product, and rate band combination) or have gaps (checked per supply point only) in supply charge transactions.",
"possible_errors": [
"zero_length_periods",
"gaps_or_overlaps_in_periods"
]
}
]
}Old
{
"x-validators": [
{
"name": "Validate line item periods",
"description": "Validate that no line items overlap (checked per supply point, product, and rate band combination) or have gaps (checked per supply point only) in supply charge transactions.",
"possible_errors": [
"zero_length_periods",
"gaps_or_overlaps_in_periods"
]
}
]
}New
[
{
"name": "Validate that current statement transactions are after the last statement closing date",
"description": "Validate that all <code>current_statement_transactions</code>, if provided, are after the <code>last_statement_closing_date</code>, if this date is given.",
"possible_errors": [
"current_statement_transaction_before_last_statement_closing_date"
]
},
{
"name": "Validate that there are no current statement transactions for unbillable ledger",
"description": "Validate that transactions for ledgers that will never issue any bills are only in <code>historical_statement_transactions</code>.",
"possible_errors": [
"unbillable_ledger_transactions_in_current_statement_transactions"
]
},
{
"name": "Validate unique transaction IDs",
"description": "Validate that all transaction IDs provided are unique.",
"possible_errors": [
"duplicate_transaction_ids",
"missing_transaction_id"
]
},
{
"name": "Validate billing document type matches provided historical billing documents' type",
"description": "Validate that the provided <code>billing_document_type</code> matches the type of all provided historical billing documents.",
"possible_errors": [
"billing_document_type_does_not_match_historical_billing_documents_type"
]
},
{
"name": "Validate that the sum of all transactions matches the ledger balance",
"description": "Validate that the sum of all transactions in <code>historical_billing_documents</code> plus <code>current_statement_transactions</code> plus <code>additional_historical_transactions</code> equals the <code>ledger_balance</code>.",
"possible_errors": [
"historical_billing_documents_balance_mismatch"
]
},
{
"name": "Validate line item periods in all transactions",
"description": "Validate that no line items overlap (checked per supply point, product, and rate band combination) or have gaps (checked per supply point only) for all supply charge transactions in <code>historical_billing_documents</code> and <code>additional_historical_transactions</code>.",
"possible_errors": [
"gaps_or_overlaps_in_periods"
]
}
]Old
[
{
"name": "Validate that current statement transactions are after the last statement closing date",
"description": "Validate that all <code>current_statement_transactions</code>, if provided, are after the <code>last_statement_closing_date</code>, if this date is given.",
"possible_errors": [
"current_statement_transaction_before_last_statement_closing_date"
]
},
{
"name": "Validate that there are no current statement transactions for unbillable ledger",
"description": "Validate that transactions for ledgers that will never issue any bills are only in <code>historical_statement_transactions</code>.",
"possible_errors": [
"unbillable_ledger_transactions_in_current_statement_transactions"
]
},
{
"name": "Validate unique transaction IDs",
"description": "Validate that all transaction IDs provided are unique.",
"possible_errors": [
"duplicate_transaction_ids",
"missing_transaction_id"
]
},
{
"name": "Validate billing document type matches provided historical billing documents' type",
"description": "Validate that the provided <code>billing_document_type</code> matches the type of all provided historical billing documents.",
"possible_errors": [
"billing_document_type_does_not_match_historical_billing_documents_type"
]
},
{
"name": "Validate that the sum of all transactions matches the ledger balance",
"description": "Validate that the sum of all transactions in <code>historical_billing_documents</code> plus <code>current_statement_transactions</code> plus <code>additional_historical_transactions</code> equals the <code>ledger_balance</code>.",
"possible_errors": [
"historical_billing_documents_balance_mismatch"
]
}
]Old
{
"x-validators": [
{
"name": "Validate line item periods",
"description": "Validate that no line items overlap (checked per supply point, product, and rate band combination) or have gaps (checked per supply point only) in supply charge transactions.",
"possible_errors": [
"zero_length_periods",
"gaps_or_overlaps_in_periods"
]
}
]
}New
{
"x-validators": [
{
"name": "Validate line item periods",
"description": "Validate that no line items overlap (checked per supply point, product, and rate band combination) or have gaps (checked per supply point only) in supply charge transactions.",
"possible_errors": [
"gaps_or_overlaps_in_periods"
]
}
]
}Old
{
"x-validators": [
{
"name": "Validate line item periods",
"description": "Validate that no line items overlap (checked per supply point, product, and rate band combination) or have gaps (checked per supply point only) in supply charge transactions.",
"possible_errors": [
"zero_length_periods",
"gaps_or_overlaps_in_periods"
]
}
]
}17 February 2026
No attributes to display
No attributes to display
16 February 2026
New
{
"x-enum-descriptions": {
"last_dunning_step": "Ultima etapa Dunning"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Ultima etapa Dunning": "Ultima etapa Dunning"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"disconnect_eligible": "Candidato Corte"
}
}Old
{
"x-enum-descriptions": {}
}New
{
"x-enum-descriptions": {
"Candidato Corte": "Candidato Corte"
}
}Old
{
"x-enum-descriptions": {}
}13 February 2026
Use instead
consents
12 February 2026
New
{
"x-enum-descriptions": {
"cataluna": "CATALUNA",
"vulnerable": "Vulnerable"
}
}Old
{
"x-enum-descriptions": {
"ict_test": "ICT Test",
"test_p_f": "Test Pte Finan,",
"sva_activo": "SVA - Activo"
}
}New
{
"x-enum-descriptions": {
"CATALUNA": "CATALUNA",
"Vulnerable": "Vulnerable"
}
}Old
{
"x-enum-descriptions": {
"ICT Test": "ICT Test",
"SVA - Activo": "SVA - Activo",
"Test Pte Finan,": "Test Pte Finan,"
}
}