hCONT

Nivelul la care are loc importul depinde de aplicaţia care execută operaţia de export. De exemplu, hCONT transferă informaţiile între baze de date ierarhice la nivel carte mare. Alte aplicaţii pot transmite la nivel de documente.
De fapt, nivelul este determinat de structura fişierului de import.

Fişierul care se importă trebuie să fie de tip DBF, recunoscut de CLIPPER5.

Structura fişierului ce se importă este prezentată în tabela de mai jos. O parte dintre aceste câmpuri sunt obligatorii, iar o parte opţionale.

• AN - reprezintă exerciţiul financiar în care au fost generate datele. Vor fi importate datele doar pentru anul contabil curent.
• LUNA - este un câmp de caractere, şi reprezintă numărul lunii la care se referă formula respectivă. Valorile posibile au forma: 01, 02, …, 09, 10, 11, 12. De obicei toate formulele sunt din aceeaşi lună, dar este posibil să coexiste şi înregistrări din mai multe luni. Oricum în operaţia de import vor fi selectate doar formulele care se referă la luna curenta.
• NRJUR - codul jurnalului în care poate fi importată acea formulă. Datorită acestui câmp, în acelaşi fişier pot să coexiste articole destinate mai multor jurnale contabile.
• CODDCM - tipul documentului de care aparţine formula. Tipul de document conţinut de CODDCM trebuie să existe în hCONT.
• NRDOC - numărul documentului de care aparţine formula. Dacă conţine litere, acestea trebuie să fie litere mari.
• DATADOC - data documentului de care aparţine formula. Datele calendaristice în fişier se înregistrează în formatul: ll/zz/aa (forma americană).
• REF - câmpul de explicaţii referitor la formulă.

• CONTDB, CONTCR - reprezintă contul debitor, respectiv contul creditor din formulă. Ambele câmpuri trebuie să fie completate cu câte un cont.

  Dacă conturile există în Planul de conturi, trebuie să fie deschise şi să fie conturi pe care se poate contabiliza (pot fi sintetice sau analitice, dar să nu aibă descendenţi).

  Dacă nu există, va fi adăugat automat dacă i s-a transmis titlul şi devine un cont de ultimul nivel. Dacă noul cont ar face parte dintr-un nivel superior, adăugarea nu va avea loc.

• UMDB, UMCR - dacă sunt completate, reprezintă o înregistrare cantitativă. Înregistrarea cantitativă trebuie să fie precedată de înregistrarea valorică la care este subordonată.

  Poate fi completat doar unul dintre câmpurile UMDB şi UMCR. Dacă se înregistrează pe ambele, înregistrarea cantitativă debitoare trebuie să fie prima, urmată de înregistrarea cantitativă creditoare. Pentru completare vezi exemplele de mai jos.

• TITDB, TITCR - titlul conturilor din formula curentă.
• VAL - este valoarea cu care se debitează simultan contul din CONTDB şi cu care se creditează contul din CONTCR, în cazul înregistrărilor valorice, şi cantitatea cu care se debitează sau se creditează (după caz) contul cantitativ.
  Conţinutul lui VAL poate fi un număr pozitiv sau negativ din intervalul:
  [-99 999 999 999.99, 999 999 999 999.99].
• NB_UPD - reprezintă numărul de punere la zi a articolului. Această valoare nu are nici o semnificaţie din punctul de vedere al operaţiei de import şi ca atare nici nu este folosită.
• Dacă lipsesc câmpuri opţionale din fişierul de import, informaţiile (câmpurile) corespunzătoare din articole contabile, rămân necompletate.
• Dacă oricare dintre câmpurile obligatorii lipseşte, importul nu se execută.

• Pentru înregistrările care aparţin aceluiaşi document, se genereză un singur articol contabil cu mai multe înregistrări.

  Condiţiile ca mai multe articole ale fişierului de import să fie considerate înregistrări contabile ale aceluiaşi articol contabil sunt următoarele:

  • să existe cel puţin unul dintre câmpurile CODDCM, NRDOC, DATADOC, REF în fişierul de import,
  • cel puţin unul dintre aceste câmpuri să fie completat,
  • valorile câmpurilor completate să fie identice pentru toate înregistrările,
  • articolele să urmeze unul după celălalt în fişierul de import.

  Operaţia de import sesizează dacă toate conturile debitoare sau creditoare din acelaşi articol sunt identice şi în caz afirmativ generează o înregistrare compusă. hCONT nu ordonează articolele fişierului de import. Acest lucru trebuie făcut de aplicaţia care creează fişierul.

