Envía una cotización al nuevo sistema

Tu primer envío, paso a paso

1. Usa la URL del ambiente donde estás trabajando: DEV, QA o Producción.
2. Agrega el token de integración en el header X-Integration-Token.
3. Envía un POST con JSON a /api/v1/integraciones/cotizaciones.
4. Guarda la respuesta. Allí vendrán el id y el numero de la cotización creada.

Content-Type: application/json
X-Integration-Token: <TOKEN_DEL_AMBIENTE>

JSON mínimo funcional

Este ejemplo crea una cotización con pago pendiente y una línea reservada desde bodega. Reemplaza los valores de ejemplo por los de tu sistema.

{
  "versionContrato": "1.0",
  "idSolicitud": "8f7d55a2-4a5a-4c16-9c7a-eec9dbfaa1a0",
  "claveIdempotencia": "3c3b33af-529c-4a45-a662-89c617683ac2",
  "fechaHoraEnvio": "2026-07-28T10:30:00-04:00",
  "origen": {
    "software": { "identificador": "ERP", "nombre": "Mi ERP", "version": "1.0", "ambiente": "DEV" },
    "evento": "FORMALIZAR_COTIZACION",
    "fechaHoraEvento": "2026-07-28T10:29:00-04:00",
    "usuario": { "idUsuarioOrigen": "15", "nombreUsuario": "maria", "nombreCompleto": "María Pérez", "correo": "maria@empresa.cl" }
  },
  "destino": { "codigoEmpresa": "REVESTIMIENTOS-CHILE", "codigoOrganizacion": "RC-SCL" },
  "cotizacion": {
    "idCotizacionOrigen": "COT-1042",
    "fechaHoraFormalizacion": "2026-07-28T10:29:00-04:00",
    "clienteCotizacion": { "rut": "76.123.456-7", "nombreORazonSocial": "Constructora Ejemplo SpA" },
    "lineas": [{
      "numeroLinea": 1,
      "producto": { "sku": "PORC-90X90-GRIS", "nombre": "Porcelanato gris 90x90", "unidadMedida": "M2" },
      "cantidad": 10, "precioUnitarioNeto": 10000, "montoNeto": 100000, "montoIva": 19000, "montoTotal": 119000,
      "asignacionesStock": [{ "secuencia": 1, "tipoStock": "FISICO", "cantidad": 10, "bodega": { "codigo": "SCL-01", "nombre": "Bodega Santiago" } }]
    }],
    "totales": { "montoNeto": 100000, "montoIva": 19000, "montoTotal": 119000, "montoPagado": 0, "saldo": 119000 },
    "estadoPago": "PAGO_PENDIENTE",
    "pagos": []
  }
}

Para una cotización pagada, usa estadoPago: "PAGADO", deja saldo en 0, informa el total en montoPagado y agrega al menos un elemento en pagos.

Antes de enviar: cinco reglas simples

1. No repitas una clave de idempotencia para otra cotización. Un GUID funciona bien.
2. Los totales deben cuadrar: neto + IVA = total, tanto en cada línea como en la cotización.
3. La suma de pagos debe coincidir con montoPagado. Si no hay pagos, envía "pagos": [].
4. Cada línea debe indicar su stock: FISICO con bodega o EN_CAMINO con número de envío.
5. Una cotización PAGADA debe tener saldo cero. Si está pendiente, después un aprobador de pago decidirá si se habilita para facturar.

Mapa completo del contrato

Usa el índice lateral para llegar al objeto que necesitas y abre su bloque para consultar todos sus campos. Cada sección explica qué representa el objeto, sus tipos de datos y sus reglas; el JSON mínimo anterior muestra cómo se combinan en una solicitud real.

Obligatorio significa que la API lo exige; Condicional, que depende de otro valor; Opcional, que puedes omitir.

Consulta esta sección antes de actualizar tu integración. Aquí se resumen los cambios que pueden afectar el JSON enviado, sus validaciones o la interpretación de una respuesta.

1. v1.0 28 de julio de 2026 Vigente

   Primera versión documentada

   • Define la solicitud de cotización formalizada, sus clientes, líneas, totales, pagos, observaciones y stock asignado.
   • Establece idempotencia mediante claveIdempotencia y trazabilidad mediante los identificadores del sistema de origen.
   • Exige declarar una versión de contrato soportada; una versión desconocida responde HTTP 422.
   • Documenta los estados de pago, las validaciones monetarias y las reglas para stock físico o en camino.

Qué significa cada respuesta