Taslak Gönderi İşle

Bu API, mevcut bir taslak gönderiyi gerçek bir gönderiye dönüştürmek için kullanılır. İşlem sonucunda kargo etiketi oluşturulur ve gönderi kargo firmasına iletilir.

Endpoint Bilgileri

İşlem Akışı

Taslak Gönderi (status: 24) → Process → Aktif Gönderi (status: 2/3)
                                ↓
                          Kargo Etiketi Oluşturulur

İstek Parametreleri

URL Parametreleri

Gövde Parametreleri (Opsiyonel)

Process isteğinde gövde parametreleri göndererek, taslağı önce güncelleyip sonra işleme alabilirsiniz. Bu sayede tek istekte hem güncelleme hem işleme yapılır.

Kullanılabilir parametreler için Taslak Gönderi Oluştur sayfasına bakın.

Örnek Kullanım

Sadece Process (Güncelleme Olmadan)

Taslak zaten tamamsa, boş gövde ile process yapabilirsiniz:

curl -X POST "{{BASE_URL}}/api/v1/consignments/draft/243/start-process" \
  -H "Content-Type: application/json" \
  -H "APIKEY: {{APIKEY}}"

<?php
$client = new \GuzzleHttp\Client();

$draftId = 243;

$response = $client->request('POST', "{{BASE_URL}}/api/v1/consignments/draft/{$draftId}/start-process", [
    'headers' => [
        'Content-Type' => 'application/json',
        'APIKEY' => '{{APIKEY}}'
    ]
]);

$body = json_decode($response->getBody(), true);

// Kargo etiketi ve takip bilgileri
$barcode = $body['data']['barcode'];
$label = $body['data']['base64label'];

print_r($body);

<?php
$draftId = 243;

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => "{{BASE_URL}}/api/v1/consignments/draft/{$draftId}/start-process",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'APIKEY: {{APIKEY}}'
    ]
]);

$response = curl_exec($ch);
$result = json_decode($response, true);

// Kargo etiketi ve takip bilgileri
$barcode = $result['data']['barcode'];

curl_close($ch);

Process + Güncelleme (Paket Bilgisi Ekleme)

Taslakta eksik olan paket bilgilerini ekleyerek process yapma:

POST {{BASE_URL}}/api/v1/consignments/draft/243/start-process
Content-Type: application/json
APIKEY: {{APIKEY}}

{
    "packages": [
        {
            "package_type": 1,
            "post_type": 4,
            "weight": 2,
            "length": 30,
            "width": 20,
            "height": 15,
            "dangerous_goods": false,
            "items": [
                {
                    "description": "Bosch Kahve Makinesi",
                    "gtip": "851671900000",
                    "origin": "TR",
                    "currency_code": "EUR",
                    "quantity": 1,
                    "unit_price": 200
                }
            ]
        }
    ]
}

API Cevabı

Başarılı Yanıt

{
    "status": true,
    "message": "Draft Consignment process start successfully",
    "data": {
        "consignment": 243,
        "barcode": "C2H32972076995",
        "c2hBarcode": "C2H32972076995",
        "providerTrackingCode": "1Z999AA10123456784",
        "trackingUrl": "https://provider.com/track/1Z999AA10123456784",
        "contentType": "application/pdf",
        "base64label": "...base64_label_data..."
    }
}

Response Alanları

Hata Yanıtları

{
    "status": false,
    "errors": [
        {
            "message": "Consignment not found or not in draft status"
        }
    ]
}

Yaygın Hata Senaryoları

Sonraki Adımlar

Process başarılı olduktan sonra:

1. Etiket Yazdırma: base64label alanını decode ederek etiketi yazdırın
2. Takip: trackingUrl veya c2hBarcode ile gönderiyi takip edin
3. Webhook: Durum değişikliklerini almak için Webhook kurulumu yapın