Wysyłanie faktur pocztą tradycyjną oraz na adres e-mail kontrahenta

|
ID: 778304815
|
Kategorie: API
Nie tylko kawa jest 2w1

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.json

Przykład z użyciem numeru faktury:

https://www.ifirma.pl/iapi/fakturawysylka/send/12_4_2014.json

Przykł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.pl

Uż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=Perfumy

Wysył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=true

Wysył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=true

UWAGA

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ą.

Jeśli informacji jakich szukasz nie znalazłeś w naszej bazie wiedzy - zadzwoń do nas 71 769 55 15 lub porozmawiaj z konsultantem na czacie . Możesz też napisać maila na bok@ifirma.pl. BOK jest czynne od poniedziałku do piątku w godz. 9:00 – 20:00.
Nie musisz czytać pomocy

Mobilnie. Wszędzie

Z ifirma.pl masz księgowość w swoim telefonie. Wysyłaj dokumenty, sprawdzaj salda i terminy online, gdziekolwiek jesteś. Aplikację znajdziesz na najpopularniejszych platformach.

Mobilnie

Ułatwienia dla e‑commerce

Wygodne integracje
Wygodne integracje

Program do faktur IFIRMA w prosty sposób zintegrujesz z Allegro i popularnymi platformami e‑commerce jak Shoper, WooCommerce czy PrestaShop.

Sprawdź wszystkie integracje →

Wygodne integracje
Płatności w jednym miejscu

ifirma.pl łączy się z urządzeniami fiskalnymi, pozwala na eksport przelewów do banku i zatwierdzanie ich jednym kodem, co znacznie usprawnia codzienną pracę i samodzielne księgowanie.

Wygodne integracje
Łatwe generowanie faktur

Dzięki integracji z bazą GUS ułatwiamy też wystawianie faktur – wystarczy, że wpiszesz NIP kontrahenta, a reszta danych uzupełni się automatycznie.

allegro integracja ecommerce
woocommerce integracja ecommerce
shoper integracja ecommerce
prestashop integracja ecommerce
shoplo integracja ecommerce
magento integracja ecommerce