IFIS*Pohledávky a externí systémy

Popis datového rozhraní pro převod dat z externích systémů do iFIS/Pohledávky

Externí aplikace může zajišťovat přenos pohledávek (vystavené faktury, vystavené zálohové listy) do datového rozhraní iFIS/Pohledávky. Datové rozhraní validuje zapisovaná data a následně je zapisuje do evidence iFIS/Pohledávky.

• Pro fyzický zápis pohledávkových dokladů do iFIS/Finance je využívána databázová package IMP_ODFA, která obsahuje jednotlivé výkonné funkce (vstupní konektory).
• Vstupním konektorem se rozumí databázová funkce, která umožňuje externím aplikacím požadovanou manipulaci s daty iFIS.
• Vstupní konektory jsou volány buď napřímo a nebo přes webovou službu (WS).
• Externí aplikace ovlivňuje chování konektoru zadáním tzv. vstupních argumentů.
• Vstupní argumenty konektorů, které mají definovány default hodnoty, jsou nepovinné.
• Argumenty, u nichž jsou uvedeny možné hodnoty, nebo odkazy na domény, nebo odkazy na jiné číselníky jsou na tyto hodnoty kontrolovány.
• Konektor kontroluje všechna databázová integritní omezení.
• Jakákoliv chyba při zpracování transakce způsobí automatické odvolání všech změn, které funkce provedla.
• Databázové funkce automaticky vrací po provedení transakce tzv. výstupní argumenty. Tyto výstupní argumenty informují externí aplikaci o stavu provedené transakce (informace o správně provedené transkaci, informace o jednoznačných identifikátorech nově založených záznamů v iFIS, informace o chybných vstupních argumentech, o porušených integritních omezeních, či o porušení pravidel pro uložení dat do iFIS/Finance).
• Další pravidla jsou součástí popisu příslušných funkcí (viz dále).

Techická specifikace webové služby ImpODFA.wsdl

  <?xml version="1.0" encoding="UTF-8" ?> 
- <!-- 
Generated by the Oracle JDeveloper 10g Web Services WSDL Generator
  --> 
- <!-- 
Date Created: Thu Feb 08 09:58:42 CET 2007
  --> 
- <definitions name="ImpODFA" targetNamespace="http://fvz/ImpODFA.wsdl" xmlns="http://schemas.xmlsoap.
org/wsdl/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.
org/wsdl/soap/" xmlns:tns="http://fvz/ImpODFA.wsdl" xmlns:ns1="http://fvz/ImpODFA.xsd">
- <types>
- <schema targetNamespace="http://fvz/ImpODFA.xsd" xmlns="http://www.w3.org/2001/XMLSchema" xmlns:SOAP-ENC="http:
//schemas.xmlsoap.org/soap/encoding/">
- <complexType name="fvz_ImpODFAImpl_zapis_radek_Out" jdev:packageName="fvz" xmlns:jdev="http://xmlns.oracle.
com/jdeveloper/webservices">
- <all>
  <element name="chybaOut" type="string" /> 
  <element name="return" type="boolean" /> 
  </all>
  </complexType>
- <complexType name="fvz_ImpODFAImpl_otevri_doklad_Out" jdev:packageName="fvz" xmlns:jdev="http://xmlns.oracle.
com/jdeveloper/webservices">
- <all>
  <element name="chybaOut" type="string" /> 
  <element name="return" type="boolean" /> 
  </all>
  </complexType>
- <complexType name="fvz_ImpODFAImpl_uzavri_doklad_Out" jdev:packageName="fvz" xmlns:jdev="http://xmlns.oracle.
com/jdeveloper/webservices">
- <all>
  <element name="chybaOut" type="string" /> 
  <element name="cislodoklOut" type="decimal" /> 
  <element name="return" type="boolean" /> 
  </all>
  </complexType>
  </schema>
  </types>
- <message name="zapis_radek0Request">
  <part name="text" type="xsd:string" /> 
  <part name="mj" type="xsd:string" /> 
  <part name="pocet" type="xsd:string" /> 
  <part name="cenamj" type="xsd:string" /> 
  <part name="cenc" type="xsd:string" /> 
  <part name="zcm" type="xsd:string" /> 
  <part name="zdcm" type="xsd:string" /> 
  <part name="dcm" type="xsd:string" /> 
  <part name="hdan" type="xsd:string" /> 
  <part name="sazba" type="xsd:string" /> 
  <part name="stav" type="xsd:string" /> 
  <part name="danidno" type="xsd:string" /> 
  <part name="nsidno" type="xsd:string" /> 
  <part name="typaidno" type="xsd:string" /> 
  <part name="akce" type="xsd:string" /> 
  <part name="komidno" type="xsd:string" /> 
  <part name="rsfidno" type="xsd:string" /> 
  </message>
