General info

API

REST API encrypted using the HTTPS protocol


HTTP Methods

  • GET - returns data - does not make changes
  • POST - sends new data
  • PUT - updates data
  • DELETE - deletes data

HTTP Codes

  • 200 - OK
  • 400 - Bad Request
  • 401 - Unauthorized
  • 404 - Not Found
  • 409 - Conflict
  • 422 - Unprocessable Entity - Data validation error
  • 500 - Server Error
Preview of response 422 - Unprocessable Entity
{
  "status": "error",
  "code": 422,
  "message": "Request body contains an error. See context for details.",
  "context": {
	"validation": {
	  "productBarcodes": [
		"This value should not be blank."
	  ],
	  "productImagesUrl": [
		"This value should not be blank."
	  ]
	}
  }
}

Data JSON

Any data in the JSON format and UTF-8 encoding. Header Content-Type: application/json


Data types

You can find all data types of individual attributes of the request body in the description of each EP, in the section Request Body, link Schematics. Optional attributes are tagged with the flag nullable


API EP

Production: https://app.log4u.cz/


Request authorization

Every request must contain 3 mandatory headers:
Header #1 Client-Key, that which must contain the API key of the provided partner
Header #2 Authorization-Token, that must contain a generated token
Header #3 Content-Type, with the value application/json.

Token generation
base64_encode(hash_hmac('sha1', API_SECRET, API_KEY . REQUEST_METHOD[GET, POST, DELETE ...] . date('Y-m-d H:i')));

Header Accept with the value application/json
Request authorization is announced via the return status code 401 with the message: Invalid request token or headers

Changes

4.4.2024 - GET Product - response attribute added disponibleCount
7.4.2024 - POST Outcome order import - response attribute added (float) shipmentValue
9.4.2024 - GET Outcome order details - response attribute added (int) stockStatus - status dial below
20.4.2024 - POST Outcome order import - response attribute added (string) stateOrProvinceCode
22.4.2024 - POST Product import - response attribute parameters for customs procedures added (string) duty_code (string) title_en (string) description_en
24.4.2024 - POST Outcome order import - response attribute added (bool) moveToDispatch
24.4.2024 - PATCH Send to dispatch - new EP added
09.5.2024 - GET Product List - new EP added
14.5.2024 - POST Outcome order import - response attribute added (string) pickupPointCarrierId
14.5.2024 - POST Product (import, update) - response attribute added (array) dutyCodes. Replacement for the original parameter dutyCode
24.6.2024 - GET Outcome order details - reponse attribute added (object) shipmentStatus.
27.9.2024 - POST Dropshipment data import - new EP added for the needs of DROP order removal from storage.
14.10.2024 - GET Outcome order details - response expanded by an array of objects[] (array) attachments.


LIST OF VALUES


Stock outcome order - List of reasons

ID DESCRIPTION
prodej created based on order received
reklamace created based on resolved complaint

Stock outcome order - List of stock statuses [stockStatus]

ID STATE INFO
0 Created
1 Waiting for outcome
2 Outcoming in progress
3 Waiting to get packed
4 Packing in progress
5 Packing error
6 Packed

Stock outcome order - List of package statuses [shipmentStatus::status]

STATUS INFO
delivered Package delivered to recipient
returned Package returned to stock

Country codes

