techdoc:integrace

Integrace rejstříku ekonomických subjektů ARES

Rejstřík ekonomických subjektů ARES je v ESO9 Start integrován běžným způsobem na stránce s číselníkem subjektů. Lze jej odtud snadno zavolat několika způsoby, přičemž ten nejjednodušší spočívá v zadání IČ nového subjektu a stisku tlačítka Proveď ARES. V závislosti na aktuálně vybrané akci (výchozí je aktualizace základních údajů bez oborů činností) se z ARESu stáhnou požadované informace a uloží se k novému založenému subjektu. Tento způsob předpokládá založení nového subjektu, popř.aktualizaci údajů v již existujícím subjektu.

V případě, že chceme z ARESu pouze stáhnout informace k subjektu na základě IČ a ty zobrazit ve formuláři (tj.bez zakládání nového subjektu), je třeba v uživatelském formuláři provést několik úprav(příklad):

Formulář bude needitační (subjekt se v něm nezakládá ani needituje), všechny položky v něm budou tedy typu MF (tj. bez obrazu v databázi).
Datový zdroj musí obsahovat pouze IČ, které bude obsluha zadávat, a typ akce v ARESu (pro ověření se jedná o hodnotu 13):

  <input name="VIEW" type="hidden" 
   value="SELECT 1 as ID, 
                '' as mf_ICO, 
		12 as MF_ARES, 
		'' as mf_ErrDesc, 
		'' as mf_Info, 
		'spARES_OverUdaje' as MF_SPZakladniUdaje">

Položka MF_SPZakladniUdaje v datovém zdroji může obsahovat uživatelskou proceduru, která se bude spouštět při aktualizaci základních údajů k subjektu. Pokud procedura není definována (a tedy se vůbec volat nemá), bude mít tato položka hodnotu '#NONDEF'. Bylo by samozřejmě jednodušší uvést pouze prázdnou hodnotu, nicméně v ten okamžik by přestaly fungovat všechny formuláře Subjektů v Profi aplikacích.
Dále může formulář obsahovat všechny položky, které se mají po ověření naplnit údaji staženými z ARESu, např. název subjektu nebo jeho adresu.
Rozhraní uživatelské procedury uvedené v parametru MF_SPZakladniUdaje může obsahovat tyto položky:

  @MF_SUBJ_NAZEV     varchar(255),
  @MF_ICO            varchar(20),
  @MF_DIC            varchar(20),
  @MF_SKUP_DPH       smallint,
  @MF_VLPRAVNIFORMA  smallint,
  @MF_ULICE          varchar(60),        
  @MF_CAST_OBCE      varchar(60),        
  @MF_MESTO          varchar(60),
  @MF_PSC            varchar(10),
  @MF_KOD_STATU      varchar(10),
  @MF_NAZEV_STATU    varchar(60),
  @MF_VLPLATCEDPH    smallint,
  @idLogUser      int

Procedura může libovolnou z uvedených položen modifikovat podobně, jako to dělají běžná obchodní pravidla v ESO9. Změny se pak promítnou do hodnot těchto položek ve formuláři.
Stiskem tlačítka Ověř subjekt v rejstříku ARES se všechny dostupné položky ve formuláři naplní výsledky z ARESu s možností jejich úpravy v uživatelské proceduře.

Kompletní zdrojový HTML kód formuláře může vypadat např. takto:

<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
<html>

<head>
  <meta http-equiv="Content-Type" content="text/html; charset=windows-1250">
  <title>Ověření subjektu z ARESu</title>
</head>

<body>

  <form method="POST" name="OverSubjekt">
  <input name="FormType" type="hidden" value="Editor">
  <input name="NavBar" type="hidden" value="none">
  <input name="HeadBar" type="hidden" value="none">
  <input name="HiddenFields" type="hidden" value="mf_ErrDesc;mf_Info" >
  <input name="VIEW" type="hidden" 
    value="SELECT 1 as ID, 
                 '' as mf_ICO, 
                 13 as MF_ARES, 
                 '' as mf_ErrDesc, 
                 '' as mf_Info, 
                 'spARES_OverUdaje' as MF_SPZakladniUdaje">

  <table border="0" cellpadding="0" cellspacing="1" width="100%">
    <caption valign="top">Ověření subjektu v rejstříku ARES</caption>
     
    <tr>
      <td width="15%"><label for="idICO">IČO</label></td>
      <td width="35%">
        <input id="idICO" name="mf_ICO" size="12" type="text" class="required">
      </td>
      <td><label for="fpNazev">Název</label></td>
      <td><input id="fpNazev" name="MF_SUBJ_NAZEV" size="80" type="text" readonly></td>
    </tr>

    <tr>
      <td width="15%"><label for="idDIC">DIČ</label></td>
      <td width="35%">
        <input id="idDIC" name="MF_DIC" size="12" type="text" readonly>
      </td>
      <td><label for="fpUlice">Část obce, ulice a číslo</label></td>
      <td>
        <input name="MF_CAST_OBCE" size="80" type="text" readonly> / <input id="fpUlice" name="MF_ULICE" size="80" type="text" readonly>
      </td>
    </tr>
    
    <tr>
      <td>Akce</td>
      <td>
        <select name="mf_ARES" style="width: 360px;" readonly>
        <option value="1">aktualizace všech údajů</option>
        <option value="2">aktualizace základních údajů</option>
        <option value="4">aktualizace základních údajů bez oborů činností</option>
        <option value="3">aktualizace pouze osob</option>
        <option value="5">aktualizace pouze oborů činností</option>
        <option value="0">ověření všech údajů</option>
        <option value="6">ověření základních údajů</option>
        <option value="12">aktualizace základních údajů (needitační formulář)</option>
        <option value="13">ověření základních údajů (needitační formulář)</option>
        </select>
      </td>
      <td><label for="fpMesto">Město</label></td>
      <td>
        <input name="MF_PSC" size="8" type="text" readonly> / <input id="fpMesto" name="MF_MESTO" size="80" type="text" readonly>
      </td>
    </tr>

    <tr>
      <td><label for="fpvlPlatceDPH">Plátce DPH</label></td>
      <td>
        <select id="fpvlPlatceDPH" name="MF_vlPlatceDPH" size="1" ReadOnly>
         <option value="0">neurčeno</option>
         <option value="1">neplátce</option>
         <option value="2">plátce tuzemsko</option>
         <option value="3">plátce v EU</option>
         <option value="4">mimo EU</option>
        </select>
      </td>
      <td><label for="fpStat">Stát</label></td>
      <td>
        <input name="MF_KOD_STATU" size="5" type="text" readonly> / <input id="fpStat" name="MF_NAZEV_STATU" size="80" type="text" readonly>
      </td>
    </tr>

    <tr>
      <td><label>Info</label></td>
      <td>
        <input id="lblErr" name="mf_Info" type="text" readonly>
      </td>
    </tr>
    
    <tr>
      <td colspan="4">
        <input name="Actx_Eso9lib.CAres_Imp" type="button" value="Ověř subjekt v rejstříku ARES" style="width:300px"></td>
      </td>
    </tr>
    
  </table>  
  </form>
</body>

</html>