OneBox
OneBox Rest API
API magazyny (Przechowywanie)

API magazyny (Przechowywanie)

Metoda: /api/storage-translocation/

Opcje

Przykład kapitalizacji:

http://myboxurl/api/storage-translocation/?login=LOGIN&password=PASSWORD&type=incoming&storageto=STORAGE_1&productArray[1][code]=PRODUKT1&productArray[1][count]=2&productArray[1][price]=22&productArray[1][currency]=USD&productArray[1][serialnumber]=123456

Przesuń przykład:

http://myboxurl/api/storage-translocation/?login=LOGIN&password=PASSWORD&type=transfer&storageto=STORAGE_1&storagefrom=STORAGE_2&productArray[1][code]=PRODUKT1&productArray[1][count]=2&productArray[1][serialnumber]=123456

Przykład odpisu:

http://myboxurl/api/storage-translocation/?login=LOGIN&password=PASSWORD&type=outcoming&storagefrom=STORAGE_2&productArray[1][code]=PRODUKT1&productArray[1][count]=2&productArray[1][serialnumber]=123456

№	Pole	Typ	Opis	Obowiązkowe lub nie	Komentarz
1	login	string	Zaloguj się w systemie BOX	Pole obowiązkowe.
2	password	string	Hasło w formacie md5	Pole obowiązkowe.	Napisz do pomocy technicznej, a my przekażemy Ci hash dla API
3	type	string	rodzaj transakcji	Pole obowiązkowe.	incoming - mianowanie transfer - poruszający outcoming - Odpisanie
4	code1c	string	kod transakcji z systemu zewnętrznego	Pole nie wymagane.	id operacji z systemu zewnętrznego
5	storagefrom	string	Magazyn, z którego zostanie dokonany odpis lub przelew	Pole nie wymagane.	id produktu z Twojego systemu lub z BOX-a jeśli taki istnieje, silnik połączy go z zamówieniem
6	storageto	string	Magazyn zostanie kapitalizowany lub przeniesiony	Pole nie wymagane.	id magazyn z Twojego systemu lub z BOX-a lub jego nazwy, jeśli go nie ma, system go utworzy
7	productArray	array(code, name, serialnumber, count, price, currency, vat, shipment, warranty, cell)	Tablica towarów	Pole nie wymagane.	code - id towary z Twojego systemu lub z BOX name - Nazwa produktu serialnumber - numer seryjny count - Ilość price - cena produktu currency - nazwa lub kod waluty vat - VAT naliczony shipment - kod partii warranty - gwarancja cell - komórka custom_key - dodatkowe pole magazynowe, zamiast klucza wpisz Identyfikator pola
8	cdate	datetime	Data operacji	Pole nie wymagane.
9	dateto	datetime	Data ważności partii towaru (stosowana podczas kapitalizacji)	Pole nie wymagane.
10	contractor	decimal	Podmiot	Pole nie wymagane.	id osoba prawna w BOX lub jej nazwa
11	supplier	string	Dostawca	Pole nie wymagane.	id zarejestrowany dostawca towarów lub jego nazwa
12	numberdocument	string	Numer dokumentu	Pole nie wymagane.
13	typetransaction	integer	Typ transakcji systemu zewnętrznego	Pole nie wymagane.
14	orderid	string	translate_wp_nomer_protsessa	Pole nie wymagane.	Передача номера процесса в операцию

Operacje edycyjne metoda: /api/storage-translocation/edit/

Opcje

Przykład:

http://myboxurl/api/storage-translocation/edit/?login=LOGIN&password=PASSWORD&id=111&productArray[1][count]=1&productArray[1][price]=10&productArray[1][batchCode]=1111111&productArray[1][id]=123

