Esquemas personalizados

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

Cuándo tiene sentido

• Documento de un proveedor con un diseño no estándar.
• Especialidad del sector: boletos de pesaje, protocolos 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 se puede enviar a la contabilidad ni exportarse a formatos contables: estos leen campos fijos de la factura. Queda JSON, XML, YAML, CSV, Excel y PDF. En los informes solo se cuenta el documento que tiene 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á desde la plantilla (factura, factura con IVA, recibo, albarán, mínimo) o desde una copia del esquema del sistema. Los campos de las plantillas tienen nombres en inglés al igual que los esquemas del sistema, por lo que el formulario de control encontrará la etiqueta; las descripciones de los campos están en el idioma de la interfaz y se pueden sobrescribir.

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 trae su asignación para el modelo, por lo que reconoce tan bien como el modelo; con el botón Desvincular se convierte en un esquema personalizado ordinario.

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

Esta es la cosa más importante de toda la página. description no solo sirve para las personas, el modelo también la lee. 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á regulado por la tarifa: 80 en Free y Starter, 160 en Business, 240 en Scale. También se cuentan los campos anidados y los campos de ítems. 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 controla la sintaxis de forma continua y no permitirá guardar hasta que el esquema sea válido. Solo se puede probar con un documento real: súbelo con el esquema seleccionado, o en un documento terminado elige Reprocesar. Ambas acciones cuestan créditos como si fueran procesamiento normal.

Cambios y eliminación

El esquema editado se aplica al procesamiento siguiente. Los documentos que ya han pasado mantienen los datos tal como fueron creados. No se puede eliminar un esquema que ha reconocido al menos un documento: los documentos perderían el formulario de control.