Skip to content

beratkrdr/yurtici-kargo-entegrasyon-php

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

32 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Hits Contributors Forks Stargazers Issues MIT License LinkedIn

Logo

Yurtiçi Kargo - Php Entegrasyon Kütüphanesi

Bu kütüphane sayesinde Yurtiçi Kargo ile entegre bir şekilde kargo oluşturabilir, kargo durumunu sorgulayabilir ve kargonuzu iptal edebilirsiniz.

Örnek Kodlar »
Hata Bildir · Öneri/İstek

İçindekiler

Proje Hakkında

Bu kütüphane sayesinde Yurtiçi Kargo ile entegre bir şekilde kargo oluşturabilir, kargo durumunu sorgulayabilir ve kargonuzu iptal edebilirsiniz.

Yurtiçi Kargo entegrasyonu için gerekli olan web servis kullanıcı adı ve web servis şifresi için entegrasyon başvurusu yapmanız gerekmektedir. Entegrasyon dökümanını Yurtiçi Kargo pazarlama sorumlusundan alarak entegrasyon bilgilerine, parametrelere ve örneklere erişebilirsiniz.

Kodların sorunsuz çalışabilmesi için sunucunun 80 numaralı portu ve soket, openssl, SOAP, curl gibi eklentilerin açık olması gerekmektedir.

Örnek Kodlar

Zorunlu Parametreler:

wsUserName : Web servis kullanıcı adı

wsPassword : Web servis şifresi

wsLanguage : Web servis dil seçeneği (Örnek: 'TR')

cleanResult : Sonuç dizisinin daha yalın olmasını sağlar. (true/false)(Varsayılan: true)

testMode : Test modu (true/false)

NOT: Yukarıdaki parametreler tüm örnekler için geçerlidir.


Kargo Oluşturma

Zorunlu Parametreler:

cargoKey : Kargo anahtarı (Her gönderi için benzersiz olmalıdır)

invoiceKey : Fatura anahtarı (Her gönderi için benzersiz olmalıdır)

receiverCustName : Alıcı adı (Min 5 karakter olmalı en az 4 harf içermelidir.)

receiverAddress : Alıcı adresi (Min 5 max 200 karakter olmalıdır. İl ve ilçe bilgisi cityName ve townName alanlarında gönderildiğinde bu alanda gönderilmemelidir.)

receiverPhone1 : Alıcı telefon-1 (Alan kodu ile birlikte 10 adet rakamdan oluşmalıdır.)

<?php
require_once "../src/class.php";

$yurtici = new yurticiKargo(array(
    'wsUserName'      => "{wsUserName}",
    'wsPassword'      => "{wsPassword}",
    'wsLanguage'      => "{wsLanguage}",    // Default: TR
    'cleanResult'     => true,              // Default: true [true/false]
    'testMode'        => true               // Default: false [true/false]
));

$response = $yurtici->createShipment(array(
    "cargoKey"          => "123456",
    'invoiceKey'        => "654321",
    'receiverCustName'  => "John Doe",
    'receiverAddress'   => "Lorem Ipsum is simply dummy text of the printing and typesetting industry.",
    'cityName'          => "City",
    'townName'          => "Town",
    'receiverPhone1'    => "05554443322",
    'emailAddress'      => "johndoe@gmail.com",
    'orgReceiverCustId' => '9999'
));
?>

Sonuç

Array
(
    [outFlag] => 0
    [outResult] => Başarılı
    [count] => 1
    [jobId] => 2198077
    [shippingOrderDetailVO] => Array
        (
            [cargoKey] => 123456
            [invoiceKey] => 654321
        )

)

Kargo Sorgulama

Zorunlu Parametreler:

keys : Kargo/Fatura anahtarı

keyType : Keys parametresinde belirtilen anahtarların tipini belirler. 0 – Kargo Anahtarı / 1 – Fatura Anahtarı

addHistoricalData : Gönderiye ait taşıma hareketlerinin raporlanması için belirtilmelidir.

onlyTracking : Sadece takip linkinin raporlanmasını sağlar.

<?php
require_once "../src/class.php";

$yurtici = new yurticiKargo(array(
    'wsUserName'      => "{wsUserName}",
    'wsPassword'      => "{wsPassword}",
    'wsLanguage'      => "{wsLanguage}",    // Default: TR
    'cleanResult'     => true,              // Default: true [true/false]
    'testMode'        => true               // Default: false [true/false]
));

$response = $yurtici->queryShipment('123456', 0, false, true);
?>

Sonuç

Array
(
    [outFlag] => 0
    [outResult] => Başarılı
    [count] => 1
    [senderCustId] => 1010954
    [shippingDeliveryDetailVO] => Array
        (
            [cargoKey] => 123456
            [invoiceKey] => 654321
            [jobId] => 2198077
            [operationCode] => 0
            [operationMessage] => Kargo İşlem Görmemiş.
            [operationStatus] => NOP
        )

)

Kargo İptal Etme

Zorunlu Parametreler:

cargoKeys : Kargo anahtarı

<?php
require_once "../src/class.php";

$yurtici = new yurticiKargo(array(
    'wsUserName'      => "{wsUserName}",
    'wsPassword'      => "{wsPassword}",
    'wsLanguage'      => "{wsLanguage}",    // Default: TR
    'cleanResult'     => true,              // Default: true [true/false]
    'testMode'        => true               // Default: false [true/false]
));

$response = $yurtici->cancelShipment('123456');
?>

Sonuç

Array
(
    [outFlag] => 0
    [outResult] => Başarılı
    [count] => 1
    [senderCustId] => 1010954
    [shippingCancelDetailVO] => Array
        (
            [cargoKey] => 123456
            [docId] => 0
            [invoiceKey] => 654321
            [jobId] => 2198077
            [operationCode] => 3
            [operationMessage] => Verisi İptal Edilmiştir.Kargo Çıkışı Engellendi.
            [operationStatus] => CNL
        )

)

İletişim

Berat Kırdar

Proje Bağlantısı: https://github.com/beratkrdr/yurtici-kargo-entegrasyon-php

GitHub LinkedIn Gmail