README

为Gurmesoft生产的kargo集成包。支持国内、Mng、Ptt、Sürat、Aras和Bolt快递。

步骤 1

创建composer.json文件或向现有文件中的适当对象添加内容。

{
  "require": {
    "gurmesoft/cargo": "dev-master"
  },
  "repositories": [
    {
      "type": "github",
      "url": "https://github.com/gurmesoft/gurmesoft-cargo"
    }
  ]
}

步骤 2

使用composer调用包

composer require gurmesoft/cargo:dev-master

步骤 3

包含vendor/autoload.php文件，并生成公司类型以准备就绪。

<?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);

创建发货

<?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.
}

查询发货状态

<?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.

取消发货

<?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.