Importing orders

1. Get your stores and status codes

• GetStores returns the stores in your account with their StoreId and marketplace (IntegrationId). Orders are pulled per store.
• GetIntegrationOrderListingStatus returns each store's order status codes (for example Created, Shipped, Cancelled). Codes differ per marketplace, so do not rely on a fixed list. Statuses with Erp: 1 are the ones suitable for ERP/accounting import.

2. Pull orders

Get orders with GetSales. StoreId and OrderStatus are always required. Select orders with one of three methods:

Incremental example:

{
  "ApiCode": "API_CODE",
  "StoreId": 12345,
  "OrderStatus": "Created",
  "BiggestOrderDetailId": 9876543,
  "PageIndex": 1,
  "RowsByPage": 200
}

Date range example (orders from 1 to 3 November):

{
  "ApiCode": "API_CODE",
  "StoreId": 12345,
  "OrderStatus": "Created",
  "StartDate": "2026-11-01T00:00:00",
  "EndDate": "2026-11-03T00:00:00",
  "PageIndex": 1,
  "RowsByPage": 200
}

3. Paging

• PageIndex starts at 1. RowsByPage is the number of orders per page (not lines); the default is 20 and the maximum is 200.
• TotalOrderCount in the response is the total number of matching orders. Increase PageIndex until you have received that many.
• Orders are always sorted by order date, newest first.

4. Statuses are per line

Each line (item) of an order has its own status. GetSales applies the status filter to lines: an order comes back with only its lines in the requested status. So:

• Make a separate request for each status code you import.
• Use GetOrder to see all lines of an order.
• Check the current status of specific lines with GetOrderDetailStatus.

5. Dates and times

• Send request dates in Turkey time without an offset: 2026-11-05T14:30:00. Do not use local formats such as 05.11.2026.
• In responses, OrderDate, CargoDate, InvoiceTime, PackageTime and WayBillTime are UTC (with a Z). LastModificationTime is Turkey time without an offset.
• Empty dates come back as 1899-12-31T22:03:00Z, not null. Treat any date before 1900 as empty.

Recommended flow

1. At start-up, get the status codes for each store and choose the statuses you import.
2. Every few minutes, call GetSales with BiggestOrderDetailId for each store and status, and read every page.
3. Store orders by OrderId and lines by OrderDetailId; if an ID arrives again, update it instead of creating a new record.
4. Save the largest OrderDetailId only after the orders are written to your own system.
5. To catch cancellations and returns, also pull changed lines with LastModificationTimeFrom.
6. After invoicing, send the invoice details back: Shipping and invoices.

Other order operations

• SetOrderNotes: writes a note on the order inside StockMount; it is not sent to the marketplace.
• SetOrder and SetOrderDetailStatus: create orders and change line statuses in StockMount-type (your own) stores only. Marketplace order statuses come from the marketplace.
• ConfirmOrRejectOrderItem: confirms or rejects N11 order items.