OneBox
OneBox Rest API
API Lager (Lagerung)

API Lager (Lagerung)

Methode: /api/storage-translocation/

Optionen

Buchungsbeispiel:

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

Beispiel bewegen:

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

Beispiel Abschreibung:

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

№	Feld	Art	Beschreibung	Obligatorisch oder nicht	Kommentar
1	login	string	Melden Sie sich im BOX-System an	Pflichtfeld.
2	password	string	Passwort im md5-Format	Pflichtfeld.	Schreiben Sie an den technischen Support und wir geben Ihnen einen Hash für die API
3	type	string	Art der Transaktion	Pflichtfeld.	incoming - posten transfer - ziehen um outcoming - Abschreiben
4	code1c	string	Operationscode von einem externen System	Nicht erforderliches Feld.	id Operationen aus einem externen System
5	storagefrom	string	Lager, von dem aus die Abschreibung oder Umbuchung erfolgt	Nicht erforderliches Feld.	id Waren aus Ihrem System oder aus BOX, falls vorhanden, wird die Engine sie der Bestellung zuordnen
6	storageto	string	Zu aktivierendes oder zu übertragendes Lager	Nicht erforderliches Feld.	id Lager aus Ihrem System oder aus BOX oder dessen Name, falls es keines gibt - das System wird es erstellen
7	productArray	array(code, name, serialnumber, count, price, currency, vat, shipment, warranty, cell)	Warensortiment	Nicht erforderliches Feld.	code - id Waren von Ihrem System oder von BOX name - Produktname serialnumber - Seriennummer count - Anzahl price - der Preis des Produkts currency - Währungsname oder -code vat - inkl. MwSt shipment - Batch-Code warranty - Garantie cell - Zelle custom_key - zusätzliches Lagerfeld, statt key angeben Feld-ID
8	cdate	datetime	Datum der Operation	Nicht erforderliches Feld.
9	dateto	datetime	Verfallsdatum einer Warencharge (wird beim Buchen verwendet)	Nicht erforderliches Feld.
10	contractor	decimal	Juristische Person	Nicht erforderliches Feld.	id juristische Person in BOX oder ihren Namen
11	supplier	string	Der Zulieferer	Nicht erforderliches Feld.	id der Lieferant der gutzuschreibenden Ware oder sein Name
12	numberdocument	string	Dokumentnummer	Nicht erforderliches Feld.
13	typetransaction	integer	Transaktionstyp des externen Systems	Nicht erforderliches Feld.
14	orderid	string	translate_wp_nomer_protsessa	Nicht erforderliches Feld.	Передача номера процесса в операцию

Bearbeitungsvorgänge, Methode: /api/storage-translocation/edit/

Optionen

Beispiel:

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

№	Feld	Art	Beschreibung	Obligatorisch oder nicht	Kommentar
1	login	string	Melden Sie sich im BOX-System an	Pflichtfeld.
2	password	string	Passwort im md5-Format	Pflichtfeld.	Schreiben Sie an den technischen Support und wir geben Ihnen einen Hash für die API
3	id	integer	id die Operation, die unsere API bei ihrer Erstellung an Sie zurückgegeben hat	Pflichtfeld.	Betriebscode im BOX-System
4	code1c	string	Operationscode von einem externen System	Pflichtfeld.	id Operationen aus einem externen System
5	date	date	das Datum des	Nicht erforderliches Feld.	Datum der Operation
6	dateto	date	Gültig bis	Nicht erforderliches Feld.
7	return	1 / 0	Geben Sie ein Produkt zurück	Nicht erforderliches Feld.	Wenn Sie das Produkt aus der Operation zurückgeben möchten, geben Sie in diesem Feld „true“ an
8	deleted	1 / 0	Löschen	Nicht erforderliches Feld.	Wenn Sie die Operation löschen möchten, setzen Sie dieses Feld auf „true“.
9	productArray	array(id, price, amount, shipment, delete)	Warensortiment	Nicht erforderliches Feld.	id - interner Produktcode in Betrieb price - Preis amount - Anzahl shipment - Batch-Code delete - ein Produkt löschen, wenn Sie ein Produkt aus der Operation entfernen möchten, setzen Sie dieses Feld auf wahr custom_key - zusätzliches Lagerfeld, statt key angeben Feld-ID

Bestandsaktualisierung, Methode: /api/storage-translocation/updatebalance/

Optionen

Beispiel:

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