№	Pole	Typ	Opis	Obowiązkowe lub nie	Komentarz
1	login	string	Zaloguj się w systemie BOX	Pole obowiązkowe.
2	password	string	Hasło w formacie md5	Pole obowiązkowe.	Napisz do pomocy technicznej, a my przekażemy Ci hash dla API
3	id	integer	id operację, którą nasz interfejs API zwrócił Ci podczas jej tworzenia	Pole obowiązkowe.	Kod transakcji w systemie BOX
4	code1c	string	kod transakcji z systemu zewnętrznego	Pole obowiązkowe.	id operacji z systemu zewnętrznego
5	date	date	data	Pole nie wymagane.	Data operacji
6	dateto	date	Sprzedaj przez	Pole nie wymagane.
7	return	1 / 0	Zwróć produkt	Pole nie wymagane.	Jeśli chcesz zwrócić towar z operacji, wpisz w tym polu wartość true
8	deleted	1 / 0	Usuwać	Pole nie wymagane.	Jeśli chcesz usunąć operację, wpisz w tym polu wartość true
9	productArray	array(id, price, amount, shipment, delete)	Tablica towarów	Pole nie wymagane.	id - wewnętrzny kod produktu w operacji price - Cena amount - Ilość shipment - kod partii delete - usuń produkt, jeśli chcesz usunąć produkt z operacji, wpisz w tym polu wartość true custom_key - dodatkowe pole magazynowe, zamiast klucza wpisz Identyfikator pola

Aktualizuj saldo w magazynie, metoda: /api/storage-translocation/updatebalance/

Opcje

Przykład:

http://myboxurl/api/storage-translocation/updatebalance/?login=LOGIN&password=PASSWORD&storagecode=111&suppliercode=222&productArray[1][code]=1&productArray[1][amount]=10

№	Pole	Typ	Opis	Obowiązkowe lub nie	Komentarz
1	login	string	Zaloguj się w systemie BOX	Pole obowiązkowe.
2	password	string	Hasło w formacie md5	Pole obowiązkowe.	Napisz do pomocy technicznej, a my przekażemy Ci hash dla API
3	storagecode	string	Magazyn, w którym sprawdzane będzie saldo produktów	Pole obowiązkowe.	kod magazynu w systemie BOX lub z poziomu Twojego systemu lub nazwy magazynu w systemie
4	suppliercode	string	Dostawca, od którego będzie dokonywane księgowanie	Pole obowiązkowe.	Kod dostawcy w systemie BOX lub z Twojego systemu lub nazwy dostawcy
5	searchbyproductid	boolean	Szukaj pasujących produktów tylko według ich identyfikatora	Pole nie wymagane.	Jeżeli parametr nie jest podany, domyślnie wyszukiwanie odbywa się po kodzie 1c, id, nazwie
6	productArray	array(code, amount, currencyid, shipment, serial, taxvalue)	Tablica towarów	Pole nie wymagane.	code - kod lub nazwa produktu price - Cena currencyid - kod waluty w systemie currencyname - nazwa waluty amount - Ilość shipment - kod partii serial - numer seryjny taxvalue - Kwota podatku VAT

Operacje odbiorcze, metoda: /api/storage-translocation/get/

Opcje

Przykład:

http://myboxurl/api/storage-translocation/get/?login=LOGIN&password=PASSWORD&type=incoming
http://myboxurl/api/storage-translocation/get/?login=LOGIN&password=PASSWORD&id=123
http://myboxurl/api/storage-translocation/get/?login=LOGIN&password=PASSWORD

