Gönderi İptal Etme

Method	URL	İçerik Türü
POST	post/cancel	application/json

Servise gönderilmesi gereken zorunlu başlıklar
Servise gönderilmesi gereken parametreler
Örnek İstek
Örnek cevaplar

Açıklama

- Bu metod, gönderinin iptal edilmesi veya gönderi işleminin geri alınması için kullanılır. Kullanıcılar veya işyerleri, bir gönderiyi teslim edilmeden önce iptal etmek istediklerinde veya teslimat sürecini durdurmak istediklerinde bu metodu kullanarak API aracılığıyla iptal talebinde bulunabilirler.

- Gönderi iptal'i gönderi durumu 'Önizleme' ya da 'Teslim Alınacak' durumlarında yapılabilmektedir.

- Gönderi iptal işlemi gönderi durumu 'İşlemde' olduğu zamanlarda yapılamamaktadır. Gönderi özelindeki işlem bittiğinde tekrar iptal edebilirsiniz.

Servise Gönderilmesi gereken zorunlu başlıklar

Parametre ismi	Tip	Zorunluluk	Açıklama
Authorization	string	evet	auth/login metodundan aldığınız token

Servise Gönderilmesi gereken parametreler

Parametre ismi	Tip	Zorunluluk	Açıklama
post_number	string	evet	Oluşan gönderi numarası

Örnek İstek

<?php

$data = [
  "post_number"=>"MFYS29970"
];
$payload = json_encode($data);

$ch = curl_init('__APIURL__/post/cancel');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
   'X-localization : tr', 
   'Content-Type : application/json',
   'Authorization : Bearer __TOKEN__',
]);

$result = curl_exec($ch);

curl_close($ch);

print_r($result);

?>

const axios = require('axios');
let data = JSON.stringify({
  "post_number": "MFYS29970"
});

let config = {
  method: 'post',
  url: '__APIURL__/post/cancel',
  headers: { 
    'X-localization' : 'tr', 
    'Content-Type': 'application/json', 
    'Authorization': 'Bearer __TOKEN__'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

import requests
import json

url = "__APIURL__/post/cancel"

payload = json.dumps({
  "post_number": "MFYS29970"
})
headers = {
  'X-localization' : 'tr', 
  'Content-Type' : 'application/json',
  'Authorization' : 'Bearer __TOKEN__'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var data = new
        {
            post_number = "MFYS29970"
        };

        var payload = Newtonsoft.Json.JsonConvert.SerializeObject(data);

        using (var client = new HttpClient())
        {
            client.DefaultRequestHeaders.Add("X-localization", "tr");
            client.DefaultRequestHeaders.Add("Content-Type", "application/json");
            client.DefaultRequestHeaders.Add("Authorization", "Bearer __TOKEN__");

            var response = await client.PostAsync("__APIURL__/v2/post/cancel",
                new StringContent(payload, Encoding.UTF8, "application/json"));

            var result = await response.Content.ReadAsStringAsync();
            Console.WriteLine(result);
        }
    }
}

Örnek Servis Cevapları

{
    "status": true,
    "message": "Gönderi başarıyla iptal edilmiştir.",
    "data": {
        "post_number": "MFYS29970",
        "reference_id": "LDTN64JV124",
        "tracking_url": "https://track.carrtell.co/check/MFYS29970",
        "barcode_url": "https://barcode.carrtell.co/MFYS29970.pdf",
        "post": {
            "carrier_id": 4,
            "carrier_name": "MNG Kargo",
            "post_type": 2,
            "post_type_name": "Standart Teslimat",
            "cod_payment_type": 0,
            "cod_payment_type_name": "Peşin Ödeme",
            "sender": {
                "name": "John Doe",
                "phone": "+90 535 123 45 67",
                "email": "sender@firma.com",
                "address": "Deneme Mahallesi, Dolmabahçe Caddesi",
                "country": "tr",
                "city": "İstanbul",
                "district": "Ataşehir",
                "post_code": null,
                "latitude": null,
                "longitude": null
            },
            "recipient": {
                "name": "John Doe",
                "phone": "+90 535 123 45 67",
                "email": "recipient@firma.com",
                "address": "Deneme Mahallesi, Ural Sk. No:999",
                "country": "tr",
                "city": "İstanbul",
                "district": "Maltepe",
                "post_code": null,
                "latitude": null,
                "longitude": null
            },
            "post": {
                "desi": 2.2,
                "package_count": 1,
                "price": null,
                "note": null
            },
            "custom_data_1": null,
            "custom_data_2": null,
            "custom_data_3": null,
            "custom_data_4": null,
            "created_at": "2023-06-01 13:39:46",
            "updated_at": "2023-06-01 14:06:12"
        }
    }
}

{
    "status": false,
    "error": "Bu kaynağa erişim yetkiniz yoktur."
}

{
    "message": "Doğrulama Hatası",
    "status": false,
    "error": {
        "post_number": [
            "Aradığınız gönderi bulunamadı."
        ]
    }
}