№	Feld	Art	Beschreibung	Obligatorisch oder nicht	Kommentar
1	login	string	Melden Sie sich im BOX-System an	Pflichtfeld.
2	password	string	Passwort im md5-Format	Pflichtfeld.	Schreiben Sie an den technischen Support und wir geben Ihnen einen Hash für die API
3	storagecode	string	Lager, in dem die Produktbilanz überprüft wird	Pflichtfeld.	Lagercode im BOX-System oder aus Ihrem System oder der Name des Lagers im System
4	suppliercode	string	Der Lieferant, von dem die Buchung vorgenommen wird	Pflichtfeld.	Lieferantencode im BOX-System oder aus Ihrem System- oder Lieferantennamen
5	searchbyproductid	boolean	Suche nach Produktübereinstimmungen nur anhand ihrer ID	Nicht erforderliches Feld.	Wenn der Parameter nicht angegeben ist, erfolgt die Suche standardmäßig nach Code 1c, ID, Name
6	productArray	array(code, amount, currencyid, shipment, serial, taxvalue)	Warensortiment	Nicht erforderliches Feld.	code - Produktcode oder Name price - Preis currencyid - Währungscode im System currencyname - Währungsname amount - Anzahl shipment - Batch-Code serial - Seriennummer taxvalue - Mehrwertsteuerbetrag

Empfangsvorgänge, Methode: /api/storage-translocation/get/

Optionen

Beispiel:

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

№	Feld	Art	Beschreibung	Obligatorisch oder nicht	Kommentar
1	login	string	Melden Sie sich im BOX-System an	Pflichtfeld.
2	password	string	Passwort im md5-Format	Pflichtfeld.	Schreiben Sie an den technischen Support und wir geben Ihnen einen Hash für die API
3	type	string	Art der Transaktion	Nicht erforderliches Feld.	incoming - posten transfer - ziehen um outcoming - Abschreiben
4	id	integer	id die Operation, die unsere API bei ihrer Erstellung an Sie zurückgegeben hat	Nicht erforderliches Feld.	Betriebscode im BOX-System
5	code1c	string	Operationscode von einem externen System	Nicht erforderliches Feld.	id Operationen von einem externen System, wenn Sie -1 an dieses Feld übergeben, erhalten Sie alle Datensätze mit leerem Code1c
6	datefrom	date	stammen aus	Nicht erforderliches Feld.	Datum, ab dem Transaktionen ausgeführt werden sollen
7	dateto	date	Datum bis	Nicht erforderliches Feld.	Datum, bis zu dem Operationen durchgeführt werden sollen
8	storageto	string	ID oder code1c	Nicht erforderliches Feld.	ID oder Code1c des Lagers, in dem die Vorgänge durchgeführt wurden
9	storagefrom	string	ID oder code1c	Nicht erforderliches Feld.	ID oder Code1c des Lagers, von dem aus die Operationen durchgeführt wurden
10	orderid	string	translate_wp_nomer_protsessa	Nicht erforderliches Feld.	Фильтрация по номеру процесса
11	part	integer	Teil der Operationen	Nicht erforderliches Feld.	API gibt bis zu 1000 Produkte im 1. Teil aus, um die nächsten 1000 Produkte dort zu erhalten Pass 2 (es stellt sich Teil 2 heraus) und so weiter. Feldwerte zurückgeben id - id Operationen, code1c - Operationscode von einem externen System, amount - Warenmenge in Betrieb, cost - Warenkosten in der Transaktion in der Basiswährung, date - das Datum des, dateto - Verfallsdatum, document - Transaktionsdokument, type - Art der Transaktion, storagefrom - eine Reihe von Informationen über das Warenlager, von dem aus die Überweisung erfolgte (ID, Code1c, Name), storageto - eine Reihe von Informationen über das Lager, in das der Umzug durchgeführt wurde (ID, Code1c, Name), numberdocument - Belegnummer aus einem Fremdsystem, user - Array von Informationen über den Betreiber (ID, vollständiger Name), typetransaction - Operationstyp aus externem System, product - Produktpalette aus dem Betrieb: id - interner Produktcode in Betrieb, productId - interner Produktcode im BOX-System, productCode1c - externer Produktcode, productName - Produktname, amount - Anzahl, pricebase - Kaufpreis, warranty - Garantie, batchCode - Batch-Code,

Reste bekommen Methode: /api/storage-balance/get/

Optionen

Beispiel:

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

