Zmiany w API w dniu 14-12-2022
Pragniemy poinformować, że w dniu 14-12-2022 wprowadziliśmy zmianę w interfejsie API naszego serwisu - zmianie uległy 2 parametry opcjonalny o nazwie - sprzedawca_panstwo oraz nabywca_panstwo - wprowadzone zmiany mają na celu przygotowanie naszego serwisu do integracji z Krajowym Systemem e-Faktur KSef.

Parametry przed zmianą:

• sprzedawca_panstwo
• nabywca_panstwo

Parametry po zmianie:

• sprzedawca_kraj
• nabywca_kraj

Po zmianie oba dla obu parametrów należy przesyłać dwuliterowy kod kraju, np.: PL = Polska; AF = Afganistan; AL = Albania; DZ = Algieria; AD = Andora; itp.. W przypadku przesłania poprawnej nazwy kraju w wersji standardowej np. Niemcy - system automatycznie przypisze dwuliterowy kod dla danego kraju czyli np. DE. Jeśli nie chcemy aby nazwa kraju była widoczna to nie należy przesyłać żadnej wartości dla tego parametru.

Przypominamy, że aktualny opis wszystkich parametrów API znajduje się na poniższej stronie:
https://www.fakturowo.pl/pomoc/api

Zmiany w API w dniu 01-12-2022
Pragniemy poinformować, że w dniu 01-12-2022 wprowadziliśmy zmiany w interfejsie API naszego serwisu (zmianie uległy 4 parametry opcjonalne).

Wprowadzone zmiany mają na celu przygotowanie naszego serwisu do integracji z Krajowym Systemem e-Faktur KSef, który od 2024 roku będzie obowiązkowy dla wszystkich podatników. System KSEF wymaga przekazywania większego zakresu informacji, np. dane adresowe każdego podmiotu znajdującego się na dokumencie muszą być zapisywane w polach do tego dedykowanych np. nazwa, miasto, ulica, numer, itp..

Opis parametrów przed zmianą:

• sprzedawca_dane - dodatkowe dane adresowe dla danych sprzedawcy;
• sprzedawca_dane_oznaczenie - oznaczenie dodatkowych danych adresowych dla danych sprzedawcy;
• nabywca_dane - dodatkowe dane adresowe dla danych sprzedawcy;
• nabywca_dane_oznaczenie - oznaczenie dodatkowych danych adresowych dla danych sprzedawcy;

Opis parametrów po zmianie:

• Dodatkowe dane sprzedawcy dodajemy z cyfrą 1 (w nazwie parametru), np. sprzedawca1_nazwa, sprzedawca1_nip, sprzedawca1_miasto, sprzedawca1_kod, sprzedawca1_oznaczenie, itp.;
  • możliwe jest przesłanie dodatkowych danych sprzedawcy w jednym polu - czyli tak jak było do tej pory, np. aby w jednym polu dodać dodatkowe dane oznaczone jako - Wystawca - wystarczy przesłać parametry: sprzedawca1_nazwa=Jan Kowalski[n]Warszawa, sprzedawca1_oznaczenie=18, sprzedawca1_pole=1
• Dodatkowe dane nabywcy dodajemy z cyfrą 1 (w nazwie parametru), np. nabywca1_nazwa, nabywca1_nip, nabywca1_miasto, nabywca1_kod, nabywca1_oznaczenie, itp.;
  • możliwe jest przesłanie dodatkowych danych nabywcy w jednym polu - czyli tak jak było do tej pory, np. aby w jednym polu dodać dodatkowe dane oznaczone jako - Odbiorca - wystarczy przesłać parametry: nabywca1_nazwa=Jan Kowalski[n]Warszawa, nabywca1_oznaczenie=3, nabywca1_pole=1

UWAGA! Należy pamiętać, że w przypadku wystawiania dokumentów z danymi adresowymi zapisanymi w formie jednego pola (parametry - sprzedawca1_pole=1 oraz nabywca1_pole=1), generowanie plików XML dla systemu KSeF może nie działać poprawnie (jest to zależne od ostatecznej specyfikacji systemu KSeF). Zalecamy zapisywanie wszystkich danych adresowych w formie wielu pól, w polaPrzypominamy, że aktualny opis wszystkich parametrów API znajduje się na poniższej stronie:
https://www.fakturowo.pl/pomoc/apich do tego dedykowanych np. sprzedawca1_nazwa, sprzedawca1_miasto, nabywca1_nazwa, nabywca1_nip, nabywca1_miasto, itp..

