In the events of API request errors, OPLOG.ONE uses conventional HTTP response codes in the 4XX and 5XX range to indicate the reason behind the error.
OPLOG.ONE uses conventional HTTP response codes to indicate the success or failure of an API request. In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error that resulted from the provided information (e.g. a required parameter was missing, a duplicate reference number already exists, etc.), and codes in the 5xx range indicate an error with OPLOG.ONE’s servers.

​
HTTP Status Codes

Status CodeDescription
2xx Success
200 OKRequest succeeded
201 CreatedResource successfully created
4xx Client Error
400 Bad RequestInvalid request format or parameters
401 UnauthorizedInvalid API key or authentication
404 Not FoundResource not found
429 Too Many RequestsRate limit exceeded
5xx Server Error
500 Internal Server ErrorSomething went wrong on OPLOG.ONE’s end
502 Bad GatewayTemporary server issue
503 Service UnavailableService temporarily unavailable

​
OPLOG Error Code Reference

Here you will find the error codes and descriptions you may encounter during various operations in the OPLOG API. Error codes are categorized by operation type.

​
Error Code Usage Tips

​
General Rules

  • Required Fields: Related error codes are returned for required fields left empty
  • Format Checks: Field name and expected format are specified for invalid format errors
  • Character Limits: Maximum character limits are defined for each field
  • Uniqueness: SKU, Barcode, and Reference numbers must be unique

​
General Error Codes

Error codes you may encounter in general system and integration errors:

​
System Errors

Error CodeDescriptionError ID
UnhandledExceptionAn unexpected error occurred. Please contact your customer representative.25
UnknownAn unknown error occurred. Please contact your customer representative.6
MaestroPackageCancelSyncFailedError occurred in Maestro package cancellation synchronization.7

​
Integration Errors

Error CodeDescriptionError ID
UpdateFromDifferentIntegrationThe request cannot be edited outside of its source.26
EmptyIntegrationIdIntegrationId field has been sent empty.55
IntegrationIsNotActiveThe integration you are sending requests to is not active. You can activate it from the integrations page.84

​
Resource and URL Errors

Error CodeDescriptionError ID
ResourceAlreadyExistsResource is already in use.0
ResourceNotFoundResource not found.1
InvalidContentTypeInvalid field type2
InvalidUrlContains invalid URL.48

​
Sales Order Error Codes

Error codes you may encounter during order creation, update, and management operations:

​
Reference Number Errors

Error CodeDescriptionError ID
ReferenceNumberAlreadyExistsReference number must be unique.0
ReferenceNumberTooLongReference number exceeds character limit.27
InvalidSalesOrderReferenceNumberSales order reference number has been sent in an invalid format.33

​
Address Validation Errors

Error CodeDescriptionError ID
EmptyAddressFirstNameAddressFirstName field is required.1
EmptyAddressLastNameAddressLastName field is required.2
EmptyAddressPhoneAddressPhone field is required.3
EmptyAddressOneAddressOne field is required.4
EmptyAddressCityAddressCity field is required.5
EmptyAddressPostalCodeAddressPostalCode is required for orders from TR to abroad and foreign warehouse orders.6
EmptyAddressCountryAddressCountry field is required.7
InvalidCountryContains invalid country name.45
InvalidCityContains invalid city name.46
InvalidDistrictContains invalid district name.47
InvalidAddressAddress contains invalid format.49

​
Address Character Limit Errors

Error CodeDescriptionError ID
AddressFirstNameMaxLengthAddress first name field exceeds character limit.68
AddressLastNameMaxLengthAddress last name field exceeds character limit.69
AddressPhoneMaxLengthAddress phone field exceeds character limit.70
AddressEmailMaxLengthAddress email field exceeds character limit.71
AddressOneMaxLengthAddressOne field exceeds character limit.72
AddressTwoMaxLengthAddressTwo field exceeds character limit.73
AddressDistrictMaxLengthAddressDistrict field exceeds character limit.74
AddressPostalCodeMaxLengthAddressPostalCode field exceeds character limit.75
AddressCityMaxLengthAddressCity field exceeds character limit.76
AddressCountryMaxLengthAddressCountry field exceeds character limit.77

​
Customer Information Errors

Error CodeDescriptionError ID
EmptyCustomerFirstNameCustomerFirstName field is required.8
EmptyCustomerLastNameCustomerLastName field is required.9
EmptyCustomerPhoneCustomerPhone field is required.10
CustomerEmailWrongFormatEmail has been formatted incorrectly.11

​
Product and Quantity Errors

Error CodeDescriptionError ID
EmptyLineItemSkuSKU in product information cannot be sent empty.12
LineItemQuantityErrorQuantity information must be a positive integer.13
LineItemNotFoundProduct definition not found.14
SalesOrderHasLineItemsWithSameSkuThere are duplicate SKUs in order LineItems. Sum up the Amount quantities for duplicate SKUs.28

