Wysłanie faktury e-mailem do klienta przez API

Fakturownia umożliwia wysyłanie wystawionych faktur bezpośrednio na adres e-mail klienta poprzez API. System korzysta ze zdefiniowanego w ustawieniach szablonu wiadomości oraz adresu e-mail przypisanego do klienta na fakturze. Funkcja pozwala zautomatyzować proces przesyłania dokumentów i zapewnia zgodność z ustawieniami konta. Poniżej znajdziesz instrukcję korzystania z tej opcji oraz odpowiedzi na najczęściej zadawane pytania.
 

Wymagania wstępne

1. Użytkownik musi posiadać aktywny token API;
2. Faktura musi być wystawiona i zapisana w systemie – nie można wysyłać faktur roboczych;
3. Faktura musi mieć przypisanego klienta z adresem e-mail;

Wysyłka faktury e-mailem – struktura zapytania

Aby wysłać fakturę na adres e-mail klienta (podany przy tworzeniu faktury, pole "buyer_email"), użyj poniższego zapytania POST:

Opcjonalne parametry do wywołania send_by_email

Parametr email_to= z wartością email1,email2,email3, umożliwia przekazanie listy adresatów emaila z fakturą. Można ustawić w ten sposób do 5 adresów email.

Parametr email_cc= z wartością email1,email2,email3 umożliwia przekazanie listy adresatów do których wyślemy kopię emaila (email cc).

Parametr email_pdf= z wartością true umożliwa dołączenie w załączniku pliku pdf z fakturą.

Parametr update_buyer_email= z wartością true umożliwa aktualizację emaila odbiorcy na fakturze (musimy również przekazać parametr email_to). Jeśli na fakturze jest ustawiony odbiorca (recipient) to aktualizujemy recipient_email, zamiast buyer_email.
 

Szablon wiadomości e-mail

Wiadomość e-mail z fakturą wysyłana przez API korzysta z domyślnego lub własnego szablonu zdefiniowanego w:

Ustawienia > Ustawienia konta > Wysyłanie e-mailem > Wysyłanie faktury e-mailem

W planie PRO możliwe jest ustawienie osobnych szablonów dla działów: Osobna konfiguracja wysyłania dokumentów e-mailem

FAQ – pytania i odpowiedzi

1. Czy mogę automatycznie wysłać fakturę od razu po jej utworzeniu przez API?
Nie, należy po wystawieniu faktury wykonać osobne żądanie POST /send_by_email.json.
Dokumentacja: GitHub Fakturownia API – Send by Email

2. Czy można ustawić własny temat e-maila i nazwę pliku PDF z fakturą?
Nazwa pliku PDF nie podlega edycji przez API. Tytuł e-maila nie jest edytowalne przez API wprost, ale można go zmienić w polu Konfiguracja > Wysyłanie e-mailem stosując zmienną {{description_long}} - opis, tym samym do tematu trafia to, co znajdzie się w polu Opis, a wartość ta może być przekazywana po API.

3. Czy można wysłać proformę przez API z linkiem do szybkiej płatności i automatycznym wystawieniem faktury po opłaceniu?
Tak. Wystarczy ustawić "kind":"proforma" i aktywować Szybki przelew lub Autopłatności. Po wystawieniu proformy należy wykonać osobne żądanie POST /send_by_email.json.