Corrispettivo Elettronico

Di seguito vengono elencate le chiamate per contattare i web service riguardanti la gestione dei documenti commerciali e le rispettive istruzioni per la compilazione degli oggetti utilizzati all'interno di esse.

Tutte le chiamate restituiscono un oggetto MysondInfoItem, il cui campo esito può assumere i valori descritti in fondo alla pagina.

Operazione	Chiamata	Cosa fa
WSC1	inviaCorrispettivo	Trasmette un documento commerciale.
WSC2	annullaCorrispettivo	Annulla un documento commerciale già trasmesso.
WSC3	listaCorrispettivo	Elenca i documenti commerciali da cassetto fiscale o gestionale.
WSC4	listaPagamenti	Elenca le modalità di pagamento utilizzabili.
WSC5	verificaCredenzialiAde	Verifica la correttezza delle credenziali Fisconline.
WSC6	cambiaPasswordAde	Effettua il cambio password delle credenziali Fisconline.

Descrizione servizi esposti

WSC1 — Trasmissione di un documento commerciale

La chiamata seguente consente la trasmissione di un documento commerciale. Il documento commerciale può essere trasmesso in due modi: compilando l'oggetto CorrispettivoTestataItem o compilando il campo tracciato, a seconda del valore inserito nel campo tipoTrasmissione.

inviaCorrispettivo:

    Parametro in ingresso:
        CorrispettivoElettronicoItem:
            - utenteItem <UtenteItem>: indica le credenziali dell'utente per effettuare l'accesso ad e-Portale.
            - utenteAdeItem <UtenteAdeItem>: indica le credenziali Fisconline del soggetto emittente.
            - tipoTrasmissione <byte>: indica in quale modo viene passato il documento commerciale all'interno della chiamata.
            - corrispettivoTestataItem <CorrispettivoTestataItem>: oggetto da popolare per la generazione del tracciato del documento commerciale.
            - tracciato <byte[]>: array di byte del tracciato riguardante il documento commerciale.

    Valore di ritorno:
        MysondInfoItem:
            - esito <byte>: contiene l'esito della chiamata.
            - codice <String>: contiene il codice della chiamata.
            - descrizione <String>: contiene la descrizione della chiamata.
            - messaggio <String>: contiene l'oggetto JSON che restituisce la chiamata all'Agenzia delle Entrate.

REQUEST SOAP:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cor="http://corrispettivoelettronico.ws.mysond.it/">
   <soapenv:Header/>
   <soapenv:Body>
      <cor:inviaCorrispettivo>
         <arg0>
            <utenteAdeItem>
               <password></password>
               <pincode></pincode>
               <username></username>
               <tipoUtenza></tipoUtenza>
               <utenza1></utenza1>
               <utenza2></utenza2>
            </utenteAdeItem>
            <utenteItem>
               <codiceAzienda></codiceAzienda>
               <password></password>
               <username></username>
            </utenteItem>
            <tipoTrasmissione>1</tipoTrasmissione>
            <tracciato/>
            <corrispettivoTestataItem>
               <ammontareComplessivo>3</ammontareComplessivo>
               <cfCessionarioCommittente></cfCessionarioCommittente>
               <corrispettivoRigaItemList>
                  <aliquotaIva>22</aliquotaIva>
                  <descrizione>Prova 22%</descrizione>
                  <imponibile>2.46</imponibile>
                  <imponibileNetto>2.46</imponibileNetto>
                  <importoIva>0.54</importoIva>
                  <prezzoLordo>3</prezzoLordo>
                  <prezzoUnitario>2.46</prezzoUnitario>
                  <quantita>3</quantita>
                  <scontoLordo>0</scontoLordo>
                  <scontoUnitario>0</scontoUnitario>
                  <totale>3</totale>
               </corrispettivoRigaItemList>
               <dataDoc>2026-09-16T11:46:00</dataDoc>
               <importoTotaleIva>0.54</importoTotaleIva>
               <corrispettivoPagamentoItemList>
                   <tipo>PC</tipo>
                   <importo>2.00</importo>
                   <incasso>2.00</incasso>
                   <resto>0.00</resto>
               </corrispettivoPagamentoItemList>
               <corrispettivoPagamentoItemList>
                   <tipo>PE</tipo>
                   <importo>1.00</importo>
                   <incasso>1.00</incasso>
                   <resto>0.00</resto>
               </corrispettivoPagamentoItemList>
               <scontoTotale>0.00000000</scontoTotale>
               <scontoTotaleLordo>0.00000000</scontoTotaleLordo>
               <totaleImponibile>2.46</totaleImponibile>
               <scontoAbbuono>0</scontoAbbuono>
            </corrispettivoTestataItem>
         </arg0>
      </cor:inviaCorrispettivo>
   </soapenv:Body>
