Customer Migrations Guide: Account Import

By now you should be prepared to go ahead and migrate an account, so let’s get stuck in.

In this section we’ll guide you step by step through the process of validating, staging and creating an account, and what kind of responses you can expect to receive.

API Endpoints

Validate account

Overview

Use this endpoint to validate account data before staging and creating an account.

The endpoint accepts a JSON payload containing an object representing a single account.

Schema

Loading...
POST https://api.oeg-kraken.energy/v1/data-import/validate-account/

Responses

The following responses may be returned from the API.

Status codeDescription
200 - OK

If the payload is valid, a 200 OK response will be returned with the validated data as its body.

400 - Bad Request

If there are validation errors, a 400 Bad Request response will be returned detailing the errors. To resolve these errors, refer to the field definitions and validation rules. Here's an example response:

{ "detail": "Could not validate account data.", "code": "account_failed_validation", "errors": [ { "detail": "abcde is not a valid phone number", "code": "invalid_phone_number", "attr": "customers.0.landline" } ] }

For more detail on validation error responses see here.

Payloads

Example payload
{ "external_account_number": "EXTERNAL-1234", "import_supplier": "TENTACLE_ENERGY", "unknown_occupier": false, "customers": [ { "given_name": "Johann", "family_name": "Goethe", "email": "g.goethe@polymath.com", "mobile": "+491741721223", "landline": "", "date_of_birth": "1997-07-26", "title": "Herr", "salutation": "Hallo", "customer_preferences": { "opted_into_sms": true, "opted_into_recommended": true, "opted_into_updates": true, "opted_into_third_parties": true, "opted_into_offers": true, "is_user_psr_consent_obtained": true } } ], "billing_address1": "Fast an der Alster", "billing_address2": "66", "billing_address3": "a", "billing_address4": "Hamburg", "billing_postcode": "20099", "sales_channel": "DIRECT", "sales_subchannel": "Website", "supply_addresses": [ { "supply_address1": "An der Elbe", "supply_address2": "2", "supply_address3": "", "supply_address4": "Jork", "supply_postcode": "21635", "customer_at_supply_address_from_date": "2022-01-01", "supply_points": [ { "identifier": "50203829715", "agreements": [ { "effective_from": "2022-01-01", "effective_to": "2023-01-01", "agreed_at": "2022-01-01T10:00:00Z", "product_code": "GAS_PRODUCT", "sign_up_reward": { "amount": "100.00", "scheme_name": "SAMPLE100" }, "params": { "annual_consumption": "12349", "network_operator_number": "9870075000009", "unit_rate_per_kwh": "0.1025", "net_unit_rate_per_kwh": "0.0830", "monthly_standing_charge": "8.76", "net_monthly_standing_charge": "7.10", "total_estimated_annual_bill_in_euros": "1370.89", "network_charges": {} } } ], "supply_type": "GAS", "supply_start_date": "2021-01-01", "supply_end_date": "2023-01-01", "supply_start_type": "MOVE_IN", "melos": [ { "melo_number": "DE700146823190123456789ABCDEFGHIJ", "meters": [ { "meter_number": "G123456", "meter_type": "EHZ", "meter_size": "B4", "converter_type": "DMU", "metering_direction": "ERZ", "reading_transmission_type": "AMR", "tariff_count": "ETZ", "active_from": "2021-01-01T00:00:00Z", "active_to": null, "registers": [ { "obis_code": "1-0:1.8.0", "digits": 4, "decimal_places": 2, "is_relevant_for_billing": true, "low_load_compatibility": "Z60", "active_from": "2021-01-01T00:00:00Z", "active_to": null, "readings": [ { "status": "SAVED", "value": "1234.02", "type_of_read": "INTERIM", "origin": "NETWORK_OPERATOR", "qualifier": "READ", "read_at": "2021-05-13T02:00:00+02:00", "is_transfer_reading": false } ] } ], "conversion_factors": [ { "active_from_date": "2021-01-01", "active_to_date": "2025-01-01", "calorific_value": "11.524", "condition_value": "0.9309" } ] } ] } ], "previous_supplier_id": "1234567890123", "last_billed_to_date": "2022-01-01", "balancing_periods": [ { "valid_from": "2021-01-01T00:00:00", "valid_to": null, "balancing_groups": [ "THE0BFH032240000" ] } ], "transfer_readings": [ { "value": "1234.02", "origin": "METER_OPERATOR", "read_at": "2021-05-13T02:00:00+02:00", "is_estimate": false, "meter_number": "G123456" } ], "meter_operators": [ { "code": "1234567890123", "valid_from": "2021-01-01T00:00:00Z", "valid_to": "2022-01-01T00:00:00Z" } ], "network_operators": [ { "code": "9870075000009", "valid_from": "2021-01-01T00:00:00Z", "valid_to": "2022-01-01T00:00:00Z" } ], "transmission_system_operators": [ { "code": "1234567890123", "valid_from": "2021-01-01T00:00:00Z", "valid_to": "2022-01-01T00:00:00Z" } ], "gas_supply_point_load_profiles": [ { "valid_from": "2021-01-01T00:00:00", "valid_to": null, "tum_kundenwert": "52.76", "jahresmenge_kwh": "12349", "marktgebiet": "293", "profilname": "R14", "bilanzierungsverfahren": "E01", "druckebene": "Y01", "gas_quality": "Y04", "prognosegrundlage": "ZC0", "fallgruppenzuordnung": "GABi-RLMmT", "netznutzungsvertrag_type": "Z08", "netznutzungszahlung": "Z10", "netznutzungsabrechnungsvariante": "Z15", "tagesparameter_type": "Z99", "tagesparameter_location": "103761", "tagesparameter_provider": "ZT3", "bilanzkreis": "11X0-0000-0665-E" } ] }, { "identifier": "60203829716", "agreements": [ { "effective_from": "2022-01-01", "effective_to": "2023-01-01", "agreed_at": "2022-01-01T10:00:00Z", "product_code": "ELECTRICITY_PRODUCT", "sign_up_reward": { "amount": "100.00", "scheme_name": "SAMPLE100" }, "params": { "annual_consumption": "3000", "annual_nighttime_usage": "382", "network_operator_number": "9900750000006", "unit_rate_per_kwh": "0.3595", "net_unit_rate_per_kwh": "0.2912", "night_unit_rate_per_kwh": "0.273", "net_night_unit_rate_per_kwh": "0.2211", "monthly_standing_charge": "10.76", "net_monthly_standing_charge": "8.72", "total_estimated_annual_bill_in_euros": "1311.91", "network_charges": { "total_network_charges_per_year": "281.21", "eeg_charge_annual": "195.0" } } } ], "supply_type": "ELECTRICITY", "supply_start_date": "2021-01-01", "supply_end_date": "2023-01-01", "supply_start_type": "MOVE_IN", "melos": [ { "melo_number": "DE700146823190123456789KLMNOPQRST", "meters": [ { "meter_number": "E123456", "meter_type": "EHZ", "converter_type": "MIW", "metering_direction": "ERZ", "conversion_factor": "0.123", "reading_transmission_type": "AMR", "tariff_count": "ETZ", "active_from": "2021-01-01T00:00:00Z", "active_to": null, "registers": [ { "obis_code": "1-0:1.8.0", "digits": 4, "decimal_places": 2, "is_relevant_for_billing": true, "low_load_compatibility": "Z60", "active_from": "2021-01-01T00:00:00Z", "active_to": null, "readings": [ { "status": "SAVED", "value": "1234.02", "type_of_read": "INTERIM", "origin": "NETWORK_OPERATOR", "qualifier": "READ", "read_at": "2021-05-13T02:00:00+02:00", "is_transfer_reading": false } ], "smgw_configurations": [ { "configuration_id": "123456", "valid_from": "2021-01-01T00:00:00Z" } ] } ], "electricity_meter_gateways": [ { "number": "456321", "communication_method": "LTE", "valid_from": "2021-01-01T00:00:00Z", "valid_to": null } ] } ] } ], "previous_supplier_id": "0454567890121", "last_billed_to_date": "2022-01-01", "balancing_periods": [ { "valid_from": "2021-01-01T00:00:00", "valid_to": null, "balancing_groups": [ "11X0-0000-0665-E" ] } ], "transfer_readings": [ { "value": "9876.03", "origin": "KRAKEN", "read_at": "2021-05-13T02:00:00+02:00", "is_estimate": true, "meter_number": "E123456", "register_type": null } ], "electricity_supply_point_load_profiles": [ { "valid_from": "2021-01-01T00:00:00", "valid_to": null, "bilanzierungsgebiet": "10YDE-TENTACLE-H", "regelzone": "10YAT-APG------L", "aggregationsverantwortung": "ZA8", "lieferrichtung": "Z07", "prognosegrundlage_werte_profile": "ZA6", "prognosegrundlage_slp_tlp": "E14", "slp_profilname": "H0", "slp_bilanzierungsverfahren": "Z10", "slp_jvp_kwh": "1000", "tlp_profilname": "S12", "tlp_bilanzierungsverfahren": "E01", "tlp_profilschar": "SP1", "tlp_jvp_spezifische_arbeit_265_kwhk": "0.42", "tlp_jvp_angepasste_elektrische_arbeit_z08_kwh": "1.2", "tlp_klima_temperatur_typ": "Z99", "tlp_klima_temperatur_kennzeichnung": "NL MKW1", "tlp_klima_temperatur_codeliste": "ZT1", "tlp_klima_temperatur_codepflege": "293", "smgw_wahlrecht": false, "smgw_wahlrecht_grund_ablehnung": "bla", "summenzeitreihentyp": "SLS_TLS", "bilanzkreis": "11X0-0000-0665-E", "spannungsebene": "E03", "umspannung": "E07", "abwicklungsmodell": "ZE9" } ] } ] } ], "transfer_balance": "0.00", "references": [ { "namespace": "tentacle-energy.client-reference-number", "value": "1234567890" } ], "statements": [ { "bill_period_from_date": "2021-01-01", "bill_period_to_date": "2022-01-01", "statement_path": "EXTERNAL-1234/2021-01-01-to-2022-01-01-electricity.pdf", "statement_id": "1", "supply_type": "ELECTRICITY" }, { "bill_period_from_date": "2021-01-01", "bill_period_to_date": "2022-01-01", "statement_path": "EXTERNAL-1234/2021-01-01-to-2022-01-01-gas.pdf", "statement_id": "2", "supply_type": "GAS" } ], "ledgers": [ { "identifiers": [ "50203829715" ], "ledger_code": "GAS_LEDGER", "last_statement_closing_date": "2022-01-01", "last_statement_balance": "-10.00", "ledger_balance": "20.00", "current_statement_transactions": [ { "transaction_id": "1", "transaction_date": "2022-03-01", "amount": "10.00", "type": "REPAYMENT", "reason": "PARTIAL_CREDIT_REFUND", "payment_type": "DIRECT_CREDIT" }, { "transaction_id": "2", "transaction_date": "2022-03-02", "amount": "20.00", "type": "PAYMENT", "reason": "ACCOUNT_CHARGE_PAYMENT", "payment_type": "DD_FIRST_COLLECTION" }, { "transaction_id": "3", "transaction_date": "2022-03-03", "amount": "20.00", "type": "CREDIT", "reason": "CUSTOMER_SERVICE_GESTURE" } ] }, { "identifiers": [ "60203829716" ], "ledger_code": "ELECTRICITY_LEDGER", "last_statement_closing_date": "2022-01-01", "last_statement_balance": "10.00", "ledger_balance": "45.00", "current_statement_transactions": [ { "transaction_id": "4", "transaction_date": "2022-02-01", "amount": "5.00", "type": "REPAYMENT", "reason": "FULL_PREPAYMENT_REFUND", "payment_type": "DIRECT_CREDIT" }, { "transaction_id": "6", "transaction_date": "2022-02-02", "amount": "15.00", "type": "PAYMENT", "reason": "ACCOUNT_CHARGE_PAYMENT", "payment_type": "DD_FIRST_COLLECTION" }, { "transaction_id": "7", "transaction_date": "2022-02-03", "amount": "25.00", "type": "CREDIT", "reason": "BALANCE_ADJUSTMENT" } ] } ], "payment_instructions": [ { "vendor": "GOCARDLESS", "reference": "MD01235CE7A0YNT", "type": "DIRECT_DEBIT", "ledger_code": "GAS_LEDGER", "valid_from": "2022-01-01", "bank_account": { "account_holder": "John Doe", "account_number": "123456789", "iban": "GB82WEST12345698765431" } } ], "payment_schedules": [ { "amount": 20.0, "ledger_code": "GAS_LEDGER", "day_of_month": 5, "frequency": "MONTHLY", "means": "DD", "start_date": "2022-01-01" }, { "amount": 20.0, "ledger_code": "ELECTRICITY_LEDGER", "day_of_month": 5, "frequency": "MONTHLY", "means": "MANUAL", "start_date": "2022-01-01" } ], "account_campaigns": [ { "slug": "super_account", "campaign_note": "Campaign note" } ], "metadata": [ { "key": "metadata_key", "value": { "some_data": "some_value" } } ], "notes": [ { "created_at": "2018-10-10T10:20:00Z", "body": "This is a note", "is_pinned": true } ] }

