PROTOTYPE / EUROPE-CENTRAL2
Centrum operacyjne
—MASTER_ADMIN
OSTATNIE 24 GODZINY
Przegląd API
SLT-INVOICE APIonline
Firestore + StorageWarszawa, PL
KSeF 2.0adapter oczekuje
Zakup → aktywacjaintegracja planowana
KONTRAKT INTEGRACYJNY
Jak wygląda SLT-INVOICE API
Adres bazowy prototypu
https://api.prototype.inv.skylegaltech.com/v1
Autoryzacja integracji
X-API-Key: sltp_••••••••
Format danych
JSON / UTF-8
Wersja
v1 / PROTOTYPE
1Utwórz szkic
→
POST /invoices2Zleć wystawienie
→
POST /invoices/{id}/issue3Sprawdzaj operację
→
GET /operations/{id}4Odbierz numer KSeF i UPO
po podłączeniu certyfikatu| Metoda | Endpoint | Do czego służy | Dostęp | Stan |
|---|---|---|---|---|
| GET | /health | Stan usługi | Publiczny | GOTOWE |
| GET | /capabilities | Zakres obsługiwanych dokumentów | Publiczny | GOTOWE |
| POST | /invoices/validate | Walidacja faktury bez jej zapisywania | Publiczny | GOTOWE |
| POST | /invoices | Utworzenie szkicu faktury | Klucz API | GOTOWE |
| GET | /invoices/{invoiceId} | Odczyt faktury | Klucz API | GOTOWE |
| POST | /invoices/{invoiceId}/corrections | Utworzenie korekty | Klucz API | GOTOWE |
| POST | /invoices/{invoiceId}/issue | Przekazanie faktury do adaptera KSeF | Klucz API | ADAPTER |
| GET | /operations/{operationId} | Status wysyłki, numer KSeF i UPO | Klucz API | ADAPTER |
Przykładowe żądanie
POST /v1/invoices{
"issuerId": "slt-pl",
"externalReference": "crm-2026-0001",
"documentKind": "VAT",
"ksefMode": "ONLINE",
"currency": "PLN",
"issueDate": "2026-09-04",
"saleDate": "2026-09-04",
"seller": {
"name": "Sky Legal Tech sp. z o.o.",
"nip": "1234567890",
"countryCode": "PL",
"addressLine1": "Warszawa"
},
"buyer": {
"name": "Przykładowy klient",
"nip": "0987654321",
"countryCode": "PL",
"addressLine1": "Kraków"
},
"items": [{
"name": "Usługa prawna",
"quantity": "1",
"unit": "szt.",
"unitNetPrice": "1000.00",
"vatRate": "23",
"netAmount": "1000.00",
"vatAmount": "230.00",
"grossAmount": "1230.00"
}],
"payment": {
"method": "TRANSFER",
"dueDate": "2026-09-18"
}
}Odpowiedź API
201 Created{
"id": "inv_01J...",
"type": "VAT",
"status": "DRAFT",
"replayed": false,
"requestId": "4c4be..."
}Ważne: utworzenie szkicu nie wysyła jeszcze faktury do KSeF. Osobne zlecenie /issue uruchamia proces asynchroniczny. Dzięki temu system klienta nie musi czekać na odpowiedź KSeF.
KONTROLA DOSTĘPU
Wnioski o używanie API
| Wdrożenie | Odbiorca | Tryb | Zakres | Status | |
|---|---|---|---|---|---|
| Ładowanie… | |||||
WDROŻENIA
Aktywne integracje
| Aplikacja | Właściciel | Zakres | Wywołania | Ostatnie IP | Status |
|---|---|---|---|---|---|
| Ładowanie… | |||||
AUDYT RUCHU
Ostatnie połączenia i IP
| Czas | Klient API | Adres IP | Metoda | Ścieżka | Wynik |
|---|---|---|---|---|---|
| Ładowanie… | |||||
KONFIGURACJA