Crear representante legal

Este endpoint permite registrar un nuevo representante legal en el sistema Guaraní App mediante una solicitud POST, es útil para registrar representantes legales de una empresa.

---

Entorno

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

Endpoint

POST /representantes-legales

Para crear un representante legal es necesario primero solicitar un código de verificación para verificar el número de WhatsApp vía 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 crear el representante legal, debes solicitar un código de verificación WhatsApp para verificar el número de WhatsApp. 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 POST "https://api.guarani.app/representantes-legales" \
  -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: Asegúrate de reemplazar <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.

---

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

Parámetro	Tipo	Requerido	Tamaño	Descripción
nombres	string	Sí	100	Nombres de la persona. Ej: “JUAN”.
apellidos	string	Sí	100	Apellidos de la persona. Ej: “PEREZ CABALLERO”.
cedula	string	Sí	11	Número de cédula o documento de identidad. Ej: “4321987”.
email	string	No	100	Correo electrónico del representante legal. Ej: “juan.perez@examplecom”.
whatsapp	objeto	No	-	Objeto con el código de verificación y el número de WhatsApp del representante legal.
codigo	string	Sí	6	Código de verificación del representante legal. (ver Solicitar codigo)
numero	string	Sí	15	Número de WhatsApp del representante legal.
fecha_nacimiento	date	No	-	Fecha de nacimiento 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": "201",
  "message": "Recurso creado 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.