Receipt APIZgodne paragony zjedną integracją
Interfejs API PosDealer pozwala użytkownikom zarządzać uprawnieniami, śledzić instalacje i zapewniać zgodne konfiguracje w tysiącach instalacji.
fiskaltrust Receipt API
fiskaltrust Receipt-API to centralny interfejs do zarządzania cyklem życia paragonów. Obejmuje on tworzenie, podpisywanie, wystawianie, transport, pobieranie oraz dostęp na potrzeby audytu w spójny i regulowany sposób. Paragony są traktowane jako podstawowy element systemu, niezależny od kanału, urządzenia lub metody dostawy, i działają tak samo na wszystkich obsługiwanych rynkach.
Interfejs API pozwala skupić się na systemie, podczas gdy fiskaltrust zajmuje się infrastrukturą paragonów. Zamiast tworzyć i utrzymywać formaty specyficzne dla danego kraju, logikę transportu i przypadki brzegowe, można polegać na ujednoliconym, otwartym interfejsie API, który pozostaje stabilny, gdy zmieniają się przepisy i wymagania operacyjne.
Podstawowe funkcjonalności API
Podstawowe funkcjonalności API
- create – tworzy paragon z pozycjami, płatnościami i sumami.
- sign – stosuje krajowe reguły fiskalne, podpisy i łańcuchowanie hash.
- issue – dostarcza paragon w formacie HTML, PDF, z kodem QR lub za pośrednictwem wiadomości e-mail/SMS.
- retrieve – pobieranie paragonów według identyfikatora, numeru referencyjnego zamówienia lub zakresu czasu.
- verify – weryfikuje podpisy i integralność.
- revoke – oznacza paragon jako anulowany lub poprawiony.
- journal – eksport dzienników audytu, zamknięć i raportów.
Kluczowe cechy
- Elastyczność formatu: Możesz otrzymywać paragony w postaci wizualizacji lub surowych danych. Do wyboru są formaty takie jak HTML, PDF, PNG lub JSON.
- Zgodność z przepisami: API zapewnia zgodność paragonów z wymogami prawnymi.
- Szybkość: Użyj POS-API Helper do natychmiastowego przesyłania paragonów. Bez tego pomocnika przesyłanie może trwać do pięciu minut.
- Pobieranie danych: API zapewnia bezpieczny sposób dostępu do danych paragonów. Pozwala to na integrację paragonów z własnymi aplikacjami.
Każda operacja odpowiada etapom cyklu życia paragonu. Paragon jest tworzony na podstawie danych zamówienia i płatności, podpisywany zgodnie z prawem krajowym i wydawany konsumentowi. Można go pobrać w przypadku zwrotów, zweryfikować na potrzeby audytów, cofnąć w przypadku korekty i wyeksportować jako część dziennika. Cały proces jest deterministyczny, z wykrywaniem manipulacji i zgodny z przepisami każdego kraju.
Receipt-API zapewnia odporną podstawę do obsługi paragonów, ułatwiając integrację, zmniejszając złożoność i zapewniając ciągłość biznesową nawet w przypadku awarii drukarek dzięki zgodnemu cyfrowemu rozwiązaniu awaryjnemu.
Dlaczego deweloperzy korzystają z Receipt-API?
API pozwala skupić się na systemie, podczas gdy fiskaltrust zajmuje się infrastrukturą paragonów. Zamiast traktować paragony jako funkcję poboczną lub dodatek dla konsumentów, interfejs Receipt-API obsługuje paragony jako pierwszorzędny, regulowany element systemu. Integrujesz się raz i polegasz na ujednoliconym, otwartym interfejsie API, który jest utrzymywany w miarę ewolucji przepisów i wymagań operacyjnych.
- Open Source: Przejrzysta implementacja bez uzależnienia od dostawcy i pełna możliwość audytu.
- Ujednolicony model paragonów: Jedna struktura danych dla pozycji, płatności, podatków, metadanych, podpisów i stanów cyklu życia.
- Hybrydowa obsługa paragonów: Cyfrowe i papierowe paragony obsługiwane przez ten sam interfejs API, w tym formaty HTML, ESC/POS, PDF i natywne dla urządzenia.
- Obsługa wielu rynków: Te same formaty komunikatów i logika cyklu życia w AT, DE, FR, IT, ES, PT i innych krajach.
- Oddzielona logika zgodności: Reguły fiskalne, formaty i mechanizmy podpisywania ewoluują niezależnie od kodu aplikacji.
- Ciągłość działania: Tworzenie, podpisywanie i wystawianie paragonów pozostaje deterministyczne i niezawodne w scenariuszach sieciowych online, offline i awaryjnych.
- Krótszy czas integracji: Brak konieczności utrzymywania we własnej bazie kodu renderowania paragonów dla poszczególnych krajów, logiki drukowania lub przepływów transportowych.
- Wizualizacja paragonów w zestawie: Znormalizowane, zgodne dokumenty paragonów HTML, które działają na różnych urządzeniach i w różnych systemach operacyjnych.
- Wbudowane kanały transportowe: Dostarczanie paragonów za pośrednictwem kodu QR, adresu URL, wiadomości e-mail, SMS lub przekazania do urządzenia, bez niestandardowej logiki transportu.
Receipt API umożliwia programistom i odsprzedawcom tworzenie spójnej warstwy paragonów omnichannel i udostępnianie danych paragonów jako usługi wielokrotnego użytku.
Paragony stają się bezpiecznym, ustrukturyzowanym źródłem danych, które można ponownie wykorzystać w ramach integracji lojalnościowych, księgowych i zewnętrznych, przekształcając transakcje w rozszerzalne punkty styku z systemem, a nie pojedyncze zdarzenia.
Opcje hostingu
Opcje hostingu
- Usługi lokalne: Windows, Linux, macOS, Android, iOS.
- Centrum danych sprzedawcy: Klastry Kubernetes lub wdrożenie IIS.
- Chmura: Europejskie regiony Azure ze zgodnością z przepisami danego rynku.
- Tryb awaryjny offline: Lokalny broker IoT zapewnia kontynuację operacji na paragonach podczas awarii.
Receipt-API obsługuje elastyczne wdrażanie. Może być wbudowany w POS, uruchomiony jako usługa lokalna, wdrożony na dużą skalę w centrum danych lub używany za pośrednictwem usług chmurowych hostowanych przez fiskaltrust. Wszystkie modele są zgodne z tym samym kontraktem API. Brokery offline zapewniają, że tworzenie i podpisywanie paragonów działa nawet w przypadku awarii połączenia internetowego.
Środowisko piaskownicy
Możesz przetestować system w naszym środowisku sandbox. Zarejestruj się jako partner w portalu fiskaltrust Market. Rozszerz swój punkt końcowy, aby wywołać API. Proces ten umożliwia pobieranie danych paragonów w preferowanym formacie i ich wizualizację.
Jak to działa w 3 krokach
1.
Zarejestruj się na stronie fiskaltrust.Portal.
2.
Utwórz CashBox i połącz ją z POS lub ERP.
3.
Rozpocznij tworzenie i wystawianie paragonów za pomocą interfejsu Receipt-API.
Dowiedz się więcej - dokumentacja, zestawy SDK i środowiska testowe są dostępne tutaj