PHPackages alex-nzr/bit-umc-sdk - 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. alex-nzr/bit-umc-sdk ActiveLibrary[API Development](/categories/api) alex-nzr/bit-umc-sdk ==================== PHP library for the typical BIT-UMC SOAP API v2.0.0(1mo ago)267MITPHPPHP >=8.1 Since Jan 30Pushed 1mo ago1 watchersCompare [ Source](https://github.com/alex-nzr/bit-umc-php-sdk)[ Packagist](https://packagist.org/packages/alex-nzr/bit-umc-sdk)[ Docs](https://github.com/alex-nzr/bit-umc-php-sdk/)[ RSS](/packages/alex-nzr-bit-umc-sdk/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (6)Dependencies (3)Versions (10)Used By (0) SDK for 1C BIT.UMC ================== [](#sdk-for-1c-bitumc) Requirements ------------ [](#requirements) - PHP >= 8.1 - ext-soap - ext-json - ext-xmlreader Version 2 API ------------- [](#version-2-api) The SDK is built around a single public entry point: `ANZ\\BitUmc\\SDK\\BitUmcClient`. ### Principles [](#principles) - Credentials and access data are passed at runtime. - The SDK does not read `.env`, ini files or databases. - Transport type is selected explicitly through `TransportType`. - SOAP is implemented now. - HTTP transport is reserved in the architecture for the next stage. - SOAP XML responses are parsed through `XMLReader` to reduce peak memory usage on large payloads. - Successful calls return normalized arrays. - Failures throw typed exceptions from `ANZ\\BitUmc\\SDK\\Domain\\Exception`. Usage ----- [](#usage) ``` use ANZ\BitUmc\SDK\BitUmcClient; use ANZ\BitUmc\SDK\Transport\Auth\BasicAuth; use ANZ\BitUmc\SDK\Transport\ConnectionOptions; use ANZ\BitUmc\SDK\Transport\Protocol; use ANZ\BitUmc\SDK\Transport\TransportType; $client = new BitUmcClient( TransportType::SOAP, new ConnectionOptions( protocol: Protocol::HTTP, host: '127.0.0.1:3500', baseName: 'umc', auth: new BasicAuth('1cUser', '1cUserPassword'), apiKey: null, ) ); ``` Available operations -------------------- [](#available-operations) ``` $client->getClinics(); $client->getEmployees(); $client->getNomenclature($clinicUid); $client->getSchedule($scheduleQuery); $client->getAppointmentStatus($appointmentUid); $client->sendReserve($reserveRequest); $client->sendWaitList($waitListRequest); $client->sendAppointment($bookAppointmentRequest); $client->deleteAppointment($appointmentUid); ``` Request DTOs ------------ [](#request-dtos) - `ANZ\\BitUmc\\SDK\\Domain\\Request\\ScheduleQuery` - `ANZ\\BitUmc\\SDK\\Domain\\Request\\ReserveRequest` - `ANZ\\BitUmc\\SDK\\Domain\\Request\\WaitListRequest` - `ANZ\\BitUmc\\SDK\\Domain\\Request\\BookAppointmentRequest` See [examples/index.php](examples/index.php) for a complete example. Returned data ------------- [](#returned-data) ### `getClinics(): array` [](#getclinics-array) ``` [ 'f679444a-22b7-11df-8618-002618dcef2c' => [ 'uid' => 'f679444a-22b7-11df-8618-002618dcef2c', 'name' => 'Центральная клиника', ], '66abf7b4-2ff9-11df-8625-002618dcef2c' => [ 'uid' => '66abf7b4-2ff9-11df-8625-002618dcef2c', 'name' => 'Третий центр', ], ] ``` ### `getEmployees(): array` [](#getemployees-array) ``` [ '2eb1f97b-6a3c-11e9-936d-1856809fe650' => [ 'uid' => '2eb1f97b-6a3c-11e9-936d-1856809fe650', 'name' => 'Юрий', 'surname' => 'Безногов', 'middleName' => 'Сергеевич', 'fullName' => 'Безногов Юрий Сергеевич', 'clinicUid' => 'f679444a-22b7-11df-8618-002618dcef2c', 'photo' => 'base64_encoded_photo', 'description' => 'Краткое описание из 1С', 'rating' => '', 'specialtyName' => 'Офтальмология', 'specialtyUid' => '0j7rhngc0ldqu9gm0lzqvtc70l7qs9c40y8', 'services' => [ '5210c9dc-65a2-11e9-936d-1856809fe650' => [ 'uid' => '5210c9dc-65a2-11e9-936d-1856809fe650', 'personalDuration' => 0, ], ], ], ] ``` ### `getNomenclature(string $clinicUid): array` [](#getnomenclaturestring-clinicuid-array) ``` [ 'a0230570-3ef7-11de-8086-001485c0d477' => [ 'uid' => 'a0230570-3ef7-11de-8086-001485c0d477', 'name' => 'Массаж век', 'typeOfItem' => 'Услуга', 'artNumber' => '', 'price' => '160', 'duration' => 1800, 'measureUnit' => 'мин', 'parent' => '5210c9bf-65a2-11e9-936d-1856809fe650', ], 'a0230571-3ef7-11de-8086-001485c0d477' => [ 'uid' => 'a0230571-3ef7-11de-8086-001485c0d477', 'name' => 'Гель для массажа', 'typeOfItem' => 'Материал', 'artNumber' => '101-55', 'price' => '100', 'duration' => 900, 'measureUnit' => 'мл', 'parent' => '00000000-0000-0000-0000-000000000000', ], ] ``` ### `getSchedule(?ScheduleQuery $query = null): array` [](#getscheduleschedulequery-query--null-array) ``` [ 'f679444a-22b7-11df-8618-002618dcef2c' => [ '0j7rhngc0ldqu9gm0lzqvtc70l7qs9c40y8' => [ 'ac30e13a-3087-11dc-8594-005056c00008' => [ 'specialtyName' => 'Офтальмология', 'employeeName' => 'Барбышева Евгения Петровна', 'durationFrom1C' => '0001-01-01T00:15:00', 'durationInSeconds' => 900, 'timetable' => [ 'freeFormatted' => [ '05-04-2026' => [ [ 'typeOfTimeUid' => '624f2a40-5aa8-4f01-83f4-0f38535364bb', 'date' => '2026-04-05T00:00:00', 'timeBegin' => '2026-04-05T09:00:00', 'timeEnd' => '2026-04-05T09:15:00', 'formattedDate' => '05-04-2026', 'formattedTimeBegin' => '09:00', 'formattedTimeEnd' => '09:15', ], ], ], ], ], ], ], ] ``` ### `getAppointmentStatus(string $appointmentUid): array` [](#getappointmentstatusstring-appointmentuid-array) ``` [ 'statusId' => '6', 'statusTitle' => 'Резерв времени', ] ``` ### `sendReserve(ReserveRequest $request): array` [](#sendreservereserverequest-request-array) ``` [ 'uid' => '432a40a2-2ea3-11f1-9bf7-8fedb1ae9f50', ] ``` ### `sendWaitList(WaitListRequest $request): array` [](#sendwaitlistwaitlistrequest-request-array) ``` [ 'uid' => '432a40ab-2ea3-11f1-9bf7-8fedb1ae9f50', ] ``` ### `sendAppointment(BookAppointmentRequest $request): array` [](#sendappointmentbookappointmentrequest-request-array) ``` [ 'success' => true, ] ``` ### `deleteAppointment(string $appointmentUid): array` [](#deleteappointmentstring-appointmentuid-array) ``` [ 'success' => true, ] ``` Error handling -------------- [](#error-handling) ``` use ANZ\BitUmc\SDK\Domain\Exception\BitUmcException; try { $clinics = $client->getClinics(); } catch (BitUmcException $e) { echo $e->getMessage(); } ``` Tests ----- [](#tests) ### What is covered [](#what-is-covered) Current test suite covers these cases. Unit and fixture-based tests: - endpoint resolution - request mapping for schedule, appointment status and appointment creation - parsing of clinics - parsing of employees and employee services - parsing of nomenclature - parsing of schedule - parsing of common result payloads - parsing of appointment status payloads - SOAP response handling for: - `Ok` - `Error` - plain text error responses - XML responses with `ОписаниеОшибки` Live integration tests: - `getClinics()` - `getEmployees()` - search for `Центральная клиника` - search for doctor `Барбышева` - `getNomenclature()` for the central clinic with lookup of `Первичная консультация офтальмолога` - `sendReserve()` -> `getAppointmentStatus()` -> `deleteAppointment()` - `sendWaitList()` - `sendAppointment()` - negative transport cases: - wrong base name - wrong web-service name ### How unit tests work [](#how-unit-tests-work) Unit tests do not connect to 1C. They work on local fixtures from `tests/Fixtures/soap`. These fixtures are raw XML or raw text responses captured from a real 1C test instance. This means: - unit tests are deterministic and fast - parser behaviour is checked against real responses, not synthetic examples - you do not need any runtime credentials to run unit tests Run unit tests: ``` vendor/bin/phpunit --testsuite unit ``` ### How to refresh fixtures from a real 1C instance [](#how-to-refresh-fixtures-from-a-real-1c-instance) Fixture capture script: - [CaptureSoapFixtures.php](tests/Tools/CaptureSoapFixtures.php) Before running it, set environment variables: - `BIT_UMC_TEST_PROTOCOL` = `HTTP` or `HTTPS` - `BIT_UMC_TEST_HOST` - `BIT_UMC_TEST_BASE_NAME` - `BIT_UMC_TEST_LOGIN` - `BIT_UMC_TEST_PASSWORD` Example PowerShell: ``` $env:BIT_UMC_TEST_PROTOCOL='HTTP' $env:BIT_UMC_TEST_HOST='example.com' $env:BIT_UMC_TEST_BASE_NAME='umc' $env:BIT_UMC_TEST_LOGIN='login' $env:BIT_UMC_TEST_PASSWORD='password' php tests/Tools/CaptureSoapFixtures.php ``` ### How to run integration tests against a real 1C instance [](#how-to-run-integration-tests-against-a-real-1c-instance) Integration tests use live network calls and require env variables. Supported env variables: - `BIT_UMC_RUN_INTEGRATION_TESTS=1` - `BIT_UMC_TEST_PROTOCOL=HTTP` or `HTTPS` - `BIT_UMC_TEST_HOST` - `BIT_UMC_TEST_BASE_NAME` - `BIT_UMC_TEST_LOGIN` - `BIT_UMC_TEST_PASSWORD` Example PowerShell: ``` $env:BIT_UMC_RUN_INTEGRATION_TESTS='1' $env:BIT_UMC_TEST_PROTOCOL='HTTP' $env:BIT_UMC_TEST_HOST='example.com' $env:BIT_UMC_TEST_BASE_NAME='umc' $env:BIT_UMC_TEST_LOGIN='login' $env:BIT_UMC_TEST_PASSWORD='password' vendor/bin/phpunit --testsuite integration ``` Important: - integration tests assume that the target test base contains data similar to the fixtures used when they were written - they are currently oriented on clinic `Центральная клиника`, doctor `Барбышева` and service `Первичная консультация офтальмолога` - on another base those exact entities may not exist, so tests that check for them may fail even if transport and parsing work correctly - generic transport-negative tests can still be reused on any base Transport notes --------------- [](#transport-notes) `ConnectionOptions` already reserves the `apiKey` field for the future HTTP transport. SOAP ignores this field. ### Health Score 45 — FairBetter than 92% of packages Maintenance92 Actively maintained with recent releases Popularity11 Limited adoption so far Community7 Small or concentrated contributor base Maturity60 Established project with proven stability 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 ~144 days Recently: every ~81 days Total 9 Last Release 40d ago Major Versions v0.1.0 → v1.0.02023-12-01 v1.0.6 → v2.0.02026-04-02 PHP version history (2 changes)v0.1.0PHP >=7.4 v1.0.0PHP >=8.1 ### Community Maintainers ![](https://www.gravatar.com/avatar/7981080f0b3a9ebb8daa0ebb1062595d3481db24f8a1f3fdc277acd35c2df256?d=identicon)[alex-nzr](/maintainers/alex-nzr) --- Top Contributors [![alex-nzr](https://avatars.githubusercontent.com/u/53831251?v=4)](https://github.com/alex-nzr "alex-nzr (3 commits)") --- Tags phpapisoapBit-Umc ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/alex-nzr-bit-umc-sdk/health.svg) ``` [![Health](https://phpackages.com/badges/alex-nzr-bit-umc-sdk/health.svg)](https://phpackages.com/packages/alex-nzr-bit-umc-sdk) ``` ### Alternatives [algolia/algoliasearch-client-php API powering the features of Algolia. 69333.0M114](/packages/algolia-algoliasearch-client-php)[theodo-group/llphant LLPhant is a library to help you build Generative AI applications. 1.5k311.5k5](/packages/theodo-group-llphant)[hiddeco/transip The better TransIP API client. 22319.8k2](/packages/hiddeco-transip)[comgate/sdk Comgate PHP SDK 13327.8k](/packages/comgate-sdk)[rubix/server Deploy your Rubix ML models to production with scalable stand-alone inference servers. 632.3k](/packages/rubix-server) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)