Ksef wysyłanie faktur

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 /invoices z 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 ✗