> ## Documentation Index
> Fetch the complete documentation index at: https://tech.sedierp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Registro de leads (precontactos) 

> API para el registro de precontactos en el CRM

Este documento describe la especificación del Web Service para el registro de contactos.

El servicio permite a los usuarios enviar datos de contacto siguiendo una estructura definida en formato JSON. El método de solicitud es POST y se requiere un encabezado "Authorization" para la autenticación, que debe contener un token JWT obtenido previamente del servicio de [autenticación](https://tech.sedierp.com/quickstart.md).

## Prerequisitos

Antes de realizar el registro de una factura de compra, se debe contar con los siguientes datos:

* Token solicitado mediante el API de [autenticación](https://tech.sedierp.com/quickstart.md)

## Como generar el token JWT

**Request URL:** https\://\{\{Ambiente}}/API\_CRM/api/Inmuebles/ContactoGuardar\
**Tipo:** POST \
**Content Type:** application/json

**OrigenPrecontactoID** `int` *required*

Código del pre contacto se obtiene a través del origen puesto anteriormente.

**FormaContactoID** `int` *required*

Código de la forma de contacto se obtiene del listado de [formas de contacto](https://tech.sedierp.com/formas-de-contacto.md).

**FormaComoNosConocioID** `int` *required*

Código de la forma como nos conoció, se obtiene del listado de [formas como nos conocio](https://tech.sedierp.com/formas-como-conocio-la-empresa.md).

**FormaComoNosConocioDetalleID** `int`

Código del detalle de la forma como nos conoció, se obtiene del listado de [detalles de formas como nos conocio](https://tech.sedierp.com/detalles-de-formas-como-conocio-la-empresa.md).

**Fecha** `Date`

Fecha en la que se registra el precontacto

**Documento** `string` *required*

Documento de la persona que será el contacto, número sin puntos, sin comas y sin espacios.

**Nombres** `string` *required*

Nombres de la persona del contacto.

**Apellidos** `string` *required*

Apellidos de la persona del contacto.

**Telefono** `string`

Número telefónico del contacto.

**Celular** `string` *required*

Número celular del contacto.

**NumeroInmueble** `int` *required*

El consecutivo del inmueble.

**EmailAsesor** `string`

Email del asesor al que se le asigna el contacto.

**Observaciones** `string`

Observaciones que describe el contacto.

**Email** `string`

Email de la persona de contacto.

**Direccion** `string`

Dirección de la persona que hizo el contacto.

**AreaDesde** `int`

Área mínima que tiene el inmueble, tipo numérico.

**AreaHasta** `int`

Área máxima que tiene el inmueble de tipo numérico.

**PresupuestoDesde** `float`

Presupuesto mínimo del inmueble de tipo numérico.

**PresupuestoHasta** `float`

Presupuesto máximo del inmueble de tipo numérico.

**Cantidadhabitaciones** `int`

Cantidad de habitaciones del inmueble, tipo numérico.

**CantidadGarajes** `int`

Cantidad de garajes del inmueble tipo numérico.

**CantidadBanos** `int`

Cantidad de baños del inmueble, tipo numérico.

**DescripcionAdicional** `string`

Descripción adicional del contacto realizado.

**InmuebleDireccion** `string`

Dirección donde se encuentra ubicado el inmueble.

**FechaInicioActividad** `DateTime`

Fecha en la que se inicia la actividad de contacto.

**FechaVencimientoActividad** `DateTime`

Fecha en la que se vence o termina la actividad.

**TipoInmuebleID** `int` *required*

Código del tipo de inmueble, las opciones se pueden validar directamente desde la lista de [tipos de inmuebles](https://tech.sedierp.com/tipos-de-inmuebles.md).

**Actividades programadas para el lead (Actividades)**

**Asunto** `string`

Descripción basica (titulo) de la actividad EJ: "Llamada comercial"

**FechaInicio** `DateTime` *required*

Fecha de inicio de la actividad

**FechaVencimiento** `DateTime` *required*

Fecha de finalización de la actividad

**Descripcion** `string`

Descripcion detallada de la actividad

**Direccion** `string`

Dirección donde se va a realizar la actividad programada

**Telefono** `string`

Telefono mediante el cual se va a realizar la llamada de la actividad

**Celular** `string`

Celular mediante el cual se va a realizar la llamada de la actividad

**Email** `string`

Email en el cual se va a registrar la actividad

**Link** `string`

Link del meet o plataforma de reuniones en la cual se va a realizar la reunión

```json Request theme={null}
{
  "UniqueID": "88c42136-e456-4142-8350-17839ccc6bff",
  "OrigenPrecontactoID": 1,
  "FormaContactoID": 1,
  "FormaComoNosConocioID": 1,
  "FormaComoNosConocioDetalleID": 1,
  "Fecha": "2026-11-03T16:09:50.3543876-05:00",
  "Documento": "sample string 1",
  "Nombres": "sample string 2",
  "Apellidos": "sample string 3",
  "Telefono": "sample string 4",
  "Celular": "sample string 5",
  "NumeroInmueble": 1,
  "EmailAsesor": "sample string 6",
  "Observaciones": "sample string 7",
  "Email": "sample string 8",
  "Direccion": "sample string 9",
  "AreaDesde": 1,
  "AreaHasta": 1,
  "PresupuestoDesde": 1,
  "PresupuestoHasta": 1,
  "Cantidadhabitaciones": 1,
  "CantidadGarajes": 1,
  "CantidadBanos": 1,
  "DescripcionAdicional": "sample string 10",
  "InmuebleDireccion": "sample string 11",
  "Actividad": {
    "Asunto": "sample string 1",
    "FechaInicio": "2026-11-03T16:09:50.3543876-05:00",
    "FechaVencimiento": "2026-11-03T16:09:50.3543876-05:00",
    "Descripcion": "sample string 2",
    "Direccion": "sample string 3",
    "Telefono": "sample string 4",
    "Celular": "sample string 5",
    "Email": "sample string 6",
    "Link": "sample string 7"
  },
  "TipoInmuebleID": 1
}
```

```json Response theme={null}
{
  "PreContactoID": 1250,
  "OrigenPreContactoID": 5,
  "Documento": "1020304050",
  "Nombres": "Carlos",
  "Apellidos": "Ramirez",
  "NombreCompleto": "Carlos Ramirez",
  "Telefono": "6011234567",
  "Celular": "3001234567",
  "UsuarioWhatsApp": null,
  "Email": "carlos@email.com",
  "Direccion": "Calle 100 # 15-20",
  "Observaciones": "Interesado en adquirir un inmueble",
  "SucursalID": 1,
  "ProcesoID": 2500,
  "AsesorID": 15,
  "FormaContactoID": 1,
  "FormaComoNosConocioID": 2,
  "FormaComoNosConocioDetalleID": null,
  "EstadoProcesoID": 1,
  "EstadoLineaTiempoID": 1,
  "Fecha": "2026-11-03T16:00:00",
  "UniqueID": "a1b2c3d4-e5f6-4789-8123-123456789abc",
  "OrigenPreContactoNombre": "VENTAS DE GBI",
  "FormaContactoNombre": "WhatsApp",
  "FormaComoNosConocioNombre": "Redes sociales",
  "FormaComoNosConocioDetalleNombre": null,
  "EstadoProcesoNombre": "Abierto",
  "EstadoLineaTiempoNombre": "Nuevo",
  "AsesorNombreCompleto": "Juan Pérez",
  "UsuarioRegistroNombreCompleto": "Administrador",
  "IsFormatoVinculacion": false,
  "CantidadDecimales": 2,
  "FormatoVinculacion": {},
  "FormatoSeguro": {},
  "ProcesosServiciosIniciales": [],
  "Cotizaciones": [],
  "OrdenesServicios": [],
  "PreFacturas": [],
  "Facturas": [],
  "CountSeguimientos": 0,
  "CountActividades": 0
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.