- <message name="zapis_radek0Response">
  <part name="return" type="ns1:fvz_ImpODFAImpl_zapis_radek_Out" /> 
  </message>
  <message name="reset_doklad1Request" /> 
  <message name="reset_doklad1Response" /> 
- <message name="otevri_doklad2Request">
  <part name="firmidno" type="xsd:string" /> 
  <part name="ico" type="xsd:string" /> 
  <part name="kopridno" type="xsd:string" /> 
  <part name="icokp" type="xsd:string" /> 
  <part name="mesic" type="xsd:string" /> 
  <part name="rok" type="xsd:string" /> 
  <part name="mena" type="xsd:string" /> 
  <part name="penale" type="xsd:string" /> 
  <part name="slevy" type="xsd:string" /> 
  <part name="vsmb" type="xsd:string" /> 
  <part name="ksmb" type="xsd:string" /> 
  <part name="ssmb" type="xsd:string" /> 
  <part name="pril" type="xsd:string" /> 
  <part name="cdl" type="xsd:string" /> 
  <part name="dodp" type="xsd:string" /> 
  <part name="popis" type="xsd:string" /> 
  <part name="zprava" type="xsd:string" /> 
  <part name="zppl" type="xsd:string" /> 
  <part name="datv" type="xsd:dateTime" /> 
  <part name="dats" type="xsd:dateTime" /> 
  <part name="datd" type="xsd:dateTime" /> 
  <part name="vf" type="xsd:string" /> 
  <part name="krechNr" type="xsd:string" /> 
  <part name="zrusId" type="xsd:string" /> 
  <part name="rel1Id" type="xsd:string" /> 
  <part name="nsidno" type="xsd:string" /> 
  <part name="typaidno" type="xsd:string" /> 
  <part name="akce" type="xsd:string" /> 
  <part name="komidno" type="xsd:string" /> 
  <part name="rsridno" type="xsd:string" /> 
  <part name="vlucidno" type="xsd:string" /> 
  </message>
- <message name="otevri_doklad2Response">
  <part name="return" type="ns1:fvz_ImpODFAImpl_otevri_doklad_Out" /> 
  </message>
  <message name="uzavri_doklad3Request" /> 
- <message name="uzavri_doklad3Response">
  <part name="return" type="ns1:fvz_ImpODFAImpl_uzavri_doklad_Out" /> 
  </message>
- <portType name="ImpODFAPortType">
- <operation name="zapis_radek">
  <input name="zapis_radek0Request" message="tns:zapis_radek0Request" /> 
  <output name="zapis_radek0Response" message="tns:zapis_radek0Response" /> 
  </operation>
- <operation name="reset_doklad">
  <input name="reset_doklad1Request" message="tns:reset_doklad1Request" /> 
  <output name="reset_doklad1Response" message="tns:reset_doklad1Response" /> 
  </operation>
- <operation name="otevri_doklad">
  <input name="otevri_doklad2Request" message="tns:otevri_doklad2Request" /> 
  <output name="otevri_doklad2Response" message="tns:otevri_doklad2Response" /> 
  </operation>
- <operation name="uzavri_doklad">
  <input name="uzavri_doklad3Request" message="tns:uzavri_doklad3Request" /> 
  <output name="uzavri_doklad3Response" message="tns:uzavri_doklad3Response" /> 
  </operation>
  </portType>
- <binding name="ImpODFABinding" type="tns:ImpODFAPortType">
  <soap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http" /> 
- <operation name="zapis_radek">
  <soap:operation soapAction="" style="rpc" /> 
- <input name="zapis_radek0Request">
  <soap:body use="encoded" namespace="ImpODFA" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" /> 
  </input>
- <output name="zapis_radek0Response">
  <soap:body use="encoded" namespace="ImpODFA" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" /> 
  </output>
  </operation>
- <operation name="reset_doklad">
  <soap:operation soapAction="" style="rpc" /> 
- <input name="reset_doklad1Request">
  <soap:body use="encoded" namespace="ImpODFA" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" /> 
  </input>
- <output name="reset_doklad1Response">
  <soap:body use="encoded" namespace="ImpODFA" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" /> 
  </output>
  </operation>
- <operation name="otevri_doklad">
  <soap:operation soapAction="" style="rpc" /> 
- <input name="otevri_doklad2Request">
  <soap:body use="encoded" namespace="ImpODFA" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" /> 
  </input>