Stage account

Overview

Use this endpoint to stage account data before creating an account. As the name suggests, this endpoint stores the data in Kraken but does not create an account from the data. Staged account data can be updated as many times as you like before an account is created.

Just as with the validation endpoint, this one accepts a JSON payload containing an object representing a single account.

Before an account is staged, it is validated according to the same rules as the validate endpoint above. This is an extra safety check to make sure nothing has changed between creating the data and submitting it for staging in Kraken.

Schema

Loading...
POST https://api.oeg-kraken.energy/v1/data-import/account-import-process/create-or-update/

Responses

The following responses may be returned from the API.

docs--rest--api-guides--data-import--account-creation-guide--staging--api-responses--html
Status codeDescription

Payloads

Example payload
{ "external_account_number": "EXTERNAL-1234", "import_supplier": "TENTACLE_ENERGY", "unknown_occupier": false, "customers": [ { "given_name": "Johann", "family_name": "Goethe", "email": "g.goethe@polymath.com", "mobile": "+491741721223", "landline": "", "date_of_birth": "1997-07-26", "title": "Herr", "salutation": "Hallo", "customer_preferences": { "opted_into_sms": true, "opted_into_recommended": true, "opted_into_updates": true, "opted_into_third_parties": true, "opted_into_offers": true, "is_user_psr_consent_obtained": true } } ], "billing_address1": "Fast an der Alster", "billing_address2": "66", "billing_address3": "a", "billing_address4": "Hamburg", "billing_postcode": "20099", "sales_channel": "DIRECT", "sales_subchannel": "Website", "supply_addresses": [ { "supply_address1": "An der Elbe", "supply_address2": "2", "supply_address3": "", "supply_address4": "Jork", "supply_postcode": "21635", "customer_at_supply_address_from_date": "2022-01-01", "supply_points": [ { "identifier": "50203829715", "agreements": [ { "effective_from": "2022-01-01", "effective_to": "2023-01-01", "agreed_at": "2022-01-01T10:00:00Z", "product_code": "GAS_PRODUCT", "sign_up_reward": { "amount": "100.00", "scheme_name": "SAMPLE100" }, "params": { "annual_consumption": "12349", "network_operator_number": "9870075000009", "unit_rate_per_kwh": "0.1025", "net_unit_rate_per_kwh": "0.0830", "monthly_standing_charge": "8.76", "net_monthly_standing_charge": "7.10", "total_estimated_annual_bill_in_euros": "1370.89", "network_charges": {} } } ], "supply_type": "GAS", "supply_start_date": "2021-01-01", "supply_end_date": "2023-01-01", "supply_start_type": "MOVE_IN", "melos": [ { "melo_number": "DE700146823190123456789ABCDEFGHIJ", "meters": [ { "meter_number": "G123456", "meter_type": "EHZ", "meter_size": "B4", "converter_type": "DMU", "metering_direction": "ERZ", "reading_transmission_type": "AMR", "tariff_count": "ETZ", "active_from": "2021-01-01T00:00:00Z", "active_to": null, "registers": [ { "obis_code": "1-0:1.8.0", "digits": 4, "decimal_places": 2, "is_relevant_for_billing": true, "low_load_compatibility": "Z60", "active_from": "2021-01-01T00:00:00Z", "active_to": null, "readings": [ { "status": "SAVED", "value": "1234.02", "type_of_read": "INTERIM", "origin": "NETWORK_OPERATOR", "qualifier": "READ", "read_at": "2021-05-13T02:00:00+02:00", "is_transfer_reading": false } ] } ], "conversion_factors": [ { "active_from_date": "2021-01-01", "active_to_date": "2025-01-01", "calorific_value": "11.524", "condition_value": "0.9309" } ] } ] } ], "previous_supplier_id": "1234567890123", "last_billed_to_date": "2022-01-01", "balancing_periods": [ { "valid_from": "2021-01-01T00:00:00", "valid_to": null, "balancing_groups": [ "THE0BFH032240000" ] } ], "transfer_readings": [ { "value": "1234.02", "origin": "METER_OPERATOR", "read_at": "2021-05-13T02:00:00+02:00", "is_estimate": false, "meter_number": "G123456" } ], "meter_operators": [ { "code": "1234567890123", "valid_from": "2021-01-01T00:00:00Z", "valid_to": "2022-01-01T00:00:00Z" } ], "network_operators": [ { "code": "9870075000009", "valid_from": "2021-01-01T00:00:00Z", "valid_to": "2022-01-01T00:00:00Z" } ], "transmission_system_operators": [ { "code": "1234567890123", "valid_from": "2021-01-01T00:00:00Z", "valid_to": "2022-01-01T00:00:00Z" } ], "gas_supply_point_load_profiles": [ { "valid_from": "2021-01-01T00:00:00", "valid_to": null, "tum_kundenwert": "52.76", "jahresmenge_kwh": "12349", "marktgebiet": "293", "profilname": "R14", "bilanzierungsverfahren": "E01", "druckebene": "Y01", "gas_quality": "Y04", "prognosegrundlage": "ZC0", "fallgruppenzuordnung": "GABi-RLMmT", "netznutzungsvertrag_type": "Z08", "netznutzungszahlung": "Z10", "netznutzungsabrechnungsvariante": "Z15", "tagesparameter_type": "Z99", "tagesparameter_location": "103761", "tagesparameter_provider": "ZT3", "bilanzkreis": "11X0-0000-0665-E" } ] }, { "identifier": "60203829716", "agreements": [ { "effective_from": "2022-01-01", "effective_to": "2023-01-01", "agreed_at": "2022-01-01T10:00:00Z", "product_code": "ELECTRICITY_PRODUCT", "sign_up_reward": { "amount": "100.00", "scheme_name": "SAMPLE100" }, "params": { "annual_consumption": "3000", "annual_nighttime_usage": "382", "network_operator_number": "9900750000006", "unit_rate_per_kwh": "0.3595", "net_unit_rate_per_kwh": "0.2912", "night_unit_rate_per_kwh": "0.273", "net_night_unit_rate_per_kwh": "0.2211", "monthly_standing_charge": "10.76", "net_monthly_standing_charge": "8.72", "total_estimated_annual_bill_in_euros": "1311.91", "network_charges": { "total_network_charges_per_year": "281.21", "eeg_charge_annual": "195.0" } } } ], "supply_type": "ELECTRICITY", "supply_start_date": "2021-01-01", "supply_end_date": "2023-01-01", "supply_start_type": "MOVE_IN", "melos": [ { "melo_number": "DE700146823190123456789KLMNOPQRST", "meters": [ { "meter_number": "E123456", "meter_type": "EHZ", "converter_type": "MIW", "metering_direction": "ERZ", "conversion_factor": "0.123", "reading_transmission_type": "AMR", "tariff_count": "ETZ", "active_from": "2021-01-01T00:00:00Z", "active_to": null, "registers": [ { "obis_code": "1-0:1.8.0", "digits": 4, "decimal_places": 2, "is_relevant_for_billing": true, "low_load_compatibility": "Z60", "active_from": "2021-01-01T00:00:00Z", "active_to": null, "readings": [ { "status": "SAVED", "value": "1234.02", "type_of_read": "INTERIM", "origin": "NETWORK_OPERATOR", "qualifier": "READ", "read_at": "2021-05-13T02:00:00+02:00", "is_transfer_reading": false } ], "smgw_configurations": [ { "configuration_id": "123456", "valid_from": "2021-01-01T00:00:00Z" } ] } ], "electricity_meter_gateways": [ { "number": "456321", "communication_method": "LTE", "valid_from": "2021-01-01T00:00:00Z", "valid_to": null } ] } ] } ], "previous_supplier_id": "0454567890121", "last_billed_to_date": "2022-01-01", "balancing_periods": [ { "valid_from": "2021-01-01T00:00:00", "valid_to": null, "balancing_groups": [ "11X0-0000-0665-E" ] } ], "transfer_readings": [ { "value": "9876.03", "origin": "KRAKEN", "read_at": "2021-05-13T02:00:00+02:00", "is_estimate": true, "meter_number": "E123456", "register_type": null } ], "electricity_supply_point_load_profiles": [ { "valid_from": "2021-01-01T00:00:00", "valid_to": null, "bilanzierungsgebiet": "10YDE-TENTACLE-H", "regelzone": "10YAT-APG------L", "aggregationsverantwortung": "ZA8", "lieferrichtung": "Z07", "prognosegrundlage_werte_profile": "ZA6", "prognosegrundlage_slp_tlp": "E14", "slp_profilname": "H0", "slp_bilanzierungsverfahren": "Z10", "slp_jvp_kwh": "1000", "tlp_profilname": "S12", "tlp_bilanzierungsverfahren": "E01", "tlp_profilschar": "SP1", "tlp_jvp_spezifische_arbeit_265_kwhk": "0.42", "tlp_jvp_angepasste_elektrische_arbeit_z08_kwh": "1.2", "tlp_klima_temperatur_typ": "Z99", "tlp_klima_temperatur_kennzeichnung": "NL MKW1", "tlp_klima_temperatur_codeliste": "ZT1", "tlp_klima_temperatur_codepflege": "293", "smgw_wahlrecht": false, "smgw_wahlrecht_grund_ablehnung": "bla", "summenzeitreihentyp": "SLS_TLS", "bilanzkreis": "11X0-0000-0665-E", "spannungsebene": "E03", "umspannung": "E07", "abwicklungsmodell": "ZE9" } ] } ] } ], "transfer_balance": "0.00", "references": [ { "namespace": "tentacle-energy.client-reference-number", "value": "1234567890" } ], "statements": [ { "bill_period_from_date": "2021-01-01", "bill_period_to_date": "2022-01-01", "statement_path": "EXTERNAL-1234/2021-01-01-to-2022-01-01-electricity.pdf", "statement_id": "1", "supply_type": "ELECTRICITY" }, { "bill_period_from_date": "2021-01-01", "bill_period_to_date": "2022-01-01", "statement_path": "EXTERNAL-1234/2021-01-01-to-2022-01-01-gas.pdf", "statement_id": "2", "supply_type": "GAS" } ], "ledgers": [ { "identifiers": [ "50203829715" ], "ledger_code": "GAS_LEDGER", "last_statement_closing_date": "2022-01-01", "last_statement_balance": "-10.00", "ledger_balance": "20.00", "current_statement_transactions": [ { "transaction_id": "1", "transaction_date": "2022-03-01", "amount": "10.00", "type": "REPAYMENT", "reason": "PARTIAL_CREDIT_REFUND", "payment_type": "DIRECT_CREDIT" }, { "transaction_id": "2", "transaction_date": "2022-03-02", "amount": "20.00", "type": "PAYMENT", "reason": "ACCOUNT_CHARGE_PAYMENT", "payment_type": "DD_FIRST_COLLECTION" }, { "transaction_id": "3", "transaction_date": "2022-03-03", "amount": "20.00", "type": "CREDIT", "reason": "CUSTOMER_SERVICE_GESTURE" } ] }, { "identifiers": [ "60203829716" ], "ledger_code": "ELECTRICITY_LEDGER", "last_statement_closing_date": "2022-01-01", "last_statement_balance": "10.00", "ledger_balance": "45.00", "current_statement_transactions": [ { "transaction_id": "4", "transaction_date": "2022-02-01", "amount": "5.00", "type": "REPAYMENT", "reason": "FULL_PREPAYMENT_REFUND", "payment_type": "DIRECT_CREDIT" }, { "transaction_id": "6", "transaction_date": "2022-02-02", "amount": "15.00", "type": "PAYMENT", "reason": "ACCOUNT_CHARGE_PAYMENT", "payment_type": "DD_FIRST_COLLECTION" }, { "transaction_id": "7", "transaction_date": "2022-02-03", "amount": "25.00", "type": "CREDIT", "reason": "BALANCE_ADJUSTMENT" } ] } ], "payment_instructions": [ { "vendor": "GOCARDLESS", "reference": "MD01235CE7A0YNT", "type": "DIRECT_DEBIT", "ledger_code": "GAS_LEDGER", "valid_from": "2022-01-01", "bank_account": { "account_holder": "John Doe", "account_number": "123456789", "iban": "GB82WEST12345698765431" } } ], "payment_schedules": [ { "amount": 20.0, "ledger_code": "GAS_LEDGER", "day_of_month": 5, "frequency": "MONTHLY", "means": "DD", "start_date": "2022-01-01" }, { "amount": 20.0, "ledger_code": "ELECTRICITY_LEDGER", "day_of_month": 5, "frequency": "MONTHLY", "means": "MANUAL", "start_date": "2022-01-01" } ], "account_campaigns": [ { "slug": "super_account", "campaign_note": "Campaign note" } ], "metadata": [ { "key": "metadata_key", "value": { "some_data": "some_value" } } ], "notes": [ { "created_at": "2018-10-10T10:20:00Z", "body": "This is a note", "is_pinned": true } ] }

Create account

Overview

Use this endpoint to process staged account data into an account in Kraken.

The endpoint accepts a JSON payload that contains an object referencing existing staged account data. The operations_team_name that the account should be linked to should also be provided. An optional dry_run field is available to test the account creation process without actually creating the account. This is useful for testing the process to ensure that an account would be created successfully.

The referenced team must already exist in Kraken and the account data must already have been staged.

Schema

Loading...
POST https://api.oeg-kraken.energy/v1/data-import/account-import-process/process/

Responses

The following responses may be returned from the API.

docs--rest--api-guides--data-import--account-creation-guide--creation--api-responses--html
Status codeDescription

Payloads

Example payload
{ "external_account_number": "EXTERNAL-1234", "import_supplier_code": "TENTACLE_ENERGY", "operations_team_name": "A", "dry_run": false }