Lista zmian w API 1.1 względem API 1.0

[Kamil Smuszkiewicz 48]

 

Wprowadziliśmy aktualizację identyfikatorów w API. Wszystkie odpowiedzi zawierają teraz id w formacie Guid, co odpowiada wartości wcześniej używanego newId.

 

Wprowadziliśmy szereg usprawnień mających na celu poprawę działania walidacji oraz zwiększenie czytelności odpowiedzi zwracanych w przypadku wystąpienia błędów. Ulepszono mechanizmy filtrowania oraz sortowania, co przekłada się na bardziej precyzyjne i efektywne wyszukiwanie danych. Dodatkowo, dokonano optymalizacji dokumentacji, aby była bardziej przejrzysta i przyjazna dla użytkowników API.

Zmiany w endpoint Products:

Metody GET:

• Dotychczasowy separator "+" zastąpiono ":" w parametrze orderBy.

Metoda PUT:

• Usunięto parametr kind.
  • Brak możliwości zmiany typu produktu po jego dodaniu.

Metoda DELETE:

• W wersji 1.1 zrezygnowano z metody DELETE.

Metoda PATCH:

• Dodano nowy endpoint PATCH /products/{id}/deactivate służący do dezaktywacji produktu (zamiast jego usuwania).

---

Zmiany w endpoint Documents:

Metody GET:

• Dodano nowe atrybuty:
  • invoiceMode: możliwe wartości:
    • "Traditional" – dla tradycyjnego trybu fakturowania.
    • "Ksef" – dla trybu fakturowania zintegrowanego z KSeF.
  • ksefNumber: string – numer nadany przez KSeF.
  • lastModificationDate: string (datetime) – data i czas ostatniej modyfikacji dokumentu.
• Dotychczasowy separator "+" zastąpiono ":" w parametrze orderBy.

Metoda PUT:

• Usunięto:
  • issuedByVatPayer – Brak możliwości zmiany wartości po dodaniu dokumentu.

Metoda POST:

• Usunięto:
  • issuedByVatPayer – Brak możliwości ustawienia wartości.
    • Status VAT wystawcy jest teraz automatycznie pobierany na podstawie wartości opcji "Czynny podatnik VAT" w konfiguracji firmy.

---

Zmiany w endpoint Clients:

Metody GET:

• Dodano nowy filtr nip, który umożliwia filtrowanie po numerze NIP klienta.
• Dotychczasowy separator "+" zastąpiono ":" w parametrze orderBy.

 

 

Zapewniamy czasową kontynuację wsparcia dla wersji API 1.0, sugerujemy przejście na wersję API 1.1. Zakończenie wsparcia dla API 1.0 poprzedzimy komunikatem.