diff --git a/_platforms/en/18app.md b/_platforms/en/18app.md index 0aed60d97d7b..6196188ad9fc 100644 --- a/_platforms/en/18app.md +++ b/_platforms/en/18app.md @@ -21,11 +21,13 @@ managers: - name: Sogei url: http://www.sogei.it/ resources: - - Documentation: - - title: Guide for merchants - icon: file - url: https://docs.italia.it/italia/18app/18app-esercenti-docs/ - desc: Documentation for merchants who are interested in validating coupons via API + - Software: + - title: Carta Docente WooCommerce plugin + icon: github + url: /it/software//ilghera-wc-carta-docente-c00aa7 + - title: 18app WooCommerce plugin + icon: github + url: /it/software/ilghera-wc-18app-86eb94 - SDK: - title: SDK for Java icon: github @@ -36,12 +38,10 @@ resources: - title: SDK for .NET icon: github url: https://github.com/italia/18app-dotnet-sdk - - title: SDK for C++ + - Examples: + - title: Python example icon: github - url: https://github.com/italia/18app-cpp-sdk - - title: SDK for Magento (TODO) - icon: github - url: https://github.com/italia/18app-magento-sdk + url: https://github.com/italia/18app-python-example --- ## Intro @@ -50,7 +50,13 @@ resources: Users enter with their [SPID digital identity](/en/spid) into a web application that allows them to create coupons (identified by an alphanumeric code and a QR code) of arbitrary amounts, that can be later spent in the accredited stores, which can be either physical or online. At the payment stage, merchants verify that the supplied coupon is valid and subtract their value from the due amount. They will emit an invoice to the State in order to be reimbursed. -In order to validate a coupon, merchants can use a simple web form or can leverage an API in order to build an integration directly from their payment software. +## Validate a coupon + +In order to validate a coupon, merchants can use a simple web form or can leverage an API in order to build an integration directly from their payment software. Merchants must be +equipped with an authentication certificate to be installed in your client of the +service and use it in the SOAP call. + +## Collaboration Enter the forum Chat on Slack (#18app) (sign up) @@ -59,10 +65,3 @@ These discussion channels are aimed at free discussion among developers; they ar - [18app](https://www.18app.italia.it/){:target="_blank"} - [Carta Docente](https://cartadeldocente.istruzione.it/){:target="_blank"} - -## Native app - -In Developers Italia a native mobile app for 18app is being developed. This app will become official in Q2 2019. - -- [More details in the software catalogue](/en/software/m_bac-italia-18app) -- [GitHub repository](https://github.com/italia/18app){:target="_blank"} diff --git a/_platforms/it/18app.md b/_platforms/it/18app.md index b3cbd8c02c5e..ded5d65027e9 100644 --- a/_platforms/it/18app.md +++ b/_platforms/it/18app.md @@ -21,11 +21,13 @@ managers: - name: Sogei url: http://www.sogei.it/ resources: - - Documentazione: - - title: Guida per gli esercenti - icon: file - url: https://docs.italia.it/italia/18app/18app-esercenti-docs/ - desc: Documentazione per gli esercenti interessati ad integrarsi con le API per la verifica dei coupon + - Software: + - title: Carta Docente WooCommerce plugin + icon: open-source + url: /it/software//ilghera-wc-carta-docente-c00aa7 + - title: 18app WooCommerce plugin + icon: open-source + url: /it/software/ilghera-wc-18app-86eb94 - SDK: - title: SDK per Java icon: github @@ -36,12 +38,10 @@ resources: - title: SDK per .NET icon: github url: https://github.com/italia/18app-dotnet-sdk - - title: SDK per C++ + - Esempi: + - title: Esempio in Python icon: github - url: https://github.com/italia/18app-cpp-sdk - - title: SDK per Magento (TODO) - icon: github - url: https://github.com/italia/18app-magento-sdk + url: https://github.com/italia/18app-python-example --- ## Intro @@ -52,17 +52,25 @@ viene assegnato un bonus economico (€500) a determinate categorie di persone spendere con specifici vincoli (in cultura e formazione) presso esercenti accreditati. -I beneficiari si identificano tramite [SPID](/it/spid), e possono poi utilizzare una -responsive web application (quindi anche da smartphone) per spendere il +I beneficiari si identificano tramite [SPID](/it/spid), e possono poi utilizzare +una responsive web application (quindi anche da smartphone) per spendere il proprio portafoglio virtuale creandosi dei buoni sconto (QRCode e codice alfanumerico), utilizzabili presso gli esercenti convenzionati, che rientrano in due categorie: esercenti fisici o esercenti online. L'esercente, verificato che il coupon è valido, effettua lo sconto per l'acquirente, e poi successivamente emette fattura verso lo Stato per recuperare l'importo scontato. +## Validazione dei coupon + Per validare un coupon, l'esercente può collegarsi via API al sistema di backend, effettuando quindi una integrazione con il proprio sistema di cassa, -oppure manualmente tramite una semplice web form. +oppure manualmente tramite una semplice web form. Per consumare il web service +di verifica del voucher, ogni esercente dovrà essere +dotato di un certificato di autenticazione da installare nel proprio client del +servizio e da utilizzare nella chiamata SOAP per effettuare l’autenticazione in +modalità SSL con certificato client. + +## Canali Entra nel forum Dialoga su Slack (#18app) (registrati su Slack) @@ -71,10 +79,3 @@ Questi spazi di discussione non sono presidiati da Sogei pertanto non sono canal - [18app](https://www.18app.italia.it/){:target="_blank"} - [Carta Docente](https://cartadeldocente.istruzione.it/){:target="_blank"} - -## App nativa - -In Developers Italia è in corso lo sviluppo di una app nativa per 18app, che nella primavera 2019 diventerà la app ufficiale. - -- [Scheda nel catalogo del software](/it/software/m_bac-italia-18app) -- [Repository GitHub](https://github.com/italia/18app){:target="_blank"}