- <output name="otevri_doklad2Response">
  <soap:body use="encoded" namespace="ImpODFA" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" /> 
  </output>
  </operation>
- <operation name="uzavri_doklad">
  <soap:operation soapAction="" style="rpc" /> 
- <input name="uzavri_doklad3Request">
  <soap:body use="encoded" namespace="ImpODFA" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" /> 
  </input>
- <output name="uzavri_doklad3Response">
  <soap:body use="encoded" namespace="ImpODFA" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" /> 
  </output>
  </operation>
  </binding>
- <service name="ImpODFA">
- <port name="ImpODFAPort" binding="tns:ImpODFABinding">
  <soap:address location="http://ifis.xxxx.cz/ws/ImpODFA" /> 
  </port>
  </service>
  </definitions>

Technická specifikace databázové části datového rozhraní PACKAGE fis_01.IMP_ODFA

/***********************************************************************
   Jmeno:    IMP_ODFA
   Ucel:    Import pohledávek do FIS*Finance
***********************************************************************/
FUNCTION Otevri_Doklad
POPIS : Funkce otevira rozhrani pro nasledne zpracovani pohledavky

VYSTUP: výstupem je popis chyby, pokud nějaká chyba nastane
VSTUP : "firmidno_" vnitrni identifikator adresy firmy oberatele
                   (nepovinny), ma prednost pred argumentem "ico_"
        "ico_" ICO firmy odberatele, povinne, pokud neni uveden argument
                  "firmidno_"
        "kopridno_" vnitrni identifikator adresy firmy konecneho
            prijemce (nepovinny), ma prednost pred argumentem "icokp_"
        "icokp_" ICO firmy konecneho prijemce, nepovinne. Pokud je
                  uveden argument "kopridno_", ignoruje se
        "mesic_" ucetni obdobi pohledavky - mesic, nepovinne
        "rok_" ucetni obdobi pohledavky - rok, nepovinne
        "mena_" Mena pohledavky, povinne
        "penale_" denni penale v %, nepovinne
        "vsmb_" variabilni symbol, max 10 znaku, nepovinne
        "ksmb_" konstantni symbol, max 10 znaku, nepovinne
        "ssmb_" specificky symbol, max 10 znaku, nepovinne
        "pril_" prilohy, max 20 znaku, nepovinne
        "cdl_" číslo dod.listu nebo číslo dokladu v externí aplikaci, max 15 znaku, nepovinne
        "dodp_" čislo objednávky nebo dodavkoveho prikazu, max 10 znaku, nepovinne
        "popis_" Popis dokladu, volny text max 255 znaku, nepovinne
        "zprava_" Zprava pro odberatele, volny text max 255 znaku, nepovinne
        "zppl_" zpusob uhrady, možné hodnoty P–Prikazem,H-Hotovosti, I-Inkasem, povinne
        "datv_" Datum vystaveni pohledavky,nepovinne
        "dats_" Datum splatnosti pohledavky,nepovinne
        "datd_" datum plneni DUZP, nepovinne
        "vf_"  typ dokladu, povinné, možné hodnoty 'N' - vystavená faktura/vnitropodniková faktura nebo'P' - zálohový list
"krech_nr_" cislo importovaneho dokladu v externí aplikaci, max 15 znaku, povinne
        "zrus_id_" zatim nevyuzivany parametr, max 15 znaku nepovinne
        "rel1_id_" zatim nevyuzivany parametr, max 15 znaku nepovinne
        "nsidno_"    id nakladoveho strediska, nepovinne, default null
        "typaidno_"  id typu akce, nepovinne, default null
        "akce_"      id akce, nepovinne, default null
        "komidno_"   id komplexní polozky, nepovinne, default null
        "rsridno_"   id radku smlouvy, nepovinne, default null 
	  "vlucidno_"  id vlastniho bank. uctu, nepovinne, default null
        "schvaluje_" osobni nebo rodne cislo osoby, ktera schvaluje doklad,
                     default null
        "prpartn_"   konečný příjemce i s adresou, volný text max 255 znaku,
                     default null, přednost má kopridno_ a icokp_
        "ns_"        číslo NS, přednost má nsidno_, default null
        "ta_"        číslo TA, přednost má typaidno_, default null
        "nakce_"     název akce, přednost má akce_, default null
        "kp_"        číslo komplexní položky, přednost má komidno_, default null
        "ejidno_"    číslo cílové EJ, default null - v tom pripade je to EJ uzivatele,
        "todfidno"   id deníku, default null
        "tof_"       číslo deníku, default null
        "datk_"      datum kurzu, default null

