Introduzione a UBL (Universal Business Language)

Transcript

1 Introduzione a UBL (Universal Business Language) Arianna Brutti arianna.brutti@bologna.enea.it Imola - 1

2 Sommario Introduzione a UBL Usare UBL Contestualizzare UBL Business collaboration supportate da UBL Casi d uso Imola - 2

3 UBL UBL (Universal Business Language) [ubl]: è sviluppato dall UBL Technical Committee di OASIS; è stato approvato come standard OASIS versione 1.0, novembre 2004; versione 2.0, dicembre 2006; è un generico formato di scambio dati basato su XML; è applicabile a tutti i settori industriali e commerciali; definisce un vocabolario standard di base che descrive le informazioni comuni a tutte le aree di business; consente di estendere il vocabolario di base per soddisfare le esigenze di specifici domini Imola - 3

4 Il commercio elettronico secondo UBL G s partners UBL Industria Generica G UBL Industria Tessile/Abb. UBL Ospedale H UBL Industria chimica C TexWeave HL7 CDIX T/A s partners H s partners C s partners Imola - 4

5 UBL ed ebxml 1/2 ebxml [ebxml]: definisce un architettura standard per il commercio elettronico; non si occupa della sintassi dei documenti di business. UBL: definisce una sintassi XML per i documenti di business base; è la prima implementazione Core Components ebxml Imola - 5

6 UBL ed ebxml 2/2 e b X M L Re gi stry / Re po si to ry UBL Context Meth Context Methodology UBL Library Core Components CPP/CPA ebbp ebms Message contextualization Standard messages Business agreements Business processes Packaging/ transport Imola - 6

7 UBL concretamente è: 1. una libreria di XML schema che definiscono componenti riusabili (es: Address, Party, Item, ); 2. un insieme di XML schema che definiscono generici tipi di documenti di business (Order, Invoice, ); 3. un metodo di contestualizzazione Imola - 7

8 Materiale di supporto diagrammi delle classi UML dei componenti; diagrammi delle classi UML dei tipi di documenti; spreadsheet: descrivono i componenti e come vengono combinati in modo da costruire i tipi di documenti; esempi di istanze di tipi di documenti UBL; la specifica ASN.1 dei tipi di documento UBL; tool ed editor per la creazione/manipolazione di documenti (istanze) UBL e XML schema. Solo per la versione 1.0: specifiche di formattazione di esempio: suggeriscono come formattare i documenti UBL (istanze) in formato human-readable; specifiche di formattazione UN Layout Keys: indicano come formattare i documenti UBL conformemente al United Nations Layout Key for Trade Documents Imola - 8

9 UBL International Data Dictionary 1/2 Dictionary Entry Name Address. Details UBL Name Address UBL Definition The particulars that identify and locate the place where someone lives or is situated, or where an organisation is situated. Traditional Chinese Business Definition Term 地 址 對 個 人 居 地 或 組 織 位 於 地 的 詳 細 定 和 標 識 Address. Identifier ID A unique identifier given to a specific address within a scheme of registered addresses. 地 址 標 識 符 在 登 記 地 址 的 方 案 中 給 予 特 定 地 址 的 唯 一 標 識 符 Address. Postbox. Text Postbox A post office box number or a numbered post box in a post office assigned to a person or organization where letters for them are kept until called for, used as part of an address. 郵 政 信 箱 地 址 的 一 部 分, 由 郵 局 分 配 給 個 人 或 組 織 的 郵 政 信 箱 號 或 已 編 號 的 郵 箱 以 便 信 件 在 送 到 收 件 人 之 前 保 存 在 其 中 Imola - 9

10 UBL International Data Dictionary 2/2 inoltre: Simplified Chinese Giapponese Coreano Danese Spagnolo Italiano (attualmente è disponibile l UBL IDD 1.0 [IDD]; il rilascio dell UBL IDD 2.0 è previsto per la primavera 2007) Imola - 10

11 Sommario Introduzione a UBL Usare UBL Contestualizzare UBL Business collaboration supportate da UBL Casi d uso Imola - 11