Przypominamy, że aktualny opis wszystkich parametrów API znajduje się na poniższej stronie:
https://www.fakturowo.pl/pomoc/api

Zmiany w API w dniu 16-06-2022
Wprowadzone zmiany mają na celu przygotowanie naszego serwisu do integracji z Krajowym Systemem e-Faktur KSef (system ten będzie wymagał przekazywania większego zakresu informacji).

Poniżej parametry, które zostały dodane - w chwili obecnej parametry te są opcjonalne, jednakże wraz z wprowadzeniem systemu KSeF parametry te będą obowiązkowe:

• sprzedawca_imie, sprzedawca_nazwisko - system KSeF będzie wymagał podawania pierwszego imienia oraz nazwiska w przypadku gdy podatnik (sprzedawca) jest osobą fizyczną, w przypadku gdy podatnik (sprzedawca) nie jest osobą fizyczną wymagana będzie tylko pełna nazwa firmy; aby pola - sprzedawca_imie, sprzedawca_nazwisko - były widoczne w przypadku danych firmowych w formularzu dodawania/edycji dokumentu należy na stronie - Ustawienia > Parametry - zaznaczyć opcję – Imię i nazwisko;
• nabywca_imie, nabywca_nazwisko - system KSeF będzie wymagał podawania pierwszego imienia oraz nazwiska w przypadku gdy nabywca/usługobiorca jest osobą fizyczną, w przypadku gdy nabywca/usługobiorca nie jest osobą fizyczną (ale prowadzi działalność) wymagana będzie tylko pełna nazwa firmy; aby pola - nabywca_imie, nabywca_nazwisko - były widoczne w przypadku danych firmowych w formularzu dodawania/edycji dokumentu należy na stronie - Ustawienia > Parametry - zaznaczyć opcję – Imię i nazwisko;
• nabywca_osoba - dla danych nabywcy wprowadziliśmy możliwość wskazania, że nabywca/usługobiorca jest osobą fizyczną nie prowadzącą działalności – w takim przypadku dla parametru - nabywca_osoba – należy przesłać wartość 1 - w takim przypadku parametr – nabywca_nip – nie jest wymagany, jednakże wymagane są parametry – nabywca_imie oraz nabywca_nazwisko;
• sprzedawca_budynek, sprzedawca_lokal, nabywca_budynek, nabywca_lokal - Numer budynku oraz numer lokalu dla danych sprzedawcy oraz nabywcy; system KSeF będzie wymagał przesyłania oprócz nazwy ulicy, w osobnych polach numer budynku oraz numer lokalu; aby pola były widoczne na dokumencie należy na stronie - Ustawienia > Parametry - zaznaczyć opcję - Numer budynku/lokalu;
• sprzedawca_krs, sprzedawca_bdo, nabywca_krs, nabywca_bdo - dodatkowe dane informacyjne;

Poniżej parametry, które zostały zmienione lub zastąpione innymi:

• Parametry – sprzedawca_vat_ue, sprzedawca_numer_firmy, sprzedawca_numer_podatkowy – zostały usunięte, w ich miejsce został dodany nowy parametr o nazwie – sprzedawca_nip_oznaczenie – który może mieć wartości - 0 = nip; 1 = vat id; 2 = vat ue; 3 = numer – są to oznaczenia dla parametru - sprzedawca_nip (zatem parametr – sprzedawca_nip – również musi być przesłany aby parametr - sprzedawca_nip_oznaczenie – był widoczny);
• Parametry – nabywca_vat_ue, nabywca_numer_firmy, nabywca_numer_podatkowy – zostały usunięte, w ich miejsce został dodany nowy parametr o nazwie – nabywca_nip_oznaczenie – który może mieć wartości - 0 = nip; 1 = vat id; 2 = vat ue; 3 = numer – są to oznaczenia dla parametru - nabywca_nip (zatem parametr – nabywca_nip – również musi być przesłany aby parametr - nabywca_nip_oznaczenie – był widoczny);

Przypominamy, że aktualny opis wszystkich parametrów API znajduje się na poniższej stronie:
https://www.fakturowo.pl/pomoc/api