Poprzez API możliwe jest wysłanie wystawionej faktury sprzedaży wiadomością e-mail do kontrahenta. W tym celu należy wysłać żądanie POST na jeden z poniższych adresów, w zależności od typu faktury:
- faktura krajowa: https://www.ifirma.pl/iapi/fakturakraj/send/identyfikator_faktury.json
- faktura wysyłkowa: https://www.ifirma.pl/iapi/fakturawysylka/send/identyfikator_faktury.json
- faktura proforma: https://www.ifirma.pl/iapi/fakturaproformakraj/send/identyfikator_faktury.json
- eksport towarów: https://www.ifirma.pl/iapi/fakturaeksporttowarow/send/identyfikator_faktury.json
- WDT: https://www.ifirma.pl/iapi/fakturawdt/send/identyfikator_faktury.json
- świadczenie usług dla podatników VAT-UE w trybie art. 28b:https://www.ifirma.pl/iapi/fakturaeksportuslugue/send/identyfikator_faktury.json
- świadczenie usług poza terytorium kraju:https://www.ifirma.pl/iapi/fakturaeksportuslug/send/identyfikator_faktury.json
- faktura wysyłkowa / krajowa w walucie obcej:https://www.ifirma.pl/iapi/fakturawaluta/send/identyfikator_faktury.json
gdzie identyfikator_faktury to identyfikator faktury uzyskany w odpowiedzi po poprawnym wystawieniu faktury, może zostać zastąpiony przez numer faktury (w numerze faktury ukośniki „/” należy zastąpić podłogami „_”, czyli np. 314/2014 to 314_2014).
Przykład z użyciem identyfikatora faktury:
https://www.ifirma.pl/iapi/fakturakraj/send/12354523.jsonPrzykład z użyciem numeru faktury:
https://www.ifirma.pl/iapi/fakturawysylka/send/12_4_2014.jsonPrzykładowa zawartość żądania (JSON)
{
"Tekst":"W załączeniu przesyłam fakturę dotyczącą zamóienia nr 258462",
"Przelew": true,
"Pobranie": true,
"MTransfer":"mtransfer"
}gdzie:
- Tekst – zawiera treść wiadomości przesyłanej do klienta, maksymalnie do 1000 znaków;
- Przelew – true – do treści wiadomości zostanie dodana informacja o możliwości zapłaty przelewem wraz z danymi do przelewu,
false – brak informacji o możliwości zapłaty przelewem; - Pobranie – true – do wiadomości zostanie dodana informacja o możliwości zapłaty za pobraniem
false – brak informacji o możliwości zapłaty za pobraniem; - MTransfer – do wiadomosci może zostać dodana opcja zapłaty przez mTransfer
Wskazanie adresu e-mail, z którego zostanie wysłana faktura
Adres e-mail, z którego ma zostać wysłana faktura należy podać jako wartość parametru SkrzynkaEmaildołączonego do adresu.
Możliwe jest wysłanie wyłącznie z adresów e-mail skonfigurowanych w serwisie. W przypadku braku dopasowania faktura zostanie wysłana z adresu zdefiniowanego jako domyślny.
Zmiana maila nadawcy przy wysyłce faktur
Przykład adresu dla przesłania faktury wysyłkowej z adresu biuro@adressklepu.pl:
https://www.ifirma.pl/iapi/fakturawysylka/send/57863485.json?SkrzynkaEmail=biuro@adressklepu.plUżycie szablonu treści wiadomości
Nazwę szablonu treści wiadomości należy podać jako wartość parametru SzablonEmail dołączonego do adresu.
Wskazana nazwa szablonu powinna być zgodna z kongiguracją w serwisie. W przypadku braku dopasowania zostanie użyty zostanie szablon domyślny.
Wiadomość przesłana w żądaniu w polu Tekst zostanie doklejona do początku wiadomości.
Przykład adresu dla przesłania faktury z wykorzystaniem szablonu treści Perfumy:
https://www.ifirma.pl/iapi/fakturawysylka/send/57863485.json?SzablonEmail=PerfumyWysyłanie faktury elektronicznej (e-faktury)
Aby wysłać fakturę elektroniczną (e-fakturę), należy parametr wyslijEfaktura z wartością true dołączonyć do adresu.
Przykład adresu dla przesłania e-faktury krajowej:
https://www.ifirma.pl/iapi/fakturakraj/send/6255125.json?wyslijEfaktura=trueWysyłanie faktury pocztą tradycyjną
Aby wysłać fakturę pocztą tradycyjną, należy parametr wyslijPoczta z wartością true dołączyć do adresu.
Przykład adresu dla przesłania faktury krajowej:
https://www.ifirma.pl/iapi/fakturakraj/send/57863485.json?wyslijPoczta=trueUWAGA
Parametr wyslijPoczta jest nadrzędny w stosunku do parametru wyslijEfaktura, tak więc użycie ich obu z wartością true spowoduje wysłanie faktury pocztą tradycyjną.