12 Gli XML Schema UBL <xsd:complextype name="orderlinetype"> <ccts:definition>information about an Order Line</ccts:Definition> <xsd:sequence> <xsd:element ref="lineitem"> <ccts:definition>an association to Line Item</ccts:Definition></xsd:element> <xsd:element ref="sellerproposedlineitem" minoccurs="0" maxoccurs="unbounded"> <ccts:definition>substitute Line Items proposed by the Seller (in Order Response)</ccts:Definition></xsd:element> <xsd:element ref="sellersubstitutedlineitem" minoccurs="0" maxoccurs="unbounded"> <ccts:definition>item(s) replaced by the seller - the original ordered quantity, pricing etc which may be different from the substituted item. It is assumed that hazard and shipment details etc will be the same.</ccts:definition></xsd:element> <xsd:element ref="buyerproposedlineitem" minoccurs="0" maxoccurs="unbounded"> <ccts:definition>possible alternatives, proposed by the Buyer, to the Line Item</ccts:Definition></xsd:element> Imola - 12

13 Come usare UBL Business Party A Business Party B XML Schema UBL XML Schema UBL Regole di Mapping DB A Regole di Mapping validazione INVIO Documento di business UBL (in formato XML) validazione Documento di business UBL (in formato XML) + XPath DOM XSLT XSLT DB B Web Pdf Imola - 13

14 UBL: linguaggio general purpose UBL è un linguaggio generico, pensato per poter essere utilizzato in molteplici e diversi domini di business Imola - 14

15 Descrizione di prodotto o servizio: Item n 0..n 0..n n n 0..n 0..n 0..n 0..n n 0..n Imola - 15

16 Sottostruttura dell elemento BuyersItemIdentification Imola - 16

17 Item UBL un Item può essere un prodotto o un servizio; i prodotti possono essere descritti definendo opportuni tipi di attributi fisici e misure ; i valori assunti da attributi fisici e misure devono essere comprensibili ed interpretabili ad entrambe le parti Imola - 17

18 Esempio: capo d abbigliamento <Item > <cbc:description>t-shirt donna manica corta</cbc:description> <cbc:hazardousriskindicator>false</cbc:hazardousriskindicator> <BuyersItemIdentification> <cbc:id>md001</cbc:id> tipo attributo <PhysicalAttribute> <cbc:attributeid>colore</cbc:attributeid> <cbc:description>rosso</cbc:description> </PhysicalAttribute> valore attributo <PhysicalAttribute> <cbc:attributeid>taglia</cbc:attributeid> <cbc:descriptioncode>xxl</cbc:descriptioncode> </PhysicalAttribute> </BuyersItemIdentification> </Item> Imola - 18

19 Esempio: prodotto edile <Item> <cbc:description>pannello di cartongesso</cbc:description> <cbc:hazardousriskindicator>false</cbc:hazardousriskindicator> <BuyersItemIdentification> misura <cbc:id>prs 9</cbc:ID> <MeasurementDimension> <cbc:attributeid>altezza</cbc:attributeid> <cbc:measure unitcode="cmt">181</cbc:measure> </MeasurementDimension> <MeasurementDimension> valore misura <cbc:attributeid>larghezza</cbc:attributeid> <cbc:measure unitcode="cmt">92</cbc:measure> </MeasurementDimension> <MeasurementDimension> <cbc:attributeid>profondità</cbc:attributeid> <cbc:measure unitcode="cmt">9</cbc:measure> </MeasurementDimension> </BuyersItemIdentification> </Item> Imola - 19

20 Sommario Introduzione a UBL Usare UBL Contestualizzare UBL Business collaboration supportate da UBL Casi d uso Imola - 20

21 Contestualizzazione di UBL nel vocabolario UBL sono descritti concetti di business generici, comuni a domini eterogenei; il vocabolario, quindi, non definisce concetti specifici di settore; il metodo di contestualizzazione di UBL consente di specializzare i concetti generici per un particolare dominio di business Imola - 21

