> For the complete documentation index, see [llms.txt](https://docs.myrspoven.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.myrspoven.com/myrspoven-docs/myrspoven-docs-pl/podlacz-swoj-budynek/energy-data/manual-upload.md).

# Ręczne przesyłanie

Większość danych dotyczących energii trafia do Myrspoven automatycznie — z systemu BMS, od zewnętrznego dostawcy energii lub bezpośrednio z liczników. Jeśli automatyczne przesyłanie danych nie jest możliwe, możesz zamiast tego przesłać dane dotyczące energii ręcznie.

## Kiedy korzystać z ręcznego przesyłania

Najczęstsze powody ręcznego przesyłania danych:

* Nie masz możliwości udostępniania danych dotyczących energii za pośrednictwem kanału automatycznego.
* Korzystasz z usług zewnętrznego dostawcy energii, z którym Myrspoven obecnie się nie integruje. Zobacz [Prośba o nową integrację z zewnętrznym dostawcą](https://docs.myrspoven.com/myrspoven-docs/myrspoven-docs-pl/podlacz-swoj-budynek/energy-data.md#requesting-a-new-third-party-integration) jeśli chcesz, abyśmy obsługiwali nowego dostawcę.
* Dane historyczne zostały skorygowane lub przeskalowane — na przykład jednostki zmieniono z megawatów (MW) na kilowaty (kW). W takim przypadku wcześniej przesłane dane będą wyświetlane z innymi wartościami liczbowymi (1 MW = 1000 kW).
* W pewnym okresie brakuje danych, które należy uzupełnić.

## Jak są obsługiwane przesłane dane

Przesłane przez Ciebie dane są traktowane jako **najdokładniejsze i najbardziej aktualne źródło** dla danego sygnału.

Jeśli prześlesz dane za okres, dla którego w systemie są już dostępne dane, istniejące wartości z tego okresu zostaną automatycznie zastąpione nowymi. System zawsze będzie odzwierciedlać najnowsze wiarygodne dane, które udostępnisz — nie trzeba ręcznie scalać danych. Jeśli masz dwa odrębne przedziały czasowe, w których dane należy zaktualizować, musisz przesłać je w dwóch osobnych partiach, aby uniknąć utraty danych z okresu pomiędzy nimi.

## Obsługiwany format danych

Minimalna struktura przesyłanego pliku obejmuje dwie kolumny:

1. **Znacznik czasu**
2. **Wartość energii**

System automatycznie przelicza jednostki, gdy jednostki w przesłanych danych różnią się od tych zapisanych dla sygnału — na przykład gdy dane są przesyłane w kWh, a sygnał zapisano w MWh. Jeśli przeliczenie nie jest możliwe (na przykład z powodu niezgodności wymiarów), podczas przesyłania otrzymasz powiadomienie, a przesyłanie zostanie odrzucone.

{% hint style="info" %}
Instrukcje dostępne w aplikacji są nadrzędne. Formularz przesyłania w BackOffice zawiera szczegółowe wskazówki dotyczące dokładnego formatu pliku i wymaganych pól. Jeśli informacje na tej stronie różnią się od tych widocznych w formularzu przesyłania, postępuj zgodnie z formularzem — jest on zawsze najbardziej aktualny.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.myrspoven.com/myrspoven-docs/myrspoven-docs-pl/podlacz-swoj-budynek/energy-data/manual-upload.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