№	Pole	Typ	Opis	Obowiązkowe lub nie	Komentarz
1	login	string	Zaloguj się w systemie BOX	Pole obowiązkowe.
2	password	string	Hasło w formacie md5	Pole obowiązkowe.	Napisz do pomocy technicznej, a my przekażemy Ci hash dla API
3	type	string	rodzaj transakcji	Pole nie wymagane.	incoming - mianowanie transfer - poruszający outcoming - Odpisanie
4	id	integer	id operację, którą nasz interfejs API zwrócił Ci podczas jej tworzenia	Pole nie wymagane.	Kod transakcji w systemie BOX
5	code1c	string	kod transakcji z systemu zewnętrznego	Pole nie wymagane.	id operacji z systemu zewnętrznego, jeśli do tego pola przekażesz -1, otrzymasz wszystkie rekordy, których code1c jest pusty
6	datefrom	date	Data, od	Pole nie wymagane.	Data, od której należy przyjmować transakcje
7	dateto	date	Data do	Pole nie wymagane.	Data, do której należy wykonać operacje
8	storageto	string	ID lub kod1c	Pole nie wymagane.	ID lub kod 1c magazynu, do którego przeprowadzono operacje
9	storagefrom	string	ID lub kod1c	Pole nie wymagane.	ID lub kod 1c magazynu, z którego przeprowadzono operacje
10	orderid	string	translate_wp_nomer_protsessa	Pole nie wymagane.	Фильтрация по номеру процесса
11	part	integer	Część operacji	Pole nie wymagane.	API rozdaje do 1000 towarów w pierwszej części, aby otrzymać kolejne 1000 towarów w ramach transferu 2 (otrzymujesz część 2) i tak dalej. Zwróć wartości pól id - id operacje, code1c - kod transakcji z systemu zewnętrznego, amount - ilość towarów w eksploatacji, cost - koszt towaru w transakcji w walucie bazowej, date - data, dateto - najlepiej spożyć przed datą, document - dokument transakcji, type - rodzaj transakcji, storagefrom - tablica informacji o magazynie, z którego wykonano przesunięcie (id, code1c, name), storageto - tablica informacji o magazynie, do którego została wykonana przeprowadzka (id, code1c, name), numberdocument - numer dokumentu z systemu zewnętrznego, user - tablica informacji o operatorze (id, imię i nazwisko), typetransaction - rodzaj operacji z systemu zewnętrznego, product - szereg produktów z eksploatacji: id - wewnętrzny kod produktu w operacji, productId - wewnętrzny kod produktu w systemie BOX, productCode1c - zewnętrzny kod produktu, productName - Nazwa produktu, amount - Ilość, pricebase - Cena zakupu, warranty - gwarancja, batchCode - kod partii,

Odbieranie sald metoda: /api/storage-balance/get/

Opcje

Przykład:

http://myboxurl/api/storage-balance/get/?login=LOGIN&password=PASSWORD&storagenameid=2

№	Pole	Typ	Opis	Obowiązkowe lub nie	Komentarz
1	login	string	Zaloguj się w systemie BOX	Pole obowiązkowe.
2	password	string	Hasło w formacie md5	Pole obowiązkowe.	Napisz do pomocy technicznej, a my przekażemy Ci hash dla API
3	storagenameid	string	id lub magazyn code1c	Pole obowiązkowe.
4	getproductdiscount	boolean	Получить скидку продукта в процентах	Pole nie wymagane.	Если параметр указан, в возвращаемом массиве появятся значения discountpercent
					Zwróć wartości pól id - id dokumentacja, productId - id dobra, code - kod wejściowy, amount - ilość towaru, amountavaillable - ilość towaru niezarezerwowana, reserve - Ilość zarezerwowany przedmiot, cost - koszt towaru w transakcji w walucie bazowej, cdate - data dodania wpisu, dateto - najlepiej spożyć przed datą, currency - waluta, price - Cena, pricebase - Cena podstawowa, productname - Nazwa produktu, serial - seria produktów, currencyrate - wskaźnik, storageName - nazwa magazynu,

Uzyskanie listy magazynów, metoda: /api/storage-names/get/

Opcje

Przykład:

http://myboxurl/api/storage-names/get/?login=LOGIN&password=PASSWORD