22 Chi fa la contestualizzazione? Standardization body: OASIS UBL Library Domain specific association UBL Library Contestualizzazione Sistemi logistici UBL Library Contestualizzazione Settore ortofrutticolo Italia UBL Library Contestualizzazione Prodotti IGP Val di Taro p. es.: CROSS può contestualizzare UBL per i prodotti IGP della Val di Taro Imola - 22

23 Come avviene la contestualizzazione XML Schema UBL Metodo di contestualizzazione XML Schema UBL Contestualizzati Documenti di business (in formato XML) Il metodo di contestualizzazione definito in UBL è basato sui concetti di: derivazione XSD; contesto Imola - 23

24 Derivazione XSD 2 sono i tipi di derivazione XSD che possono essere utilizzati per caratterizzare UBL mantenendo compatibilità con lo standard: estensione: consente di aggiungere informazioni; restrizione: consente di eliminare o porre vincoli alle informazioni. Estensione: aggiunto elemento Indirizzo Tipo base: tipo Persona composto dagli elementi Nome (opzionale) e Cognome (obbligatorio) Restrizione: reso obbligatorio l elemento Nome Imola - 24

25 Concetto di contesto Un contesto definisce l insieme delle circostanze in cui: possono avere luogo determinate collaborazioni di business tra partner commerciali; e sono validi i dati che i partner si scambiano (sotto forma di messaggi di business) nell ambito di queste collaborazioni Imola - 25

26 Specificare il contesto il contesto va specificato nello schema XML contestualizzato; il contesto è espresso come insieme di coppie nomevalore ; i nomi sono definiti nelle specifiche UBL sulla base delle [CCTS]; non c è un insieme predefinito di valori per ciascun contesto; è possibile, quindi, adottare qualunque codifica, purché consistente. Si raccomanda, però, di: utilizzare sempre gli stessi valori in un medesimo contesto (p.es.: una volta usato USA per indicare lo stato dell America del Nord, non usare U.S.A. o US ); indicare un eventuale codifica standardizzata utilizzata Imola - 26

27 Categorie di contesti 1/2 Contesto Business Process Product Classification Industry Classification Esempi di liste di codici riconosciute UN/CEFACT Catalogue of Common Business Processes Universal Standard Product and Service Specification (UNSPSC), Standard International Trade Classification (SITC Rev 3) International Standard Industrial Classification (ISIC) Universal Standard Product and Service Specification (UNSPSC) Esempi valori Create Order, Notify Of Advance Shipment, Process Payment, Footwear, Articles of apparel and clothing accessories, Beverages, Manufactures of metals, Medicinal and pharmaceutical products, Agriculture, hunting and related service activities, Manufacture of food products and beverages, Manufacture of basic metals, Manufacture of wearing apparel; dressing and dyeing of fur, Electricity, gas, steam and hot-water supply, Imola - 27

28 Categorie di contesti 2/2 Contesto Geopolitical Official Constraints Esempi di liste di codici riconosciute ISO Country Codes Esempi valori America, Europe, Asia, Italy, Business Process Role Supporting Role UN/CEFACT Catalogue of Common Business Processes UN/EDIFACT Code List for DE 3035 Buyer, Vendor, Customer,.. Buyer, Seller, Payee, System Capabilities Imola - 28

29 Esempio: contestualizzazione per estensione in contesto Tessile/Abbigliamento estensione <ccts:contextualization> <ccts:context> <ccts:geopolitical>italy</ccts:geopolitical> <ccts:industryclassification>manufacture of wearing apparel</ccts:industryclassification> <ccts:productclassification>t-shirts, singlets and other vests, knitted or crocheted</ccts:productclassification> </ccts:context> Imola - 29 </ccts:contextualization>

30 Istanza del tipo esteso <cac:item> <cbc:description>t-shirt donna manica corta</cbc:description> <cbc:hazardousriskindicator>false</cbc:hazardousriskindicator> <cac:buyersitemidentification xsi:type="mybuyersitemidentificationtype"> <cbc:id>md001</cbc:id> Elementi aggiunti </cac:buyersitemidentification> </cac:item> <colore>verde chiaro</colore> <taglia>m</taglia> Imola - 30

