first

2026-07-15 09:03:28 +02:00
parent 4b98f37407
commit fea25d7429
31 changed files with 4906 additions and 30 deletions
@@ -0,0 +1,44 @@
+# Specifika instalace POLSTRIN DESIGN s.r.o.
+
+Zjištěno z `GET /api/system/info` (10. 7. 2026, testovací databáze).
+
+## Základní údaje
+
+- Service Layer: `https://ws.polstrin.cz:50000/b1s/v1`
+- Verze SAP Business One: `1000310` (SAP B1 10.0), session timeout 30 minut
+- Firma: POLSTRIN DESIGN s.r.o., Hradec Králové, DIČ `CZ49283120`
+- Firemní měna `CZK`, systémová měna `EUR`, účtová osnova šablona `U`
+- Průběžné vedení skladu metodou **Moving Average**, výchozí sklad `01.100`
+- Výchozí kódy DPH: prodej `UP21`, nákup `PP21`
+- **Pozor:** dodaný výpis pochází z databáze pojmenované „TEST 10.7.2026 POLSTRIN DESIGN, s.r.o.“ — před produkčním nasazením ověř, že secret `SAP_B1_COMPANY_DB` míří na správnou (produkční) databázi.
+
+## Nainstalované addony a jejich prefixy
+
+Instalace obsahuje rozsáhlé customizace. UDO tabulky jsou v Service Layeru dostupné jako entity sety `U_<prefix>_*` (přes `/api/entities/...`), UDF se stejnými prefixy jsou přidané na standardních objektech (artikly `OITM`, obchodní partneři `OCRD`, všechny marketingové doklady, montážní zakázky `OWOR`, kusovníky `OITT` atd.) a vrací se v běžných odpovědích — stačí je uvést v `$select`.
+
+| Prefix | Oblast |
+|---|---|
+| `ADN_` / `U_ADN_*` | Evidence majetku (karty majetku, odpisy daňové/účetní, pohyby, inventury, ceniny, pronájmy) |
+| `DFX_` / `U_DFX_*` | Intrastat a evidence majetku CZ (hlášení, nomenklatury, číselníky, verze addonu) |
+| `PVT_` / `U_PVT_*` | Intrastat (KN8 kódy, kurzy, statistické kódy, tisková data) |
+| `VCZ_` / `U_VCZ_*` | Versino CZ – lokalizace a výroba: EET, elektronická banka, platební příkazy (KS/SS/VS), QR platba, kontrolní/souhrnné hlášení DPH, kalkulace, plánování výroby (`MPK*`), pracoviště (`MWPL*`), trasování výroby (`MTTRC`), pick listy, tiskové reporty |
+| `B1SYS_` | Systémová CZ lokalizace (EET pole PKP/BKP na dokladech) |
+| `BOE*`, `BOO*`, `BOQUOT`, `BOSETTINGS` | Outlook/Office integrace (sync kalendáře, kontaktů, šablony Word/Excel) |
+| `VYROBNI_PLAN`, `VYROBNI_DAVKA` | Vlastní UDO pro výrobní plánování |
+
+Často užitečná pole na dokladech: `VCZ_5030` (číslo dokladu), `VCZ_7042` (variabilní symbol), `VCZ_6502`/`VCZ_7141` (KS/SS), `VCZ_9522`/`VCZ_9192` (vazba na zakázku odběratele a její řádek), `VCZ_5EE*` (EET), `DFX_*`/`PVT_*` (Intrastat), na artiklu `VCZ_5315/5316/5317` (popisy CZ/EN/RU) a `PVT_KINT` (kód Intrastat).
+
+## Oprávnění SAP uživatele
+
+Aktuální SAP uživatel **nemá oprávnění** číst `UserTablesMD` a `UserObjectsMD` (v `/api/system/info` se vrací `{ "error": "The logged-on user does not have permission..." }`). Data UDO tabulek jsou přesto dostupná přes jejich `U_*` entity sety; pro čtení metadat UDT/UDO je potřeba uživateli doplnit oprávnění v SAP (General → User-Defined Objects/Tables).
+
+## Práce s customizacemi přes API
+
+```http
+GET  /api/entities                          # seznam všech entity setů
+GET  /api/entities/U_VCZ_MKONF?$top=10      # konfigurátor výroby
+GET  /api/entities/U_ADN_MEM/all            # všechny karty majetku
+GET  /api/entities/VYROBNI_PLAN/'001'       # klíč Code (string, default)
+GET  /api/entities/ProductionOrders/123?idType=number
+GET  /api/items/A00001                      # UDF pole jsou součástí odpovědi
+```