Esquemas personalizados

Cuando necesitas leer algo de un documento que no está en los esquemas del sistema, defines tu propio esquema.

Cuándo tiene sentido

• Un documento de un proveedor con un diseño no estándar.
• Especialidad de la industria: boletos de pesaje, informes de prueba, tarjetas de combustible.
• Campos que necesitas en tu sistema y que no aparecen en ningún otro lugar.

Ten en cuenta que un documento de un esquema personalizado no puede ser enviado a la contabilidad ni exportado a formatos contables — estos leen campos fijos de la factura. Solo se mantiene JSON, XML, YAML, CSV, Excel y PDF. En los informes, solo se cuenta un documento que tenga el campo numérico TotalAmount.

Cómo se define

Con el editor en la pestaña Esquemas. Se escribe en JSON Schema — un objeto con properties, para cada campo type y description, listas como array con items. Quien conozca el estándar no se sorprenderá; quien no, comenzará con una plantilla (factura, factura con IVA, recibo, albarán, mínimo) o con una copia del esquema del sistema.

El editor no permite enlaces, allOf, oneOf, condiciones y construcciones similares; el esquema debe ser un árbol plano de campos. Una copia del esquema del sistema también lleva su entrada para el modelo, por lo que reconoce igual de bien como el patrón; al hacer clic en el botón Desvincular se convierte en un esquema personalizado ordinario.

La descripción del campo es una guía para el modelo

Esto es lo más importante de toda la página. description no solo sirve para las personas, también lo lee el modelo. La diferencia entre "número de pedido" y "número de pedido, comienza con Z- y tiene seis dígitos, suele estar en la esquina superior derecha junto al código de barras" es enorme en términos de éxito.

Límites

El número de campos está determinado por el plan: 80 en Free y Starter, 160 en Business, 240 en Scale. También se cuentan los campos anidados y los campos de artículos. Los nombres y descripciones se envían al modelo con cada documento, por lo que un esquema más largo significa un procesamiento más costoso.

Pruebas

El editor verifica la sintaxis continuamente y no permite el guardado hasta que el esquema sea correcto. Solo se puede probar en un documento real: cárgalo con el esquema seleccionado, o en un documento ya finalizado elige Procesar de nuevo. Ambas opciones consumen créditos como un procesamiento normal.

Cambios y eliminación

El esquema modificado se aplica a los próximos procesamientos. Los documentos que ya han pasado mantienen los datos tal como se generaron. No se puede eliminar un esquema según el cual se haya reconocido al menos un documento — los documentos perderían el formulario de control.