№	Feld	Art	Beschreibung	Obligatorisch oder nicht	Kommentar
1	login	string	Melden Sie sich im BOX-System an	Pflichtfeld.
2	password	string	Passwort im md5-Format	Pflichtfeld.	Schreiben Sie an den technischen Support und wir geben Ihnen einen Hash für die API
3	storagenameid	string	id oder Lagercode1c	Pflichtfeld.
4	getproductdiscount	boolean	Получить скидку продукта в процентах	Nicht erforderliches Feld.	Если параметр указан, в возвращаемом массиве появятся значения discountpercent
					Feldwerte zurückgeben id - id Aufzeichnungen, productId - id Waren, code - Eintrittscode, amount - Menge der Ware, amountavaillable - Warenmenge nicht reserviert, reserve - Anzahl reservierter Artikel, cost - Warenkosten in der Transaktion in der Basiswährung, cdate - Datum, an dem der Datensatz hinzugefügt wurde, dateto - Verfallsdatum, currency - Währung, price - Preis, pricebase - Grundpreis, productname - Artikelname, serial - Produktreihe, currencyrate - Wechselkurs, storageName - Lagername,

Abrufen einer Liste von Lagern, Methode: /api/storage-names/get/

Optionen

Beispiel:

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

№	Feld	Art	Beschreibung	Obligatorisch oder nicht	Kommentar
1	login	string	Melden Sie sich im BOX-System an	Pflichtfeld.
2	password	string	Passwort im md5-Format	Pflichtfeld.	Schreiben Sie an den technischen Support und wir geben Ihnen einen Hash für die API
3	id	string	id Warenhaus	Nicht erforderliches Feld.	Wird verwendet, um ein bestimmtes Warenlager mit der angegebenen ID abzurufen
4	externalid	string	Lager externe ID	Nicht erforderliches Feld.	Wird verwendet, um ein bestimmtes Lager anhand der angegebenen externen ID abzurufen
4	code	string	Lagercode	Nicht erforderliches Feld.	Wird verwendet, um Warenhäuser mit dem angegebenen Code abzurufen
5	isemployee	boolean	Lagermitarbeiter	Nicht erforderliches Feld.	Wird verwendet, um Warenlager nach Mitarbeitern zu erhalten
6	employerexternalid	integer	Externe Mitarbeiter-ID	Nicht erforderliches Feld.	Wird verwendet, um Warenlager für den Mitarbeiter mit der angegebenen externen ID zu erhalten
					Feldwerte zurückgeben id - id Warenhaus, name - Lagername, code - Lagercode, forsale - ist es möglich, von diesem Lager aus zu verkaufen (1 - möglich, 0 - nein), isvendor - ob das Lager ein virtuelles Lager eines Lieferanten ist (1 - ja, 0 - nein), isemployee - ob das Lager das virtuelle Lager eines Mitarbeiters ist (1 - ja, 0 - nein), isoutcoming - ob es möglich ist, vom Lager abzuschreiben (1 - ja, 0 - nein), hidden - verstecktes Lager (1 - ja, 0 - nein), default - Standardlager, zum Buchen (1 - ja, 0 - nein), externalid - Lager externe ID,

Ändern der Produktbilanz im Lager: /api/storage-translocation/product/updatebalance/

Optionen

Einbuchung eines Produkts in Höhe von 2 Stück ins Lager:

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

Ausbuchung eines Produktes in Höhe von 2 Stück aus dem Lager:

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

Stellen Sie den Produktbestand auf 2 ein:

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}]}

№	Feld	Art	Beschreibung	Obligatorisch oder nicht	Kommentar
1	login	string	Melden Sie sich im BOX-System an	Pflichtfeld.
2	password	string	Passwort im md5-Format	Pflichtfeld.	Schreiben Sie an den technischen Support und wir geben Ihnen einen Hash für die API
3	dataFromBody	boolean	Nehmen Sie Daten nicht aus Argumenten, sondern aus dem Körper	Nicht erforderliches Feld.	Wenn dataFromBody=1 übergeben wird, werden die Daten nicht aus den Argumenten, sondern aus dem Request-Body genommen. Json muss an den Body übergeben werden, in dem die Schlüssel die oben beschriebenen Parameter sein müssen
4	useTotalBalance	boolean	1 oder 0	Nicht erforderliches Feld.	Wenn bestanden - dann bei Zählung = 1 - wird der Saldo des angegebenen Produkts im Lager 1. Wird dieser Parameter nicht übergeben, so wird bei Übergabe von count=1 1 Produkt gutgeschrieben und bei count=-1 wird 1 Produkt abgeschrieben
5	data	json	json	Pflichtfeld.	Array wo: storageid - id Lager in OneBox storagecode1c - externe Lager-ID in OneBox. Pflichtfeld, falls nicht angegeben storageid vendorid - id Anbieter in OneBox vendorcode1c - Externe Lieferanten-ID in OneBox. Wenn nicht vendorid und vendorcode1c - der erste verfügbare Lieferant im System wird genommen productArray - ein Array mit Daten zu Produkten, wobei ein Element ein Array mit Daten zu 1 Produkt ist, in dem: code1c - externe Produkt-ID im OneBox-System (Pflichtfeld) count - Menge (Pflichtfeld) price - Preis (Optionales Feld)

