Specifiche tecniche

Inviare le fatture relative alle spese sanitarie 730 al sistema TS® non è mai stato così facile.

L'XML, di cui trovate alcuni semplici esempi in seguito, va inviato all'indirizzo

https://www.gestionale.biz/inviaspesasanitaria/process.php

passando gli opportuni parametri:
method (obbligatorio per ogni chiamata): indica l'operazione da eseguire.

• invioFatture
• invioFattureSincrono
• reportMensile
• interrogazionePuntuale
• esitoInvio
• ricevutaPDF
• dettaglioErrori

xml (obbligatorio per ogni chiamata): è la stringa che contiene l'xml codificata in JSON
month (obbligatorio per reportMensile): indica l'anno ed il mese della richiesta nel formato AAAAMM. Es: 201701
output (obbligatorio per reportMensile): indica il tipo di report.

• I (data di invio)
• P (data di pagamento)

protocol (obbligatorio per esitoInvio, ricevutaPDF, dettaglioErrori): indica il numero di protocollo ricevuto dall'invio della fattura.

Riportiamo alcuni esempi di chiamata ai servizi esposti:

https://www.gestionale.biz/inviaspesasanitaria/process.php?method=invioFatture&xml=[stringa JSON]
https://www.gestionale.biz/inviaspesasanitaria/process.php?method=esitoInvio&xml=[stringa JSON]&protocol=[NUM. PROT.]
https://www.gestionale.biz/inviaspesasanitaria/process.php?method=dettaglioErrori&xml=[stringa JSON]&protocol=[NUM. PROT.]

Ricorda: le prime 10 richieste sono gratuite!!

Esempio di file XML (inviante una struttura accreditata)

<?xml version="1.0" encoding="UTF-8" ?>
<dati>
	<connessione>
		<!-- utente abilitato alla connessione al sistema TS -->
		<username>UWT3CBXX</username>
		<password>PBUW9EBP</password>
		<pincode>1302170925</pincode>
		
		<codice_regione>190</codice_regione> <!-- Se chi trasmette il dato e' una struttura, altrimenti non scrivere questo tag -->
		<codice_asl>201</codice_asl> <!-- Se chi trasmette il dato e' una struttura, altrimenti non scrivere questo tag -->
		<codice_ssa>888888</codice_ssa> <!-- Se chi trasmette il dato e' una struttura, altrimenti non scrivere questo tag -->
		<cf_proprietario>CCSRMO77A09H501E</cf_proprietario> <!-- Specificare sia se professionista che per struttura -->
		
		<!-- url dei servizi ws -->
		<url_inviotelematico>https://invioSS730pTest.sanita.finanze.it/InvioTelematicoSS730pMtomWeb/InvioTelematicoSS730pMtomPort</url_inviotelematico>
		<url_esitoinvio>https://invioSS730pTest.sanita.finanze.it/EsitoStatoInviiWEB/EsitoInvioDatiSpesa730Service</url_esitoinvio>
		<url_ricevutepdf>https://invioSS730pTest.sanita.finanze.it/Ricevute730ServiceWeb/ricevutePdf</url_ricevutepdf>
		<url_dettaglioerrori>https://invioSS730pTest.sanita.finanze.it/EsitoStatoInviiWEB/DettaglioErrori730Service</url_dettaglioerrori>
		<url_documentospesa>https://invioss730ptest.sanita.finanze.it/enti/DocumentoSpesa730pWeb/DocumentoSpesa730pPort</url_documentospesa>
	</connessione>

	<documento_spesa>

		<documento_fiscale>
			<partita_iva>03213213210</partita_iva>
			<data_emissione>2016-11-18</data_emissione>
			<numero_documento>
				<dispositivo>1</dispositivo>
				<numero>100ISS</numero>
			</numero_documento>
		</documento_fiscale>
		<data_pagamento>2016-11-18</data_pagamento>
		<flag_operazione>I</flag_operazione>
		<cf_cittadino>cf cittadino</cf_cittadino>
		<voce_spesa>
			<tipo_spesa>TK</tipo_spesa>
			<importo>100.25</importo>
		</voce_spesa>
		<voce_spesa>
			<tipo_spesa>TK</tipo_spesa>
			<importo>3.50</importo>
		</voce_spesa>

	</documento_spesa>
</dati>
				

Esempio di file XML (inviante un professionista)

<?xml version="1.0" encoding="UTF-8" ?>
<dati>
	<connessione>
		<!-- utente abilitato alla connessione al sistema TS -->
		<username>PNIMRA70A01H501P</username>
		<password>Salve123</password>
		<pincode>1492034195</pincode>
		<cf_proprietario>PNIMRA70A01H501P</cf_proprietario> <!-- Specificare sia se professionista che per struttura -->
		
		<codice_regione>190</codice_regione> <!-- Se chi trasmette il dato e' una struttura, altrimenti non scrivere questo tag -->
		<codice_asl>201</codice_asl> <!-- Se chi trasmette il dato e' una struttura, altrimenti non scrivere questo tag -->
		<codice_ssa>888888</codice_ssa> <!-- Se chi trasmette il dato e' una struttura, altrimenti non scrivere questo tag -->
		<cf_proprietario>CCSRMO77A09H501E</cf_proprietario> <!-- Specificare sia se professionista che per struttura -->
		
		<!-- url dei servizi ws -->
		<url_inviotelematico>https://invioSS730pTest.sanita.finanze.it/InvioTelematicoSS730pMtomWeb/InvioTelematicoSS730pMtomPort</url_inviotelematico>
		<url_esitoinvio>https://invioSS730pTest.sanita.finanze.it/EsitoStatoInviiWEB/EsitoInvioDatiSpesa730Service</url_esitoinvio>
		<url_ricevutepdf>https://invioSS730pTest.sanita.finanze.it/Ricevute730ServiceWeb/ricevutePdf</url_ricevutepdf>
		<url_dettaglioerrori>https://invioSS730pTest.sanita.finanze.it/EsitoStatoInviiWEB/DettaglioErrori730Service</url_dettaglioerrori>
		<url_documentospesa>https://invioss730ptest.sanita.finanze.it/enti/DocumentoSpesa730pWeb/DocumentoSpesa730pPort</url_documentospesa>
	</connessione>

	<documento_spesa>

		<documento_fiscale>
			<partita_iva>03213213210</partita_iva>
			<data_emissione>2016-11-18</data_emissione>
			<numero_documento>
				<dispositivo>1</dispositivo>
				<numero>100ISS</numero>
			</numero_documento>
		</documento_fiscale>
		<data_pagamento>2016-11-18</data_pagamento>
		<flag_operazione>I</flag_operazione>
		<cf_cittadino>cf cittadino</cf_cittadino>
		<voce_spesa>
			<tipo_spesa>TK</tipo_spesa>
			<importo>100.25</importo>
		</voce_spesa>
		<voce_spesa>
			<tipo_spesa>TK</tipo_spesa>
			<importo>3.50</importo>
		</voce_spesa>

	</documento_spesa>
</dati>
				

Esempio di richiesta del report mensile in PHP

// Codifico in JSON la stringa xml (come da esempio sopra)
$jsonXml = json_encode(simplexml_load_string($xml));

// Ottengo il risultato
$json = file_get_contents("https://www.gestionale.biz/inviaspesasanitaria/process.php?method=reportMensile&xml=".$jsonXml."&month=201701&output=O");

// Visualizzo il risultato
var_dump($json);