Skip to main content

​
Alcance

Este dominio cubre el ciclo comercial antes de billing. Incluye:
  • cotizaciones
  • pipeline comercial
  • catalogo de dispositivos cotizables
  • catalogos comerciales auxiliares
  • ventas de equipamiento
  • envios y shipment orders
  • funciones de IA y outreach
  • Cotizaciones
  • Pipeline
  • Dispositivos cotizables
  • IA de cotizaciones
  • Outreach IA
  • Equipment Sales
  • Shipments
  • Catalogos comerciales

​
Quotes

Endpoints principales:
  • POST /api/v1/quotes
  • GET /api/v1/quotes
  • GET /api/v1/quotes/{id}
  • PATCH /api/v1/quotes/{id}
  • DELETE /api/v1/quotes/{id}
  • DELETE /api/v1/quotes/batch/cancel
  • POST /api/v1/quotes/calculate
  • POST /api/v1/quotes/{id}/clone
  • POST /api/v1/quotes/{id}/duplicate
  • POST /api/v1/quotes/{id}/pdf
  • GET /api/v1/quotes/{id}/pdf
  • GET /api/v1/quotes/{id}/activities
  • POST /api/v1/quotes/{id}/send-email
  • GET /api/v1/quotes/{id}/email-template
Usalo para:
  • crear una cotizacion
  • recalcular montos
  • revisar detalle y actividades
  • clonar o duplicar propuestas
  • generar PDF y enviar por correo

​
Pipeline comercial

Endpoints principales:
  • GET /api/v1/quotes/pipeline-stages
  • GET /api/v1/quotes/kanban
  • PATCH /api/v1/quotes/{id}/pipeline-stage
  • GET /api/v1/pipeline-stages
  • POST /api/v1/pipeline-stages
  • GET /api/v1/pipeline-stages/{id}
  • PATCH /api/v1/pipeline-stages/{id}
  • DELETE /api/v1/pipeline-stages/{id}
  • PATCH /api/v1/pipeline-stages/reorder
Usalo para:
  • operar embudo comercial
  • mover oportunidades entre etapas
  • administrar etapas disponibles
  • ordenar pipeline para vistas Kanban

​
Quoter devices

Endpoints principales:
  • GET /api/v1/quoter/devices
  • POST /api/v1/quoter/devices
  • GET /api/v1/quoter/devices/{id}
  • PATCH /api/v1/quoter/devices/{id}
  • DELETE /api/v1/quoter/devices/{id}
  • GET /api/v1/quoter/devices/{id}/accessories
  • POST /api/v1/quoter/devices/{id}/upload
  • DELETE /api/v1/quoter/devices/{id}/file
Usalo para:
  • administrar dispositivos cotizables
  • cargar fichas o archivos
  • consultar accesorios relacionados

​
IA para cotizaciones

Endpoints principales:
  • POST /api/quotes/ai/generate
  • POST /api/quotes/ai/regenerate-section
  • GET /api/quotes/ai/{quoteId}
  • PUT /api/quotes/ai/{quoteId}
  • POST /api/quotes/ai/mark-accepted
El correo que acompaña una cotización se redacta desde la pantalla de la cotización con «Generar con IA»; no hay un endpoint de generación de correo para integraciones. Usalo para:
  • generar contenido de cotizacion
  • regenerar secciones
  • actualizar texto comercial

​
Outreach IA sobre cotizaciones

Endpoints principales:
  • POST /api/quotes/{quoteId}/outreach
  • GET /api/quotes/{quoteId}/outreach
  • GET /api/quotes/{quoteId}/outreach/intelligence
  • GET /api/quotes/{quoteId}/outreach/effectiveness
  • GET /api/quotes/{quoteId}/outreach/{sequenceId}
  • PATCH /api/quotes/{quoteId}/outreach/{sequenceId}
  • POST /api/quotes/{quoteId}/outreach/{sequenceId}/messages/generate
  • GET /api/quotes/{quoteId}/outreach/{sequenceId}/messages
  • PATCH /api/quotes/{quoteId}/outreach/messages/{messageId}
  • POST /api/quotes/{quoteId}/outreach/messages/{messageId}/approve
  • POST /api/quotes/{quoteId}/outreach/messages/{messageId}/send
  • POST /api/quotes/{quoteId}/outreach/messages/{messageId}/regenerate
  • POST /api/quotes/{quoteId}/outreach/probability
  • POST /api/quotes/{quoteId}/outreach/messages/{messageId}/success
Usalo para:
  • automatizar seguimiento comercial
  • generar secuencias y mensajes
  • medir efectividad
  • aprobar y enviar outreach

​
Equipment sales

Endpoints principales:
  • GET /api/v1/equipment-sales
  • POST /api/v1/equipment-sales
  • GET /api/v1/equipment-sales/{id}
  • PUT /api/v1/equipment-sales/{id}
  • DELETE /api/v1/equipment-sales/{id}
Usalo para:
  • registrar ventas de equipamiento
  • relacionarlas con cliente, suscripcion o visita
  • mantener trazabilidad de montos y modalidad de pago

​
Shipments y shipment orders

Endpoints principales:
  • POST /api/v1/shipments/quote
  • POST /api/v1/shipment-orders
  • GET /api/v1/shipment-orders
  • GET /api/v1/shipment-orders/stats
  • GET /api/v1/shipment-orders/by-ticket/{ticketId}
  • GET /api/v1/shipment-orders/{id}
  • PATCH /api/v1/shipment-orders/{id}/status
  • PATCH /api/v1/shipment-orders/{id}/cancel
Usalo para:
  • cotizar despacho o logistica asociada a la venta
  • operar ordenes reales de despacho postventa o postcierre

​
Catalogos comerciales

Endpoints principales:
  • GET /api/v1/sellers/all
  • POST /api/v1/sellers/create
  • PUT /api/v1/sellers/update/{id}
  • GET /api/v1/currency/all
  • POST /api/v1/currency/create
  • GET /api/v1/plans
  • POST /api/v1/plans
  • GET /api/v1/plans/categories
  • GET /api/v1/plan-categories
  • POST /api/v1/plan-categories
  • GET /api/v1/accessory/all
  • GET /api/v1/accessory/compatible/{gpsId}
  • POST /api/v1/accessory/create
  • GET /api/product-knowledge
  • POST /api/product-knowledge
  • PUT /api/product-knowledge/{id}
Usalo para:
  • mantener vendedores y parametros del equipo comercial
  • definir moneda, planes y categorias previas a una propuesta
  • enriquecer catalogos con accesorios y knowledge reutilizable

​
Flujo recomendado

  1. Definir catalogos comerciales, dispositivos y knowledge reusable.
  2. Crear cotizacion.
  3. Calcular montos y validar pipeline.
  4. Generar PDF o email.
  5. Ejecutar outreach si la oportunidad lo requiere.
  6. Registrar venta de equipamiento y despacho si la cotizacion se concreta.

​
Recomendaciones

  • Usa quotes como registro principal de oportunidad.
  • Usa pipeline stages para el estado comercial y no mezcles ese estado con billing.
  • Usa equipment sales solo cuando la venta ya exista como hecho comercial.
  • Separa claramente IA de contenido comercial y envio real al cliente.
  • Usa shipment-orders para la operacion real del despacho y shipments/quote solo para estimacion.