API Endpoints

BizFlow NH udostępnia REST API do integracji z systemami zewnętrznymi. Poniżej kluczowe endpointy.

Uwierzytelnianie

Wszystkie endpointy (oprócz logowania) wymagają tokenu JWT w nagłówku:

Authorization: Bearer <token>

Login

POST /api/v1/auth/login
Content-Type: application/json

{
  "email": "user@example.com",
  "password": "password"
}

Odpowiedź:

{
  "accessToken": "eyJhbG...",
  "refreshToken": "eyJhbG...",
  "expiresIn": 86400
}

Refresh token

POST /api/v1/auth/refresh
Content-Type: application/json

{
  "refreshToken": "eyJhbG..."
}

Faktury KSeF

Wysyłka faktury

POST /api/v1/ksef/invoices/send
Content-Type: application/json

{
  "sapConfigId": 1,
  "docType": "OINV",
  "docEntry": 12345
}

Odpowiedź:

{
  "submissionId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "Sending"
}

Status wysyłki

GET /api/v1/ksef/submissions/{submissionId}

Odpowiedź:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "Accepted",
  "ksefNumber": "2026-0315-XXXXXXXXXX-XX",
  "ksefDate": "2026-03-15T10:30:00Z"
}

Lista wysyłek

GET /api/v1/ksef/submissions?sapConfigId=1&status=Accepted&page=1&pageSize=50

Podgląd XML

POST /api/v1/ksef/invoices/preview
Content-Type: application/json

{
  "sapConfigId": 1,
  "docType": "OINV",
  "docEntry": 12345,
  "mappingProfileId": 1
}

Zwraca wygenerowany XML bez wysyłki do KSeF.

Konfiguracja SAP

Lista połączeń

GET /api/v1/sap-config

Dodaj połączenie

POST /api/v1/sap-config
Content-Type: application/json

{
  "name": "Firma ABC",
  "serviceLayerUrl": "https://sapserver:50000/b1s/v1/",
  "companyDb": "SBO_ABC",
  "username": "BizFlowNH",
  "password": "password",
  "ksefEnvironment": "Test"
}

Test połączenia

POST /api/v1/sap-config/{id}/test

Profile mapowania

Lista profili

GET /api/v1/mapping-profiles?sapConfigId=1

Import profilu

POST /api/v1/mapping-profiles/import
Content-Type: application/json

{
  "sapConfigId": 1,
  "profile": { ... }
}

Eksport profilu

GET /api/v1/mapping-profiles/{id}/export

Certyfikaty

Lista certyfikatów

GET /api/v1/certificates?sapConfigId=1

Upload certyfikatu

POST /api/v1/certificates/upload
Content-Type: multipart/form-data

sapConfigId: 1
type: Auth
environment: Test
file: (plik PFX)
password: haslo_do_pfx

Mapowanie VAT

Lista mapowań

GET /api/v1/vat-mappings?sapConfigId=1

Dodaj mapowanie

POST /api/v1/vat-mappings
Content-Type: application/json

{
  "sapConfigId": 1,
  "sapVatCode": "Dzw",
  "ksefCategory": "23",
  "description": "Dostawa towarów 23%"
}

Stan systemu

Health check

GET /api/v1/health

Odpowiedź:

{
  "status": "Healthy",
  "components": {
    "database": "Healthy",
    "rabbitmq": "Healthy",
    "redis": "Healthy",
    "openbao": "Healthy",
    "minio": "Healthy",
    "pdfSidecar": "Healthy"
  }
}

Stan KSeF (Latarnia)

GET /api/v1/ksef/status

Odpowiedź:

{
  "status": "Available",
  "lastChecked": "2026-03-15T10:30:00Z",
  "environment": "Production"
}

Kody odpowiedzi

Kod	Opis
200	Sukces
201	Utworzono
400	Błąd walidacji (nieprawidłowe dane)
401	Brak autoryzacji (token wygasł lub nieprawidłowy)
403	Brak uprawnień (rola nie pozwala)
404	Nie znaleziono
500	Błąd wewnętrzny serwera