Ambiente di prova

Ambiente Sandbox

Il sandbox ti permette di testare la tua integrazione senza toccare dati reali. Ogni developer registrato ottiene automaticamente un tenant di test isolato.

5

Clienti azienda

Sempre visibili via API

10

Clienti persona

5 con consenso terzi, 5 senza — per testare il filtro GDPR

20

Appuntamenti

Distribuiti sui prossimi 30 giorni

15

Prodotti/servizi

Con prezzi e aliquote IVA variati

10

Fatture attive

In stati diversi: bozza, emessa, pagata

5

Fatture passive

Fornitori di test

Caratteristiche del sandbox

  • SDI simulato — l'invio consegna la fattura subito (stato CONS, la fattura diventa Delivered); con codice destinatario SCARTO1 lo SDI la scarta (ERRO, la fattura diventa Scartata e si riapre con /reopen)
  • Firma digitale simulata — le firme sui consensi privacy si completano immediatamente
  • Pagamenti disabilitati — nessun addebito reale, crediti illimitati
  • Dati pre-caricati — clienti, prodotti, appuntamenti e fatture di prova, creati pochi minuti dopo la registrazione

Come usarlo

  1. 1Registra la tua app e attendi l'approvazione del team Pazienza
  2. 2App web: usa il Client ID sandbox (quello che finisce con -sandbox) e il suo secret, dalla pagina della tua app
  3. 3Avvia il flusso OAuth su https://api.pazienza.app/connect/authorize e accedi con il tuo account sviluppatore: il token punta già al tuo studio sandbox, senza header aggiuntivi
  4. 4Plugin distribuito: installalo con il tuo account sviluppatore e, nella schermata di consenso, scegli Studio sandbox
  5. 5Per controllare cosa è arrivato, apri la sandbox con Apri nel gestionale: vedi clienti, fatture e agenda come li vedono i tuoi utenti

Simulare gli esiti SDI

Dopo l'invio, una fattura nel sandbox può ricevere un esito SDI imposto da te con POST /api/cloud/invoices/{id}/sandbox/sdi-outcome. Serve una fattura già inviata: altrimenti la risposta è 409. Fuori dal sandbox la route risponde 404.

POST /api/cloud/invoices/{id}/sandbox/sdi-outcome
Content-Type: application/json

{
  "stato": "ERRO",
  "message": "Scarto di prova"
}
  • CONSconsegnata: la fattura diventa Delivered
  • NONCnon consegnata: la fattura diventa Delivered
  • ERROscartata: la fattura diventa Rejected (Scartata) e si riapre con /reopen per reinviarla
  • ACCEaccettata: la fattura diventa Accepted, passando da Delivered
  • RIFIrifiutata dal destinatario: la fattura diventa Rejected; non si riapre, si corregge con una nota di credito
  • DECOdecorrenza dei termini: la fattura diventa Accepted, passando da Delivered

Per ottenere lo scarto già all'invio, imposta come codice destinatario SCARTO1 sul cliente: la fattura viene scartata con esito ERRO.