Vai al contenuto
Menu della documentazione

Guida rapida

Da un nuovo account al tuo primo PDF generato tramite API: collega, interroga, progetta, pubblica, genera.

Questa guida ti accompagna da un nuovo account a un PDF generato tramite API in pochi minuti, senza collegare alcun database: la galleria di esempi contiene template pronti (DDT, fattura, conferma d'ordine, preventivo, packing list, estratto conto, listino prezzi, scheda prodotto, etichetta di spedizione GS1 in ZPL, una lettera commerciale) che leggono dati demo integrati. Poi colleghi un template al tuo database.

  1. Crea un account

    Crea un account, apri il link di verifica che ti inviamo via email, poi accedi. Crea la tua organizzazione (prova gratuita o chiave di licenza) e il primo workspace: parte con tre ambienti (development, staging e production); il Designer lavora su development, dove puoi fare prove in libertà.

  2. Parti da un esempio

    L'onboarding propone Parti da un esempio; in seguito trovi la galleria in Template → Parti da un esempio (anche da Nuovo template). Ogni esempio mostra un'anteprima, cosa dimostra e i suoi parametri. Usa questo esempio lo copia nel tuo workspace come template in bozza, con il componente di intestazione e il logo che usa, e lo apre nel Designer. La copia è tua: la galleria non la modifica mai.

    Dati demo integrati

    I dataset degli esempi leggono la sorgente dati PRYNT_DEMO: un database demo in sola lettura di un'azienda di abbigliamento fittizia (clienti, ordini, DDT, fatture, articoli, spedizioni), uguale per tutti i workspace e mai mescolato con i tuoi dati. Niente da configurare.

  3. Guarda l'anteprima

    Premi Anteprima (F5): il PDF viene generato con il valore di prova di ogni parametro, per esempio DOCUMENT_ID = 82422 per il DDT. Cambia il valore nel pannello dell'anteprima per vedere un altro documento. Le etichette ZPL hanno un'anteprima propria, disegnata come la stamperebbe la stampante.

  4. Pubblica

    Pubblica convalida il template e crea la versione 1, non più modificabile, che diventa la versione corrente: l'API la genera dalla richiesta successiva, in tutti gli ambienti. Per cambiare il documento in seguito, crea una nuova bozza e pubblica di nuovo. Chi ha il ruolo designer vede invece Richiedi pubblicazione: un developer, un admin o l'owner la approva in Richieste di pubblicazione.

  5. Crea una chiave API

    In Sviluppatori → Chiavi API crea una chiave (una chiave di test per lo sviluppo). La chiave completa viene mostrata una sola volta: salvala come segreto nella configurazione della tua applicazione, mai nel codice del browser né nel controllo di versione.

  6. Genera il documento

    Chiama l'endpoint di generazione con il codice del template e i suoi parametri. Il corpo della risposta è il PDF.

    Terminale
    curl -X POST https://api.prynt.it/api/v1/render \  -H "Authorization: Bearer prynt_live_..." \  -H "Content-Type: application/json" \  -d '{    "template": "invoice",    "environment": "production",    "parameters": { "invoiceId": 18425 }  }' \  -o invoice-18425.pdf

    Una chiamata riuscita risponde 200 OK con Content-Type: application/pdf. In caso di errore la risposta è un problem document; vedi errori. La Panoramica del workspace ha la checklist Per iniziare che segue questi passi, con questa richiesta pronta da copiare per il tuo template (cURL, C#, JavaScript) e un pulsante Prova che scarica il PDF.

  7. Collega il tuo database

    In Sorgenti dati, scegli Nuova sorgente dati, dagli un nome e un codice e scegli Oracle (o PostgreSQL). Poi configura la connessione dell'ambiente development: un Prynt Gateway per un database in una rete privata (lo scarichi dal Download Center), oppure una connessione diretta su TLS per un database in cloud; host, porta e service name (per PostgreSQL il nome del database) e le credenziali di un utente che possa leggere le tabelle necessarie ai tuoi documenti. Salva la connessione la salva e la prova.

    Oracle · utente in sola lettura consigliato
    -- Un utente dedicato a Prynt, in sola letturaCREATE USER prynt_reader IDENTIFIED BY "<una password robusta>";GRANT CREATE SESSION TO prynt_reader;GRANT SELECT ON erp.invoices      TO prynt_reader;GRANT SELECT ON erp.invoice_lines TO prynt_reader;GRANT SELECT ON erp.customers     TO prynt_reader;

    Le credenziali restano protette

    Le password sono cifrate a riposo e non vengono mai rimandate al browser. I dataset possono solo leggere: le istruzioni che modificano i dati vengono rifiutate.

  8. Collega il template ai tuoi dati

    Apri il template nel Designer e, per ogni dataset, scegli la tua sorgente dati al posto di PRYNT_DEMO nella barra del dataset. Riscrivi la query sulle tue tabelle mantenendo gli stessi nomi di colonna con gli alias (il layout legge i campi per nome), eseguila per aggiornare i campi e controlla i parametri: i dataset degli esempi legano la ditta alla costante 01 dei dati demo, collegala a un tuo parametro o al valore di sistema DITTA. Prova l'anteprima con documenti reali, poi pubblica una nuova versione.

    Un dataset sulle tue tabelle
    SELECT i.invoice_no, i.issue_date, c.name AS customer_name,       l.description, l.quantity, l.amount  FROM erp.invoices i  JOIN erp.customers c      ON c.id = i.customer_id  JOIN erp.invoice_lines l  ON l.invoice_id = i.id WHERE i.id = :invoiceId ORDER BY l.line_no

  9. Disegna i tuoi template

    Per un documento tutto tuo, Nuovo template ne crea uno vuoto (formato Documento (PDF) o Etichetta ZPL): aggiungi un dataset (ogni variabile di bind come :invoiceId diventa un parametro), trascina i suoi campi sulla pagina, aggiungi tabelle, totali, un logo e barcode, e guarda l'anteprima quando vuoi.

Prossimi passi