Getting started

Error codes

Business errors return HTTP 200: Result is false and ErrorCode and ErrorMessage are set. Always branch on ErrorCode; the ErrorMessage text may change and its language differs by endpoint.

HTTP status codes

HTTP	Meaning
`200`	The request was processed. Read Result to see whether it succeeded.
`400`	The body is empty or not valid JSON. The response is a standard ProblemDetails object, not ResultInfo.
`404`	Wrong URL. Check the controller and action names.
`410`	The endpoint was removed. Its page names the replacement.
`5xx`	Temporary server error. Wait and retry.

Error codes

Code	Meaning	What to do
`00001`NotAuthenticated	Authentication failed. The `ApiCode` could not be decoded or the session expired; for `DoLogin`, wrong credentials, a passive account or a passive API key.	Get a new `ApiCode` with `DoLogin` and retry. If `DoLogin` also returns `00001`, check your credentials and the account/API key status in the panel.
`00002`AccountPassive	The account is passive.	Check your account status in the panel or contact support.
`00003`MissingParameter	A required field is missing or invalid (e.g. 0 or empty). `ErrorMessage` usually contains the field name.	Add the parameter named in `ErrorMessage` and retry. If `ErrorMessage` is `ApiCode`, call `DoLogin` first.
`00004`RequiredField	A field value was not accepted; e.g. the shipment company code is not in the marketplace's list.	Check `ErrorMessage`. For shipment codes, use the `GetIntegrationShipmentCompanies` list.
`00005`BadReqeust	The request could not be processed ("Bad request!").	Check the request body and field values, then try again.
`00006`SessionTimedOut	The `ApiCode` does not contain valid session data (incomplete or corrupted code).	Get a new `ApiCode` with `DoLogin` and send it unchanged.
`00007`TooManyRequests	The per-minute request limit was exceeded (per user, or DoLogin per IP).	Wait a minute and retry. Queue your requests, and call `DoLogin` only when you get `00001`/`00006`, not before every request.
`10001`InvalidStore	Invalid store: not found, not yours, or not valid for this operation.	Verify the `StoreId` with `GetStores`.
`20001`UserWasNotFound	User not found.	Check your account details.
`50001`SetOrder	The order could not be saved.	Check the data you sent and try again. If it persists, contact support with the `ErrorMessage`.
`50002`SetOrderBuyer	The order's buyer data could not be saved.	Check the buyer fields and try again.
`50003`SetOrderDetail	An order line could not be saved.	Check the order line fields and try again.
`50004`DeleteOrderDetail	An order line could not be deleted.	Check the data you sent and try again. If it persists, contact support with the `ErrorMessage`.
`50005`OrderExist	The order already exists. In this case `SetOrder` returns the existing order in `Response`.	Do not create the order again; use the record in `Response`.
`50006`OrderNotExisted	The order was not found.	Check the order ID.
`50007`SetOrderListingStatus	The order status could not be updated.	Verify the status code with `GetIntegrationOrderListingStatus` and try again.
`60001`IntegrationError	The marketplace or platform rejected the operation or returned an error. Details are in `ErrorMessage`.	Fix the marketplace error in `ErrorMessage`. If it is temporary, try again later.
`60002`SaleItemWasShippedBefore	The order line has already been shipped.	Do not send the shipment information again.
`60003`IntegrationSettingNotFound	The store's integration settings (marketplace API credentials) were not found.	Complete the store's integration settings in the panel.
`60004`IntegrationOrderCanNotBeRetrieved	The order could not be retrieved from the marketplace.	Try again later. If it persists, check the order number.
`60005`ProductQuantityIsLessThanMinQuantity	The product stock is below the minimum quantity set for sending.	Update the stock or the minimum quantity setting.
`60006`ListingTempalteWasNotFound	No listing template was found for the product.	Define a listing template for the store in the panel.
`60007`CategoryMappingWasNotFound	The product's category is not mapped to a marketplace category.	Map the category in the panel.
`60008`ProductPriceIsEqualToZero	The product price is zero.	Set a price greater than zero.
`60009`ProductPriceLessThanMinPrice	The product price is below the minimum price.	Update the price or the minimum price setting.
`60010`ProductHasNoImage	The product has no image.	Add at least one image to the product.
`60011`ProductDeleted	The product has been deleted.	Do not operate on a deleted product, or add it again.
`60012`LanguageWasNotFoundForSchema	No language is defined for the product source.	Set the language of the product source in the panel.
`60013`ProductCouldNotBePrepared	The product could not be prepared for the marketplace.	Fix the product data or the panel mappings and send the product again.
`60014`ProductVariantMappingWasNotFound	The product variants are not mapped to marketplace variants.	Map the variants in the panel.
`60015`ProductMarketPriceLessThanPrice	The product's market (list) price is lower than its sale price.	Make the market price equal to or higher than the sale price.
`60016`ProductMarketStoreCodeInvalid	The product's marketplace store code is invalid.	Fix the product data or the panel mappings and send the product again.
`60017`BrandMappingNotFound	The product's brand is not mapped to a marketplace brand.	Map the brand in the panel.
`60101`IntegrationCategorySynchronization	An error occurred while synchronizing marketplace categories.	Try again later.
`60501`ProductSourceUrlInvalid	The product source URL is invalid or unreachable.	Check the URL and its access permissions.
`60502`FtpDirectoryCouldNotBeCreated	A folder for the product source file could not be created on the server.	Try again later; if it persists, contact support.
`60503`FtpFileCanNotBeUploded	The product source file could not be uploaded to the server.	Try again later; if it persists, contact support.
`70001`InvalidTaxRate	The tax (VAT) rate is invalid.	Send a valid VAT rate.
`70002`InvalidProductSource	The product source is invalid or was not found.	Check the product source ID.
`70003`InvalidProductSourceType	The product source type is not valid for this operation.	Use a product source of the StockMount type.
`70004`InsertedProductCodeExists	Another product already uses this product code.	Use a different product code or update the existing product.
`70005`ProductWasNotFound	The product was not found.	Check the product ID or code.
`70006`BrandNameRequired	The brand name is required.	Add a brand name to the product.
`70007`BarcodeRequired	A barcode is required.	Add a barcode to the product.
`70008`ProductWasAddedBefore	The product was added before or is already listed on the marketplace.	Update the existing record instead of adding it again.
`70009`InvalidProductCodeLength	The product code is too long (maximum 50 characters).	Shorten the product code to 50 characters or less.
`70010`InvalidBarcode	The barcode is invalid.	Send a valid barcode.
`70011`InvalidProductType	The product type is invalid.	Send a valid product type.
`70012`BarcodeContainsSpecialChar	The barcode contains special characters the marketplace does not accept.	Remove special characters from the barcode.
`70013`ProductWasNotChanged	The product was not sent to the marketplace again because it has not changed since the last send.	No action needed.
`70014`ProductInProgress	The product is being processed on the marketplace.	Check the status again later.
`70015`InvalidImageFormatWebp	A product image is in .webp format, which the marketplace does not accept.	Send the image in a supported format such as JPG or PNG.
`70016`InvalidImageUrlProtocol	A product image URL does not start with `http://` or `https://`.	Send image URLs as full URLs.
`70017`InCatalogApproval	The product is in the N11 catalog approval process.	Wait for the approval result.
`70018`ProductPackageRequired	Product operations need an active Product Package ("Ürün entegrasyonu için aktif Ürün Paketi gereklidir."). If the package cannot be verified, `99999` is returned instead ("Paket bilgisi doğrulanamadı. Lütfen tekrar deneyin.").	Buy or renew the Product Package in the panel.
`89001`InsertError	The record could not be inserted.	Check the data you sent and try again. If it persists, contact support with the `ErrorMessage`.
`89002`UpdateError	The record could not be updated.	Check the data you sent and try again. If it persists, contact support with the `ErrorMessage`.
`89003`DeleteError	The record could not be deleted.	Check the data you sent and try again. If it persists, contact support with the `ErrorMessage`.
`89004`InsertUpdateError	The record could not be inserted or updated.	Check the data you sent and try again. If it persists, contact support with the `ErrorMessage`.
`99988`PackageValidation	`DoLogin`: the account has no valid package or Out API service that gives API access, or the package data could not be read. `ErrorMessage` starts with "Package can not be validated! ...".	Check your package or API service in the panel; buy or renew it if needed. If the message says "Type: 3", try again later.
`99999`Exception	An unexpected server error occurred. `ErrorMessage` can be empty or contain a technical error text.	Try again shortly. For requests that change data, check whether the operation was applied before retrying. If it persists, contact support with the `ErrorMessage`.