Passo 1: richiedere un account sandbox

Richiedere un account sandbox per l'API PSB, e come passare dalla sandbox alla produzione.

Senza sandbox non c'è un percorso di integrazione sicuro. In acceptance testi token, invio e webhook senza impatto sulla produzione. I documenti di un account di test restano sulla rete Peppol di test.

Cosa richiedi

Richiedi le credenziali OAuth2 tramite la procedura guidata sandbox. Scegli il tipo di collegamento che stai costruendo (software proprio, ERP, service provider).

Richiedere sandbox

Dopo aver completato la richiesta, eConnect di solito crea:

DatoSignificatoclientIdIdentifica la tua applicazione presso l'Identity ServerclientSecretSegreto per le richieste di token; trattalo come una passwordParty di testParty Peppol sulla rete di test (invio/ricezione in accp)Username/password opzionaleSolo per il flusso Resource Owner Password; vedi Autenticazione
Costi e limiti

L'accesso sandbox/acceptance (accp-psb) è gratuito, così puoi iniziare a costruire senza barriere:

  • Nessuna tariffa di produzione o pacchetto di transazioni sul traffico sandbox/acceptance
  • Nessun limite rigido sulla durata del tuo accesso di test/acceptance
  • Nessun massimo sul numero di transazioni di test
  • Si applica comunque il fair use: un uso improprio o sproporzionatamente intenso può essere corretto

I costi di invio sulla sandbox non vengono scalati da un saldo o da un pacchetto documenti. Il PSB di produzione segue il partnership. Non esiste un prezzo pubblico per documento né un self-service per vedere o ricaricare un pacchetto documenti. Non indirizzare il consumo PSB al saldo Platform o alla ricarica Platform.

Flusso consigliato

Per integrazioni server-to-server: Client Credentials (grant_type=client_credentials, scope ap). I diritti sono legati all'applicazione senza password utente nel backend.

Cosa non fare ancora
  • Niente clientId di produzione nei .env locali
  • Niente traffico di test verso psb.econnect.eu / identity.econnect.eu
  • Non assumere che dati/party accp esistano in produzione
  • Non assumere che le credenziali sandbox funzionino in produzione
Dalla sandbox alla produzione

Un account sandbox non diventa da solo un ambiente di produzione. Per la produzione serve un appuntamento con Sales. Costo e tempi si definiscono per situazione cliente in quel colloquio. Non c'è un prezzo pubblico fisso né un lead time commerciale fisso al di fuori di quell'appuntamento.

  1. Appuntamento con Sales.
  2. Sales prepara un agreement da firmare.
  3. Firmi e compili il modulo di onboarding.
  4. Poi un ticket di consegna va a Delivery. Delivery prende l'ordine in carico.
  5. Produzione standard (nessun lavoro su misura): TechSupport consegna entro 10 giorni lavorativi.
  6. Lavoro su misura: il termine di consegna dipende dall'impatto.

Questo percorso non vale per la procedura guidata sandbox, un percorso partner e il colloquio di produzione del pacchetto software. Le credenziali sandbox non funzionano in produzione.

Checklist prima di continuare
  1. Credenziali ricevute e archiviate in modo sicuro (secrets manager / vault)
  2. Conosci il partyId della party di test
  3. Conosci la differenza acceptance/produzione. Avanti: Acceptance endpoints