# Symfonia WebAPI

# Słownik

- **Integrator** – system Integrator THTG  
- **Symfonia** – system księgowy Symfonia  
- **WebAPI** – usługa stworzona przez Symfonię, pozwalająca na integrację systemów zewnętrznych z systemem księgowym Symfonia.  
  Link do opisu WebAPI: https://symfonia.pl/oprogramowanie/web-api

---

# Wstęp

**WebAPI** jest modułem dodatkowo płatnym.  

W przypadku posiadania wielu spółek wymagane jest uruchomienie wielu instancji **WebAPI**.

Instrukcja instalacji usługi:  
https://pomoc.symfonia.pl/Help/api/webapi/2022/123205

### Przykład konfiguracji

[![](https://pomoc.thtg.io/uploads/images/gallery/2026-03/scaled-1680-/EUdnRmw4eknNWjBV-image-1773048419847.png)](https://pomoc.thtg.io/uploads/images/gallery/2026-03/EUdnRmw4eknNWjBV-image-1773048419847.png)
[![](https://pomoc.thtg.io/uploads/images/gallery/2026-03/scaled-1680-/7ADxfJokvTW5lUXj-image-1773048427142.png)](https://pomoc.thtg.io/uploads/images/gallery/2026-03/7ADxfJokvTW5lUXj-image-1773048427142.png)
---

# Wymagania

- uruchomiona usługa **WebAPI**
- link do publicznego adresu, za pomocą którego **Integrator** będzie komunikował się z **WebAPI**
- token autoryzacyjny
- nazwa spółki, której dotyczy konfiguracja

---

# Możliwości integracji

Integrator posiada następujące możliwości integracji z systemem **Symfonia**.

## Tworzenie kontrahentów [Integrator → Symfonia]

Po utworzeniu kontrahenta w **Integratorze** jest on automatycznie wysyłany do **Symfonii**.

Kontrahenci wysyłani są:

- po ich utworzeniu lub modyfikacji w sekcji **Klient → Kontrahent**
- po utworzeniu i podpisaniu **umowy dla klienta lub klientów**

W przypadku umowy dla wielu klientów tworzony jest **jeden kontrahent w Symfonii**, który zawiera dane wszystkich klientów.

## Tworzenie faktur kosztowych i sprzedażowych [Integrator → Symfonia]

Po utworzeniu faktury w **Integratorze** w module **EOD** lub w module **Faktur**, może ona zostać automatycznie wysłana do **Symfonii** do odpowiedniej sekcji systemu.

Faktury są **zadekretowane zgodnie z konfiguracją w Integratorze**.

Do **Symfonii nie są wysyłane pliki PDF faktur**.

---

# Procedura integracji

1. **THTG** ustala z klientem zakres integracji.
2. Klient instaluje **WebAPI** i przekazuje THTG dane do **bazy testowej utworzonej na podstawie bazy istniejącej**.
3. **THTG** wewnętrznie testuje integrację.
4. **THTG** testuje integrację wspólnie z klientem.
5. Klient konfiguruje **WebAPI dla pozostałych baz** i przekazuje dane do THTG.
6. **THTG** uzupełnia konfigurację w Integratorze i uruchamia integrację.