</soapenv:Envelope>

WSC2 — Annullo di un documento commerciale

La chiamata seguente consente di effettuare l'annullo di un documento commerciale. Il documento commerciale può essere annullato compilando il campo progressivoSdi con il progressivo del documento commerciale che si desidera annullare.

annullaCorrispettivo:

    Parametro in ingresso:
        CorrispettivoElettronicoItem:
            - utenteItem <UtenteItem>: indica le credenziali dell'utente per effettuare l'accesso ad e-Portale.
            - utenteAdeItem <UtenteAdeItem>: indica le credenziali Fisconline del soggetto emittente.
            - progressivoSdi <String>: indica il progressivo del documento commerciale che si desidera annullare.

    Valore di ritorno:
        MysondInfoItem:
            - esito <byte>: contiene l'esito della chiamata.
            - codice <String>: contiene il codice della chiamata.
            - descrizione <String>: contiene la descrizione della chiamata.
            - messaggio <String>: contiene l'oggetto JSON che restituisce la chiamata all'Agenzia delle Entrate.

REQUEST SOAP:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cor="http://corrispettivoelettronico.ws.mysond.it/">
   <soapenv:Header/>
   <soapenv:Body>
      <cor:annullaCorrispettivo>
         <arg0>
            <utenteAdeItem>
               <password></password>
               <pincode></pincode>
               <username></username>
               <tipoUtenza></tipoUtenza>
               <utenza1></utenza1>
               <utenza2></utenza2>
            </utenteAdeItem>
            <utenteItem>
               <codiceAzienda></codiceAzienda>
               <password></password>
               <username></username>
            </utenteItem>
            <progressivoSdi>DCW2026/8899-4683</progressivoSdi>
         </arg0>
      </cor:annullaCorrispettivo>
   </soapenv:Body>
</soapenv:Envelope>

WSC3 — Lista dei documenti commerciali

La chiamata seguente consente di richiedere la lista dei documenti commerciali presenti all'interno del cassetto fiscale o del gestionale, in base al valore inserito nel campo from. Se richiesti dal cassetto fiscale, i documenti commerciali verrano inseriti nel campo messaggio della risposta sotto forma di stringa, mentre se richiesti dal gestionale verranno inseriti nel campo corrispettivoTestataItemList sotto forma di List<CorrispettivoTestataItem>. Per effettuare la chiamata l'intervallo temporale di ricerca non deve superare i 31 giorni. Inoltre è possibile filtrare il tipo di operazione desiderato a seconda del valore inserito nel campo tipoOperazione.

listaCorrispettivo:

    Parametro in ingresso:
        CorrispettivoElettronicoItem:
            - from <Byte>: indica al sistema dove effettuare la lettura dei documenti commerciali.
            - dataDal <Date>: filtro 'Data Dal' per la chiamata riguardante la lista dei documenti commerciali.
            - dataAl <Date>: filtro 'Data Al' per la chiamata riguardante la lista dei documenti commerciali.
            - tipoOperazione <String>: filtro per la tipologia di operazioni che si desidera recuperare.
            - utenteItem <UtenteItem>: indica le credenziali dell'utente per effettuare l'accesso ad e-Portale.
            - utenteAdeItem <UtenteAdeItem>: indica le credenziali Fisconline del soggetto emittente.

    Valore di ritorno:
        MysondInfoItem:
            - esito <byte>: contiene l'esito della chiamata.
            - codice <String>: contiene il codice della chiamata.
            - descrizione <String>: contiene la descrizione della chiamata.
            - messaggio <String>: contiene i documenti commerciali in caso di lettura da cassetto fiscale.
            - corrispettivoTestataItemList <List<CorrispettivoTestataItem>>: contiene i documenti commerciali in caso di lettura da gestionale.

