Differences

This shows you the differences between two versions of the page.

--- interoperabilita:gdxp [2014/11/12 14:42] – creata letti
+++ interoperabilita:gdxp [2014/11/17 16:33] (current) – Decisione prese al tavolo tecnico di interoperabilità del GDL del 15/11/14 letti
@@ Line 1: / Line 1: @@
+==== GDXP ====
 <code>
@@ Line 355: / Line 357: @@
 </code>
+Il gdxp rappresenta un ordine o un listino, a seconda che sia presente (almeno) un elemento ordine.
+==== Struttura ====
+In questa sezione viene esaminato il formato per verificarne l'applicabilità a Gasista Felice. In particolare,
+si vuole verificare quali e quante modifiche al formato si renderebbero necessarie per esportare / importare
+listini e ordini dal / nel software.
+> Sono state esaminate le parti di Gasista Felice che sarebbero interessate dal processo di importazione / esportazione dei dati.
+**Supplier**
+  * id
+  * name [name]
+  * seat_id [address]
+  * vat_number [EXTRAFIELD]
+  * ssn [taxCode]
+  * website [EXTRAFIELD]
+  * frontman_id [EXTRAFIELD]
+  * flavour [EXTRAFIELD]
+  * n_employers [EXTRAFIELD]
+  * logo [EXTRAFIELD]
+  * iban [EXTRAFIELD]
+  * description [note]
+**base place** --> [ADDRESS]
+>> SERVIRANNO DEGLI [EXTRAFIELDS]
+  * id
+  * name ???
+  * description ???
+  * address [street]
+  * zipcode [zipcode]
+  * city ???
+  * province ???
+  * lon ???
+  * lat ???
+**contact** --> [PRIMARY] [EXTRAFIELDS]
+  * id
+  * flavour --> tipo, da usare per decidere se inserire il value in [phone],[fax] ecc
+  * value
+  * is_preferred
+  * description
+>> Qui andrebbe cambiata la struttura. Piuttosto che:
+>>    * contacts
+>>      * primary [phone,fax,email,web]
+>>      * extra* [first_name, last_name, phone, mobile, fax, email]
+>>
+>> Sarebbe meglio:
+>>
+>>    * contacts
+>>      * primary*(flvour, value, description) --> quello preferito per il flavour
+>>      * extra* (first_name, last_name, phone, mobile, fax, email) --> per mantenere la compatibilità
+**
+supplier_product** --> anagrafica prodotto [PRODUCTS]* --> [PRODUCT]
+  * id
+  * code [EXTRAFIELD]
+  * producer_id
+  * category_id [category]
+  * mu_id [um]
+  * pu_id [EXTRAFIELD]
+  * muppu [EXTRAFIELD]
+  * muppu_is_variable [EXTRAFIELD]
+  * vat_percent [EXTRAFIELD]
+  * name [name]
+  * description [description]
+  * deleted [EXTRAFIELD]
+------
+**supplier_stock** --> prodotto ordinabile
+  * id
+  * supplier_id --> supplier
+  * product_id --> anagrafica del prodotto
+  * supplier_category_id  [VARIANT]
+  * image [VARIANT]
+  * price [ORDERINFO][umprice]
+  * code [PRODUCT][sku]
+  * amount_available [ORDERINFO][max quantity]
+  * units_minimum_amount [VARIANT]
+  * units_per_box [VARIANT]
+  * detail_minimum_amount [VARIANT]
+  * detail_step [VARIANT]
+  * delivery_notes [VARIANT]
+  * deleted [VARIANT]
+)
+**gas_supplier_stock** --> prodotto ordinabile all'interno di un patto supplier - gas
+  * id
+  * pact_id
+  * stock_id
+  * enabled [VARIANT]
+  * minimum_amount [ORDERINFO][minimum quantity]
+  * step
+**gas_supplier_order_product** --> ordine di un prodotto all'interno di un patto
+  * id
+  * order_id
+  * gasstock_id
+  * maximum_amount [ORDERINFO][max quantity]
+  * initial_price [VARIANT]
+  * order_price [VARIANT]
+  * delivered_price [VARIANT]
+  * delivered_amount[ORDERINFO][PackageQuantity]
+------
+**gas_supplier_order** --> ordine dei gasisti su un patto supplier - gas [ORDERS]* --> [ORDER]
+  * id
+  * pact_id
+  * datetime_start [opendate]
+  * datetime_end [closedate]
+  * order_minimum_amount [EXTRAFIELD]
+  * delivery_id
+  * withdrawal_id
+  * delivery_cost [EXTRAFIELD]
+  * referrer_person_id
+  * delivery_referrer_person_id
+  * withdrawal_referrer_person_id
+  * group_id
+  * invoice_amount [EXTRAFIELD]
+  * invoice_note [EXTRAFIELD]
+  * root_plan_id
+** delivery **
+  * id
+  * place_id
+  * date [ORDER][deliveryDate]
+==== Incontro GDL sull'interoperabilità del 15/11/2014 ====
+> Conteunti presi da: http://piratepad.net/ANbI4uJ8VG
+Durante il tavolo tecnico per lo standard il formato **GDXP** è stato esaminato al fine di verificarne l'espressività riguardo le entità e le relazioni coinvolte nell'attività di acquisto dei GAS.
+Il formato è visionabile al link https://github.com/madbob/GASdotto/wiki/GDXPTodo .
+Il tavolo ha prodotto le seguenti proposte di modifica / integrazione:
+> **NOTA**:  a livello di formato, inserire un numero limite di caratteri per il contenuto di alcuni campi.
+> **TODO**: in una versione successiva, abdrebbero inserite informazioni anche su accreditmento e rating del produttore/fornitore, anche tramite link a risorse esterne, come siti o social network
+  * elemento **supplier**:
+  * almeno un elemento tra **taxCode** e **vatNumber** deve essere presente. Se l'azienda è in realtà una singola persona fisica, questa potrà inserire il proprio codice fiscale.
+    * l'elemento **name** non dovrebbe contenere piu di 200 caratteri.
+    * l'elemento **note** dovrebbe essere opzionale
+    * aggiungere un campo obbligatorio **description**. Questo campo sarà utilizzato per inserire un descrizione verbosa del produttore/fornitore e non dovrebbe contenere piu di (un numero ancora da definire di) caratteri.
+    * aggiungere un elemento di nome **generator** che contenga l'informazione sull'esporatore che ha prodotto l'xml
+    * aggiungere un elemento di nome **source** che contenga l'informazione sulla fonte da cui viene esportato il produttore/fornitore (gestionale, ...)
+    * inserire un elemento obbligatorio **subject** che  indichi a quale soggetto (GAS, ..) si riferisce l'ordine o il listino rappresentati. Questo elemento conterrà due attributi:
+      * **id**
+      * **type**
+    * inserire un elemento **id** che, nel caso si rappresenti un ordine, indichi l'id dell'ordine stesso nel gestionale di provenienza
+    * inserire un elemento **tipology**  che indichi il tipo di azienda (coperativa, ditta individuale, azienda agricola, .... )
+  * elemento **address**:
+    * inserire un elemento facoltativo **extraFields** per dare la possibilità di specificare altre informazioni geografiche e logistiche
+  * elemento **primary**:
+    * elementi **faxNumber** e **webSite** opzionali
+  * elemento **extraContact**:
+    * almeno un campo tra **phoneNumber**, **mobileNumber** ed **emailAddress** deve necessariamente essere obbligatorio
+  * elemento **product**:
+    * nell'elemnto **um**  discutere a proposito della lista di unità di misura possibili. La proposta è di avere una lista ben definita di queste unità di misura, da adottare fra tutti i gestionali
+    * nell'elemento **category** definire in maniera univoca le categorie che è possibile inserire. Queste categorie dovrebbero essere condivise tra tutti i gestionali
+    * per ora l'elemento **description** non dovrebbe avere limitazioni nel numero di caratteri; eventualmente il soggetto importatore (es. un gestionale) ne troncherà il contenuto se eccessivamente lungo
+    * inserire un elemento **vat** che indichi il valore dell'iva relativa al prodotto; questo valore puo essere 0 se il produttore è una persona fisica che non applica l'iva ai prodotti.
+      * NOTA: inserire un attributo all'elemento **vat** [nome da definire: **toApply** come boolean?] che indichi se l'iva è da applicare al prezzo del prodotto (**umPrice** di **orderInfo** ), oppure se questo lo include già e quindi è da scorporare