Customer Migrations Guide: Post Business Import

After a business has successfully been created you might need to import additional data. In this section we’ll walk you through the various endpoints you can use to add information to an imported business in Kraken.

Importing business contracts
Importing payment instructions for business

Importing business contracts

Use this endpoint to add contracts to a business.

POST https://api.eonnext-kraken.energy/v1/data-import/business-contracts/create/

The following responses may be returned from the API.

Status code	Description
`201 - Created`	If the payload is valid, a `201 Created` response will be returned containing the `identifier` of the created business contracts. For example: `{ "business_contracts": [ { "identifier": "123-12345" }, { "identifier": "456-12346" } ] }`
`400 - Bad Request`	The post business import endpoint does both validation and creation, so you will receive: If there are validation errors, a `400 Bad Request` response will be returned, detailing the errors. To resolve the error, refer to the field definitions and validation rules. If there are creation errors, a `400 Bad Request` response will be returned, detailing the errors. To resolve these errors, correct the data mentioned in the error messages.
`404 - Not Found`	If a business is not found, then a `404 Not Found` response will be returned. To resolve the error, check that the business has been imported (not just staged) and that the `import_supplier_code` and `external_business_identifier` in the request are correct.
`500 - Internal Server Error`	If an unexpected error occurs, a `500 Internal Server Error` response will be returned.

{
    "import_supplier_code": "TENTACLE_ENERGY",
    "external_business_identifier": "EXTERNAL-1234",
    "business_contracts": [
        {
            "valid_from_date": "2023-01-01",
            "signed_at_date": "2023-01-01",
            "versions": [
                {
                    "applicable_at_date": "2023-01-01",
                    "terms": []
                }
            ],
            "identifier": "ABC"
        }
    ]
}

Importing payment instructions for business

Use this endpoint to create a payment instruction for a business.

POST https://api.eonnext-kraken.energy/v1/data-import/business-payment-instruction/create/

The following responses may be returned from the API.

Status code	Description
`201 - Created`	If the payload is valid, a `201 Created` response will be returned containing the Kraken account number and the reference. For example: `{ "reference": "abc-defg", "external_business_identifier": "external-123343243" }`
`400 - Bad Request`	If there are validation errors, a `400 Bad Request` response will be returned, detailing the errors. To resolve the error, refer to the field definitions and validation rules. This error can be returned if we have persistent issues communicating with the upstream payment vendor (we call their API to verify the instruction exists, and retrieve the details to store in Kraken). In this case, the request should not be retried in its current form.
`401 - Unauthorized`	If there are authorization errors, a `401 Unauthorized` response will be returned. To resolve the error, ensure that authorization token is provided and valid.
`500 - Internal Server Error`	If an unexpected error occurs, a `500 Internal Server Error` response will be returned. This error can be returned if we have intermittent issues communicating with the upstream payment vendor (we call their API to verify the instruction exists, and retrieve the details to store in Kraken). In this case, the request should be retried as-is.

{
    "import_supplier_code": "TENTACLE_UTILITIES",
    "external_business_identifier": "EXTERNAL-1234",
    "vendor": "STRIPE",
    "reference": "THIS-IS-A-FAKE-REFERENCE",
    "type": "CARD",
    "accounts": [
        {
            "external_account_number": "EXTERNAL-ACCOUNT-123"
        },
        {
            "external_account_number": "EXTERNAL-ACCOUNT-1234"
        }
    ]
}

EONnext

Customer Migrations Guide: Post Business Import

API Endpoints

Importing business contracts

Overview

Schema

Responses

Payloads

Example payload