{"id":1007,"date":"2022-12-14T11:04:05","date_gmt":"2022-12-14T10:04:05","guid":{"rendered":"https:\/\/compliance.toscana.it\/wordpress\/?page_id=1007"},"modified":"2022-12-14T11:10:27","modified_gmt":"2022-12-14T10:10:27","slug":"attivazione-servizi-cart-pt","status":"publish","type":"page","link":"https:\/\/compliance.toscana.it\/wordpress\/it\/attivazione-servizi-cart-pt\/","title":{"rendered":"ATTIVAZIONE SERVIZI CART"},"content":{"rendered":"\n

Piani Terapeutici<\/strong><\/p>\n\n\n\n

ATTIVAZIONE AMBIENTI STAGE E PRODUZIONE<\/strong><\/p>\n\n\n\n

Per fare richiesta di attivazione ambienti configurazione staging e\/o produzione e richiesta di fruizione degli endpoint CART occorre seguire la procedura indicata di seguito:<\/p>\n\n\n\n

Modalit\u00e0 di Adesione<\/strong><\/p>\n\n\n\n

Gli applicativi fruitori si autenticano attraverso l\u2019uso di credenziali TLS, fornite direttamente dal client tramite protocollo HTTPS (MTLS).<\/p>\n\n\n\n

L\u2019accesso, mediante protocollo HTTPS, prevede che sussista una relazione di trust tra applicativo fruitore ed API Gateway del CART, che viene preventivamente stabilito in fase di richiesta di adesione al servizio tramite lo scambio dei certificati. Il CART \u00e8 cos\u00ec in grado di identificare puntualmente l\u2019applicativo ed applicare i criteri di autorizzazione previsti per l\u2019accesso alle API sulla base dell\u2019identit\u00e0 del client fruitore.<\/p>\n\n\n\n

Per poter essere abilitati all’uso dei servizi, oggetto del presente documento, \u00e8 necessario avere fatto esplicita richiesta a Regione Toscana. In particolare \u00e8 necessario eseguire i seguenti passi:<\/p>\n\n\n\n

  1. Andare sul sito del CART nella sezione configurazione dei servizi https:\/\/cart.regione.toscana.it\/portale\/it\/panoramica-cart\/la-richiesta-di-adesione-ai-servizi\/<\/a><\/li>
  2. Scaricare il documento nella sezione Adesione API https<\/li>
  3. Riempire il documento indicando per i seguenti campi i seguenti valori<\/li><\/ol>\n\n\n\n
    API A CUI SI RICHIEDE L\u2019ADESIONE<\/td>< …><\/td><\/tr>
    SOGGETTO EROGATORE:<\/td>Regione Toscana<\/td><\/tr>
    REFERENTE TECNICO APPLICATIVO (*)<\/td>Omar Lorenzini<\/td><\/tr>
    EMAIL<\/td>grupposis@regione.toscana.it<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

    Le URL di erogazione dei servizi sono diversificate per il tipo di software ed in dettaglio:<\/p>\n\n\n\n

    per i software  di cartella medica utilizzati dai MMG\/PLS<\/strong>:<\/p>\n\n\n\n

    ambiente di stage<\/strong><\/p>\n\n\n\n

    • nome API : TrasmissionePianiTerapeuticiAifaMMG<\/strong> <\/li><\/ul>\n\n\n\n
      • nome API : ElencoProtocolliPianiTerapeuticiMMG<\/strong> <\/li><\/ul>\n\n\n\n
        • nome API : VisualizzazionePianoTerapeuticoAifaMMG<\/strong> <\/li><\/ul>\n\n\n\n
          • nome API : AnnullamentoPianoTerapeuticoAifaMMG<\/strong> <\/li><\/ul>\n\n\n\n

            ambiente di produzione<\/strong><\/p>\n\n\n\n

            • nome API : TrasmissionePianiTerapeuticiAifaMMG<\/strong> <\/li><\/ul>\n\n\n\n
              • nome API : ElencoProtocolliPianiTerapeuticiMMG<\/strong> <\/li><\/ul>\n\n\n\n
                • nome API : VisualizzazionePianoTerapeuticoAifaMMG<\/strong> <\/li><\/ul>\n\n\n\n
                  • nome API : AnnullamentoPianoTerapeuticoAifaMMG<\/strong> <\/li><\/ul>\n\n\n\n

                    per le applicazioni utilizzate dai medici specialisti<\/strong>:<\/p>\n\n\n\n

                    ambiente di stage<\/strong><\/p>\n\n\n\n

                    nome API :<\/p>\n\n\n\n

                    • TrasmissionePianiTerapeuticiAifa<\/li>
                    • ElencoProtocolliPianiTerapeutici<\/li>
                    • VisualizzazionePianoTerapeuticoAifa<\/li>
                    • AnnullamentoPianoTerapeuticoAifa<\/li><\/ul>\n\n\n\n

                      URL :<\/p>\n\n\n\n

                      • https:\/\/api.regione.toscana.it\/sanita\/C04\/PianiTerapeutici\/v1<\/li><\/ul>\n\n\n\n

                        ambiente di produzione<\/strong><\/p>\n\n\n\n

                        nome API :<\/p>\n\n\n\n

                        • TrasmissionePianiTerapeuticiAifa<\/li>
                        • ElencoProtocolliPianiTerapeutici<\/li>
                        • VisualizzazionePianoTerapeuticoAifa<\/li>
                        • AnnullamentoPianoTerapeuticoAifa<\/li><\/ul>\n\n\n\n

                          <\/p>\n\n\n\n

                          Modalit\u00e0 di invio<\/strong><\/p>\n\n\n\n

                          Per l\u2019apertura del canale  HTTPS, dipendentemente dal tipo di software, devono essere usati due modalit\u00e0 diverse::<\/p>\n\n\n\n

                          • per i software  di cartella medica utilizzati dai MMG\/PLS l’apertura del canale viene effettuato tramite la Tessera Sanitaria del medico, alla stregua della modalit\u00e0 utilizzato per la prescrizione elettronica.<\/li>
                          • per i medici specialisti l’apertura del canale viene effettuato tramite il certificato applicativo fornito da Regione Toscana<\/li><\/ul>\n\n\n\n
                            • Nel caso di software MMG\/PLS<\/strong><\/li><\/ul>\n\n\n\n
                              CERTIFICATO X.509:<\/td>TS\/CNS dell’utente <\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
                              • Nel caso di software utilizzato dai medici specialisti<\/strong><\/li><\/ul>\n\n\n\n
                                CERTIFICATO X.509:<\/td>va richiesto al CART (cartdesk@regione.toscana.it)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                                <\/p>\n\n\n\n

                                inviare il modulo compilato (uno per ogni API e\/o endpoint specificando l’ambiente stage o produzione) a: cartdesk@regione.toscana.it<\/strong><\/p>\n\n\n\n

                                e per conoscenza a;<\/strong><\/p>\n\n\n\n

                                omar.lorenzini@regione.toscana.it e grupposis@regione.toscana.it<\/strong><\/p>\n\n\n\n

                                <\/p>\n\n\n\n

                                Tracciatura delle comunicazioni<\/strong><\/p>\n\n\n\n

                                I Gateway del CART, per ogni richiesta gestita introducono alcuni header http, in particolare l\u2019header X-CART-id<\/strong> viene valorizzato con un identificativo unico di transazione generato dal CART che pu\u00f2 essere salvato per eventuali verifiche diagnostiche.<\/p>\n\n\n\n

                                Ad ogni invio l\u2019infrastruttura CART restituisce al chiamate l’identificativo della chiamata\/transazione. Tale identificativo \u00e8 restituito nella variabile  X-Cart-id <\/strong>posta nell’header HTTP.<\/p>\n\n\n\n

                                Il valore della variabile X-Cart-id<\/strong> deve essere sempre salvato e custodito perch\u00e9 permettere di certificare l’avvenuta comunicazione del messaggio garantendone la tracciabilit\u00e0 all’interno dell’intero sistema. E’ importante osservare che tale identificativo viene sempre restituito dall’infrastruttura sia in caso di accettazione o meno del messaggio.<\/strong><\/p>\n\n\n\n

                                Un esempio  di valore della variabile X-Cart-id \u00e8 il seguente b7cad8e2-72c4-41ce-ac9a-24ff2b3f72a0.<\/strong><\/p>\n\n\n\n

                                <\/p>\n","protected":false},"excerpt":{"rendered":"

                                Piani Terapeutici ATTIVAZIONE AMBIENTI STAGE E PRODUZIONE Per fare richiesta di attivazione ambienti configurazione staging e\/o produzione e richiesta di fruizione degli endpoint CART occorre seguire la procedura indicata di seguito: Modalit\u00e0 di Adesione Gli applicativi fruitori si autenticano attraverso l\u2019uso di credenziali TLS, fornite direttamente dal client tramite protocollo HTTPS (MTLS). L\u2019accesso, mediante protocollo […]<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":[],"_links":{"self":[{"href":"https:\/\/compliance.toscana.it\/wordpress\/wp-json\/wp\/v2\/pages\/1007"}],"collection":[{"href":"https:\/\/compliance.toscana.it\/wordpress\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/compliance.toscana.it\/wordpress\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/compliance.toscana.it\/wordpress\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/compliance.toscana.it\/wordpress\/wp-json\/wp\/v2\/comments?post=1007"}],"version-history":[{"count":4,"href":"https:\/\/compliance.toscana.it\/wordpress\/wp-json\/wp\/v2\/pages\/1007\/revisions"}],"predecessor-version":[{"id":1021,"href":"https:\/\/compliance.toscana.it\/wordpress\/wp-json\/wp\/v2\/pages\/1007\/revisions\/1021"}],"wp:attachment":[{"href":"https:\/\/compliance.toscana.it\/wordpress\/wp-json\/wp\/v2\/media?parent=1007"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}