DoConure

DoConure · Guida per l'integratore

Trasforma i tuoi dati in un PDF finito, con un modello di documento che controlli tu.

Come funziona

Invii dati strutturati; il servizio li unisce a un modello che hai caricato e restituisce un PDF. Il modello è un normale file Word, Excel o HTML con dei segnaposto dove vanno i valori variabili.

il tuo sistema (Salesforce, Odoo, uno script…)
        │
        │  JSON:  { "customer": { "name": "Acme Srl" }, … }
        ▼
   POST /api/v1/compose/documents/generate
        │
        ▼
      PDF

Il servizio non sa nulla di Salesforce o di Odoo, di proposito: qualsiasi sistema si integra allo stesso modo.

Formato del modello	Per cosa usarlo
Word (.docx)	Lettere, contratti, moduli, report. Il formato che chiunque sa modificare.
HTML	Controllo preciso dell'impaginazione, e velocità: circa 7× più rapido degli altri.
Excel (.xlsx)	Report tabellari con molte righe.

Termine	Significato
Tenant	Un cliente (un'organizzazione). Possiede i propri modelli e le proprie chiavi API, e non può vedere quelli di nessun altro.
Modello (template)	Il modello di documento, identificato da un id come invoice-standard-8bc99b.
Versione	Ogni caricamento ne crea una. Più versioni possono essere attive insieme — vedi Versioni.
Chiave API	La credenziale del tenant, inviata a ogni richiesta.

Su cosa puoi contare

Ciò di cui gli sviluppatori si lamentano nelle API di documenti e di firma, e cosa fa questa invece.

• Nessuna approvazione per andare in produzione. Un account è attivo appena ti registri; la produzione richiede credito, non una revisione.
• Test gratuiti con la chiamata vera. "isTest": true in settings non consuma credito: stesso indirizzo, stessa chiave.
• Ogni chiamata dice quanto è costata, in output.credits.items o nell'header X-Credits-Used. Senza credito, la chiamata viene rifiutata con un codice (Errori), mai spostata su un piano più caro; prima ti avvisa un'email.
• Errori leggibili. Ogni esito ha un codice e un numero stabili; i campi mancanti di un modello sono elencati per nome.
• Vedi cosa è successo, e rifallo. La console mostra il payload di ogni documento con un comando curl per ripeterlo, e per ogni webhook la risposta, il prossimo tentativo e un pulsante Invia di nuovo; Errori API elenca cosa è stato rifiutato alle tue chiavi, per codice, con un link alla riga di ogni codice in Errori.
• Il PDF assomiglia al tuo file Word. La pagina di un modello dice quali font di Word mancano e cosa li sostituisce (font).

Tutte le pagine

Raggruppate come nel menu laterale — prima un percorso rapido, poi una ricetta per ogni attività, poi tutto per esteso.

Cosa è cambiato in ogni versione è nelle note di rilascio. Un problema o un'idea: i clienti con accesso possono segnalarlo dalla console, e chiunque può scriverci dalla pagina dei contatti, anche per un reclamo.