Specyfikacja plików w formacie CSV - Historia wersji

Ssekscinski o 11:50, 10 lis 2020

2020-11-10T11:50:22Z

← poprzednia wersja		Wersja z 11:50, 10 lis 2020
Linia 433:		Linia 433:

	Możliwe statusy (id - nazwa)		Możliwe statusy (id - nazwa)

	0 - "Nowe"		0 - "Nowe"

	1 - "Przypisane do operatora"		1 - "Przypisane do operatora"

	2 - "W trakcie kompletacj"		2 - "W trakcie kompletacj"

	3 - "Skompletowane. Czeka na transport"		3 - "Skompletowane. Czeka na transport"

	4 - "W trakcie transportu"		4 - "W trakcie transportu"

	5 - "Spakowane. Czeka na paragon"		5 - "Spakowane. Czeka na paragon"

	10 - "Zakonczone"		10 - "Zakonczone"

	12 - "Anulowane"		12 - "Anulowane"


	Zwraca:		Zwraca:

	403 - przy braku autoryzacji		403 - przy braku autoryzacji

	404 - jak nie znajdzie zamówienia		404 - jak nie znajdzie zamówienia

	200 - w innym wypadku:		200 - w innym wypadku:

	aktualizacja ok - ['status' => 'success', 'errors' => null, 'message' => 'Status został		aktualizacja ok - ['status' => 'success', 'errors' => null, 'message' => 'Status został
	zaktualizowany.),		zaktualizowany.),

	błędy walidacji danych - ['status' => 'failed', 'errors' => [/Tablica błędów/], 'message'		błędy walidacji danych - ['status' => 'failed', 'errors' => [/Tablica błędów/], 'message'
	=> null]		=> null]

	cURL:		cURL:

	curl --location --request POST		curl --location --request POST

	'http://admin.sklep.localhost:8999/backendApi/updateOrderStatus' \		'http://admin.sklep.localhost:8999/backendApi/updateOrderStatus' \

	--header 'x-token: [token]' \		--header 'x-token: [token]' \

	--header 'x-apikey: [api-key]' \		--header 'x-apikey: [api-key]' \

	--form 'order=1462929' \		--form 'order=1462929' \

	--form 'status=1'		--form 'status=1'


	lub		lub

	curl --location --request POST		curl --location --request POST

	'http://admin.sklep.localhost:8999/backendApi/updateOrderStatus' \		'http://admin.sklep.localhost:8999/backendApi/updateOrderStatus' \

	--header 'x-token: [token]' \		--header 'x-token: [token]' \

	--header 'x-apikey: [api-key]' \		--header 'x-apikey: [api-key]' \

	--header 'Content-Type: application/json' \		--header 'Content-Type: application/json' \

	--data-raw '{"order": 1462929, "status": 1}'		--data-raw '{"order": 1462929, "status": 1}'

Ssekscinski o 11:44, 10 lis 2020

2020-11-10T11:44:52Z

← poprzednia wersja		Wersja z 11:44, 10 lis 2020
Linia 377:		Linia 377:

	Przykładowa odpowiedz w formacie json:		Przykładowa odpowiedz w formacie json:


	[		[
	{		{
	"id": 1462936,		"id": 1462936,
	"data": "2020-02-17",		"data": "2020-02-17",
	"czas": "2020-02-17 12:25:25",		"czas": "2020-02-17 12:25:25",
	"data_odbioru": "2020-02-21 17:00:00",		"data_odbioru": "2020-02-21 17:00:00",
	"koszt_dostawy": 999,		"koszt_dostawy": 999,
	"adres": {		"adres": {
	"imie": "~~Micha\u0142~~",		"imie": "Michał",
	"nazwisko": "Motyczko",		"nazwisko": "Motyczko",
	"kod": "01-100",		"kod": "01-100",
	"miasto": "Warszawa",		"miasto": "Warszawa",
	"ulica": "Aleje Jerozolimskie 23\/4",		"ulica": "Aleje Jerozolimskie 23/4",
	"telefon": "123456789"		"telefon": "123456789"
	},		},
	"prezent": false,		"prezent": false,
	"kwota_rabatu": 0,		"kwota_rabatu": 0,
	"klient": {		"klient": {
	"id": 353322		"id": 353322
	},		},
	"status": "Nowe",		"status": "Nowe",
	"metoda_platnosci": "~~Got\u00f3wka~~",		"metoda_platnosci": "Gotówka",
	"sklep": "Warszawa",		"sklep": "Warszawa",
	"produkty": [		"produkty": [
	{		{
	"plu": 290403,		"plu": 290403,
	"ilosc_zamowiona": 5000,		"ilosc_zamowiona": 5000,
	"ilosc_zrealizowana": 5000,		"ilosc_zrealizowana": 5000,
	"cena": 299,		"cena": 299,
	"wartosc": 1495000,		"wartosc": 1495000,
	"uwagi": "",		"uwagi": "",
	"produkt": {		"produkt": {
	"nazwa": "~~\u015aLEDZIKI~~ NA\/RAZ\/S\/~~\u015aMIET~~ 100",		"nazwa": "ŚLEDZIKI NA/RAZ/S/ŚMIET 100",
	"kod_paskowy": "5900344403664",		"kod_paskowy": "5900344403664",
	"plu_sklepowe": 130728		"plu_sklepowe": 130728
	}		}
			}
			]
	}		}
	]
	}
	]		]

