🚴 Kurye Entegrasyonu Dokümantasyonu

// Restomenum POS, siparişi kurye firmasına gönderir
POST https://kurye-firmasi.com/api/webhook
Headers:
  Content-Type: application/json
  Accept: application/json
  Authorization: Bearer abc123xyz_restaurant_unique_token

Body: {
  "id": "250306031353V2F52",
  "customer": { ... },
  "address": { ... },
  ...
}

// Kurye firması API'sinde token kontrolü
// Her token bir restorana ait olduğundan, 
// gelen Authorization token'a bakarak restoran tespit edilir

const token = request.headers.authorization.replace('Bearer ', '');

// Token veritabanında aranır
const restaurant = await findRestaurantByToken(token);

if (!restaurant) {
    return response.status(401).json({
        error: "Geçersiz authorization token"
    });
}

// Sipariş, tespit edilen restorana ait olarak işlenir
console.log(`Sipariş ${restaurant.name} restoranından geldi`);

// Token üretim örneği (Node.js)
const crypto = require('crypto');

function generateRestaurantToken(restaurantId) {
    const token = crypto.randomBytes(32).toString('hex');
    
    // Veritabanına kaydet
    await db.tokens.create({
        token: token,
        restaurantId: restaurantId,
        createdAt: new Date()
    });
    
    return token;
}

// Örnek: "a7f3c9e2b4d8f1a6c5e9d3b7f2a8c4e6d1b9f5a3c7e2d4b8f6a1c9e5d3b7f2a8"

// Kurye firması API'sinde test endpoint'i
// Test siparişi göndererek entegrasyonu doğrulayın

POST /api/webhook/test
Headers:
  Authorization: Bearer [RESTAURANT_TOKEN]

Response:
{
    "success": true,
    "restaurant": {
        "id": "12345",
        "name": "Füreyya Restaurant",
        "phone": "0212XXXXXXX"
    },
    "message": "Token doğrulandı. Entegrasyon aktif."
}

{
    "id": "250306031353V2F52",
    "customer": {
        "fullName": "SAMET KARAKAYA",
        "phoneNumber": "05527283903",
        "phoneCode": null
    },
    "address": {
        "text": "BEM 330 SK ŞÜKÜR ST. G BLOK  ZİL 2",
        "description": null,
        "lat": null,
        "lon": null
    },
    "products": [
        {
            "id": "16571086",
            "name": "2 Kişilik Füreyya Menü",
            "price": "295",
            "quantity": "1",
            "options": null
        }
    ],
    "source": "sanaladisyon.com",
    "note": null,
    "totalAmount": "295",
    "totalDiscount": "0",
    "paymentMethod": "NAKIT",
    "platformCode": "109580",
    "dailyOrderNo": "0",
    "createdAt": "2025-03-06 03:00:17",
    "scheduledAt": null,
    "courierPhone": null,
    "callbackUrls": {
        "orderPickupUrl": "https://api.restomenum.app/integrations/kurye/{storeId}/{packetId}/pickup?token={token}",
        "orderDeliveredUrl": "https://api.restomenum.app/integrations/kurye/{storeId}/{packetId}/delivered?token={token}"
    }
}

// Kurye paketi teslim aldığında orderPickupUrl çağrılır
POST https://api.restomenum.app/integrations/kurye/{storeId}/{packetId}/pickup?token={token}

// Body göndermeye gerek yoktur; token URL içindedir.
// Başarılı yanıt:
{
    "success": true,
    "status": "OnDelivery"
}