31 Punti di forza della contestualizzazione derivazione XSD: mantiene esplicita la relazione tra il tipo definito nel vocabolario standard e il tipo derivato. Questo significa che un applicazione automatica in grado di processare solamente i tipi base UBL, sarà anche capace di gestire i tipi derivati da essi, poiché, potendo risalire ai tipi da cui sono stati derivati, potrà processarli allo stesso modo; dichiarazione del contesto: rende esplicito e non ambiguo il dominio di validità delle singole contestualizzazioni Imola - 31

32 Sommario Introduzione a UBL Usare UBL Contestualizzare UBL Business collaboration supportate da UBL Casi d uso Imola - 32

33 Tipi di documento definiti in UBL 1.0 Tipi di documento Order - Order Response - Order Response Simple - Order Change - Order Cancellation - Despatch Advice - Receipt Advice Invoice Tipi di documento aggiunti in UBL 2.0 Catalogue Request Catalogue - Catalogue Deletion - Catalogue Item Specification Update - Catalogue Pricing Update - Request For Quotation - Quotation - Self Billed Invoice - Credit Note - Debit Note - Self Billing Credit Note Statement Reminder - Remittance Advice Forwarding Instruction Bill of Lading - Waybill - Packing List - Freight Invoice Certificate of Origin - Transportation Status - Application Response - Attached Document Imola - 33

34 Diagramma dei casi d uso: Business Collaboration supportate da UBL Contractor Sourcing Receiver Originator Ordering Buyer Provider Seller Customer Fulfilment Despatch Supplier Delivery Billing Creditor Debtor Payment Payee Imola - 34

35 Business Collaboration supportate da UBL 1. Business Collaboration Sourcing 2. Business Collaboration Ordering 3. Business Collaboration Fulfilment 4. Business Collaboration Billing 5. Business Collaboration Payment inoltre (business collaboration che estendono la business collaboration Fulfillment ): 6. Business Collaboration Transport Services 7. Business Collaboration Certification of Origin of Goods 8. Business Collaboration Report Status of Goods Imola - 35

36 1. Business Collaboration Sourcing Ruoli: Contractor Receiver Provider Seller Originator Documenti: CatalogueRequest Catalogue CatalogueItemSpecificationUpdate CataloguePricingUpdate CatalogueDeletion RequestForQuotation Quotation Imola - 36

37 Diagramma delle attività per la Business Collaboration Sourcing Imola - 37

38 2. Ordering Collaboration Ruoli: Buyer Seller Documenti: Order OrderResponse OrderResponseSimple OrderChange OrderCancellation Imola - 38

39 Diagramma delle attività per la Business Collaboration Ordering Imola - 39

40 3. Fulfilment collaboration Ruoli: Buyer Seller Delivery Despatch Documenti: DespatchAdvice ReceiptAdvice Order Cancellation Order Change Imola - 40

41 Diagramma delle attività per la Business Collaboration Fulfilment Imola - 41

42 4. Billing collaboration Ruoli: Accounting Customer Accounting Supplier Documenti: Invoice CreditNote DebitNote SelfBilledInvoice SelfBilledCreditNote Freight Invoice Reminder Imola - 42

43 Diagramma delle attività per la Business Collaboration Billing Imola - 43

44 5. Payment collaboration Ruoli: Accounting Customer Accounting Supplier Payee Documenti: RemittanceAdvice Statement Imola - 44

45 Diagramma delle attività per la Business Collaboration Payment Imola - 45

46 6. Transport Services Collaboration Ruoli: Consignee Consignor Freight Forwarder Carrier Documenti: ForwardingInstruction PackingList BillOfLading Waybill Transportation Status Imola - 46

47 Diagramma delle attività per la Business Collaboration Transport Services Imola - 47

48 7. Certification of Origin of Goods Collaboration Ruoli: Exporter Issuer Endorser Importer Documenti: Certificate of Origin Imola - 48

49 Diagramma delle attività per la Business Collaboration Certification of Origin of Goods Imola - 49

