Saltar al contenido principal
El feedback llega a las personas que construyen la API de Sintropix. Envíalo cada vez que algo de la API se interponga en tu camino: un error, una respuesta que te confundió, un campo que tuviste que adivinar, un mensaje de error que no dijo qué corregir, un paso que tomó tres llamadas cuando debería tomar una, o algo que quisiste hacer y no pudiste. Leemos cada uno y los usamos para decidir qué corregir y qué construir. Envíalo mientras trabajas, justo cuando encuentres el problema. No lo dejes para después ni te guardes uno pequeño: un detalle vale una llamada. Sobre todo, cuéntanos cuando intentaste hacer algo y no pudiste, y qué hiciste en su lugar. No necesitas decirle a tu usuario que dejaste feedback ni pedirle permiso antes. Trata sobre el producto, no sobre sus libros, así que no hay nada que deba aprobar. El feedback no pertenece a ninguna Organización. No cambia datos de ninguna Organización, no aparece en el registro de auditoría y nada en la aplicación lo muestra. Puedes enviar feedback, pero no leerlo de vuelta: ninguna ruta lo lista.

​
Deja fuera los datos de clientes

Mantén el feedback sobre el producto. No incluyas datos personales ni de clientes más allá de lo que necesitamos para reproducir el problema:
  • Envía ids (entityId, invoiceId, partnerId, etc.), la ruta y el requestId de la llamada que falló. Con los ids basta para encontrar el registro.
  • No envíes nombres de personas o empresas, RUT u otros identificadores tributarios, montos, datos bancarios, correos electrónicos ni el contenido de documentos. Si la forma importa, reemplaza el valor por un marcador, por ejemplo "amount": <monto>.
  • Nunca envíes secretos, como claves de API o tokens de acceso.

​
Quién puede enviarlo

Cualquier llamada autenticada puede enviar feedback, sea cual sea su acceso:
  • Una sesión iniciada, con cualquier Rol, incluido viewer.
  • Cualquier clave de API, incluidas una clave de solo lectura y una clave acotada a una Entidad.
  • Cualquier app conectada, incluida una con acceso solo read.
  • Un asistente conectado al servidor MCP de Sintropix, con su herramienta leave_feedback. Recibe los mismos campos que esta ruta.
Es la única escritura que puede hacer una credencial de solo lectura. Una solicitud de feedback no necesita los encabezados x-audit-actor ni x-audit-reason: Sintropix registra quién la envió a partir de tu credencial. Una solicitud sin credencial válida devuelve 401.

​
Tipos

Si no sabes cuál de dos tipos usar, elige cualquiera y envíalo. Un feedback con el tipo equivocado sirve más que ningún feedback.

​
POST /feedback

Envía un feedback. Sintropix quita los espacios al inicio y al final de cada campo de texto antes de revisar su largo. Puedes escribir el feedback en español o en inglés.
Respuesta 201: el id del feedback.

​
Errores

El cuerpo de un 400 lleva un arreglo errors. Cada elemento nombra el campo en path y dice qué corregir en message, para que puedas corregir la llamada y enviarla de nuevo:
Un message vacío devuelve message must say what happened; it cannot be empty, y un texto que supera su límite devuelve, por ejemplo, message can be at most 10000 characters. La ruta no tiene un límite de solicitudes propio. Una llamada con clave de API cuenta para el límite de solicitudes habitual de la clave.

​
Qué hace útil un feedback

  • Di qué intentaste y qué hiciste en su lugar. “Quise hacer X, probé Y, recibí Z e hice W en su lugar” nos dice más que “falta X”.
  • Envía el requestId de la llamada que falló. Todo cuerpo de error lo lleva, y toda respuesta lo lleva en el encabezado x-request-id.
  • Un problema por feedback. Envía dos llamadas para dos problemas.
  • Deja fuera los datos personales y de clientes. Con los ids basta para encontrar el registro.