REQUEST SOAP:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cor="http://corrispettivoelettronico.ws.mysond.it/">
    <soapenv:Header/>
    <soapenv:Body>
        <cor:listaCorrispettivo>
            <arg0>
                <utenteAdeItem>
                    <password></password>
                    <pincode></pincode>
                    <username></username>
                    <tipoUtenza></tipoUtenza>
                    <utenza1></utenza1>
                    <utenza2></utenza2>
                </utenteAdeItem>
                <utenteItem>
                    <codiceAzienda></codiceAzienda>
                    <password></password>
                    <username></username>
                </utenteItem>
                <from>1</from>
                <dataDal>2026-09-11T00:00:00</dataDal>
                <dataAl>2026-09-11T00:00:00</dataAl>
            </arg0>
        </cor:listaCorrispettivo>
    </soapenv:Body>
</soapenv:Envelope>

WSC4 — Lista dei pagamenti

La chiamata seguente consente di richiedere la lista dei pagamenti utilizzabili all'interno dello scontrino. I pagamenti vengono restituiti nel campo pagamentoItemList sotto forma di List<PagamentoItem>.

listaPagamenti:

    Parametro in ingresso:
        CorrispettivoElettronicoItem:
            - utenteItem <UtenteItem>: indica le credenziali dell'utente per effettuare l'accesso ad e-Portale.

    Valore di ritorno:
        MysondInfoItem:
            - esito <byte>: contiene l'esito della chiamata.
            - codice <String>: contiene il codice della chiamata.
            - descrizione <String>: contiene la descrizione della chiamata.
            - pagamentoItemList <List<PagamentoItem>>: contiene la lista dei pagamenti.

REQUEST SOAP:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cor="http://corrispettivoelettronico.ws.mysond.it/">
   <soapenv:Header/>
   <soapenv:Body>
      <cor:listaPagamenti>
         <arg0>
            <utenteItem>
               <codiceAzienda></codiceAzienda>
               <password></password>
               <username></username>
            </utenteItem>
         </arg0>
      </cor:listaPagamenti>
   </soapenv:Body>
</soapenv:Envelope>

WSC5 — Verifica credenziali Fisconline

La chiamata seguente consente di verificare la correttezza delle credenziali Fisconline.

verificaCredenzialiAde:

    Parametro in ingresso:
        VerificaCredenzialiAdeItem:
            - utenteItem <UtenteItem>: indica le credenziali dell'utente per effettuare l'accesso ad e-Portale.
            - utenteAdeItem <UtenteAdeItem>: indica le credenziali Fisconline del soggetto emittente.

    Valore di ritorno:
        MysondInfoItem:
            - esito <byte>: contiene l'esito della chiamata.
            - codice <String>: contiene il codice della chiamata.
            - descrizione <String>: contiene la descrizione della chiamata.

REQUEST SOAP:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cor="http://corrispettivoelettronico.ws.mysond.it/">
   <soapenv:Header/>
   <soapenv:Body>
      <cor:verificaCredenzialiAde>
         <arg0>
            <utenteAdeItem>
               <password></password>
               <pincode></pincode>
               <username></username>
               <tipoUtenza></tipoUtenza>
               <utenza1></utenza1>
               <utenza2></utenza2>
            </utenteAdeItem>
            <utenteItem>
               <codiceAzienda></codiceAzienda>
               <password></password>
               <username></username>
            </utenteItem>
         </arg0>
      </cor:verificaCredenzialiAde>
   </soapenv:Body>
