Genel Bilgilendirme
TEST
API : https://www.pts.net:5161/api/shipmentv4/api.php
WSDL URL Adress : https://www.pts.net:5161/api/shipmentv4/api.php?wsdl
Canlı
API : https://www.pts.net:443/api/shipmentv4/api.php
WSDL URL Adress : https://www.pts.net:443/api/shipmentv4/api.php?wsdl
Bu çalışma, müşteri gönderilerinin PTS sistemine SOAP/XML kullanılarak aktarılması amacıyla
hazırlanmıştır. Özellikle e-ticaret sistemleriyle haberleşebilmesi hedeflenmiştir.
Oturum kimlik doğrulama kullanici, sifre
Sürüm Notları
1.9.2 - 23.05.2023 versiyonda yapılan değişiklikler
1. addshipmentwithservicetype methodunda yapılan değişiklik:
Fatura parametresi kısmına eklenen
urunkodu { Ürün kodu isteğe bağlı }, urunbarkodu { Ürün barkodu isteğe bağlı }, Fatura kısmına bu parametreler eklenmiştir.
1.9.1 - 10.05.2023 versiyonda yapılan değişiklikler
1. addshipment, addshipmentExpress, addShipmentWithPickUp, addshipmentwithservicetype methodlarında yapılan değişiklik:
payType{ O-P }, gumruktipi{ D (DDP) - H (DAP) }, musteriBeyanTuru{ M - N - D }, business_model{ 1 (Online Satış Değil) - 2 (Online Satış) } parametrelerinden herhangi biri girildiğinde bu değerler dışında kabul edilmeyecektir.
2. addShipmentVariantJoom methodunda yapılan değişiklik:
payType{ O-P }, business_model{ 1 (Online Satış Değil) - 2 (Online Satış) } parametrelerinden herhangi biri girildiğinde bu değerler dışında kabul edilmeyecektir.
Güvenlik
Yazılımını kendi geliştiren API müşterilerimize, Geliştirici Anahtarı ve Kullanıcı Anahtarı veriyoruz. PTS API sistemi için eklenti geliştiren yazılım şirketlerine sadece Geliştirici Anahtarı veriyoruz ve bu tür hazır yazılımları kullanan müşterilerimize de sadece Kullanıcı Anahtarı veriyoruz. Bu iki anahtar birlikte kullanıldığında, sistemimizin güvenlik mekanizması, hem geliştiriciyi hem de müşteriyi doğrulamış oluyor.
Test Ortamı Geliştirici Anahtar :DEV-27541194384867335
Test Ortamı Kullanıcı Anahtar : bbd47bf0-8ff8-11ec-83f4-005056b8981b
https://pts.net:5161/api/shipmentv4/api.php
Kodlama
Pts tüm içeriğin UTF-8 kodlu olmasını bekler.
Yanıt İçerik Türü
Yanıt, HTTP Content-Type üstbilgisindeki yanıt türünü gösterir. Content-Type: text/xml;charset=utf-8
Tarih Biçimleri
Pts Api sistemindeki tüm tarihler YYYY-mm-dd formatında
Gönderi Ekleme
Method Test Url si
https://pts.net:5161/api/shipmentv4/api.php
Method Canlı Url si
https://pts.net:443/api/shipmentv4/api.php
Bu metot gönderi oluşturmayı sağlayan,varsayılan gönderi oluşturma metodudur. İsteğin başarılı olması durumunda, ileteceğiniz etiket parametresine göre, gönderi üzerine yapıştıracağınız, A6 boyutunda,bir etiket link'i dönüyor olacaktır.
Etiket Parametresi
- 0. basılmasın (default)
- 1. PTS Etiketi (yetkilendirme gereklidir)
- 2 ve üzeri değerleri LastMile (son dağıtıcı acente) etiketi dönecektir. LastMile etiket kullanımı PTS yetkilendirmesi ile mümkündür.
ptsno parametresi 0 gönderilmesi durumunda yeni gönderi oluşturulacaktır.
Önceden alınmış bir ptsno ile gönderilmesi durumunda yeni iletilen ptsno güncellenecektir.
Bu method tanımlı servislerin kullanımına izin verir. ( Servis Kodları kısmında servislere erişebilirsiniz. )
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv=
"http://schemas.xmlsoap.org/soap/envelope/"
xmlns:urn="urn:server">
<soapenv:Header/>
<soapenv:Body>
<urn:addShipment soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<kullanici xsi:type="xsd:string">DEV-27541194384867335</kullanici>
<sifre xsi:type="xsd:string">bbd47bf0-8ff8-11ec-83f4-005056b8981b</sifre>
<ptsno xsi:type="xsd:string">0</ptsno>
<servis xsi:type="xsd:string">E</servis>
<yetkili xsi:type="xsd:string">TESTYETKİLİ</yetkili>
<sirketadi xsi:type="xsd:string">TEST ŞİRKET ADI</sirketadi>
<adres xsi:type="xsd:string">TEST ADRES</adres>
<sehir xsi:type="xsd:string">Rotterdam</sehir>
<eyalet xsi:type="xsd:string">?</eyalet>
<postakodu xsi:type="xsd:string">3034PJ</postakodu>
<ulkekodu xsi:type="xsd:string">NL</ulkekodu>
<telefon xsi:type="xsd:string">02123659874</telefon>
<email xsi:type="xsd:string">test@gmail.com</email>
<toplamkg xsi:type="xsd:decimal">2</toplamkg>
<siparisno xsi:type="xsd:string">TESTORDER4</siparisno>
<malcinsi xsi:type="xsd:string">DRESS</malcinsi>
<toplamadet xsi:type="xsd:string">2</toplamadet>
<toplamdeger xsi:type="xsd:decimal">7</toplamdeger>
<parabirimi xsi:type="xsd:string">EUR</parabirimi>
<fatura xsi:type="SOAP-ENC:Array" SOAP-ENC:arrayType="urn:line[2]">
<item xsi:type="tns:line">
<aciklama xsi:type="xsd:string">LADIES SWEATA</aciklama>
<miktar xsi:type="xsd:decimal">55</miktar>
<birim xsi:type="xsd:string">pcs</birim>
<birimfiyat xsi:type="xsd:decimal">3</birimfiyat>
<gtip xsi:type="xsd:string">4242424233</gtip>
<discount xsi:type="xsd:decimal"></discount>
<vatbase xsi:type="xsd:decimal"></vatbase>
<itemUrl xsi:type="xsd:string">
https://media.istockphoto.com/photos/mens-white-blank-tshirt-templatefrom-two-sides-natural-shape-on-for-picture-id1151955708
</itemUrl>
<sivv xsi:type="xsd:decimal"></sivv>
<mensei xsi:type="xsd:string">TR</mensei>
</item>
<item xsi:type="tns:line">
<aciklama xsi:type="xsd:string">Thermo Clothes</aciklama>
<miktar xsi:type="xsd:decimal">2</miktar>
<birim xsi:type="xsd:string">PCS</birim>
<birimfiyat xsi:type="xsd:decimal">59.99</birimfiyat>
<gtip xsi:type="xsd:string">620213100019</gtip>
<discount xsi:type="xsd:decimal"></discount>
<vatbase xsi:type="xsd:decimal"></vatbase>
<itemUrl xsi:type="xsd:string">
https://media.istockphoto.com/photos/mens-white-blank-tshirt-templatefrom-two-sides-natural-shape-on-for-picture-id1151955708
</itemUrl>
<sivv xsi:type="xsd:decimal"></sivv>
<mensei xsi:type="xsd:string">TR</mensei>
</item>
</fatura>
<faturano xsi:type="xsd:string">458712</faturano>
<faturatarihi xsi:type="xsd:string">2022-08-10</faturatarihi>
<earsivpdf xsi:type="xsd:string">?</earsivpdf>
<etiket xsi:type="xsd:string">1</etiket>
<gonderici_yetkilisi xsi:type="xsd:string">TEST GÖNDERİCİ YETKİLİSİ</gonderici_yetkilisi>
<ebat xsi:type="urn:dims" SOAP-ENC:arrayType="urn:dim[2]">
<dim>
<en xsi:type="xsd:string">20</en>
<boy xsi:type="xsd:decimal">20</boy>
<yukseklik xsi:type="xsd:string">10</yukseklik>
<agirlik xsi:type="xsd:decimal">0.75</agirlik>
</dim>
<dim>
<en xsi:type="xsd:decimal">20</en>
<boy xsi:type="xsd:decimal">20</boy>
<yukseklik xsi:type="xsd:decimal">10</yukseklik>
<agirlik xsi:type="xsd:decimal">1.25</agirlik>
</dim>
</ebat>
<payType xsi:type="xsd:string">P</payType>
<gbeyanTutar xsi:type="xsd:string">57</gbeyanTutar>
<shipAccessCode xsi:type="xsd:string">?</shipAccessCode>
<ygarsivpdf xsi:type="xsd:string">?</ygarsivpdf>
<vatno xsi:type="xsd:string">VATNo</vatno>
<eorino xsi:type="xsd:string">EORINo</eorino>
<gumruktipi xsi:type="xsd:string">H</gumruktipi>
<ioss xsi:type="xsd:string">IM2332222225</ioss>
<musteriBeyanTuru xsi:type="xsd:string">M</musteriBeyanTuru>
<businessmodel xsi:type="xsd:integer">1</businessmodel>
<faturayetkili xsi:type="xsd:integer">TEST FATURA YETKİLİSİ</faturayetkili>
<faturaunvan xsi:type="xsd:string">TEST FATURA UNVAN</faturaunvan>
<faturatelefon xsi:type="xsd:string">12345678910</faturatelefon>
<faturaemail xsi:type="xsd:string">test@gmail.com</faturaemail>
<faturaadres xsi:type="xsd:string">1234 Main St.</faturaadres>
<faturaulkekodu xsi:type="xsd:string">US</faturaulkekodu>
<faturapostakodu xsi:type="xsd:string">99546</faturapostakodu>
<faturasehir xsi:type="xsd:string">ADAK</faturasehir>
</urn:addShipment>
</soapenv:Body>
</soapenv:Envelope>Gönderi Ekleme Veri Formatları
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(45) | kullanıcı adınız | Mandatory |
| Sifre | String(45) | şifreniz | Mandatory |
| siparisno | String(24) | Gönderinizin size ait barkodu olan tekil no | Mandatory |
| ptsno | Double(10,0) | 0 gönderebilirsiniz; gönderi numarasını oluşturup geri döndürür. Düzeltme yapılacaksa daha önceden alınmış PTS Numarsı gönderilemelidir. | Optional |
| servis | String(2) | ecoPTS ise “E” ekspres ise “X” | Mandatory |
| yetkili | String(30) | Alıcı yetkilisinin adı | Optional |
| sirketadi | String(35) | Alıcı şirketin adı; alıcı şahıssa şahıs adı | Mandatory |
| adres | String(70) | Alıcı adresi | Mandatory |
| sehir | String(35) | Alıcı şehri | Optional |
| eyalet | String(2) | Bazı ülkelerde geçerlidir | Optional |
| postakodu | String(10) | Alıcı posta kodu | Mandatory |
| ulkekodu | String(2) | ISO 3166-1 alpha-2 tanımlamasına göre | Mandatory |
| telefon | String(30) | Alıcı telefon bilgisi | Optional |
| String(50) | Alıcı eposta adresi | Optional | |
| toplamkg | Double(8,3) | Gönderinin kg cinsinden toplam ağırlığı | Optional |
| malcinsi | String(40) | Awb üzerinde görünecek olan mal tanımı | Mandatory |
| toplamadet | Double(6,0) | Koli adedi | Mandatory |
| toplamdeger | Double(15,2) | Malın toplam dağeri toplamdeger alanı Fatura objesinde bulunan kalemlerin değer toplamı ile eşit bir değer olmalıdır. Bu kalem toplamı (miktar*(birimfiyat-discount) şeklinde hesaplanır. | Mandatory |
| parabirimi | String(3) | Kullanılan para birimi | Mandatory |
| faturano | String(45) | Fatura numarası | |
| faturatarihi | Date (YYYY/MM/DD) | Fatura tarihi | |
| earsivpdf | String(250) | Pdf faturanın web adresi (tıklanınca açılacak) | |
| fatura | Array | Aşağıdaki sahalardan oluşan çok satırlı dizi | |
| aciklama | String(50) | Her bir kalem malın tanımı | Mandatory |
| miktar | Double(15,3) | İlgili satırda yer alan kalemim adedi | Mandatory |
| birim | String(6) | İlgili satırda yer alan kalem birimi (pcs,kg) | Mandatory |
| birimfiyat | Double(16,4) | İlgili satırda yer alan kalemin birim fiyatı | Mandatory |
| gtip | String(12) | Gümrük tarife istatistik pozisyon numarası | Optional |
| discount | Double(16,4) | Varsa ürün üzerindeki indirim tutarı(discount) | Optional |
| vatbase | Double(16,4) | KDV beyan tutarı(vatbase) | Optional |
| itemUrl | String(500) | Ürün linki(itemUrl) | Optional |
| sivv | Double(16,4) | Türkiye gümrüğüne bildirilen beyan tutarı(sivv) | Optional |
| mensei | String(2) | İmal edildiği Ülke(mensei) | Optional |
| etiket | String(1) | Öndeğer 0, üzeri değerler yetkiye tabii | Optional |
| gonderici_yetkilisi | String(30) | İsim ya da “Customer Service” yazılabilir | |
| Ebat | Array | Numune ve mikro ihracat gönderiler için | Optional |
| en | Double(3,0) | Gönderinin ebat bilgisi cm cinsinden | Optional |
| boy | Double(3,0) | Gönderinin ebat bilgisi cm cinsinden | Optional |
| yukselik | Double(3,0) | Gönderinin ebat bilgisi cm cinsinden | Optional |
| agirlik | Double(9,3) | Gönderinin ağırlık bilgisi kg cinsinden | Optional |
| payType | String(1) | Gönderinin ödeme türü | Optional |
| businessmodel | Integer(3) | Müşterinin satış türünü belirleme(online satış=2, online satış değil=1) | Optional |
| musteriBeyanTuru | String(1) | Micro ihracat için M, Numune için N, Döküman için D | Optional |
| faturayetkili | String(35) | Fatura yetkilisinin adı | optional |
| faturaunvan | String(35) | Faturadaki ünvan adı | optional |
| faturatelefon | String(50) | Faturadaki telefon | optional |
| faturaemail | String(50) | Faturadaki email | optional |
| faturaadres | String(35) | Faturadaki adres | optional |
| faturaulkekodu | String(2) | Faturadaki ülke kodu | optional |
| faturapostakodu | String(12) | Faturadaki posta kodu | optional |
| faturasehir | String(35) | Faturadaki sehir | optional |
| ygarsivpdf | String(250) | varış gümrüğe iletilecek commercial invoice pdf linki | optional |
| gumruktipi | String(1) | Incoterm Flag : DDP için D DAP(DDU) için H | Mandatory |
| typeOfGoods | String(10) | Mal cinsi | optional |
Yanıtın (Response) çıktısı
Sistemin oluşturduğu PTS gönderi no AWB(House AirWaybill No)
<SOAP-ENV:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:server">
<SOAP-ENV:Body>
<ns1:addshipmentResponse xmlns:ns1="urn:server""http://schemas.xmlsoap.org/soap/encoding/">
<return xsi:type="xsd:string">"success":true,
AWB=2280000984
</return>
</ns1:addshipmentResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>PDF:
Etiket oluşmuşsa, etikete ait dosya bağlantısı .
CROSS:
Doğrudan etiket basma özelliği ile ilişkili takip numarasıGönderi kaydedilmiş ancak
proforma satırı kaydedilememişse aşağıdaki biçimde bir yanıt gelir:
AWB=222xxxxxx
UYARI: Proforma satırı kaydedilemedi: mal cinsi 1.
Herşey başarılı ise no döner(AWB),
etiket 0 ise, geri dönen değer AWB=2232184911 şeklinde
döner.
etiket 0’dan büyük
ise;
AWB=22xxx|CROSS=|PDF=https://www.pts.net:5161/api/ptsawb/15XXXXX_22XXXX.pdf|
HATA: Servis türü tanımlı servislerin kullanımına izin verir!UYARI:mesajları bazen hata da içerebiliyor. Eğer gönderi no (AWB) oluşmamışsa ya da CROSS oluşmamışsa hata mesajı olarak yorumlanabilir
Durum Kodları HTTP Durum Kodları Web Servisler yapılan işlemlerle ilgili bilgi vermek için HTTP durum kodlarını kullanırlar. Kod Açıklama 200 İşlemin başarılı olduğu anlamına gelir. 404 Sayfanın bulunamadığı anlamına gelir. 500 İç sunucu hatası anlamına gelir. Kodlarınıza tekrar bir gözatmanız gerekir
Express Gönderi Oluşturma
Müşteri referansını veya PTS referansını geçebilirsiniz
Request (istek) parametreleri
Bu metot'da addshipment methodundan farklı olarak gönderici bilgilerini de iletebilirisiniz.
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | kullanıcı adınız | Mandatory |
| Sifre | String(25) | şifreniz | Mandatory |
| siparisno | String(40) | Gönderinizin size ait barkodu olan tekil no | Mandatory |
| ptsno | String(10) | 0 gönderebilirsiniz; gönderi numarasını oluşturup geri döndürür. Düzeltme yapılacaksa daha önceden alınmış PTS Numarsı gönderilemelidir. | Optional |
| yetkili | String(35) | Alıcı yetkilisinin adı | Optional |
| sirketadi | String(35) | Alıcı şirketin adı; alıcı şahıssa şahıs adı | Mandatory |
| adres | String(70) | Alıcı adresi | Mandatory |
| sehir | String(35) | Alıcı şehri | Mandatory |
| eyalet | String(2) | Bazı ülkelerde geçerlidir | Mandatory |
| postakodu | String(10) | Alıcı posta kodu | Mandatory |
| ulkekodu | String(2) | ISO 3166-1 alpha-2 tanımlamasına göre | Mandatory |
| telefon | String(40) | Alıcı telefon bilgisi | Optional |
| String(40) | Alıcı eposta adresi | Optional | |
| gonderici_yetkili | String(40) | Gönderen Yetkili kişi | Mandatory |
| gonderici_unvan | String(40) | Gönderen firma/kişi ünvan | Mandatory |
| gonderici_adres | String(40) | Gönderen Adres | Mandatory |
| gonderici_sehir | String(40) | Gönderen Şehri | Mandatory |
| gonderici_postakodu | String(10) | Gönderen posta kodu | Mandatory |
| gonderici_ulkekodu | String(40) | ISO 3166-1 alpha-2 tanımlamasına göre | Mandatory |
| gonderici_telefon | String(40) | Gönderen telefon | Mandatory |
| gonderici_email | String(40) | Gönderen eposta | Mandatory |
| toplamkg | Double(8,3) | Gönderinin kg cinsinden toplam ağırlığı | Optional |
| siparisno | String(40) | Gönderinizin size ait barkodu olan tekil no | Mandatory |
| malcinsi | String(40) | Awb üzerinde görünecek olan mal tanımı | Mandatory |
| toplamadet | Double(6,0) | Koli adedi | Mandatory |
| toplamdeger | Double(15,2) | Malın toplam dağeri. toplamdeger alanı Fatura objesinde bulunan kalemlerin değer toplamı ile eşit bir değer olmalıdır. Bu kalem toplamı (miktar*(birimfiyat-discount) şeklinde hesaplanır. | Mandatory |
| parabirimi | String(3) | Kullanılan para birimi | Mandatory |
| fatura | Array | Aşağıdaki sahalardan oluşan çok satırlı dizi | |
| aciklama | String(50) | Her bir kalem malın tanımı | Mandatory |
| miktar | Double(15,3) | İlgili satırda yer alan kalemim adedi | Mandatory |
| birim | String(6) | İlgili satırda yer alan kalem birimi (pcs,kg) | Mandatory |
| birimfiyat | Double(16,4) | İlgili satırda yer alan kalemin birim fiyatı | Mandatory |
| gtip | String(12) | Gümrük tarife istatistik pozisyon numarası | Optional |
| discount | Double(16,4) | Varsa ürün üzerindeki indirim tutarı(discount) | Optional |
| vatbase | Double(16,4) | KDV beyan tutarı(vatbase) | Optional |
| itemUrl | String(500) | Ürün linki(itemUrl) | Optional |
| sivv | Double(16,4) | Türkiye gümrüğüne bildirilen beyan tutarı(sivv) | Optional |
| mensei | String(2) | İmal edildiği Ülke(mensei) | Optional |
| faturano | String(45) | Fatura numarası | |
| faturatarihi | Date (YYYYMMDD) | Fatura tarihi | |
| earsivpdf | String(250) | Pdf faturanın web adresi (tıklanınca açılacak) | |
| Ebat | Array | Aşağıdaki sahalardan oluşan çok satırlı dizi | Optional |
| en | Double(4,1) | Gönderinin ebat bilgisi cm cinsinden | Optional |
| boy | Double(4,1) | Gönderinin ebat bilgisi cm cinsinden | Optional |
| yukselik | Double(4,1) | Gönderinin ebat bilgisi cm cinsinden | Optional |
| agirlik | Double(6,2) | Gönderinin ağırlık bilgisi kg cinsinden | Optional |
| payType | String(1) | Gönderinin ödeme türü | Optional |
| gbeyanTutar | String(10) | Gönderinin ödeme türü | Optional |
| shipAccessCode | String(1) | boş bırakılabilir | |
| ygarsivpdf | String(10) | varış gümrüğe iletilecek commercial invoice pdf linki | Mandatory |
| vatno | String(1) | boş bırakılabilir | |
| eorin | String(1) | boş bırakılabilir | |
| gumruktipi | String(10) | Incoterm Flag : DDP için D DAP(DDU) için H | Optional |
| ioss | String(10) | boş bırakılabilir | |
| businessmodel | Integer(10) | Müşterinin satış türü(online satış kontrolü) | Optional |
| musteriBeyanTuru | String(1) | Micro ihracat için M, Numune için N, Döküman için D | Optional |
| gonderici_vergi_no | String(40) | Gönderen Vergi numarası | Mandatory |
Yanıtın (Response) çıktısı
Sisteme gönderdiğiniz istek (request) sonunda PTS sistemi aşağıdaki yanıtları üretir:
<SOAP-ENV:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:server">
<SOAP-ENV:Body>
<ns1:addshipmentExpressResponse xmlns:ns1="urn:server""http://schemas.xmlsoap.org/soap/encoding/">
<return xsi:type="xsd:string">AWB=5580000080|UYARI=_awb5580000080
</return>
</ns1:addshipmentExpressResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>Joom Gönderi Oluşturma
Bu metot spesifik bir müşterinin kullanımı içindir. Başka müşterilerin kullanımına kapalıdır.
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv=
"http://schemas.xmlsoap.org/soap/envelope/"
xmlns:urn="urn:server">
<soapenv:Header/>
<soapenv:Body>
<urn:addShipmentVariantJoom soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<kullanici xsi:type="xsd:string">DEV-27541194384867335</kullanici>
<sifre xsi:type="xsd:string">bbd47bf0-8ff8-11ec-83f4-005056b8981b</sifre>
<ptsno xsi:type="xsd:string">0</ptsno>
<servis xsi:type="xsd:string">E</servis>
<yetkili xsi:type="xsd:string">TESTYETKİLİ</yetkili>
<sirketadi xsi:type="xsd:string">TEST ŞİRKET ADI</sirketadi>
<adres xsi:type="xsd:string">TEST ADRES</adres>
<sehir xsi:type="xsd:string">Rotterdam</sehir>
<eyalet xsi:type="xsd:string">?</eyalet>
<postakodu xsi:type="xsd:string">3034PJ</postakodu>
<ulkekodu xsi:type="xsd:string">NL</ulkekodu>
<telefon xsi:type="xsd:string">02123659874</telefon>
<email xsi:type="xsd:string">test@gmail.com</email>
<kimlik_kart_kod xsi:type="xsd:string">?</kimlik_kart_kod>
<kimlik_kart_seri xsi:type="xsd:string">?</kimlik_kart_seri>
<kimlik_kart_numara xsi:type="xsd:string">?</kimlik_kart_numara>
<kimlik_kart_tarih xsi:type="xsd:string">?</kimlik_kart_tarih>
<gonderici_yetkili xsi:type="xsd:string">TEST GÖNDERİCİ YETKİLİ</gonderici_yetkili>
<gonderici_unvan xsi:type="xsd:string">TEST GÖNDERİCİ UNVAN</gonderici_unvan>
<gonderici_adres xsi:type="xsd:string">TEST GÖNDERİCİ ADRES</gonderici_adres>
<gonderici_sehir xsi:type="xsd:string">İstanbul</gonderici_sehir>
<gonderici_postakodu xsi:type="xsd:string">34340</gonderici_postakodu>
<gonderici_ulkekodu xsi:type="xsd:string">TR</gonderici_ulkekodu>
<gonderici_telefon xsi:type="xsd:string">02123658741</gonderici_telefon>
<gonderici_email xsi:type="xsd:string">deneme@gmail.com</gonderici_email>
<gonderici_vergi_no xsi:type="xsd:string">458712</gonderici_vergi_no>
<toplamkg xsi:type="xsd:decimal">2</toplamkg>
<siparisno xsi:type="xsd:string">TESTORDER4</siparisno>
<malcinsi xsi:type="xsd:string">DRESS</malcinsi>
<toplamadet xsi:type="xsd:string">2</toplamadet>
<toplamdeger xsi:type="xsd:decimal">7</toplamdeger>
<parabirimi xsi:type="xsd:string">EUR</parabirimi>
<fatura xsi:type="SOAP-ENC:Array" SOAP-ENC:arrayType="urn:line[2]">
<item xsi:type="tns:line">
<aciklama xsi:type="xsd:string">LADIES SWEATA</aciklama>
<miktar xsi:type="xsd:decimal">55</miktar>
<birim xsi:type="xsd:string">pcs</birim>
<birimfiyat xsi:type="xsd:decimal">3</birimfiyat>
<gtip xsi:type="xsd:string">4242424233</gtip>
<discount xsi:type="xsd:decimal"></discount>
<vatbase xsi:type="xsd:decimal"></vatbase>
<itemUrl xsi:type="xsd:string">
https://media.istockphoto.com/photos/mens-white-blank-tshirt-templatefrom-two-sides-natural-shape-on-for-picture-id1151955708
</itemUrl>
<sivv xsi:type="xsd:decimal"></sivv>
<mensei xsi:type="xsd:string">TR</mensei>
</item>
<item xsi:type="tns:line">
<aciklama xsi:type="xsd:string">Thermo Clothes</aciklama>
<miktar xsi:type="xsd:decimal">2</miktar>
<birim xsi:type="xsd:string">PCS</birim>
<birimfiyat xsi:type="xsd:decimal">59.99</birimfiyat>
<gtip xsi:type="xsd:string">620213100019</gtip>
<discount xsi:type="xsd:decimal"></discount>
<vatbase xsi:type="xsd:decimal"></vatbase>
<itemUrl xsi:type="xsd:string">
https://media.istockphoto.com/photos/mens-white-blank-tshirt-templatefrom-two-sides-natural-shape-on-for-picture-id1151955708
</itemUrl>
<sivv xsi:type="xsd:decimal"></sivv>
<mensei xsi:type="xsd:string">TR</mensei>
</item>
</fatura>
<faturano xsi:type="xsd:string">458712</faturano>
<faturatarihi xsi:type="xsd:string">2022-08-10</faturatarihi>
<earsivpdf xsi:type="xsd:string">?</earsivpdf>
<etiket xsi:type="xsd:string">1</etiket>
<ebat xsi:type="urn:dims" SOAP-ENC:arrayType="urn:dim[2]">
<dim>
<en xsi:type="xsd:string">20</en>
<boy xsi:type="xsd:decimal">20</boy>
<yukseklik xsi:type="xsd:string">10</yukseklik>
<agirlik xsi:type="xsd:decimal">0.75</agirlik>
</dim>
<dim>
<en xsi:type="xsd:decimal">20</en>
<boy xsi:type="xsd:decimal">20</boy>
<yukseklik xsi:type="xsd:decimal">10</yukseklik>
<agirlik xsi:type="xsd:decimal">1.25</agirlik>
</dim>
</ebat>
<payType xsi:type="xsd:string">P</payType>
<gbeyanTutar xsi:type="xsd:string">57</gbeyanTutar>
<shipAccessCode xsi:type="xsd:string">?</shipAccessCode>
<gonderici_tckn xsi:type="xsd:string">12312541204</gonderici_tckn>
<business_model xsi:type="xsd:integer">1</business_model>
</urn:addShipmentVariantJoom>
</soapenv:Body>
</soapenv:Envelope>Request (istek) parametreleri
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | kullanıcı adınız | Mandatory |
| Sifre | String(25) | şifreniz | Mandatory |
| siparisno | String(40) | Gönderinizin size ait barkodu olan tekil no | Mandatory |
| ptsno | String(10) | 0 gönderebilirsiniz; gönderi numarasını oluşturup geri döndürür. Düzeltme yapılacaksa daha önceden alınmış PTS Numarsı gönderilemelidir. | Optional |
| servis | String(1) | ecoPTS ise “E” ekspres ise “X” | Mandatory |
| yetkili | String(35) | Alıcı yetkilisinin adı | Optional |
| sirketadi | String(35) | Alıcı şirketin adı; alıcı şahıssa şahıs adı | Mandatory |
| adres | String(70) | Alıcı adresi | Mandatory |
| sehir | String(35) | Alıcı şehri | Mandatory |
| eyalet | String(2) | Bazı ülkelerde geçerlidir | Mandatory |
| postakodu | String(10) | Alıcı posta kodu | Mandatory |
| ulkekodu | String(2) | ISO 3166-1 alpha-2 tanımlamasına göre | Mandatory |
| telefon | String(40) | Alıcı telefon bilgisi | Optional |
| String(40) | Alıcı eposta adresi | Optional | |
| Kimlik_kart_kod | String(4) | Alıcı pasaport kod bilgisi. | Optional |
| Kimlik_kart_seri | String(8) | Alıcı pasaport seri bilgisi | Optional |
| Kimlik_kart_numara | String(32) | Alıcı pasaport seri numara bilgisi | Optional |
| Kimlik_kart_tarih | String(10) | Alıcı pasaport veriliş tarihi | Mandatory |
| gonderici_yetkili | String(40) | Gönderen Yetkili kişi | Mandatory |
| gonderici_unvan | String(40) | Gönderen firma/kişi ünvan | Mandatory |
| gonderici_adres | String(40) | Gönderen Adres | Mandatory |
| gonderici_sehir | String(40) | Gönderen Şehri | Mandatory |
| gonderici_postakodu | String(40) | Gönderen posta kodu | Mandatory |
| gonderici_ulkekodu | String(40) | ISO 3166-1 alpha-2 tanımlamasına göre | Mandatory |
| gonderici_telefon | String(40) | Gönderen telefon | Mandatory |
| gonderici_email | String(40) | Gönderen eposta | Mandatory |
| gonderici_vergi_no | String(40) | Gönderen Vergi numarası | Mandatory |
| toplamkg | Double(8,3) | Gönderinin kg cinsinden toplam ağırlığı | Optional |
| siparisno | String(40) | Gönderinizin size ait barkodu olan tekil no | Mandatory |
| malcinsi | String(40) | Awb üzerinde görünecek olan mal tanımı | Mandatory |
| toplamadet | Double(6,0) | Koli adedi | Mandatory |
| toplamdeger | Double(15,2) | Malın toplam dağeri. toplamdeger alanı Fatura objesinde bulunan kalemlerin değer toplamı ile eşit bir değer olmalıdır. Bu kalem toplamı (miktar*(birimfiyat-discount) şeklinde hesaplanır. | Mandatory |
| parabirimi | String(3) | Kullanılan para birimi | Mandatory |
| fatura | Array | Aşağıdaki sahalardan oluşan çok satırlı dizi | |
| aciklama | String(50) | Her bir kalem malın tanımı | Mandatory |
| miktar | Double(15,3) | İlgili satırda yer alan kalemim adedi | Mandatory |
| birim | String(6) | İlgili satırda yer alan kalem birimi (pcs,kg) | Mandatory |
| birimfiyat | Double(16,4) | İlgili satırda yer alan kalemin birim fiyatı | Mandatory |
| gtip | String(12) | Gümrük tarife istatistik pozisyon numarası | Optional |
| discount | Double(16,4) | Varsa ürün üzerindeki indirim tutarı(discount) | Optional |
| vatbase | Double(16,4) | KDV beyan tutarı(vatbase) | Optional |
| itemUrl | String(500) | Ürün linki(itemUrl) | Optional |
| sivv | Double(16,4) | Türkiye gümrüğüne bildirilen beyan tutarı(sivv) | Optional |
| mensei | String(2) | İmal edildiği Ülke(mensei) | Optional |
| faturano | String(45) | Fatura numarası | |
| faturatarihi | Date (YYYYMMDD) | Fatura tarihi | |
| earsivpdf | String(250) | Pdf faturanın web adresi (tıklanınca açılacak) | |
| etiket | String() | Öndeğer 0, üzeri değerler yetkiye tabii | Optional |
| Ebat | Array | Aşağıdaki sahalardan oluşan çok satırlı dizi | Optional |
| en | Double(4,1) | Gönderinin ebat bilgisi cm cinsinden | Optional |
| boy | Double(4,1) | Gönderinin ebat bilgisi cm cinsinden | Optional |
| yukselik | Double(4,1) | Gönderinin ebat bilgisi cm cinsinden | Optional |
| agirlik | Double(6,2) | Gönderinin ağırlık bilgisi kg cinsinden | Optional |
| payType | String(1) | Gönderinin ödeme türü | Optional |
| gbeyanTutar | String(10) | Gönderinin ödeme türü | Optional |
| shipAccessCode | String(1) | boş bırakılabilir | |
| gonderici_tckn | String(10) | gönderenin tckn si | Mandatory |
| business_model | Integer(1) | Müşterinin satış türü(online satış kontrolü) | Optional |
Yanıtın (Response) çıktısı
AWB=222xxxxxx
etiket 0 ise, geri dönen değer AWB=2232184911 şeklinde döner. etiket 0’dan büyük ise;
AWB=22400XXXX|CROSS=0150514XXXXX|PDF=https://www.pts.net/WEB/DPDPDFV4/22XXX_160XXX.pdf
şeklinde içinde etiketin indirilebileceği URL bulunan bir alfasayısal bilgi dönüyor.Herşey normalse, gönderi no döner, işlem başarılı demektir:
AWB Sistemin oluşturduğu PTS gönderi no.
HATA mesajları konusunda, etiketi basılacak taşıyıcının sisteminden gelen mesajları, original
dilinde ve doğrudan iletiyoruz.
UYARI mesajları bazen hata da içerebiliyor. Eğer gönderi no (AWB) oluşmamışsa ya da CROSS
oluşmamışsa hata mesajı olarak yorumlanabilir.
PDF Etiket oluşmuşsa, etikete ait dosya bağlantısı .
CROSS Doğrudan etiket basma özelliği ile ilişkili takip numarası
Servis Türü İle Gönderi Ekleme
Request (istek) parametreleri
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv=
"http://schemas.xmlsoap.org/soap/envelope/"
xmlns:urn="urn:server">
<soapenv:Header/>
<soapenv:Body>
<urn:addshipmentwithservicetype soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<kullanici xsi:type="xsd:string">DEV-27541194384867335</kullanici>
<sifre xsi:type="xsd:string">bbd47bf0-8ff8-11ec-83f4-005056b8981b</sifre>
<ptsno xsi:type="xsd:string">0</ptsno>
<servis xsi:type="xsd:string">E</servis>
<yetkili xsi:type="xsd:string">TESTYETKİLİ</yetkili>
<sirketadi xsi:type="xsd:string">TEST ŞİRKET ADI</sirketadi>
<adres xsi:type="xsd:string">TEST ADRES</adres>
<sehir xsi:type="xsd:string">Rotterdam</sehir>
<eyalet xsi:type="xsd:string">?</eyalet>
<postakodu xsi:type="xsd:string">3034PJ</postakodu>
<ulkekodu xsi:type="xsd:string">NL</ulkekodu>
<telefon xsi:type="xsd:string">02123659874</telefon>
<email xsi:type="xsd:string">test@gmail.com</email>
<toplamkg xsi:type="xsd:decimal">2</toplamkg>
<siparisno xsi:type="xsd:string">TESTORDER4</siparisno>
<malcinsi xsi:type="xsd:string">DRESS</malcinsi>
<toplamadet xsi:type="xsd:string">2</toplamadet>
<toplamdeger xsi:type="xsd:decimal">7</toplamdeger>
<parabirimi xsi:type="xsd:string">EUR</parabirimi>
<fatura xsi:type="SOAP-ENC:Array" SOAP-ENC:arrayType="urn:line[2]">
<item xsi:type="tns:line">
<aciklama xsi:type="xsd:string">LADIES SWEATA</aciklama>
<miktar xsi:type="xsd:decimal">55</miktar>
<birim xsi:type="xsd:string">pcs</birim>
<birimfiyat xsi:type="xsd:decimal">3</birimfiyat>
<gtip xsi:type="xsd:string">4242424233</gtip>
<discount xsi:type="xsd:decimal"></discount>
<vatbase xsi:type="xsd:decimal"></vatbase>
<itemUrl xsi:type="xsd:string">
https://media.istockphoto.com/photos/mens-white-blank-tshirt-templatefrom-two-sides-natural-shape-on-for-picture-id1151955708
</itemUrl>
<sivv xsi:type="xsd:decimal"></sivv>
<mensei xsi:type="xsd:string">TR</mensei>
</item>
<item xsi:type="tns:line">
<aciklama xsi:type="xsd:string">Thermo Clothes</aciklama>
<miktar xsi:type="xsd:decimal">2</miktar>
<birim xsi:type="xsd:string">PCS</birim>
<birimfiyat xsi:type="xsd:decimal">59.99</birimfiyat>
<gtip xsi:type="xsd:string">620213100019</gtip>
<discount xsi:type="xsd:decimal"></discount>
<vatbase xsi:type="xsd:decimal"></vatbase>
<itemUrl xsi:type="xsd:string">https://media.istockphoto.com/photos/mens-white-blank-tshirt-templatefrom-two-sides-natural-shape-on-for-picture-id1151955708
</itemUrl>
<sivv xsi:type="xsd:decimal"></sivv>
<mensei xsi:type="xsd:string">TR</mensei>
<urunkodu xsi:type="xsd:string">TESTKOD-1234</urunkodu>
<urunbarkodu xsi:type="xsd:string">DUMMY-BARCODE123</urunbarkodu>
</item>
</fatura>
<faturano xsi:type="xsd:string">458712</faturano>
<faturatarihi xsi:type="xsd:string">2022-08-10</faturatarihi>
<earsivpdf xsi:type="xsd:string">?</earsivpdf>
<etiket xsi:type="xsd:string">1</etiket>
<gonderici_yetkili xsi:type="xsd:string">TEST GÖNDERİCİ YETKİLİ</gonderici_yetkili>
<gonderici_unvan xsi:type="xsd:string">TEST GÖNDERİCİ UNVAN</gonderici_unvan>
<gonderici_adres xsi:type="xsd:string">TEST GÖNDERİCİ ADRES</gonderici_adres>
<gonderici_sehir xsi:type="xsd:string">İstanbul</gonderici_sehir>
<gonderici_postakodu xsi:type="xsd:string">34340</gonderici_postakodu>
<gonderici_ulkekodu xsi:type="xsd:string">TR</gonderici_ulkekodu>
<gonderici_telefon xsi:type="xsd:string">02123658741</gonderici_telefon>
<gonderici_email xsi:type="xsd:string">deneme@gmail.com</gonderici_email>
<ebat xsi:type="urn:dims" SOAP-ENC:arrayType="urn:dim[2]">
<dim>
<en xsi:type="xsd:string">20</en>
<boy xsi:type="xsd:decimal">20</boy>
<yukseklik xsi:type="xsd:string">10</yukseklik>
<agirlik xsi:type="xsd:decimal">0.75</agirlik>
</dim>
<dim>
<en xsi:type="xsd:decimal">20</en>
<boy xsi:type="xsd:decimal">20</boy>
<yukseklik xsi:type="xsd:decimal">10</yukseklik>
<agirlik xsi:type="xsd:decimal">1.25</agirlik>
</dim>
</ebat>
<payType xsi:type="xsd:string">P</payType>
<gbeyanTutar xsi:type="xsd:string">57</gbeyanTutar>
<ygarsivpdf xsi:type="xsd:string">?</ygarsivpdf>
<vatno xsi:type="xsd:string">VATNo</vatno>
<eorino xsi:type="xsd:string">EORINo</eorino>
<gumruktipi xsi:type="xsd:string">H</gumruktipi>
<ioss xsi:type="xsd:string">IM2332222225</ioss>
<musteriBeyanTuru xsi:type="xsd:string">M</musteriBeyanTuru>
<businessmodel xsi:type="xsd:integer">1</businessmodel>
<faturayetkili xsi:type="xsd:integer">TEST FATURA YETKİLİSİ</faturayetkili>
<faturaunvan xsi:type="xsd:string">TEST FATURA UNVAN</faturaunvan>
<faturatelefon xsi:type="xsd:string">12345678910</faturatelefon>
<faturaemail xsi:type="xsd:string">test@gmail.com</faturaemail>
<faturaadres xsi:type="xsd:string">1234 Main St.</faturaadres>
<faturaulkekodu xsi:type="xsd:string">US</faturaulkekodu>
<faturapostakodu xsi:type="xsd:string">99546</faturapostakodu>
<faturasehir xsi:type="xsd:string">ADAK</faturasehir>
<gonderici_vergi_no xsi:type="xsd:string">458712</gonderici_vergi_no>
</urn:addshipmentwithservicetype>
</soapenv:Body>
</soapenv:Envelope>Servis Türü İle Gönderi Ekleme Veri Formatları
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | API Kullanıcı Adı | Mandatory |
| Sifre | String(25) | API kullanıcı şifreniz | Mandatory |
| siparisno | String(40) | Gönderinizin size ait barkodu olan tekil no | Mandatory |
| ptsno | String(10) | 0 gönderebilirsiniz; gönderi numarasını oluşturup geri döndürür. Düzeltme yapılacaksa daha önceden alınmış PTS Numarsı gönderilemelidir. | Optional |
| servis | String(1) | ecoPTS ise “E” ekspres ise “X” | Mandatory |
| yetkili | String(35) | Alıcı yetkilisinin adı | Optional |
| sirketadi | String(35) | Alıcı şirketin adı; alıcı şahıssa şahıs adı | Mandatory |
| adres | String(70) | Alıcı adresi | Mandatory |
| sehir | String(35) | Alıcı şehri | Mandatory |
| eyalet | String(2) | Bazı ülkelerde geçerlidir | Mandatory |
| postakodu | String(10) | Alıcı posta kodu | Mandatory |
| ulkekodu | String(2) | ISO 3166-1 alpha-2 tanımlamasına göre | Mandatory |
| telefon | String(40) | Alıcı telefon bilgisi | Optional |
| String(40) | Alıcı eposta adresi | Optional | |
| toplamkg | Double(8,3) | Gönderinin kg cinsinden toplam ağırlığı | Optional |
| malcinsi | String(40) | Awb üzerinde görünecek olan mal tanımı | Mandatory |
| toplamadet | Double(6,0) | Koli adedi | Mandatory |
| toplamdeger | Double(15,2) | Malın toplam dağeri. toplamdeger alanı Fatura objesinde bulunan kalemlerin değer toplamı ile eşit bir değer olmalıdır. Bu kalem toplamı (miktar*(birimfiyat-discount) şeklinde hesaplanır. | Mandatory |
| parabirimi | String(3) | Kullanılan para birimi | Mandatory |
| faturano | String(45) | Fatura numarası | |
| faturatarihi | Date (YYYYMMDD) | Fatura tarihi | |
| earsivpdf | String(250) | Pdf faturanın web adresi (tıklanınca açılacak) | |
| fatura | Array | Aşağıdaki sahalardan oluşan çok satırlı dizi | |
| aciklama | String(50) | Her bir kalem malın tanımı | Mandatory |
| miktar | Double(15,3) | İlgili satırda yer alan kalemim adedi | Mandatory |
| birim | String(6) | İlgili satırda yer alan kalem birimi (pcs,kg) | Mandatory |
| birimfiyat | Double(16,4) | İlgili satırda yer alan kalemin birim fiyatı | Mandatory |
| gtip | String(12) | Gümrük tarife istatistik pozisyon numarası | Optional |
| discount | Double(16,4) | Varsa ürün üzerindeki indirim tutarı(discount) | Optional |
| vatbase | Double(16,4) | KDV beyan tutarı(vatbase) | Optional |
| itemUrl | String(500) | Ürün linki(itemUrl) | Optional |
| sivv | Double(16,4) | Türkiye gümrüğüne bildirilen beyan tutarı(sivv) | Optional |
| mensei | String(2) | İmal edildiği Ülke(mensei) | Optional |
| urunkodu | String(100) | Ürün Kodu(urunkodu) | Optional |
| urunbarkodu | String(100) | Ürün barkodu(urunbarkodu) | Optional |
| etiket | String(1) | Öndeğer 0, üzeri değerler yetkiye tabii | Optional |
| gonderici_yetkili | String(30) | Gönderici Yetkili İsmi | |
| gonderici_unvan | String(30) | Gönderici Unvanı | |
| gonderici_adres | String(30) | Gönderici Adresi | |
| gonderici_sehir | String(30) | Gönderici Şehri | |
| gonderici_postakodu | String(30) | Gönderici Posta Kodu | |
| gonderici_ulkekodu | String(30) | Gönderici Ülke Kodu | |
| gonderici_telefon | String(30) | Gönderici Telefonu | |
| gonderici_email | String(30) | Gönderici Maili | |
| Ebat | Array | Aşağıdaki sahalardan oluşan çok satırlı dizi | Optional |
| en | Double(4,1) | Gönderinin ebat bilgisi cm cinsinden | Optional |
| boy | Double(4,1) | Gönderinin ebat bilgisi cm cinsinden | Optional |
| yukselik | Double(4,1) | Gönderinin ebat bilgisi cm cinsinden | Optional |
| agirlik | Double(6,2) | Gönderinin ağırlık bilgisi kg cinsinden | Optional |
| payType | String(1) | Gönderinin ödeme türü | Optional |
| gbeyanTutar | String(20) | Gümrük Beyan tutarı | Optional |
| ygarsivpdf | String(10) | varış gümrüğe iletilecek commercial invoice pdf linki | Mandatory |
| vatno | String(10) | vatno | Mandatory |
| eorino | String(10) | eorino | Mandatory |
| gumruktipi | String(10) | Incoterm Flag : DDP için D DAP(DDU) için H | Optional |
| ioss | String(10) | IOSS vergi kimlik numarası | Mandatory |
| businessmodel | Integer(10) | Müşterinin satış türünü belirleme(online satış=2, online satış değil=1) | Optional |
| musteriBeyanTuru | String(1) | Micro ihracat için M, Numune için N, Döküman için D | Optional |
| faturayetkili | String(10) | Fatura yetkilisinin adı | optional |
| faturaunvan | String(10) | Faturadaki ünvan adı | optional |
| faturatelefon | String(10) | Faturadaki telefon | optional |
| faturaemail | String(10) | Faturadaki email | optional |
| faturaadres | String(50) | Faturadaki adres | optional |
| faturaulkekodu | String(10) | Faturadaki ülke kodu | optional |
| faturapostakodu | String(10) | Faturadaki posta kodu | optional |
| faturasehir | String(10) | Faturadaki sehir | optional |
| gonderici_vergi_no | String(40) | Gönderen Vergi numarası | optional |
| shipAccessCode | String(1) | boş bırakılabilir | optional |
| labelType | PDF,ZPL,pdf,zpl | labelType parametresi PDF veya ZPL olmalıdır. | Optional |
| gonderici_tckn | String(10) | gönderenin tckn si | optional |
| typeOfGoods | String(10) | Mal cinsi | Optional |
Yanıtın (Response) çıktısı
Sisteme gönderdiğiniz istek (request) sonunda PTS sistemi aşağıdaki yanıtları üretir:
<SOAP-ENV:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:urn="urn:server">
<SOAP-ENV:Body>
<ns1:addshipmentwithservicetypeResponse xmlns:ns1="urn:server""http://schemas.xmlsoap.org/soap/encoding/">
<return xsi:type="xsd:string">"success":true,
AWB=2280062997|CROSS=2280062997|PDF=https:\/\/www.pts.net\/WEB\/connects\/fastdespatch\/fastdPDF\/2280062997_1942319266.pdf|UYARI=Sonuc
</return>
</ns1:addshipmentwithservicetypeResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>PDF:
Etiket oluşmuşsa, etikete ait dosya bağlantısı .
CROSS:
Doğrudan etiket basma özelliği ile ilişkili takip numarasıGönderi kaydedilmiş ancak
proforma satırı
kaydedilememişse aşağıdaki biçimde bir yanıt gelir:
AWB=222xxxxxx
UYARI: Proforma satırı kaydedilemedi: mal cinsi 1.
Herşey başarılı ise no döner(AWB),
etiket 0 ise, geri dönen değer AWB=2232184911 şeklinde
döner.
etiket
0’dan büyük ise;
AWB=22xxx|CROSS=|PDF=https://www.pts.net:5161/api/ptsawb/15XXXXX_22XXXX.pdf|
HATA: Servis türü tanımlı servislerin kullanımına izin verir!UYARI:mesajları bazen hata da içerebiliyor. Eğer gönderi no (AWB) oluşmamışsa ya da CROSS oluşmamışsa hata mesajı olarak yorumlanabilir
Pick-Up(Çağrı) İle Gönderi Oluşturma
Bu metot gönderi oluşturma ile birlikte Pick-Up(Çağrı) oluşturma yapabilmektedir. Marketplace Müşterilerimizin, satıcılarına kurye ile firmalarından gönderi teslimatı yaptırabileceği bir hizmettir.
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv=
"http://schemas.xmlsoap.org/soap/envelope/"
xmlns:urn="urn:server">
<soapenv:Header/>
<soapenv:Body>
<urn:addShipmentWithPickUp soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<kullanici xsi:type="xsd:string">DEV-27541194384867335</kullanici>
<sifre xsi:type="xsd:string">bbd47bf0-8ff8-11ec-83f4-005056b8981b</sifre>
<pickupTarih xsi:type="xsd:string">2023-01-01</pickupTarih>
<ptsno xsi:type="xsd:string">0</ptsno>
<servis xsi:type="xsd:string">E</servis>
<yetkili xsi:type="xsd:string">TESTYETKİLİ</yetkili>
<sirketadi xsi:type="xsd:string">TEST ŞİRKET ADI</sirketadi>
<adres xsi:type="xsd:string">TEST ADRES</adres>
<sehir xsi:type="xsd:string">Rotterdam</sehir>
<eyalet xsi:type="xsd:string">?</eyalet>
<postakodu xsi:type="xsd:string">3034PJ</postakodu>
<ulkekodu xsi:type="xsd:string">NL</ulkekodu>
<telefon xsi:type="xsd:string">02123659874</telefon>
<email xsi:type="xsd:string">test@gmail.com</email>
<gonderici_yetkili xsi:type="xsd:string">TEST GÖNDERİCİ YETKİLİ</gonderici_yetkili>
<gonderici_unvan xsi:type="xsd:string">TEST GÖNDERİCİ UNVAN</gonderici_unvan>
<gonderici_adres xsi:type="xsd:string">TEST GÖNDERİCİ ADRES</gonderici_adres>
<gonderici_sehir xsi:type="xsd:string">İstanbul</gonderici_sehir>
<gonderici_postakodu xsi:type="xsd:string">34340</gonderici_postakodu>
<gonderici_ulkekodu xsi:type="xsd:string">TR</gonderici_ulkekodu>
<gonderici_telefon xsi:type="xsd:string">02123658741</gonderici_telefon>
<gonderici_email xsi:type="xsd:string">deneme@gmail.com</gonderici_email>
<toplamkg xsi:type="xsd:decimal">2</toplamkg>
<siparisno xsi:type="xsd:string">TESTORDER4</siparisno>
<malcinsi xsi:type="xsd:string">DRESS</malcinsi>
<toplamadet xsi:type="xsd:string">2</toplamadet>
<toplamdeger xsi:type="xsd:decimal">7</toplamdeger>
<parabirimi xsi:type="xsd:string">EUR</parabirimi>
<fatura xsi:type="SOAP-ENC:Array" SOAP-ENC:arrayType="urn:line[2]">
<item xsi:type="tns:line">
<aciklama xsi:type="xsd:string">LADIES SWEATA</aciklama>
<miktar xsi:type="xsd:decimal">55</miktar>
<birim xsi:type="xsd:string">pcs</birim>
<birimfiyat xsi:type="xsd:decimal">3</birimfiyat>
<gtip xsi:type="xsd:string">4242424233</gtip>
<discount xsi:type="xsd:decimal"></discount>
<vatbase xsi:type="xsd:decimal"></vatbase>
<itemUrl xsi:type="xsd:string">
https://media.istockphoto.com/photos/mens-white-blank-tshirt-templatefrom-two-sides-natural-shape-on-for-picture-id1151955708
</itemUrl>
<sivv xsi:type="xsd:decimal"></sivv>
<mensei xsi:type="xsd:string">TR</mensei>
</item>
<item xsi:type="tns:line">
<aciklama xsi:type="xsd:string">Thermo Clothes</aciklama>
<miktar xsi:type="xsd:decimal">2</miktar>
<birim xsi:type="xsd:string">PCS</birim>
<birimfiyat xsi:type="xsd:decimal">59.99</birimfiyat>
<gtip xsi:type="xsd:string">620213100019</gtip>
<discount xsi:type="xsd:decimal"></discount>
<vatbase xsi:type="xsd:decimal"></vatbase>
<itemUrl xsi:type="xsd:string">https://media.istockphoto.com/photos/mens-white-blank-tshirt-templatefrom-two-sides-natural-shape-on-for-picture-id1151955708
</itemUrl>
<sivv xsi:type="xsd:decimal"></sivv>
<mensei xsi:type="xsd:string">TR</mensei>
</item>
</fatura>
<faturano xsi:type="xsd:string">458712</faturano>
<faturatarihi xsi:type="xsd:string">2022-08-10</faturatarihi>
<earsivpdf xsi:type="xsd:string">?</earsivpdf>
<ebat xsi:type="urn:dims"SOAP-ENC:arrayType="urn:dim[2]">
<dim>
<en xsi:type="xsd:string">20</en>
<boy xsi:type="xsd:decimal">20</boy>
<yukseklik xsi:type="xsd:string">10</yukseklik>
<agirlik xsi:type="xsd:decimal">0.75</agirlik>
</dim>
<dim>
<en xsi:type="xsd:decimal">20</en>
<boy xsi:type="xsd:decimal">20</boy>
<yukseklik xsi:type="xsd:decimal">10</yukseklik>
<agirlik xsi:type="xsd:decimal">1.25</agirlik>
</dim>
</ebat>
<payType xsi:type="xsd:string">P</payType>
<gbeyanTutar xsi:type="xsd:string">57</gbeyanTutar>
<vatno xsi:type="xsd:string">VATNo</vatno>
<eorino xsi:type="xsd:string">EORINo</eorino>
<gumruktipi xsi:type="xsd:string">H</gumruktipi>
<ioss xsi:type="xsd:string">IM2332222225</ioss>
<musteriBeyanTuru xsi:type="xsd:string">M</musteriBeyanTuru>
<business_model xsi:type="xsd:string">1</business_model>
<gonderici_vergi_no xsi:type="xsd:string">458712</gonderici_vergi_no>
</urn:addShipmentWithPickUp>
</soapenv:Body>
</soapenv:Envelope>Request (istek) parametreleri
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | kullanıcı adınız | Mandatory |
| Sifre | String(25) | şifreniz | Mandatory |
| siparisno | String(40) | Gönderinizin size ait barkodu olan tekil no | Mandatory |
| pickupTarih | String(10)(YYYY-mm-dd) | YYYY-mm-dd formatted desired Pickup date | Mandatory |
| ptsno | String(10) | 0 gönderebilirsiniz; gönderi numarasını oluşturup geri döndürür. Düzeltme yapılacaksa daha önceden alınmış PTS Numarsı gönderilemelidir. | Optional |
| servis | String(1) | ecoPTS ise “E” ekspres ise “X” | Mandatory |
| yetkili | String(35) | Alıcı yetkilisinin adı | Optional |
| sirketadi | String(35) | Alıcı şirketin adı; alıcı şahıssa şahıs adı | Mandatory |
| adres | String(70) | Alıcı adresi | Mandatory |
| sehir | String(35) | Alıcı şehri | Mandatory |
| eyalet | String(2) | Bazı ülkelerde geçerlidir | Mandatory |
| postakodu | String(10) | Alıcı posta kodu | Mandatory |
| ulkekodu | String(2) | ISO 3166-1 alpha-2 tanımlamasına göre | Mandatory |
| telefon | String(40) | Alıcı telefon bilgisi | Optional |
| String(40) | Alıcı eposta adresi | Optional | |
| gonderici_yetkili | String(40) | Gönderen Yetkili kişi | Mandatory |
| gonderici_unvan | String(40) | Gönderen firma/kişi ünvan | Mandatory |
| gonderici_adres | String(40) | Gönderen Adres | Mandatory |
| gonderici_sehir | String(40) | Gönderen Şehri | Mandatory |
| gonderici_postakodu | String(40) | Gönderen posta kodu | Mandatory |
| gonderici_ulkekodu | String(40) | ISO 3166-1 alpha-2 tanımlamasına göre | Mandatory |
| gonderici_telefon | String(40) | Gönderen telefon | Mandatory |
| gonderici_email | String(40) | Gönderen eposta | Mandatory |
| toplamkg | Double(8,3) | Gönderinin kg cinsinden toplam ağırlığı | Optional |
| malcinsi | String(40) | Awb üzerinde görünecek olan mal tanımı | Mandatory |
| toplamadet | Double(6,0) | Koli adedi | Mandatory |
| toplamdeger | Double(15,2)) | Malın toplam dağeri. toplamdeger alanı Fatura objesinde bulunan kalemlerin değer toplamı ile eşit bir değer olmalıdır. Bu kalem toplamı (miktar*(birimfiyat-discount) şeklinde hesaplanır. | Mandatory |
| parabirimi | String(3) | Kullanılan para birimi | Mandatory |
| faturano | String(45) | Fatura numarası | |
| faturatarihi | Date(YYYYMMDD) | Fatura tarihi | |
| earsivpdf | String(250) | Pdf faturanın web adresi (tıklanınca açılacak) | |
| fatura | Array | Aşağıdaki sahalardan oluşan çok satırlı dizi | |
| aciklama | String(50) | Her bir kalem malın tanımı | Mandatory |
| miktar | Double(15,3) | İlgili satırda yer alan kalemim adedi | Mandatory |
| birim | String(6) | İlgili satırda yer alan kalem birimi (pcs,kg) | Mandatory |
| birimfiyat | Double(16,4) | İlgili satırda yer alan kalemin birim fiyatı | Mandatory |
| gtip | String(12) | Gümrük tarife istatistik pozisyon numarası | Optional |
| discount | Double(16,4) | Varsa ürün üzerindeki indirim tutarı(discount) | Optional |
| vatbase | Double(16,4) | KDV beyan tutarı(vatbase) | Optional |
| itemUrl | String(500) | Ürün linki(itemUrl) | Optional |
| sivv | Double(16,4) | Türkiye gümrüğüne bildirilen beyan tutarı(sivv) | Optional |
| mensei | String(2) | İmal edildiği Ülke(mensei) | Optional |
| Ebat | Array | Aşağıdaki sahalardan oluşan çok satırlı dizi | Optional |
| en | Double(4,1) | Gönderinin ebat bilgisi cm cinsinden | Optional |
| boy | Double(4,1) | Gönderinin ebat bilgisi cm cinsinden | Optional |
| yukselik | Double(4,1) | Gönderinin ebat bilgisi cm cinsinden | Optional |
| agirlik | Double(6,2) | Gönderinin ağırlık bilgisi kg cinsinden | Optional |
| payType | String(1) | Gönderinin ödeme türü | Optional |
| gbeyanTutar | String(10) | Gönderinin ödeme türü | Optional |
| shipAccessCode | String(1) | boş bırakılabilir | |
| vatno | String(1) | boş bırakılabilir | |
| eorin | String(1) | boş bırakılabilir | |
| gumruktipi | String(10) | Incoterm Flag : DDP için D DAP(DDU) için H | Optional |
| ioss | String(10) | boş bırakılabilir | |
| musteriBeyanTuru | String(1) | Micro ihracat için M, Numune için N, Döküman için D | Optional |
| business_model | String(1) | Müşterinin satış türü(online satış kontrolü) | Optional |
| gonderici_vergi_no | String(40) | Gönderen Vergi numarası | Mandatory |
Yanıtın (Response) çıktısı
<SOAP-ENV:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:urn="urn:server">
<SOAP-ENV:Body>
<ns1:addShipmentWithPickUpResponse xmlns:ns1="urn:server""http://schemas.xmlsoap.org/soap/encoding/">
<return xsi:type="xsd:string">"success":true,
AWB=2280000211
</return>
</ns1:addShipmentWithPickUpResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Sisteme gönderdiğiniz talep (request) sonunda PTS sistemi aşağıdaki yanıtları üretir:
1)Herşey normalse, gönderi no döner, işlem başarılı demektir:
AWB=222xxxxxx
AWB Sistemin oluşturduğu PTS gönderi no.
HATA mesajları konusunda, etiketi basılacak taşıyıcının sisteminden gelen mesajları, original
dilinde ve doğrudan iletiyoruz.
UYARI mesajları bazen hata da içerebiliyor. Eğer gönderi no (AWB) oluşmamışsa ya da CROSS
oluşmamışsa hata mesajı olarak yorumlanabilir.
2) Gönderi kaydedilmişancak proforma satırı kaydedilememişse aşağıdaki biçimde
bir yanıt gelir:
AWB=222xxxxxx
UYARI: Proforma satırı kaydedilemedi: mal cinsi 1
3) Gönderinin kaydedilemediği, HATA içeren mesajlar aşağıdadır:
HATA: Kullanıcı bilgileriniz yanlış. //Username or password is incorrect
HATA: Hesabınız kısıtlanmıştır. Lütfen çağrı merkezimizi arayınız. Tel: xxx x xxx // Your
account is blocked, please call our Customer Service
HATA: Toplama tarih formatı hatalı //Pickup date format is incorrect
HATA: Toplama tarihi geçmiş tarih seçilemez. // Pickup date can not be past than today
HATA: Toplama tarihi d-m-Y tarihini geçmemelidir. //Pick up date should not be greater than
within week
HATA: Toplama tarihi d-m-Y Pazar gününe gelmektedir. //Selected Pickup date is Sunday. PTS do
not collect on Sundays.
HATA: 222xxxxxx nolu gönderide değişiklik yapamazsınız! //Changes are not allowed
HATA: Bu sipariş no daha önce kullanılmış: xxxsiparisnoxxx //Order number Previously used
HATA: Yetkili ya da şirket unvanı dolu olmalıdır!// Authority or company title must be full
HATA: Ülke kodu bulunamadı: UK //Country code is wrong
HATA: Adres bilgisi boş! //Address is empty
HATA: Posta kodu geçerli değil! //Postal Code is not allowed
HATA: Servis türü ecoPTS için E, Express için X olmalıdır! //Service type is wrong
HATA: Gönderi kaydedilemedi! //Shipment could not saved
HATA: Fatura satiri kaydedilemedi! //Invoice could not saved
TOPLU GONDERİ TAKİP
Toplu olarak Gönderi numarasıyla veya Sipariş numarasıyla gönderi takip bilgilerini toplu alma
Request (istek) parametreleri
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | kullanıcı adınız | Mandatory |
| Sifre | String(25) | şifreniz | Mandatory |
| ptsnolist | Array | PTS AWB No | Optional |
| siparisnoList | Array | Gönderinizin size ait barkodu olan tekil no | Optional |
Nar Gönderi İçin Ana Gönderi Numarası Alma
Nar gönderilerinin kaydını oluşturma
Request (istek) parametreleri
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | kullanıcı adınız | Mandatory |
| Sifre | String(25) | şifreniz | Mandatory |
| gumruktipi | String(10) | Incoterm Flag : DDP için D DAP(DDU) için H | Mandatory |
| faturano | String(45) | Fatura numarası | |
| faturatarihi | Date (YYYYMMDD) | Fatura tarihi | |
| arsivpdf | String(250) | Pdf faturanın web adresi (tıklanınca açılacak) |
Ana Gönderi Numarası ile Nar Gönderisi Oluşturma
Request (istek) parametreleri
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | kullanıcı adınız | Mandatory |
| Sifre | String(25) | şifreniz | Mandatory |
| masterNo | Integer(7) | Ana Nar Gönderi numarası | Mandatory |
| shipmentNo | Array | Gönderinizin size ait barkodu olan tekil no | Optional |
create pickup
Toplama tarihi oluşturmayı sağlar
Request (istek) parametreleri
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | kullanıcı adınız | Mandatory |
| Sifre | String(25) | şifreniz | Mandatory |
| toplama_tarihi | Date(YYYYMMDD) | Toplama tarihi | Mandatory |
| gonderici_yetkili | String(30) | İsim Gönderici yetkilisi | Optional |
| gonderici_unvan | String(30) | Gönderen firma/kişi ünvan | Optional |
| gonderici_adres | String(200) | Gönderen Adres | Mandatory |
| gonderici_postakodu | String(10) | Gönderen Postakodu | Mandatory |
| gonderici_telefon | String(40) | Gönderen telefon | Optional |
| gonderici_email | String(40) | Gönderen Maili | Optional |
| ptsnolist | Array | PTS AWB No | Optional |
crossref
Dağıtıcı acente bilgisine erişmek için kullanılır. Parametreleri şunlardır : kullanici, sifre, ptsno, siparisno Kullanımı için özel yetkilendirme gereklidir.
Konşimento Oluşturma
A4 Formatında konşimento linki döndüren metotdur.
Müşteri referansını veya PTS referansını geçebilirsiniz A4 boyutunu ve PDF formatını döndürür
Fatura Bilgileri Alma
Request(istek) parametreleri
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv=
"http://schemas.xmlsoap.org/soap/envelope/"
xmlns:urn="urn:server">
<soapenv:Header/>
<soapenv:Body>
<urn:getFatura soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<kullanici xsi:type="xsd:string">DEV-27541194384867335</kullanici>
<sifre xsi:type="xsd:string">bbd47bf0-8ff8-11ec-83f4-005056b8981b</sifre>
<faturaNo xsi:type="xsd:string">FT-840301</faturaNo>
<faturaBaslangicTarihi xsi:type="xsd:string">2007-02-17</faturaBaslangicTarihi>
<faturaBitisTarihi xsi:type="xsd:string">2007-04-17</faturaBitisTarihi>
</urn:getFatura>
</soapenv:Body>
</soapenv:Envelope>fatura bilgilerini alma
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | kullanıcı adınız | Mandatory |
| Sifre | String(25) | şifreniz | Mandatory |
| faturano | String(40) | Fatura numarası | |
| faturabaslagıctarihi | Date (YYYYMMDD) | Fatura başlangıç tarihi | |
| faturabitistarihi | Date (YYYYMMDD) | Fatura bitiş tarihi |
Yanıtın(Response) çıktısı
İşlem başarılı ise JSON formatında veri döner:
<SOAP-ENV:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:server">
<SOAP-ENV:Body>
<ns1:getFaturaResponse xmlns:ns1="urn:server""http://schemas.xmlsoap.org/soap/encoding/">
<return xsi:type="xsd:string">"success":true,
"data":{"invoices":[{"invoice":{"number":"FT-840301","date":"2007-01-11","
total":"73.67","KDV":"","EPH":"0.00","receiver"
:"CANTEKS TEKS.\u0130N\u015e.DI\u015e.T\u0130C.LTD.\u015eT","address1":"MERKEZ MAH.HAVUZLAR CAD.
","address2":"NO:1 K:1","address3":"KA\u011eITHANE \u0130STANBUL",
"subItems":[{"invoiceDesc":"5558807236 IL TANGA LINGERIE LTD 1.400 KG Gross","invoiceCurrency":"EUR","invoiceAmount":"39.00",
"KDV":""}],"supplier":"PAKET TA\u015eIMACILIK S\u0130STEMLER\u0130 A.\u015e.","taxNumber":"7190041528 \/MARMARA KUR."}}]},
"message":"Basarili"}
</return>
</ns1:getFaturaResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Fatura kontroller için kullanılabilecek fatura hakkında bilgiler.
Etiket Alma
A6 formatında etiket döndürür. Çalışma koşulları addshipment'deki ile aynıdır.
Bu fonksiyon, etiket oluşturmak için kullanılıyor. Çağrıldığında cross referans metotun aksine etiket değişir ve etiket yeniden oluşturulur. Parametreleri şunlardır : kullanici, sifre, ptsno, siparisno, etiket, labelType
Geri dönen değer örneği:
AWB=2240000001|CROSS=01505149075717|PDF=https://www.pts.net/WEB/DPDPDFV4/2240000001_1607745124.pdf|UYARI=|HATA=
KATEGORİ ID DEN GTIP KOD BULMA ( HSCODE )
Request (istek) parametreleri
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | kullanıcı adınız | Mandatory |
| Sifre | String(25) | şifreniz | Mandatory |
| ulkekodu | String(2) | ISO 3166-1 alpha-2 tanımlamasına göre | Mandatory |
| aliexpresskategoriid | Integer | Aliexpress kategori id si | Mandatory |
SERVİS TÜRÜNÜ ALMA
Kulanıcı Bilgileriyle Servis Türünü Alabilme
Request (istek) parametreleri
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | kullanıcı adınız | Mandatory |
| Sifre | String(25) | şifreniz | Mandatory |
AGIRLIK BİLGİSİNİ ALMA
Bu fonksiyon, bir gönderinin agırlık bilgilerini sorgulamak için kullanılır
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:urn="urn:server">
<soapenv:Header/>
<soapenv:Body>
<urn:getweight soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<kullanici xsi:type="xsd:string">DEV-27541194384867335</kullanici>
<sifre xsi:type="xsd:string">bbd47bf0-8ff8-11ec-83f4-005056b8981b</sifre>
<ptsnolist SOAP-ENC:arrayType="urn:ptstrackingno[2]">
<code xsi:type="xsd:string">2280063175</code>
<code xsi:type="xsd:string">2280063176</code>
</ptsnolist>
<siparisnoList SOAP-ENC:arrayType="urn:msiparisno[2]">
<code xsi:type="xsd:string">96066582</code>
<code xsi:type="xsd:string">96044959</code>
</siparisnoList>
</urn:getweight>
</soapenv:Body>
</soapenv:Envelope>Request (istek) parametreleri
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | kullanıcı adınız | Mandatory |
| Sifre | String(25) | şifreniz | Mandatory |
| ptsnolist | Array | PTS AWB No (ptsnolist veya siparisnoList zorunludur) | Optional |
| siparisnoList | Array | Gönderinizin size ait barkodu olan tekil no | Optional |
Yanıtın (Response) çıktısı
İşlem başarılı ise JSON formatında veri döner:
Geri dönen değeri, php json_decode fonksiyonu ile doğrudan object formatına ya da diziye
dönüştürebilirsiniz.
Başarılı değilse boş ya da aşağıdaki türde bir hata mesajı döner:
HATA=Bulunamadi
<SOAP-ENV:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:server">
<SOAP-ENV:Body>
<ns1:getweightResponse xmlns:ns1="urn:server""http://schemas.xmlsoap.org/soap/encoding/">
<return xsi:type="xsd:string">"success":true,
[{"ptsno":"2280063175","siparisno":"TESTORDER35588782282","weight":"2.000","volume":[{"length":"30","width":"40","height":"60"}]},
{"ptsno":"2280063176","siparisno":"TESTORDER35588782283","weight":"2.000","volume":[{"length":null,"width":null,"height":null}]}]
</return>
</ns1:getweightResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>Gumruk Beyan(ETGB) Bilgilerini Alma
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:urn="urn:server">
<soapenv:Header/>
<soapenv:Body>
<urn:gumrukbeyan soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<kullanici xsi:type="xsd:string">DEV-27541194384867335</kullanici>
<sifre xsi:type="xsd:string">bbd47bf0-8ff8-11ec-83f4-005056b8981b</sifre>
<ptsno xsi:type="xsd:string">2007-02-17</faturaBaslangicTarihi>
<siparisno xsi:type="xsd:string">2007-04-17</faturaBitisTarihi>
</urn:gumrukbeyan>
</soapenv:Body>
</soapenv:Envelope>
Request (istek) parametreleri
Bu fonksiyon, bir gönderinin gümrük beyan bilgilerini sorgulamak için kullanılır
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | kullanıcı adınız | Mandatory |
| Sifre | String(25) | şifreniz | Mandatory |
| siparisno | String(40) | Gönderinizin size ait barkodu olan tekil no | Mandatory |
| ptsno | String(10) | PTS AWB No | Optional |
Saha açıklamaları diğer fonksiyonlarla aynıdır.
Parametreler:
kullanici,
sifre,
ptsno,
siparisnoSaha
Örnek:
'siparisno'=>'stest34234234',…
Kullanımı için yetkilendirme gereklidir.
Yanıtın (Response) çıktısı
Sunucu cevap örneği:
2245013963|66179116|20343200EX025010|2020-09-17|116.05|EUR|116.05 Geri dönen sahalar:
PtsNo
SiparişNo, TGCB No, BeyanTarihi (YYYY-MM-DD), beyan edilen değer,
Beyan edilen para birimi
Euro cinsinden tutar (gönderi tarihindeki TCMB kurundan dönüştürülerek)
printed
Bu fonksiyon, hem gönderi pts görevlisine teslim edilirken hem de kaydedilmiş bir gönderinin ebat ve ağırlık bilgilerini güncellemek için kullanılıyor. Bu fonksiyonun işlemesi için gönderinin daha önce addshipment fonksiyonu ile sisteme yüklenmiş olması gereklidir. Bu fonksiyon çağırılınca,gönderinn etiketi basıldı ve PTS kuryesine teslim edildi anlamına gelmektedir. Bu veri, günlük mutabakat raporları için kullanılıyor.
Remove Shipment
fonksiyon, kaydedilmiş bir gönderinin silinmesini sağlar. İptal edilen siparişler için kullanılabilir.
Bu metot'un kullanılabilmesi için gönderinin PTS tarafından teslim alınmamış olması
gerekmektedir.
Parametreleri şunlardır :
kullanici, sifre, ptsno, siparisno
Saha açıklamaları addshipment ile aynıdır. ptsno veya sipariş no’dan biri yeterlidir.
Örnek:
…
'siparisno'=>'stest34234234',
…
İşlem başarılı ise “xxx silindi. “ şeklinde bir mesaj döner, başarılı değilse aşağıdaki türde bir
hata mesajları:
HATA: xxx silinemedi! Hareket gormus. HATA:xxx bulunamadi!
tracker
crossref fonksiyonu ile aynı parametrelerle çalışır. Gönderinin son durumunu dağıtıcı acentelerden sorgular. Aşağıdaki şekilde veri döner: 2231048841||ZZZ FREIGHT -ACENTE ADI-|01505148980856|https://tracking.zzz.de/parcelstatus? query=01505148980856&locale=en_D2 Geri dönen bilginin son parçası gönderi izleme bağlantısıdır. Eğer gönderi dağıtıcı acente tarafından henüz işlenmemişse, PTS’nin izleme bağlantısı geri döner. Eğer gönderi acente tarafından işleme alındıysa, acenteye ait izleme bağlantısı geri döner. Bu fonksiyon e-ticaret firmalarının, güncel izleme bağlantısını kendi müşterileriyle doğrudan paylaşabilmesi için eklenmiştir. Kullanımı için özel yetkilendirme gereklidir.
Takip
Bu fonksiyon, gönderi takibi amacıyla kullanılmaktadır.
Request (istek) parametreleri
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn=
"urn:server">
<soapenv:Body>
<soapenv:Header/>
<urn:tracking soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<kullanici xsi:type="xsd:string">DEV-27541194384867335</kullanici>
<sifre xsi:type="xsd:string">bbd47bf0-8ff8-11ec-83f4-005056b8981b</sifre>
<ptsno xsi:type="xsd:unsignedLong">0</ptsno>
<siparisno xsi:type="xsd:string">PTSTST{%Y-%m-%d}-001</siparisno>
<dil xsi:type="xsd:string">TR</dil>
</urn:tracking>
</soapenv:Body>
</soapenv:Envelope>| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | kullanıcı adınız | Mandatory |
| Sifre | String(25) | şifreniz | Mandatory |
| siparisno | String(40) | Gönderinizin size ait barkodu olan tekil no | Mandatory |
| ptsno | String(10) | PTS AWB No | Optional |
| dil | String(10) | Optional |
Dil Saha açıklamaları addshipment ile aynıdır. dil sahası “TR”,”EN” veya “DE” olabilir. Örnekler: 1)… 'ptsno'=>5552221915, 'dil'=>'tr' … 2) … 'siparisno'=>'stest34234234', 'dil'=>'tr' …
Yanıtın (Response) çıktısı
[{"tarih":"2017-04-10","saat":"16:21","durumkodu":"222","durum":"Abgang ab Station","detay":"test"},
{"tarih":"2017-05- 19","saat":"11:00","durumkodu":"225","durum":"Ankunft in der Station","detay":"Cologne -
Germany"},{"tarih":"2017-06-12","saat":"10:00","durumkodu":"225","durum":"Ankunft in der Station",
"detay":"COLOGNE - GERMANY"}]
İşlem başarılı ise JSON formatında veri döner:
Geri dönen değeri, php json_decode fonksiyonu ile doğrudan object formatına ya da diziye
dönüştürebilirsiniz.
Başarılı değilse boş ya da aşağıdaki türde bir hata mesajı döner:
HATA=Bulunamadi
Takip Xml
bu fonksiyon tracking fonksiyonu ile aynı işleve sahiptir, farklı olarak xml formatında çıktı üretir.
trackıngmultı
Bu fonksiyon, gönderi takibi amacıyla kullanılmaktadır.
Request (istek) parametreleri
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | kullanıcı adınız | Mandatory |
| Sifre | String(25) | şifreniz | Mandatory |
| ptsno | String(10) | PTS AWB No | Optional |
| siparisno | String(40) | Gönderinizin size ait barkodu olan tekil no | Optional |
| dil | String(2) | Dil Seçeneği isteğe bağlı | Optional |
trackıngxmllatest
Bu fonksiyon, gönderi takibi amacıyla kullanılmaktadır.
Request (istek) parametreleri
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | kullanıcı adınız | Mandatory |
| Sifre | String(25) | şifreniz | Mandatory |
| ptsno | String(10) | PTS AWB No | Optional |
| siparisno | String(40) | Gönderinizin size ait barkodu olan tekil no | Optional |
| dil | String(2) | Dil Seçeneği isteğe bağlı | Optional |
trackıngxmlmultıwıthgroup
Bu fonksiyon, gönderi takibi amacıyla kullanılmaktadır.
Request (istek) parametreleri
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | kullanıcı adınız | Mandatory |
| Sifre | String(25) | şifreniz | Mandatory |
| ptsno | String(10) | PTS AWB No | Optional |
| siparisno | String(40) | Gönderinizin size ait barkodu olan tekil no | Optional |
| dil | String(2) | Dil Seçeneği isteğe bağlı | Optional |
updatedim
Bu fonksiyon, kaydedilmiş bir gönderinin ebat ve ağırlık bilgilerini güncellemek için kullanılmaktadır. Bu fonksiyonun işlemesi için gönderinin daha önce addshipment fonksiyonu ile sisteme yüklenmiş olması gereklidir. … 'siparisno'=>'stest34234234', 'toplamkg'=>0.25, // kg cinsinden agirlik ‘ebat'=>$ebat … İşlem başarılı ise OK şeklinde bir mesaj döner, başarılı değilse aşağıdaki türde bir hata mesajı: HATA=Bu siparis hareket gormus
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | kullanıcı adınız | Mandatory |
| Sifre | String(25) | şifreniz | Mandatory |
| ptsno | String(10) | PTS AWB No | Optional |
| siparisno | String(40) | Gönderinizin size ait barkodu olan tekil no | Mandatory |
| Ebat | Array | Aşağıdaki sahalardan oluşan çok satırlı dizi | Optional |
| en | Double(4,1) | Gönderinin ebat bilgisi cm cinsinden | Optional |
| boy | Double(4,1) | Gönderinin ebat bilgisi cm cinsinden | Optional |
| yukselik | Double(4,1) | Gönderinin ebat bilgisi cm cinsinden | Optional |
| agirlik | Double(6,2) | Gönderinin ağırlık bilgisi kg cinsinden | Optional |
Müşteri Faturası Bilgi Güncelleme
Yeni eklenen bu fonksiyon, kaydedilmiş bir gönderinin fatura bilgilerini güncellemek için kullanılıyor. Bu fonksiyonun işlemesi için gönderinin daha önce addshipment fonksiyonu ile sisteme yüklenmiş olması gereklidir.
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | kullanıcı adınız | Mandatory |
| Sifre | String(25) | şifreniz | Mandatory |
| ptsno | String(10) | PTS AWB No | Optional |
| siparisno | String(40) | Gönderinizin size ait barkodu olan tekil no | Mandatory |
| faturano | String(40) | Fatura Numarası | Mandatory |
| faturatarihi | Date (YYYYMMDD) | Fatura Tarihi | Mandatory |
| earsivpdf | String(250) | E-Arşiv Pdf Linki | Mandatory |
| ygarsivpdf | String(250) | Varış Gümrük Commercial Invoice PDF Linki | Optional |
Dosya Yükleyerek Müşteri Faturası Bilgi Güncelleme
Yeni eklenen bu fonksiyon, kaydedilmiş bir gönderinin fatura bilgilerini güncellemek için kullanılıyor. updateinvoice metotundan farklı olarak, URL olarak değil base64 formatında image olarak dosya iletimi yapabilirsiniz. Sadece PDF formatında desteklemektedir. Bu fonksiyonun işlemesi için gönderinin daha önce addshipment fonksiyonu ile sisteme yüklenmiş olması gereklidir.
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | kullanıcı adınız | Mandatory |
| Sifre | String(25) | şifreniz | Mandatory |
| ptsno | String(10) | PTS AWB No | Optional |
| siparisno | String(40) | Gönderinizin size ait barkodu olan tekil no | Mandatory |
| faturano | String(40) | Fatura Numarası | Mandatory |
| faturatarihi | Date (YYYYMMDD) | Fatura Tarihi | Mandatory |
| base64earsivPdfContent | String(250) | E-Arşiv Base64 Pdf Image | Mandatory |
| base64ygarsivPdfContent | String(250) | Varış Gümrük Commercial Invoice PDF Base64 Image | Optional |
NAR Gönderi İçin Ana Gönderi Bilgisine ait Fatura Bilgilerinin Güncellemesi
Request (istek) parametreleri
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | kullanıcı adınız | Mandatory |
| Sifre | String(25) | şifreniz | Mandatory |
| masterno | Integer(7) | Ana Nar Gönderi numarası/td> | |
| faturano | String(45) | Fatura numarası | |
| faturatarihi | Date (YYYYMMDD) | Fatura tarihi | |
| arsivpdf | String(250) | Pdf faturanın web adresi (tıklanınca açılacak) |
updateConsigneeID
Alıcı Kİmlik Bilgilerini güncellemek için kullanılır
Request (istek) parametreleri
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | kullanıcı adınız | Mandatory |
| Sifre | String(25) | şifreniz | Mandatory |
| ptsno | String(10) | PTS AWB No | Mandatory |
| name | String(10) | İsminiz | Optional |
| lastName | String(10) | Soyİsiminiz | Optional |
| patronymic | String(250) | baba kökenli ad | Optional |
| sex | String(10) | Cinsiyet | Optional |
| birthDate | Date (YYYYMMDD) | Doğum tarihi | Optional |
| birthPlace | String(10) | Doğum Yeri | Mandatory |
| docTypeCode | String(10) | Döküman Tipi | Optional |
| docSeries | String(10) | Döküman Seri Numarası | Optional |
| docNumber | String(10) | Döküman Numarası | Optional |
| docDate | Date (YYYYMMDD) | Döküman Tarihi | Optional |
| docOrganization | String(10) | Döküman Organizasyon | Optional |
| docOrganizationCode | String(10) | Döküman | Optional |
| taxNumber | String(10) | Vergi Numarası | Optional |
update ıdentıty ınfo
Alıcı Kİmlik Bilgilerini güncellemek için kullanılır
Request (istek) parametreleri
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | kullanıcı adınız | Mandatory |
| Sifre | String(25) | şifreniz | Mandatory |
| ptsno | String(10) | PTS AWB No | Mandatory |
| name | String(10) | İsminiz | Optional |
| lastName | String(10) | Soyİsiminiz | Optional |
| patronymic | String(250) | baba kökenli ad | Optional |
| sex | String(10) | Cinsiyet | Optional |
| birthDate | Date (YYYYMMDD) | Doğum tarihi | Optional |
| birthPlace | String(10) | Doğum Yeri | Mandatory |
| docTypeCode | String(10) | Döküman Tipi | Optional |
| docSeries | String(10) | Döküman Seri Numarası | Optional |
| docNumber | String(10) | Döküman Numarası | Optional |
| docDate | Date (YYYYMMDD) | Döküman Tarihi | Optional |
| docOrganization | String(10) | Döküman Organizasyon | Optional |
| docOrganizationCode | String(10) | Döküman | Optional |
| taxNumber | String(10) | Vergi Numarası | Optional |
add ıdentıty ınfo
Alıcı Kİmlik Bilgilerini Eklemek için kullanılır
Request (istek) parametreleri
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | kullanıcı adınız | Mandatory |
| Sifre | String(25) | şifreniz | Mandatory |
| ptsno | String(10) | PTS AWB No | Mandatory |
| name | String(10) | İsminiz | Optional |
| lastName | String(10) | Soyİsiminiz | Optional |
| patronymic | String(250) | baba kökenli ad | Optional |
| sex | String(10) | Cinsiyet | Optional |
| birthDate | Date (YYYYMMDD) | Doğum tarihi | Optional |
| birthPlace | String(10) | Doğum Yeri | Mandatory |
| docTypeCode | String(10) | Döküman Tipi | Optional |
| docSeries | String(10) | Döküman Seri Numarası | Optional |
| docNumber | String(10) | Döküman Numarası | Optional |
| docDate | Date (YYYYMMDD) | Döküman Tarihi | Optional |
| docOrganization | String(10) | Döküman Organizasyon | Optional |
| docOrganizationCode | String(10) | Döküman | Optional |
| taxNumber | String(10) | Vergi Numarası | Optional |
updatepickup
Oluşturulan Çağrının gönderilerini güncellemek için kullanılır. (createpickup method servisinden oluşan çağrı numarasıyla gönderi no bilgilerini ptsnolist güncelleme methodur)
Request (istek) parametreleri
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | kullanıcı adınız | Mandatory |
| Sifre | String(25) | şifreniz | Mandatory | ptsnolist | Array | PTS AWB No | Mandatory |
| cagri_numarasi | String(8) | Çağrı Numarası | Mandatory |
cancelpickup
Bu fonksiyon, kaydedilmiş bir çağrının silinmesini sağlar. (createpickup) servisiyle oluşturulan çağrının silinmesi için kullanılır
Request (istek) parametreleri
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | kullanıcı adınız | Mandatory |
| Sifre | String(25) | şifreniz | Mandatory |
| cagri_numarasi | String(8) | Çağrı Numarası | Mandatory |
getPrices
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv=
"http://schemas.xmlsoap.org/soap/envelope/"
xmlns:urn="urn:server">
<soapenv:Header/>
<soapenv:Body>
<urn:getPrices soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<kullanici xsi:type="xsd:string">DEV-27541194384867335</kullanici>
<sifre xsi:type="xsd:string">bbd47bf0-8ff8-11ec-83f4-005056b8981b</sifre>
<ulkekodu xsi:type="xsd:string">NL</ulkekodu>
<customsType xsi:type="xsd:string">D</customsType>
<ebat xsi:type="urn:dims" SOAP-ENC:arrayType="urn:dim[2]">
<dim>
<en xsi:type="xsd:string">20</en>
<boy xsi:type="xsd:decimal">20</boy>
<yukseklik xsi:type="xsd:string">10</yukseklik>
<agirlik xsi:type="xsd:decimal">0.75</agirlik>
</dim>
<dim>
<en xsi:type="xsd:decimal">20</en>
<boy xsi:type="xsd:decimal">20</boy>
<yukseklik xsi:type="xsd:decimal">10</yukseklik>
<agirlik xsi:type="xsd:decimal">1.25</agirlik>
</dim>
</ebat>
</urn:getPrices>
</soapenv:Body>
</soapenv:Envelope>Bu fonksiyon, girilen ebat ve ülke bilgisine bağlı olan firmaların fiyat listesini getirmek için kullanılır.
Request (istek) parametreleri
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | kullanıcı adınız | Mandatory |
| Sifre | String(25) | şifreniz | Mandatory |
| ulke_kodu | String(2) | ISO 3166-1 alpha-2 tanımlamasına göre | Mandatory |
| customsType | String(1) | Gümrük Tipine göre | Optional |
| Ebat | Array | Aşağıdaki sahalardan oluşan çok satırlı dizi | Mandatory |
<SOAP-ENV:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:server">
<SOAP-ENV:Body>
<ns1:getPricesResponse xmlns:ns1="urn:server""http://schemas.xmlsoap.org/soap/encoding/">
<return xsi:type="xsd:string">"success":true,
{"Fiyat":[{"serviceName":"Eco","currency":"EUR","price":"11.26","priceTL":"231.88","chargableWeight":"1.500"}]}
</return>
</ns1:getPricesResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>Yanıtın (Response) çıktısı
İşlem başarılı ise JSON formatında veri döner:
Geri dönen değeri, php json_decode fonksiyonu ile doğrudan object formatına ya da diziye
dönüştürebilirsiniz.
Başarılı değilse boş [ ] döner
updateproform
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv=
"http://schemas.xmlsoap.org/soap/envelope/"
xmlns:urn="urn:server">
<soapenv:Header/>
<soapenv:Body>
<urn:updateproform soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<kullanici xsi:type="xsd:string">DEV-27541194384867335</kullanici>
<sifre xsi:type="xsd:string">bbd47bf0-8ff8-11ec-83f4-005056b8981b</sifre>
<ptsno xsi:type="xsd:unsignedLong">0</ptsno>
</urn:updateproform>
</soapenv:Body>
</soapenv:Envelope>Gönderinin proforma kalemlerini güncellemek için kullanılan metoddur.
Request (istek) parametreleri
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | kullanıcı adınız | Mandatory |
| Sifre | String(25) | şifreniz | Mandatory | proforma | Array | proforma | Mandatory |
| ptsno | String(10) | PTS AWB No | Mandatory |
| siparisno | String(40) | Gönderinizin size ait barkodu olan tekil no | Optional |
Yanıtın (Response) çıktısı:
AWB=0 proforma kalemleri guncellendi
getPickupInfo
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv=
"http://schemas.xmlsoap.org/soap/envelope/"
xmlns:urn="urn:server">
<soapenv:Header/>
<soapenv:Body>
<urn:getPickupInfo soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<kullanici xsi:type="xsd:string">DEV-27541194384867335</kullanici>
<sifre xsi:type="xsd:string">bbd47bf0-8ff8-11ec-83f4-005056b8981b</sifre>
<cagri xsi:type="xsd:string">21416311</cagri>
</urn:getPickupInfo>
</soapenv:Body>
</soapenv:Envelope>Bu method, çağrıya ait ve o çağrıda mevcut olan gönderi/gönderilere ait bilgileri listemelek için kullanılır.
Request (istek) parametreleri
| parametre adı | türü | Açıklama | M/O |
|---|---|---|---|
| Kullanici | String(25) | kullanıcı adınız | Mandatory |
| Sifre | String(25) | şifreniz | Mandatory |
| cagri | Integer | Çağrı Numarası | Mandatory |
<SOAP-ENV:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:server">
<SOAP-ENV:Body>
<ns1:getPickupInfoResponse xmlns:ns1="urn:server""http://schemas.xmlsoap.org/soap/encoding/">
<return xsi:type="xsd:string">"success":true,
{"Çağrı":[{"Unvan":"PTSTEST","Adres":"YENİBOSNA MERKEZ MAH. CEMAL ULUSOY CAD. NO:57/2 YENİBOSNA BAHÇELİEVLER ISTANBUL 34197","Telefon":"90(212)444 0787","E-mail":"test@test.com","Tarih":"2023-02-27","Çağrı Durumu":"Onaylandı","Çağrı Durum Kodu":"O"},{"Gönderi":"5515083278","Gönderi Durumu":"Gönderi Toplanmadı","Status":"1"}]}
</return>
</ns1:getPricesResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>Yanıtın (Response) çıktısı
İşlem başarılı ise JSON formatında veri döner:
Geri dönen değeri, php json_decode fonksiyonu ile doğrudan object formatına ya da diziye
dönüştürebilirsiniz.
Başarılı değilse boş [ ] döner
Responseta dönen Durum Kodları ve Açıklamaları şu şekildedir;
| Çağrı Durum Kodu | Durum Açıklaması |
|---|---|
| B | Kuryeye Bildirildi |
| C | Çağrı Geldi |
| E | Ertelendi |
| O | Onaylandı |
| T | Tamamlandı |
| W | İptal Talep |
| X | İptal |
Responseta dönen Gönderi Durum Kodları ve Açıklamaları şu şekildedir;
| Gönderi Durum Kodu(Status) | Durum Açıklaması |
|---|---|
| 0 | İptal |
| 1 | Gönderi Toplanmadı |
| 2 | Gönderi Toplandı |
Servis Kodları
Kullanılabilecek servis kodları listesi
| Servis Kodu | Prefix | Açıklaması |
|---|---|---|
| E | 22 | ecoPTS |
| X | 55 | PTS Express |
| A | 66 | Aliexpress |
| W | 77 | Wish PTT |
| T | 88 | Etsy |
| J | 99 | Jumia |
| C | 44 | Çiçek Sepeti |
| H | 65 | Hedef Avrupa |
| M | 33 | Amazon |
| U | 53 | UPS Express |
| F | 54 | FEDEX Express |
| P | 24 | PTS Mail |
| Y | 23 | US ECO |
| G | 25 | GBS Rusya |
| D | 26 | UPS Expedited |
| L | 27 | PTS Flex |
| S | 28 | PTS Smart |
| Q | 52 | DHL Express |
| O | 45 | OZON |
| R | 68 | Aliexpress Rusya |
| I | 11 | Import |
| K | 29 | TY KARAYOLU |
| B | 46 | SHOPIFY |
| N | 56 | UPS SAVER |
| Z | 21 | PTS US-D |
| 1 | 20 | JOOM KARAYOLU |
| 2 | 30 | PTS Flex MENA |
| V | 47 | EBAY |
| 3 | 31 | SPEGAT RUSYA |
| 4 | 57 | RUPOST |
| 5 | 32 | PTS US-D-EXPEDITED |
| 6 | 34 | FirsMile |
Hareket(Exception) Kodları
Takip metotlarında dönen sonuçlara ait tüm hareketlere ait kodlar.
| Durum Kodu | Durum Açıklaması |
|---|---|
| 001 | Kurye Tarafından Gönderi Toplandı |
| 004 | Gönderi Verisi Ulaştı |
| 007 | Çuvallama yapıldı |
| 008 | API OKUTMASI |
| 009 | Çuval Değişikliği Yapıldı |
| 010 | Hasarlı Ulaştı |
| 012 | VIAEU Bag Okutması |
| 016 | Operasyon İşlemleri bekleniyor |
| 020 | Acenteye Ulaştı |
| 100 | Gümrükte Ordinolu |
| 101 | Havayolu Transfer Surecinde |
| 104 | Acenteye teslim edildi |
| 105 | Gümrük Müşavr.Bildirildi |
| 106 | Araca Yuklendi |
| 107 | Araç Değişikliği |
| 108 | Alıcıdan vekaletname bekleniyor |
| 113 | Vekaletname bekleniyor |
| 201 | Özel Fiyat Alma Sürecinde |
| 203 | Özel Fiyat Teklifi Reddedildi |
| 210 | Operasyon Alanına Ulaşmadı |
| 212 | Merkeze geri döndü |
| 216 | Acenteden onay geldi |
| 217 | Ertesi Gün Uçuşlu |
| 218 | Gönderi Bekletiliyor |
| 219 | Gönderi Merkeze Ulaştı |
| 220 | Acenteden onay bekleniyor |
| 221 | Şube Çıkışı |
| 222 | Uçuşa hazırlandı |
| 224 | Koln operasyonunda işlendi |
| 225 | Hub Girişi |
| 226 | Aktarma İstasyonda |
| 227 | Hub Çıkışı |
| 230 | Gümrük İncelemesi |
| 240 | Gümrükte Terk Edildi |
| 250 | Gümrükten Çekildi |
| 251 | B2B Gümrükten Çekildi |
| 255 | Gümrük İşlemleri Devam Ediyor |
| 260 | Gümrük Tarafından El Konuldu |
| 261 | Aylik 5 Gönderi Limit Aşımı |
| 270 | Linehaul'u Kaçırdı |
| 280 | Transferde Gecikme |
| 285 | Hava Koşulları |
| 290 | Yanlış Varış Yeri. Yeniden Yönlendirildi |
| 300 | Dağıtıma Çıktı |
| 304 | Dağıtıma Çıktı |
| 305 | Aktarması Yapıldı |
| 310 | Tatil |
| 330 | Teslimat Yeri Kapalı |
| 400 | Adres Yanlış, PTS ile temasa geçiniz |
| 401 | Alıcı Taşınmış |
| 402 | Başka adrese teslim istendi |
| 405 | Adres Düzeltildi |
| 420 | Teslim Edilemiyor |
| 430 | Gönderi Reddedildi |
| 440 | Collect Reddedildi |
| 450 | Daha sonra teslimat istendi |
| 460 | Parcelshop Teslim.Alıcı Alması Bekleniyr |
| 477 | AFS Köln Ofisine Geri Döndü |
| 478 | PTS Londra Ofisine Geri Döndü |
| 479 | Pts Amsterdam Deposuna Geri Döndü |
| 550 | Gümrük Sorunlarından Kaynaklanan |
| 710 | ATR BELGELİ GÖNDERİ |
| 720 | EUR 1 BELGELİ GÖNDERİ |
| 730 | MENŞE ŞAHADETNAMELİ GÖNDERİ |
| 777 | Tracer Açıldı |
| 778 | Tracer Kapandı |
| 780 | Claim Açıldı |
| 781 | Claim Kapandı |
| 800 | İmha Edildi |
| 888 | Kayıp |
| 890 | Ödeme bekleniyor |
| 891 | Ödeme geldi |
| 900 | Reverse Operasyon |
| 901 | Cikis Merkezinden Gonderene Iade |
| 910 | Gönderi iptal edildi |
| 990 | Hasarlı |
| 992 | Dağıtımı planlandı |
| 993 | Afs Yönlendirmesi |
| 994 | İade Süreci Tamamlandı |
| 995 | Gümrük Müşavirine Teslim |
| 996 | Tahmini Teslim Tarihi |
| 997 | Göndericiye iade edildi |
| 998 | Yerel Acenteye Teslim Edildi |
| 999 | Teslim Edildi |
Sorularınız veya çözümleriniz için Lütfen firmamızla iletişim kurunuz itdestek@pts.net