Orsoft Doku
Dokumentace a nápověda pro IS Orsoft Open

Dokumentaci pro REST API rozhraní, které poskytuje funkce pro přidávání dokumentů k objednávkám, nabídkám a reklamacím. Na straně klienta se používá Add-in doplněk do Office365, kterým se zavolá webová služba.

### Základní informace

API Endpoint: `/dokumenty` Metoda: POST

### 1. Přidání dokumentu k objednávce - URL: `/dokumenty/add_docu_order` - Metoda: POST - Přijímá: JSON - Vrací: text/plain - Parametry:

  1. `OrderNumber`: Číslo objednávky (povinný)
  2. `FileName`: Název souboru (povinný)
  3. `Base64Content`: Obsah souboru v Base64 (povinný)

- Popis: Tato metoda přijímá JSON objekt s číslem objednávky, názvem souboru a obsahem souboru v Base64 a přidává dokument k objednávce.

### 2. Přidání dokumentu k nabídce - URL: `/dokumenty/add_docu_offer` - Metoda: POST - Přijímá: JSON - Vrací: text/plain - Parametry:

  1. `OfferNumber`: Číslo nabídky (povinný)
  2. `FileName`: Název souboru (povinný)
  3. `Base64Content`: Obsah souboru v Base64 (povinný)

- Popis: Tato metoda přijímá JSON objekt s číslem nabídky, názvem souboru a obsahem souboru v Base64 a přidává dokument k nabídce.

### 3. Přidání dokumentu k reklamaci - URL: `/dokumenty/add_docu_complaint` - Metoda: POST - Přijímá: JSON - Vrací: text/plain - Parametry:

  1. `ComplaintNumber`: Číslo reklamace (povinný)
  2. `FileName`: Název souboru (povinný)
  3. `Base64Content`: Obsah souboru v Base64 (povinný)

- Popis: Tato metoda přijímá JSON objekt s číslem reklamace, názvem souboru a obsahem souboru v Base64 a přidává dokument k reklamaci.

### Příklady použití (JSON formát): ```json {

"OrderNumber": "123456",
"FileName": "dokument.pdf",
"Base64Content": "JVBERi0xLjQKJeLjz9MKMyAwIG9iago8PC9UeXBl..."

} ```

### Chybové stavy - Popis: V případě selhání operace se vrací odpověď s chybovým hlášením. - Příklad: `KO Exception message here`

Poznámka: Můžete chtít doplnit informace o autentizaci a specifikovat HTTP kódy odpovědí pro úspěšné a neúspěšné operace.