CODE COUNTRY/PROVINCE
CZ Czech Republic
SK Slovakia
HU Hungary
AX Åland Islands
AL Albania
AD AndorrA
AT Austria
BY Belarus
BE Belgium
BA Bosnia and Herzegovina
BG Bulgaria
HR Croatia
CY Cyprus
DK Denmark
EE Estonia
FO Faroe Islands
FI Finland
FR France
DE Germany
GI Gibraltar
GR Greece
GG Guernsey
VA Holy See (Vatican City State)
IS Iceland
IE Ireland
IM Isle of Man
IT Italy
JE Jersey
LV Latvia
LI Liechtenstein
LT Lithuania
LU Luxembourg
MK Macedonia, The Former Yugoslav Republic of
MT Malta
MD Moldova, Republic of
MC Monaco
NL Netherlands
NO Norway
PL Poland
PT Portugal
RO Romania
RU Russian Federation
SM San Marino
CS Serbia and Montenegro
SI Slovenia
ES Spain
SJ Svalbard and Jan Mayen
SE Sweden
CH Switzerland
TR Turkey
UA Ukraine
GB United Kingdom
AF Afghanistan
DZ Algeria
AS American Samoa
AO Angola
AI Anguilla
AQ Antarctica
AG Antigua and Barbuda
AR Argentina
AM Armenia
AW Aruba
AU Australia
AZ Azerbaijan
BS Bahamas
BH Bahrain
BD Bangladesh
BB Barbados
BZ Belize
BJ Benin
BM Bermuda
BT Bhutan
BO Bolivia
BW Botswana
BV Bouvet Island
BR Brazil
IO British Indian Ocean Territory
BN Brunei Darussalam
BF Burkina Faso
BI Burundi
KH Cambodia
CM Cameroon
CA Canada
CV Cape Verde
KY Cayman Islands
CF Central African Republic
TD Chad
CL Chile
CN China
CX Christmas Island
CC Cocos (Keeling) Islands
CO Colombia
KM Comoros
CG Congo
CD Congo, The Democratic Republic of the
CK Cook Islands
CR Costa Rica
CI Cote D'Ivoire
CU Cuba
DJ Djibouti
DM Dominica
DO Dominican Republic
EC Ecuador
EG Egypt
SV El Salvador
GQ Equatorial Guinea
ER Eritrea
ET Ethiopia
FK Falkland Islands (Malvinas)
FJ Fiji
GF French Guiana
PF French Polynesia
TF French Southern Territories
GA Gabon
GM Gambia
GE Georgia
GH Ghana
GL Greenland
GD Grenada
GP Guadeloupe
GU Guam
GT Guatemala
GN Guinea
GW Guinea-Bissau
GY Guyana
HT Haiti
HM Heard Island and Mcdonald Islands
HN Honduras
HK Hong Kong
IN India
ID Indonesia
IR Iran, Islamic Republic Of
IQ Iraq
IL Israel
JM Jamaica
JP Japan
JO Jordan
KZ Kazakhstan
KE Kenya
KI Kiribati
KP Korea, Democratic People'S Republic of
KR Korea, Republic of
KW Kuwait
KG Kyrgyzstan
LA Lao People'S Democratic Republic
LB Lebanon
LS Lesotho
LR Liberia
LY Libyan Arab Jamahiriya
MO Macao
MG Madagascar
MW Malawi
MY Malaysia
MV Maldives
ML Mali
MH Marshall Islands
MQ Martinique
MR Mauritania
MU Mauritius
YT Mayotte
MX Mexico
FM Micronesia, Federated States of
MN Mongolia
MS Montserrat
MA Morocco
MZ Mozambique
MM Myanmar
NA Namibia
NR Nauru
NP Nepal
AN Netherlands Antilles
NC New Caledonia
NZ New Zealand
NI Nicaragua
NE Niger
NG Nigeria
NU Niue
NF Norfolk Island
MP Northern Mariana Islands
OM Oman
PK Pakistan
PW Palau
PS Palestinian Territory, Occupied
PA Panama
PG Papua New Guinea
PY Paraguay
PE Peru
PH Philippines
PN Pitcairn
PR Puerto Rico
QA Qatar
RE Reunion
RW RWANDA
SH Saint Helena
KN Saint Kitts and Nevis
LC Saint Lucia
PM Saint Pierre and Miquelon
VC Saint Vincent and the Grenadines
WS Samoa
ST Sao Tome and Principe
SA Saudi Arabia
SN Senegal
SC Seychelles
SL Sierra Leone
SG Singapore
SB Solomon Islands
SO Somalia
ZA South Africa
GS South Georgia and the South Sandwich Islands
LK Sri Lanka
SD Sudan
SR Suriname
SZ Swaziland
SY Syrian Arab Republic
TW Taiwan, Province of China
TJ Tajikistan
TZ Tanzania, United Republic of
TH Thailand
TL Timor-Leste
TG Togo
TK Tokelau
TO Tonga
TT Trinidad and Tobago
TN Tunisia
TM Turkmenistan
TC Turks and Caicos Islands
TV Tuvalu
UG Uganda
AE United Arab Emirates
US United States
UM United States Minor Outlying Islands
UY Uruguay
UZ Uzbekistan
VU Vanuatu
VE Venezuela
VN Viet Nam
VG Virgin Islands, British
VI Virgin Islands, U.S.
WF Wallis and Futuna
EH Western Sahara
YE Yemen
ZM Zambia
ZW Zimbabwe

Document types

TYPE DESCRIPTION
pick_invoice Outcome order invoice

File types

TYPE
application/pdf
application/x-pdf
image/gif
image/png
image/jpeg
image/jpg

Dropshipment types

dropType
alza

Dropshipment item attributes

productAttribute NAME
BCX