NAVRATOVA HODNOTA : Pri chybe vraci FALSE jinak vraci TRUE.
***********************************************************************/
 
/***********************************************************************
   FUNCTION Zapis_Radek
POPIS : Funkce zapisuje radek pohledavky. Radky nelze zapisovat, pokud
  Nebylo provedeno otevreni dokladu pomoci funkce Otevri_Doklad.

VSTUP : "text_" text radku, nepovinne, max 255 znaku
        "mj_" merna jednotka, max 10 znaku, nepovinne
        "pocet_" mnozstvi, nepovinne
        "cenamj_" cena za jednotku v domaci nebo cizi mene, nepovinne
        "cenc_" zaklad dane v domaci mene, povinne
        "zcm_" castka v cizi mene, povinne, pokud je zavazek v cizi mene
        "zdcm_" zaklad dane v cizi mene nepovinne
        "dcm_" castka DPH v cizi mene, nepovinne
        "hdan_" castka DPH v domaci mena, povinne
        "sazba_" sazba DPH v %
        "stav_" stav radku (kvuli zaloham), povinne, povolena pouze hodnota 'E'
        "DANIDNO_" id sazby DPH viz. sazebník DPH (J_SZD), nepovinne, default null
        "nsidno_"   id nakl. Strediska (ELAURI_VW), nepovinne, default null
        "typaidno_" id typu akce, nepovinne (ELAURI_VW), default null
        "akce_"     id akce, nepovinne (ELAURI_VW), default null
        "komidno_"  id komplexni polozky (ELAURI_VW), default null
        "rsfidno_"  id radku ceny ze smlouvy (viz.iFIS*Smlouvy), default null
"kodal_"    id analytickeho uctu
"audal_"    číslo analytického účtu, default null
"ns_"       číslo NS, přednost má nsidno_, default null
"ta_"       číslo TA, přednost má typaidno_, default null
"nakce_"    název akce, přednost má akce_, default null
"kp_"       číslo komplexní položky, přednost má komidno_, default null

VYSTUP : "Chyba" - text chyboveho hlaseni pri chybe.
NAVRATOVA HODNOTA : Pri chybe vraci FALSE jinak vraci TRUE.
***********************************************************************/



/***********************************************************************
   FUNCTION Uzavri_Doklad
POPIS :  Funkce provadi formalni kontroly uplnosti dokladu, uzavira jej
         pro dalsi zpracovani v uloze Finance a inicializuje rozhrani
         pro zpracovani dalsiho dokladu.
VYSTUP : "Chyba" - text chyboveho hlaseni pri chybe.
      "CisloDokl" - cislo dokladu pod kterym byl doklad ulozen do
             tabulky rozhrani
NAVRATOVA HODNOTA : Pri chybe vraci FALSE jinak vraci TRUE.
***********************************************************************/


/***********************************************************************
   PROCEDURE Reset_Doklad
POPIS :  V pripade ze dojde k chybe pri zapisu radku dokladu nebo pri
         uzavreni dokladu je nutne inicializovat rozhrani touto
         procedurou. Zaroven tato procedura provadi rollback k okamziku
         otevreni dokladu.
***********************************************************************/

Podrobnější komentáře k některým vstupním argumentům v db rozhraní PACKAGE fis_01.IMP_ODFA:

a) funkce otevri_doklad

• firmidno_ a ico_ - Jeden z těchto parametrů musí být v rámci volání funkce vyplněný. Pokud jsou vyplněny oba, přednost má firmidno_, ve kterém se předpokládá jednoznačný identifikátor partnera. Pokud je vyplněn pouze porametr ico_, hledá se firma s IČO, které je obsahem parametru. U takové firmy se hledá její hlavní část. Pokud žádná její část není označena jako hlavní, kontroluje se, zda existuje pouze jedna. Ta se předvyplní na importovaný doklad v iFIS/Pohledávky. Pokud jich existuje více, je vydáno chybové hlášení a předání podkladů pro vystavení pohledávky skončí neúspěšně chybou.
• kopridno_ a icokp - parametry pro identifikaci konečného příjemce. Mohou být prázdné. Jinak platí totéž, co platí i pro předchozí dvojici vstupních parametrů.
• mesic_ a rok_ - udávají účetní období, do kterého se má budoucí pohledávkový doklad zapsat. Když jsou prázdné, pohledávka se zapíše do aktuálně otevřeného období pro pohledávky (lokální parametr ODFAMES1)

b) funkce ZapisRadek

