Create a new invoice

POST

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

Last modified:2026-01-13 10:32:48

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.

Access via Access token, with the source accessibility determined by the permissions of the customer associated with the token and the Login token scopes used to obtain it

Request

Authorization

JWT Bearer

Add the parameter

Authorization

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

Example:

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

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 2026-01-13 10:32:48

Meter