Editar usuario con empresa

Este endpoint permite actualizar los datos de una empresa previamente registrado en el sistema Guarani App, la solicitud debe realizarse mediante el método PUT, incluyendo el ID de la empresa como parámetro de ruta.

---

Entorno

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

Endpoint

PUT /empresas/{id}

Para editar la empresa es necesario primero solicitar un código de verificación para el representante legal vía WhatsApp. Este proceso de verificación es obligatorio y debe completarse antes de proceder con el registro de la empresa.

Paso previo obligatorio: Antes de editar la empresa, 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 solicitar codigo). OBS: El codigo solo es valido por 5 minutos.

Ejemplo de solicitud

curl -X PUT "https://api.guarani.app/empresas/{id}" \
  -H "x-api-key: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "empresa": {
      "ruc": "12345678-9",
      "nombre": "NOMBRE DE EJEMPLO",
      "nombre_fantasia": "NOMBRE DE EJEMPLO",
      "fecha_constitucion": "11/09/2025"
    },
    "representantes_legales": [
      {
        "cedula": "12345678",
        "nombres": "NOMBRES DE EJEMPLO",
        "apellidos": "APELLIDOS DE EJEMPLO",
        "email": "[email protected]",
        "whatsapp": {
          "numero": "+595981234567",
          "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: Asegurate de reemplazar {id} con el identificador único de la empresa 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 de la empresa para actualizar sus datos. (ver empresas)

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.
Accept	application/json	Indica que la respuesta debe devolverse en formato JSON.

Descripción de Campos

empresa (objeto)

Campo	Tipo	Requerido	Tamaño	Descripción
ruc	string	Sí	11	Número de RUC de la empresa.
nombre	string	Sí	255	Nombre legal de la empresa.
nombre_fantasia	string	No	255	Nombre fantasia de la empresa.
fecha_constitucion	date	Sí	-	Fecha de constitución (formato DD/MM/YYYY).

representantes_legales (array)

Campo	Tipo	Requerido	Tamaño	Descripción
cedula	string	Sí	11	Número de cédula del representante legal.
nombres	string	Sí	100	Nombres del representante legal.
apellidos	string	Sí	100	Apellidos del representante legal.
fecha_nacimiento	date	Sí	-	Fecha de nacimiento (formato DD/MM/YYYY).
email	string	Sí	100	Correo electrónico del representante legal.
whatsapp	objeto	No	-	Objeto con el código de verificación y el número de WhatsApp del representante legal.

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 del numero de WhatsApp. (ver Solicitar codigo)

Ejemplo de respuesta

{
  "success": true,
  "codigo": "200",
  "message": "Recurso actualizado con éxito.",
  "data": {
    "empresa": {
      "id": "869943e3-7995-4eb6-9327-9868e0a93117",
      "nombre": "NOMBRE DE EJEMPLO",
      "nombre_fantasia": "NOMBRE DE EJEMPLO",
      "ruc": "12345678-9",
      "fecha_constitucion": "11/09/2025",
      "tipo_persona": 2
    },
    "representantes_legales": [
      {
        "id": "b8ab12ca-a33f-4edd-a345-c752c83c0849",
        "cedula": "12345678",
        "nombres": "NOMBRES DE EJEMPLO",
        "apellidos": "APELLIDOS DE EJEMPLO",
        "email": "[email protected]",
        "whatsapp": "+595981234567",
        "fecha_nacimiento": "11/09/2025"
      }
    ]
  }
}

Descripción de Campos de Respuesta

Campos principales

Campo	Tipo	Descripción
empresa	objeto	Contiene la información completa de la empresa actualizada.
representantes_legales	array	Lista de representantes legales asociados a la empresa.

Campos de empresa

Campo	Tipo	Descripción
id	uuid	Identificador único de la empresa.
nombre	string	Nombre legal de la empresa.
nombre_fantasia	string	Nombre comercial o fantasía de la empresa.
ruc	string	Número de RUC de la empresa.
fecha_constitucion	string	Fecha de constitución de la empresa en formato DD/MM/YYYY.
tipo_persona	number	Tipo de persona. 2 = Persona Jurídica.

Campos de representantes_legales

Campo	Tipo	Descripción
id	uuid	Identificador único del representante legal.
cedula	string	Número de cédula del representante legal.
nombres	string	Nombres del representante legal.
apellidos	string	Apellidos del representante legal.
email	string	Correo electrónico del representante legal.
whatsapp	string	Número de WhatsApp del representante legal.
fecha_nacimiento	string	Fecha de nacimiento en formato DD/MM/YYYY.

Recursos adicionales

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