Ssekscinski o 11:41, 10 lis 2020

2020-11-10T11:41:42Z

← poprzednia wersja		Wersja z 11:41, 10 lis 2020
Linia 417:		Linia 417:
	}		}
	]		]



			'''6. Zmiana statusu zamówienia:'''

			POST /backendApi/updateOrderStatus

			Parametry:
			order - int - numer zamówienia
			status - int - nowy status zamówienia

			Możliwe statusy (id - nazwa)
			0 - "Nowe"
			1 - "Przypisane do operatora"
			2 - "W trakcie kompletacj"
			3 - "Skompletowane. Czeka na transport"
			4 - "W trakcie transportu"
			5 - "Spakowane. Czeka na paragon"
			10 - "Zakonczone"
			12 - "Anulowane"

			Zwraca:
			403 - przy braku autoryzacji
			404 - jak nie znajdzie zamówienia
			200 - w innym wypadku:
			aktualizacja ok - ['status' => 'success', 'errors' => null, 'message' => 'Status został
			zaktualizowany.),
			błędy walidacji danych - ['status' => 'failed', 'errors' => [/Tablica błędów/], 'message'
			=> null]

			cURL:
			curl --location --request POST
			'http://admin.sklep.localhost:8999/backendApi/updateOrderStatus' \
			--header 'x-token: [token]' \
			--header 'x-apikey: [api-key]' \
			--form 'order=1462929' \
			--form 'status=1'

			lub

			curl --location --request POST
			'http://admin.sklep.localhost:8999/backendApi/updateOrderStatus' \
			--header 'x-token: [token]' \
			--header 'x-apikey: [api-key]' \
			--header 'Content-Type: application/json' \
			--data-raw '{"order": 1462929, "status": 1}'

Ssekscinski o 11:39, 10 lis 2020

2020-11-10T11:39:34Z

← poprzednia wersja		Wersja z 11:39, 10 lis 2020
Linia 360:		Linia 360:
	0 \| Nowe		0 \| Nowe
	1 \| Przypisane do operatora		1 \| Przypisane do operatora
	2 \| W trakcie ~~kompletacj~~		2 \| W trakcie kompletacji
	3 \| Skompletowane. Czeka na transport		3 \| Skompletowane. Czeka na transport
	4 \| W trakcie transportu		4 \| W trakcie transportu
Linia 366:		Linia 366:
	10 \| Zakonczone		10 \| Zakonczone
	12 \| Anulowane		12 \| Anulowane


	''Przykład użycia curl:''		''Przykład użycia curl:''
Linia 415:		Linia 416:
	]		]
	}		}

	]		]

Ssekscinski o 11:38, 10 lis 2020

2020-11-10T11:38:23Z

Podgląd zmian

Ssekscinski o 11:18, 10 lis 2020

2020-11-10T11:18:49Z

Ssekscinski o 11:17, 10 lis 2020

2020-11-10T11:17:58Z

