--- metadata: - name: generator content: Diplodoc Platform v5.19.6 alternate: - https://docs.routeq.com/doc/en/vrp/properties-of-depot.md - https://docs.routeq.com/doc/tr/vrp/properties-of-depot.md title: RouteQ – depo öznitelikleri --- > **Documentation Index:** Fetch the complete configuration index at https://docs.routeq.com/doc/tr/llms.txt # Depo özellikleri Depo, tüm rotaların başladığı ve bitebileceği noktadır. Depo dışında bir yerden yola çıkması gereken kuryeleriniz varsa lütfen [Araç başlangıcı depodan değil](https://docs.routeq.com/doc/tr/vrp/properties-of-vehicles-depot.md#vehicle-start-at) talimatlarını okuyun. Depoların belirlenmesi için `depot`/`depots` istek alanı kullanılır. ## Depo tanımlayıcısı {#depot-id} `id` alanında belirtilen benzersiz sayısal veya satır içi tanımlayıcı zorunlu bir depo özniteliğidir. Tanımlayıcı bir istek kapsamında benzersiz olmalıdır. {% note alert "Uyarı" %} Depo tamamlayıcısı sipariş tanımlayıcılarıyla aynı olmamalıdır. {% endnote %} Ayrıca `ref` alanda muhasebe sisteminizden sayısal veya dizeli bir depo tanımlayıcısı belirtebilirsiniz; bu tanımlayıcı, **Planlama** bölümündeki [elde edilen çözüm](https://docs.routeq.com/doc/tr/vrp/interface-result.md)’de görüntülenecektir. Bunun dışında deponun adını `title` alanında belirtebilir ve depoyu `description` alanında tanımlayabilirsiniz – bu alanlar arayüzde görüntülenmeyecek ancak [çözüm](https://yandex.ru/routing/doc/en/vrp/redoc/index.html#operation/getMVRPTaskResult)’e aktarılacaktır. ## Depo koordinatları {#depot-coordinates} RouteQ, depo adres noktasına karşılık gelen sistemdeki depo konumunun coğrafi koordinatlar [WGS84](https://en.wikipedia.org/wiki/World_Geodetic_System#WGS84) şeklinde belirlenmesini desteklemektedir. Koordinatlar `point` alanında bir değer çifti olarak gösterilir: `point.lat` (enlem) ve `point.lon` (boylam). {% include [warehouse-null-coords-processing](_includes/null-coords-processing-92555f6bb287.md) %} Excel üzerinden planlama yaparken `address` alanında sadece depo adresini belirtebilirsiniz; bu durumda coğrafi kodlama gerçekleştirilecek, yani belirtilen adrese göre koordinatlar belirlenecektir. Daha fazla bilgi için [Harita](https://docs.routeq.com/doc/tr/vrp/interface-import.md#map) bölümüne göz atın. ## Depo türü {#depot-types} Varsayılan olarak tüm depolar `depot`türündedir. Ancak malların aktarılması, yeniden konsolidasyonu veya ek yüklemesinin gerçekleştirildiği ara alanlar da kullanılabilir. Bu tür depolar için `type` alanı `crossdock` olarak belirtilir. Bu tür depolarla çalışma [çapraz sevkiyat senaryolarında](https://docs.routeq.com/doc/tr/vrp/supported-use-cases.md#cross-docking) açıklanmaktadır. ## Depo zaman aralığı {#depot-time-window} İstekte belirtilen deponun, deponun çalışma saatlerini belirten bir zaman aralığıne sahip olması gerekir. Deponun çalışma saatlerini belirtmek için `time_window` alanı kullanılır. {% include [warehouse-tw-formats](_includes/tw-formats-1f195c4b77e0.md) %} Zaman aralığının türüne bağlı olarak, rotalarını depoda tamamlamak zorunda olan araçlar deponun çalışma süresi sona ermeden (**katı** zaman aralığı) önce geri dönebilir veya bu sınırı ihlal edebilir (**esnek** zaman aralığı). {% include [warehouse-hard-window](_includes/hard-window-175aabca27f5.md) %} {% note info "Not" %} `hard_time_window` ve `hard_window` alanları birlikte kullanılamaz. {% endnote %} Zaman aralığının başlangıcından önce depodan başlangıç yapmak da mümkündür. Bu durum [Esnek başlangıç zamanı](https://docs.routeq.com/doc/tr/vrp/properties-of-depot.md#depot-flexible-start-time) bölümünde daha detaylı ele alınmıştır. {% note info "Not" %} Depo zaman aralığını belirlerken aracın depoya dönmesi gereken durumları dikkate almak gerekir. Araç depoya zamanında dönemiyorsa ve deponun penceresi katıysa bazı siparişler teslim edilmeden kalabilir. Şüpheniz varsa, depo çalışma saatlerini planlanan döneme yaymak ve esnek hâle getirmek daha iyi olur. {% endnote %} ### Depo çoklu zaman aralığı {#depot-multiple-time-windows} Gerekirse bir depo için birden fazla zaman aralığı belirleyebilirsiniz. Bu, şu durumlarda kullanılır: - Depo, çalışmasına ara verir. Örneğin öğle yemeği molası verilir. - Kurye birden çok gün süren bir rota gerçekleştiriyorsa. Örneğin, siparişlerin belirli bir zamanda teslim edilmesi gerekiyor ancak teslimat günlerinden birinde depoda siparişlerin yüklenmesini etkileyebilecek bir kesinti var. - Kuryenin birkaç gün için planlanmış siparişleri varsa ve bazı siparişler sadece belirli bir günde alınabiliyor veya teslim edilebiliyorsa. `time_windows` alanında ögeler dizisi belirtilir. Bu dizideki her öge zorunlu `time_window` alanını içerir. Siparişler olası pencerelerden birinde depoda yüklenecek ve API yanıtının `used_time_window` alanı, kullanılan zaman aralığıyla ilgili bilgileri içerecektir. {% note alert "Uyarı" %} {% include [order-multiple-time-windows-not-intersect-windows](_includes/not-intersect-windows-db98e807c91a.md) %} {% endnote %} Her depo zaman aralığı için ek bir (haricî) katı pencere belirlenebilir. Bu pencere ana pencerenin ihlal edilebileceği süreyi sınırlamak için kullanılır ve `hard_time_window` parametresi kullanılarak tanımlanır. **Örnek** Kurye, bir kısmını günün ilk yarısında, bir kısmını öğleden sonra teslim etmesi gereken 10 sipariş teslim edecek. Depo saat 13.00-14.00 arasında öğle yemeği molası için çalışmaya ara veriyor. Kurye, siparişlerin bir kısmını teslim ediyor ve depodaki yemek molası sırasında ek yükleme yapmak için geri dönüyor. Kurye yemek molası bittikten sonra kalan siparişleri yüklüyor ve teslim ediyor. [API isteği (JSON)](https://courier.yandex.ru/vrs/api/v1/log/request/d2896ad0-76ebf482-4c9c497a-33a48dd) ⋅ [API yanıtı](https://courier.yandex.ru/vrs/api/v1/result/d2896ad0-76ebf482-4c9c497a-33a48dd) ⋅ [Haritada aç](https://yandex.com/courier/mvrp-map#d2896ad0-76ebf482-4c9c497a-33a48dd) ## Yükleme, gönderi indirme ve ek yükleme penceresi {#additional-time-windows} Çalışma saatlerini tanımlayan zaman aralıklarına ek olarak, bir depo için bireysel işlemleri sınırlayan ek pencereler de atayabilirsiniz: - `time_windows_loading` – yükleme pencereleri – kuryenin vardiya sırasında depoya ilk kez uğradığı zamanı belirler. - `time_windows_unloading` – gönderi indirme pencereleri – kuryenin vardiya sırasında depoya son kez uğradığı zamanı belirler. - `time_windows_refilling` – ek yükleme pencereleri – kuryenin ek yükleme için depoya uğradığı zamanı belirler. Bu ana depo veya bir ara depo olabilir. {% note info "Not" %} Ek bir pencere türü belirtilmemişse ilgili işlem için genel depo zaman aralığı kullanılır. {% endnote %} Bir depo için her türden birkaç ek pencere atanabilir. Bu durumda bu pencereler `time_windows` dizisi kullanılarak atanır. Ek pencere için şu parametrelerden biri belirtilebilir: - `hard_window` – ek bir pencerenin katı mı yoksa esnek mi olacağını belirler (her türdeki ek pencere dizisinin tamamı için atanır). - Katı bir ek pencerenin var olması durumunda rotaya beklemeler eklenebilir; koşulların yerine getirilmesi mümkün değilse bazı siparişler dağıtılamayanlar listesine düşebilir. - Esnek bir ek pencerenin var olması durumunda, ihlal yaşanması hâlinde uygulanacak en az bir ceza belirtilmelidir. - `hard_time_window` – esnek zaman aralığının çevresine katı bir zaman aralığı atar (her `time_window` parametresi için ayrı ayrı atanır). **Örnek** Depoda `7:00–21:00` şeklinde genel bir zaman aralığı mevcut. Bu pencereye ayrıca şu pencereler atanmış bulunuyor: - yükleme için – `7:00–9:00` katı penceresi; - ek yükleme için – `11:00–12:00` ve `14:00–15:00` yumuşak pencereleri; - gönderi indirme için – `18:00–19:00` esnek penceresinin çevresine `17:00–20:00` katı penceresi. Araçta bir ağırlık sınırı mevcut: maksimum 200 kg. Tüm siparişler 100 kg’dan ağır olduğundan kurye her seferinde ek yükleme yapmak üzere depoya geri dönecek. Bu koşullar altında optimal rota şu şekilde oluşturulur: - Vardiya sırasında kurye birinci seferde 1. siparişi yüklüyor ve yükleme penceresine uyuyor. Siparişin teslimatından sonra kurye bu defa ilk ek yükleme penceresinin başında depoya dönüyor. - İkinci seferde kurye 2. siparişi depodan alıyor, teslim ediyor, tekrar depoya dönüyor ve ikinci ek yükleme penceresinin başlaması için 44 dakika bekliyor. - Üçüncü seferde kurye 3. siparişi depodan alıyor, teslim ediyor ve 4. siparişi alıyor. - Vardiyanın sonunda kurye 4 numaralı siparişi indirmek için depoya geri dönüyor ve esnek gönderi indirme penceresine göre 33 dakika gecikiyor fakat katı pencereyi tutturmayı başarıyor. [API isteği (JSON)](https://courier.yandex.ru/vrs/api/v1/log/request/c310d3d0-f3f2c8e2-8d83ef24-e70d5430) ⋅ [API yanıtı](https://courier.yandex.ru/vrs/api/v1/result/c310d3d0-f3f2c8e2-8d83ef24-e70d5430) ⋅ [Haritada aç](https://yandex.com/courier/mvrp-map#c310d3d0-f3f2c8e2-8d83ef24-e70d5430) ## Depodaki hizmet süresi {#depot-service-duration} RouteQ’da depo, her aracın veya kuryenin depoda geçirmesi gereken toplam hizmet süresinin tanımlanmasını desteklemektedir. Depodaki genel hizmet süresi kurye için belge hazırlama süresini hesaba katmak veya aracın yüklenme süresini ortalamaya çekmek için kullanılabilir. - `depot.preliminary_service_duration_s` – [sipariş depoda hazır olana](https://docs.routeq.com/doc/tr/vrp/properties-of-orders.md#order-time-depot-ready) kadar sefere hazırlık süresi; - `depot.service_duration_s` – sipariş depoda hazır olduktan sonra sefere hazırlık süresi; - `depot.load_service_duration_s` – `delivery` türündeki siparişleri araca yükleme süresi. En az bir `delivery` siparişinin yüklenmesi durumunda depo hizmet süresine eklenir; - `depot.unload_service_duration_s` – `pickup` türündeki siparişleri araçtan indirme süresi. En az bir `pickup` siparişinin indirilmesi durumunda depo hizmet süresine eklenir; - `depot.finish_service_duration_s` – her seferin bitirilmesinden önceki süre. Sipariş hazırlama süresi kullanılmıyorsa `preliminary_service_duration_s` belirtmeye gerek yoktur – toplam zaman olarak `service_duration_s` ögesinin belirtilmesi yeterlidir. {% note info "Not" %} Her siparişe özel olarak depoda bir yükleme süresi belirtebilirsiniz – bununla ilgili daha fazla bilgi [Depoda sipariş yükleme veya boşaltma hizmet süresi](https://docs.routeq.com/doc/tr/vrp/properties-of-orders.md#order-service-duration-load) bölümünde mevcut. {% endnote %} **Örnek 1** Saat 07.00’de çalışmaya başlayan bir depoda herhangi bir rotanın başlangıcına ve bitişine 10 dakika hizmet süresi verelim. Oluşturulan rotada ilk siparişe varış saati 07.28 olurken, ilk siparişe kadar yolculuk 18 dakika sürer. Böylece araç sefere başlamadan önce depoda 10 dakika geçirmiş oluyor. Rota sonunda depoya varış saati 07.53’tür. Bu süreye 10 dakikalık hizmet süresi eklenir ve bu, tüm rotanın toplam süre ölçümüne yansıtılır. [API isteği (JSON)](https://courier.yandex.ru/vrs/api/v1/log/request/17f1e3db-182aa7-4f4f1834-8d2b1418) ⋅ [API yanıtı](https://courier.yandex.ru/vrs/api/v1/result/17f1e3db-182aa7-4f4f1834-8d2b1418) ⋅ [Haritada aç](https://yandex.com/courier/mvrp-map#17f1e3db-182aa7-4f4f1834-8d2b1418) **Örnek 2** Örnekte 3 sipariş var ve her sipariş araç kapasitesinin %100’ünü kullandığı için 3 ayrı sefer planlanıyor. Buna bağlı olarak `depot.service_duration_s` ve `depot.finish_service_duration_s` sürelerinin sırasıyla her seferin başına ve sonuna eklendiği görülmektedir. [API isteği (JSON)](https://courier.yandex.ru/vrs/api/v1/log/request/54af85a9-878c0638-e862db09-d31d223) ⋅ [API yanıtı](https://courier.yandex.ru/vrs/api/v1/result/54af85a9-878c0638-e862db09-d31d223) ⋅ [Haritada aç](https://yandex.com/courier/mvrp-map#54af85a9-878c0638-e862db09-d31d223) **Örnek 3** Sipariş saat 08.00.00’de (`location.depot_ready_time`)depodan sevkiyata hazır olacaktır. Siparişin hazırlanmasına kadar depodaki ön işlemlerin 30 dakika (`depot.preliminary_service_duration_s`) içerisinde tamamlanması gerekiyor. Sipariş hazır olduğu andan itibaren servis için 10 dakika (`depot.service_duration_s`) harcanacaktır. Böylece toplam hizmet süresi 07.30.00-08.10.00 arasındadır. [API isteği (JSON)](https://courier.yandex.ru/vrs/api/v1/log/request/f7c466c-b45fef15-62daacb6-8b317965) ⋅ [API yanıtı](https://courier.yandex.ru/vrs/api/v1/result/f7c466c-b45fef15-62daacb6-8b317965) ⋅ [Haritada aç](https://yandex.com/courier/mvrp-map#f7c466c-b45fef15-62daacb6-8b317965) ## Esnek başlangıç zamanı {#depot-flexible-start-time} Varsayılan olarak kuryeler depo açıldıktan (veya kuryenin vardiyasının başlamasından) ve siparişlerin yüklenmesinin bitmesinden hemen sonra depodan hareket etmeye başlar. Burada `depot.flexible_start_time` parametresinin değeri `false` olarak belirtilir. Değer `true` olarak belirtilirse depodan başlangıç, depo zaman aralığı veya kurye vardiyasının başlangıcından değil, daha sonrası için planlanacaktır. **Örnek 1** Kuryenin vardiyası 09.00’da başlıyor, depo ise 08.30’da çalışmaya başlıyor. `depot.flexible_start_time` parametresi `false` olarak belirtiliyor. Planlama yapılırken, ilk siparişin penceresi 13.00-14.00 arasında olsa ve kuryenin depodan siparişe kadar sadece 15 dakika seyahat etmesi gerekiyor olsa bile, bu kurye için elde edilen her rotanın 09.00’da başlaması gerektiği dikkate alınacaktır. [API isteği (JSON)](https://courier.yandex.ru/vrs/api/v1/log/request/f67467cf-6d93dee5-f581e725-c8c45ad8?activeVehicle=1) ⋅ [API yanıtı](https://courier.yandex.ru/vrs/api/v1/result/f67467cf-6d93dee5-f581e725-c8c45ad8?activeVehicle=1) ⋅ [Haritada aç](https://yandex.com/courier/mvrp-map#f67467cf-6d93dee5-f581e725-c8c45ad8?activeVehicle=1) **Örnek 2** Kuryenin vardiyası 09.00’da başlıyor, depo ise 08.30’da çalışmaya başlıyor. `depot.flexible_start_time` parametresi `true` olarak belirtiliyor. İlk siparişin penceresi 13.00-14.00 arasında olacaksa ve kuryenin depodan siparişe kadar sadece 15 dakika seyahat etmesi gerekiyorsa planlayıcı başka sınırlamalar ihlal edilmiyorsa kuryenin depodan çıkışını 09.00’da değil, daha geç (örneğin 12.30’da) planlayabilir. [API isteği (JSON)](https://courier.yandex.ru/vrs/api/v1/log/request/f1187785-faa81651-dc27c189-c32397bd?activeVehicle=1) ⋅ [API yanıtı](https://courier.yandex.ru/vrs/api/v1/result/f1187785-faa81651-dc27c189-c32397bd?activeVehicle=1) ⋅ [Haritada aç](https://yandex.com/courier/mvrp-map#f1187785-faa81651-dc27c189-c32397bd?activeVehicle=1) ## Birkaç deponun birinden teslimat {#depot-start-from-any} Bazen bir ürün birden fazla depoda bulunur ve planlama sırasında hangi depodan teslimat yapacağınızı seçmeniz gerekir. Belirli bir siparişin hangi depolardan gönderilmesi gerektiğini biliyorsanız [location.depot_id](https://docs.routeq.com/doc/tr/vrp/properties-of-orders.md#linking-order-depot) parametresini kullanın. Parametre değeri olarak bu depoların `id` dizisini belirtin. Araçlar için [hangi depolardan başlayacaklarını](https://docs.routeq.com/doc/tr/vrp/properties-of-vehicles-depot.md#start-from-any) belirleyebilirsiniz; bu, siparişin depolara bağlandığını gösterecektir. **Örnek 1** Elimizde iki araç, iki depo ve üç sipariş var. Araçlar belirli depolardan başlıyor: - Birinci araç 1. depodan. - İkinci araç 2. depodan. Planlamanın bir sonucu olarak: 1. Birinci araç 1. depodan 3. siparişi servis ediyor. 1. İkinci araç 2. depodan 1. ve 2. siparişi servis ediyor. [API isteği (JSON)](https://courier.yandex.ru/vrs/api/v1/log/request/aded48d2-69181dcc-79b75582-94125830) ⋅ [API yanıtı](https://courier.yandex.ru/vrs/api/v1/result/aded48d2-69181dcc-79b75582-94125830) ⋅ [Haritada aç](https://yandex.com/courier/mvrp-map#aded48d2-69181dcc-79b75582-94125830) **Örnek 2** Örnek 1’deki gibi fakat siparişler depolara bağlı: - sipariş 1\. ve 2\. depoya. - sipariş 1\. depoya. - sipariş 2\. depoya. Planlamanın bir sonucu olarak: 1. Birinci araç 1. depodan 1. ve 2. siparişi servis ediyor. 1. İkinci araç 2. depodan ve 3. siparişi servis ediyor. [API isteği (JSON)](https://courier.yandex.ru/vrs/api/v1/log/request/eb3d94fa-193a9d84-b089cccf-37fb32c) ⋅ [API yanıtı](https://courier.yandex.ru/vrs/api/v1/result/eb3d94fa-193a9d84-b089cccf-37fb32c) ⋅ [Haritada aç](https://yandex.com/courier/mvrp-map#eb3d94fa-193a9d84-b089cccf-37fb32c) ## Depo işlem kapasitesi {#depot-throughput} Deponun işlem kapasitesi hem [siparişlerin araçlara yüklenme](#throughput) hızına hem de [siparişlerin yüklenmeye hazırlanma](#package-throughput) (örneğin hazırlanma veya paketleme) hızına bağlıdır. Çoğu zaman siparişlerin hazırlanma ve yüklenme süreçleri paralel olarak gerçekleştirilir; önceden hazırlanmış siparişler araçlara yüklenirken, bir sonraki sipariş partisi yüklenmeye hazırlanır. Burada siparişlerin hazırlanma hızı ile elleçlenme hızı çakışmayabilir (örneğin siparişin hazırlanması ortalama 5 dakika, elleçlenmesi ise 1,5 dakika sürer). Siparişlerin hazırlanması ve elleçlenme süreçlerinin zaman aralıkları de çakışmayabilir (örneğin siparişlerin hazırlanması daha erken başlar). Bir depo için bu süreçlerin her birinin işlem kapasitesi ayrı ayrı atanabilir. Kapasitenin doğru şekilde belirtilmesi araçların depodan ayrılması için gerçekçi bir zaman planlamanıza olanak tanır. ### Depoda araç yükleme hızı {#throughput} Yükleme hızını sınırlamak için `depot.throughput` istek alanı kullanılır. Şu sınırlamalardan birini atayabilirsiniz: - `throughput.kg_per_hour` – kg/saat cinsinden elleçleme işlem kapasitesi; - `throughput.units_per_hour` – birim/saat cinsinden elleçleme işlem kapasitesi (paletler, kutular, variller); - `throughput.vehicle_count` – araçlardaki elleçleme işlem kapasitesi. Bu parametre depoda elleçlemeye uygun yerleri hesaplamaya imkân verir. Böyle bir yerde aynı anda sadece bir araç durabilir. Depo işlem kapasitesi günün saatine göre değişiklik gösterebilir (örneğin yoğun saatlerde daha çok elleçleme elemanı çalışıyorsa). Her `N` zaman aralığı için aşağıdakileri tanımlayan birkaç alan atanması gerekiyor: - sipariş zaman aralığı – `throughput.kg_per_hour.N.time_window`, `throughput.units_per_hour.N.time_window` veya `throughput.vehicle_count.N.time_window`; - bu zaman aralığındaki işlem kapasitesi – `throughput.kg_per_hour.N.value`, `throughput.units_per_hour.N.value` veya `throughput.vehicle_count.N.value`. Bu parametrelerin değerleri atanırken aşağıdaki sınırlamalar dikkate alınmalıdır: - İşlem kapasitesi pencereleri birbiriyle çakışmamalıdır. - İşlem kapasitesi pencereleri toplamda deponun çalışma saatlerini kapsamıyorsa, o zaman aralıklar arasındaki aralıklarda kapasite 0’a eşit kabul edilir. - İşlem kapasitesi pencereleri, bir aracın depoya çalışma başlamadan önce veya deponun çalışması bittikten sonra geldiği durumlara uyum sağlamak için depo çalışma saatlerinin ötesine uzanabilir. Sipariş için bir [depoda yükleme süresi](https://docs.routeq.com/doc/tr/vrp/properties-of-orders.md#order-service-duration-load) atanmışsa bu değer işlem kapasitesi sınırlamaları kontrol edilirken sipariş birimlerinin ağırlığına veya sayısına ek olarak dikkate alınacaktır. Elleçleme süresi siparişlerin özelliklerine bağlı olmayıp sadece depo ve araç tarafından belirleniyorsa `vehicle.depot_extra_service_duration_s` alanını kullanın. Bu alanda süreyi saniye cinsinden belirtmelisiniz çünkü bu değer deponun kendi hizmet süresini aşan yüklemelerde gerekli olacaktır. Bu parametreyle ilgili daha fazla bilgi için [Depoda yükleme hizmet süresi](https://docs.routeq.com/doc/tr/vrp/properties-of-vehicles-depot.md#depot-extra-service-duration) bölümüne göz atın. {% note alert "Uyarı" %} Planlama sırasında depo işlem kapasitesini dikkate almak için: - [Esnek başlangıç zamanı](https://docs.routeq.com/doc/tr/vrp/properties-of-depot.md#depot-flexible-start-time)’nı etkinleştirin. - [Depodaki hizmet süresi](https://docs.routeq.com/doc/tr/vrp/properties-of-depot.md#depot-service-duration) ve/veya [depoda siparişi yükleme hizmet süresi](https://docs.routeq.com/doc/tr/vrp/properties-of-orders.md#order-service-duration-load) belirtin. Bir siparişin depoda yüklenme hizmet süresi değerinin (`service_duration_s`) en az 10 dakika (600 saniye) olarak belirlenmesi önerilir. {% endnote %} Deponun elleçleme işlem kapasitesinin ihlal edilmesi durumunda cezalar uygulanır: - `depot.penalty.throughput.fixed` – her ihlal olayı için; - `depot.penalty.throughput.kg` – `throughput.kg_per_hour` sınırlamasını aşan her kilogram için; - `depot.penalty.throughput.unit` – `throughput.units_per_hour` sınırlamasını aşan her gönderi birimi için; - `depot.penalty.throughput.vehicle` – yükleme veya gönderi indirme sırasında araç sayısının ihlali için. Bir aracın depoya erken veya geç gelmesi durumunda hem [depo zaman aralığının ihlali](#penalties-time-window-violation) hem de yükleme veya gönderi indirme sırasında araç sayısının aşılması nedeniyle (`depot.penalty.throughput.vehicle`) para cezası uygulanır. Çifte cezadan kaçınmak için işlem kapasitesi pencerelerini deponun çalışma saatlerinin ötesine geçecek şekilde atayın ve araçların olası erken ve geç gelişlerini hesaba katın. **Örnek 1** Örnekte 20 sipariş bulunmaktadır. Gönderi birimi toplam miktarı – 1170. Depodaki hizmet süresi – 1 saat. İşlem kapasitesi sınırı atanmadığından, çözümde tüm kuryeler, tüm siparişlerin eş zamanlı yüklenebileceğini varsayarak yaklaşık olarak aynı anda işe koyuluyor. [API isteği (JSON)](https://courier.yandex.ru/vrs/api/v1/log/request/c36f691f-1c75ab80-b864b294-fb903e03) ⋅ [API yanıtı](https://courier.yandex.ru/vrs/api/v1/result/c36f691f-1c75ab80-b864b294-fb903e03) ⋅ [Haritada aç](https://yandex.com/courier/mvrp-map#c36f691f-1c75ab80-b864b294-fb903e03) **Örnek 2** Örnek 1’dekiyle aynı ancak depo için `throughput.vehicle_count` = 3 parametre değeri kullanılarak araçların eş zamanlı yüklenmesine yönelik bir sınırlama atanmıştır. Böylece depoda eş zamanlı olarak en fazla 3 araç yüklenebiliyor: önce 2, 3 ve 4 ve ardından 1. araç. [API isteği (JSON)](https://courier.yandex.ru/vrs/api/v1/log/request/7a6cd633-e3cf3938-de9c89e5-ec5b867f) ⋅ [API yanıtı](https://courier.yandex.ru/vrs/api/v1/result/7a6cd633-e3cf3938-de9c89e5-ec5b867f) ⋅ [Haritada aç](https://yandex.com/courier/mvrp-map#7a6cd633-e3cf3938-de9c89e5-ec5b867f) **Örnek 3** Örnek 1’dekiyle aynı ancak depo için `throughput.vehicle_count` parametre değeri kullanılarak araçların eş zamanlı yüklenmesine yönelik bir sınırlama atanmıştır. Aynı zamanda depo işlem kapasitesi farklı zaman dilimlerinde değişiklik göstermektedir: - `06:00 — 07:30` – 2 araç; - `07:30 — 22:00` – 1 araç. [API isteği (JSON)](https://courier.yandex.ru/vrs/api/v1/log/request/d79e5fcb-b202f036-b53328e1-970c53ba) ⋅ [API yanıtı](https://courier.yandex.ru/vrs/api/v1/result/d79e5fcb-b202f036-b53328e1-970c53ba) ⋅ [Haritada aç](https://yandex.com/courier/mvrp-map#d79e5fcb-b202f036-b53328e1-970c53ba) **Örnek 4** Örnek 1’dekiyle aynı ancak depo için `throughput.units_per_hour` = 300 parametre değeri kullanılarak elleçleme işlem kapasitesine yönelik bir sınırlama atanmıştır, yani bir saat sadece 300 birim yüklenebilir. Bu, sipariş yüklemelerinin gerçekçi bir şekilde belirlenmesini mümkün kılmaktadır. Artık kuryeler önceki kuryenin yüklemeyi bitirmesini bekledikten sonra depoya varıyor. [API isteği (JSON)](https://courier.yandex.ru/vrs/api/v1/log/request/8903c353-cfa08de7-45778e31-c75101a5) ⋅ [API yanıtı](https://courier.yandex.ru/vrs/api/v1/result/8903c353-cfa08de7-45778e31-c75101a5) ⋅ [Haritada aç](https://yandex.com/courier/mvrp-map#8903c353-cfa08de7-45778e31-c75101a5) ### Siparişlerin elleçlemeye hazırlanma hızı {#package-throughput} Siparişlerin elleçlemeye hazırlanma hızını sınırlamak için `depot.package_throughput` alanı kullanılıyor. Şu sınırlamalardan birini atayabilirsiniz: - `package_throughput.kg_per_hour` – kg/saat cinsinden elleçleme hazırlığı kapasitesi; - `package_throughput.units_per_hour` – depoda bir saat içinde yüklemeye hazırlanabilecek maksimum gönderi birimi sayısı. Elleçleme hazırlığı kapasitesi günün saatine göre değişiklik gösterebilir (örneğin yoğun saatlerde paketleme ve hazırlamada daha çok eleman çalışıyorsa). Her `N` zaman aralığı için aşağıdakileri tanımlayan birkaç alan atanması gerekiyor: - zaman aralığı – `package_throughput.kg_per_hour.N.time_window` veya `package_throughput.units_per_hour.N.time_window`; - bu zaman aralığındaki işlem kapasitesi – `package_throughput.kg_per_hour.N.value` veya `package_throughput.units_per_hour.N.value`. {% include [throughput-restrictions-throughput-tw](_includes/restrictions-throughput-tw-3a8a79447e5d.md) %} Planlamadaki elleçleme hazırlığı kapasitesi aşılırsa bunun için cezalar uygulanır: - `depot.penalty.package_throughput.fixed` – her ihlal olayı için; - `depot.penalty.package_throughput.kg` – `package_throughput.kg_per_hour` sınırlamasını aşan her kilogram için; - `depot.penalty.package_throughput.unit` – `package_throughput.unit_per_hour` sınırlamasını aşan her gönderi birimi için. **Örnek 5** Örnek 1’dekiyle aynı ancak siparişleri elleçlenmeye hazırlama kapasitesi için bir sınırlama atanmış bulunuyor: depoda sabah saat 6 ila 10 arasında saatte 180 birim paketlemek mümkünken saat 10 ila akşam 22 arasında 120 birim paketlenebiliyor. Elleçleme hazırlığı kapasitesinin ihlali için belirlenen ceza `penalty.package_throughput.unit` = 100 şeklindedir. Araçları zamanında sefere göndermek için, siparişlere yönelik depo elleçleme hazırlığı kapasitesi ihlal edilmiş bulunuyor, Bu nedenle `total_depot_penalty` = 9500 şeklinde bir ceza kesildi. [API isteği (JSON)](https://courier.yandex.ru/vrs/api/v1/log/request/5d1a6c1f-9a189b3a-9ce9a94b-45b279a8) ⋅ [API yanıtı](https://courier.yandex.ru/vrs/api/v1/result/5d1a6c1f-9a189b3a-9ce9a94b-45b279a8) ⋅ [Haritada aç](https://yandex.com/courier/mvrp-map#5d1a6c1f-9a189b3a-9ce9a94b-45b279a8) ## Depo zaman aralığını ihlal etme cezaları {#penalties-time-window-violation} Aracın depodan depo çalışma zaman aralığından önce ayrılması veya depoya depo çalışma süresi penceresinden sonra dönmesi durumunda bu ceza rotanın toplam ücretine eklenir. {% note info "Not" %} Bu davranış sadece **esnek** bir zaman aralığı tanımlandığında mümkündür. **Katı** pencere ihlal ediliyorsa bu durumda sipariş otomatik olarak teslim edilmedi olarak işaretlenir ve tüm rotaların dışında bırakılır. {% endnote %} Depoya uygun olmayan bir zamanda gelme cezası, siparişlerin belirlenen zaman aralığında araca yüklenmesinin mümkün olmaması durumunda deponun zaman aralığını ihlal etmenize olanak tanır. Depoya zamanında varışı yönetmek için RouteQ’da aşağıdaki nesneler kullanılabilir: - `depot.penalty.early` – depoya zaman aralığından daha erken varıldığında oy kullanacak cezayı belirtir; - `depot.penalty.late` – depoya zaman aralığından daha geç varıldığında uygulanacak cezayı belirtir; - `depot.penalty.out_of_time` – hem depoya erken gelişler hem depoya geç dönüşler için uygulanacak genel cezayı belirtir. Eğer `depot.penalty.early` ve `depot.penalty.late` atanmıyorsa o zaman `depot.penalty.out_of_time` değerleri kullanılır (yani `early` ve `late` `out_of_time` ögesini geçersiz kılma işlevi görür). Her nesne iki alandan oluşur: - `fixed` – depoya zamanında varmama sabit cezası; - `minute` – depoya zamanında varılmayan her dakika için uygulanan ceza. Eğer `depot.penalty.early` veya `depot.penalty.late` için sadece bir değer atanmışsa (`fixed` veya `minute`), o zaman ikincisi `depot.penalty.out_of_time` ögesinden alınır. Örneğin sadece `depot.penalty.late.fixed` atanmış olabilir. Bu durumda depoya geç kalınması hâlinde her dakika için ceza olarak `depot.penalty.out_of_time.minute` kullanılacaktır. {% note info "Not" %} Yukarıdaki alanlar, kullanıcıların depoya varış önceliklerini tanımlarken başlangıç değerleri olarak kullanılması önerilen varsayılan değerler içerir. Şüpheniz varsa doğru katsayıları belirlemek için RouteQ analistleriyle iletişime geçin. {% endnote %} {% include [warehouse-feedback](_includes/feedback-b2774f1f09f5.md) %}