Zakres danych
Przesyłane żądanie w formacie json przez API Rest musi posiadać poniższą strukturę danych
NAZWA POLA | NAZWA POLA W APLIKACJI | TYP POLA | WYMAGANE | OPIS |
|---|---|---|---|---|
Nazwa zamówienia | requestName | varchar(300) | TAK | |
Numer zamówienia | ordernumber | varchar(30) | NIE | Kolejny numer zamówienia. |
Status | orderstatus | varchar(50) | TAK | Dostępne statusy: w przygotowaniu, w trakcie zatwierdzania, zatwierdzone, odrzucone, wysłane do dostawcy, zrealizowane, anulowane, w realizacji |
Szablon | ordertemplate_id | bigint | TAK | Pole wyboru ze słownika szablonów zamówień |
Tworzący zamówienie | orderingOperator_id | bigint | NIE | Osoba tworząca zamówienie |
NIP dostawcy | suppliervatid | varchar(20) | NIE | Pole uzupełnia się po wyborze dostawcy. |
Termin dostawy | supplydate | date | NIE | Pole uzupełniane ręcznie. Możliwość wskazania daty za pomocą opcji kalendarza. Z polem powiązana jest notyfikacja informująca osobę wysyłającą zamówienie o zbliżającej się dostawie. Notyfikacja wysyłana 24 h przed datą dostawy. |
Waluta | company_id | bigint | TAK | Możliwość wyboru z listy: PLN, USD, GBP, EUR, CHF. |
Data wysłania (prawa strona) | sendingtosupplierfirstdate | timestamp | NIE | Pole uzupełniane automatycznie po wysłaniu zamówienia do dostawcy. |
Kategorie zakupowe | buyer_category_id | bigint | TAK | Konieczność przekazania kodu kategorii |
Jednostka organizacyjna | company_organisation_unit_id | bigint | TAK | Możliwość wskazania jednostki organizacyjnej w imieniu, której tworzone jest zamówienie. |
| Adres dostawy | ||||
Nazwa firmy | supplyaddress_companyname | varchar(512) | NIE | Automatycznie przypisywany jest adres dostawy podany w jednostkach organizacyjnych. Można dodać inny/wybrać z listy dostępnych adresów. |
| Kraj | supplyaddress_country_id | bigint | TAK | |
| Numer budynku | supplyaddress_number | varchar(20) | TAK | |
| Numer mieszkania | supplyaddress_officenumber | varchar(20) | NIE | |
| Miejscowość | supplyaddress_place | varchar(512) | TAK | |
| Województwo | supplyaddress_province_id | bigint | NIE | |
| Ulica | supplyaddress_street | varchar(512) | TAK | |
| Kod pocztowy | supplyaddress_zipcode | varchar(30) | TAK | |
| Przedmiot zamówienia | ||||
TABELA Z POZYCJAMI | ||||
Indeks kupca | buyerIndex | String | NIE | Indeks produktu, z którego korzysta dostawca |
Nazwa | name | String | TAK | Nazwa produktu na linii |
Ilość | quantity | Double | TAK | Ilość produktu na linii |
Jednostka | measureunit_id | TAK | Słownik jednostek miar | |
Cena jednostkowa netto | netUnitPrice | Double | NIE | Liczba dziesiętna (2 miejsca po przecinku) |
Wartość netto | netValue | Double | NIE | Liczba walutowa (2 miejsca po przecinku) |
Stawka VAT | vatRate | NIE | Słownik stawek VAT. Pole nie wymagane. | |
Komentarz | comment | String | NIE | Informacja o adresie dostawy |
LISTA PÓL DODATKOWYCH | ||||
Uwagi | comments | String | NIE |
|
| Możliwość dodania załączników, które zostaną wysłane dostawcy razem z zamówieniem | |||
Kody błędówStatusu odpowiedzi
Nazwa statusu |
OK |
ERROR |
Kod Błędu | Nazwa | Opis |
101 | Nie wszystkie wymagane pola są uzupełnione. | Występuje kiedy pola wymagane nie zostały wysłane w żądaniu. |
102 | Uzupełnione pola są wypełnione nieprawidłowo. | Występuje kiedy dane słownikowe wysłane w żądaniu nie zgadzają się ze słownikiem. |
201 | Błąd autoryzacji | Występuje kiedy dane autoryzacyjne są nieprawidłowe. |
202 | Błąd podczas deserializacji json | Występuje kiedy w żądaniu występują nieprawidłowe dane. |
203 | Błąd json. Uszkodzenie całego pliku | Występuje kiedy całe żądanie jest nieprawidłowe błędy podczas transmisji danych. |
UWAGA
Jeżeli nie posiadasz danej funkcji, skontaktuj się z nami w celu uzyskania szczegółów.