Package: xl2roefact
RENware Software Systemsxl2roefactPentru accesul la toate link-urile din acest document vizitatisite-ul dedicat:https://invoicetoroefact.renware.eu/acestui sistem.FacilitatiAceasta componenta este "totul despre crearea de facturi electronice" din formatul Excel office (xlsx). Aplicatia poate genera factura in format JSON, XML, PDF si o poate incarca in sistemulRO E-Fact[^ld_roefact].Aceasta componenta ofera urmatoarele facilitati (acestea fiind obiectivele fundamentale ale componentei):transformarea facturilor din Excel in formatulXMLcerut de catre sistemul ANAF RO E-Fact pentru incarcareincarcarea acestorain sistemul ANAF RO E-Fact[^ld_roefact]transformarea facturilor din Excel intr-un formatJSONintermediar, independent de platforma si care permite integrarea acestora cu alte sisteme (standardREST)generarea facturii in format PDFpentru transmiterea acesteia catre client, semnarea electronica, tiparirea si arhivarea acesteia in format fizic (in general manipularea facturii in format"human readable")Componenta ofera doua instrumente pentru realizarea si indeplinirea acestor obiective:xl2roefactoaplicatie de tip linie de comanda(disponibila pentru sistemele de operare Windows, Linux si MacOS)xl2roefact PyPioblioteca standard Pythonutilizabila pentru dezvoltari proprii in scopul extinderii altor sisteme existente (custom development)Instalarea aplicatiei xl2roefactPachetele de instalare suntdisponibile aici.
Pachetele disponibile contin in numele lor versiunea de aplicatie utilizata si sistemul de operare pentru care sunt disponibile:MSIpachet instalare pentruWindowsDEBpachet instalare pentruLinux Debian(verificati disponibilitatea pentru varianta sistemului de operare folosit de dvs)EXEexecutabilWindows in format "portabil" (un singur fisier)NOTA 1:pentru echivalent utilizareportabila pentru Linuxse va instala biblioteca Python (vezi sectiuneaxl2roefact PyPi library) dupa care devine utilizabil scriptul Python "ca orice alta comanda Linux"NOTA 2:pachetulMSIpentruWindowseste disponibil in orice variante / versiuni al sistemului. Optiunile pentruLinuxsunt mult mai flexibile si astfel celelalte pot lipsi insa pot fi disponibile graruit, la cerere.Configurarea aplicatiei xl2roefactParametrii de configurare a plicatiei se gasesc in fisierulconfig_settings.py. Acestia sunt sub elaborati in limbaj Python prin utilizarea conventiilor de constante conform recomandarilor PEP (numele capitatlizat) si sunt acompaniti de linii de explicatii privind aplicabilitatea lor.Configurare aplicatiei se poate face interactiv si din aplicatie. Pentru a obtine help referitor la detaliile comenzi se va folosixl2roefactsettings--helpComenzile aplicatieiInterfata aplicatie este realizata utilizind conventiile si practicile uzuale pentru aplicatii tip linie de comanda consola. Pentru informatii privind comenzile se poate folosi optiunea dehelp, dispobilia atit la nivelul general:xl2roefact--helpcit si la nivel detaliat pentru fiecare comandaxl2roefact[COMMAND]--helpLista comenzilor:about- Afiseaza informatii despre aceatsa aplicatie (copyright, scop, etc)settings_ Afiseaza parametrii de configurare a aplicatiei.Vezi sectiunea de configurare a aplicatieixl2json- Transforma fisierul (fisierele) Excel in forma JSON pentru utilizare ulterioara ca forma de date standardizat pentru schimbul de informatii cu alte sisteme electroniceComenzile detaliate:::: mkdocs-typer
:module: xl2roefact.app_cli
:command: app_cli
:prog_name: xl2roefact
:depth: 2Practici si regului referitoare la continutul facturilor din ExcelAcest capitol se refera la modul in care este "tratat" continutul fisierului Excel cu factura, mai exact la modalitatea in care informatia facturii este cautata, identificata si gasita in scopul de a fi salvata in oricare din formatele de "factura electronica / E-Fact".Utilizarea sablonului de factura Excel ce este livrat impreuna cu aplicatiaESTE O VARIANTA DE LUCRU RECOMANDATA, dar nu obligatorie. Chiar si in cazul utilizarii acestuia, prin modificarea "structurii" acestuia, informatia poate ajungenerecognoscibila / neidentificabilatotal sau partial daca nu sunt urmate regulile expuse.In general trebuie facuta diferenta intre datele facturii si modul in care aceasta va fi tiparita (va aparea la tiparire / previzualizare).Mai exactcontinutul informationalal facturii nu trebuie nici confundat si nici mixat cuformatul de afisare al acesteia(layout). Pentru acesta din urma se recomanda a fi folosite cu precadereregulile de formataredin Excel si nu cele stocare a datelor. Un exemplu este un numar zecimal oarecare unde:una este valoarea introdusa intr-o celula (de ex cu 3 zecimale) sialta este valoarea afisata (cu 2 zecimale) - aceasta din urma trebuie obtinuta prin formatarea celulei respective de a afisa 2 zecimale prin rotunjire insa valoarea efectiva trebuie sa fie cea originala cu 3 zecimale, lucru (diferenta) care se poate vedea la editarea continutului celulei.Tutorial utilizare aplicatieOrganizarea informatieiAplicatiaxl2roefact"promoveaza" structurarea informatiei procesate astfel incit sa fie evitata situatia"de aglomerare" a directorului curent cu fisierece trebuiesc identificate si izolate in situatia in care se facprocesari in masa(pe mai multe fisiere / facturi sursa).Astfel, aplicatia se asteapa ca fisierele Excel sursa (adica facturile de procesat) sa fie copiate in directorulinvoice_files/de unde vor fi citite si tot aici vor fi create fisierele rezultate (JSON, XML, etc). Acest director este relativ la directorul curent de unde este lansata aplicatia si considerat"implicit"cu acest nume dar daca se doreste un alt director acest lucru poate fi facut folosind parametrul--files-directory(sau prescurtat-d) la lansarea aplicatiei astfel:xl2roefact-d"calea si numele directorului dorit"!!! note "Nota"
Ghilimelele sunt necesare numai daca numele si calea (path) contin caracterul spatiu.Exemple:pentru stabilirea directorului curent ca sursa pentru fisierele factura Excel:xl2roefact-d./procesarea tuturor facturilor facturilor din lunaiunie, copiate intr-un director dedicat sub directorul curent:xl2roefact-d./facturi_iunie/Exemplu de procesare a unei facturise creaza directorul recomandat pentru stocarea facturilor in Excel:mdinvoice_filesse copiaza facturafactura_A.xlsxin acest director apoi se revine in directorul anterior daca acesta a fost schimbat pentru efectuarea copieriise lanseaza aplicatia:xl2roefactxl2jsonIn urma acestor operatii, in directorulinvoice_filesvor rezulta:invoice_files/
    factura_A.xlsx  # fisierul Excel original
    factura_A.json  # fisierul JSON rezultat in urma procesariifactura_A.xlsxca fiind fisierul Excel original cu facturafactura_A.jsonacesta fiind fisierul format JSON rezultat in urma procesarii si ce poate fi folosit pentru interschimbarea electronica a informatiei intre sistemeAspecte tehnice referitoare la formatul fisierului JSON aferent facturiiAcest fisier este cel generat de catre aplicatie in urma executiei acesteia cu comandaxl2json. Formatul JSON are urmatoarra structura de baza:{"Invoice":{...},"meta_info":{...},"excel_original_data":{...}}Cheile de la primul nivel contin:Invoice- datele efective ale facturiimeta_infoinformatii referitoare la procesarea facturii si mapa de conversie a cheiiInvoicedin formatulJSONin formatulXMLcerut de sistemulRO E-Factharta de ajutor in conversia formatului JSON in formatul XML acceptat de sistemul RO E-Fact (cheiemeta_info.map_JSONkeys_XMLtags) si definititiile XML aferente (cheiemeta_info.invoice_XML_schemes)alte informatii despre fisierul Excel prelucrat (numele, worksheet cu factura, data si ora procesarii, CRC pentru verificare, etc)excel_original_data- informatiile originale din fisierul Excel, asa cum au fost ele identificate si gasite precum si locatia (adresele celulelor). Aceste informatii sunt utile in cazul in care exista neclaritati in urma procesuluicde conversie pentru "a intelege" de unde si cum arata informatiile originale din fisierul ExcelPentru detalii suplimentare despre formatul JSON trebyie consultata componenta referitoare labibliotecaxl2roefactdestinata dezvoltarii software.Descarcare (download) aplicatie xl2roefact CLIPachet instalare aplicatie WindowsPachet instalare script PythonDate identificarepart number (p/n):0000-0095-xl2roefactproducator si copyright: RENWare Software Systemsauthor: Petre Iordanescu (petre.iordanescu@gmail.com)LicenseNote[^ld_roefact]: Toate interactiunile cu sistemulANAF RO E-Factnecesita oconexiune la internetsi un set decredentiale ANAF RO E-Fact ale companieipentru care se incarca factura. In lipsa acestora, fisierulXMLgenerat de aplicatie poate fi incarcat ulterior (de ex de catre departmentul contabilitate)