1 - Overview 2 - Processes 3 - Documents 4 - Transactions 5 - Resources 6 - Decoding tables 7 - Dictionary 8 - Atlas Printable version





XML structures of eBIZ/TC Upstream documents (Draft)

Introduction to the XML document template

The structure of the XML documents is the very prescriptive part of the eBIZ/TC Upstream framework: using the eBIZ/TC Upstream documents, the prescriptions must be completely respected about structure of the documents, names and coding, optionality or mandatory use of elements, meaning of each element.
Otherwise the documents could be not validable with the XML Schema (that are the only way to check the formal compliance of the documents) or could generate misunderstandings about the meaning of the message on the side of your partners.
The allowable customisations are about the use or not of a document or about the elements of the document that are declared 'optional'; they can be used to simplify the documents (not all the elements are always necessary).

The (template of) eBIZ/TC Upstream documents of each release are on www.ebiz.enea.it or www.moda-ml.org and are represented by:


release 11/ott/2022

Document Document Availability Advise
Document Document Availability Advise
(New)
Description Document Availability Advise, contains a list of references to documents that are currently available.
Release date 28/05/2022
Scope
This guide aims to illustrate to fashion companies the standard XML format of the document type "NEW DOCUMENT ADVISE", providing instructions for its use in the context of a TRACEABILITY SYSTEM involving Fashion Manufacturers, their customers, third parties and in case customs authorities, eBusiness and eCommerce platforms.
All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Generalities This document is intended to inform a party, be it a company or a service platform, that one or more (new) documents are available and to provide some metadata, including information on where they can be found. For each reported document, among the metadata, there is a flag that indicates whether the availability of the document requires taking some specific action, indications on any document to which it refers and finally an indication of traceable objects to which it refers. The document could be included in the message as a binary object, choice not recommended for practical reasons, or it could be indicated with a file name or with an external reference though a URI.
Credits This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility New
Document Code TRC005
Resources [Guide]
[XML Schema]
[JSON Schema]
Specific for TRICK Document: Document Availability Advise

An alert is sent to the producer to advise him about a new document on TRICK related to raw material availability at the supplier facility.
In this way he can connect to the platform and get the contents of this file.

Resources specific for TRICK [Guide - Specific for TRICK]
Used in Processes
 

Document Fashion Catalogue
Document Fashion Catalogue
Description Trade document containing the prices and the technical properties of the FASHION articles offered by the manufacturer
Release date 05/11/2018
Scope
The present guide has been issued to assist the companies of the Fashion sector in the implementation of the standard XML document type FASHION CATALOGUE”, providing all the instruction required for its use in any context of e-commerce between Fashion Producers and their customers and eBusiness and eCommerce platforms.
All the rules required for the construction and validation of the document are embedded into the specific XML-Schema, which is detailed in section "Implementation guide".
Generalities
This document is usable as a catalog (showcase / offer) as well as to exchange in advance the product data between Suppliers and Customers, in order to allow the synchronization of the corresponding data-base. . Furthermore, a Producer can use it to publish is offer on ePlatforms.
It contains the items that compose the Fashion Manufacturer's offer (codes, descriptions, prices and terms of sale) and may include some technical-descriptive data of the product (trade name, composition, weight and height, …) as well as marketing information (images, verbose descriptions, …)
Credits This XML document was created by Arianna Brutti with the support of Piero De Sabbata (ENEA) in collaboration with Francesco Melani and Simone Gabellini (Kykos), Virginia Fani (University of Florence) as part of the eBIZ 4.0 project.
Back compatibility Unchanged
Document Code G080
Resources [Guide]
[XML Schema]
[JSON Schema]
[XSL]
[XML+XSL]
Resources specific for TRICK [Guide - Specific for TRICK]
Used in Processes
 

