PHPackages alperragib/ticimax-php-service - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. alperragib/ticimax-php-service ActiveLibrary[API Development](/categories/api) alperragib/ticimax-php-service ============================== A PHP library for integrating with the Ticimax SOAP API. v1.2.0(2mo ago)0161[1 PRs](https://github.com/alperragib/TicimaxPhpServiceProject/pulls)MITPHPPHP >=7.4 Since Aug 4Pushed 2mo agoCompare [ Source](https://github.com/alperragib/TicimaxPhpServiceProject)[ Packagist](https://packagist.org/packages/alperragib/ticimax-php-service)[ RSS](/packages/alperragib-ticimax-php-service/feed)WikiDiscussions main Synced today READMEChangelogDependenciesVersions (3)Used By (0) Ticimax PHP SDK =============== [](#ticimax-php-sdk) A modern PHP SDK for interacting with Ticimax E-commerce Web Services. Built with modern PHP practices, strict typing, and clean architecture. Features -------- [](#features) - 🚀 Modern PHP 7.4+ with strict typing - 🎯 PSR-4 autoloading compliant - 🔄 Comprehensive API service coverage - 🛡️ Robust error handling and responses - 📦 Consistent model structure - 🔧 Easy configuration and setup Installation ------------ [](#installation) ``` composer require alperragib/ticimax-php-service ``` Quick Start ----------- [](#quick-start) ``` use AlperRagib\Ticimax\Ticimax; // Initialize the client $ticimax = new Ticimax('https://your-store.com', 'your-api-key'); // Get product service $productService = $ticimax->productService(); // Fetch products with filters $filters = [ 'Aktif' => 1, // -1: no filter, 0: false, 1: true 'Firsat' => -1, // -1: no filter, 0: false, 1: true 'Indirimli' => -1, // -1: no filter, 0: false, 1: true 'Vitrin' => -1, // -1: no filter, 0: false, 1: true 'KategoriID' => 0, // 0: no filter 'MarkaID' => 0, // 0: no filter 'UrunKartiID' => 0, // 0: no filter 'ToplamStokAdediBas' => null, // Starting stock amount (double) 'ToplamStokAdediSon' => null, // Ending stock amount (double) 'TedarikciID' => 0, // 0: no filter 'Dil' => 'tr', ]; $pagination = [ 'BaslangicIndex' => 0, 'KayitSayisi' => 10, 'KayitSayisinaGoreGetir' => true, 'SiralamaDegeri' => 'Sira', 'SiralamaYonu' => 'ASC', ]; $response = $productService->getProducts($filters, $pagination); if ($response->isSuccess()) { foreach ($response->data as $product) { echo ( ($product->UrunAdi ?? '[No UrunAdi]') . ' (ID: ' . ($product->ID ?? '[No ID]') . ', ToplamStokAdedi: ' . ($product->ToplamStokAdedi ?? '[No ToplamStokAdedi]') . ")\n" ); } } ``` Available Services ------------------ [](#available-services) - 🛍️ Products (`ProductService`) - Product management - Variations - Favorite products - 📂 Categories (`CategoryService`) - 🏢 Brands (`BrandService`) - 📦 Orders (`OrderService`) - 👥 Users (`UserService`) - 📍 Locations (`LocationService`) - 🏪 Suppliers (`SupplierService`) - 📋 Menus (`MenuService`) Detailed Usage -------------- [](#detailed-usage) ### User Operations [](#user-operations) ``` // User authentication $userService = $ticimax->userService(); $loginResponse = $userService->login('user@example.com', 'password'); ``` ### Order Operations [](#order-operations) The `OrderService` covers the order lifecycle methods that Ticimax's `SiparisServis.svc` exposes. Note that Ticimax does **not** provide a generic "update order" method — once an order is created you can mutate its **status**, its **invoice number**, its **cargo tracking info**, and the **integration-transferred flag**, but not its line items, addresses, or totals. For those, use Ticimax's admin panel. ``` use AlperRagib\Ticimax\Service\Order\OrderStatus; use AlperRagib\Ticimax\Service\Order\PaymentStatus; use AlperRagib\Ticimax\Service\Order\PaymentType; $orderService = $ticimax->orderService(); // 1) Create an order with payment marked as "awaiting approval" $created = $orderService->createOrder([ /* ... other fields ... */ 'Odeme' => [ 'OdemeDurumu' => PaymentStatus::ONAY_BEKLIYOR, // 0 'OdemeTipi' => PaymentType::HAVALE, // 1 'OdemeSecenekID' => 1, 'TaksitSayisi' => 1, 'Tarih' => date('c'), 'Tutar' => 100.00, ], ]); $orderId = (int) $created->data->ID; // 2) Move the order into "Ödeme bekliyor" so the customer/back office sees it $orderService->setOrderStatus($orderId, OrderStatus::ODEME_BEKLIYOR); // 3) When the payment provider (PayTR / iyzico) confirms the payment via its // notify webhook, flip BOTH the order status AND the payment record: $orderService->setOrderStatus( $orderId, OrderStatus::ONAYLANDI, '', // optional cargo tracking number true // notify the customer by email ); $paymentId = $orderService->getOrderPaymentId($orderId); if ($paymentId !== null) { $orderService->setOrderPaymentStatus($orderId, $paymentId, PaymentStatus::ONAYLANDI); } // Cargo / fulfillment shortcuts $orderService->saveCargoTrackingNumber($orderId, '4561562545', '', 'https://carrier.example/track/4561562545'); $orderService->setOrderShipped($orderId); // OrderStatus::KARGOYA_VERILDI $orderService->setOrderDelivered($orderId); // OrderStatus::TESLIM_EDILDI $orderService->setInvoiceNumber($orderId, 'FTR-2025-0001'); ``` #### `OrderService` methods [](#orderservice-methods) MethodTicimax SOAP callWhat it does`getOrders($filters, $pagination)``SelectSiparis`List orders.`createOrder($order)``SaveSiparis`Create a new order.`setOrderStatus($id, $status, $kargoTakipNo = '', $notifyByMail = false)``SetSiparisDurum`Change the order's status. Use the `OrderStatus::*` constants.`setOrderPaymentStatus($id, $odemeId, $status, $notifyByMail = false)``SetSiparisOdemeDurum`Change a payment record's status (e.g. on PayTR / iyzico notify). Use `PaymentStatus::*`.`getOrderPaymentId($id)``SelectSiparis`Helper: look up `WebSiparisOdeme.ID` for an order — needed for `setOrderPaymentStatus`.`setOrderShipped($id)``SetSiparisKargoyaVerildi`Shortcut for the "Kargoya verildi" state.`setOrderDelivered($id)``SetSiparisTeslimEdildi`Shortcut for the "Teslim edildi" state.`setOrderTransferred($id)``SetSiparisAktarildi`Mark the order as transferred to an external system.`unsetOrderTransferred($id)``SetSiparisAktarildiIptal`Cancel the "transferred" flag.`setInvoiceNumber($id, $invoiceNo)``SetFaturaNo`Attach an invoice number to the order.`saveCargoTrackingNumber($id, $trackingNo, ...)``SaveKargoTakipNo`Save / update the cargo tracking number.#### Enum constants [](#enum-constants) The `AlperRagib\Ticimax\Service\Order\OrderStatus`, `PaymentStatus`, and `PaymentType` classes expose the integer values that Ticimax expects: **`OrderStatus`** integer constants. Pass them straight to `setOrderStatus`; the service converts them to the PascalCase string the WSDL's `WebSiparisDurumlari`enum expects (e.g. `ODEME_BEKLIYOR` → `"OdemeBekliyor"`). You can also pass the PascalCase string directly if you prefer. ConstantValueMeaning`ON_SIPARIS`0Ön sipariş`ONAY_BEKLIYOR`1Onay bekliyor`ONAYLANDI`2Onaylandı`ODEME_BEKLIYOR`3Ödeme bekliyor`PAKETLENIYOR`4Paketleniyor`TEDARIK_EDILIYOR`5Tedarik ediliyor`KARGOYA_VERILDI`6Kargoya verildi`TESLIM_EDILDI`7Teslim edildi`IPTAL`8İptal`IADE`9İade`SILINMIS`10Silinmiş`IADE_TALEP_ALINDI`11İade talebi alındı`IADE_ULASTI_ODEME`12İade ulaştı, ödeme yapılacak`IADE_ODEME_YAPILDI`13İade ödemesi yapıldı`TESLIM_ONCESI_IPTAL`14Teslimat öncesi iptal`IPTAL_TALEBI`15İptal talebi`KISMI_IADE_TALEBI`16Kısmi iade talebi`KISMI_IADE_YAPILDI`17Kısmi iade yapıldı`TESLIM_EDILEMEDI`18Teslim edilemedi**`PaymentStatus`** integer constants. Used both in `Odeme.OdemeDurumu` when creating an order, and as the `$status` argument to `setOrderPaymentStatus()`(the service translates them to the PascalCase strings `WebOdemeDurumlari`expects, e.g. `ONAYLANDI` → `"Onaylandi"`): ConstantValueMeaning`ONAY_BEKLIYOR`0Onay bekliyor`ONAYLANDI`1Onaylandı`HATALI`2Hatalı`IADE_EDILMIS`3İade edilmiş`IPTAL_EDILMIS`4İptal edilmiş**`PaymentType`** (used in `Odeme.OdemeTipi`): `KREDI_KARTI=0`, `HAVALE=1`, `KAPIDA_ODEME_NAKIT=2`, `KAPIDA_ODEME_KK=3`, `MOBIL_ODEME=4`, `BKM_EXPRESS=5`, `PAYPAL=6`, `CARI=7`, `MAIL_ORDER=8`, `IPARA=9`, `NAKIT=10`, `PAYUONECLICK=11`, `CARI_KREDI=12`, `GARANTIPAY=13`, `PAYU_BKMEXPRESS=14`, `NESTPAY=15`, `PAYCELL=16`, `IYZIPAY=17`, `HOPI=18`, `PAYBYME=19`, `HEDIYE_CEKI=20`, `PAYGURUMOBIL=21`, `PAYNET=22`, `TELR=23`, `COMPAY=24`, `PAYTR=25`, `MAXIMUM_MOBIL=26`, `MAGAZADA_ODE=27`. > **Note on payment vs. order status.** Ticimax keeps two separate fields: the **order status** (`OrderStatus`) drives the order's lifecycle (Ödeme bekliyor → Onaylandı → Kargoya verildi → …), while **payment status**(`PaymentStatus`) describes the WebSiparisOdeme row's own state. PayTR / iyzico notify callbacks should typically flip BOTH: `setOrderStatus(..., OrderStatus::ONAYLANDI)` so the order moves out of "Ödeme bekliyor", **and** `setOrderPaymentStatus(..., PaymentStatus::ONAYLANDI)`so the admin panel shows the payment row as captured. Setting only the order status leaves the payment record looking unpaid. Error Handling -------------- [](#error-handling) The SDK uses a consistent response structure through the `ApiResponse` class: ``` if ($response->isSuccess()) { $data = $response->getData(); } else { echo "Error: " . $response->getMessage(); } ``` Configuration ------------- [](#configuration) Create a configuration file: ``` // config.php define('TICIMAX_MAIN_DOMAIN', 'https://your-store.com'); define('TICIMAX_API_KEY', 'your-api-key'); ``` License ------- [](#license) This project is licensed under the MIT License - see the LICENSE file for details. Support ------- [](#support) - Check the [examples](example/) directory for more usage examples - Submit issues through GitHub - Follow PSR-12 coding standards when contributing Requirements ------------ [](#requirements) - PHP 7.4 or higher - SOAP extension - JSON extension - Composer ### Health Score 36 — LowBetter than 79% of packages Maintenance87 Actively maintained with recent releases Popularity7 Limited adoption so far Community7 Small or concentrated contributor base Maturity37 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~266 days Total 2 Last Release 66d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/45243541?v=4)[Alper Ragıb](/maintainers/alperragib)[@alperragib](https://github.com/alperragib) --- Top Contributors [![alperragib](https://avatars.githubusercontent.com/u/45243541?v=4)](https://github.com/alperragib "alperragib (15 commits)") ### Embed Badge ![Health badge](/badges/alperragib-ticimax-php-service/health.svg) ``` [![Health](https://phpackages.com/badges/alperragib-ticimax-php-service/health.svg)](https://phpackages.com/packages/alperragib-ticimax-php-service) ``` ### Alternatives [exsyst/swagger A php library to manipulate Swagger specifications 35916.4M7](/packages/exsyst-swagger)[hubspot/api-client Hubspot API client 24016.2M20](/packages/hubspot-api-client)[pocketmine/bedrock-protocol An implementation of the Minecraft: Bedrock Edition protocol in PHP 172445.0k15](/packages/pocketmine-bedrock-protocol)[botman/driver-telegram Telegram driver for BotMan 93459.5k6](/packages/botman-driver-telegram) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)