PHP code example of mpyazilim / logistics

1. Go to this page and download the library: Download mpyazilim/logistics library. Choose the download type require.

2. Extract the ZIP file and open the index.php.

3. Add this code to the index.php.
    
        
<?php
require_once('vendor/autoload.php');

/* Start to develop here. Best regards https://php-download.com/ */

    

mpyazilim / logistics example snippets




use MPYazilim\Logistics\MPLogistics;

$response = MPLogistics::ptt()
    ->account(
        username: 'NORMAL_KULLANICI',
        password: 'NORMAL_SIFRE',
        postaCeki: 'POSTA_CEKI'
    )
    ->payload(
        dosyaAdi: 'BATCH_20260207',
        gonderiTur: 'KARGO',
        gonderiTip: 'NORMAL',
        aAdres: 'Mahalle Adres Ilce/Il',
        aliciAdi: 'Ad Soyad',
        agirlik: 0,
        aliciIlAdi: 'ISTANBUL',
        aliciIlceAdi: 'KADIKOY',
        aliciSms: '905551112233',
        barkodNo: '1234567890',
        odemeSartUcreti: 100.50,
        musteriReferansNo: 1452,
        rezerve1: 'POSTA_CEKI',
        yukseklik: 0,
        boy: '',
        desi: '',
        ekhizmet: '',
        en: '',
        odemesekli: 'GONDERICI',
        gondericibilgi: null,
        kullanici: 'PttWs'
    )
    ->test(false)
    ->send();

$hareketler = MPLogistics::ptt()
    ->account(
        username: 'NORMAL_KULLANICI',
        password: 'NORMAL_SIFRE',
        postaCeki: 'POSTA_CEKI'
    )
    ->test(false)
    ->kargoHareketleri('1234567890');

$referansTakip = MPLogistics::ptt()
    ->account(
        username: 'NORMAL_KULLANICI',
        password: 'NORMAL_SIFRE',
        postaCeki: 'POSTA_CEKI'
    )
    ->test(false)
    ->referansTakip('REF-1001');

$response = MPLogistics::ptt()
    ->account(
        username: 'IADE_KULLANICI_ADI', // iadeKullaniciAdi
        password: 'IADE_SIFRE', // iadeSifre
        postaCeki: 'POSTA_CEKI'
    )
    ->payload(
        dosyaAdi: 'BATCH_RETURN_20260207',
        gonderiTur: 'KARGO',
        gonderiTip: 'NORMAL',
        aAdres: 'Mahalle Adres Ilce/Il',
        aliciAdi: 'Ad Soyad',
        agirlik: 0,
        aliciIlAdi: 'ISTANBUL',
        aliciIlceAdi: 'KADIKOY',
        aliciSms: '905551112233',
        barkodNo: '',
        odemeSartUcreti: 0,
        musteriReferansNo: 1452, // refno
        rezerve1: 'POSTA_CEKI',
        yukseklik: 0,
        boy: '',
        desi: '',
        ekhizmet: '',
        en: '',
        odemesekli: 'MH',
        gondericibilgi: [
            'gonderici_adi' => 'Ad',
            'gonderici_adresi' => 'Mahalle Adres Ilce/Il',
            'gonderici_email' => '',
            'gonderici_il_ad' => 'ISTANBUL',
            'gonderici_ilce_ad' => 'KADIKOY',
            'gonderici_posta_kodu' => '',
            'gonderici_sms' => '',
            'gonderici_soyadi' => 'Soyad',
            'gonderici_telefonu' => '905551112233',
            'gonderici_ulke_id' => '',
        ]
    )
    ->test(false)
    ->return();



use MPYazilim\Logistics\MPLogistics;

$response = MPLogistics::aras()
    ->account(
        username: 'ARAS_USERNAME',
        password: 'ARAS_PASSWORD',
        customerCode: 'ARAS_CUSTOMER_CODE'
    )
    ->test(false)
    ->getBarcode('8827930407131929');

$imageResponse = MPLogistics::aras()
    ->account(
        username: 'ARAS_USERNAME',
        password: 'ARAS_PASSWORD',
        customerCode: 'ARAS_CUSTOMER_CODE'
    )
    ->test(false)
    ->getBarcodeImage('8827930407131929', __DIR__ . '/tmp');

$imageDataUri = MPLogistics::aras()
    ->account(
        username: 'ARAS_USERNAME',
        password: 'ARAS_PASSWORD',
        customerCode: 'ARAS_CUSTOMER_CODE'
    )
    ->test(false)
    ->getBarcodeImageDataUri('8827930407131929');