Hinzufügen eines neuen Lagers /api/storage/names/add/

Optionen

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

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

№	Feld	Art	Beschreibung	Obligatorisch oder nicht	Kommentar
1	login	string	Melden Sie sich im BOX-System an	Pflichtfeld.
2	password	string	Passwort im md5-Format	Pflichtfeld.	Schreiben Sie an den technischen Support und wir geben Ihnen einen Hash für die API
3	externalid	integer	Внешний id склада	Pflichtfeld.	Внешний id склада
4	name	string	1 oder 0	Pflichtfeld.	Название склада
5	forsale	boolean	boolean	Pflichtfeld.	Можно продавать с этого склада?

Mögliche Antworten auf die Anfrage

Mehr

№	Status	Nachricht	Nachrichtenbeschreibung
1	ok	balanceArray	Array des Saldos des ausgewählten Lagers
2	fail	login_empty	Fehlende Anmeldung
3	fail	password_empty	Fehlendes Passwort
4	fail	Login or password not correct!	Falsches Login oder Passwort
5	fail	Bad user level!	Niedriges Benutzerlevel zum Ausführen dieser Aktion (benötigt Level 2 und höher)
6	fail	Not found storage	Lager nicht gefunden
7	fail	You don't available transaction for update!	Keine Transaktion zum Aktualisieren gefunden (fehlende Transaktions-ID oder Code)
8	fail	Transaction by id not found!	Transaktion mit dieser ID wurde nicht gefunden
9	fail	Transaction by code1c not found!	Transaktion mit diesem Code wurde nicht gefunden
10	fail	Returns can not be done!	Die Rückerstattungstransaktion konnte nicht abgeschlossen werden
11	fail	Returns can not be done!	Die Rücksendung kann nicht erfolgen (das Lager, an das die Ware zurückgesendet werden muss, wurde nicht gefunden)

Es können auch Fehler auftreten:

502 Bad Gateway - Wenn dieser Fehler auftritt, müssen Sie:
1. Überprüfen Sie, ob Sie Zugang zum Internet haben (gehen Sie zu einer anderen Website).
2. Wenn es keine Probleme mit dem Zugriff gibt — Sie können Cookies löschen.
Wenn das oben genannte nicht geholfen hat — Serverseitiges Problem. Wenden Sie sich an den Systemadministrator der Site.

503 (Service Temporarily Unavailable) - Dieser Fehler kann durch zu viele auftreten Anfragen an den Server. Wenn Sie einen solchen Fehler sehen, sollten Sie ein paar Minuten warten und es erneut versuchen.

504 Gateway Timeout - cDer Punkt ist höchstwahrscheinlich die erhöhte Auslastung der Site, bei der Apache dies nicht tut verwaltet, HTTP-Antworten zu geben, und neue Anforderungen werden in die Warteschlange gestellt. Um das Problem zu lösen, können Sie hinzufügen Serverressourcen, insbesondere RAM, und die Anzahl der httpd-Prozesse erhöhen (Apache).
Ein weiterer möglicher Grund für den 504-Fehler ist, dass das ausführbare Skript nicht in das zugewiesene Limit passt Zeit. Dies passiert, wenn die Anfrage zu schwer ist. Versuchen Sie, Ihre Anfrage in mehrere weitere aufzuteilen klein.

Fehler 505 HTTP-Version wird nicht unterstützt bedeutet, dass die Website nicht ist unterstützt die Version des HTTP-Protokolls, die der Browser verwendet, um eine Webseite anzufordern

API Lager (Lagerung)

Vielen Dank für Ihre Wahl.