Kargo teklifi alma
-
Bu aşamada kullanılacak kargo platformu ve bu platform için hesabınızda aktif olan kargo hesabının id'si önceden biliniyor olmalıdır. Bu bilgilere api üzerinden ulaşılabileceği gibi kullanıcı panelinden de ulaşılabilmektedir (Firma ayarlarında Kargo Servisleri bölümü).
-
Sipariş için kargo oluştururken teklif id'si kullanılmaktadır fakat bu id'ler zaman içinde değişebileceği için, ya da kargo platformu hedef ülke/bölge için verdiği servislerde değişiklik yapabileceği için bu noktada önerilen yöntem, kullanılmak istenen teklif kodlarını (offer_code olarak gelecek ve kargo platformuna göre değişkenlik göstermekte) sabit tutarak hedef ülke için teklif aramak ve dönen teklifler içinde offer_code'a göre kullanılmak istenen teklifi belirleyip id'sini alarak ilerlemektir.
Endpoint: /api/v1/shipping/list_cached_offers/
Method: POST
Request Data:
{
"account_id":1,
"provider_key":"pts",
"destination_country":"DE",
"parcel":"1"
}
account_id
: Kargoyu gönderimek için kullanılacak olan kargo hesabının id'siprovider_key
: Kargoyu gönderimek için kullanılacak olan kargo platformunun kodudestination_country
: Kargonun gönderileceği hedef iso ülkeparcel
: Gönderilecek olan kargonun desi miktarı
Response (örnek):
[
{
"id": 26,
"shipping_time_display": "2 - 4 Gün",
"offer_name": "PTS Flex",
"offer_code": "L",
"origin_country": "TR",
"parcel": "1",
"price": "8.2377",
"destination_country": "DE",
"shipping_time": "2 - 4 Gün",
"destination_postal_code": null,
"update_time": 1721614003,
"currency": 3,
"account": 1
},
{
"id": 27,
"shipping_time_display": "1 - 3 Gün",
"offer_name": "FEDEX EXP",
"offer_code": "F",
"origin_country": "TR",
"parcel": "1",
"price": "19.91",
"destination_country": "DE",
"shipping_time": "1 - 3 Gün",
"destination_postal_code": null,
"update_time": 1721614003,
"currency": 3,
"account": 1
}
]
Bu işlemde dönülen tekliflerin kodu sabit olacak ama id'si cache mekanizmalarından dolayı değişebileceği için, gönderi oluşturmak için offer_code'u kendi tarafınızda sabit tutarak siparişi göndermek istediğiniz ülke için teklif listesini alıp bu teklif listesinde sabitlediğiniz offer_code'a denk gelen objeyi bulup onun id'sini kullanabilirsiniz.