Taslak Gönderi Güncelle

Bu API, mevcut bir taslak gönderiyi güncellemek için kullanılır. Güncelleme sonrasında taslak hâlâ NEW_DRAFT durumunda kalır ve işleme alınmaz.

Endpoint Bilgileri

Özellik	Değer
URL	`{{BASE_URL}}/api/v1/consignments/draft/{draft_consignment_id}`
HTTP Metodu	`PUT`
İçerik Türü	`application/json`
Kimlik Doğrulama	`APIKEY` header

Ne Zaman Kullanılır?

Senaryo	Açıklama
Adres düzeltme	Gönderen veya alıcı adresini güncelleme
Paket ekleme	Eksik paket bilgilerini tamamlama
Referans güncelleme	Sipariş numarası veya referans değiştirme
Provider değiştirme	Farklı kargo firması seçme

Not: Güncelleme sonrası taslak işlenmez. İşleme almak için Taslak İşle endpoint'ini kullanın.

İstek Parametreleri

URL Parametreleri

Parametre	Tip	Zorunluluk	Açıklama
`draft_consignment_id`	Integer	ZORUNLU	Taslak gönderi ID'si

Gövde Parametreleri

Taslak Gönderi Oluştur sayfasındaki tüm parametreler kullanılabilir.

Kısmi Güncelleme: Sadece güncellemek istediğiniz alanları gönderin. Gönderilmeyen alanlar değişmez.

Örnek Kullanım

Paket Bilgisi Ekleme

curl -X PUT "{{BASE_URL}}/api/v1/consignments/draft/242" \
  -H "Content-Type: application/json" \
  -H "APIKEY: {{APIKEY}}" \
  -d '{
    "packages": [
        {
            "package_type": 1,
            "post_type": 4,
            "weight": 2,
            "length": 15,
            "width": 15,
            "height": 15,
            "dangerous_goods": false,
            "items": [
                {
                    "description": "Bosch Kahve Makinesi",
                    "gtip": "851671900000",
                    "origin": "TR",
                    "currency_code": "USD",
                    "quantity": 1,
                    "unit_price": 200
                }
            ]
        }
    ]
}'

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

$draftId = 242;

$response = $client->request('PUT', "{{BASE_URL}}/api/v1/consignments/draft/{$draftId}", [
    'headers' => [
        'Content-Type' => 'application/json',
        'APIKEY' => '{{APIKEY}}'
    ],
    'json' => [
        'packages' => [
            [
                'package_type' => 1,
                'post_type' => 4,
                'weight' => 2,
                'length' => 15,
                'width' => 15,
                'height' => 15,
                'dangerous_goods' => false,
                'items' => [
                    [
                        'description' => 'Bosch Kahve Makinesi',
                        'gtip' => '851671900000',
                        'origin' => 'TR',
                        'currency_code' => 'USD',
                        'quantity' => 1,
                        'unit_price' => 200
                    ]
                ]
            ]
        ]
    ]
]);

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

<?php
$draftId = 242;

$payload = [
    'packages' => [
        [
            'package_type' => 1,
            'post_type' => 4,
            'weight' => 2,
            'length' => 15,
            'width' => 15,
            'height' => 15,
            'dangerous_goods' => false,
            'items' => [
                [
                    'description' => 'Bosch Kahve Makinesi',
                    'gtip' => '851671900000',
                    'origin' => 'TR',
                    'currency_code' => 'USD',
                    'quantity' => 1,
                    'unit_price' => 200
                ]
            ]
        ]
    ]
];

$ch = curl_init();

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

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

print_r($result);

curl_close($ch);

Alıcı Adresini Güncelleme

PUT {{BASE_URL}}/api/v1/consignments/draft/242
Content-Type: application/json
APIKEY: {{APIKEY}}

{
    "consignee": {
        "name": "John Smith",
        "address": "456 New Street",
        "city": "Munich",
        "state": "Bavaria",
        "postal_code": "80331"
    }
}

Referans Numarası Güncelleme

PUT {{BASE_URL}}/api/v1/consignments/draft/242
Content-Type: application/json
APIKEY: {{APIKEY}}

{
    "reference_no": "ORDER-2024-002-UPDATED"
}

API Cevabı

Başarılı Yanıt

{
    "status": true,
    "message": "Draft consignment updated",
    "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": 2,
        "desi": 0.68,
        "consignor": {
            "name": "Gönderen Firma A.Ş.",
            "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",
            "country": "Germany",
            "country_iso3": "DEU",
            "state": "Hamburg",
            "city": "Altona",
            "address": "Beispielstraße 123",
            "postal_code": "22765",
            "phone": "+4940123456",
            "email": "hans@example.de"
        },
        "packages": [
            {
                "id": 238,
                "package_type": 1,
                "post_type": 4,
                "weight": 2,
                "width": 15,
                "length": 15,
                "height": 15,
                "desi": 0.68,
                "dangerous_goods": false,
                "items": [
                    {
                        "id": 204,
                        "description": "Bosch Kahve Makinesi",
                        "gtip": "851671900000",
                        "origin": "TR",
                        "currency": "USD",
                        "unit_price": 200,
                        "quantity": 1
                    }
                ]
            }
        ],
        "documents": [],
        "special_services": [],
        "consignment_type": 2,
        "incoterms_type": 2,
        "created_at": "2025-05-07 18:14:45",
        "updated_at": "2025-05-07 18:30:06"
    }
}

Response Alanları

Alan	Tip	Açıklama
`id`	Integer	Taslak gönderi ID'si
`uuid`	String	Taslak gönderi UUID'si
`status`	Integer	Gönderi durumu. Güncelleme sonrası hâlâ `24`
`weight`	Float	Toplam ağırlık (kg)
`desi`	Float	Hesaplanan desi değeri
`packages`	Array	Güncellenmiş paket listesi
`updated_at`	String	Son güncelleme tarihi

Hata Yanıtları

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

Yaygın Hata Senaryoları

Hata	Açıklama	Çözüm
`Consignment not found`	Taslak bulunamadı	Doğru ID kullanın
`Not in draft status`	Gönderi zaten işlenmiş	Sadece `status: 24` taslaklar güncellenebilir
`Reference number has already been used`	Referans numarası mevcut	Benzersiz referans kullanın

Sonraki Adımlar

Taslak güncellendikten sonra:

İşleme Al: Taslak İşle ile gönderiyi aktif hale getirin
Tekrar Güncelle: Gerekirse bu endpoint ile tekrar güncelleyebilirsiniz
Silme: Gerekirse taslağı silebilirsiniz