Structuri de Import Json¶
EMSYS va prelua din aplicatia de facturare energie termica urmatoarele informatii prin proceduri API REST:
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
Notă
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.
Solduri¶
Pe acesta structura se preia soldul pe fiecare factura la data implementarii.
Implementarea se va face la 1 ianuarie a anului.
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 |
Notă
Preluarea facturilor in sold se face dupa data operarii
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
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 |
Notă
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
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 |
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
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) |
Notă
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
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 |