API – Historia zmian

21.05.2023

Udostępniono nowe metody służące do pobierania płatności i aktualizacji ich statusu. Więcej informacji w artykule: API – Płatności

16.03.2023

Udostępniono nowe wersje metod do pobierania danych dotyczących:

• faktur sprzedaży (wersja 1.4),
• faktur zaliczkowych (wersja 1.4),
• faktur proforma (wersja 1.4),
• korekt (wersja 1.4).

W zakresie tych metod poszerzono informacje o dokumenty wystawione w walutach obcych.

Dodatkowo udostępniono nową metodę do pobierania faktur VAT marża. Więcej informacji w artykule Faktura VAT marża.

22.06.2022

Udostępniono nową wersję metody do faktur sprzedaży (Faktura sprzedaży wersja 1.3), w której:

• rozszerzono zakres danych pobieranych z dokumentu,
• dodano funkcję pobierania i edycji terminu płatności.

Umożliwiono także wystawianie i zatwierdzanie faktur korygujących do faktur sprzedaży i faktur zaliczkowych oraz pobieranie wydruków tych dokumentów.

16.03.2022

Dodano nowe funkcje w API w zakresie zatwierdzania faktur sprzedaży, wystawiania faktur zaliczkowych oraz przekształcania faktur zaliczkowych do faktur finalnych. Opisy do nowych i zaktualizowanych metod znajdują się w poszczególnych artykułach:

• Faktura sprzedaży wersja 1.2 – dodano metodę do zatwierdzania dokumentów będących w buforze
• Faktura zaliczkowa
• Przekształcanie faktur zaliczkowych

09.02.2022

Udostępniono możliwość dodawania i edycji rachunków bankowych oraz form płatności:

• Rachunki bankowe
• Formy płatności

23.07.2021

W związku z możliwością stosowania procedury OSS w API udostępniono nowe wersje metod:

• Kontrahenci wersja 1.2
• Faktura sprzedaży wersja 1.2
• Faktura proforma wersja 1.2

W tych metodach można m.in. wskazać kod kraju kontrahenta oraz jego status. Dla kontrahentów unijnych dodatkowe dane można pobrać ze słowników oznaczeń krajów UE i stawek VAT. Więcej informacji w artykule: API – Obsługa procedury OSS

Zaktualizowana została także metoda do pobierania wydruków.

Ponadto w dotychczasowej metodzie dotyczącej produktów dodano możliwość pobrania rodzaju produktu (ProductType):

• 0 – usługa
• 1 – towar
• 2 – towar z kontrolą stanu

17.06.2021

Udostępniono opcję usuwanie wielu faktur proforma w jednej operacji. Nowa metoda przyjmuje obiekt o polu IdCollection, który zawiera tablice reprezentującą numery Id faktur proforma do usunięcia. Więcej informacji znajduje się dokumentacji dla wersji 1.1 dostępnej pod adresem: Faktura proforma wersja 1.1

27.04.2021

Dodano nowe pole InvoiceDocIdNum dla faktur proforma, które przechowuje numer Id powiązanej faktury sprzedaży, faktury zaliczkowej lub powiązanego paragonu. Szczegółowy opis całej struktury faktur proforma znajduje się pod następującymi linkami:

• Faktura proforma
• Faktura proforma wersja 1.1

22.07.2020

Udostępniono nowe wersje metod w zakresie dokumentów handlowych:

• https://app.comarchbetterfly.pl/api2/public/v1.1/invoices
• https://app.comarchbetterfly.pl/api2/public/v1.1/proformas
• https://app.comarchbetterfly.pl/api2/public/v1.1/invoices/print/{id}
• https://app.comarchbetterfly.pl/api2/public/v1.1/proformas/print/{id}

W wersjach 1.1 dla faktur sprzedaży i faktur proforma wprowadzono następujące nowości – od teraz można:

• wskazać odbiorcę na dokumentach faktury sprzedaży i fakturach proforma (ReceivingPartyId)
• ustawić algorytm naliczania – od cen netto (InvoiceType=0) oraz od cen brutto (InvoiceType=1)
• dodać opis na dokument (Description)
• pobrać wydruk dokumentu wg domyślnego szablonu przypisanego do kontrahenta

W dotychczasowych wersjach metod w zakresie produktów można dodatkowo:

• zapisać cenę sprzedaży produktu w kwotach brutto (ProductCurrencyPrice)
• pobrać informacje o stanie magazynowym towaru (Quantity)

Udostępniono także filtrowanie danych we wszystkich obsługiwanych metodach GET zwracających dane w formie listy – przykłady:

• produkty
  • wg nazwy (…/products/?$filter=Name eq {nazwa})
  • wg kodu (…/products/?$filter=ProductCode eq {kod_produktu})
• kontrahenci
  • wg NIP (…/customers/nip/{nr_nip})
  • wg nazwy (…/customers/?$filter=Name eq {nazwa})
  • wg adresu e-mail (…/customers/?$filter=Mail eq {adres_email})
• dokumenty
  • wg numeru faktury sprzedaży (…/invoices/number/{nr_dokumentu})
  • wg numeru faktury proforma (…/proformas/number/{nr_dokumentu})

17.12.2019

Udostępniono API w zakresie:

• pobieranie, dodawanie, modyfikowanie i usuwanie produktów
• pobieranie, dodawanie, modyfikowanie i usuwanie kontrahentów
• pobieranie form zapłaty,
• pobieranie rachunków bankowych,
• pobieranie faktur sprzedaży i faktur proforma
• dodawanie faktur sprzedaży i faktur proforma
• usuwanie faktur sprzedaży i faktur proforma
• pobieranie wydruku faktury sprzedaży i faktury proforma z możliwością wskazania szablonu

Szczegółowy opis powyższych funkcji znajduje się tutaj.

Aby rozpocząć pracę z Comarch Betterfly API – dowiedz się więcej tutaj.