[
    'Images' => ['...'], // Aras direkt resim donerse base64 liste
    'ZebraZpl' => ['^XA...^XZ'],
    'ZebraEpl' => [],
    'ZebraPdf' => [],
    'BarcodeModelLst' => [
        [
            'BarcodeNo' => '8827930407131929',
            'IntegrationCode' => '8827930407131929',
        ],
    ],
    'Message' => '',
    'ResultCode' => 0,
]

[
    'Images' => ['iVBORw0KGgoAAAANSUhEUgAA...'],
    'ImageBase64' => 'iVBORw0KGgoAAAANSUhEUgAA...',
    'ImageDataUri' => 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...',
    'SavedFiles' => ['/tmp/8827930407131929.png'],
    'ImagePath' => '/tmp/8827930407131929.png',
    'ZebraZpl' => ['^XA...^XZ'],
    'ZebraEpl' => [],
    'ZebraPdf' => [],
    'BarcodeModelLst' => [],
    'Message' => '',
    'ResultCode' => 0,
]



use MPYazilim\Logistics\MPLogistics;

$response = MPLogistics::dhl()
    ->account(
        username: 'MNG_CUSTOMER_NUMBER',
        password: 'MNG_PASSWORD',
        clientId: 'MNG_CLIENT_ID',
        clientSecret: 'MNG_CLIENT_SECRET'
    )
    ->payload(
        referenceId: 'REF-1001',
        barcode: 'REF-1001',
        isCOD: false,
        codAmount: 0,
        shipmentServiceType: 1,
        packagingType: 1,
        paymentType: 1,
        deliveryType: 1,
        content: '1001',
        description: 'Order : 1001',
        cityCode: 34,
        cityName: 'ISTANBUL',
        districtName: 'KADIKOY',
        districtCode: 34001,
        address: 'Mahalle Sokak No:1',
        fullName: 'Ad Soyad',
        mobilePhoneNumber: '905551112233',
        pieceBarcode: 'Product',
        pieceDesi: 0,
        pieceKg: 0,
        pieceContent: '',
        smsPreference1: 0,
        smsPreference2: 0,
        smsPreference3: 0,
        billOfLandingId: 'REF-1001',
        marketPlaceShortCode: '',
        marketPlaceSaleCode: '',
        pudoId: '',
        customerId: '',
        refCustomerId: '',
        bussinessPhoneNumber: '',
        email: '[email protected]',
        taxOffice: '',
        taxNumber: '',
        homePhoneNumber: ''
    )
    ->test(false)
    ->send();

$dhlHareket = MPLogistics::dhl()
    ->account(
        username: 'MNG_CUSTOMER_NUMBER',
        password: 'MNG_PASSWORD',
        clientId: 'MNG_CLIENT_ID',
        clientSecret: 'MNG_CLIENT_SECRET'
    )
    ->test(false)
    ->kargoHareketleri('REF-1001');

$dhlDurum = MPLogistics::dhl()
    ->account(
        username: 'MNG_CUSTOMER_NUMBER',
        password: 'MNG_PASSWORD',
        clientId: 'MNG_CLIENT_ID',
        clientSecret: 'MNG_CLIENT_SECRET'
    )
    ->test(false)
    ->kargoDurum('REF-1001');

$response = MPLogistics::dhl()
    ->account(
        username: 'MNG_CUSTOMER_NUMBER',
        password: 'MNG_PASSWORD',
        clientId: 'MNG_CLIENT_ID',
        clientSecret: 'MNG_CLIENT_SECRET'
    )
    ->payload(
        referenceId: 'REF-1001',
        barcode: 'REF-1001',
        isCOD: false,
        codAmount: 0,
        shipmentServiceType: 1,
        packagingType: 1,
        paymentType: 2,
        deliveryType: 1,
        content: '1001',
        description: 'Order : 1001',
        cityCode: 34,
        cityName: 'ISTANBUL',
        districtName: 'KADIKOY',
        districtCode: 34001,
        address: 'Alici adresi',
        fullName: 'Alici Ad Soyad',
        mobilePhoneNumber: '905551112233',
        shipper: [
            'customerId' => '',
            'refCustomerId' => '',
            'cityCode' => 34,
            'cityName' => 'ISTANBUL',
            'districtName' => 'KADIKOY',
            'districtCode' => 34001,
            'address' => 'Gonderici adresi',
            'bussinessPhoneNumber' => '',
            'email' => '[email protected]',
            'taxOffice' => '',
            'taxNumber' => '',
            'fullName' => 'Gonderici Ad Soyad',
            'homePhoneNumber' => '',
            'mobilePhoneNumber' => '905551112233',
        ]
    )
    ->test(false)
    ->return();



