Przejdź do treści
SiopKA czeka na potwierdzenie typu kasy przez Prezesa GUM. Do tego czasu działa w pilotażu w środowisku testowym Ministerstwa Finansów. Szczegóły

Integracje i API

Podłącz swój system do kasy

SiopKA ma ogólne API kasy. Twoja aplikacja sprzedażowa, system rezerwacji albo dyspozytornia wystawia dokumenty przez kasę klienta, bez pisania własnej kasy fiskalnej.

Dwie drogi

Jak Twój system łączy się z kasą?

Na tym samym telefonie albo jako stanowisko zdalne. Obie drogi kończą się w tej samej kolejce kasy.

Lokalne API kasy 1.3

Aplikacja na tym samym telefonie z Androidem. Wniosek przez system Android (pakiet, identyfikator, certyfikat podpisu), sesja kasjera zatwierdzana na ekranie kasy, szyfrowane połączenie tylko w obrębie telefonu.

Stanowiska zdalne 1.0

System POS, tablet albo serwer partnera wysyła podpisane żądania przez nasz backend do kasy firmy. Parowanie w panelu kodem albo kodem QR, dwustopniowa autoryzacja.

Uprawnienia

Do czego dostaje dostęp integrator?

Do tego, na co zgodzi się administrator kasy, w podziale na zakresy. Wybór z najczęściej używanych:

Wybrane zakresy lokalnego API kasy 1.3
ZakresNa co pozwala
status.readOdczyt gotowości kasy, licencji kasy i jej możliwości.
session.requestProśba o sesję kasjera, zatwierdzana PIN-em na ekranie kasy.
catalog.readOdczyt stawek VAT i katalogu towarów.
receipts.createWystawienie paragonu jednym żądaniem.
sales.openSprzedaż dwuetapowa: otwarcie, operacje, zatwierdzenie albo anulowanie.
sales.taxiStart i zakończenie kursu taxi, tylko dla aplikacji zadeklarowanych w kasie.
operations.readStan własnych operacji i sprzedaży po identyfikatorze żądania.
documents.readStrony zachowanych dokumentów własnej sprzedaży jako obrazy.
output.printWydruk albo wysłanie dokumentu do Siop Printer.
reports.daily.generateRaport dobowy na żądanie.
invoices.requestFaktura do własnego paragonu.
payments.terminalPłatność na terminalu płatniczym kasy; integracja terminala jest poza pilotażem i kasa zgłasza ją jako niedostępną.
Zasady

Jakie zasady obowiązują każdą integrację?

Te same, które chronią kasę przed podwójnym paragonem i utratą dokumentu.

  • Idempotencja: każde żądanie ma własny identyfikator. Powtórzenie tego samego żądania zwraca ten sam wynik, a nie drugi paragon.
  • Wynik nieznany: gdy odpowiedź nie dotarła, najpierw odczytaj stan operacji po identyfikatorze, potem decyduj o ponowieniu.
  • Jasne odmowy: znane odmowy mają własne kody, np. zmiana stawki VAT albo brak katalogu, zanim cokolwiek zostanie zapisane.
  • Kasjer z sesji: kasjer wynika z zatwierdzonej sesji kasy, nigdy z treści żądania.
  • Jedna centralna kasa nie zastąpi wielu: kasa obsługuje kasjerów jednego podatnika, nie wiele niezależnych punktów płatności ani wielu taksówek.
Start

Jak zacząć integrację?

Od rozmowy o scenariuszu. Opis kontraktu przekazujemy po rozmowie, a próby prowadzimy razem w środowisku MF TEST.

  1. Opisz scenariuszBranża, rodzaj integracji (lokalnie albo stanowisko zdalne), dokumenty i zachowanie po utracie połączenia.
  2. Dostajesz kontraktOpis tras, zakresów, kodów odmów i przykładów, z wersją kontraktu.
  3. Testujemy razem w środowisku MF TESTPełna droga dokumentu bez rzeczywistej sprzedaży, także scenariusze błędów i wznowień.

Zacznij od pierwszego paragonu

Kup licencję w sklepie, a instalację wersji pilotażowej uzgodnimy z Tobą po zakupie. Możesz też umówić bezpłatną prezentację: pokażemy kasę, aplikację taxi i panel na Twoim przykładzie.

Ciasteczka niezbędne zapamiętują Twój wybór wyglądu i języka, chronią formularze i utrzymują sesję panelu. Nie wymagają zgody, bo bez nich strona nie zadziała tak, jak o to prosisz.

Niezbędne

Zawsze włączone: wygląd, język, zapis wyboru cookies, ochrona formularzy, sesja panelu.

Ta strona nie używa ciasteczek analitycznych ani reklamowych i nie ładuje narzędzi innych firm do śledzenia.

Przeczytaj politykę cookies