Qué es
Un schema —esquema— es la descripción formal de la forma que deben tener unos datos: qué campos los componen, cómo se llama cada uno, de qué tipo es y cuáles son obligatorios. Se define antes de que exista el primer dato.
No es el dato ni el resultado: es el acuerdo sobre el molde. Quien produce la información se compromete a entregarla así y quien la recibe arma su proceso sobre esa forma. Cuando dos sistemas se conectan por una API, el esquema evita negociar la forma en cada entrega.
En palabras de contador
Piénsalo como el acuerdo de qué columnas va a tener la cédula, antes de que nadie la llene. No es la cédula ni son los importes: es la lista de campos —RFC, fecha de pago, importe actualizado, recargos— con su nombre y su tipo, que ambas partes dan por buena.
La ventaja se cobra después: si la fecha quedó acordada con ese nombre y en formato de fecha, nadie adivina si viene como texto o partida en dos. Sin ese acuerdo, cada entrega trae los campos que se le ocurran a quien la arme.
Ejemplo aplicado
Dos sistemas que se van a conectar. Ambas partes acuerdan cómo se llama cada campo y de qué tipo es antes de enlazarlos; eso mismo declara una herramienta expuesta por function calling.
Layout para recibir información del cliente. Le pides la nómina en un formato acordado: columnas con nombre fijo, RFC como texto, salario diario como número. Lo que no cumple el molde se detecta al cargarlo.
La estructura publicada de un CFDI. El XML de un comprobante declara qué nodos existen, cuáles son obligatorios y qué catálogo admite cada atributo. Así un validador revisa la forma antes del fondo.
Para qué sirve en un despacho
- Acordar qué campos devuelve una herramienta antes de integrarla.
- Detectar una entrega incompleta al cargarla, no al cierre.
- Automatizar información recurrente sin reacomodar columnas.
- Comparar periodos sabiendo que cada campo significa lo mismo.
Riesgos o limitaciones
Un esquema describe la forma, no el fondo. Un importe puede cumplir el molde y no corresponder al periodo que trabajas: pasar la validación de forma no dice si la cifra aplica a tu caso.
El punto delicado es el cambio. Si del otro lado renombran un campo o dejan de mandar uno que usabas, tu flujo de trabajo se detiene o, peor, sigue corriendo con un espacio vacío que nadie notó.
Buena práctica
Pídelo por escrito y completo antes de integrar nada: nombre de cada campo, tipo, si es obligatorio y qué llega cuando el dato no existe —campo vacío, ausente o con una marca—. Ese último caso es el que suele romper procesos. Luego compruébalo: pide dos respuestas de casos distintos y compáralas campo por campo; si aparecen campos que no venían en el documento, es una descripción aproximada.
Pregunta cómo se versiona y archiva la versión con la que se produjo cada resultado: eso permite rastrear por qué una entrega vieja se lee distinto de una reciente.
Preguntas frecuentes
¿En qué se distingue del structured output? El structured output es que la respuesta llegue en campos y no en prosa; el schema es el acuerdo previo sobre cuáles son esos campos y de qué tipo.
¿Lo tengo que leer yo? Conviene, aunque no lo escribas tú. La parte que importa es corta: los nombres de los campos y qué significa cada uno. Ahí ves si devuelve lo que tu papel de trabajo necesita.
¿Qué pasa si el proveedor agrega un campo nuevo? Si nada más agrega, lo que usabas suele seguir en su lugar. La atención va en lo que quita o renombra.
Términos relacionados
Conexión NexFiscal
En NexFiscal Skills la forma de la respuesta está versionada, y esa es la parte que le sirve a un despacho: agregar un campo nuevo no rompe lo que ya venías usando, y un cambio de forma obliga a publicar una versión nueva en lugar de llegar sin aviso. Visto así, un esquema es una promesa sobre lo que vas a recibir, y una promesa versionada te da margen para adaptarte en vez de enterarte a media temporada de cierres. Cuando evalúes una herramienta que vayas a integrar, pregunta justo eso: no solo qué campos devuelve hoy, sino qué pasa el día que cambien.
Revisa qué más conviene archivar junto a un resultado para poder reconstruirlo meses después
Escrito y revisado por Ernesto Sobrino, contador.
Última revisión: 24 de agosto de 2026.