Download the PHP package tcgunel/omniship-surat without Composer

On this page you can find all versions of the php package tcgunel/omniship-surat. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of tcgunel/omniship-surat

Informations about the package omniship-surat

Omniship Surat Kargo

Surat Kargo carrier driver for the Omniship shipping library.

Uses the unified SOAP API at webservices.suratkargo.com.tr/services.asmx with the newer GonderiyiKargoyaGonderYeniSiparisBarkodOlustur method that returns structured responses with barcode.

Installation

Usage

Initialize

Note: Surat Kargo uses separate passwords for shipment operations (sifre) and tracking queries (webSifre). The web service password is customer-defined at ekargo.suratkargo.com.tr.

Create Shipment

Cash on Delivery (Kapida Odeme)

Track Shipment

Cancel Shipment

API Endpoints

Environment URL
Production https://webservices.suratkargo.com.tr/services.asmx
Test https://prova.suratkargo.com.tr/services.asmx

Legacy Endpoints (from PDF docs, for reference)

Service URL
Gonderi (Prod) http://www.suratkargo.com.tr/GonderiWebServiceGercek/service.asmx
Gonderi (Test) http://www.suratkargo.com.tr/GonderiWebServiceProva/service.asmx
Takip (Prod) http://webservices.suratkargo.com.tr/services.asmx
Takip (Test) https://esatis.suratkargo.com.tr/services.asmx

Credentials

Surat Kargo uses three credentials (unlike most Turkish carriers):

Credential Field Used For Set By
Cari Kodu kullaniciAdi / cariKodu All operations Surat Kargo (10-digit)
Cari Sifresi sifre Shipment creation, cancel Surat Kargo
Web Servis Sifresi webSifre Tracking, reporting Customer (at ekargo portal)

Test Credentials

Field Value
Cari Kodu 1038106246
Cari Sifresi 123456
Web Servis Sifresi 123456.Ff
COD Cari Kodu 1038106247
COD Cari Sifresi 1234567
Test Tracking Codes 123456789, 12v34567g89

SOAP Methods Used

Operation SOAP Method Description
Create Shipment GonderiyiKargoyaGonderYeniSiparisBarkodOlustur Returns structured response with barcode
Track Shipment KargoTakipHareketDetayliV2 Detailed tracking by WebSiparisKodu
Cancel Shipment GonderiGeriCek Cancel with reason (IptalNeden)

Alternative Methods Available

Method Description
GonderiyiKargoyaGonder Legacy create (returns "Tamam" string, no barcode)
GonderiyiKargoyaGonderYeni Newer create (returns string, no barcode)
WebSiparisKodu Track by order code (returns DataSet)
TakipNo Track by Surat's barcode number (returns DataSet)
GonderiSil Delete shipment (different auth: cariKodu + WebPassword)
WebSiparisKodundanKargoTeslimatBilgisi Delivery info (returns TeslimatBilgisiSonuc)

Gonderi Fields

Field Type Required Description
KisiKurum string Yes Recipient name
AliciAdresi string Yes Full address (single field)
Il string Yes City/Province
Ilce string Yes District
TelefonCep string Conditional Mobile phone (required if SMS service)
KargoTuru int Yes 1=Dosya, 2=Mi, 3=Koli
OdemeTipi int Yes 1=Pesin (sender), 2=Ucret Alici (receiver)
Adet int Yes Package count
OzelKargoTakipNo string No Your custom tracking code
BirimDesi string No Volumetric weight per unit
BirimKg string No Weight per unit
KapidanOdemeTahsilatTipi int If COD 1=Nakit, 2=POS
KapidanOdemeTutari string If COD COD amount
IrsaliyeSeriNo string If COD Invoice serial number
IrsaliyeSiraNo string If COD Invoice sequence number
TeslimSekli int No 1=Address delivery, 2=Branch pickup

Notes

Testing

License

MIT

All versions of omniship-surat with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2
tcgunel/omniship-common Version ^0.0.1
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package tcgunel/omniship-surat contains the following files

Loading the files please wait ...