@@ Linia 120: / Linia 120: @@
 {| class="wikitable"
 |-
-! METODA !! URL
+! Metoda !! URL
 |-
 | POST || /import/categories
@@ Linia 137: / Linia 137: @@
 'Content-Type: text/csv' https://nazwa_domeny/import/categories
-Specyfikacja pliku z kategoriami
+'''Specyfikacja pliku z kategoriami'''
 Plik musi być w formacie csv z następującą kolejnością pól
 id,nadrzedna_id,nazwa,opis
@@ Linia 155: / Linia 155: @@
 | opis || Opis kategorii ||
 |}

Ssekscinski o 11:09, 10 lis 2020

2020-11-10T11:09:24Z

← poprzednia wersja		Wersja z 11:09, 10 lis 2020
Linia 73:		Linia 73:
	! Metoda !! URL		! Metoda !! URL
	\|-		\|-
	\| POST \|\| /import/productsShop\|}		\| POST \|\| /import/productsShop
			\|}


	''Tab. 5. Parametry żądania''		''Tab. 5. Parametry żądania''

Ssekscinski o 11:07, 10 lis 2020

2020-11-10T11:07:32Z

@@ Linia 19: / Linia 19: @@
 '''1. Zakładanie nowych lub aktualizacja istniejących towarów.'''
-Tab. 1. Żądanie
+''Tab. 1. Żądanie''
 {| class="wikitable"
 |-
@@ Linia 27: / Linia 27: @@
 |}
-Tab. 2. Parametry żądania
+''Tab. 2. Parametry żądania''
 {| class="wikitable"
 |-
@@ Linia 46: / Linia 45: @@
 produkt_id,nazwa,kod_paskowy,producent_id,jednostka,gramatura_netto,opis
 kolejne produkty muszą być oddzielone znakiem nowej linii
 {| class="wikitable"
 |-
@@ Linia 63: / Linia 64: @@
 |-
 | opis || Opis produktu wyświetlany na stronie ||
 |}

Ssekscinski o 10:32, 10 lis 2020

2020-11-10T10:32:42Z

@@ Linia 5: / Linia 5: @@
 https://domena.pl/backendApi/login
-Przykład użycia curl:
+''Przykład użycia curl:''
 curl -H "X-ApiKey: klucz" --data '{"username":"login"}' -X POST
@@ Linia 34: / Linia 34: @@
 |-
 | HEAD || X-ApiKey || string
 |}

← poprzednia wersja		Wersja z 11:39, 10 lis 2020
Linia 360:		Linia 360:
	0 \| Nowe		0 \| Nowe
	1 \| Przypisane do operatora		1 \| Przypisane do operatora
	2 \| W trakcie ~~kompletacj~~		2 \| W trakcie kompletacji
	3 \| Skompletowane. Czeka na transport		3 \| Skompletowane. Czeka na transport
	4 \| W trakcie transportu		4 \| W trakcie transportu
Linia 366:		Linia 366:
	10 \| Zakonczone		10 \| Zakonczone
	12 \| Anulowane		12 \| Anulowane


	''Przykład użycia curl:''		''Przykład użycia curl:''
Linia 415:		Linia 416:
	]		]
	}		}

	]		]

← poprzednia wersja		Wersja z 11:18, 10 lis 2020
Linia 138:		Linia 138:

	'''Specyfikacja pliku z kategoriami'''		'''Specyfikacja pliku z kategoriami'''

	Plik musi być w formacie csv z następującą kolejnością pól		Plik musi być w formacie csv z następującą kolejnością pól
	id,nadrzedna_id,nazwa,opis		id,nadrzedna_id,nazwa,opis
Linia 179:		Linia 180:

	'''Specyfikacja pliku z producentami'''		'''Specyfikacja pliku z producentami'''

	Plik musi być w formacie csv z następującą kolejnością pól		Plik musi być w formacie csv z następującą kolejnością pól
	id,nazwa		id,nazwa
Linia 218:		Linia 220:

	'''Specyfikacja pliku z produktami'''		'''Specyfikacja pliku z produktami'''

	Plik w formacie csv z następującą kolejnością pól:		Plik w formacie csv z następującą kolejnością pól:
	produkt_id,nazwa,kod_paskowy,producent_id,jednostka,gramatura_netto,opis		produkt_id,nazwa,kod_paskowy,producent_id,jednostka,gramatura_netto,opis
	Opis pól jest analogiczny do importowanych.		Opis pól jest analogiczny do importowanych.
	Kolejne produkty oddzielone znakiem nowej linii		Kolejne produkty oddzielone znakiem nowej linii