Crear una empresa

Registra una nueva empresa en el sistema junto con sus representantes legales. Incluye verificación por WhatsApp y creación del establecimiento matriz.

---

Entorno

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

Endpoint

POST /empresas

Para crear 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 crear la empresa, debes solicitar un código de verificación WhatsApp de cada 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 POST "https://api.guarani.app/empresas" \
  -H "Content-Type: application/json" \
  -d '{
    "empresa": {
      "nombre": "NOMBRE DE EJEMPLO",
      "nombre_fantasia": "NOMBRE DE EJEMPLO",
      "ruc": "12345678-9",
      "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"
      }
    ],
    "establecimiento_matriz": {
      "direccion": "tu direccion",
      "barrio": "tu barrio",
      "numero_casa": "123",
      "ciudad_id": "67ef2e9f-0fa7-43e7-ad5e-87a694e56341"
    }
  }' | jq

Nota: Se debe enviar el objeto whatsapp con el número y el código de verificación. Nota: Los campos direccion, barrio, numero_casa y ciudad_id son campos para crear un establecimiento.

---

Encabezados de la Solicitud

Encabezado	Valor	Descripción
Content-Type	application/json	Indica que los datos se envían 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 comercial 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)

establecimiento_matriz (objeto)

Campo	Tipo	Requerido	Tamaño	Descripción
direccion	string	No	100	Dirección del establecimiento.
barrio	string	No	-	Barrio del establecimiento.
numero_casa	string	No	-	Número de casa del establecimiento.
ciudad_id	uuid	Sí	36	Identificador único de la ciudad.

Ejemplo de Respuesta

{
  "success": true,
  "codigo": "201",
  "message": "Recurso creado 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 creada.
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 generado por el sistema.
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 verificado.
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