Taslak Gönderi Oluştur

Bu API, taslak (draft) gönderi oluşturmak için kullanılır. Taslak gönderiler, tüm bilgiler henüz hazır olmadığında veya daha sonra işlenmek üzere kaydedilmek istendiğinde kullanılır.

Endpoint Bilgileri

Taslak Gönderi Nedir?

Taslak gönderiler, normal gönderilerden farklı olarak:

Ne Zaman Kullanılır?

• Paket bilgileri henüz belli değilse
• Toplu gönderi girişi yapılacaksa
• Gönderi bilgilerinin daha sonra tamamlanması gerekiyorsa
• Sipariş alındığında gönderi kaydı oluşturup, paketleme sonrası işlemek istiyorsanız

İstek Parametreleri

Temel Parametreler

Gönderen Bilgileri

Alıcı Bilgileri

Paket Bilgileri (Opsiyonel)

Taslak gönderilerde paket bilgileri opsiyoneldir. Daha sonra Taslak Güncelle veya Process aşamasında eklenebilir.

Paket İçerik Bilgileri (Opsiyonel)

Döküman Bilgileri (Opsiyonel)

Ek Hizmet Bilgileri (Opsiyonel)

Örnek Kullanım

Minimal Taslak Oluşturma (Sadece Adres Bilgileri)

curl -X POST "{{BASE_URL}}/api/v1/consignments/draft" \
  -H "Content-Type: application/json" \
  -H "APIKEY: {{APIKEY}}" \
  -d '{
    "provider_id": 7,
    "preference": 0,
    "consignor": {
        "name": "Gönderen Firma A.Ş.",
        "country": "TR",
        "state": "İstanbul",
        "city": "Kadıköy",
        "postal_code": "34758",
        "address": "Moda Caddesi No:1",
        "phone_number": "+902161234567",
        "email": "info@firma.com"
    },
    "consignee": {
        "name": "Hans Mueller",
        "country": "DE",
        "state": "Hamburg",
        "city": "Altona",
        "postal_code": "22765",
        "address": "Beispielstraße 123",
        "phone_number": "+4940123456",
        "email": "hans@example.de"
    }
}'

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

$response = $client->request('POST', '{{BASE_URL}}/api/v1/consignments/draft', [
    'headers' => [
        'Content-Type' => 'application/json',
        'APIKEY' => '{{APIKEY}}'
    ],
    'json' => [
        'provider_id' => 7,
        'preference' => 0,
        'consignor' => [
            'name' => 'Gönderen Firma A.Ş.',
            'country' => 'TR',
            'state' => 'İstanbul',
            'city' => 'Kadıköy',
            'postal_code' => '34758',
            'address' => 'Moda Caddesi No:1',
            'phone_number' => '+902161234567',
            'email' => 'info@firma.com'
        ],
        'consignee' => [
            'name' => 'Hans Mueller',
            'country' => 'DE',
            'state' => 'Hamburg',
            'city' => 'Altona',
            'postal_code' => '22765',
            'address' => 'Beispielstraße 123',
            'phone_number' => '+4940123456',
            'email' => 'hans@example.de'
        ]
    ]
]);

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

// Taslak ID'sini saklayın - daha sonra process için kullanılacak
$draftId = $body['data']['id'];
$draftUuid = $body['data']['uuid'];

print_r($body);

<?php
$payload = [
    'provider_id' => 7,
    'preference' => 0,
    'consignor' => [
        'name' => 'Gönderen Firma A.Ş.',
        'country' => 'TR',
        'state' => 'İstanbul',
        'city' => 'Kadıköy',
        'postal_code' => '34758',
        'address' => 'Moda Caddesi No:1',
        'phone_number' => '+902161234567',
        'email' => 'info@firma.com'
    ],
    'consignee' => [
        'name' => 'Hans Mueller',
        'country' => 'DE',
        'state' => 'Hamburg',
        'city' => 'Altona',
        'postal_code' => '22765',
        'address' => 'Beispielstraße 123',
        'phone_number' => '+4940123456',
        'email' => 'hans@example.de'
    ]
];

$ch = curl_init();

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

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

// Taslak ID'sini saklayın
$draftId = $result['data']['id'];

curl_close($ch);

Tam Taslak Oluşturma (Paket Bilgileri Dahil)

{
    "provider_id": 7,
    "preference": 0,
    "incoterms_type": 2,
    "reference_no": "ORDER-2024-001",
    "consignor": {
        "name": "Gönderen Firma A.Ş.",
        "country": "TR",
        "state": "İstanbul",
        "city": "Kadıköy",
        "postal_code": "34758",
        "address": "Moda Caddesi No:1",
        "phone_number": "+902161234567",
        "tax_number": "1234567890"
    },
    "consignee": {
        "name": "Hans Mueller",
        "country": "DE",
        "state": "Hamburg",
        "city": "Altona",
        "postal_code": "22765",
        "address": "Beispielstraße 123",
        "phone_number": "+4940123456"
    },
    "packages": [
        {
            "package_type": 1,
            "post_type": 4,
            "weight": 1.5,
            "length": 30,
            "width": 20,
            "height": 15,
            "dangerous_goods": false,
            "items": [
                {
                    "description": "Electronic Device",
                    "gtip": "854370900000",
                    "origin": "TR",
                    "currency_code": "EUR",
                    "unit_price": 150.00,
                    "quantity": 1
                }
            ]
        }
    ]
}

API Cevabı

Başarılı Yanıt

{
    "status": true,
    "message": "Draft consignment created",
    "data": {
        "id": 242,
        "uuid": "aa203bc1-c2f0-46c3-a635-f59abccd1c4a",
        "provider_id": 7,
        "preference": 0,
        "barcode": null,
        "reference_no": null,
        "invoice_number": null,
        "status": 24,
        "status_message": "New draft",
        "weight": 0,
        "desi": 0,
        "consignor": {
            "name": "Gönderen Firma A.Ş.",
            "attention_name": null,
            "country": "Turkey",
            "country_iso3": "TUR",
            "state": "İstanbul",
            "city": "Kadıköy",
            "address": "Moda Caddesi No:1",
            "postal_code": "34758",
            "phone": "+902161234567",
            "email": "info@firma.com"
        },
        "consignee": {
            "name": "Hans Mueller",
            "attention_name": null,
            "country": "Germany",
            "country_iso3": "DEU",
            "state": "Hamburg",
            "city": "Altona",
            "address": "Beispielstraße 123",
            "postal_code": "22765",
            "phone": "+4940123456",
            "email": "hans@example.de"
        },
        "packages": [],
        "documents": [],
        "special_services": [],
        "consignment_type": 2,
        "incoterms_type": 2,
        "specific_shipping_method": null,
        "specific_provider_barcode": null,
        "created_at": "2025-05-07 18:14:45",
        "updated_at": "2025-05-07 18:14:45"
    }
}

Response Alanları

Hata Yanıtları

{
    "status": false,
    "errors": [
        {
            "message": "reference_no: Reference number \"ORDER-2024-001\" has already been used. Please provide a unique reference number."
        }
    ]
}

Yaygın Hata Senaryoları

Sonraki Adımlar

Taslak gönderi oluşturduktan sonra:

1. Güncelleme: Eksik bilgileri Taslak Güncelle ile tamamlayın
2. İşleme: Tüm bilgiler tamamlandığında Taslak İşle ile gönderiyi aktif hale getirin
3. Silme: Gerekirse taslağı silebilirsiniz