Hepsiburada Entegrasyonu: Merchant API Rehberi

# Python ile Hepsiburada'ya ürün ekleme
import requests
from requests.auth import HTTPBasicAuth
import json

API_URL = "https://mpop.hepsiburada.com"
MERCHANT_ID = "12345678"
API_KEY = "your-api-key"

auth = HTTPBasicAuth(MERCHANT_ID, API_KEY)
headers = {"Content-Type": "application/json"}

product = {
    "merchantSku": "LAPTOP-ASUS-001",
    "hepsiburadaSku": "HBV00000ABC123",  # Hepsiburada ürün kodu
    "price": 25000.00,
    "availableStock": 15,
    "dispatchTime": 2,  # Kargo hazırlık süresi (gün)
    "cargoCompany": "HepsiJet",
    "attributes": {
        "Marka": "ASUS",
        "Model": "VivoBook 15",
        "Renk": "Gri",
        "EkranBoyutu": "15.6 inç",
        "RAM": "8 GB",
        "Depolama": "512 GB SSD"
    },
    "images": [
        "https://cdn.example.com/laptop1.jpg",
        "https://cdn.example.com/laptop2.jpg",
        "https://cdn.example.com/laptop3.jpg"
    ],
    "description": "ASUS VivoBook 15 - Intel Core i5, 8GB RAM, 512GB SSD",
    "longDescription": """
        ASUS VivoBook 15, günlük kullanım için ideal performans sunar.
        - İşlemci: Intel Core i5-1135G7 (11. Nesil)
        - RAM: 8 GB DDR4
        - Depolama: 512 GB NVMe SSD
        - Ekran: 15.6" FHD (1920x1080)
        - Grafik: Intel Iris Xe
        - İşletim Sistemi: Windows 11 Home
    """,
    "vatRate": 18,
    "warranty": 24,  # Garanti süresi (ay)
    "categoryId": "18020301"  # Laptop kategorisi
}

response = requests.post(
    f"{API_URL}/product/api/products",
    auth=auth,
    headers=headers,
    json=product
)

if response.status_code in [200, 201]:
    print("Ürün başarıyla eklendi!")
    print(response.json())
else:
    print(f"Hata: {response.status_code}")
    print(response.text)

# Toplu fiyat ve stok güncelleme
def update_price_stock(items):
    """
    items = [
        {"merchantSku": "LAPTOP-ASUS-001", "price": 24500, "stock": 12},
        {"merchantSku": "LAPTOP-HP-002", "price": 18900, "stock": 8},
    ]
    """
    url = f"{API_URL}/product/api/products/price-inventory"

    # Hepsiburada formatına çevir
    payload = {
        "items": [
            {
                "merchantSku": item["merchantSku"],
                "price": item.get("price"),
                "availableStock": item.get("stock"),
                "dispatchTime": 2
            }
            for item in items
        ]
    }

    response = requests.put(url, auth=auth, headers=headers, json=payload)
    return response.json()

# Sadece fiyat güncelleme
def update_price_only(sku, new_price):
    return update_price_stock([{
        "merchantSku": sku,
        "price": new_price
    }])

# Sadece stok güncelleme
def update_stock_only(sku, new_stock):
    return update_price_stock([{
        "merchantSku": sku,
        "stock": new_stock
    }])

# Kampanya fiyatı belirleme
def set_campaign_price(sku, original_price, campaign_price):
    url = f"{API_URL}/product/api/products/campaign-price"

    payload = {
        "merchantSku": sku,
        "listPrice": original_price,
        "salePrice": campaign_price,
        "campaignStartDate": "2026-02-20T00:00:00",
        "campaignEndDate": "2026-02-28T23:59:59"
    }

    response = requests.post(url, auth=auth, headers=headers, json=payload)
    return response.json()

# Sipariş listesi çekme
from datetime import datetime, timedelta

def get_orders(status="Approved", days=7):
    """
    status: Approved, Preparing, Shipped, Delivered, Cancelled, Returned
    """
    url = f"{API_URL}/order/api/orders"

    end_date = datetime.now()
    start_date = end_date - timedelta(days=days)

    params = {
        "status": status,
        "beginDate": start_date.strftime("%Y-%m-%dT%H:%M:%S"),
        "endDate": end_date.strftime("%Y-%m-%dT%H:%M:%S"),
        "page": 0,
        "size": 100
    }

    response = requests.get(url, auth=auth, params=params)
    return response.json()

# Sipariş detayı
def get_order_detail(order_number):
    url = f"{API_URL}/order/api/orders/{order_number}"
    response = requests.get(url, auth=auth)
    return response.json()

# HepsiJet ile kargo bildirimi
def ship_with_hepsijet(order_id, package_items):
    """
    package_items = [
        {"merchantSku": "LAPTOP-ASUS-001", "quantity": 1}
    ]
    """
    url = f"{API_URL}/order/api/orders/{order_id}/shipping"

    payload = {
        "cargoCompany": "HepsiJet",
        "cargoTrackingNumber": None,  # HepsiJet otomatik oluşturur
        "packages": [
            {
                "items": package_items,
                "desi": 5,  # Desi hesaplaması
                "width": 40,
                "height": 30,
                "length": 10
            }
        ]
    }

    response = requests.post(url, auth=auth, headers=headers, json=payload)
    return response.json()

# Kendi kargonuzla gönderim
def ship_with_own_cargo(order_id, tracking_number, cargo_company):
    url = f"{API_URL}/order/api/orders/{order_id}/shipping"

    payload = {
        "cargoCompany": cargo_company,  # "Yurtiçi", "Aras", "MNG", vb.
        "cargoTrackingNumber": tracking_number
    }

    response = requests.post(url, auth=auth, headers=headers, json=payload)
    return response.json()