• Dacă cel puţin unul dintre câmpurile CODDCM, NRDOC, DATADOC şi REF este prezent, importul poate fi făcut doar în jurnalul indicat de câmpul NRJUR.
• Dacă nici unul dintre câmpurile de mai sus nu este prezent, pentru toate articolele fişierului de import se generează câte un articol contabil cu o singură înregistrare contabilă. În acest caz primul caracter din câmpul NRJUR determină secţiunea de contabilitate. Importul poate fi făcut doar în secţiunea determinată de câmpul NRJUR. Deci în acelaşi fişier de import pot exista înregistrări din mai multe secţiuni de contabilitate (ex. C-Secţiunea bilanţ, G-Secţiunea contabilitate de gestiune).
• Dacă câmpul NRJUR este absent, datele pot fi importate în oricare dintre jurnale.
• Operaţia de import suportă două nivele de siguranţă, setabile în Parametri:
  • IMP_COMMIT := „N“ - forţează scriere pe disc (COMMIT) după fiecare articol importat „D“ - Da, „N“ - Nu
  • IMP_COMMIT := „N“ - este varianta implicită:
    După fiecare înregistrare importată se execută scrierea fizică a datelor pe disc. Este mai sigură la căderile accidentale de sistem, însă are dezavantajul că este considerabil mai lentă decât varianta IMP_COMMIT:=„D“.
  • IMP_COMMIT := „D“ :
    Scrierea efectivă a datelor importate pe disc se realizează periodic şi la sfârşit, după ce toate datele au fost importate. Importul realizat cu această variantă este mult mai rapid, însă la căderile accidentale de tensiune/sistem, în anumite cazuri, poate provoca incoerenţe în baza de date. Aceste incoerenţe se rezolvă fie prin reindexarea bazei de date, fie prin restaurarea ultimei salvări (copii), fie cu asistenţa distribuitorului.

Exemple:
1. fişierul de importat conţine doar câmpurile obligatorii:

    LUNA    CONTCR    CONTDB     VAL        NB_UPD
    ----------------------------------------------
    ...
    02      301       401        1390.00    0
    02      345       711        1150.00    0
    02      371       401        3400.00    0
    ...

2. fişierul de importat conţine toate câmpurile posibile:

AN LUNA NRJUR CODDCM NRDOC DATADOC    REF        CONTDB    UMDB TITDB   CONTCR   UMCR TITCR   VAL    NB_UPD
-----------------------------------------------------------------------------------------------------------
...
15 07   CR    NIR    P001  03/07/2015 F001/30.06 301.02                 401.1.01      AAA SRL 200.00 0
15 07   CR    NIR    P001  03/07/2015 F001/30.06 301.02    CUT          401.1.01      AAA SRL  40.00 0
15 07   CR    NIR    P001  03/07/2015 F001/30.06 4426.01                401.1.01      AAA SRL  38.00 0
...
15 07   CV    FACT   F101  03/07/2015 Vinz. prod 4111.1.03      XXX SRL 707.01               1000.00 0
15 07   CV    FACT   F101  03/07/2015 Vinz. prod 4111.1.03      XXX SRL 4427                  190.00 0
....

3. înregistrare contabilă cantitativă:

  
  ...  CONTDB    UMDB  TITDB    CONTCR     UMCR  TITCR      VAL       NB_UPD
  --------------------------------------------------------------------------
       301.01                   401.1.01         AAA SRL    210.00    0
       301.01    BUC            401.1.01         AAA SRL     10.00    0

4. înregistrări în valută în debit şi credit:

  
  ...  CONTDB    UMDB  TITDB    CONTCR     UMCR  TITCR      VAL       NB_UPD
  --------------------------------------------------------------------------
       5124.01                  411.2.01         AAA LTD    210.00    0
       5124.01   EUR            411.2.01         AAA LTD     50.00    0
       5124.01                  411.2.01   EUR   AAA LTD     50.00    0

5. înregistrare în valută numai în credit:

  ...  CONTDB    UMDB  TITDB    CONTCR     UMCR  TITCR      VAL       NB_UPD
  --------------------------------------------------------------------------
       401.2.02        BBB LTD  5124.01                     420.00    0
       401.2.02        BBB LTD  5124.01    EUR              100.00    0

6. înregistrări contabile cantitave şi în valută:

  
  ...  CONTDB    UMDB  TITDB    CONTCR     UMCR  TITCR      VAL       NB_UPD
  --------------------------------------------------------------------------
       301.01                   401.2.01         AAA LTD    210.00    0
       301.01    BUC            401.2.01         AAA LTD     10.00    0
       301.01                   401.2.01   EUR   AAA LTD     50.00    0