Wprowadzenie

Czym jest BizFlow NH?

BizFlow NH to platforma integracji KSeF z SAP Business One, zaprojektowana od podstaw z myślą o niezawodności, skalowalności i prostocie wdrożenia.

BizFlow NH został zaprojektowany z naciskiem na:

• Niezawodności — obsługa trybu offline, automatyczne dosyłanie faktur, monitoring
• Elastyczności — konfigurowalny system profili mapowania zamiast sztywnego kodu
• Skalowalności — architektura mikrousługowa z kolejkowaniem wiadomości
• Bezpieczeństwie — szyfrowany magazyn certyfikatów (OpenBao/Vault), RBAC

Edycje

BizFlow NH jest dostępny w trzech edycjach:

Funkcja	Essential	Professional	Enterprise
Wysyłka faktur sprzedaży do KSeF	✓	✓	✓
Odbiór faktur zakupu z KSeF	✓	✓	✓
Profile mapowania SAP → KSeF	✓	✓	✓
Multi-company	✓	✓	✓
Tryb offline z kodami QR	✓	✓	✓
Dashboard (panel webowy)	✓	✓	✓
Faktury kosztowe — mapowanie odwrotne KSeF → SAP	—	✓	✓
JPK — generowanie i wysyłka deklaracji (V7M, CIT, ST, VAT_UE)	—	✓	✓
Operaton BPM — procesy zatwierdzania (akceptacja faktur, eskalacje, SLA)	—	—	✓

Kluczowe funkcje

• Wysyłka i odbiór faktur KSeF — pełna obsługa FA(3), w tym faktury korygujące, zaliczkowe, walutowe
• Profile mapowania — definiują jak dane z SAP B1 przekształcane są na XML KSeF, bez pisania kodu
• Multi-company — jedna instalacja obsługuje wiele spółek (baz SAP)
• Tryb offline — automatyczne przejście gdy KSeF jest niedostępny, z kodami QR zgodnie z dokumentacją techniczną CIRFMF
• Wizualizacja PDF — generowanie wydruku faktury z danymi KSeF

Architektura

BizFlow NH składa się z następujących komponentów:

┌─────────────┐     ┌──────────────┐     ┌──────────────┐
│  Dashboard   │────▸│   .NET 9 API │────▸│  PostgreSQL   │
│  (React 19)  │     │              │────▸│  RabbitMQ     │
└─────────────┘     │              │────▸│  Redis         │
                     │              │────▸│  OpenBao       │
                     │              │────▸│  MinIO          │
                     └──────┬───────┘
                            │
                     ┌──────▼───────┐
                     │  PDF Sidecar  │
                     │  (Node.js)    │
                     └──────────────┘

• .NET 9 API — główny serwis: logika KSeF, mapowanie, zarządzanie certyfikatami
• React 19 Dashboard — panel zarządzania do konfiguracji i monitoringu
• PostgreSQL — baza danych (faktury, profile, konfiguracja)
• RabbitMQ — kolejkowanie zadań wysyłki i odbioru
• Redis — cache sesji i danych tymczasowych
• OpenBao — szyfrowany magazyn certyfikatów i sekretów
• MinIO — przechowywanie plików XML i PDF
• PDF Sidecar — generowanie wizualizacji PDF z kodami QR

Całość uruchamiana jest jako zestaw kontenerów Docker, zarządzanych przez docker-compose.

Dla kogo jest ta dokumentacja?

Dokumentacja jest przeznaczona dla konsultantów SAP B1 odpowiedzialnych za wdrożenie BizFlow NH u klientów. Zakładamy znajomość:

• SAP Business One (Service Layer, dokumenty handlowe, partnerzy biznesowi)
• Podstaw administracji Linux (terminal, SSH)
• Podstaw Docker (kontenery, obrazy, docker-compose)

Nie jest wymagana znajomość programowania — konfiguracja profili mapowania odbywa się przez dashboard lub pliki JSON.