/ docs
ProdottoConoscenzaSviluppatori
Piattaforma Control
Legacy Platform API: SOAP v3.1 Deprecated::

La SOAP API v3.1 di eConnect è deprecated. Non vengono più accettate nuove connessioni. Panoramica degli endpoint e migrazione verso la REST API.

Questa API è deprecated. eConnect non accetta più nuove connessioni SOAP. Ai pacchetti software che utilizzano ancora l'API SOAP si consiglia di migrare alla REST API (PSB). Le connessioni SOAP esistenti continuano a funzionare, ma non vengono più sviluppate.

La SOAP API v3.1 è l'API originale della piattaforma eConnect. Questa API è ancora supportata per le integrazioni esistenti, ma eConnect non accetta più nuove connessioni SOAP. Tutte le nuove integrazioni passano attraverso la REST API (PSB).

A chi è destinata questa documentazione?

Questa documentazione è destinata esclusivamente a fornitori di software e organizzazioni che dispongono già di un collegamento SOAP funzionante con la piattaforma eConnect, come integrazioni esistenti di parti quali ECI, Inventive o Bloxs. State sviluppando una nuova integrazione? Scegliete la PSB REST API, che offre sicurezza OAuth 2.0, webhook, SDK e documentazione estesa tramite Swagger UI.

Requisiti tecnici

La SOAP API funziona su SOAP 1.1 over HTTPS/SSL ed è conforme al WSDL Basic Profile v1.1. Un punto importante: Transfer-Encoding=chunked non è supportato. Questo è un errore di implementazione frequente.

CaratteristicaValoreProtocolloSOAP 1.1 over HTTPS/SSLEndpointhttps://api.everbinding.nl/soap/v3.1?subscriptionKey={subscriptionKey}WSDLDisponibile tramite sales@econnect.eu (subscriptionKey richiesta)AutenticazioneLogin con Consumer Key + Consumer Secret, poi SecurityTokenValidità token4 ore (oppure richiedere un nuovo token per sessione)
Endpoint disponibili

La SOAP API v3.1 offre i seguenti endpoint:

Autenticazione e gestione account
EndpointFunzioneLoginOttenere SecurityToken con Consumer Key + Consumer SecretGetAccountDetailsRichiedere informazioni sull'accountGetAccountPartiesOttenere le proprie party (con EConnectPartyId e stato Peppol)GetPartiesRichiedere tutte le party conosciuteGetPartyRichiedere dettagli party per ReferenceId
Invio documenti
EndpointFunzioneSendDocumentInviare un documento (Inbox + Outbox)GetOutboxDocumentsLista dei documenti inviati (metadati)GetOutboxDocumentOttenere documento outbox completo per ExternalIdGetOutboxDocumentStatusRichiedere lo stato di un documento inviato
Ricezione documenti
EndpointFunzioneGetInboxDocumentsLista dei documenti ricevuti (metadati)GetInboxDocumentOttenere documento inbox completo per ExternalIdGetInboxDocumentStatusRichiedere lo stato attuale di un documento ricevutoSetInboxDocumentStatusModificare lo stato di un documento ricevuto
Bozze e PDF
EndpointFunzioneGetDocumentsRichiedere documenti bozzaGetDocumentOttenere documento bozza completo per DocumentIdGetDocumentPdfScaricare il PDF di un documento come base64
Altro
EndpointFunzioneGetAdvisedInvoiceRecipientIdConsigliare il miglior ID destinatario PeppolRequestAppIntegrationAvviare richiesta di integrazione app (flusso commercialista)
SOAP vs. REST: le principali differenze
SOAP API v3.1PSB REST APIProtocolloSOAP 1.1REST (JSON)AutenticazioneConsumer Key/Secret + SecurityTokenOAuth 2.0DocumentazioneWSDL (su richiesta)Swagger UI / OpenAPISDKNessunoPHP e .NET (open source)WebhookNon disponibiliPienamente supportatiStatoDeprecated (nessuna nuova connessione)In sviluppo attivo
Richiedere il WSDL

Il WSDL non è disponibile pubblicamente. Avete un collegamento SOAP esistente e avete bisogno del WSDL? Contattate support@econnect.eu. Per le nuove integrazioni il WSDL non è disponibile; utilizzate la REST API.

Desidera passare alla moderna REST API? Consultare la documentazione PSB su psb.econnect.eu per la Swagger UI completa e la guida introduttiva.

Migri alla REST API

Correlati
NextAutenticazione SOAP