README

要使用 PTT Web 服务，您可以从 PTT 市级办事处获取客户 ID 和客户密码信息。

PTT Web 服务文档

https://github.com/ahmeti/ptt-kargo-api/blob/master/01_PTT_Entegrasyon_Giris.pdf

https://github.com/ahmeti/ptt-kargo-api/blob/master/02_PTT_Veri_Yukleme_Web_Servisi.pdf

PTT 扩展服务代码

AA - ADRESTEN ALMA
ST - ŞEHİR İÇİ TESLİM
DK - DEĞER KONULMUŞ
OS - ÖDEME ŞARTLI
AH - ALMA HABERLİ
AK - ALICININ KENDİNE TESLİM
TA - TELEFONLA BİLGİLENDİRME
KT - KONTROLLU TESLIM
OU - ÖZEL ULAK
UA - ÜCRETİ ALICIDAN TAHSİL
GD - GİDİŞ-DÖNÜŞ
SV - SERVİS
RP - RESMİ PUL
UO - ÜCRET ÖDEME MAKİNESİ
VI - KREDİ KARTI
PC - POSTA ÇEKİ HESABI
DN - BARKOD DÖNÜŞLÜ
PI - PTT ISYERINE TESLIM
AT - ADLI TIP
PR - POSTRESTANT
SB - SMS ILE BILGILENDIRME

PTT 状态代码

要查看完整列表，请点击 03_PTT_Durum_Kodlari.md

状态代码列表是在 Arif Bey 的支持下编制的。

使用 Composer 安装

https://packagist.org.cn/packages/ahmeti/ptt-kargo-api

composer require "ahmeti/ptt-kargo-api:@dev"

环境变量

PTT_ACT_ID=
PTT_ACT_PASS=

如果已定义环境变量

<?php
# pttApi nesnemizi .env değişkenleri ile oluşturuyoruz.
$pttApi = new \Ahmeti\PttKargoApi\PttKargoApi();

如果未定义环境变量

<?php
# pttApi nesnemizi parametre ile oluşturuyoruz.
$pttApi = new \Ahmeti\PttKargoApi\PttKargoApi($pttMusteriId, $pttMusteriSifre);

01. 条码查询

<?php
$result = $pttApi->barkodSorgu('KP02168XXXXXX');

if( is_array($result) ){
    // Başarılı
    var_dump($result);
}else{
    // Hata (SoapFault)
    var_dump($result);
}

02. 发送件移动业务处理日期查询

<?php
$result = $pttApi->gonderiHareketIslemTarihiSorgu('2018-03-01');

if( is_array($result) ){

    foreach( $result['dongu'] as $item ){
        // Başarılı
        var_dump($item);
    }

}else{
    // Hata (SoapFault)
    var_dump($result);
}

03. Ptt 数据上传 2

API: https://pttws.ptt.gov.tr/PttVeriYukleme/services/Sorgu?wsdl

<?php

use Ahmeti\PttKargoApi\PttVeriYukle2;

# $items = (array) Kargo Bilgileri

$ptt = (new PttVeriYukle2())->kullanici('PttWs')
    ->sifre(env('PTT_ACT_PASS'))
    ->musteriId(env('PTT_ACT_ID'))
    ->dosyaAdi(date('Ymd-His-').uniqid())
    ->gonderiTur('KARGO')
    ->gonderiTip('NORMAL');

foreach ($items as $item){
    $ptt->aAdres($item->aAdres)
        ->agirlik($item->agirlik)
        ->aliciAdi($item->aliciAdi)
        ->aliciIlAdi($item->aliciIlAdi)
        ->aliciIlceAdi($item->aliciIlceAdi)
        ->aliciSms($item->aliciSms)
        ->barkodNo($item->barkodNo)
        ->boy($item->boy)
        ->deger_ucreti($item->deger_ucreti)
        ->desi($item->desi)
        ->ekhizmet($item->ek_hizmet)
        ->en($item->en)
        ->musteriReferansNo($item->musteriReferansNo)
        ->odemesekli($item->odemesekli)
        ->odeme_sart_ucreti($item->odeme_sart_ucreti)
        ->rezerve1($item->rezerve1)
        ->yukseklik($item->yukseklik)
        ->ekle();
}

$result = $ptt->yukle();

if( is_array($result) && $result['hataKodu'] == 1 ){

    print_r($result);

    foreach ($result['dongu'] as $barcode){
        // $barcode
    }

    return true;

}else{

    print_r($result['aciklama']);

    return false;
}

04. Ptt 条码数据删除

要删除我们创建的条码，可以使用以下方法。

API: https://pttws.ptt.gov.tr/PttVeriYukleme/services/Sorgu?wsdl

<?php

use Ahmeti\PttKargoApi\PttBarkodVeriSil;

$ptt = new PttBarkodVeriSil();

$result = $ptt->barcode('BARKOD NO')
    ->dosyaAdi('BORKODU İLK KAYDETTİĞİNİZ DOSYA ADI')
    ->musteriId('XXX_Musteri_Id')
    ->sifre('XXX_Sifre')
    ->sil();

if( is_array($result) && $result['hataKodu'] == 1 ){

    print_r($result);

    return true;

}else{

    print_r($result);

    return false;
}