Dokumentacja API - ifirma.pl


Dodatkowy podmiot na fakturze


Oprócz danych kontrahenta, możliwe jest wskazanie dodatkowych podmiotów występujących na fakturze.

Dodatkowe podmioty są powiązane z wybranym kontrahentem i mogą być zdefiniowane w jego danych jako Podmioty dodatkowy.

Przez API możliwe jest dodanie podmiotów dodatkowych do kontrahenta w następujących scenariuszach:

  • przy dodawaniu nowego kontrahenta,
  • edytując zapisanego już kontrahenta,
  • dodając podmiot dodatkowy wykorzystując dedykowany endpoint
  • dodając podmiot dodatkowy przy wystawianiu dokumentu poprzez wskazanie w obiekcie PodmiotyDodatkowe

W każdym z powyższych przypadków, dane podmiotu dodatkowego należy podać jako JSON zgodny z poniższym opisem:

Nazwa w JSON Typ danych Wartości Wymagane Opis
CzyDomyslny Boolean true; false N Określa czy dane podmiotu dodatkowego mają być zawsze widoczne na fakturze dla tego kontrahenta
Rola String ODBIORCA
DODATKOWY_NABYWCA
DOKONUJACY_PLATNOSCI
JEDN_SAMORZADU_TERYT (jednostka samorządu terytorialnego – odbiorca)
CZLONEK_GRUPY_VAT (członek grupy VAT – odbiorca)
PRACOWNIK
INNA – w tym przypadku należy uzupełnić pole NazwaRoli
N Rola podmiotu dodatkowego
NazwaRoli String <= 50 znaków N Inna nazwa roli podmiotu niż dostępne
Nazwa String >= 1 znak;<= 150 znaków T Nazwa
PrefiksUE String <= 2 znaki N Prefiks UE
NIP String <= 13 znaków N NIP
IdentyfikatorWewnetrznyZNip String <= 18 znaków N Identyfikator wewnętrzny z NIP
Ulica String <= 65 znaków N
KodPocztowy String >= 1 znak;
<= 16 znaków
N
Miejscowosc String >= 1 znak;
<= 65 znaków
N
Kraj String <= 70 znaków N

Do wykorzystania na dokumencie zapisanego już w danych kontrahenta podmiotu dodatkowego, należy w obiekcie PodmiotyDodatkowe przesłać pole Identyfikator wskazujące na wybrany podmiot dodatkowy.


Copyright 2001-2026 ifirma.pl