wFirma i SMS: przypomnienie o niezapłaconej fakturze

1. Przygotuj dostęp do wFirma

W wFirma otwórz Ustawienia → Bezpieczeństwo → Aplikacje → Klucze API. Przygotuj accessKey i secretKey. Potrzebny jest również appKey przyznawany aplikacji przez wFirma. Sam klucz Przypominamy.com nie daje dostępu do faktur. Zapisz identyfikator właściwej firmy, szczególnie gdy jedno konto obsługuje kilka podmiotów.

Klucze przechowuj w połączeniu narzędzia automatyzacji lub sekretach serwera. Zakres odczytu faktur wystarcza do przypomnień; proces nie musi zmieniać dokumentów ani oznaczać ich jako opłacone.

2. Pobierz dokumenty i sprawdź stan płatności

Oficjalna dokumentacja opisuje invoices/find oraz invoices/get/{id} na https://api2.wfirma.pl. Odczytaj m.in. identyfikator, numer faktury, termin płatności paymentdate i pozostałą kwotę remaining. Autoryzacja API Key używa trzech nagłówków: accessKey, secretKey, appKey; parametr company_id wybiera firmę.

W scenariuszu n8n lub Make ustaw harmonogram, paginowany odczyt, filtr przeterminowanych należności i ponowne pobranie pojedynczej faktury bezpośrednio przed wysyłką. Pomijaj dokumenty opłacone, anulowane i wyłączone przez księgowość. Numer telefonu powinien pochodzić z uzgodnionych danych kontrahenta; brak numeru kieruj do ręcznej obsługi.

3. Ustal jeden etap przypomnienia

Na początek wybierz jedno przypomnienie, np. trzeci dzień po terminie o 10:00 czasu Warszawy. Klucz operacji zbuduj z firmy, faktury i etapu: wfirma-firma7-faktura123-d3. Przed żądaniem zapisz operację w trwałym rejestrze. Ponowne wykonanie harmonogramu powinno odnaleźć ten sam zapis.

{
  "to": "+48600100200",
  "text": "Przypominamy o platnosci za fakture FV/123. Jesli przelew zostal wykonany, prosimy pominac wiadomosc. Biuro ABC",
  "reference": "wfirma-firma7-faktura123-d3"
}

To przykład body dla POST https://api.przypominamy.com/v1/messages. Dodaj Authorization: Bearer TWÓJ_KLUCZ, Content-Type: application/json i nagłówek Idempotency-Key z identyfikatorem operacji. Przykładowy telefon zastąp własnym zweryfikowanym numerem.

4. Zapisz wynik i przetestuj wyścig z płatnością

Po odpowiedzi zapisz identyfikator wiadomości oraz stan przyjęcia. Raport doręczenia sprawdzisz w panelu lub przez API. Pole reference służy do wyszukiwania; samo nie usuwa duplikatów. Po timeoutcie zachowaj ten sam klucz i treść, sprawdź historię, a nierozstrzygniętej operacji nie twórz ponownie z nowym identyfikatorem.

Test obejmuje fakturę nieopłaconą, częściową wpłatę, wpłatę między odczytem listy a wysyłką, brak telefonu i drugi przebieg tego samego dnia. Jeśli księgowanie wpłat odbywa się z opóźnieniem, ustal dodatkowy bufor z księgowością. Koszt to liczba części SMS pomnożona przez stawkę konta; wdrożenie i abonament wFirma rozliczane są osobno.

Najczęstsze pytania