№	Pole	Typ	Opis	Obowiązkowe lub nie	Komentarz
1	login	string	Zaloguj się w systemie BOX	Pole obowiązkowe.
2	password	string	Hasło w formacie md5	Pole obowiązkowe.	Napisz do pomocy technicznej, a my przekażemy Ci hash dla API
3	id	string	id magazyn	Pole nie wymagane.	Służy do uzyskania określonego magazynu według określonego identyfikatora
4	externalid	string	identyfikator magazynu zewnętrznego	Pole nie wymagane.	Służy do uzyskania konkretnego magazynu poprzez podany identyfikator zewnętrzny
4	code	string	kod magazynu	Pole nie wymagane.	Służy do pozyskiwania magazynów o podanym kodzie
5	isemployee	boolean	Pracownik magazynu	Pole nie wymagane.	Służy do pozyskiwania magazynów przez pracowników
6	employerexternalid	integer	Zewnętrzny identyfikator pracownika	Pole nie wymagane.	Służy do pozyskiwania magazynów przez pracownika o podanym identyfikatorze zewnętrznym
					Zwróć wartości pól id - id magazyn, name - nazwa magazynu, code - kod magazynu, forsale - Czy jest możliwość sprzedaży z tego magazynu (1 - możliwe, 0 - nie), isvendor - Czy magazyn jest magazynem wirtualnym dostawcy (1 – tak, 0 – nie), isemployee - czy magazyn jest magazynem wirtualnym pracownika (1 – tak, 0 – nie), isoutcoming - Czy można odpisać z magazynu (1 - tak, 0 - nie), hidden - ukryty magazyn (1 - tak, 0 - nie), default - domyślny magazyn dla kapitalizacji (1 - tak, 0 - nie), externalid - identyfikator magazynu zewnętrznego,

Zmiana salda produktów w magazynie: /api/storage-translocation/product/updatebalance/

Opcje

Przyjęcie produktu w ilości 2 sztuk do magazynu:

http://myboxurl/api/storage-translocation/product/updatebalance/?login=LOGIN&password=PASSWORD&data={"storageid":4,"vendorid":3,"productArray":[{"code1c":42875,"count":2,"price":120}]}

Spisanie 2 produktów z magazynu:

http://myboxurl/api/storage-translocation/product/updatebalance/?login=LOGIN&password=PASSWORD&data={"storageid":4,"vendorid":3,"productArray":[{"code1c":42875,"count":-2,"price":120}]}

Ustaw pozostały produkt w magazynie na 2:

http://myboxurl/api/storage-translocation/product/updatebalance/?login=LOGIN&password=PASSWORD&useTotalBalance=1&data={"storageid":4,"vendorid":3,"productArray":[{"code1c":42875,"count":2,"price":120}]}

№	Pole	Typ	Opis	Obowiązkowe lub nie	Komentarz
1	login	string	Zaloguj się w systemie BOX	Pole obowiązkowe.
2	password	string	Hasło w formacie md5	Pole obowiązkowe.	Napisz do pomocy technicznej, a my przekażemy Ci hash dla API
3	dataFromBody	boolean	Pobieraj dane nie z argumentów, ale z treści	Pole nie wymagane.	Jeżeli zostanie przekazane dataFromBody=1, to dane zostaną pobrane nie z argumentów, ale z treści żądania. Należy przekazać treść json, w której klucze muszą mieć parametry opisane powyżej
4	useTotalBalance	boolean	1 lub 0	Pole nie wymagane.	Jeśli zostanie przeniesiony - to przy przeniesieniu liczba = 1 - saldo określonego produktu w magazynie wyniesie 1. Jeżeli parametr ten nie zostanie przekazany, to przy przekroczeniu liczby=1 zostanie zaliczony 1 produkt, a przy liczbie=-1 1 produkt zostanie odpisany
5	data	json	json	Pole obowiązkowe.	Tablica gdzie: storageid - id magazyn w OneBox storagecode1c - zewnętrzny identyfikator magazynu w OneBox. Pole wymagane, jeśli nie zostało określone storageid vendorid - id dostawca w OneBox vendorcode1c - Identyfikator dostawcy zewnętrznego w OneBox. Jeśli nie vendorid I vendorcode1c - wybrany zostanie pierwszy dostępny w systemie dostawca productArray - tablica z danymi o produktach, gdzie jeden element jest tablicą z danymi o 1 produkcie, w którym: code1c - zewnętrzny identyfikator produktu w systemie OneBox (pole wymagane) count - ilość (Pole wymagane) price - cena (pole opcjonalne)