</soapenv:Envelope>

WSC6 — Cambia password credenziali Fisconline

La chiamata seguente consente di cambiare la password delle credenziali Fisconline, se scaduta.

cambiaPasswordAde:

    Parametro in ingresso:
        CambioPasswordAdeItem:
            - utenteItem <UtenteItem>: indica le credenziali dell'utente per effettuare l'accesso ad e-Portale.
            - utenza <String>: username dell'utenza per la quale si desidera cambiare la password.
            - vecchiaPassword <String>: vecchia password usata fino ad oggi.
            - nuovaPassword <String>: nuova password che si desidera impostare.
            - confermaPassword <String>: conferma della nuova password.

    Valore di ritorno:
        MysondInfoItem:
            - esito <byte>: contiene l'esito della chiamata.
            - codice <String>: contiene il codice della chiamata.
            - descrizione <String>: contiene la descrizione della chiamata.

REQUEST SOAP:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cor="http://corrispettivoelettronico.ws.mysond.it/">
   <soapenv:Header/>
   <soapenv:Body>
      <cor:cambiaPasswordAde>
         <arg0>
            <utenteItem>
               <codiceAzienda></codiceAzienda>
               <password></password>
               <username></username>
            </utenteItem>
            <utenza></utenza>
            <vecchiaPassword></vecchiaPassword>
            <nuovaPassword></nuovaPassword>
            <confermaPassword></confermaPassword>
         </arg0>
      </cor:cambiaPasswordAde>
   </soapenv:Body>
</soapenv:Envelope>

Struttura degli oggetti

UtenteItem — dati di accesso ad e-Portale

Campo	Descrizione
codiceAzienda	Codice azienda e-Portale della quale si vuole effettuare l'accesso.
username	Username dell'utente e-Portale.
password	Password dell'utente e-Portale.

UtenteAdeItem — credenziali Fisconline del soggetto emittente

Campo	Descrizione
tipoUtenza	Scelta dell'utenza di lavoro.
username	Username dell'utente incaricato Fisconline.
password	Password dell'utente incaricato Fisconline.
pincode	Pincode dell'utente incaricato Fisconline.
utenza1	Utenza di primo livello (Partita Iva del soggetto emittente).
utenza2	Utenza di secondo livello (da compilare solo in caso di necessità).

CorrispettivoTestataItem — testata del documento commerciale

Campo	Descrizione
cfCessionarioCommittente	Eventuale codice lotteria presentato dal cliente (non può essere indicato su documenti di importo inferiore ad 1 euro o non pagati esclusivamente con mezzi elettronici).
dataDoc	Data di emissione del documento commerciale. (Il formato della data deve essere: 'yyyy-MM-ddTHH:mm:ss')
importoTotaleIva	Importo totale dell'iva.
scontoTotale	Importo totale dello sconto.
scontoTotaleLordo	Importo lordo dello sconto.
scontoAbbuono	Indica l'abbuono o sconto a pagare.
totaleImponibile	Importo totale dell'imponibile.
ammontareComplessivo	Ammontare complessivo del documento commerciale.
corrispettivoRigaItemList	Lista delle righe del documento commerciale. CorrispettivoRigaItem
corrispettivoPagamentoItemList	Lista dei pagamenti del documento commerciale. CorrispettivoPagamentoItem

Campi in sola lettura

Valorizzati dal sistema, compaiono solo nella risposta di WSC3. Non vanno compilati in trasmissione.

Campo	Descrizione
id	Identificativo dell'oggetto.
progressivoSdi	Progressivo assegnato allo scontrino dal Sistema di Interscambio.
progressivoCollegato	Progressivo dello scontrino annullato nel caso di creazione di un Annullo.
tipo	Tipo dell'oggetto. Può assumere i seguenti valori.
stato	Stato attuale del preconto. Può assumere i seguenti valori.
tipoDoc	Tipo dello scontrino. Può assumere i seguenti valori.
descrizione	Descrizione dell'oggetto.
utenteLog_id	Utente che ha effettuato l'operazione.

