PHPackages                             lukeotdr/api-subiekt-gt - 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. lukeotdr/api-subiekt-gt

ActiveProject

lukeotdr/api-subiekt-gt
=======================

Wrapper SubiektGT + SferaGT - PHP REST API

5118228[8 issues](https://github.com/LukeOtdr/api-subiekt-gt/issues)PHP

Since Mar 13Pushed 4y ago10 watchersCompare

[ Source](https://github.com/LukeOtdr/api-subiekt-gt)[ Packagist](https://packagist.org/packages/lukeotdr/api-subiekt-gt)[ RSS](/packages/lukeotdr-api-subiekt-gt/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (1)DependenciesVersions (3)Used By (0)

PHP REST API dla SubiektGT + SferaGT
====================================

[](#php-rest-api-dla-subiektgt--sferagt)

API udostępnia interfejs i zapewnia komunikacje z SubiektGT w następujący sposób:

- tworzenie zamówień od klientów
- tworzenie klientów
- tworzenie towarów
- przetworzenie zamówień klientów na fakturę sprzedaży lub paragon imienny
- pobranie dowolnego dokumentu
- pobranie dowolnego dokumentu w formacie pdf
- pobranie podstawowych danych o kliencie
- pobranie podstawowych danych o towarze oraz jego stanie magazynowym

Wymagania
---------

[](#wymagania)

Aplikacje, które muszą zostać wcześniej zainstalowane na komputerze/serwerze z Windows:

- SubiektGT oraz SferaGT (testowano na 1.50 HF1)
- serwer WWW (testowano na Apache/2.4.27 (Win32))
- php (testowano na wersji 7.1.9)
- zainstalowane biblioteki php: com\_dotnet, sqlsrv

Instalacja
----------

[](#instalacja)

Pobieramy projekt w wersji master/lub stabilnej lub używamy do tego composer-a. Poniższy przykład przedstawia pobranie wersji developerskiej.

```
create-project lukeotdr/api-subiekt-gt  --stability dev

```

Paczkę umieszczamy tak aby serwer www miał możliwość uruchomienia plików PHP z katalogu public lub odpowiednio konfigurujemy serwer [www](http://www). Uruchamiamy konfigurację api poprzez przykładowe poniższe wywołanie:

```
http://192.168.1.1/api-subiekt-gt/public/setup

```

Powyższe wywołanie uruchomi konfigurator api, który pomoże utworzyć plik konfiguracyjny do połączenia ze Sferą GT oraz SQLServer-em. Należy przygotować użytkownika oraz hasło do SQLServera dzięki któremu zostanie nawiązane połączenie z bazą Subiekta. Jeśli była użyta autentykacja windows trzeba utworzyć użytkownika z dostępem do podmiotu. Do testów można użyć danych admina "sa" lecz na produkcji nie zalecane.

Po konfiguracji należy jeszcze przeprowadzić test połączenia podając istniejący numer dokumentu sprzedaży z Subiekta. Np: "PA 13659/12/2017". W odpowiedzi i poprawnego połączenia powinniśmy zobaczyć coś podobnego jak poniżej.

Wysłane rządanie:

```
192.168.1.1/api-subiekt-gt/public/api/document/get
{
    "api_key": "XXXXXXXXXXXXXXXXXXXXXX",
    "data": {
        "doc_ref": "PA 13659/12/2017"
    }
}

```

XXXXXXXXXXXXXXXXXXXXXX - wygenerowane api key.

Odebrana odpowiedź:

```
{
    "state": "success",
    "data": {
        "products": [
            {
                "name": "MUND Skarpety PAMIR r.M czarny",
                "code": "8424752732026",
                "qty": "1.0000",
                "price": "34.9200"
            },
            {
                "name": "ARC'TERYX Woreczek APERTURE CHALK BAG large fiolet",
                "code": "806955782905",
                "qty": "1.0000",
                "price": "62.5700"
            },
            {
                "name": "ARC'TERYX Plecak CIERZO 18 dk basalt",
                "code": "806955927375",
                "qty": "1.0000",
                "price": "175.5200"
            },
            {
                "name": "LIFESYSTEMS Gwizdek ratunkowy SAFETY WHISTLE",
                "code": "5031863022507",
                "qty": "1.0000",
                "price": "27.0600"
            }
        ],
        "fiscal_state": 1,
        "accounting_state": 0,
        "reference": "",
        "comments": "",
        "customer": [],
        "doc_ref": "PA 13659/12/2017",
        "doc_type": "PA",
        "amount": "300.0700",
        "state": 1,
        "date_of_delivery": null,
        "is_exists": true,
        "gt_id": 171417
    }
}

```

Jeśli udało się połączyć z bazą danych to teraz nie pozostaje nic innego jak utworzyć interfejs do komunikacji z api. Rządania do api w powyższym przykładzie wysyłamy na adres:

```
http://192.168.1.1/api-subiekt-gt/public/api/

przykładowe wywołanie:

http://192.168.1.1/api-subiekt-gt/public/api/document/get

```

**UWAGA** - adres "setup-u" należy zabezpieczyć przed nieautoryzowanym dostępem np przez .htaccess dyrektywy allow deny. Można również przkopiować katalog w inne miejsce.

Gdyby zaszła potrzeba użyć IIS-a jako serwera www to rządania bez modułu "rewrite" miałyby postać:

```
http://192.168.1.1/api-subiekt-gt/public/api?c=document/get

```

Dokumentacja API
----------------

[](#dokumentacja-api)

Dokumentacja metod API: [Dokumentacja](https://github.com/LukeOtdr/api-subiekt-gt/wiki)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](https://github.com/LukeOtdr/api-subiekt-gt/blob/devloper/LICENSE) for more information.

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance17

Infrequent updates — may be unmaintained

Popularity26

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 98.8% 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/997aae4debdc76c69140ee05d5643cfb80e5bfeead4fd9543cb68089c9d904aa?d=identicon)[LukeOtdr](/maintainers/LukeOtdr)

---

Top Contributors

[![Lukegpl](https://avatars.githubusercontent.com/u/10967218?v=4)](https://github.com/Lukegpl "Lukegpl (158 commits)")[![naturalGroove](https://avatars.githubusercontent.com/u/59738752?v=4)](https://github.com/naturalGroove "naturalGroove (1 commits)")[![xlawok](https://avatars.githubusercontent.com/u/11177168?v=4)](https://github.com/xlawok "xlawok (1 commits)")

### Embed Badge

![Health badge](/badges/lukeotdr-api-subiekt-gt/health.svg)

```
[![Health](https://phpackages.com/badges/lukeotdr-api-subiekt-gt/health.svg)](https://phpackages.com/packages/lukeotdr-api-subiekt-gt)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
