Actualizar encabezado de reportes
PUT/settings/reports/:id
Solo el encabezado de la empresa del usuario (uno de otra empresa responde 404); company_id enviado en records se ignora. Actualiza el encabezado de reportes indicado por id (el id retornado por GET /settings/reports). Los campos se envían como objeto JSON serializado en records; el id de la ruta prevalece sobre cualquier id enviado. El logo se envía en base64 (imgdata como data URL + imgname) y se guarda en image. Orden de validación: usuario sin empresa asociada (500) o empresa inactiva (403) → encabezado inexistente o de otra empresa (404) → records (422/500). Con un id ajeno o inexistente se responde 404 aunque records falte o sea inválido.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
- 500
Encabezado actualizado (la respuesta no incluye el registro)
No autenticado
La empresa del usuario está inactiva. Cuerpo: {"message": "La empresa se encuentra inactiva."}, sin success (o una página HTML si la petición no envía Accept: application/json).
El encabezado no existe o es de otra empresa. Mensaje: Encabezado de reportes no encontrado.
records ausente, vacío o con un string que no decodifica a un objeto JSON (por ejemplo un arreglo o un JSON inválido). Si records se envía como objeto JSON nativo en lugar de string, la API responde 500 (ver abajo). Mensaje: El campo records debe ser un objeto JSON serializado.
Límite general de 60 peticiones por minuto excedido.
Error interno, con dos formatos. Error al guardar en base de datos: {"success": false, "message": {"error": "..."}, "payload": "Internal Server Error"}. Error genérico del servidor (usuario sin empresa asociada, records enviado como objeto o arreglo JSON nativo en lugar de string, o, dentro de records, imgdata enviado como objeto o arreglo JSON, imgname enviado como objeto o arreglo JSON junto con un imgdata válido, o un campo del encabezado como line1/line2/foot/mime/image/timestamp enviado como objeto JSON): en producción y con Accept: application/json el cuerpo es solo {"message": "Server Error"}, sin success ni payload; sin ese encabezado se responde una página HTML.