Documents

Jak pobierać dokumenty zsynchronizowane w KSeFCore (cursor sync, XML/PDF, trigger sync)

Endpointy

• GET /api/v1/documents
• GET /api/v1/documents/{doc_id}
• GET /api/v1/documents/{doc_id}/xml
• GET /api/v1/documents/{doc_id}/pdf
• POST /api/v1/documents/sync

Wymagania:

• header X-API-Token
• scope documents:read (GET) i documents:write (sync)

Listowanie dokumentów

GET /api/v1/documents działa w 2 trybach:

• sync-mode (cursor) — zalecany dla integracji
• UI-mode (filtry bez kursora) — niezalecany dla integratora

Incremental sync

• używaj next_cursor
• zapisuj next_cursor dopiero po poprawnym przetworzeniu strony

Trigger sync

POST /api/v1/documents/sync zleca synchronizację asynchronicznie.

Pobieranie XML/PDF

• GET /api/v1/documents/{doc_id}/xml
• GET /api/v1/documents/{doc_id}/pdf

Jeśli XML nie jest jeszcze dostępny → 404.