gurmesoft / cargo
There is no license information available for the latest version (dev-master) of this package.
dev-master
2022-11-01 08:12 UTC
This package is auto-updated.
Last update: 2025-06-29 02:00:03 UTC
README
Gurmesoft için üretilmiş kargo entegrasyon pakedi.Yurtiçi, Mng, Ptt, Sürat, Aras ve Bolt kargo desteği mevcuttur.
Adım 1
composer.json
dosyası oluşturulur yada var olan dosyadaki uygun objelere ekleme yapılır.
{ "require": { "gurmesoft/cargo": "dev-master" }, "repositories": [ { "type": "github", "url": "https://github.com/gurmesoft/gurmesoft-cargo" } ] }
Adım 2
composer
kullanılarak paket çağırılır
composer require gurmesoft/cargo:dev-master
Adım 3
vendor/autoload.php
dosyası dahil edilir ve firma türetilerek hazır hale getirilir.
<?php require 'vendor/autoload.php'; $options = array( 'live' => false, // Test ortamı için gereklidir. 'apiKey' => 'XXXXXXXX', // Kargo firması tarafından verilen anahtar,kullanıcı vb. 'apiPass' => 'XXXXXXXX', // Kargo firması tarafından verilen şifre,gizli anahtar vb. ); $yurtici = new \GurmesoftCargo\Client('Yurtici', $options);
Gönderi oluşturma
<?php $shipment = new \GurmesoftCargo\Shipment; $shipment->setBarcode('XXXXXXXXXXXX') // Eşsiz barkod numaranız her gönderi için yenisini türetiniz. ->setInvoice('XXXXXXXXXXXX') // Gönderi fatura numarası ->getWaybill('XXXXXXXXXXXX') // İrsaliye No (Ticari gönderilerde zorunludur) ->setFirstName('Fikret') // Alıcı ad ->setLastName('Çin') // Alıcı soyad ->setPhone('5527161084') // Alıcı telefon ->setCity('Bursa' || '16') // Alıcı il (Plaka kodu destekler örn. 01,16,81) ->setDistrict('Nilüfer') // Alıcı ilçe bilgisi ->setAddress('Ertuğrul Cd. Eker İş Hanı D13') // Alıcı adres bilgisi ->setPostcode('16120') // Alıcı posta kodu bilgisi (Opsiyonel) ->setMail('info@gurmesoft.com'); // Alıcı e-posta (Opsiyonel) $result = $yurtici->createShipment($shipment); $result->getResponse(); // Kargo firmasından gelen tüm cevabı incelemek için kullanılır. if ($result->isSuccess()) { echo $result->getBarcode(); // Kargo firmasının barkod ürettiği senaryolarda barkodu taşır. echo $result->getOperationCode(); // Paketin operasyon kodunu döndürür. echo $result->getOperationMessage(); // Paketin operasyon mesajını döndürür. echo $result->getTrackingUrl(); // Paket taşıma aşamasında ise takip linkini döndürür. echo $result->getTrackingCode(); // Paket taşıma aşamasında ise takip kodunu döndürür. } else { echo $result->getErrorCode(); // Hata kodunu döndürür. echo $result->getErrorMessage(); // Hata mesajını döndürür. }
Gönderinin durumunu sorgulama
<?php $barcode = 'XXXXXXXXXXXX'; // Başarılı gönderi oluşturma sonucu kayıt edilen barkod $result = $yurtici->infoShipment($barcode); // Dönen cevabı gönderi oluşturmadaki methodlar ile inceleyebilirsiniz.
Gönderinin iptali
<?php $barcode = 'XXXXXXXXXXXX'; // Başarılı gönderi oluşturma sonucu kayıt edilen barkod $result = $yurtici->cancelShipment($barcode); // Dönen cevabı gönderi oluşturmadaki methodlar ile inceleyebilirsiniz.