Müşterilerinize otomatik SMS ve Mail gönderin
Kargo sorgulama alt yapımızı müşterilerine gelişmiş kargo takip hizmeti sunmak isteyen firmalara açıyoruz. Kargo takip işlemlerini aşağıdaki dökümantasyonla beraber sisteminize entegre edebilirsiniz. Anlık webhooklarla kullanıcılarınızı bilgilendirebilirsiniz.
Kargo Takip API sisteminde endpointlerdeki companySlug alanına aşağıdaki tabloda bulunan firma slug'larını kullanarak sorgulama yapabilirsiniz.
Slug | Kargo Firması |
---|---|
aras-kargo | Aras Kargo |
yurtici-kargo | Yurtiçi Kargo |
surat-kargo | Sürat Kargo |
ptt-kargo | PTT Kargo |
mng-kargo | MNG Kargo |
hepsijet-kargo | HepsiJet |
trendyol-express | Trendyol Express |
ups-kargo | UPS Kargo |
aramex | Aramex |
kolaygelsin | Kolay Gelsin |
kargomsende | Kargomsende |
jetizz | Jetizz |
aras-kurye | Aras Kurye |
kargoist | KargoIst |
netkargo | NetKargo |
aliexpress-cainiao | AliExpress / Cainiao |
tnt | TNT Kargo |
inter-global-kargo | İnter Global Kargo |
dhl | DHL |
china-ems | China Ems |
yanwen | Yanwen |
canadapost | Canadapost |
ups-global | Ups Global |
purolator | Purolator |
poste-italiane | Poste-Italiane |
deutsche-post | Deutsche Post |
uk-mail | Uk Mail |
sendeo-kargo | Sendeo Kargo |
gkn-kargo | Gkn Kargo |
Kargo Takip API sisteminde endpoint'lerdeki status veya statusType alanına aşağıdaki tabloda bulunan statüleri kullanarak filtreleme yapabilir veya gelen response yorumlayabilirsiniz.
Slug | Açıklama |
---|---|
in-output-unit | Çıkış Biriminde |
transit | Yolda |
delivery-branch | Teslimat Şubesinde |
out-for-delivery | Dağıtımda |
delivered | Teslim Edildi |
unknown | Bilinmiyor |
error | Hata (Teslim Edilemedi, Kayıp vs.) |
Kargo Takip API sisteminde erişim sağladığınız hesaba ait kargoların listenmesini sağlamaktadır.
POST
https://api.kargomnerede.co/api/customer/cargo/getall
Header
ApiKey: api_key
Body
{ search: 'Ayakkabı', // Kargo adında arama companySlugs: [ "aras-kargo" // (Aras Kargo) Kargo firmasına göre sorgulama ], statusSlugs: [ "delivered" // (Teslim Edildi) Kargo statülerine göre sorgulama ] }
{ value: [ { id: number, name: string, barcode: string, companyId: number, companySlug: string, isDelivered: boolean, customerEmail: string, customerName: string, customerPhoneNumber: string, orderNumber: string, notificationEnable: boolean, cargo: { barcode: string, isDelivered: boolean, companyId: number, companySlug: string, companyName: string, companyImage: string, statusDescription: string, status: string, statusSlug: string, date: datetime, name: string, code: string, shareUrl: string } } ], success: true, message: Başarılı }
Kargo Takip API sisteminde erişim sağladığınız hesaba kargo eklenmesini sağlamaktadır.
POST
https://api.kargomnerede.co/api/customer/cargo/add
Header
ApiKey: api_key
Body
{ barcodes: [ { code: string, companySlug: string, name: string, orderNumber: string, customerName: string, customerPhoneNumber: string, customerEmail: string, notificationEnable: boolean } ] }
{ value: [ { value: { name: string, id: number, isActive: boolean, barcode: string, companyId: number, companySlug: string, companyName: string, companyImage: string, isDelivered: boolean, statusDescription: string, status: string, statusSlug: string, sender: string, senderAddress: string, sendDate: datetime, receiver: string, receiverAddress: string, deliveredDate: datetime, code: string, shareUrl: string, customerEmail: string, customerName: string, customerPhoneNumber: string, orderNumber: string, movement: [ { description: string, detailDescription: string, title: string, date: datetime, externalLocation: string, status: string, statusSlug: string } ] }, success: true, message: string } ], success: true, message: İşlem başarılı }
Kargo Takip API sisteminde erişim sağladığınız hesaba ait ilgili kargonun detaylarının listelenmesi sağlamaktadır.
POST
https://api.kargomnerede.co/api/customer/cargo/query
Header
ApiKey: api_key
Body
{ barcodes: [ { code: string, companySlug: string } ] }
{ value: [ { value: { name: string, id: number, isActive: boolean, barcode: string, companyId: number, companySlug: string, companyName: string, companyImage: string, isDelivered: boolean, statusDescription: string, status: string, statusSlug: string, sender: string, senderAddress: string, sendDate: datetime, receiver: string, receiverAddress: string, deliveredDate: datetime, code: string, shareUrl: string, customerEmail: string, customerName: string, customerPhoneNumber: string, orderNumber: string, movement: [ { description: string, detailDescription: string, title: string, date: datetime, externalLocation: string, status: string, statusSlug: string } ] }, success: true, message: string } ], success: true, message: İşlem başarılı }
Kargo Takip API sisteminde önceden kaydedilen kargonun bilgilerini getirir.
POST
https://api.kargomnerede.co/api/customer/cargo/getsingle
Header
ApiKey: api_key
Body
{ id: number // Kargo sisteme kaydedilen id'si }
{ value: { id: number, userId: number, name: string, barcode: string, isActive: boolean, companyId: number, companySlug: string, status: string, statusSlug: string, isDelivered: boolean, customerEmail: string, customerName: string, customerPhoneNumber: string, orderNumber: string, notificationEnable: boolean }, "success": boolean, "message": string }
Kargo Takip API sisteminde önceden kaydedilen kargonun bilgilerini düzenler.
POST
https://api.kargomnerede.co/api/customer/cargo/edit
Header
ApiKey: api_key
Body
{ id: number, orderNumber: string, customerName: string, customerPhoneNumber: string, customerEmail: string, notificationEnable: boolean }
{ value: boolean, success: true, message: İşlem başarılı }
Kargo Takip API sisteminde önceden kaydedilen kargoyu siler.
DELETE
https://api.kargomnerede.co/api/customer/cargo/delete
Header
ApiKey: api_key
Query Parameters - Integer Array
https://api.kargomnerede.co/api/customer/cargo/delete?id=number&id=number
{ value: boolean, success: true, message: İşlem başarılı }
Webhook tanımlayarak anlık kargo değişikliklerinden kendi sisteminizi haberdar edebilirsiniz.
Kendi sisteminizde tanımladığınız API uç noktasını Kurumsal Dashboard - Ayarlar - Webhook sekmesi altından ekleyebilirsiniz.
Her kargo durum değişikliğinde bu uç noktası çağrılarak sisteminiz bilgilendirilecektir.
POST
https:/siteniz.com/apiucnokta
Content-Type
application/json
Request Body
{ id: number, // Kargonun bizim sistemimizdeki id'si barcode: string, // Kargo takip numarası statusSlug: string, // Kargonun son durumunun statüsü isDelivered: boolean, companyName: string, description: string, // Kargonun durumu location: string, // Kargonun son lokasyonu shareUrl: string, // Paylaşım Url message: string, // Kullanıcılara gönderilen mesaj içeriği orderNumber: string // Kargonun sisteminizdeki sipariş numarası }
{ success: boolean }