Hepsiburada Integration

Connect your Hepsiburada merchant account, browse your live listings and order packages, and ask the AI Assistant questions about stock, pricing, and shipments.

Overview

The Hepsiburada Integration screen (Ecommerce → Marketplace Hub → Hepsiburada) is the connection hub between TotalApp and your Hepsiburada merchant account. It manages your API credentials, loads your live listing catalog and order packages, lists the exact Hepsiburada REST endpoints in use, and provides an embedded AI Assistant with direct context of your marketplace data.

Server-Side API Calls Only

All requests to the Hepsiburada Listing API (listing-external.hepsiburada.com) and Order Management System (oms-external.hepsiburada.com) are made from the TotalApp server using HTTP Basic authentication, never directly from your browser. This keeps your API username and password secure and avoids CORS restrictions.

Setting Up the Connection

Step 1 — Get Your Hepsiburada Integration Credentials

TotalApp connects using your Hepsiburada Merchant ID and API credentials. To find them:

Log in to the Hepsiburada Merchant Panel (merchant portal).
Go to Account → Integration Information.
Copy your Merchant ID.
Copy your API Username and API Password.

Step 2 — Enter Credentials in TotalApp

Open Settings → Integrations → Ecommerce → Hepsiburada and enter:

Field	Where to find it	Example
Merchant ID	Hepsiburada Merchant Panel → Account → Integration Info	`a1b2c3d4-...`
API Username	Hepsiburada Merchant Panel → Account → Integration Info	`merchant_username`
API Password	Hepsiburada Merchant Panel → Account → Integration Info	`xxxxxxxxxxxxxxxx`

Back on the Hepsiburada Integration screen, open the Merchant Connection panel and click Test Connection. TotalApp fetches a page of your listings and reports the count if the credentials are valid.

Step 3 — Load Live Data

Use Load Listings and Load Packages to pull the latest snapshot from Hepsiburada:

Listing Catalog — merchant SKU, HB SKU, product name, available stock, price, and listing status.
Order Packages — order number, package number, customer, item count, total price, and package status.

On-Demand Sync

Data is loaded on demand, not synced automatically in the background. Click the load buttons whenever you want the tables and the AI Assistant to reflect the latest Hepsiburada state.

API Endpoints

The screen exposes an API Endpoints reference panel listing the exact Hepsiburada Listing and Order Management (OMS) endpoints TotalApp uses. Path parameters such as {merchantId}, {packageNumber}, and {status} are filled at call time.

Listing API — listing-external.hepsiburada.com

Method	Path	Purpose
`GET`	`/listings/merchantid/{merchantId}`	List merchant products (listings)
`POST`	`/listings/merchantid/{merchantId}/inventory-uploads`	Upload price & inventory updates

Order Management (OMS) — oms-external.hepsiburada.com

Method	Path	Purpose
`GET`	`/packages/merchantid/{merchantId}`	List seller packages
`GET`	`/orders/merchantid/{merchantId}/paymentawaiting`	List payment-awaiting orders
`POST`	`/packages/merchantid/{merchantId}/packagenumber/{packageNumber}/deliver`	Send delivery status (delivered)
`GET`	`/claims/merchantId/{merchantId}/status/{status}`	Retrieve merchant claims / returns
`GET`	`/transactions/merchantid/{merchantId}`	Record-based accounting service

SIT (Test) Environment

Hepsiburada provides a SIT (System Integration Test) environment on the -sit hostnames (e.g. oms-external-sit.hepsiburada.com). Use it to validate your integration before switching to the production hosts shown above.

AI Assistant

The AI Assistant panel on the right side of the screen gives you a conversational interface into your Hepsiburada data. When credentials are configured, TotalApp fetches your live listings and packages server-side and provides them as context, so the AI can answer analytical questions instantly.

What You Can Ask

Stock questions: “Which listings are low on stock?”
Order questions: “Summarise this week’s packages by status.”
Fulfillment questions: “List packages awaiting shipment.”
Pricing questions: “Which listings have the highest price?”

Writer Engine Support

The assistant respects your Settings → Agentic → Writer Engine choice. In Local CLI or Hosted API mode, live Hepsiburada data is fetched server-side and included as context. In Ollama, Local LLM, or Web LLM mode the request runs entirely client-side and live marketplace data is not available — switch to Local CLI or Hosted API for data-driven reports.

Saving as a Report

After the AI responds, a Save as Report button appears under the reply. Clicking it saves the response as a named report in Ecommerce Reports, automatically titled with your question and the current month.

Frequently Asked Questions

Where are my Hepsiburada credentials stored?

Your Merchant ID, API Username, and API Password are stored via Settings → Integrations. All calls to Hepsiburada are made from the TotalApp server using HTTP Basic authentication — credentials are never exposed to the browser.

The connection test fails with an HTTP 401. What should I check?

A 401 means the API Username/Password pair is wrong or the Merchant ID does not match the credentials. Re-copy all three values from the Hepsiburada Merchant Panel → Account → Integration Information and test again.

Why do listings and packages use different base URLs?

Hepsiburada splits its APIs across services: the Listing API lives on listing-external.hepsiburada.com and the Order Management System (OMS) lives on oms-external.hepsiburada.com. TotalApp routes each request to the correct host automatically.