Create a new invoice

POST

https://api.enectiva.cz//meters/{meterIdentification}/invoices/received

Last modified:2025-09-17 10:36:30

This endpoint enables clients to add invoices for energy use to Enectiva. Each invoice is created in a separate HTTP request.

Each invoice must satisfy validation rules:

from and to are date strings in RFC3339 format, the dates are inclusive, invoice ranges for a given meter must not overlap, the whole range must be in the past

cost and consumption are non-negative floats, at least one of them must be provided

note is limited to 255 characters

The required scope is received_invoices.

Request

Authorization

OAuth 2.0

Authorization Code

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Authorize URL: https://app.enectiva.cz/en/api/dashboard

Token URL: /access_tokens

Path Params

Header Params

Body Params application/vnd.api+json

Example

{
    "data": {
        "attributes": {
            "consumption": 734.22,
            "cost": 123.45,
            "from": "2022-07-01",
            "note": "Monthly electricity invoice",
            "to": "2022-07-31"
        },
        "type": "received_invoices"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.enectiva.cz//meters//invoices/received' \
--header 'Accept: application/vnd.api+json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data-raw '{
    "data": {
        "attributes": {
            "consumption": 734.22,
            "cost": 123.45,
            "from": "2022-07-01",
            "note": "Monthly electricity invoice",
            "to": "2022-07-31"
        },
        "type": "received_invoices"
    }
}'

Responses

🟢201Created

application/vnd.api+json

Created

Body

Example

{
    "data": {
        "attributes": {
            "consumption": 734.22,
            "consumption_unit": "kWh",
            "cost": 123.45,
            "currency": "EUR",
            "from": "2022-07-01",
            "note": "Monthly electricity invoice",
            "to": "2022-07-31"
        },
        "id": "022d3385-a109-4ccb-aeb5-b2e547b73e81",
        "type": "received_invoices"
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠406Not Acceptable

🟠409Conflict

🟠415Unsupported Media Type

🟠429Too Many Requests

🔴500Server Error

Modified at 2025-09-17 10:36:30

Meter