======================== Structuri de Import Json ======================== EMSYS va prelua din aplicatia de facturare energie termica urmatoarele informatii prin proceduri API REST: :ref:`Parteneri ` :ref:`Solduri ` :ref:`Facturi ` :ref:`Incasari ` .. _Ident_Parteneri: Parteneri --------- +--------------------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ | Column_Name | Data Type | Comment | +================================+=======================+==========================================================================================================================================+ |cod_partener |Varchar(10) |Cod unic de identificare client: informatie prin care se identifica unic partenerul in EMSYS, respectiv codul partenerului din EMSYS | | | |Modalitate codificare in functie de grupa clientului: | | | | | | | | **Populatie**: „P” + „0..”+ numarul contractului (Exemplu: P00031). Se completeaza cu „0” pana la lungime de 5. | | | | | | | | **Agenti nebugetari**: „N”+”0..”+ numarul contractului (exemplu: N00020) | | | | | | | | **Agenti bugetari**: „B”+”0..”+ numarul contractului (exemplu: B00010) | | | | | | | | **Agenti primari**, unde: | | | | | | | | “N”+nr. contract+AA - pentru nebugetari | | | | | | | | “B”+nr. contract+AA - pentru bugetari | | | | | | | | nr. contract este NR_NR (notatie contract) si AA sunt ultimele 2 cifre ale anului. | | | | | | | | Exemple: B01_000_19, N04_004_15 | +--------------------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ |denumire |varchar(60) |Denumire partener | +--------------------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ |ID_Simetrix |N(20) |ID unic partener Simetrix | +--------------------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ |cod_fiscal |varchar(15) |Codul fiscal al partenerului persoana juridica | +--------------------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ |CNP |varchar(20) |Cod numeric personal pentru persoane fizice | +--------------------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ |localitate |varchar(50) |Numele localitatii de domiciliu. Pentru Bucuresti, completati: B1, B2, B3, B4, B5 sau B6, relativ la sector | +--------------------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ |judet |varchar(50) |Codul auto al judetului, ex: TM, BT, etc. Pentru Bucuresti, completati Judet cu B | +--------------------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ |adresa |varchar(100) |Adresa de domiciliu | +--------------------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ |banca |varchar(90) |Numele bancii unde este deschis contul partenerului | +--------------------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ |cont_bancar |varchar(20) |IBAN-ul contului deschis la banca | +--------------------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ |Categoria Client |varchar(10) |Grupa partenerului in EMSYS: | | | | | | | | 0 - Agenti primari nebugetari; | | | | | | | | 1 - Agenti primari bugetari; | | | | | | | | 2 - Populatie; | | | | | | | | 3 - Agenti secundari nebugetari; | | | | | | | | 4 - Agenti secundari bugetari | +--------------------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ |dataact |Date |Data calendaristica cand a fost actualizat ultima data partenerul | +--------------------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------------------------+ .. note:: Cod_partener reprezinta codul contractului partenerului. Acelasi partener poate avea mai multe contracte pe diferite categorii de client. Din motive de adaptare a tranzactiilor contabile pe conturile dezvoltate pe grupe de clienti, s-a adoptat solutia identificarii contractului in parteneri. Partenerii se actualizaeaza incepand cu dataact. .. _Ident_Solduri: Solduri ------- Pe acesta structura se preia soldul pe fiecare factura la data implementarii. Implementarea se va face la 1 ianuarie a anului. .. list-table:: :widths: 10 15 47 :header-rows: 1 * - Column_Name - Data_Type - Comment * - cod_factura - Int - Identificator unic al facturii * - seria_factura - varchar(9) - * - nr_factura - int(15) - * - Data - Date - Data emiterii facturii * - Data_operare - Date - Data inregistrarii, identificator dupa care se face selectia datelor * - cod_partener - varchar(10) - Cod partener - legatura cu tabela parteneri * - scadenta - Date - Data scadentei la plata * - luna - int - Luna de consum pentru care este emisa factura * - an - int - Anul consum pentru care este emisa factura * - Cod produs - varchar(18) - Codul produsului, legatura cu serviciul definit in EMSYS * - produs - varchar(255) - denumire produs * - Cod gestiune - varchar(15) - Cod gestiune, legatura cu Subgrupa servicii definita in EMSYS * - gestiune - varchar(255) - Denumire gestiune * - Cod_pt - varchar(18) - Sursa furnizare serviciu: Punctul termic, Centrala termica, Agent primar, legatura cu obiectul de cost/venit din EMSYS * - denumire_pt - varchar(60) - Denumire sursa furnizare produs/serviciu, legatura cu obiectul de cost definit in EMSYS * - sold - numeric(16, 2) - Valoarea soldului facturii .. note:: Preluarea facturilor in sold se face dupa data operarii .. _Ident_Facturi: Facturi ------- Reprezinta structurile dupa care se preiau facturile emise intr-o perioada. Sunt disponibile doua structuri Json: **1.** Antet factura - identifica informatiile despre o factura **2.** Detaliu factura - identifica seviciile facturate si valoarea si TVA **Antet Factura** .. list-table:: :widths: 10 15 47 :header-rows: 1 * - Column_Name - Data_Type - Comment * - cod_factura - Int - Identificator unic al facturii * - seria_factura - varchar(9) - * - nr_factura - int(15) - * - Data - Date - Data emiterii facturii * - Data_operare - Date - Data inregistrarii, identificator dupa care se face selectia datelor * - cod_partener - varchar(10) - Cod partener - legatura cu tabela parteneri * - scadenta - Date - Data scadentei la plata * - total_valoare - numeric(16, 2) - Valoarea serviciilor facturii * - total_TVA - numeric(16, 2) - Valoarea TVA pe factura * - total - numeric(16, 2) - Valoarea facturii, inclusiv TVA * - nr_contract - varchar(50) - Nr. contract partener * - Data_contract - Date - * - Explicatii - varchar(255) - * - taxare_inversa - bit - Daca este cu taxare inversa * - luna - int - Luna de consum pentru care este emisa factura * - an - int - Anul consum pentru care este emisa factura .. note:: Preluarea facturilor in sold se face dupa data operarii. Luna si anul reprezinta perioada fiscala in care se inregistreaza venitul pentru energia termica consumata de clienti. Data reprezinta data la care se inregistreaza TVA colectat. **Detaliu Factura** .. list-table:: :widths: 10 15 47 :header-rows: 1 * - Column_Name - Data_Type - Comment * - cod_factura - Int - Identificator unic al facturii, legatura cu antetul facturii * - Cod produs - varchar(18) - Codul serviciului facturat, legatura cu serviciul definit in EMSYS * - produs - varchar(255) - denumire produs * - Cod gestiune - varchar(15) - Cod gestiune, legatura cu Subgrupa servicii definita in EMSYS * - gestiune - varchar(255) - Denumire gestiune * - Cod_pt - varchar(18) - Sursa furnizare serviciu: Punctul termic, Centrala termica, Agent primar, legatura cu obiectul de cost/venit din EMSYS * - denumire_pt - varchar(60) - Denumire sursa furnizare produs/serviciu, legatura cu obiectul de cost definit in EMSYS * - cantitate - numeric(10, 6) - Cantitatea facturata * - tarif - numeric(10, 2) - Pretul serviciului * - Valoarea - numeric(16, 2) - Valoarea serviciului facturat * - TVA - numeric(16, 2) - Valoare TVA serviciu facturat * - cota_tva - numeric(5, 2) - Cota TVA (%) aplicata serviciului facturat .. _Ident_Incasari: Incasari -------- Reprezinta structurile dupa care se preiau incasarile si alte documente care sting factura intr-o perioada. Sunt disponibile doua structuri Json: **1.** Antet incasari - identifica informatiile despre modalitatea incasarii **2.** Detaliu incasari - identifica seviciile incasate **Antet Incasari** .. list-table:: :widths: 10 15 47 :header-rows: 1 * - Column_Name - Data_Type - Comment * - id - Int - ID unic antet incasare * - casa - varchar(60) - Numele casieriei din Simetrix * - cont_banca - varchar(30) - IBAN (NULL daca nu este incasare prin banca) * - tip_doc - varchar(15) - Denumirea Tipului de document * - nr_document - varchar(50) - Nr. document incasare * - data_doc - Date - Data document incasare * - data_operare - Date - Data operarii / data extrasului de cont * - cod_partener - varchar(10) - Cod partener - legatura cu tabela parteneri * - total - numeric(18, 2) - Total incasat * - Observatii - varchar(255) - .. note:: Data_operare reprezinta data extrasului de cont in cazul incasarilor prin ordine de plata, procesatori de plati, POS in casierie Casa completata si cont banca necompletat – incasari in numerar Casa completata si cont banca completat – incasari prin POS Casa necompletata si cont_banca completat – incasari prin banca cu Ordin de plata sau incasari prin procesatori de plati Casa si cont_banca necompletate – forme speciale de stingere a facturile in conformitate cu tip_doc, astfel: o Compensare incert – trecere factura in contul Clienti incerti o Compensare stornari – defalcare factura initiala cu factura de storno **Detaliu Incasari** .. list-table:: :widths: 10 15 47 :header-rows: 1 * - Column_Name - Data_Type - Comment * - Id_document - Int - Legatura cu antetul * - seria_factura - varchar(9) - Seria facturii incasate * - nr_factura - int(15) - Nr. facturii incasate * - Data_factura - Date - Data facturii incasate * - Cod gestiune - varchar(15) - Cod gestiune, legatura cu Subgrupa servicii definita in EMSYS * - Cod produs - varchar(18) - Codul serviciului facturat, legatura cu serviciul definit in EMSYS * - Total - numeric(16, 2) - Valoarea incasata din factura * - stare_factura - int(1) - Valori: 1 - Factura emisa; 2 - Factura trecuta in clienti incerti; 3 - Factura in litigiu; 4 - Factura extern bilant