# wFirma + Przypominamy.com: starter połączenia

Kolekcja Postman sprawdza odczyt faktur i dostęp do konta SMS. Nie wysyła wiadomości ani nie zmienia dokumentów. To punkt wyjścia do indywidualnej automatyzacji, nie gotowy harmonogram przypomnień.

## Przygotowanie

1. Importuj `connection.postman_collection.json` do Postman.
2. W prywatnym środowisku lokalnym ustaw `wfirma_accessKey`, `wfirma_secretKey`, `wfirma_appKey`, `wfirma_company_id` i `przypominamy_api_key` (zakres `read`). Sekrety oznacz jako wrażliwe, nie udostępniaj ich ani nie eksportuj wartości.
3. Klucze wFirma utworzysz w Ustawienia → Bezpieczeństwo → Aplikacje → Klucze API. `appKey` przyznaje wFirma aplikacji. Bez przyznanego klucza połączenie nie będzie działać.
4. Uruchom pierwszy odczyt. To pięć ostatnich zwykłych faktur, a nie lista wszystkich zaległości. Żądanie GET zawiera XML body, zgodnie z kolekcją producenta; nie przenoś go bez zmian do narzędzia, które usuwa body z GET.
5. Z odpowiedzi wybierz właściwy identyfikator i ustaw `wfirma_invoice_id`. Uruchom drugi odczyt. Sprawdź `paymentdate`, `remaining`, `paymentstate` i tożsamość firmy. Sam HTTP 200 nie przesądza o sukcesie — zweryfikuj status i zawartość odpowiedzi API.
6. Trzeci odczyt pokazuje konto SMS i stawki. Nie łączy automatycznie telefonu kontrahenta z numerem odbiorcy.

## Następny krok

Zastosuj [poradnik przypomnień wFirma](https://przypominamy.com/blog/sms-wfirma-przypomnienia-o-platnosci): harmonogram, paginacja, wybór niezapłaconych dokumentów, ponowny odczyt tuż przed SMS, trwały rejestr operacji i identyczny `Idempotency-Key` przy ponowieniu. Pierwszą rzeczywistą wiadomość wyślij na własny zweryfikowany numer. Po timeoutcie sprawdź historię, zanim zdecydujesz o ponowieniu.

Starter sprawdzono strukturalnie z oficjalną kolekcją API. Nie przetestowano go na koncie wFirma, ponieważ wymaga prywatnych kluczy użytkownika i przyznanego appKey.

Źródło kontraktu: [oficjalna dokumentacja wFirma](https://doc.wfirma.pl/), sprawdzona 8 września 2026.