Dodaj produkt

Definicja Funkcji

Int createProduct(Array $data)

Definicja parametrów

Metoda przyjmuje 1 argument, jako tablica lub string JSON. Dostępne klucze:

Nazwa parametru	Typ parametru	Opis
symbol	string (wymagany)	Symbol nowego produktu musi być unikalny w obrębie jednostki.
name__	string (wymagany)	Nazwa produktu
vatnam	string (wymagany)	Nazwa stawki VAT (vat.vatnam). Jeśli system nie znajdzie stawki wyrzucany jest wyjątek
pgrpnm	string (wymagany)	Nazwa grupy (product_groups.name__). Jeśli nie ma jej w słowniku system automatycznie ją doda.
dscrpt	string	Opis produktu
fixinf	string	Uwagi
url___	string	Odnośnik url gdzie można zobaczyć produkt, zewnętrzny opis - strona produktu
pkwiu_	string	PKWiU
type__	int	Typ produktu: 1. Usługa 2. Produkt 3. Towar
unitnm	string	Nazwa jednostki ze słownika jednostek (units_of_measure)
spl_id	int	Dostawca (contacts.contid)
netto_	numeric(12,2)	Cena netto produktu
cursmb	string	Symbol waluty (currency.cursmb)
acorid	int	Identyfikator jednostki rozliczeniowej (organization_units.orunid)
tovcid	int	Identyfikator rodzaju kosztów (types_of_vcosts.tovcid)
quantm	numeric(12,2)	Ilość na magazynie
quamin	numeric(12,2)	Ilość minimalna
prior_	int	Liczba porządkowa
bckwar	bool	Blokuj obrót magazynowy. Zaznaczenie tej opcji spowoduje, że wydania oraz przyjęcia nie wpływają na stan danego produktu. Stan nie wpływa na wydania. Dany produkt nie podlega przesunięciom. Nie ma możliwości określenia stanu magazynowego. Domyślnie false
foto__	string	Zdjęcie towaru/usługi przechowywane w var/img/Depository
is_act	bool	Status czy aktywny. Domyślnie true
alarm_	bool	Produkt z alarmem - podczas otwierania kartoteki lub dodawania produktu na pozycję wyświetla się tekst umieszczony w polu Uwagi (depository.fixinf). Domyślnie false

Przykład użycia

 require_once('./classes/eDokumentyApi/EDokApi.inc');
 $api = new \EDokApi();
 try {
    $data = [
        'symbol' => 'CH',
        'name__' => 'Chrupki',
        'pgrpnm' => 'produkty spożywcze',
        'vatnam' => '5.00%'
    ];
    $depoid = $api->createProduct($data);

 }catch (\Exception $e ){
    throw new \Exception($e->getMessage());
 }   

Zwracane dane lub wyjątki

Metoda zwraca id produktu (depository:depoid) w przypadku sukcesu. 0 w razie niepowodzenia lub jeśli wystąpi błąd, wtedy zostanie zwrócony wyjątek. Zwracane wyjątki w zależności od wywołania

• SOAP - SoapFault
• Lokalnie - Exception