​
Payment Errors

Error CodeDescriptionError ID
EmptySalesOrderPaymentCurrencyCurrency is required for orders from TR to abroad and foreign warehouse orders.15
EmptySalesOrderPaymentTotalPaymentAmountCurrency amount is required for orders from TR to abroad and foreign warehouse orders.16
UnsupportedCurrencyContains unsupported currency.22
InvalidCodReceiptTotalAmountCash on delivery amount has been sent in invalid format.78

​
CoD (Cash on Delivery) Errors

Error CodeDescriptionError ID
EmptyCoDKeyThe CoD key you specified is empty or incorrect.17
EmptyOrMultipleCodKeyThe specified CoD Key is empty or incorrect.18
CoDKeysNotEqualToPaymentGatewayThe specified CoD Key is empty or incorrect.19
SalesOrderPaidWhenCoDKeysExistPaymentType is empty or CoD key is incorrect.20
SalesOrderNotPaidWhenCoDPassivePaymentType Paid was not sent while cash on delivery feature is not active.21
MarketplaceNoCoDCoD is not supported for marketplace orders.79

​
Cargo Errors

Error CodeDescriptionError ID
CargoCarrierNotFoundCargo carrier is not defined. Please get the current cargo list via CargoCarriers endpoint.32
CargoCodeAndCargoDocumentUrlCannotBeNullOrEmptyCargo code and cargo document URL cannot be empty.60
SalesOrderDoesNotSupportCargoInfoUpdateOrder does not support cargo information updates.62

​
Same Day Delivery Errors

Error CodeDescriptionError ID
CargoDocumentURLAndCargoCodeShouldBeEmptyWhenCargoTypeIsSameDayDeliveryCargoDocumentURL and CargoCode should be empty for SameDayDelivery delivery type.44
SameDayDeliveryNotEnabledSame Day Delivery is not active. Please contact your customer representative.57
OutOfCoverageSameDayDeliveryA city outside the cities supporting Same Day Delivery has been sent.58

​
Gift and Additional Services

Error CodeDescriptionError ID
GiftWrapTypeGift note was sent with a value other than true/false.51
GiftNotesTooLong2000 character limit exceeded.52

​
Order Status Errors

Error CodeDescriptionError ID
CancelledSalesOrderCannot perform operations on cancelled order.61
DeliveredSalesOrderCannot make changes on delivered order.63

​
Receiving Order Error Codes

Error codes you may encounter during receiving operations:
Error CodeDescriptionError ID
InvalidReceivingOrderReferenceNumberReceiving order reference number has been sent in an invalid format.34
EmptyReceivingOrderShipmentDateReceiving order ShipmentDate has been sent empty.38
InvalidReceivingOrderShipmentDateReceiving order ShipmentDate has been sent in invalid format.39
ReceivingOrderExpectedDeliveryDateEmptyExpectedDeliveryDate has been sent empty in receiving order request.42
ReceivingOrderTransferTypeEmptyReceiving order TransferType field has been sent empty.59
ReceivingOrderTransferTypeTransferDetailsMismatchTransfer type and transfer details do not match.67

​
Product Error Codes

Error codes you may encounter during product definition and management operations:

​
SKU and Barcode Errors

Error CodeDescriptionError ID
ProductSKUAlreadyExistsSKU has been used before among product definitions. SKU must be unique when defining products.0
ProductBarcodeAlreadyExistsBarcode has been used before among product definitions. Barcode must be unique when defining products.1
SameBarcodeForDifferentSkusAtBarcodesSheetErrorBarcode is defined on another SKU. Barcode must be unique when defining products.2
ProductSKUAlreadyExistsSKU information is being used. SKU must be unique.37

​
Required Field Errors

Error CodeDescriptionError ID
ProductSKUIsEmptySKU field cannot be empty when defining products.3
ProductBarcodeIsEmptyBarcode field cannot be empty when defining products.4
ProductNameIsEmptyName field cannot be empty when defining products.5

​
Product Management Errors

Error CodeDescriptionError ID
ProductNotFoundThe queried product was not found in our product definition query.7
SalesUrlIsNotValidSalesUrl field in product definition is not valid.8
BarcodeCantBeChangedBarcode defined in product definition cannot be changed.11

​
Error Response Format

When an error occurs, OPLOG.ONE returns a structured error response: 
{
  "error": {
    "code": 400,
    "message": "Validation Errors",
    "errors": [
      {
        "property": "AddressOneMaxLength",
        "message": "AddressOneMaxLength",
        "errorCode": "AddressOneMaxLength"
      }
    ]
  },
  "requestId": "0HMA1B2C3D4E5F678:00000001",
  "timestamp": "2025-06-24T13:37:00.123Z"
}
Error Handling Best Practice: Always check the errorCode and property fields to programmatically handle specific error scenarios in your application. Use requestId for support inquiries.