Kargo İşlemleri (Shippings API)

Kargo servisi, Shopier Anlaşmalı Kargo entegrasyonu üzerinden indirimli kargo kodları üretmenizi ve gönderi durumlarını sorgulamanızı sağlar.

Metotlar

• client.Shippings.List(ctx, opts) -> (*PageResponse[Shipping], error)
• client.Shippings.All(ctx, opts) -> iter.Seq2[Shipping, error]
• client.Shippings.Get(ctx, code) -> (*Shipping, error)
• client.Shippings.Create(ctx, req) -> (*Shipping, error)
• client.Shippings.Delete(ctx, code) -> error

---

1. Anlaşmalı Kargo Kodu Üretme

shipping, err := client.Shippings.Create(ctx, &shopier.ShippingCreateRequest{
	OrderID: "ord_123456",
	Company: "yurtici", // yurtici, mng, ptt, aras, surat, ups vb.
})
if err != nil {
	log.Fatal(err)
}

fmt.Printf("Kargo Kodu: %s (Firma: %s)\n", shipping.Code, shipping.Company)

2. Kargo Durumu Sorgulama

ship, err := client.Shippings.Get(ctx, "SHP-987654")
if err != nil {
	log.Fatal(err)
}

fmt.Printf("Durum: %s | Takip No: %s (Takip Linki: %s)\n",
	ship.Status, ship.TrackingNumber, ship.TrackingURL)

---

Veri Modelleri ve Tipler

Shipping (Kargo Modeli)

Shopier anlaşmalı kargo etiketini ve kargo gönderi kaydını temsil eder.

Alan (Field)	Tip	JSON Etiketi	Açıklama
OrderID	string	orderId	İlgili Shopier sipariş numarası
Code	string	code	Anlaşmalı kargo barkod / kampanya kodu
Company	string	company	Kargo firması ("yurtici", "mng", "ptt", "aras", "surat", "ups")
Status	string	status	Kargo durumu ("created", "inTransit", "delivered", "cancelled")
Method	string	method	Gönderi yöntemi
Type	string	type	Gönderi türü
TrackingNumber	string	trackingNumber	Kargo firması canlı takip numarası
TrackingURL	string	trackingUrl	Kargo firması online takip linki
Cost	string	cost	Satıcıya yansıyan kargo maliyeti
Currency	string	currency	Para birimi ("TRY")
DateCreated	string	dateCreated	Kod oluşturulma tarihi
DateDispatched	string	dateDispatched	Kargoya teslim edilme tarihi

---

ShippingCreateRequest

Alan (Field)	Tip	JSON Etiketi	Zorunlu	Açıklama
OrderID	string	orderId	Evet	Kargo kodu üretilecek sipariş numarası
Company	string	company	Evet	Anlaşmalı kargo firması adı