• sazba_ - pokud je zadána pouze číselná hodnota sazby DPH, pak se do na doklad v iFIS předvyplňuje pouze tato základní hodnota, konkrétní sazbu DPH pak musí uživatel iFIS vybrat ze seznamu možných hodnot.
• danidno_ - identifikátor sazby DPH ze sazebníku DPH (J_SZD.szd_id), vstupní parametr sazba_ musi být uveden současně také a nesmí být v rozporu s identifikací sazby v parametru danidno_.

	Pozor
	I na nedaňové řádky faktury je nutné uvádět sazbu daně určenou výhradně pro nedaňové finanční operace. Na zálohových listech je vždy uváděna sazba 0% Není daňový doklad. Fakturované částky nejsou v iFIS nikterak kontrolovány. Kontroly částek nejsou prováděny ani podle sazby DPH ani podle kurzu. Výpočty fakturovaných částek zajišťuje externí aplikace. iFIS tyto částky pouze přebírá 1:1.

Názorný příklad zápisu nového dokladu pomocí konektorů iFIS přes standardní prostředek SQL*Plus.

SQL> connect USER_EXT_APL_XXX /XXXXX@testdb
Spojeno.
SQL> @C:\imp_pohl
Byl vygenerovan podklad č.117 pro vystavení pohledavky v iFIS.

Procedura PL/SQL úspěšně dokončena.

Potvrzení transakce dokončeno.


Obsah souboru IMP_POHL.sql:

Set serveroutput on size 1000000;
declare
    chyba varchar2(2000);
    cislodokl number(10);
  begin
    if not imp_odfa.otevri_doklad(
            chyba,
            null,  -- id partnera - firmy
            '40755592', --ICO (ICO BBM z evidence partneru)
            null,   -- id konecneho prijemce
            null,   -- ico konecneho prijemce
            null,   -- mesic
            null,   -- rok
            'KC',  -- mena
            null,   -- denni penale v procentech
            null,   -- slevy v procentech
            null,   -- variabilni symbol
            '308',  -- konstantni symbol
            null,   -- specificky symbol
            null,   -- prilohy
            null,   -- cislo dodaciho listu
            null,   -- dodavkovy prikaz
            'pokusny import', -- popis dokladu
            'Zprava pro prijemce',
            'P',           -- zpusob uhrady
            trunc(sysdate), -- datum vystaveni dokladu
            trunc(sysdate+10), -- datum splatnosti
            trunc(sysdate), -- DUZP
            'N',            -- typ dokladu, N=faktura, P=zalohovy list
            1,              -- ZDE UVEST cislo importovaneho dokladu z externí aplikace(nelze opakovane zapisovat stejne cislo dokladu)
            null,           -- zatim se nevyuziva
            null,           -- zatim se nevyuziva
            null,           -- id nakladoveho strediska
            null,           -- id typu akce
            null,           -- id akce
            null,           -- id komplexni polozky
            null,           -- id radku smlouvy (vyuziva se jen pri generovani z RS)
            null            -- id vlastniho bankovniho uctu
    ) then
      imp_odfa.reset_doklad;
      RAISE_APPLICATION_ERROR(-20103, chyba);   
    end if;
    /*zacatek smycky pro zapsani vsech radku dokladu*/
    if not imp_odfa.zapis_radek(chyba,
                       'Text 1. radku',
                       'ks', -- merna jednotka
                       3,    -- pocet mernych jednotek,
                       500,  -- cena za MJ
                       1500, -- zaklad dane
                       null, -- castka v cizi mene vcetne dane
                       null, -- zaklad dane v cizi mene
                       null, -- dan v cizi mene
                       75,   -- èástka DPH
                       5,    -- hodnota sazby DPH
                       'E',
                       null, -- id sazby DPH
                       null, -- id nakladoveho strediska
                       null, -- id typu akce
                       null, -- id akce
                       null, -- id komplexni polozky
                       null  -- id radku smlouvy (vyuziva se pri generovani z RS)
    ) then
      imp_odfa.reset_doklad;
      RAISE_APPLICATION_ERROR(-20104, chyba);   
    end if;
    --konec smycky pro zaspani vsech radku dokladu
    if not imp_odfa.uzavri_doklad(chyba,cislodokl) then
      imp_odfa.reset_doklad;
      RAISE_APPLICATION_ERROR(-20105, chyba);   
    end if;
    -- ZDE je mozno prevzit cislo vygenerovaneho podkladu pro vystavení pohledavky iFIS, které je ulozeno v promenne cislodokl
    dbms_output.put_line('Byl vygenerovan podklad č.'||cislodokl||' pro vystavení pohledavky v iFIS.');
  end;
/
commit;