├── README.md └── yurticikargo.php /README.md: -------------------------------------------------------------------------------- 1 | # Yurtiçi Kargo - Php Entegrasyon Kütüphanesi 2 | 3 |

Başlangıç

4 | http://webservices.yurticikargo.com:8080/KOPSWebServices/ShippingOrderDispatcherServices?wsdl 5 | 6 |

İşleyiş

7 | 8 | ```php 9 | 10 | $cargokey, 16 | 'invoiceKey'=>"DENEME", 17 | 'receiverCustName'=>"DENEME DENEME", 18 | 'receiverAddress'=>"DENEME DENEME", 19 | 'cityName'=>"DENEME", 20 | 'townName'=>"DENEME", 21 | 'receiverPhone1'=>"DENEME", 22 | 'receiverPhone2'=>"DENEME", 23 | 'receiverPhone3'=>"DENEME", 24 | 'emailAddress'=>"info@umitkatmer.com.tr", 25 | 'taxOfficeId'=>'', 26 | 'taxNumber'=>"", 27 | 'taxOfficeName'=>"", 28 | 'desi'=>"", 29 | 'kg'=>"", 30 | 'cargoCount'=>'', 31 | 'waybillNo'=>"",//Sevk İrsaliye No (Ticari gönderilerde zorunludur) 32 | 'specialField1'=>"", 33 | 'specialField2'=>"", 34 | 'specialField3'=>"", 35 | 'ttInvoiceAmount'=>"", 36 | 'ttDocumentId'=>'', 37 | 'ttCollectionType'=>"", 38 | 'ttDocumentSaveType'=>"", 39 | 'dcSelectedCredit'=>"", 40 | 'dcCreditRule'=>'', 41 | 'description'=>"", 42 | 'orgGeoCode'=>"", 43 | 'privilegeOrder'=>"", 44 | 'custProdId'=>"", 45 | 'orgReceiverCustId'=>"", 46 | ); 47 | 48 | //$talepno 4 adet kargo gönderme (talep no var) şekli var bunu pazarlama sorumlusu arkadaş size iletecektir. 49 | 50 | $sifreler = array ( 51 | "******(talepno)" => array("bilgi"=>"GÖNDERİCİ ÖDEMELİ NORMAL GÖNDERİLER", 52 | "kullaniciadi"=>"************","sifre"=>"************"), 53 | "******(talepno)" => array("bilgi"=>"GÖNDERİCİ ÖDEMELİ TAHSİLATLI TESLİMAT", 54 | "kullaniciadi"=>"************","sifre"=>"************"), 55 | "******(talepno)" => array("bilgi"=>"ALICI ÖDEMELİ NORMAL GÖNDERİLER", 56 | "kullaniciadi"=>"************","sifre"=>"************"), 57 | "******(talepno)" => array("bilgi"=>"ALICI ÖDEMELİ TAHSİLATLI TESLİMAT", 58 | "kullaniciadi"=>"************","sifre"=>"************") 59 | ); 60 | 61 | 62 | $kullaniciadi = $sifreler[$talepno]["kullaniciadi"] ; 63 | $sifre = $sifreler[$talepno]["sifre"] ; 64 | 65 | $yurticiparams = ["wsUserName"=>$kullaniciadi,"wsPassword"=>$sifre,"userLanguage"=>"TR"]; 66 | 67 | $yurtici = new yurtici($yurticiparams); 68 | $yurtici->createShipment ($params); 69 | //Kargo çıkış , kargo var gelin alın , kargo siparişi verilir. 70 | $yurtici->cancelShipment($cargoKeys=""); 71 | //Kargo çıkışı iptal edilir , Kargo siparişi iptal ,Artık Kargom yok maalesef . 72 | $yurtici->queryShipment($keys="",$keyType="0",$addHistoricalData=true,$onlyTracking=true); 73 | //Kargo Siparişinin Durumu 74 | $yurtici->queryShipmentDetail($keys="",$keyType="0",$addHistoricalData=true,$onlyTracking=true,$jsonData=true); 75 | //Siparişin aşamaları ve detayları , kargo takip linki 76 | $yurtici->queryShipmentDetail($keys="",$keyType="0",$addHistoricalData=true,$onlyTracking=false,$jsonData=false); 77 | //Siparişin aşamaları ve detayları , kargo takip linki , true false değerlerine göre bilgiler gelmektedir. 78 | //Kargo Key otomatik oluşturup bu key ve kargo bilgileri ile 79 | //(adres,telefon,fatura ve irsaliye (ticari gönderiler) numarası zorunludur) 80 | ?> 81 | ``` 82 | 83 | 84 |
Kargo siparişi oluşturup yurtiçi kargo nun sistemine sipariş (kargo çıkışı) düşürülür. 85 |
Kargo siparişi kargonun ödeme tipine göre 4 şekilde yapılmakda ve her talep için faklı kullanıcı adı şifre bulunmakta.Bu talep nolar ile sipariş vermekte zorunlusunuz. 86 |
Kargo firması kargo almaya geldiğinde kargo keyi ile kargoları alır ve bunları sisteme bu key ile girerler.Sizde bu key ile kargonuzun durumunu takip edebilirsiniz.(Biraz zorunlu sorunlu bir süreç). 87 | 88 |