use MPYazilim\Logistics\MPLogistics;

$resp = MPLogistics::hepsijet()
    ->account(
        username: 'HEPSIJET_USERNAME',
        password: 'HEPSIJET_PASSWORD',
        companyName: 'SIRKET_ADI',
        companyCode: 'SIRKET_KODU'
    )
    ->payload(
        customerDeliveryNo: 'BARCODE_1001',
        customerOrderId: 'BARCODE_1001',
        totalParcels: '1',
        desi: '1',
        deliveryDateOriginal: '2026-02-07',
        deliveryType: 'RETAIL',
        productCode: 'HX_STD',
        receiverCompanyCustomerId: 'BARCODE_1001_ADDR_1',
        receiverFirstName: 'Ad',
        receiverLastName: 'Soyad',
        receiverPhone1: '905551112233',
        receiverEmail: '[email protected]',
        senderCompanyAddressId: 'SENDER_ADDRESS_ID',
        senderCityName: 'ISTANBUL',
        senderTownName: 'KADIKOY',
        senderDistrictName: 'SARUHAN',
        senderAddressLine1: 'Depo adresi',
        recipientCompanyAddressId: 'RECIPIENT_ADDR_1',
        recipientCityName: 'ISTANBUL',
        recipientTownName: 'KADIKOY',
        recipientDistrictName: '',
        recipientAddressLine1: 'Musteri adresi',
        recipientPerson: 'Ad Soyad',
        recipientPersonPhone1: '905551112233',
        countryName: 'Turkiye',
        deliverySlotOriginal: '0',
        extra: [] // kapida odeme gibi ek alanlar
    )
    ->test(false)
    ->send();

$takip = MPLogistics::hepsijet()
    ->account(
        username: 'HEPSIJET_USERNAME',
        password: 'HEPSIJET_PASSWORD',
        companyName: 'SIRKET_ADI',
        companyCode: 'SIRKET_KODU'
    )
    ->test(false)
    ->kargoTakip('BARCODE_1001');

$takipLink = MPLogistics::hepsijet()
    ->account(
        username: 'HEPSIJET_USERNAME',
        password: 'HEPSIJET_PASSWORD',
        companyName: 'SIRKET_ADI',
        companyCode: 'SIRKET_KODU'
    )
    ->test(false)
    ->takipLinkOlustur([
        'customerDeliveryNo' => 'BARCODE_1001',
    ]);

$sil = MPLogistics::hepsijet()
    ->account(
        username: 'HEPSIJET_USERNAME',
        password: 'HEPSIJET_PASSWORD',
        companyName: 'SIRKET_ADI',
        companyCode: 'SIRKET_KODU'
    )
    ->test(false)
    ->kargoSil('BARCODE_1001');



use MPYazilim\Logistics\MPLogistics;

$resp = MPLogistics::aras()
    ->account(
        username: 'ARAS_USERNAME',
        password: 'ARAS_PASSWORD',
        customerCode: 'ARAS_CUSTOMER_CODE'
    )
    ->test(false) // true: test, false: canli
    ->payload(
        tradingWaybillNumber: 'REF-1001',
        integrationCode: '1001',
        receiverName: 'Ad Soyad',
        receiverAddress: 'Mahalle Adres Ilce/Il',
        receiverPhone1: '2121111111', // 10 hane sayisal
        receiverCityName: 'ISTANBUL',
        receiverTownName: 'KADIKOY',
        payorTypeCode: 1,
        isWorldWide: 0,
        isCod: 0,
        codAmount: 0,
        codCollectionType: 0,
        barcodeNumber: 'BARCODE_1001'
    )
    ->send();

$takip = MPLogistics::aras()
    ->account(
        username: 'ARAS_USERNAME',
        password: 'ARAS_PASSWORD',
        customerCode: 'ARAS_CUSTOMER_CODE'
    )
    ->test(false)
    ->kargoTakip((string) $siparisId);

$sil = MPLogistics::aras()
    ->account(
        username: 'ARAS_USERNAME',
        password: 'ARAS_PASSWORD',
        customerCode: 'ARAS_CUSTOMER_CODE'
    )
    ->test(false)
    ->barkodSil((string) $siparisId);

