20 marca, 2023

KSeF, A-Cube PL API – FAQ

Featured image for “KSeF, A-Cube PL API – FAQ”
  1. Czym jest A-Cube ?
    A-Cube Srl to włoska firma będąca pionierem i potentatem na rynku włoskim w zakresie e-fakturowania. Firma działa na tamtejszym rynku od 2019 roku i w tym czasie ich rozwiązania pomogły przetworzyć ponad 20 milionów faktur w komunikacji B2G. Firma wkracza na kolejne rynki w UE oraz wszędzie tam gdzie pojawia się konieczność wdrożenia e-fakturowania.
  1. Czym jest A-Cube PL API
    A-Cube PL API to oprogramowanie pozwalające na integrację dowolnego systemu z KSeF (Krajowy System e-Faktur).

  2. Co to jest REST API
    REST (Representational State Transfer) to typ architektury oprogramowania i zestaw ograniczeń, które zwykle stosuje się do usług sieciowych. REST-API (Interfejs Programowania Aplikacji) to zestaw zasad i protokołów do budowy i interakcji z usługami sieciowymi, które przestrzegają styl architektoniczny REST. W skrócie, REST-API pozwala stronie internetowej lub aplikacji na komunikowanie się z serwerem i żądanie od niego informacji lub wysyłanie do niego informacji, przy użyciu protokołu HTTP.

  3. Co to jest KSeF
    KSeF, czyli Krajowy System e-Faktur, to centralna baza danych faktur. Jest to system teleinformatyczny administrowany przez Krajową Administrację Skarbową, który służy do wystawiania i odbierania faktur ustrukturyzowanych. Działa od 1 stycznia 2022 roku i obecnie jest dobrowolny, ale w przyszłości ma być obowiązkowy. Ministerstwo Finansów poinformowało, że zostało to zatwierdzone przez Komisję Europejską. Według wcześniejszych zapowiedzi, Krajowy System e-Faktur ma stać się obowiązkowy od 1 lipca 2024 roku. Z tego powodu, zaleca się przygotowanie się na obowiązek korzystania z systemu już teraz.
  1. Czym różni się efaktura i faktura ustrukturyzowana?
    Faktura elektroniczna to dokument w formie elektronicznej wystawiony i otrzymany w dowolnym formacie elektronicznym. Faktura ustrukturyzowana natomiast to nowy typ faktury, który jest wystawiany przy użyciu Krajowego Systemu e-Faktur, i ma przydzielony numer identyfikujący go w tym systemie. Faktura ustrukturyzowana jest wystawiona zgodnie z określonym w przepisach wzorem, za pomocą zintegrowanego oprogramowania współpracującego z KSeF i zawiera wszelkie elementy, jakie wymaga ustawa o VAT w stosunku do faktur.

  2. Czy faktura ustrukturyzowana w Polsce jest to obowiązkowa?
    Faktura ustrukturyzowana jest nowym typem faktury, która od 1 stycznia 2022 roku jest dopuszczona do obrotu gospodarczego. Została wprowadzona jako część szerszych zmian podatkowych pod hasłem SLIM VAT 2 i od 1 stycznia 2024 roku będzie obowiązkowa dla wszystkich podmiotów w Polsce.

  3. Kto jest idealnym klientem waszego produktu?
    A-Cube API to idealne rozwiązanie dla firm i organizacji, które chcą usprawnić proces fakturowania elektronicznego i wymiany dokumentów cyfrowych z KSeF. Korzystając z naszego gotowego API, można zaoszczędzić cenny czas i zmniejszyć koszty projektu, eliminując konieczność tworzenia i utrzymywania złożonej infrastruktury w chmurze. Nasze rozwiązanie sprawdzi się w firmach pracujących nad integracją systemów z KSeF, platform tworzących własne rozwiązania, software house’ów budujących dedykowane rozwiązania dla swoich klientów, a nawet firm posiadających złożone i unikalne narzędzia, w których modyfikacje są kosztowne lub niemożliwe. A-Cube API można wykorzystać jako rozszerzenie całej infrastruktury, dzięki czemu jest to perfekcyjny wybór również dla firm audytorskich i księgowych. 
    • Wspólny mianownik zastosowania ACube PL API dla uzyskanej wartości to:
      • wykorzystanie gotowego API
      • redukcja czasu na stworzenie całego rozwiązania
      • redukcja kosztów projektu
      • eliminacja tworzenia i utrzymania złożonej infrastruktury w chmurze

    • Docelowym klientem dla zastosowania A-Cube PL API są m.in.
      • Firmy pracujące nad integracją systemów z KSeF w szeroko pojętym spektrum.
      • Platformy rozwijające własne rozwiązania i automatyzujące procesy związane z obszarem księgowości, kosztów, monitoringiem faktur, BI.
      • Software House budujące dedykowane rozwiązania dla swoich klientów.
      • Firmy posiadające złożone i unikalne rozwiązania gdzie modyfikacje są kosztowne lub nawet niemożliwe. ACube PL API może być w takim przypadku rozszerzeniem całej infrastruktury
      • Firmy audytorskie
      • Firmy księgowe
  1. Dlaczego korzystne jest wdrożenie A-Cube PL API
    Wdrożenie naszego rozwiązania pomoże zaoszczędzić czas potrzebny na zbudowanie całego projektu od zera. Dzięki zastosowaniu A-Cube PL API zredukowane zostaną koszty potrzebne na stworzenie zespołu programistycznego oraz skalowalną infrastrukturę. Nasz produkt jest gotowy do użycia i wypełnia lukę pomiędzy systemem klienta a KSeF.

  2. Ile czasu trwa wdrożenie rozwiązania od A-Cube?
    Zależy to od stopnia złożoności systemu klienta. Do pełnego wdrożenia potrzebne są 4 elementy. Autentykacja, Faktury, Integracja + Webooki. W przypadku naszych pierwszych early-adoptersów wdrożenie zajęło maksymalnie 7 dni. Dodatkowo. A-Cube przygotowało szczegółową dokumentację REST API oraz gotowe SDK, które można wykorzystać we własnym systemie.

  3. Mam system księgowy, e-commerce lub ERP w którym są zapewnione funkcjonalności wysyłki faktur do KSeF. Po co mi wasze rozwiązanie?
    Prawdopodobnie masz już własny system księgowy czy nawet ERP do obsługi firmy i dostawca tych narzędzi zapewnia integrację z KSeF. Nasze rozwiązanie może być używane równolegle do istniejących systemów lub rozszerzające je w kontekście brakujących funkcjonalności. Dodatkowo, nasze API będzie idealne do zastosowania wszędzie tam gdzie konieczne jest powiązanie kilku idei, systemów w nowy produkt wymagający integracji faktur z KSeF.

  4. Czy API sprawdza poprawność faktury?
    Tak. W momencie otrzymania faktury w formacie XML lub JSON, A-Cube PL API sprawdza zgodność ze schemą rządową i jeżeli wystąpi błąd walidacji – zwrócony zostanie on do wysyłającego systemu. Taka faktura nie zostanie przekazana do KSeF.

  5. Czy A-Cube PL API obsługuje faktury sprzedażowe?
    Tak. Wszystkie faktury wystawione przez Twoją firmę są widoczne w KSeF oraz będą synchronizowane do Twojego systemu od dowolnej daty.

  6. Czy A-Cube PL API obsługuje faktury zakupowe?
    Tak. Wszystkie faktury zakupowe wystawione na Twoją firmę są widoczne w KSeF oraz będą synchronizowane do Twojego systemu od dowolnej daty.

  7. Czy KSeF wyśle mi powiadomienie o nowej fakturze?
    Nie. KSeF nie posiada takiej funkcjonalności i prawdopodobnie nie zostanie ona wdrożona. W A-Cube PL API zbudowaliśmy własny system powiadomień o nowych fakturach w KSeF. A-Cube PL API przekazuje wiadomości (tzw. webhooks) z informacjami o fakturze do Twojego systemu na odpowiednio skonfigurowany adres URL.

  8. Czy KSeF pozwala na wysyłkę załączników?
    Nie. KSeF nie posiada takiej funkcjonalności i prawdopodobnie nie zostanie ona wdrożona. W A-Cube PL API zbudowaliśmy własny system załączników do faktury, dzięki czemu możliwe jest wysłanie ich wraz z fakturą. Załączniki są przechowywane w chmurze A-Cube i mogą być dostępne dla odbiorcy i nadawcy faktury po uprzednim jednorazowym autoryzowaniu się w systemie A-Cube.

  9. Czy KSeF zawiera informacje o płatnościach za fakturę?
    Nie. Taka funkcjonalność być może zostanie wdrożone w późniejszym czasie. A-Cube posiada rozwiązania w zakresie Open Banking i jest możliwe wdrożenie rozwiązania dzięki któemu faktury będa powiązane z płatnościami bezpośrednio z konta bankowego. Niektórzy nasi partnerzy stosują już własne rozszerzenia oparte na A-Cube PL API aby wstawiać dodatkowe informacje na temat np własnie płatności czy procesowania faktury we własnym systemie.

  10. Czy KSeF pobierze mi stare faktury?
    Tak. Po rejestracji w systemie A-Cube i uruchomieniu integracji, system automatycznie rozpocznie synchronizację faktur od daty rejestracji. Możliwe jest ustawienie daty wcześniejszej od której pobrane zostaną faktury. Minimalna data to 1.01.2022.

  11. Czy otrzymam UPO dla faktur?
    Tak ale tylko w przypadku faktur wysłanych do KSeF poprzez A-Cube PL API. Jest to ograniczenie techniczne nałożone przez KSeF i nie da się pozyskać UPO za pomocą naszego API do faktur wprowadzonych do KSeF w inny sposób.

  12. Z jakimi językami programowania jest zgodne A-Cube PL API?
    Nasze rozwiązanie napisane jest w języku PHP. Należy jednak rozmieć, że REST (Representational State Transfer) API jest architekturą oprogramowania, która pozwala na komunikację między różnymi systemami przez HTTP (Hypertext Transfer Protocol). W przypadku REST API, ważniejsze niż język, w jakim jest napisane oprogramowanie, jest to, że spełnia ono określone zasady i protokoły, takie jak użycie metod HTTP (np. GET, POST, PUT itd.) oraz formatowanie danych w formacie JSON.

    Dlatego, jeśli system spełnia te wymagania, jest w stanie wykonywać żądania i odpowiadać na nie za pomocą endpointów API, niezależnie od tego, jakim językiem jest napisany. Oznacza to, że REST API może być łatwo integrowane z różnymi systemami, niezależnie od ich języka programowania czy platformy.
  1. Czy udostępniacie tutorial jak użyć waszego systemu do integracji?
    Tak. Mamy dokumentację API oraz tutorial jak również gotowe komponenty, usprawniające proces integracji z KSeF.
    Dokumentacja: https://docs.acubeapi.com/documentation/gov-pl
    Tutorial: https://github.com/a-cube-io/gov-pl-ksef-tutorial
    SDK: PHP + Inne języki

  2. Czy A-Cube udostępnia SDK?|
    Tak
  1. Jaka jest wydajność systemu A-Cube?
    Jeśli chodzi o ograniczenia techniczne w KSeF, to nasz system jest w stanie obsłużyć teoretycznie maksymalnie 1,2 mln dziennie dla faktur wychodzących i 1.2 mln dla faktur przychodzących dla każdego numeru NIP.

    Nasza infrastruktura jest w stanie obsłużyć duże ilości i przeciążenia, dostosowując swoje zasoby w razie potrzeby. Sam KSeF jest wg deklaracji ze strony rządowej, w stanie obsłużyć do 100 mln faktur na dobę. Nie jest na tą chwilę jasne jak będzie wyglądać rzeczywista wydajność KSeF.

Nasze Usługi

API E-Fakturowanie Polska
API E-Fakturowanie Włochy
API Otwarta Bankowość
PEPPOL