{"id":29273400,"url":"https://github.com/wtx-labs/symfonia-erp-webapi-client-java","last_synced_at":"2025-07-05T02:32:11.528Z","repository":{"id":298306800,"uuid":"999504153","full_name":"wtx-labs/symfonia-erp-webapi-client-java","owner":"wtx-labs","description":"Klient WebAPI systemu Symfonia ERP umożliwia szybką i łatwą integrację z aplikacjami wykorzystującymi język Java.","archived":false,"fork":false,"pushed_at":"2025-06-23T09:32:40.000Z","size":234,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-23T10:32:20.529Z","etag":null,"topics":["api","api-client","api-clients","erp","integration","rest","rest-api","symfonia","symfonia-erp","symfonia-handel","symfonia-webapi","system-integration","webapi"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wtx-labs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-10T10:55:42.000Z","updated_at":"2025-06-23T09:32:43.000Z","dependencies_parsed_at":null,"dependency_job_id":"82d2815e-1b06-4e4e-9ebd-a0e816fdbbc4","html_url":"https://github.com/wtx-labs/symfonia-erp-webapi-client-java","commit_stats":null,"previous_names":["wtx-labs/symfonia-erp-webapi-client-java"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/wtx-labs/symfonia-erp-webapi-client-java","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wtx-labs%2Fsymfonia-erp-webapi-client-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wtx-labs%2Fsymfonia-erp-webapi-client-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wtx-labs%2Fsymfonia-erp-webapi-client-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wtx-labs%2Fsymfonia-erp-webapi-client-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wtx-labs","download_url":"https://codeload.github.com/wtx-labs/symfonia-erp-webapi-client-java/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wtx-labs%2Fsymfonia-erp-webapi-client-java/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263671746,"owners_count":23494027,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","api-client","api-clients","erp","integration","rest","rest-api","symfonia","symfonia-erp","symfonia-handel","symfonia-webapi","system-integration","webapi"],"created_at":"2025-07-05T02:30:35.100Z","updated_at":"2025-07-05T02:32:11.512Z","avatar_url":"https://github.com/wtx-labs.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Klient Symfonia ERP WebAPI dla aplikacji Java\n### Symfonia ERP WebAPI client for Java\n***\n[![Licencja: MIT](https://img.shields.io/badge/Licencja-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Wersja Java](https://img.shields.io/badge/Java-17%2B-blue)](https://www.java.com)\n\nLekka biblioteka kliencka w języku Java do integracji z Symfonia WebAPI. Stworzona dla programistów Java, którzy potrzebują zintegrować swoje aplikacje z API systemu Symfonia ERP. 🚀\n\nTen klient API zapewnia interfejsy Java dla Symfonia WebAPI, umożliwiając płynne zarządzanie:\n- Towarami i stanami magazynowymi\n- Kontrahentami i zamówieniami\n- Dokumentami sprzedaży\n- Operacjami systemowymi poprzez API\n\n## ✨ Dlaczego warto wybrać tego klienta?\n\n- 💡 **Typowane interfejsy Java** – w pełni typowane interfejsy dla endpointów Symfonia WebAPI\n- 🛡️ **Uwierzytelnianie sesyjne** – bezpieczny dostęp do API Symfonii\n- 📚 **Przejrzysta dokumentacja** – kompleksowe przykłady integracji w Javie\n- 🚀 **Nowoczesne wsparcie Java** – kompatybilność z Java 17 i nowszymi wersjami\n\n## 🎯 Zaimplementowane funkcje\n\n- ✅ API systemowe\n  - Endpoint ping do sprawdzenia statusu systemu\n  - Informacje o modułach\n  - Aktywne instancje HMF\n- ✅ API sesji\n  - Otwieranie nowej sesji\n  - Pobieranie informacji o sesji\n- ✅ API kontrahentów  \n  - Lista/wyszukiwanie kontrahentów\n  - Pobieranie szczegółów kontrahenta po ID, kodzie lub NIP\n- ✅ API towarów\n  - Lista/wyszukiwanie towarów\n  - Pobieranie szczegółów towaru po ID lub kodzie kreskowym\n  - Filtrowanie towarów przy użyciu kryteriów SQL\n  - Pobieranie wymiarów towaru\n- ✅ API cen towarów\n  - Pobieranie cen zamówień\n  - Obliczanie cen na podstawie kryteriów\n- ✅ API stanów magazynowych\n  - Pobieranie wszystkich stanów magazynowych\n  - Pobieranie stanów magazynowych dla towaru\n- ✅ API zamówień\n  - Pobieranie szczegółów zamówienia\n  - Pobieranie faktur dla zamówienia\n- ✅ API wystawiania zamówień\n  - Tworzenie nowych zamówień\n- ✅ API sprzedaży\n  - Pobieranie dokumentów sprzedaży\n  - Filtrowanie sprzedaży według zakresu dat i nabywcy\n\n## 🚨 Status projektu\n\n\u003e ⚠️ **Uwaga: To jest wczesna wersja rozwojowa!**\n\u003e  \n\u003e Aktywnie implementujemy kolejne funkcje Symfonia ERP WebAPI.\n\u003e Zapraszamy do współpracy i zgłaszania uwag na GitHubie!\n\n## 📦 Informacje o wersji\n\n- **Aktualna wersja**: `0.1.0`\n- **Wymagana wersja Java**: Java 17+\n\n## 🔓 Licencja\n\n**Licencja MIT**\n\nNiniejszym udziela się zgody na bezpłatne korzystanie z tego oprogramowania i powiązanych plików dokumentacji (\"Oprogramowanie\"), do korzystania z Oprogramowania bez ograniczeń, w tym bez ograniczeń praw do używania, kopiowania, modyfikowania, łączenia, publikowania, dystrybuowania, sublicencjonowania i/lub sprzedaży kopii Oprogramowania.\n\nJedynym wymogiem jest zachowanie oryginalnych informacji o autorze w kodzie źródłowym i dokumentacji.\n\n## 🚀 Szybki start\n\n### 1️⃣ Instalacja\n\nSklonuj i zbuduj bibliotekę ze źródeł:\n\n```sh\ngit clone https://github.com/wtx-labs/symfonia-erp-webapi-client-java.git\ncd symfonia-erp-webapi-client-java\nmvn clean install\n```\n\nNastępnie dodaj zbudowany artefakt do swojego projektu:\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003epl.wtx.symfonia\u003c/groupId\u003e\n    \u003cartifactId\u003esymfonia-erp-webapi-client\u003c/artifactId\u003e\n    \u003cversion\u003e0.1.0\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n### 2️⃣ Przykład integracji w Javie\n\nOto jak używać klienta Symfonia ERP WebAPI:\n\n```java\npackage pl.wtx.symfonia;\n\nimport pl.wtx.symfonia.api.client.SystemApi;\nimport pl.wtx.symfonia.api.client.invoker.ApiException;\nimport pl.wtx.symfonia.api.client.model.PingResponse;\n\npublic class SymfoniaWebApiClientUsageDemo {\n\n    // TODO: Set your Symfonia ERP WebAPI base path!\n    private static final String API_BASE_PATH = \"http://127.0.0.1:9000/api\";\n\n    public static void main(String[] args) {\n\n        System.out.println(\"\u003e\u003e\u003e Start running the SymfoniaWebApiClientUsageDemo...\");\n\n        // Use SymfoniaWebApiClient(true) if you need to log API communication messages.\n        SymfoniaWebApiClient apiClient = new SymfoniaWebApiClient();\n\n        apiClient.setBasePath(API_BASE_PATH);\n\n        // TODO: If you need to invoke an API that requires authorization, provide a valid session token as shown below:\n        // apiClient.addDefaultHeader(\"Authorization\", \"Session 2ab29954-ca2d-4c6b-873b-9b136e892d7d\");\n\n        // The System API does not require authorization, so there is no need to provide a session token in the Authorization header.\n        SystemApi systemApi = new SystemApi(apiClient);\n\n        try {\n\n            PingResponse pingResponse = systemApi.pingSymfoniaApi();\n\n            System.out.println(\"Number of open sessions: \" + pingResponse.getOpenSessionsNumber());\n\n        } catch (ApiException e) {\n\n            System.err.println(\"Error occurred during API call: \" + e);\n\n        }\n\n        System.out.println(\"\u003c\u003c\u003c The SymfoniaWebApiClientUsageDemo has been finished.\");\n\n    }\n\n}\n```\n\n## 📚 Dokumentacja API\n\nKlient udostępnia następujące główne interfejsy API:\n\n### API systemowe\n- `pingSymfoniaApi()` - Sprawdzenie statusu systemu i pobranie informacji o modułach\n\n### API sesji\n- `openNewSession(deviceName)` - Otwarcie nowej sesji\n- `getSessionInformation()` - Pobranie szczegółów bieżącej sesji\n\n### API kontrahentów\n- `getContractors(id, code, nip)` - Pobranie informacji o kontrahencie\n\n### API towarów\n- `getProducts(id, barcode)` - Pobranie informacji o towarze\n- `getProductsByFilterSql(productCriteriaFilter)` - Filtrowanie towarów przy użyciu kryteriów SQL\n- `getProductDimensions(productId)` - Pobranie wymiarów towaru\n\n### API cen towarów\n- `getOrderPrices(priceOrderCriteria)` - Obliczanie cen zamówień\n\n### API stanów magazynowych\n- `getInventoryStates()` - Pobranie wszystkich stanów magazynowych\n- `getInventoryStatesByProduct(id, code)` - Pobranie stanów magazynowych dla towaru\n\n### API zamówień\n- `getOrder(number)` - Pobranie szczegółów zamówienia\n- `getInvoicesForOrder(orderNumber)` - Pobranie faktur dla zamówienia\n\n### API wystawiania zamówień\n- `addNewOrdersIssue(orderIssue, issue)` - Utworzenie nowego zamówienia\n\n### API sprzedaży\n- `getSaleDocument(id, number)` - Pobranie dokumentu sprzedaży\n- `getSalesByBuyerAndDateRange(buyerId, dateFrom, dateTo)` - Filtrowanie dokumentów sprzedaży\n\n## 🤝 Współpraca\n\n- ✨ Sprawdź nasze [GitHub Issues](https://github.com/wtx-labs/symfonia-erp-webapi-client-java/issues) po najnowsze aktualizacje\n\n- 💡 Masz sugestie? Otwórz zgłoszenie lub dołącz do projektu\n\n- 🌟 Oznacz to repozytorium gwiazdką, jeśli uważasz je za pomocne\n\n## 📝 Licencja\n\nTen projekt jest udostępniany na licencji MIT - szczegóły znajdują się w pliku [LICENSE](LICENSE). \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwtx-labs%2Fsymfonia-erp-webapi-client-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwtx-labs%2Fsymfonia-erp-webapi-client-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwtx-labs%2Fsymfonia-erp-webapi-client-java/lists"}