Dodanie nowego magazynu /api/storage/names/add/

Opcje

Добавление склада с названием Склад1 и Внешним id 10

http://myboxurl/api/storage/names/add/?login=LOGIN&password=PASSWORD&externalid=10&name=Склад1

№	Pole	Typ	Opis	Obowiązkowe lub nie	Komentarz
1	login	string	Zaloguj się w systemie BOX	Pole obowiązkowe.
2	password	string	Hasło w formacie md5	Pole obowiązkowe.	Napisz do pomocy technicznej, a my przekażemy Ci hash dla API
3	externalid	integer	Внешний id склада	Pole obowiązkowe.	Внешний id склада
4	name	string	1 lub 0	Pole obowiązkowe.	Название склада
5	forsale	boolean	boolean	Pole obowiązkowe.	Можно продавать с этого склада?

Możliwe odpowiedzi na zapytanie

Więcej szczegółów

№	Status	Wiadomość	Opis wiadomości
1	ok	balanceArray	Tablica sald wybranego magazynu
2	fail	login_empty	Brak logowania
3	fail	password_empty	Brak hasła
4	fail	Login or password not correct!	Nieprawidłowy login lub hasło
5	fail	Bad user level!	Niski poziom użytkownika, aby wykonać tę akcję (wymagany poziom 2 lub wyższy)
6	fail	Not found storage	Nie znaleziono magazynu
7	fail	You don't available transaction for update!	Nie znaleziono transakcji do aktualizacji (brak identyfikatora lub kodu transakcji)
8	fail	Transaction by id not found!	Nie znaleziono transakcji o tym identyfikatorze
9	fail	Transaction by code1c not found!	Nie znaleziono transakcji z tym kodem
10	fail	Returns can not be done!	Transakcja zwrotna nie może zostać zrealizowana
11	fail	Returns can not be done!	Zwroty nie mogą zostać zrealizowane (nie znaleziono magazynu, do którego należy zwrócić towar)

Mogą również wystąpić błędy:

502 Bad Gateway - Jeśli wystąpi ten błąd, musisz to zrobić:
1. Sprawdź, czy jest dostęp do Internetu (przejdź do dowolnej innej witryny).
2. Jeśli nie ma problemów z dostępem — możesz usunąć pliki cookie.
Jeśli powyższe nie pomogło — problem po stronie serwera. Powinieneś skontaktować się z administratorem systemu lokacji.

503 (Service Temporarily Unavailable) - Ten błąd może wystąpić w wyniku zbyt dużej liczby żądania do serwera. Jeśli widzisz ten błąd, odczekaj kilka minut i spróbuj ponownie.

504 Gateway Timeout - cNajprawdopodobniej jest to spowodowane zwiększonym obciążeniem witryny, pod którym Apache nie jest w stanie zarządza wysyłaniem odpowiedzi HTTP, a nowe żądania ustawiają się w kolejce. Aby rozwiązać problem, możesz dodać zasobów serwera, w szczególności pamięci RAM, oraz zwiększenia liczby procesów httpd (Apache).
Inną możliwą przyczyną błędu 504 jest to, że wykonywany skrypt nie mieści się w wyznaczonym limicie. czas. Dzieje się tak, gdy żądanie jest zbyt ciężkie. Spróbuj podzielić żądanie na kilka kolejnych maluchy.

Błąd 505 Wersja HTTP nie jest obsługiwana oznacza, że strona internetowa nie jest obsługuje wersję protokołu HTTP używaną przez przeglądarkę do żądania strony internetowej

API magazyny (Przechowywanie)

Dziękujemy za wybór.