50 8. Report Status of Goods Collaboration Ruoli: Exporter Issuer Endorser Importer Documenti: Certificate of Origin Imola - 50

51 Diagramma delle attività per la Business Collaboration Report Status of Goods Imola - 51

52 Struttura del documento UBL-Order Imola - 52

53 Descrizione del documento Order-UBL-2 Alcune informazioni contenute nel documento Order- UBL-2: - header (identificatore, data di emissione, ); - buyer (informazioni sul buyer: nome, indirizzo, ); - seller (informazioni sul seller: nome, indirizzo, ); - luogo di consegna; - termini di consegna; - importi richiesti per fini legali; - riga d ordine Imola - 53

54 Istanza del tipo di documento UBL-Order-2 1/3 <Order> <cbc:id> </cbc:id> <cbc:copyindicator>true</cbc:copyindicator> header <cbc:issuedate> </cbc:issuedate> <cbc:documentcurrencycode>usd</cbc:documentcurrencycode> <cac:buyercustomerparty> <cac:party> <cac:partyname> <cbc:name>bills Microdevices</cbc:Name> </cac:partyname> <cac:address> buyer <cbc:streetname>spring St</cbc:StreetName> <cbc:buildingnumber>413</cbc:buildingnumber> <cbc:cityname>elgin</cbc:cityname> <cbc:postalzone>60123</cbc:postalzone> <cbc:countrysubentitycode>il</cbc:countrysubentitycode> </cac:address> </cac:party> </cac:buyercustomerparty> Imola - 54

55 Istanza del tipo di documento UBL-Order-2 2/3 <cac:sellersupplierparty> </cac:sellersupplierparty > seller <cac:delivery> <cbc:requesteddeliverydatetime> t14:00:00 </cbc:requesteddeliverydatetime> <cac:deliveryaddress> <cbc:streetname>spring St</cbc:StreetName> <cbc:buildingnumber>413 N</cbc:BuildingNumber> <cbc:cityname>elgin</cbc:cityname> <cbc:postalzone>60123</cbc:postalzone> <cbc:countrysubentitycode>il</cbc:countrysubentitycode> </cac:deliveryaddress> </cac:delivery> <cac:deliveryterms> <cbc:specialterms>signature Required</cbc:SpecialTerms> </cac:deliveryterms> consegna termini di consegna Imola - 55

56 Istanza del tipo di documento UBL-Order-2 3/3 <cac:legaltotal> <cbc:lineextensionamount currencyid="usd"> importi </cbc:lineextensionamount> richiesti <cbc:taxinclusiveamount currencyid="usd">482.35</cbc:taxinclusiveamount> per fini <cbc:tobepaidamount currencyid="usd">482.35</cbc:tobepaidamount> legali </cac:legaltotal> <cac:orderline> <cac:lineitem> <cbc:id>1</cbc:id> <cbc:quantity unitcode= PK">5</cbc:Quantity> <cbc:lineextensionamount currencyid="usd">12.50</cbc:lineextensionamount> <cac:item> <cbc:description>pencils, box #2 red</cbc:description> <cbc:hazardousriskindicator>false</cbc:hazardousriskindicator> <cac:sellersitemidentification> <cbc:id> </cbc:id> </cac:sellersitemidentification> </cac:item> </cac:lineitem> </cac:orderline> Imola - 56 riga d ordine

57 Visualizzazione dell istanza tramite XSLT Imola - 57

58 Sommario Introduzione a UBL Usare UBL Contestualizzare UBL Business Collaboration supportate da UBL Casi d uso Imola - 58

59 Adozione e risultati 1/2 In Danimarca [dk]: è stata implementata la fattura UBL ed è già ampiamente utilizzata nel settore pubblico; è già stata programmata l implementazione dell ordine UBL. I perché di questa scelta: volontà del governo danese di ottimizzare il processo di pagamento nel settore pubblico; uno studio ha stimato che il risparmio di tempo dato dall utilizzo della fatturazione elettronica si sarebbe tradotto in un risparmio economico pari a quasi 100 M di euro l anno, che potrebbero diventare 160 implementando l intero processo ordine-fattura; decisione del governo di adottare tecnologie standard Imola - 59

