https://claude.ai/chat/4cc1d3ee-fca7-47c3-ae8e-069e207e025c
1. Wysyłanie faktur do KSeF ⭐ (najważniejsze)
- Przygotowanie XML faktury (FA(3))
- Wysłanie faktury POST
/invoices - Pobieranie numeru KSeF
2. Sprawdzanie statusu faktury
- GET
/invoices/{invoiceElementReferenceNumber}/status - Pobieranie UPO (Urzędowe Poświadczenie Odbioru)
3. Pobieranie listy faktur
- GET
/invoicesz filtrowaniem - Paginacja wyników
4. Odświeżanie tokenów
- Automatyczne odświeżanie gdy token wygasa
- POST
/auth/token/refresh
5. Zarządzanie sesjami w bazie danych
- Tabela do przechowywania tokenów
- Model + migracja CakePHP
6. Pobieranie faktur
- GET
/invoices/{KsefReferenceNumber} - Export XML/PDF
Jak to działa:
User → „📤 Wyślij do KSeF”
↓
Generowanie XML FA(3)
↓
POST /invoices → ElementReferenceNumber
↓
Polling co 3s (max 10 prób = 30s)
↓
processingCode = 200?
├─ TAK → Pobierz UPO → Status: ACCEPTED ✓
└─ NIE → Status: REJECTED/PENDING
↓
Automatyczna aktualizacja w bazie:
– ksef_status
– ksef_number
– ksef_upo
– ksef_accepted_at
📊 Statusy faktur:
| Status | Co to znaczy |
|---|---|
| DRAFT | Wersja robocza – gotowa do wysłania |
| PENDING | Wysłana – czeka na przetworzenie |
| ACCEPTED | Zaakceptowana – masz numer KSeF ✓ |
| REJECTED | Odrzucona – błąd walidacji ✗ |