MasLogistics Error Catalogue

All errors returned by the MasLogistics API follow a common structure:

json

[
  {
    "code": "MLOG_0001",
    "title": "OUT_OF_STOCK",
    "details": "Out of stock"
  }
]

400 Bad Request — Validation

Code	Title	Description	Possible actions
MLOG_0003	MISSING_MANDATORY_FIELDS	Missing mandatory fields	Check all required fields are present in the request
MLOG_0005	VALUE_NOT_VALID	Value not valid	Check the value format and allowed values for the field
MLOG_0010	VALIDATION_FIELDS	Field not valid	Review the field value against the API specification
MLOG_0018	VALIDATION_FIELDS_SIZE	Field size not valid	Check minLength / maxLength constraints for the field
MLOG_0019	VALIDATION_FIELDS_FORMAT	Field format not valid	Check the field matches the required pattern
MLOG_0020	BAD_REQUEST	Bad request	Review the full request structure and parameters

Code	Title	Description	Possible actions
MLOG_0008	RESERVATION_INVALID	Reservation invalid	Check the reservation exists and belongs to the correct order
MLOG_0009	TRANSITION_NOT_VALID	The current status does not allow the transition	Review the allowed status transitions for the resource
MLOG_0014	DEVICE_NOT_VALID	The device is not valid	Verify the device reference and its current state
MLOG_0015	ORDER_STATUS_NOT_VALID	Order status not valid	Check the order is in a status that allows the requested operation

Code	Title	Description	Possible actions
MLOG_0006	PRODUCT_NOT_EXIST	Product not exists	Verify the product reference exists in the catalogue
MLOG_0011	ORDER_NOT_FOUND	Order not found	Check the order ID is correct and belongs to the organisation
MLOG_0017	SERIAL_NUMBER_NOT_EXISTS	SerialNumber not exists	Verify the serial number is registered in the system

Code	Title	Description	Possible actions
MLOG_0001	OUT_OF_STOCK	Out of stock	Check stock availability before retrying
MLOG_0007	DUPLICATE_UNIQUE_KEY	Duplicate unique key	The resource already exists; check for an existing record before creating
MLOG_0012	RESERVATION_EXPIRED	Reservation already cancelled due to expiration time	Create a new reservation; the previous one has expired
MLOG_0013	PICKING_ALREADY_CONFIRMED	The picking has already confirmed	No action needed; the picking was already processed
MLOG_0016	UNSUBSCRIBE_ALREADY_EXISTS	Unsubscribe already exists	Check for an existing unsubscribe request before creating a new one

Code	Title	Description	Possible actions
MLOG_0002	UNCONTROLLED	Uncontrolled error	Retry the request; if the problem persists contact the logistics team
MLOG_0004	THIRD_PARTY_ERROR	Third party error	A downstream system failed; retry or contact the logistics team
MLOG_0999	THIRD_PARTY_UNKNOWN_ERROR	Internal error	An unexpected internal error occurred; contact the logistics team