CorrispettivoRigaItem — riga del documento commerciale

Campo	Descrizione
quantita	Quantità del prodotto all'interno della riga.
descrizione	Descrizione della riga.
prezzoLordo	Importo prezzo lordo della riga.
prezzoUnitario	Prezzo unitario del prodotto all'interno della riga.
scontoUnitario	Importo sconto unitario della riga.
scontoLordo	Importo sconto lordo della riga.
aliquotaIva	Aliquota o natura iva del prodotto all'interno della riga.
importoIva	Importo iva della riga.
imponibile	Importo imponibile della riga.
imponibileNetto	Importo imponibile netto della riga.
totale	Importo totale della riga.

Campi in sola lettura

Valorizzati dal sistema, compaiono solo nella risposta di WSC3. Non vanno compilati in trasmissione.

Campo	Descrizione
codice	Codice del prodotto.

CorrispettivoPagamentoItem — riga di pagamento del documento commerciale

Campo	Descrizione
codicePagamento	Opzionale - discriminante da usare in caso si abbiano più modalità di pagamento con lo stesso tipo e se ne voglia associare una in particolare.
tipo	Tipo della riga di pagamento. Può assumere i seguenti valori.
importo	Importo della riga di pagamento.
incasso	Incasso della riga di pagamento. Potrebbe differire dall'importo solo se il tipo della riga è pagamento contante (PC).
resto	Resto della riga di pagamento. Diverso da 0 solo se l'incasso è maggiore dell'importo della riga.

PagamentoItem — modalità di pagamento del documento commerciale

Campo	Descrizione
codice	Codice della modalità di pagamento.
descrizione	Descrizione della modalità di pagamento.
tipo	Tipo della modalità di pagamento. Può assumere i seguenti valori.

Valori ammessi

Valori di tipoUtenza

Valore	Descrizione
0	Per l'utenza di lavoro come Incaricato.
1	Per l'utenza di lavoro come Me Stesso.

Valori di tipoTrasmissione (WSC1)

Valore	Descrizione
1	Se si desidera trasmettere il documento commerciale compilando l'oggetto CorrispettivoTestataItem.
2	Se si desidera trasmettere il documento commerciale tramite byte array compilando il campo 'tracciato'.

Valori di from (WSC3)

Valore	Descrizione
null / 0	Se si desidera recuperare i documenti commerciali dal cassetto fiscale.
1	Se si desidera recuperare i documenti commerciali dal gestionale.

Valori di tipoOperazione (WSC3)

Valore	Descrizione
R	Se si desidera recuperare i documenti commerciali di tipo 'Reso'.
A	Se si desidera recuperare i documenti commerciali di tipo 'Annullo'.
V	Se si desidera recuperare i documenti commerciali di tipo 'Vendita/Prestazione'.

Valori di tipo (risposta WSC3)

Valore	Descrizione
1	Se è un preconto.
2	Se è uno scontrino.

Valori di stato (risposta WSC3)

Valore	Descrizione
0	Se il preconto è aperto.
1	Se il preconto è chiuso.

Valori di tipoDoc (risposta WSC3)

Valore	Descrizione
S	Se lo scontrino è una vendita.
A	Se lo scontrino è un annullo.

Valori di tipo (pagamenti)

Valore	Descrizione
PE	Pagamento elettronico
PC	Pagamento contante
NR_EF	Non riscosso - Emissione fattura
NR_PS	Non riscosso - Prestazioni di servizi
NR_CS	Non riscosso - Cessione per cessione di bene consegnato

Valori di esito

Valore	Descrizione
0	Se la chiamata è andata a buon fine.
!= 0	Se si sono verificati errori, specificati nei campi codice, descrizione e messaggio.

Download

L'archivio contiene il WSDL del servizio e il PDF di questa documentazione.

• CorrispettivoElettronicoService.zip