CRM
Vincular un documento a una oportunidad
Vincula a la oportunidad el presupuesto, el pedido o el proyecto que salió de ella.
crm:writeResultado
generado desde el esquema
Con kind: "quote" e isPrimary: true, ese presupuesto pasa a ser el principal y los demás se degradan. meta. distingue un vínculo nuevo de uno que ya existía, que es lo que necesita saber un reintento. Devuelve la oportunidad completa, la misma proyección que su GET. El vínculo en sí —kind, linkedEntityId, created— va en meta.
Argumentos
Identificador de la oportunidad.
Límites: longitud mín. 1
Lo que está vinculado a la oportunidad.
Opciones disponibles: quote, order, project
Presupuesto. Obligatorio con kind="quote".
Pedido. Obligatorio con kind="order".
Proyecto. Obligatorio con kind="project".
Solo con kind="quote": marca este presupuesto como el principal.
Clave de idempotencia elegida por el cliente (se recomienda un UUID). Repetir la misma clave con los mismos argumentos en 24 h devuelve la respuesta almacenada sin volver a ejecutar; con argumentos distintos responde 422. Es la forma segura de reintentar tras un fallo de red.
Límites: longitud mín. 1, longitud máx. 255
Bloqueo optimista: el meta.etag que obtuviste de la lectura de detalle de este recurso (o "*"). Si el recurso ha cambiado desde entonces, la llamada falla con 412 precondition_failed antes de escribir nada; léelo de nuevo y reintenta. Omítelo para escribir sin condiciones.
Límites: longitud mín. 1
Resultado
En un éxito el resultado lleva structuredContent con data y meta. Estos son los atributos de data.
Ver los atributos de data
Opciones disponibles: open, won, lost
Opciones disponibles: open, won, lost
Opciones disponibles: inbound_email, website_form, referral, cold_outreach, event, social, existing_customer, partner, other
Límites: mín. 1
Mostrar atributos hijosOcultar atributos hijos
Un error es un resultado con isError: true y el problema en content[0].; no hay structuredContent. Consulta Errores.
La misma operación por REST
Esta herramienta ejecuta POST /api/v1/crm/opportunities/{opportunityId}/links.
Páginas relacionadas
Enlace a esta sección: Páginas relacionadasCRM
Vincular un documento a una oportunidad
Vincula a la oportunidad el presupuesto, el pedido o el proyecto que salió de ella.
Guías
Escrituras seguras
Un asistente que puede escribir también puede escribir lo equivocado. Decide qué herramientas necesitan a una persona, reintenta sin duplicar y sabe qué pone en marcha una escritura.
Guías
Errores
Un error de herramienta es un resultado con
isError: truey el problema en el primer bloque de texto. Ramifica por sucode.
¿Te ha resultado útil esta página?