Editar representante legal

Este endpoint permite actualizar la información de un representante legal registrado en el sistema Guaraní App. Para ello, se debe realizar una solicitud HTTP de tipo PUT, proporcionando el identificador único del representante legal en la ruta y los datos actualizados en el cuerpo de la solicitud.

---

Entorno

URL base: https://api.guarani.app

Endpoint

PUT /representantes-legales/{id}

Para editar el representante legal es necesario primero solicitar un código de verificación para el número de WhatsApp. Este proceso de verificación es obligatorio y debe completarse antes de proceder con el registro del representante legal.

Paso previo obligatorio: Antes de editar el representante legal, debes solicitar un código de verificación WhatsApp para el representante legal. Una vez recibido el código, inclúyelo en el campo codigo del objeto whatsapp en esta solicitud. (ver aquí)

Ejemplo de solicitud

curl -X PUT "https://api.guarani.app/representantes-legales/{id}" \
  -H "Content-Type: application/json" \
  -H "x-api-key: Bearer <access_token>" \
  -d '{
    "cedula": "4321987",
    "nombres": "JUAN",
    "apellidos": "PEREZ CABALLERO",
    "email": "[email protected]",
    "whatsapp": {
        "numero": "+595981123456",
        "codigo": "123456"
    },
    "fecha_nacimiento": "11/09/2025"
  }' | jq

Nota: Si se desea actualizar el número de WhatsApp, se debe enviar el objeto whatsapp con el número y el código de verificación, si no se desea actualizar el número de WhatsApp, se debe enviar solamente “whatsapp”: “+595xxxxxxxxx”. Nota: Asegúrate de reemplazar {id} con el identificador único del representante legal y <access_token> con un token JWT válido proporcionado por el equipo Guarani.
Importante:
Es imprescindible incluir un token de acceso válido en el encabezado x-api-key para autenticar y autorizar el uso de este endpoint. Sin este token, la solicitud será rechazada.

---

Parámetros de ruta

Parámetro	Tipo	Requerido	Descripción
id	uuid	Sí	ID del representante legal a editar. ver representantes legales

Encabezados de la solicitud

Encabezado	Valor	Descripción
Content-Type	application/json	Indica que los datos se envían en formato JSON.
x-api-key	Bearer <access_token>	Token de autenticación necesario para acceder al recurso.

Descripción de Campos

Campo	Tipo	Requerido	Descripción
cedula	string	Sí	Número de cédula de identidad de la persona.
nombres	string	Sí	Nombres de la persona en mayúsculas.
apellidos	string	Sí	Apellidos de la persona en mayúsculas.
email	string	No	Correo electrónico de contacto.
whatsapp	objeto	No	Datos del número de WhatsApp de la persona.
fecha_nacimiento	date	No	Fecha de nacimiento de la persona en (formato DD/MM/YYYY).

whatsapp (objeto)

Campo	Tipo	Requerido	Tamaño	Descripción
numero	string	Sí	15	Número de WhatsApp en formato internacional (ej. +595xxxxxxxxx).
codigo	string	Sí	6	Código de verificación. Solo se envía cuando el número de WhatsApp cambia. (ver Solicitar codigo)

Ejemplo de respuesta

{
  "success": true,
  "codigo": "200",
  "message": "Recurso actualizado con éxito.",
  "data": {
    "id": "c8a1d6e4-7b3f-4f5e-94f3-7f20c9fbc1a1",
    "cedula": "4321987",
    "nombres": "JUAN",
    "apellidos": "PEREZ CABALLERO",
    "email": "[email protected]",
    "whatsapp": "+595981123456",
    "fecha_nacimiento": "11/09/2025"
  }
}

Para más información sobre posibles errores y cómo manejarlos, consulta errores.