# Czynność „Uruchomienie zewnętrznego API”

Podobnie jak w przypadku innych typowych czynności, uruchomienia zewnętrznego API można użyć w toku sprawy, gdy trzeba połączyć się z innym systemem, przekazać do niego dane i ewentualnie pobrać z zewnętrznego systemu zaktualizowane niestandardowe dane z powrotem do Enate.

Więcej informacji na temat konfiguracji czynności uruchomienia zewnętrznego API można znaleźć w tej sekcji poświęconej [Builderowi](https://docs.enate.net/enate-help/builder/builder-2021.1/case-configuration/external-api-action-info-tab).

Czasami odpowiedź z systemu zewnętrznego może nadejść z opóźnieniem. W takiej sytuacji, gdy czynność „Uruchomienie zewnętrznego API” oczekuje na informacje z zewnętrznego systemu, na karcie informacyjnej czynności w Work Managerze zostanie wyświetlony status „Oczekuje”.

![](/files/-MdNThtZg4y1_1HCPb4o)

Gdy z zewnętrznego systemu do Enate nadejdzie wreszcie odpowiedź z aktualizacją danych, będzie ona opatrzona znacznikiem informującym użytkownika, czy aktualizacja się powiodła, czy nie.

#### **Odpowiedź „Zakończono pomyślnie”**

Jeśli system w odpowiedzi zgłasza, że operacja zakończyła się powodzeniem, status czynności automatycznie zmieni się na „Zamknięta” z metodą rozwiązania „Zakończono pomyślnie”.

![](/files/HGP06ZvFBMwMKZYlqyOM)

#### **Odpowiedź „Nie udało się zakończyć pomyślnie”**

Jeśli system w odpowiedzi zgłasza, że operacja nie zakończyła się powodzeniem, status czynności zmieni się na „Do zrobienia” z podaną przyczyną „Zaktualizowano przez integrację”. Zewnętrzny API może również wraz z odpowiedzią dostarczyć dodatkowych informacji o przyczynach niepowodzenia. Ta informacja zostanie wyświetlona na karcie informacyjnej czynności w sekcji „Powód odrzucenia”.

![](/files/fQBCJB4DVYKhDgEKvpYK)

Jeśli czynności nie udało zakończyć się pomyślnie z powodu przekroczenia ustawionego czasu ([w Builderze](https://docs.enate.net/enate-help/builder/builder-2021.1/case-configuration/external-api-action-info-tab)), wówczas otrzyma ona status „Do zrobienia” z przyczyną „Koniec czasu” i zostanie przeniesiona do kolejki lub przekazana innemu użytkownikowi, w zależności od ustawionych reguł przenoszenia.

![](/files/8UeHdudWkDoVeNr3Ih3M)

Czynności zakończone niepowodzeniem będą się zachowywać jak standardowe czynności wykonywane ręcznie.

{% hint style="info" %}
Należy pamiętać, że właściciel sprawy NIE będzie powiadomiony o takich przypadkach.
{% endhint %}

### **Automatyczne powtórzenia**     

Jeśli czynność nie może połączyć się z systemem zewnętrznym, wówczas automatycznie ponowi próbę określoną liczbę razy, zależnie od tego, jak twój system został skonfigurowany w Builderze (więcej informacji znajdziesz [tutaj](https://docs.enate.net/enate-help/builder/builder-2021.1/system-wide-settings#automated-failure-retry-pattern)). Zostanie również wyświetlony komunikat o błędzie, informujący:

* kiedy wystąpił błąd
* kiedy system automatycznie spróbuje ponownie nawiązać połączenie
* ile razy system automatycznie ponowił próbę nawiązania połączenia
* ile razy system automatycznie spróbuje ponownie nawiązać połączenie.

![](/files/XCs68eYVRVSWgEMBkjLZ)

Można również z tego miejsca ręcznie ponowić próbę nawiązania połączenia, klikając w odnośnik „Ponów” w wiadomości o błędzie.

{% hint style="info" %}
Należy pamiętać, że ręczne ponowienie próby liczy się jako podjęta próba i tym samym będzie uwzględnione w liczbie wskazującej, ile razy system „automatycznie” próbował nawiązać połączenie.
{% endhint %}

Jeśli czynność nie nawiąże połączenia po automatycznych ponownych próbach (np. jeśli liczba prób jest ustawiona na 5, a system nie nawiąże połączenia po 5 automatycznych próbach), status czynności automatycznie zmieni się na „Zamknięta” z metodą rozwiązania „Nie udało się zakończyć pomyślnie”.

![](/files/Ax6YCAQpv6W8bWeH9arU)

{% hint style="info" %}
W sytuacji, gdy czynności nie uda się nawiązać połączenia z systemem zewnętrznym, element zostanie przekazany właścicielowi sprawy, a w sekcji czynności na ekranie sprawy zostanie zaznaczone, że czynność jest Zamknięta – Nie udało się zakończyć pomyślnie.
{% endhint %}

Gdy czynność otrzyma wymagane informacje, zostanie automatycznie zamknięta.

![](/files/hvO08LzpZbR4fB5A6GLC)

#### **Dostosowywanie ustawień ponawiania w Builderze podczas / po rozpoczęciu ponawiania**

Jeśli ustawienia automatycznego ponawiania w Builderze zostaną zmienione *już po* *tym,* jak system podjął automatyczne próby nawiązania połączenia z systemem zewnętrznym, sytuacja może rozwinąć się następująco.

Jeśli na przykład ustawienie ponawiania było pierwotnie ustawione na 5 i system automatycznie ponawiał próbę nawiązania połączenia 5 razy, ale bez powodzenia, wtedy status czynności zmieni się na „Zamknięte” z komunikatem o błędzie i wskazaną liczbą prób wynoszącą 5/5.

 Jeśli ustawienie ponownych prób zostanie zwiększone do wartości powyżej 5, na przykład 7, w komunikacie o błędzie zostanie wyświetlona liczba ponownych prób wynosząca 5/7, ale system NIE spróbuje automatycznie ponowić próby nawiązania połączenia po raz szósty i siódmy, ponieważ czynność zostanie już zamknięta.

Jeśli jednak czynność nie przeszła do stanu „Zamknięte”, ponieważ nie osiągnęła maksymalnej liczby automatycznych ponownych prób (na przykład próbowała nawiązać połączenie tylko 4 razy z 5), wówczas zwiększenie liczby ponownych prób do 7 oznacza, że czynność będzie automatycznie ponawiać próbę nawiązania połączenia, dopóki licznik nie osiągnie 7.

I odwrotnie, zmniejszenie liczby prób już po ich rozpoczęciu (np. przy próbie 4 z 10 zmniejszono maksymalną liczbę prób właśnie do 4) sprawi, że system będzie pokazywał próbę 4 z 10, ale czynność w rzeczywistości będzie już zamknięta.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.enate.net/enate-help/polski/przetwarzanie-dzialania/czynnosci-trigger-external-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.