Schemi personalizzati

Quando hai bisogno di leggere qualcosa da un documento che non è presente negli schemi standard, definisci il tuo.

Quando ha senso

• Documento di un fornitore con layout non standard.
• Specializzazione di settore: ricevute di pesatura, protocolli di prova, carte carburante.
• Campo che hai bisogno nel tuo sistema e che non si trova altrove.

Tieni presente che un documento con schema personalizzato non può essere inviato alla contabilità né esportato in formati contabili—essi leggono campi fissi della fattura. Rimangono JSON, XML, YAML, CSV, Excel e PDF. Nei riepiloghi viene conteggiato solo il documento che ha il campo numerico TotalAmount.

Come si definisce

Con l'editor nella scheda Schemi. Si scrive in JSON Schema—oggetto con properties, per ogni campo type e description, liste come array con items. Chi conosce lo standard non sarà sorpreso; chi non lo conosce, può partire da un modello (fattura, fattura con IVA, ricevuta, bolla di consegna, minima) o da una copia dello schema di sistema.

Riferimenti, allOf, oneOf, condizioni e simili non sono consentiti dall'editor; lo schema deve essere un albero piatto di campi. La copia dello schema di sistema porta con sé anche la sua definizione per il modello, quindi riconosce altrettanto bene quanto il modello; premendo il pulsante Disconnetti, diventa un normale schema personalizzato.

La descrizione del campo è una guida per il modello

Questo è l'aspetto più importante di tutta la pagina. La description non serve solo all'utente, viene letta anche dal modello. La differenza tra "numero dell'ordine" e "numero dell'ordine, inizia con Z- e ha sei cifre, di solito si trova nell'angolo in alto a destra accanto al codice a barre" è enorme in termini di successo.

Limiti

Il numero di campi è regolato dal tariffario: 80 per Free e Starter, 160 per Business, 240 per Scale. Si contano anche i campi annidati e i campi degli articoli. I nomi e le descrizioni vengono inviati al modello per ogni documento, quindi uno schema più lungo significa un'elaborazione più costosa.

Prove

L'editor controlla continuamente la sintassi e non permette il salvataggio fino a quando lo schema non è corretto. Può essere testato solo su un documento reale: caricalo con lo schema selezionato, oppure per un documento già completato scegli Elabora di nuovo. Entrambi i casi costano crediti come una normale elaborazione.

Modifiche e cancellazioni

Lo schema modificato si applica per le elaborazioni successive. I documenti che sono già stati elaborati manterranno i dati così come sono stati generati. Non è possibile eliminare uno schema sotto il quale è stato riconosciuto almeno un documento—i documenti perderebbero il modulo di controllo.