Document Health Protection Information
Document Health Protection Information
(New)
Description Health Protection Information, contains information to accomplish the Health Protection and Assessment service.
Release date 06/09/2022
Scope
This guide aims to illustrate the standard XML format of the document type "Health Protection Information", providing instructions for its use in the context of a TRANSPARENCY SYSTEM involving Fashion Manufacturers, their customers, third parties and in case customs authorities, eBusiness and eCommerce platforms.
All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Credits This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility New
Document Code TRC008
Diagrams   +      Diagramm A_S4.1HealthProtectionserviceexecution
Resources [Guide]
[XML Schema]
[JSON Schema]
Used in Processes
 

Document Health Protection Preliminary Information
Document Health Protection Preliminary Information
(New)
Description Health Protection Preliminary Information, contains preliminary information to start the Health Protection and Assessment service.
Release date 06/09/2022
Scope
This guide aims to illustrate the standard XML format of the document type "Health Protection Preliminary Information", providing instructions for its use in the context of a TRANSPARENCY SYSTEM involving Fashion Manufacturers, their customers, third parties and in case customs authorities, eBusiness and eCommerce platforms.
All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Credits This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility New
Document Code TRC006
Diagrams   +      Diagramm A_S4.1HealthProtectionserviceexecution
Resources [Guide]
[XML Schema]
[JSON Schema]
Used in Processes
 

Document Indicators declaration
Document Indicators declaration
(New)
Description Results of the assessment performed by the service, includes the study as a separate document attached and, in case, a list of calculated indicators, possibly publishable.
Release date 06/09/2022
Scope
This guide aims to illustrate the standard XML format of the document type that declares a list of indicators calculated by a service, providing instructions for its use in the context of a TRANSPARENCY SYSTEM involving Fashion Manufacturers, their customers, third parties and in case customs authorities, eBusiness and eCommerce platforms.
All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Credits This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility New
Document Code TRC009
Resources [Guide]
[XML Schema]
[JSON Schema]
Used in Processes
 

