Wymagania SAP B1

Wersja SAP Business One

Minimalna wersja: SAP Business One 10.0 FP2308 (Feature Pack 2308) lub nowsza.

Wymagany jest Service Layer v2 — starsze wersje SAP B1 używają Service Layer v1, który nie obsługuje wszystkich potrzebnych endpointów.

Sprawdź wersję Service Layer:

GET https://sapserver:50000/b1s/v1/Info

Obsługiwane bazy danych

Baza danych	Wsparcie	Uwagi
SAP HANA	✓	Typ źródła danych: `SqlHana`
Microsoft SQL Server	✓	Typ źródła danych: `SqlMssql`

Typ bazy wpływa na składnię zapytań SQL w profilach mapowania. Profile są przenośne między klientami korzystającymi z tego samego typu bazy danych.

UDO i UDF — obiekty użytkownika

BizFlow NH wymaga utworzenia w SAP zestawu tabel użytkownika (UDT), pól (UDF) i obiektów (UDO). Instalacja nie jest automatyczna — wymaga świadomej decyzji konsultanta.

Procedura instalacji

Zaloguj się do dashboardu BizFlow NH kontem serwisowym (rola service lub super_admin)
Przejdź do Panel serwisowy (ikona klucza w sidebar)
Otwórz zakładkę SAP Setup
Na liście zobaczysz wymagane UDT, UDF i UDO wraz z ich aktualnym stanem zainstalowania
Przejrzyj listę i sprawdź, które elementy wymagają instalacji

Kliknij Install All Missing aby zainstalować brakujące elementy
Zweryfikuj że wszystkie pozycje na liście mają status ✓ (zainstalowane)

User-Defined Tables (UDT)

Tabela	Typ	Opis
`@BCD_KSEF_DATA`	Document	Dane zwrotne KSeF (numer, hash, status, UPO, QR)
`@BCD_EVENTS`	Document	Kolejka zdarzeń integracji (polling trigger)

User-Defined Fields (UDF) na `@BCD_KSEF_DATA`

Pole	Typ	Opis
`U_ObjType`	Tekst (10)	Typ dokumentu SAP (13=OINV, 165=OCSI, 14=ORIN, 203=ODPI)
`U_DocEntry`	Tekst (20)	DocEntry dokumentu źródłowego w SAP
`U_KSeF_Number`	Tekst (100)	Numer przydzielony przez KSeF
`U_KSeF_Hash`	Tekst (254)	SHA-256 hash wysłanego XML
`U_KSeF_IssueDate`	Data	Data wystawienia faktury
`U_KSeF_Status`	Tekst (1)	Status: S=Sent, A=Accepted, E=Error
`U_KSeF_Err`	Tekst (254)	Komunikat błędu (jeśli Status=E)
`U_UPO_Xml`	Memo	Urzędowe Poświadczenie Odbioru (XML)
`U_QR_Code`	Tekst (254)	Dane kodu QR weryfikacyjnego
`U_SendMode`	Tekst (10)	Tryb wysyłki: Online lub Offline

User-Defined Fields (UDF) na `@BCD_EVENTS`

Pole	Typ	Opis
`U_object_type`	Tekst (20)	Typ obiektu + sufiks (np. `13_KSEF20`)
`U_transaction_type`	Tekst (1)	Typ transakcji: A=Add, U=Update
`U_num_of_cols_in_key`	Numeryczny	Liczba kolumn klucza
`U_list_of_key_cols_tab_del`	Tekst (254)	Nazwy kolumn klucza
`U_list_of_cols_val_tab_del`	Tekst (254)	Wartości klucza (DocEntry)
`U_database`	Tekst (254)	Nazwa bazy SAP

User-Defined Field (UDF) na dokumentach handlowych

Na tabeli ORDR (SAP propaguje automatycznie na OINV, OCSI, ODPI i inne dokumenty marketingowe):

Pole	Typ	Opis
`U_BCD_KSEF_COMMENTS`	Tekst (254)	Informacje o statusie KSeF (błędy, ostrzeżenia)

User-Defined Objects (UDO)

UDO	Tabela	Opis
`BCD_KSEF_DATA`	`@BCD_KSEF_DATA`	Odczyt/zapis danych KSeF przez Service Layer (CanFind=YES)
`BCD_EVENTS`	`@BCD_EVENTS`	Kolejka zdarzeń do pollingu (CanFind=YES)

Service Layer

Service Layer musi:

Być uruchomiony — sprawdź status usługi na serwerze SAP
Być dostępny sieciowo — z serwera BizFlow NH musi być możliwe połączenie na port Service Layer (domyślnie 50000 HTTPS lub 50001 HTTP)
Obsługiwać wystarczającą liczbę sesji — BizFlow NH utrzymuje pulę połączeń, zalecane minimum 10 sesji równoległych

Konfiguracja Service Layer

Plik konfiguracyjny: b1s.conf (na serwerze SAP)

Zalecane ustawienia:

SessionTimeout = 30
MaxSessionsPerUser = 10
MaxSessions = 100

Uprawnienia użytkownika

Użytkownik integracyjny potrzebuje dostępu do:

Moduł	Uprawnienia	Powód
Faktury sprzedaży (OINV)	Odczyt/Zapis	Odczyt danych, zapis statusów KSeF
Faktury korygujące (OCSI)	Odczyt/Zapis	j.w.
Faktury zaliczkowe (ODPI)	Odczyt/Zapis	j.w.
Partnerzy biznesowi	Odczyt	Dane nabywcy (NIP, adres)
UDO Management	Pełen	Tworzenie i zarządzanie obiektami BCD_*
Company Info	Odczyt	Dane sprzedawcy (NIP, adres firmy)