InvoiceIntegration • Aceve & KlarPris Integration

InvoiceIntegration

API OIOUBL ingestion to KlarPris. Secure FTP/SFTP, resilient parsing, Postgres config/ledger, OpenTelemetry, and AKS-ready.

Readiness Liveness

Admin

Enable/disable ingestion fleet-wide or per site.

POST /api/admin/sites/disable-all — disables all sites
PUT /api/config/ftp-sites/{id}/enabled — body { "enabled": true|false }

Config

Seed destinations and FTP/SFTP sites/folders.

PUT /api/config/destinations — array of DestinationApi
PUT /api/config/ftp-sites — sites+folders payload
GET /api/config/sites — returns current config

Files Status

Query processed ledger with filtering and pagination.

Example:

GET /api/files/status?siteId=1&status=failed&page=1&pageSize=50

Filters: siteId (multi), status, from, to, hash, remotePath
Fields: bytes, invoice_amount, downstream, error, moved_to

Stats

GET /api/stats/files-per-day — processed/failed counts per day
GET /api/stats/amount-per-day — sum invoice amount per day
GET /api/stats/top-errors — top error messages

KlarPris Integration

POST /Api/ImportInvoice?cvr=... (201 with {InvoiceId})
POST /Api/ImportInvoiceLines?cvr=... (200 array of line statuses)
Always uses Customer CVR; apikey sent (header or query fallback)

Observability

OpenTelemetry via OTEL_EXPORTER_OTLP_ENDPOINT
SigNoz-ready traces/metrics/logs