> For the complete documentation index, see [llms.txt](https://relax4me.gitbook.io/relax-plus-help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://relax4me.gitbook.io/relax-plus-help/ecommerce-shop-online/relax-bridge-feed.md).

# Relax Bridge Feed

Relax Bridge XML permette di alimentare un flusso vero altre piattaforme Online. Il Flusso legge i dati i tempo reale e mette a disposizione nel formato XML i seguenti dati.

Indice:

**Attivazione & Installazione**

**Configurazione Plugin**&#x20;

* Configurazione da Relax4Me per l’accesso
* Configurazione lato Server&#x20;
* Configurazione del Plugin su Shopify
* Struttura Dati che alimentano il Modulo&#x20;

**Stato Documento:**

**Formato: XML**&#x20;

* Tracciato Prodotto
* Tracciato Taglia e colore&#x20;

**Tracciato Giacenza**&#x20;

* Tracciato Saldi e Promozione&#x20;

**Esempio XML Prodotto**

* Prodotto Senza Taglia e colore&#x20;
* Prodotto Taglia e colore

**Esempio XML Giacenza**

### Stato Documento: <a href="#id-1ch1lvj4b4vt" id="id-1ch1lvj4b4vt"></a>

| Rev. | Data       | Note                                        |
| ---- | ---------- | ------------------------------------------- |
| 1.0  | 23/05/2018 | Versione 1.0                                |
| 2.0  | 01/04/2020 | Nuova Versione con diverse tipologia di XML |

### Formato: XML <a href="#id-8kdiz3xwv5ud" id="id-8kdiz3xwv5ud"></a>

Dati sorgente:

percorso-relaxcliente = accesso riservato al cliente del gestionale Relax Plus protetto.

| Nr. | Tipologia          | Percorso                                                  |
| --- | ------------------ | --------------------------------------------------------- |
| 1   | Prodotto           | <https://percorso-relaxcliente/entities/api/get-products> |
| 2   | Giacenze           | <https://percorso-relaxcliente/entities/api/get-stocks>   |
| 3   | Saldi e Promozione | <https://percorso-relaxcliente/entities/api/get-sales>    |

Alla fine documento sono presenti gli esempi:

1. XML con Articolo con e senza Taglia e colore
2. XML Giacenza
3. XML Saldi e Promozione

Tracciato Record

### Tracciato Prodotto <a href="#ftryn6frsgzc" id="ftryn6frsgzc"></a>

(<https://percorso-relaxcliente/entities/api/get-products>)

Esempio: <https://demo.r-elax.cloud/entities/api/get-products>

| Nome Campo              | Valore                 | Note                                                   |
| ----------------------- | ---------------------- | ------------------------------------------------------ |
| id                      | Numerico Progressivo   | 6654                                                   |
| codiceArticolo          | Alfanumerico           | PANT-MARCELLO                                          |
| codiceArticoloFornitore | Alfanumerico           | blank                                                  |
| nome                    | Alfanumerico           | PANTALONE CON RISVOLTO                                 |
| testoBreve              | Alfanumerico           | Testo Breve                                            |
| testoEsteso             | Alfanumerico           | Testo esteso Esempio per Shop Online                   |
| keywords                | Alfanumerico           | Keywords1, Keywords2                                   |
| idFornitore             | Numerico               | 428                                                    |
| idProduttore            | Numerico               |                                                        |
| costoStandard           | Numerico ( 2 decimali) | 11.00                                                  |
| ricarico                | Numerico               |                                                        |
| percIva                 | Numerico ( 2 decimali) | 22.00                                                  |
| idIva                   | Numerico               | 1                                                      |
| prezzoVendita           | Numerico ( 2 decimali) | 54.10                                                  |
| prezzoPubblico          | Numerico ( 2 decimali) | 66.00                                                  |
| idUMAcquisto            | Numerico               |                                                        |
| idUMVendita             | Numerico               | 2                                                      |
| idStagione              | Numerico               | 62                                                     |
| idClasse                | Numerico               | 42                                                     |
| idLinea                 | Numerico               |                                                        |
| idModello               | Numerico               | 3                                                      |
| idMateriale             | Numerico               | 23                                                     |
| idGriffe                | Numerico               | 175                                                    |
| puntoRiordino           | Numerico               |                                                        |
| lottoRiordino           | Numerico               |                                                        |
| scortaMinima            | Numerico               |                                                        |
| barcode                 | 12 cifre Numerico      | 210000000201                                           |
| shopOnline              | Numerico               | 1= Attivo in Relax Plus                                |
| shopOnline2             | Numerico               | 1= Attivo in Relax Plus                                |
| idProdottoAlternativo   | Numerico               |                                                        |
| foto                    | Non disponibile        |                                                        |
| idTipologiaProdotto     | Numerico               |                                                        |
| taglieColori            |                        | <p>1= Taglia e colore</p><p>2 =Non Taglia e colore</p> |
| idTipoTaglia            | Numerico               | 48                                                     |
| fittizio                | Numerico               |                                                        |
| tipoTagliaId            | Numerico               |                                                        |
| nomeTaglia              | Alfanumerico           | TG ABB UOMO                                            |
| classe                  | Alfanumerico           | Abbigliamento uomo                                     |
| famiglia                | Alfanumerico           | PANTALONE                                              |
| materiale               | Alfanumerico           |                                                        |
| stagione                | Alfanumerico           | AI 2020-21                                             |
| linea                   | Alfanumerico           |                                                        |
| griffe                  | Alfanumerico           | ADIDAS                                                 |
| produttore              | Alfanumerico           |                                                        |
| fornitore               | Alfanumerico           | MARCELLO SPA                                           |
| tipoprodotto            | Alfanumerico           | VENDITA                                                |

### Tracciato Taglia e colore <a href="#id-3t9mg3x1a85f" id="id-3t9mg3x1a85f"></a>

(<https://percorso-relaxcliente/entities/api/get-products>)

| Nome Campo     | Valore               | Note           |
| -------------- | -------------------- | -------------- |
| id             | Numerico Progressivo | 51700          |
| codiceArticolo | Alfanumerico         | 12345\_001\_TG |

Sotto elementi del record con le specifiche delle taglie e colori:

| Nome Campo            | Valore                 | Note         |
| --------------------- | ---------------------- | ------------ |
| id                    | Numerico Progressivo   | 51700        |
| idArticolo            | Numerico               | 6654         |
| idColore              | Numerico               | 61           |
| idTagliaDescrizione   | Numerico               | 390          |
| costo                 | Numerico ( 2 decimali) | 11.00        |
| prezzoVendita         | Numerico ( 2 decimali) | 54.10        |
| prezzoPubblico        | Numerico ( 2 decimali) | 66.00        |
| barcode               | Numerico               | 210000000203 |
| barcodeFornitore      | Numerico               |              |
| idIva                 | Numerico               | 0            |
| percIva               | Numerico ( 2 decimali) | 0.00         |
| tagliaDescrizioneId   | Numerico               | 390          |
| descrizioneTaglia     | Alfanumerico           | 46           |
| idTaglia              | Numerico               | 48           |
| ivaId                 | Numerico               |              |
| descrizioneIva        | Numerico               |              |
| coloreId              | Numerico               | 71           |
| descrizioneColore     | Alfanumerico           | BLU JEANS    |
| descrizioneColoreShop | Alfanumerico           |              |
| coloreCodice          | Numerico               |              |
| coloreRGB             | Numerico               |              |

**combinations**:

\[

* {
  * **id**: "51700",
  * **idArticolo**: "6654",
  * **idColore**: "71",
  * **idTagliaDescrizione**: "390",
  * **costo**: "11.00",
  * **prezzoVendita**: "54.10",
  * **prezzoPubblico**: "66.00",
  * **barcode**: "210000000203",
  * **barcodeFornitore**: "",
  * **idIva**: null,
  * **percIva**: null,
  * **tagliaDescrizioneId**: "390",
  * **descrizioneTaglia**: "46",
  * **idTaglia**: "48",
  * **ivaId**: null,
  * **descrizioneIva**: null,
  * **coloreId**: "71",
  * **descrizioneColore**: "BLU JEANS",
  * **descrizioneColoreShop**: null,
  * **coloreCodice**: null,
  * **coloreRGB**: null
* },
* {
  * **id**: "51701",
  * **idArticolo**: "6654",
  * **idColore**: "71",
  * **idTagliaDescrizione**: "391",
  * **costo**: "11.00",
  * **prezzoVendita**: "54.10",
  * **prezzoPubblico**: "66.00",
  * **barcode**: "210000000204",
  * **barcodeFornitore**: "",
  * **idIva**: null,
  * **percIva**: null,
  * **tagliaDescrizioneId**: "391",
  * **descrizioneTaglia**: "48",
  * **idTaglia**: "48",
  * **ivaId**: null,
  * **descrizioneIva**: null,
  * **coloreId**: "71",
  * **descrizioneColore**: "BLU JEANS",
  * **descrizioneColoreShop**: null,
  * **coloreCodice**: null,
  * **coloreRGB**: null
* },

### Tracciato Giacenza <a href="#qmi36nxtnn07" id="qmi36nxtnn07"></a>

(<https://percorso-relaxcliente/entities/api/get-stocks>)

Esempio: <https://demo.r-elax.cloud/entities/api/get-stocks>

| Nome Campo             | Valore   | Note         |
| ---------------------- | -------- | ------------ |
| idArticolo             | Numerico | 6725         |
| idArticoloTaglieColori | Numerico | 50469        |
| idColore               | Numerico | 1394         |
| idTagliaDescrizione    | Numerico | 97           |
| barcode                | Numerico | 200000012484 |
| quantita               | Numerico | 2            |

\[

* {
  * **idArticolo**: "6425",
  * **idArticoloTaglieColori**: "50469",
  * **idColore**: "1394",
  * **idTagliaDescrizione**: "97",
  * **barcode**: "200000012484",
  * **quantita**: 2
* },
* {
  * **idArticolo**: "6425",
  * **idArticoloTaglieColori**: "50470",
  * **idColore**: "1394",
  * **idTagliaDescrizione**: "89",
  * **barcode**: "200000012485",
  * **quantita**: 2
* },
* {
  * **idArticolo**: "6425",
  * **idArticoloTaglieColori**: "50471",
  * **idColore**: "1394",
  * **idTagliaDescrizione**: "257",
  * **barcode**: "200000012486",
  * **quantita**: 2
* },

### Tracciato Saldi e Promozione <a href="#gb2tfofwypmz" id="gb2tfofwypmz"></a>

(<https://percorso-relaxcliente/entities/api/get-sales>)

Esempio: <https://demo.r-elax.cloud/entities/api/get-sales>

| Nome Campo  | Valore   | Note             |
| ----------- | -------- | ---------------- |
| id          | Numerico | 67               |
| descrizione | Testo    | Shop Online PE21 |
| dataForm    | Data     | 2021-07-06       |
| dataTo      | Data     | 2021-07-31       |

| Nome Campo     | Valore | Note                |
| -------------- | ------ | ------------------- |
| idArticolo     | Numero | 7444                |
| codiceArticolo | Testo  | AB-001              |
| percentuale    | Numero | 60.000000           |
| taglieColori   | Numero | 1                   |
| idColori       | Numero | <p>13</p><p>106</p> |

{

* **infoSaldo**:
* {
  * **id**: "67",
  * **descrizione**: "Shop ONline PE21",
  * **dataFrom**: "2021-07-06",
  * **dataTo**: "2021-07-31"
* },
* **articoli**:
* \[
  * {
    * **idArticolo**: "7444",
    * **codiceArticolo**: "AB-001",
    * **percentuale**: "60.000000",
    * **taglieColori**: 1,
    * **idColori**:
    * \[
      * "13",
      * "106"
    * ]
  * }
* ]

}

### Esempio XML Prodotto <a href="#id-3z7pvk3ndxh8" id="id-3z7pvk3ndxh8"></a>

### Prodotto Senza Taglia e colore <a href="#id-5p7wo3jv6knt" id="id-5p7wo3jv6knt"></a>

* {
  * **id**: "6724",
  * **codiceArticolo**: "ES\_NON\_TG",
  * **codiceArticoloFornitore**: "",
  * **nome**: "Accessorio Esempio senza Taglie Colore",
  * **testoBreve**: "Testo Breve",
  * **testoEsteso**: "Testo esteso Esempio per Shop Online",
  * **keywords**: "Keywords1, Keywords2",
  * **idFornitore**: "138",
  * **idProduttore**: null,
  * **costoStandard**: "30.00",
  * **ricarico**: null,
  * **percIva**: "22.00",
  * **idIva**: "1",
  * **prezzoVendita**: "73.77",
  * **prezzoPubblico**: "90.00",
  * **idUMAcquisto**: null,
  * **idUMVendita**: "2",
  * **idStagione**: "72",
  * **idClasse**: "4",
  * **idLinea**: "18",
  * **idModello**: "225",
  * **idMateriale**: "23",
  * **idGriffe**: "333",
  * **puntoRiordino**: "",
  * **lottoRiordino**: "",
  * **scortaMinima**: null,
  * **barcode**: "210000001094",
  * **shopOnline**: "1",
  * **shopOnline2**: "1",
  * **idProdottoAlternativo**: null,
  * **foto**: null,
  * **idTipologiaProdotto**: "2",
  * **taglieColori**: "0",
  * **idTipoTaglia**: null,
  * **fittizio**: "0",
  * **tipoTagliaId**: null,
  * **nomeTaglia**: null,
  * **classe**: "ACCESSORI",
  * **famiglia**: "ANELLO",
  * **materiale**: "ACCIAIO",
  * **stagione**: "FW-2021",
  * **linea**: "AURORA",
  * **griffe**: "4MOMS",
  * **produttore**: null,
  * **fornitore**: "ABBI. FASHION GROUP SPA",
  * **tipoprodotto**: "VENDITA"
* },

### Prodotto Taglia e colore <a href="#kcsr8ja24kzc" id="kcsr8ja24kzc"></a>

{

* **id**: "6721",
* **codiceArticolo**: "12345\_001\_TG",
* **codiceArticoloFornitore**: "",
* **nome**: "Abbigliamento Esempio",
* **testoBreve**: "Testo Breve Nome Prodotto",
* **testoEsteso**: "Testo Esteso Shop Online Prodotto TG",
* **keywords**: "KEYWORDS, Keyword2",
* **idFornitore**: "138",
* **idProduttore**: null,
* **costoStandard**: "20.00",
* **ricarico**: null,
* **percIva**: "22.00",
* **idIva**: "1",
* **prezzoVendita**: "73.77",
* **prezzoPubblico**: "90.00",
* **idUMAcquisto**: null,
* **idUMVendita**: "2",
* **idStagione**: "72",
* **idClasse**: "3",
* **idLinea**: "86",
* **idModello**: "344",
* **idMateriale**: "3",
* **idGriffe**: "333",
* **puntoRiordino**: "",
* **lottoRiordino**: "",
* **scortaMinima**: null,
* **barcode**: "210000001019",
* **shopOnline**: "1",
* **shopOnline2**: "1",
* **idProdottoAlternativo**: null,
* **foto**: null,
* **idTipologiaProdotto**: "2",
* **taglieColori**: "1",
* **idTipoTaglia**: "2",
* **fittizio**: "0",
* **tipoTagliaId**: "2",
* **nomeTaglia**: "ABBIGLIAMENTO ",
* **classe**: "DONNA",
* **famiglia**: "ABITO",
* **materiale**: "COTONE",
* **stagione**: "FW-2021",
* **linea**: "ACCIAIO",
* **griffe**: "4MOMS",
* **produttore**: null,
* **fornitore**: "ABBI. FASHION GROUP SPA",
* **tipoprodotto**: "VENDITA",
* **combinations**:
* \[
  * {
    * **id**: "52349",
    * **idArticolo**: "6721",
    * **idColore**: "13",
    * **idTagliaDescrizione**: "63",
    * **costo**: "20.00",
    * **prezzoVendita**: "73.77",
    * **prezzoPubblico**: "90.00",
    * **barcode**: "210000001020",
    * **barcodeFornitore**: "",
    * **idIva**: "0",
    * **percIva**: "0.00",
    * **tagliaDescrizioneId**: "63",
    * **descrizioneTaglia**: "34",
    * **idTaglia**: "2",
    * **ivaId**: null,
    * **descrizioneIva**: null,
    * **coloreId**: "13",
    * **descrizioneColore**: "NERO",
    * **descrizioneColoreShop**: null,
    * **coloreCodice**: null,
    * **coloreRGB**: null
  * },
  * {
    * **id**: "52350",
    * **idArticolo**: "6721",
    * **idColore**: "13",
    * **idTagliaDescrizione**: "8",
    * **costo**: "20.00",
    * **prezzoVendita**: "73.77",
    * **prezzoPubblico**: "90.00",
    * **barcode**: "210000001021",
    * **barcodeFornitore**: "",
    * **idIva**: "0",
    * **percIva**: "0.00",
    * **tagliaDescrizioneId**: "8",
    * **descrizioneTaglia**: "36",
    * **idTaglia**: "2",
    * **ivaId**: null,
    * **descrizioneIva**: null,
    * **coloreId**: "13",
    * **descrizioneColore**: "NERO",
    * **descrizioneColoreShop**: null,
    * **coloreCodice**: null,
    * **coloreRGB**: null
  * },
  * {
    * **id**: "52351",
    * **idArticolo**: "6721",
    * **idColore**: "13",
    * **idTagliaDescrizione**: "9",
    * **costo**: "20.00",
    * **prezzoVendita**: "73.77",
    * **prezzoPubblico**: "90.00",
    * **barcode**: "210000001022",
    * **barcodeFornitore**: "",
    * **idIva**: "0",
    * **percIva**: "0.00",
    * **tagliaDescrizioneId**: "9",
    * **descrizioneTaglia**: "38",
    * **idTaglia**: "2",
    * **ivaId**: null,
    * **descrizioneIva**: null,
    * **coloreId**: "13",
    * **descrizioneColore**: "NERO",
    * **descrizioneColoreShop**: null,
    * **coloreCodice**: null,
    * **coloreRGB**: null
  * },
  * {
    * **id**: "52352",
    * **idArticolo**: "6721",
    * **idColore**: "13",
    * **idTagliaDescrizione**: "10",
    * **costo**: "20.00",
    * **prezzoVendita**: "73.77",
    * **prezzoPubblico**: "90.00",
    * **barcode**: "210000001023",
    * **barcodeFornitore**: "",
    * **idIva**: "0",
    * **percIva**: "0.00",
    * **tagliaDescrizioneId**: "10",
    * **descrizioneTaglia**: "40",
    * **idTaglia**: "2",
    * **ivaId**: null,
    * **descrizioneIva**: null,
    * **coloreId**: "13",
    * **descrizioneColore**: "NERO",
    * **descrizioneColoreShop**: null,
    * **coloreCodice**: null,
    * **coloreRGB**: null
  * },
  * {
    * **id**: "52353",
    * **idArticolo**: "6721",
    * **idColore**: "13",
    * **idTagliaDescrizione**: "11",
    * **costo**: "20.00",
    * **prezzoVendita**: "73.77",
    * **prezzoPubblico**: "90.00",
    * **barcode**: "210000001024",
    * **barcodeFornitore**: "",
    * **idIva**: "0",
    * **percIva**: "0.00",
    * **tagliaDescrizioneId**: "11",
    * **descrizioneTaglia**: "42",
    * **idTaglia**: "2",
    * **ivaId**: null,
    * **descrizioneIva**: null,
    * **coloreId**: "13",
    * **descrizioneColore**: "NERO",
    * **descrizioneColoreShop**: null,
    * **coloreCodice**: null,
    * **coloreRGB**: null
  * },
  * {
    * **id**: "52354",
    * **idArticolo**: "6721",
    * **idColore**: "13",
    * **idTagliaDescrizione**: "12",
    * **costo**: "20.00",
    * **prezzoVendita**: "73.77",
    * **prezzoPubblico**: "90.00",
    * **barcode**: "210000001025",
    * **barcodeFornitore**: "",
    * **idIva**: "0",
    * **percIva**: "0.00",
    * **tagliaDescrizioneId**: "12",
    * **descrizioneTaglia**: "44",
    * **idTaglia**: "2",
    * **ivaId**: null,
    * **descrizioneIva**: null,
    * **coloreId**: "13",
    * **descrizioneColore**: "NERO",
    * **descrizioneColoreShop**: null,
    * **coloreCodice**: null,
    * **coloreRGB**: null
  * },
  * {
    * **id**: "52355",
    * **idArticolo**: "6721",
    * **idColore**: "13",
    * **idTagliaDescrizione**: "13",
    * **costo**: "20.00",
    * **prezzoVendita**: "73.77",
    * **prezzoPubblico**: "90.00",
    * **barcode**: "210000001026",
    * **barcodeFornitore**: "",
    * **idIva**: "0",
    * **percIva**: "0.00",
    * **tagliaDescrizioneId**: "13",
    * **descrizioneTaglia**: "46",
    * **idTaglia**: "2",
    * **ivaId**: null,
    * **descrizioneIva**: null,
    * **coloreId**: "13",
    * **descrizioneColore**: "NERO",
    * **descrizioneColoreShop**: null,
    * **coloreCodice**: null,
    * **coloreRGB**: null
  * },
  * {
    * **id**: "52356",
    * **idArticolo**: "6721",
    * **idColore**: "13",
    * **idTagliaDescrizione**: "62",
    * **costo**: "20.00",
    * **prezzoVendita**: "73.77",
    * **prezzoPubblico**: "90.00",
    * **barcode**: "210000001027",
    * **barcodeFornitore**: "",
    * **idIva**: "0",
    * **percIva**: "0.00",
    * **tagliaDescrizioneId**: "62",
    * **descrizioneTaglia**: "48",
    * **idTaglia**: "2",
    * **ivaId**: null,
    * **descrizioneIva**: null,
    * **coloreId**: "13",
    * **descrizioneColore**: "NERO",
    * **descrizioneColoreShop**: null,
    * **coloreCodice**: null,
    * **coloreRGB**: null
  * },
  * {
    * **id**: "52357",
    * **idArticolo**: "6721",
    * **idColore**: "13",
    * **idTagliaDescrizione**: "37",
    * **costo**: "20.00",
    * **prezzoVendita**: "73.77",
    * **prezzoPubblico**: "90.00",
    * **barcode**: "210000001028",
    * **barcodeFornitore**: "",
    * **idIva**: "0",
    * **percIva**: "0.00",
    * **tagliaDescrizioneId**: "37",
    * **descrizioneTaglia**: "50",
    * **idTaglia**: "2",
    * **ivaId**: null,
    * **descrizioneIva**: null,
    * **coloreId**: "13",
    * **descrizioneColore**: "NERO",
    * **descrizioneColoreShop**: null,
    * **coloreCodice**: null,
    * **coloreRGB**: null
  * },

### Esempio XML Giacenza <a href="#cf4ju1utdh9j" id="cf4ju1utdh9j"></a>

\[

* {
  * **idArticolo**: "6721",
  * **idArticoloTaglieColori**: "52349",
  * **idColore**: "13",
  * **idTagliaDescrizione**: "63",
  * **barcode**: "210000001020",
  * **quantita**: 6
* },
* {
  * **idArticolo**: "6721",
  * **idArticoloTaglieColori**: "52350",
  * **idColore**: "13",
  * **idTagliaDescrizione**: "8",
  * **barcode**: "210000001021",
  * **quantita**: 6
* },
