PATCH/api/mod/ventas/{espacio}/leads/{lead}

Mueve un lead en el embudo

Cambia el estado comercial de un lead cuando tu equipo lo contacta, lo gana o lo da por cerrado.

PARÁMETROS

CAMPO	TIPO	REQUERIDO	QUÉ ES
espacio	string	SÍ	El id del espacio (sale en GET /api/companies). Tiene que tener el módulo Ventas.
lead	string	SÍ	El id del lead (32 caracteres hexadecimales): sale en la lista de leads y en lead_id al conversar.

CAMPO	TIPO	REQUERIDO	QUÉ ES
estado	"nuevo" \| "contactado" \| "ganado" \| "cerrado"	SÍ	El estado nuevo.

El lead, ya con su estado nuevo.

CAMPO	TIPO	QUÉ ES
id	string	El id del lead.
estado	"nuevo" \| "contactado" \| "ganado" \| "cerrado"	Dónde está en tu embudo: ver leads.
producto_interes	string \| null	Lo que quería comprar.
contacto_masked	string \| null	Qué datos dejó, seudonimizados: `nombre=<PERSON>; telefono=<PHONE>`. El contacto nunca sale en claro. null si no dio consentimiento.
cotizaciones_emitidas	integer	Cuántas cotizaciones recibió.
consent · consent_ts	boolean · number \| null	Si autorizó el seguimiento comercial, y cuándo (segundos desde 1970).
created_at · updated_at	number	Segundos desde 1970, con decimales.
tenant_id	string	El espacio.

STATUS	CUÁNDO	DETAIL LITERAL
403	El espacio no tiene el módulo Ventas	módulo no habilitado para este espacio.
403	La clave es de solo lectura	Tu cuenta es de solo lectura en este espacio.
400	estado no es nuevo, contactado, ganado ni cerrado	estado inválido: ['cerrado', 'contactado', 'ganado', 'nuevo']
404	No hay un lead con ese id en el espacio	Lead no encontrado: …
422	Falta un campo obligatorio o uno no es de su tipo (detail es una lista)	—

Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.

Ventas pone ganado por su cuenta cuando se confirma el pago del pedido de ese cliente.