$respRaw = MPLogistics::aras()
    ->account(
        username: 'ARAS_USERNAME',
        password: 'ARAS_PASSWORD',
        customerCode: 'ARAS_CUSTOMER_CODE'
    )
    ->test(false)
    ->payloadRaw([
        'TradingWaybillNumber' => 'REF-1002',
        'IntegrationCode' => '1002',
        'ReceiverName' => 'Ad Soyad',
        'ReceiverAddress' => 'Mahalle Adres Ilce/Il',
        'ReceiverPhone1' => '2121111111',
        'ReceiverCityName' => 'ISTANBUL',
        'ReceiverTownName' => 'KADIKOY',
        'PayorTypeCode' => 1,
        'IsWorldWide' => 0,
        'IsCod' => 0,
        'PieceCount' => 2,
        'PieceDetails' => [
            'PieceDetail' => [
                ['BarcodeNumber' => 'BARCODE_1002_1', 'Weight' => '1', 'VolumetricWeight' => '1'],
                ['BarcodeNumber' => 'BARCODE_1002_2', 'Weight' => '1', 'VolumetricWeight' => '1'],
            ],
        ],
    ])
    ->send();

$returnResp = MPLogistics::aras()
    ->account(
        username: 'mporder',
        password: 'ARAS_MPORDER_PASSWORD',
        customerCode: 'ARAS_CUSTOMER_CODE'
    )
    ->test(false)
    ->returnPayload(
        configurationId: 'D564FFCA455BBC46BAE926EA74B15032',
        integrationCode: '123456789',
        collectionType: 1,
        payorType: 2,
        mainServiceCode: 'STNK',
        pieceCount: 1,
        receiverAddressInfo: [
            'Address' => 'Aşağı Dudullu mah şahinler',
            'AddressId' => '1CDABE4834FCC4448D38AC33F08F7849',
            'CityName' => 'ISTANBUL',
            'MobilePhone' => '05555555555',
            'Name' => 'Gokhan YILMAZ',
            'PhoneNumber' => '02155555555',
            'TaxNumber' => '123456',
            'TownName' => 'BEYKOZ',
        ],
        senderAddressInfo: [
            'Address' => 'Aşağı Dudullu mah Sok No:3/6',
            'AddressId' => '',
            'CityName' => 'ISTANBUL',
            'Name' => 'GONDERICI ADI',
            'PhoneNumber' => '05324444444',
            'TaxNumber' => '90060406218',
            'TownName' => 'UMRANIYE',
        ],
        tradingWaybillNumber: '3792249',
        volume: 1,
        weight: 1,
        codeExpireDate: '2023-09-16T02:36:50',
        extServiceCodeList: ['AT']
    )
    ->return();



use MPYazilim\Logistics\MPLogistics;

$resp = MPLogistics::ups()
    ->account(
        customerNumber: 'UPS_CUSTOMER_NUMBER',
        username: 'UPS_USERNAME',
        password: 'UPS_PASSWORD'
    )
    ->payload(
        shipperAccountNumber: $customer,
        shipperName: 'Firma Adi',
        shipperAddress: 'Gonderici adresi',
        shipperCityCode: 51,
        shipperAreaCode: 701,
        consigneeName: "{$adres->isim} {$adres->soyisim}",
        consigneeContactName: "{$adres->isim} {$adres->soyisim}",
        consigneeAddress: "{$adres->mahalle} {$adres->adres} {$adres->ilce}/{$adres->il}",
        consigneeCityCode: $ilCode,
        consigneeAreaCode: $ilceCode,
        consigneePhoneNumber: $telefon,
        consigneeMobilePhoneNumber: $telefon,
        packageType: 'D',
        serviceLevel: 3,
        paymentType: 2,
        idControlFlag: 0,
        phonePrealertFlag: 0,
        smsToShipper: 0,
        smsToConsignee: 1,
        insuranceValue: 0,
        insuranceValueCurrency: 'TL',
        numberOfPackages: 1,
        descriptionOfGoods: '0.5',
        length: 0.5,
        height: 0.5,
        width: 0.5,
        valueOfGoods: $siparisTutari,
        valueOfGoodsCurrency: 'TL',
        valueOfGoodsPaymentType: $odemeSekli
    )
    ->send();

$takip = MPLogistics::ups()
    ->account(
        customerNumber: 'UPS_CUSTOMER_NUMBER',
        username: 'UPS_USERNAME',
        password: 'UPS_PASSWORD'
    )
    ->kargoTakip('1Z999AA1234567890');