Document Party Information
Document Party Information
Description The "Party Information" document is used to communicate information about people or companies.
Release date 05/11/2018
Scope
This guide is intended to illustrate to FASHION companies the standard XML form of the document type "Party Information", providing instructions for its use in any context of electronic commerce between different subjects of the production and sales chain.
All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Generalities
The message is issued to communicate information about people or organisations (for example, lists of customers enabled to operate on an eCommerce site).
The sender forwards this document when he has to feed a registry of persons or organizations.
Main function of the message is transferring information about people or companies: personal or business data (name, address, contacts, billing information, categories of belonging to subjects useful for commercial purposes).
Credits This XML document was created by Arianna Brutti with the support of Piero De Sabbata (ENEA) in collaboration with Giuliano Dal Brun and Elisa Sciascia (Cotonificio Monti), Manuel Toniato e Ilenia Trevisan (Develon). This XML document & egrave; updated by Arianna Brutti with the support of Piero De Sabbata (ENEA) in collaboration with Francesco Melani and Simone Gabellini (Kykos), Virginia Fani (Università scope of the eBIZ 4.0 project.
Back compatibility Unchanged
Document Code G079
Resources [Guide]
[XML Schema]
[JSON Schema]
[XSL]
[XML+XSL]
Resources specific for TRICK [Guide - Specific for TRICK]
Used in Processes
 

Document PEF and environmental footprint Information
Document PEF and environmental footprint Information
(New)
Description PEF and environmental footprint Assessment Information, contains information to accomplish the PEF and environmental footprint Assessment service.
Release date 06/09/2022
Scope
This guide aims to illustrate the standard XML format of the document type "PEF and environmental footprint Information", providing instructions for its use in the context of a TRANSPARENCY SYSTEM involving Fashion Manufacturers, their customers, third parties and in case customs authorities, eBusiness and eCommerce platforms.
All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Credits This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility New
Document Code TRC013
Diagrams   +      Diagramm A_S3.1PEFandenvironmentalfootprintassessmentserviceexecution
Resources [Guide]
[XML Schema]
[JSON Schema]
Used in Processes
 

Document PEF and environmental footprint Preliminary Information
Document PEF and environmental footprint Preliminary Information
(New)
Description PEF and environmental footprint assessment preliminary Information, contains preliminary information to start the PEF and environmental footprint Assessment service.
Release date 06/09/2022
Scope
This guide aims to illustrate the standard XML format of the document type "PEF and environmental footprint Assessment Preliminary Information", providing instructions for its use in the context of a TRANSPARENCY SYSTEM involving Fashion Manufacturers, their customers, third parties and in case customs authorities, eBusiness and eCommerce platforms.
All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Credits This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility New
Document Code TRC014
Diagrams   +      Diagramm A_S3.1PEFandenvironmentalfootprintassessmentserviceexecution
Resources [Guide]
[XML Schema]
[JSON Schema]
Used in Processes
 

Document Reaction to service results
Document Reaction to service results
(New)
Description User reaction to the results of the assessment performed by the service. Includes disclosure instructions.
Release date 06/09/2022
Scope
This guide aims to illustrate the standard XML format of the document type originated by a service, providing instructions for its use in the context of a TRANSPARENCY SYSTEM involving Fashion Manufacturers, their customers, third parties and in case customs authorities, eBusiness and eCommerce platforms.
All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Credits This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility New
Document Code TRC012
Resources [Guide]
[XML Schema]
[JSON Schema]
Used in Processes
 

Document Service final response
Document Service final response
(New)
Description Results of the assessment performed by the service, includes the study as a separate document attached and, in case, a list of calculated indicators, possibly publishable.
Release date 06/09/2022
Scope
This guide aims to illustrate the standard XML format of the document type originated by a service, providing instructions for its use in the context of a TRANSPARENCY SYSTEM involving Fashion Manufacturers, their customers, third parties and in case customs authorities, eBusiness and eCommerce platforms.
All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Credits This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility New
Document Code TRC009
Resources [Guide]
[XML Schema]
[JSON Schema]
Used in Processes
 

Document Service Information Request
Document Service Information Request
(New)
Description Information requested to accomplish the requested service.
Release date 06/09/2022
Scope
This guide aims to illustrate the standard XML format of the document type "Health Protection Information Request", providing instructions for its use in the context of a TRANSPARENCY SYSTEM involving Fashion Manufacturers, their customers, third parties and in case customs authorities, eBusiness and eCommerce platforms.
All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Credits This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility New
Document Code TRC007
Resources [Guide]
[XML Schema]
[JSON Schema]
Used in Processes
 

Document Social and Ethic Accountability Information
Document Social and Ethic Accountability Information
(New)
Description Social and Ethic Accountability Information, contains information to accomplish the Social and Ethic Accountability Assessment service.
Release date 06/09/2022
Scope
This guide aims to illustrate the standard XML format of the document type originated by a service, providing instructions for its use in the context of a TRANSPARENCY SYSTEM involving Fashion Manufacturers, their customers, third parties and in case customs authorities, eBusiness and eCommerce platforms.
All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Credits This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility New
Document Code TRC010
Diagrams   +      Diagramm A_S5.1SocialandEthicalprotectionassessmentserviceexecution
Resources [Guide]
[XML Schema]
[JSON Schema]
Used in Processes
 

Document Social and Ethic Accountability Preliminary Information
Document Social and Ethic Accountability Preliminary Information
(New)
Description Social and Ethic Accountability Preliminary Information, contains preliminary information to start the Social and Ethic Accountability Assessment service.
Release date 06/09/2022
Scope
This guide aims to illustrate the standard XML format of the document type "Social and Ethic Accountabilityn Preliminary Information", providing instructions for its use in the context of a TRANSPARENCY SYSTEM involving Fashion Manufacturers, their customers, third parties and in case customs authorities, eBusiness and eCommerce platforms.
All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Credits This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility New
Document Code TRC011
Diagrams   +      Diagramm A_S5.1SocialandEthicalprotectionassessmentserviceexecution
Resources [Guide]
[XML Schema]
[JSON Schema]
Used in Processes
 

Document Textile Invoice
Document Textile Invoice
Description Invoice used to debit supplies and works or miscellaneous services in the Textile-Clothing industry. It can be also used to credit amounts.
Release date 05/11/2018
Scope
The present guide has been issued to assist the companies of the Textile-Clothing sector in the implementation of the standard XML document type “Textile INVOICE”, providing all the instruction required for its use in any context of e-commerce between Apparel Producers and their partners.
All the rules required for the construction and validation of the document are embedded into the specific XML-Schema, which is detailed in section "Implementation guide".
Generalities
The document "Textile invoice" can be used to debit the Client for any kind of supply or service.
This document can be used to debit standard supply using the option "texItem", and additional goods or services using the option "prodServItem", even in the same invoice.
The use of quantity and unit price is mandatory only with "texItem".
Credits The first version of this XML document was made in the framework of MODA-ML project by Guido Cucchiara, PROGEMA - Gruppo SOI, supported by Thomas Imolesi and Arianna Brutti, XML-Lab (initiative of ENEA and Forum per la Tecnologia dell'Informazione). Other participants: Alessandro Barberis Canonico (Lanificio Vitale Barberis Canonico), Albino Botto Poala (Lanificio Successori Reda), Gustavo Cametti (Lanificio Piacenza), Massimo Perona (Domina srl), Piero De Sabbata e Piergiorgio Censoni (ENEA) Gianfranco Irico (Lanificio Loro Piana), Luca Mainetti (Politecnico di Milano, Hypermedia Open center), Federico Tamburini e Ivano Begnozzi (Fratelli Corneliani). Subsequent developments in this document have been financed by the TQR consortium, partly self-financed by the partners and the eBIZ 4.0 project More information can be acquired in http://www.ebiz.enea.it.
Back compatibility Unchanged
Document Code G011
Resources [Guide]
[XML Schema]
[JSON Schema]
[XSL]
[XML+XSL]
Resources specific for TRICK [Guide - Specific for TRICK]
Used in Processes
 

Document Traceability Despatching Advice
Document Traceability Despatching Advice
(New)
Description Traceability Despatching Advise of the goods sent upon any business transaction
Release date 28/05/2022
Scope
This guide aims to illustrate to fashion companies the standard XML format of the document type "TRACEABILITY DESPATCHING ADVISE", providing instructions for its use in the context of a TRACEABILITY SYSTEM involving Fashion Manufacturers, their customers, third parties and in case customs authorities, eBusiness and eCommerce platforms.
All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Generalities
The message is issued to record in the traceability system and anticipate to the destinationparty the information of the shipment of the product (it does not indicate the 'ready to send' condition, for this purpose use a normal despatch Advise); it may contain information such as transaction certificates relating to the goods shipped.
Each line of Traceability Despatch Advice must indicate the product with a unique code and can specify the Order line or other document to which it refers.
Credits This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility New
Document Code TRC003
Resources [Guide]
[XML Schema]
[JSON Schema]
Resources specific for TRICK [Guide - Specific for TRICK]
Used in Processes
 

Document Traceability Receiving Advice
Document Traceability Receiving Advice
(New)
Description Traceability Receiving Advise of the goods received upon upon any business transaction
Release date 28/05/2022
Scope
This guide aims to illustrate to fashion companies the standard XML format of the document type "TRACEABILITY RECEIVING ADVISE", providing instructions for its use in the context of a TRACEABILITY SYSTEM involving Fashion Manufacturers, their customers, third parties and in case customs authorities, eBusiness and eCommerce platforms.
All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Generalities
The Traceability Receiving Advice is a notice that may be addressed to both the sender of the goods as well as the traceability systems; can be used by the Receiver of the goods (purchased or received on account; including in the case of import) both to confirm the regular receipt of the goods against despatching by partners already within the traceability system as well as to communicate the entry into the traceability system, for example following import; it can also be used to notify discrepancies between what was declared by the sender and what was received and accepted.
In the first and third cases, this document must be used in association with the Traceability Despatching advice document (linked via mandatory cross-references); in the second case (import / entry into the system) the document stands alone.
It is recommended to issue an Receipt Notice for each Shipment Notice.
Credits This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility New
Document Code TRC002
Resources [Guide]
[XML Schema]
[JSON Schema]
Specific for TRICK Activity transactions: P1.A2 Incoming material/Traceability Receiving Advice

Traceability Receiving Advice in activity P1.A2 for the TRICK Pilot (Trick context specific)

In TRICK Pilots this transaction has the aim to inform the platform that raw materials have been received and activate the tracing activity by registering their lots.

In this initial activity also custom documentation related to extra UE imported raw material will be uploaded by the importer

Resources specific for TRICK [Guide - Specific for TRICK]
Used in Processes
 

Document Traceability report
Document Traceability report
(New)
Description This documentsi is a Traceability Report containing information related to a single tracing unit (lot or single item or…) and its history and references to its components/raw materials.
Release date 28/05/2022
Scope
This guide aims to illustrate to fashion companies the standard XML format of the document type "TRACEABILITY REPORT", providing instructions for its use in the context of a TRACEABILITY SYSTEM involving Fashion Manufacturers, their customers, third parties and in case customs authorities, eBusiness and eCommerce platforms.
All the rules necessary for the construction and validation of the document are expressed through a specific XML schema, which is presented in detail in the paragraph "Implementation Guide".
Generalities
This document has a double function:

- it can be used to RETRIEVE the FULL HISTORY of a traceability unit (in this case all the events relating to the traceability unit - the history - are contained in the document from the beginning of its history; the events relating to the components can be or not included depending on the level of detail requested and the disclosure allowed to the applicant); in some cases it might also retrieve information relating to more than one traceability units.

In this use, the report is usually a response to a request for information.

When reporting the complete history of a traceability unit the document would contain an item with attribute primaryItemFlag=true- which identifies the primary lot of the history, while the remaining items are related to the components.

otherwise

- it can be used to NOTIFY to a partner (for example the customer) or to the traceability system the NEW or (exceptionally) MODIFIED events relating to one or more traceability units (in this case the events contained in the document must be added to the history of the traceability unit to which they refer, as long as the sender has the appropriate authorization level).

In this case the report is sent to the receiver and constitutes a request for registration.

Validity of the report: the report contents are guaranteed at the issueing time: the past cannot be changed (with the exception of error corrections), but it may evolve with new events.

It is important to distinguish between two stages of the product life: reports up to the 'ready for use' status and circularity reports that include its life after usage up to dismantling:

1) when the product is finished, the ‘technical history’ of a lot of product is ended

2) changes may happen on logistic or ownership or usage between sales/delivering and recollection/dismantling

- logistic: changes of the lots (before sales/deliver) for example sent to different warehouses…
- usage: should not affect the tracing report

Credits This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility New
Document Code TRC004
Resources [Guide]
[XML Schema]
[JSON Schema]
Resources specific for TRICK [Guide - Specific for TRICK]
Used in Processes
 

Document Transparency and Sustainability Report
Document Transparency and Sustainability Report
(New)
Description This report collects all the basic information about the productive process, the facilities and the organisation that are necessary to describe the sustainability characteristcs of the products, enable transparency within the supply chains and activate traceability.
Release date 28/05/2022
Credits This document was produced by Piero De Sabbata, Arianna Brutti e Gessica Ciaccio for ENEA X-LAB with the contribution of the partners of the TRICK project.
Back compatibility New
Document Code TRC001
Resources [Guide]
[XML Schema]
[JSON Schema]
Resources specific for TRICK [Guide - Specific for TRICK]
Used in Processes