60 Adozione e risultati 2/2 In Svezia [se]: dall Ottobre 2005 la Swed-invoice (una sottoparte della Fattura UBL) è stata raccomandata per tutti gli usi governativi della Swedish National Financial Management Authority. I perché di questa scelta: uno studio ha stimato che la standardizzazione nella Fattura UBL farà risparmiare al governo Svedese 4 miliardi di SEK (più di 500 milioni di dollari) nei primi 5 anni di impiego. Nel Regno Unito [uk]: il marketplace Zanzibar, partito nel febbraio 2006, utilizza 14 documenti UBL 2.0. I perché di questa scelta: decisione del governo di adottare tecnologie standard Imola - 60

61 Progetti 1/2 EFM (Electronic Freight Management)* [efm]: progetto pilota del Dipartimento dei Trasporti degli Stati Uniti (US DOT); obiettivo: testare l utilizzo dei documenti UBL Despatch Advice e Bill of Lading ; attori coinvolti: 2 aziende manifatturiere di abbigliamento cinesi, 2 trasportatori internazionali, 1 operatore di terminali di trasporto aereo, 2 compagnie di volo charter, 1 compratore, 1 fornitore di servizi logistici americano e 1 broker di importazioni. * fonte OASIS Imola - 61

62 Progetti 2/2 ABILITIES (Application Bus for InteroperabiLITy In enlarged Europe SMEs) [abl]: progetto europeo partito nel gennaio 2006 e della durata di due anni; obiettivo: studiare, progettare e sviluppare un architettura federata per mezzo di messaggi UBL intelligenti ed adattivi e servizi per l interoperabilità, per supportare le piccole e medie imprese nell ambito dell e-commerce; attori coinvolti: PMI dei settori Retail (Lituania), High-Tec (Slovacchia), Agroalimentare (Turchia), Tessile-Abbigliamento (Romania), Turismo (Lituania e Ungheria) Imola - 62

63 UBL in Italia attualmente nessuna implementazione UBL nota; maggio 2006: costituito UBL Italian Localization Subcommittee per fornire contenuti UBL in lingua italiana e promuovere UBL in Italia [ublitlsc]. Contatti: Roberto Cisternino (roberto@javest.com); Arianna Brutti (arianna.brutti@bologna.enea.it) Imola - 63

64 Free software a supporto di UBL Crane Softwrights Ltd. ha rilasciato una suite di XSLT/XSL-FO stylesheets per convertire i documenti UBL 1.0 in HTML o PDF [CS]; UBL Formatter: applicazione basata sui Crane stylesheets che trasforma i documenti UBL 1.0 in file in formato html o pdf (sviluppata da Ambrosoft) [Amb]; UBL Reader: applicazione che offre una vista semplificata degli schema UBL (sviluppato da Gefeg) [Gef]; UBL Swinger: editor per la creazione di documenti UBL (sviluppato da Javest) [sw]; free-ubl: software opensource per la creazione, compilazione e visualizzazione di documenti UBL ed ebxml [freeubl]; riferimenti ad ulteriori software sono disponibili nella UBL Support Page [sup] Imola - 64

65 Riferimenti 1/3 [ubl] Universal Business Language [ebxml] Electronic Business using extensible Markup Language [IDD] [CCTS] [dk] UBL 1.0 International Data Dictionary open.org/committees/download.php/15631/cd-ubl-1.0-idd- 1.ods open.org/committees/download.php/12242/cd-ubl-1.0-idd- 1.xls Core Components Technical Specification The Danish OIOXML project Imola - 65

66 Riferimenti 2/3 [se] [uk] SwedInvoice Zanzibar Marketplace [efm] EFM [abl] Abilities [ublitlsc] UBL Italian Localization Subcommittee wg_abbrev=ubl-itlsc Imola - 66

67 Riferimenti 3/3 [CS] [Amb] [Gef] [sw] Crane Softwrights Ambrosoft Gefef UBL Swinger [freeubl] free-ubl [sup] UBL Support Page Imola - 67

68 FINE Imola - 68