Ek Eklenti ve Ürün Seçeneklerini Barkod Çıktısına Yansıtma (WooCommerce)

Ek Eklenti ve Ürün Seçeneklerini Barkod Çıktısına Yansıtma

Mağazanızda ürün ek seçenekleri (Product Add-Ons, Extra Product Options), kişiselleştirme, hediye paketi, işleme/gravür gibi alanlar sunan bir eklenti kullanıyorsanız; müşterinin seçtiği bu değerler WooCommerce tarafında sipariş satırı meta verisinde saklanır ve varsayılan olarak Kargo Entegratör'e iletilmez.

Bu değerleri paketleme sırasında görebilmek için, ürün satırındaki custom_attributes alanına aktarabilirsiniz. Bu alana eklediğiniz anahtar / değer çiftleri, gönderiye ait barkod ve fiş PDF çıktılarında ilgili ürün satırının altında listelenir.

Barkod Çıktısına İletilen Veri Yapısı

Her ürün satırı (lines) aşağıdaki gibi serbest bir custom_attributes nesnesi kabul eder:

"lines": [
  {
    "title": "Deri Çanta",
    "quantity": 3,
    "platform_id": 1235,
    "img": "https://dericanta.com/assets/ornek.png",
    "sku": "DRCNT123",
    "custom_attributes": {
      "Renk": "Kırmızı",
      "Boyut": "160 cm"
    }
  }
]

Anahtar isimleri sabit değildir; çıktıda görünmesini istediğiniz etiketi doğrudan siz belirlersiniz. Değerlerin kısa metinler olmasına dikkat edin, uzun metinler barkod çıktısında kırpılabilir.

Ek Seçenek Eklentilerinin Verisini Toplu Aktarma

Ek seçenek eklentilerinin büyük bölümü, müşterinin seçimlerini sipariş satırı meta verisi olarak kaydeder ve bu veriler sipariş detay ekranında ürün adının altında görüntülenir. Aşağıdaki örnek, sipariş ekranında görünen tüm bu satırları olduğu gibi barkod çıktısına taşır:

add_filter('gcargo_shipment_map_wc_order_request', function ($gcargo_request, $order) {

    $gcargo_request['lines'] = array_map(function ($line) use ($order) {

        // platform_id -> WooCommerce sipariş satırı (order item) ID'si
        $item = $order->get_item($line['platform_id']);

        if (!$item) {
            return $line;
        }

        // Sipariş ekranında görünen tüm seçenek satırları (varyasyon + ek seçenekler)
        foreach ($item->get_formatted_meta_data('_') as $meta) {
            $baslik = wp_strip_all_tags($meta->display_key);
            $deger  = wp_strip_all_tags($meta->display_value);

            if (!empty($baslik) && !empty($deger)) {
                $line['custom_attributes'][$baslik] = $deger;
            }
        }

        return $line;
    }, $gcargo_request['lines']);

    return $gcargo_request;
}, 10, 2);

Notlar

• Yalnızca belirli bir alanı aktarmak isterseniz, meta anahtarını wc_get_order_item_meta($line['platform_id'], '_meta_anahtari', true) ile doğrudan okuyup custom_attributes içine ekleyebilirsiniz.

• İade gönderilerinde aynı yapıyı gcargo_returned_map_wc_order_request filtresi ile kullanabilirsiniz.

• custom_attributes zorunlu bir alan değildir; gönderilmediğinde barkod çıktısında ek satır oluşmaz.