<aside> ❗ Importante: con fecha 2024-06-28 se movió la funcionalidad de subir archivos a un nuevo endpoint Subir archivo a un Deal . Este endpoint “Editar Deal” ahora recibe únicamente un body JSON con los fields dentro de una llave fields.

</aside>

Descripción

Endpoint que permite editar el contenido de uno o varios campos de un deal. Para el formato y contenido de los campos aplica el mismo estándar y restricciones que en el endpoint Crear Deal.

Este endpoint acepta body únicamente en formato application/json y no acepta la subida de archivos. Si se quieren subir archivos debe utilizarse el endpoint Subir archivo a un Deal.

A través de este endpoint no se puede modificar el status de un deal, para eso es necesario ejecutar una transición según el endpoint Ejecutar transición para un Deal.

Ruta

crm/integration-generic/deals/:dealId

Método

PATCH

Autorización

Este endpoint requiere autorización según se indica en Authorization

Parámetros de entrada (path params)

Nombre del dato Tipo Dato Descripción Requerido
dealId string
(numeric string) Id del deal que se quiere editar

Parámetros de entrada (application/json)

Nombre del dato Tipo Dato Descripción Requerido
assignee string (UUID) UUID de usuario al que se le asignará el deal. La lista de usuarios válidos se puede obtener de ‣. No
fields `{
[key: string]:
string |
number |
field

}` | Cada una de las variables del deal que se quiere rellenar.

Ejemplo objeto de entrada

Se muestra a continuación un ejemplo de body de entrada para un tablero que tiene, al menos, las variables internal_id, package_code.

{
  "assignee": "fh5k39d5-m62b-xxxx-xxxx-xxxxxxxxxxxx",
	"fields": {
		"internal_id": 843,
		"package_code": "A49271-2"
	}
}

Parámetros de salida (data)

Nombre del dato Tipo Dato Descripción
id Integer Id del deal que fue editado
updatedAt date Fecha de edición del deal en UTC+0.