Najczęściej zadawane pytania
Odpowiedzi o pierwszych krokach, danych, płatnościach i prywatności. Nie znajdujesz tego, czego szukasz? Napisz na support@codepile.dev.
Pierwsze kroki
Jak uzyskać klucz API?
Załóż konto, utwórz organizację i wygeneruj klucz w panelu — zajmuje to kilka sekund. Wysyłaj klucz jako token Bearer w nagłówku Authorization każdego zapytania. Zobacz dokumentację, aby wykonać pierwsze wywołanie.
Czy do startu potrzebuję karty płatniczej?
Nie. Darmowy plan nie wymaga karty i pozwala od razu wykonywać wywołania. Dane płatności dodajesz dopiero, gdy zdecydujesz się na wyższy plan.
Czy potrzebuję SDK?
Nie. Stawka to zwykłe API REST z endpointami tylko do odczytu (GET) — wystarczy cokolwiek, co mówi po HTTP. Nie ma żadnego SDK do instalacji.
Co potrafi API?
Zwraca stawki VAT dla wszystkich 27 krajów UE, dzienne referencyjne kursy euro EBC oraz walidację numerów VAT w VIES w czasie rzeczywistym, a także dziennik zmian stawek i webhooki. Limity dla każdego planu znajdziesz w cenniku.
Dane i dokładność
Skąd pochodzą dane?
Stawki VAT pochodzą z bazy Komisji Europejskiej Taxes in Europe Database (TEDB), kursy walut z Europejskiego Banku Centralnego, a sprawdzanie numerów VAT odpytuje oficjalny unijny serwis VIES w czasie rzeczywistym. Te źródła pierwotne ujednolicamy w jeden spójny schemat.
Jak aktualne są dane?
Stawki śledzimy na bieżąco i aktualizujemy, gdy tylko państwo członkowskie je zmieni. Możesz pobrać najnowsze stawki, stawki obowiązujące w dowolnym dniu z przeszłości, odczytać dziennik zmian albo zasubskrybować podpisany webhook wyzwalany w momencie zmiany stawki.
Czy mogę polegać na danych przy rozliczeniach podatkowych?
Dane udostępniamy wyłącznie informacyjnie i nie są one poradą podatkową, prawną ani księgową. Dokładamy starań o ich dokładność, ale nie gwarantujemy kompletności ani aktualności — to Ty odpowiadasz za ich weryfikację przed wykorzystaniem. Zobacz sekcję 4 Regulaminu.
Czy mogę pobrać stawki historyczne?
Tak. Endpointy są adresowane po dacie, więc możesz pobrać dokładne stawki VAT lub kursy obowiązujące w dowolnym dniu z przeszłości — przydatne do audytów i faktur wstecznych.
Płatności i plany
Jak działają płatności?
Plany płatne rozliczane są z góry — miesięcznie lub rocznie (przy rocznej 2 miesiące gratis) — przez Stripe. Ceny wyświetlają się w Twojej walucie (PLN lub EUR). Zobacz cennik.
Jak zmienić plan na wyższy lub niższy?
Zmień plan na stronie Płatności w panelu organizacji. Wyższy plan zaczyna obowiązywać w ciągu minuty, gdy API odświeży cache; aby obniżyć plan, zarządzaj subskrypcją w Portalu Klienta.
Jak anulować? Czy są zwroty?
Możesz anulować w dowolnej chwili w Portalu Klienta; anulowanie wchodzi w życie z końcem bieżącego okresu rozliczeniowego, a do tego czasu zachowujesz dostęp. Poza przypadkami wymaganymi prawem opłacone kwoty nie podlegają zwrotowi za niepełne okresy.
Czy ceny zawierają VAT?
Ceny podawane są bez VAT, jeśli ma on zastosowanie; VAT jest doliczany według obowiązującej stawki przy płatności na podstawie Twoich danych.
Bezpieczeństwo i prywatność
Jak przechowywane są moje klucze API?
Wyłącznie jako nieodwracalne skróty SHA-256 — nigdy w postaci jawnej. Klucz pokazujemy raz, przy tworzeniu; potem nie możemy go odzyskać, więc zamiast tego go odnawiasz lub wycofujesz. Możesz też ograniczyć klucz do konkretnych źródeł (Origin) z przeglądarki.
Jakie dane osobowe zbieracie?
Imię i e-mail (przez logowanie Google), dane sesji/techniczne, metadane kluczy API, logi użycia oraz dane rozliczeniowe obsługiwane przez Stripe. Pełne informacje znajdziesz w Polityce prywatności.
Czy Usługa jest zgodna z RODO?
Tak. Jesteśmy administratorem z siedzibą w Polsce i przetwarzamy dane zgodnie z RODO, udostępniając je wyłącznie podmiotom niezbędnym do działania Stawki (Cloudflare, Stripe, Google). Podstawy prawne, okresy przechowywania i Twoje prawa opisuje Polityka prywatności.
Jak usunąć konto i dane?
Usuń organizację i konto w panelu albo napisz do nas na support@codepile.dev. Usuwamy lub anonimizujemy Twoje dane w rozsądnym terminie, z wyjątkiem dokumentacji, którą musimy przechowywać z mocy prawa (np. fakturowej).
Jak uzyskać wsparcie?
Napisz na support@codepile.dev. Plany płatne obejmują wsparcie e-mail i priorytetowe; staramy się odpowiadać tak szybko, jak to możliwe.