Integracja ze Skrótami / Siri / Spotlight

KSeF Katalog jest częścią ekosystemu Skrótów Apple. Aplikacja udostępnia 5 intencji App Intents — inne aplikacje na Twoim urządzeniu (np. budżetówki, planery, automatyzacje, asystenci AI w aplikacji Skróty) mogą bezpiecznie i lokalnie pobierać dane fakturowe.

Wszystkie 5 intencji jest darmowych. Działają identycznie na iPadzie i Macu — jeden kod, ten sam efekt.

Dostępne intencje

Intencja	Co robi
Otwórz fakturę	Otwiera wskazaną fakturę w aplikacji KSeF Katalog (deep-link do widoku szczegółów)
Wyszukaj faktury	Full-text search po numerze faktury, nazwie kontrahenta lub numerze KSeF
Faktury z okresu	Lista faktur z wybranego zakresu dat (z opcjonalnym filtrem typu i NIPu kontrahenta)
Suma miesięczna	Agregowana kwota brutto faktur dla wybranego miesiąca i typu (przychodzące / wychodzące)
Podsumowanie VAT	Total, count i średni VAT z wybranego okresu

Każda intencja ma polską i angielską lokalizację — Siri rozpoznaje frazy w obu językach.

Trzy przykładowe Skróty

1. Suma przychodów za poprzedni miesiąc → wyślij do Numbers

Skrót automatyzuje miesięczne raporty finansowe. Pierwszego dnia każdego miesiąca pobiera sumę faktur przychodzących z miesiąca poprzedniego i dopisuje ją do arkusza w Numbers.

Akcje:

1. Pobierz aktualną datę → Odejmij 1 miesiąc → wyciągnij komponent „miesiąc” oraz „rok” (zmienne Miesiąc, Rok)
2. KSeF Katalog → Suma miesięczna (Miesiąc: Miesiąc, Rok: Rok, Typ: Przychodzące)
3. Numbers → Dodaj wiersz (z otrzymaną sumą)

Możesz dodać do Skrótu trigger automatyzacji „1. dzień miesiąca, 9:00” — raport przyjdzie sam, bez Twojego udziału.

2. Wyszukaj fakturę po nazwie kontrahenta — głosem

Powiedz Siri: „Hej Siri, wyszukaj faktury w KSeF Katalog”. Siri zapyta o frazę wyszukiwania, uruchomi SearchInvoicesIntent i pokaże listę dopasowanych faktur z formatowanymi kwotami w polskich złotych.

Wariant z parametrem zapisanym w Skrócie:

1. Tekst → wpisz np. „Allegro”
2. KSeF Katalog → Wyszukaj faktury (Fraza: użyj zmiennej z kroku 1)
3. Wybierz z listy → użytkownik wybiera fakturę
4. KSeF Katalog → Otwórz fakturę (z poprzedniego kroku)

Skrót można uruchomić jednym kliknięciem ze Spotlight, z Doku iPada lub paska menu Maca, albo komendą głosową Siri.

3. Podsumowanie VAT za kwartał → wyślij e-mailem do księgowej

Skrót pobiera VAT podsumowanie za zakończony kwartał i wysyła wiadomość do wskazanej osoby.

Akcje:

1. Wybierz datę (lub policz dynamicznie pierwszy/ostatni dzień kwartału)
2. KSeF Katalog → Podsumowanie VAT (Od: 1.04, Do: 30.06, Typ: Wychodzące)
3. Tekst → sformatuj wynik („Total VAT: …, Count: …, Średnia: …”)
4. Mail → Wyślij e-mail (Do: księgowa@firma.pl, Treść: tekst z kroku 3)

Skrót można rozszerzyć o Pobierz folder z plikami (jeżeli używasz eksportu CSV w Pro) i wysłać raport razem z arkuszem.

Wymagania

• macOS 15.0 lub nowszy / iPadOS 18.0 lub nowszy
• Aplikacja KSeF Katalog zainstalowana i uruchomiona przynajmniej raz (Apple wymaga uruchomienia żeby App Shortcuts trafiły do indeksu Skrótów / Siri / Spotlight)
• Faktury zsynchronizowane z KSeF (przynajmniej jedno wywołanie sync)

Prywatność

Wszystkie wywołania App Intents są lokalne. Dane nigdy nie wychodzą z Twojego urządzenia — system Apple pośredniczy między aplikacjami, KSeF Katalog nie wystawia żadnego endpointu sieciowego. Aplikacja nie zbiera telemetrii o wywołaniach intencji; lokalny licznik (Ustawienia → Integracje Shortcuts) jest wyłącznie informacyjny i nie opuszcza urządzenia.

Szczegóły: Polityka prywatności — sekcja App Intents

Dokumentacja techniczna

Programiści zainteresowani szczegółami implementacji (parametry intencji, typy zwracane, error handling) — napisz contact@thehardway.pl. Pełna specyfikacja App Intents jest też dostępna w aplikacji Skróty po wybraniu „KSeF Katalog” w bibliotece akcji.