Rejestracja korespondencji wysłanej kanałami wysyłki

Aby zarejestrować korespondencję wysłaną za pośrednictwem zewnętrznego kanału wysyłki (np. systemu zintegrowanego z EZD RP), kanał wysyłki musi zostać wcześniej dodany przez administratora EZD RP w danym podmiocie. Opis konfiguracji znajduje się w artykule: Konfiguracja kanałów wysyłek rejestrowanych w RKW.

Po skonfigurowaniu i włączeniu kanałów wysyłki listę wszystkich aktywnych kanałów można pobrać przy użyciu metody:

GET /ezdrp/integrator/v2/kw/kanaly-wysylki/aktywne

Przykład odpowiedzi:

{
    "lista": [
        {
            "idWlasnyKanalWysylki": "fdfd2b5859504b88bb9b62ce250ddf19",
            "nazwa": "System Zintegrowany A",
            "opis": "System Zintegrowany A"
        },
        {
            "idWlasnyKanalWysylki": "1f60303e5ab14f76a1d3434cd0e94716",
            "nazwa": "System Zintegrowany B",
            "opis": "System Zintegrowany B"
        }
    ]
}

Zarządzanie kanałami wysyłki adresatów

Mając listę kanałów, można przypisywać je do adresatów z poziomu EZD RP lub przy użyciu metody:

PUT /ezdrp/integrator/v2/adresaci/{idAdresat}/kanaly-wysylki

Lista kanałów dostępnych do przypisania jest zwracana po wywołaniu poniższej metody bez parametrów:

GET /ezdrp/integrator/v2/adresaci/kanaly-wysylki

Przykład odpowiedzi:

{
    "lista": [
        {
            "idWlasnyKanalWysylki": "fdfd2b5859504b88bb9b62ce250ddf19",
            "nazwa": "System Zintegrowany A",
            "opis": "System Zintegrowany A",
            "czyPrzypisany": false
        }
    ]
}

Lista kanałów wysyłki przypisanych do adresata jest zwracana przez metodę:

GET /ezdrp/integrator/v2/adresaci/kanaly-wysylki

Metodę należy wywołać z parametrem idAdresat wskazującym konkretnego adresata.

Rejestracja wysyłki

Mając listę dostępnych kanałów wysyłki, należy odszukać w sprawie dokument, dla którego ma zostać zarejestrowana wysyłka. Można to zrobić przy użyciu metody:

GET /ezdrp/integrator/v2/sprawy/{idSprawa}/dokumenty

Jeżeli identyfikator sprawy nie jest znany, sprawę można wyszukać po znaku sprawy lub innych parametrach za pomocą metody:

POST /ezdrp/integrator/v2/sprawy/_search

Przykład: rejestracja wysyłki dokumentu Decyzja odmowna.pdf do adresata Ministerstwo Zdrowia.

Pobranie listy dokumentów w sprawie (przykład zawiera wyłącznie wartości idDokumentPrzestrzeni, idDokument oraz idDokumentWersja):

{
    "lista": [
        {
            "dokumentPrzestrzeni": {
                "idDokumentPrzestrzeni": "b71d5f35bda342dcbf8d39e29c59eecd",
                "idDokument": "a810abd8115848c7afb92b0994a07d88",
                "idDokumentWersja": "be87d877b4f2437eba4988b05da47940",
                "nazwa": "Decyzja odmowna.pdf"
            }
        }
    ]
}

Następnie należy pobrać informacje o sprawie:

GET /ezdrp/integrator/v2/sprawy/{idSprawa}

Przykład odpowiedzi ograniczony do parametrów idPrzestrzenRobocza, idSprawa oraz znak:

{
    "idSprawa": "b87e8e27a34641d8b84cc71230435b6f",
    "idPrzestrzenRobocza": "917a2e8a6aae409880d78993a8685451",
    "znak": "SSPASI.40.1.2026"
}

Ostatnim etapem jest wyszukanie adresata. Jeżeli znany jest identyfikator adresata, należy użyć metody:

GET /ezdrp/integrator/v2/adresaci/{idAdresat}

W przeciwnym przypadku:

POST /ezdrp/integrator/v2/adresaci/_search

Z listy adresów należy wybrać odpowiednią wartość idAdresWersja. W przedstawionym przykładzie jest to:

45ee50240d3a481abe14f84aa846f1e3

Po zgromadzeniu wszystkich wymaganych danych wysyłkę można zarejestrować przy użyciu metody:

POST /ezdrp/integrator/v2/kw/wyslanie/kanal-wysylki

Przykład żądania:

{
  "idPrzestrzenRobocza": "917a2e8a6aae409880d78993a8685451",
  "idSprawa": "b87e8e27a34641d8b84cc71230435b6f",
  "znakSprawy": "SSPASI.40.1.2026",
  "dokumenty": [
    {
      "idDokumentPrzestrzeni": "b71d5f35bda342dcbf8d39e29c59eecd",
      "idDokument": "a810abd8115848c7afb92b0994a07d88",
      "idDokumentWersja": "be87d877b4f2437eba4988b05da47940"
    }
  ],
  "listaIdAdresWersja": [
    "45ee50240d3a481abe14f84aa846f1e3"
  ],
  "idWlasnyKanalWysylki": "fdfd2b5859504b88bb9b62ce250ddf19",
  "dataWyslania": "2026-10-07"
}

Po zarejestrowaniu wysyłki informacja o niej będzie widoczna w zakładce wysyłek w sprawie.

Będzie również widoczna w rejestrze korespondencji wychodzącej.

POST /ezdrp/integrator/v2/kw/wyslanie/kanal-wysylki

Jeżeli wysyłka ma być realizowana wyłącznie kanałami przypisanymi do adresata, przed jej zarejestrowaniem należy zweryfikować przypisania przy użyciu metody:

GET /ezdrp/integrator/v2/adresaci/kanaly-wysylki

Metodę należy wywołać z parametrem idAdresat adresata, dla którego ma zostać wykonana weryfikacja.