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
AL Albania
AT Austria
AU Australia
BY Belarus
BE Belgium
BA Bosnia and Herzegovina
BG Bulgaria
CA Canada
HR Croatia
CY Cyprus
DK Denmark
FI Finland
FR France
DE Germany
EE Estonia
GR Greece
IE Ireland
IL Israel
IT Italy
LI Liechtenstein
LT Lithuania
LU Luxembourg
LV Latvia
MT Malta
MC Monaco
NL Netherlands
NO Norway
PL Poland
PT Portugal
RO Romania
RU Russian Federation
SM San Marino
SI Slovenia
ES Spain
SE Sweden
CH Switzerland
TR Turkey
UA Ukraine
GB United Kingdom
US United States

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