Not

89 | Sunucu da bu kodun çalışabilmesi için 80 port unun acık olması , soket , openssl , SOAP , curl gibi eklentilerin açık olması gerekmekte. 90 | 91 |

İletişim

92 | ÜMİT KATMER 93 |
info@umitkatmer.com.tr 94 |
https://umitkatmer.com.tr 95 |
https://www.facebook.com/katmersoft 96 | 97 | 98 | -------------------------------------------------------------------------------- /yurticikargo.php: -------------------------------------------------------------------------------- 1 | self::$_wsUserName, 15 | 'wsPassword' => self::$_wsPassword, 16 | 'userLanguage' => self::$_userLanguage, 17 | ]; 18 | } 19 | 20 | public function setUrl($url) { 21 | self::$_sclient = new \SoapClient($url); 22 | } 23 | 24 | 25 | 26 | public function createShipment($datagelen) { 27 | 28 | $data = array_merge( 29 | array("wsUserName" => self::$_parameters['wsUserName'], 30 | "wsPassword" => self::$_parameters['wsPassword'], 31 | "userLanguage" => self::$_parameters['userLanguage'], 32 | ), 33 | array("ShippingOrderVO" => $datagelen) 34 | ); 35 | 36 | 37 | $this->setUrl('http://webservices.yurticikargo.com:8080/KOPSWebServices/ShippingOrderDispatcherServices?wsdl'); 38 | return self::$_sclient->createShipment($data); 39 | } 40 | 41 | public function cancelShipment($cargoKeys) { 42 | 43 | $data = array_merge( 44 | array("wsUserName" => self::$_parameters['wsUserName'], 45 | "wsPassword" => self::$_parameters['wsPassword'], 46 | "userLanguage" => self::$_parameters['userLanguage'], 47 | "cargoKeys" => $cargoKeys, 48 | ) 49 | 50 | ); 51 | 52 | 53 | $this->setUrl('http://webservices.yurticikargo.com:8080/KOPSWebServices/ShippingOrderDispatcherServices?wsdl'); 54 | return self::$_sclient->cancelShipment($data); 55 | } 56 | 57 | public function queryShipment($keys,$keyType,$addHistoricalData=true,$onlyTracking=true) { 58 | 59 | $data = array_merge( 60 | array("wsUserName" => self::$_parameters['wsUserName'], 61 | "wsPassword" => self::$_parameters['wsPassword'], 62 | "wsLanguage" => self::$_parameters['userLanguage'], 63 | "keys" => $keys, // array olacak [] 64 | "keyType" => $keyType, // 0 – Kargo Anahtarı 1 – Fatura Anahtarı 65 | "addHistoricalData" => $addHistoricalData, // true / false Default : false 66 | "onlyTracking" => $onlyTracking, // true / false Default : false 67 | 68 | ) 69 | 70 | ); 71 | 72 | 73 | $this->setUrl('http://webservices.yurticikargo.com:8080/KOPSWebServices/ShippingOrderDispatcherServices?wsdl'); 74 | return self::$_sclient->queryShipment($data); 75 | } 76 | 77 | 78 | public function queryShipmentDetail($keys,$keyType,$addHistoricalData=true,$onlyTracking=true,$jsonData=true) { 79 | 80 | $data = array_merge( 81 | array("wsUserName" => self::$_parameters['wsUserName'], 82 | "wsPassword" => self::$_parameters['wsPassword'], 83 | "wsLanguage" => self::$_parameters['userLanguage'], 84 | "keys" => $keys, // array olacak [] 85 | "keyType" => $keyType, // 0 – Kargo Anahtarı 1 – Fatura Anahtarı 86 | "addHistoricalData" => $addHistoricalData, // true / false Default : false 87 | "onlyTracking" => $onlyTracking, // true / false Default : false 88 | "jsonData" => $jsonData, // true / false Default : false 89 | 90 | ) 91 | 92 | ); 93 | 94 | 95 | $this->setUrl('http://webservices.yurticikargo.com:8080/KOPSWebServices/ShippingOrderDispatcherServices?wsdl'); 96 | return self::$_sclient->queryShipmentDetail($data); 97 | } 98 | 99 | 100 | 101 | public function __destruct() { 102 | if ($this->_debug) { 103 | print_r(self::$_parameters); 104 | } 105 | } 106 | } 107 | 108 | 109 | 110 | $cargokey = rand(1111111111111111111,99999999999999999999); 111 | 112 | $params = array( 113 | 'cargoKey'=>$cargokey, 114 | 'invoiceKey'=>"DENEME", 115 | 'receiverCustName'=>"DENEME DENEME", 116 | 'receiverAddress'=>"DENEME DENEME", 117 | 'cityName'=>"DENEME", 118 | 'townName'=>"DENEME", 119 | 'receiverPhone1'=>"DENEME", 120 | 'receiverPhone2'=>"DENEME", 121 | 'receiverPhone3'=>"DENEME", 122 | 'emailAddress'=>"info@umitkatmer.com.tr", 123 | 'taxOfficeId'=>'', 124 | 'taxNumber'=>"", 125 | 'taxOfficeName'=>"", 126 | 'desi'=>"", 127 | 'kg'=>"", 128 | 129 | 'cargoCount'=>'', 130 | 'waybillNo'=>"",//Sevk İrsaliye No (Ticari gönderilerde zorunludur) 131 | 132 | 'specialField1'=>"", 133 | 'specialField2'=>"", 134 | 'specialField3'=>"", 135 | 'ttInvoiceAmount'=>"", 136 | 137 | 'ttDocumentId'=>'', 138 | 'ttCollectionType'=>"", 139 | 'ttDocumentSaveType'=>"", 140 | 141 | 'dcSelectedCredit'=>"", 142 | 143 | 'dcCreditRule'=>'', 144 | 'description'=>"", 145 | 'orgGeoCode'=>"", 146 | 'privilegeOrder'=>"", 147 | 'custProdId'=>"", 148 | 'orgReceiverCustId'=>"", 149 | 150 | 151 | ); 152 | 153 | 154 | //$talepno yurt içi kargodan aldığınız talep koduna göre kargonuzu göndermek istediğiniz şekilde login olup kargoyu oluşturmanız gerekmekte 155 | // 4 adet kargo gönderme (talep no var) şekli var bunu pazarlama sorumlusu arkadaş size iletecektir. 156 | //siz eğer alıcı ödeyecekse bu kullanıcı adı şifre ile kargoyu göndereceksiniz. 157 | 158 | $sifreler = array ( 159 | 160 | "******(talepno)" => array( 161 | 162 | "bilgi"=>"GÖNDERİCİ ÖDEMELİ NORMAL GÖNDERİLER", 163 | "kullaniciadi"=>"************", 164 | "sifre"=>"************", 165 | 166 | ), 167 | "******(talepno)" => array( 168 | 169 | "bilgi"=>"GÖNDERİCİ ÖDEMELİ TAHSİLATLI TESLİMAT", 170 | "kullaniciadi"=>"************", 171 | "sifre"=>"************", 172 | 173 | ), 174 | "******(talepno)" => array( 175 | 176 | "bilgi"=>"ALICI ÖDEMELİ NORMAL GÖNDERİLER", 177 | "kullaniciadi"=>"************", 178 | "sifre"=>"************", 179 | 180 | ), 181 | "******(talepno)" => array( 182 | 183 | "bilgi"=>"ALICI ÖDEMELİ TAHSİLATLI TESLİMAT", 184 | "kullaniciadi"=>"************", 185 | "sifre"=>"************", 186 | 187 | ), 188 | ); 189 | 190 | 191 | $kullaniciadi = $sifreler[$talepno]["kullaniciadi"] ; 192 | $sifre = $sifreler[$talepno]["sifre"] ; 193 | 194 | $yurticiparams = [ 195 | "wsUserName"=>$kullaniciadi, 196 | "wsPassword"=>$sifre, 197 | "userLanguage"=>"TR" 198 | ]; 199 | 200 | $yurtici = new yurtici($yurticiparams); 201 | //$OrderList = $yurtici->createShipment ($params); //Kargo çıkış , kargo var gelin alın , kargo siparişi verilir. 202 | //$OrderList = $yurtici->cancelShipment($cargoKeys="**************");// Kargo çıkışı iptal edilir , Kargo siparişi iptal ,Artık Kargom yok maalesef . 203 | //$OrderList = $yurtici->queryShipment($keys="**************",$keyType="0",$addHistoricalData=true,$onlyTracking=true);//Kargo Siparişinin Durumu 204 | //$OrderList = $yurtici->queryShipmentDetail($keys="**************",$keyType="0",$addHistoricalData=true,$onlyTracking=true,$jsonData=true);//Siparişin aşamaları ve detayları , kargo takip linki 205 | $OrderList = $yurtici->queryShipmentDetail($keys="**************",$keyType="0",$addHistoricalData=true,$onlyTracking=false,$jsonData=false);////Siparişin aşamaları ve detayları , kargo takip linki , true false değerlerine göre bilgiler gelmektedir. 206 | 207 | 208 | 209 | 210 | 211 | //Tüm hataları ekrana basar 212 | if (is_soap_fault($OrderList)) { 213 | trigger_error("SOAP Fault: (faultcode: {$OrderList->faultcode}, faultstring: {$OrderList->faultstring})", E_USER_ERROR); 214 | } 215 | 216 | ?> 217 | --------------------------------------------------------------------------------