erp Centro de Ayuda

API Endpoint: Ventas Cotizaciones

Listar Cotizaciones

URL: /ventasCotizaciones.list.json
Método: GET
Descripción: Obtiene una lista de todas las cotizaciones de ventas emitidas por la empresa.

Parámetros (opcional):

• Ninguno.

Listar Items de Cotizaciones

• URL: /ventasCotizaciones.listItems.json
• Método: GET
• Descripción: Obtiene una lista de todos los ítems de las cotizaciones de ventas.
• Parámetros (opcional):
  • Ninguno.

Obtener Último Folio Emitido

• URL: /ventasCotizaciones.listLast.json
• Método: GET
• Descripción: Devuelve el último folio emitido en Obuma para un tipo de documento específico.
• Parámetros (opcional):
  • Ninguno.

Obtener Cotización por ID

• URL: /ventasCotizaciones.findById.json/{RecursoId}
• Método: GET
• Descripción: Devuelve una cotización específica basada en el ID proporcionado.
• Parámetros:
  • RecursoId: ID de la cotización (incluido en la URL).

Crear Cotización

• URL: /ventasCotizaciones.create.json
• Método: POST
• Descripción: Crea una nueva cotización de ventas en el sistema.
• Parámetros (JSON Body):
  • cliente_rut: RUT del cliente.
  • cliente_razon_social: Razón social del cliente.
  • cliente_giro: Giro comercial del cliente.
  • cliente_direccion: Dirección de facturación del cliente.
  • cliente_comuna: Comuna de facturación del cliente.
  • cliente_region: Región de facturación del cliente.
  • cliente_email: Email del cliente.
  • cliente_telefono: Teléfono del cliente.
  • cliente_contacto: Contacto del cliente.
  • cliente_actualizar_datos: Indica si se deben actualizar los datos del cliente (1 = Sí, 0 = No).
  • cotizacion_fecha: Fecha de la cotización (formato yyyy-mm-dd).
  • cotizacion_fecha_vencimiento: Fecha de vencimiento de la cotización (formato yyyy-mm-dd).
  • cotizacion_sucursal: Código de la sucursal.
  • cotizacion_usuario: Código del usuario.
  • cotizacion_lista_precio: Código de la lista de precios.
  • cotizacion_canal: Código del canal de venta.
  • cotizacion_direccion: Dirección de facturación.
  • cotizacion_direccion_id: ID de la dirección de facturación.
  • cotizacion_direccion_despacho: Dirección de despacho.
  • cotizacion_direccion_despacho_id: ID de la dirección de despacho.
  • cotizacion_contacto: Contacto de la cotización.
  • cotizacion_forma_pago: Código de la forma de pago.
  • cotizacion_enviar_email_cliente: Indica si se debe enviar la cotización por email al cliente (1 = Sí, 0 = No).
  • cotizacion_enviar_emails: Lista de emails a los cuales enviar la cotización, separados por ;.
  • cotizacion_total: Total de la cotización.
  • cotizacion_exento: Indica si la cotización es exenta (1 = Sí, 0 = No).
  • cotizacion_subtotal: Subtotal de la cotización.
  • cotizacion_descuento_pesos: Descuento en pesos aplicado a la cotización.
  • cotizacion_descuento_porciento: Descuento en porcentaje aplicado a la cotización.
  • cotizacion_neto: Total neto de la cotización.
  • cotizacion_iva: IVA aplicado a la cotización.
  • cotizacion_condiciones: Condiciones de la cotización.
  • cotizacion_observacion: Observaciones adicionales de la cotización.
  • cotizacion_referencia: Referencia de la cotización.
  • cotizacion_internacional: Indica si la cotización es internacional (1 = Sí, 0 = No).
  • cotizacion_moneda: Moneda en que se realiza la cotización (CLP, USD, EUR, etc.).
  • cotizacion_perfil_fantasia: Indica si se usa un perfil de fantasía (1 = Sí, 0 = No).
  • cotizacion_detalle: Array de detalles de la cotización, incluyendo:
    • producto_nombre: Nombre del producto.
    • producto_descripcion: Descripción del producto.
    • producto_exento: Indica si el producto es exento (1 = Sí, 0 = No).
    • codigo_comercial: Código comercial del producto.
    • unidad_medida: Unidad de medida del producto.
    • cantidad: Cantidad del producto.
    • producto_precio: Precio del producto.
    • descuento: Descuento aplicado al producto.
    • descuento_monto: Monto del descuento aplicado al producto.
    • subtotal: Subtotal del producto.
    • ia_codigo: Código de impuestos adicionales aplicables.
    • ia_tasa: Tasa de impuestos adicionales aplicables.
    • ia_monto: Monto de impuestos adicionales aplicables.

Actualizar Cotización

• URL: /ventasCotizaciones.update.json
• Método: POST
• Descripción: Actualiza una cotización de ventas existente en el sistema.
• Parámetros (JSON Body):
  • cotizacion_id: ID de la cotización a actualizar.
  • cliente_rut: RUT del cliente.
  • cliente_razon_social: Razón social del cliente.
  • cliente_giro: Giro comercial del cliente.
  • cliente_direccion: Dirección de facturación del cliente.
  • cliente_comuna: Comuna de facturación del cliente.
  • cliente_region: Región de facturación del cliente.
  • cliente_email: Email del cliente.
  • cliente_telefono: Teléfono del cliente.
  • cliente_contacto: Contacto del cliente.
  • cliente_actualizar_datos: Indica si se deben actualizar los datos del cliente (1 = Sí, 0 = No).
  • cotizacion_fecha: Fecha de la cotización (formato yyyy-mm-dd).
  • cotizacion_fecha_vencimiento: Fecha de vencimiento de la cotización (formato yyyy-mm-dd).
  • cotizacion_sucursal: Código de la sucursal.
  • cotizacion_usuario: Código del usuario.
  • cotizacion_lista_precio: Código de la lista de precios.
  • cotizacion_canal: Código del canal de venta.
  • cotizacion_direccion: Dirección de facturación.
  • cotizacion_direccion_id: ID de la dirección de facturación.
  • cotizacion_direccion_despacho: Dirección de despacho.
  • cotizacion_direccion_despacho_id: ID de la dirección de despacho.
  • cotizacion_contacto: Contacto de la cotización.
  • cotizacion_forma_pago: Código de la forma de pago.
  • cotizacion_enviar_email_cliente: Indica si se debe enviar la cotización por email al cliente (1 = Sí, 0 = No).
  • cotizacion_enviar_emails: Lista de emails a los cuales enviar la cotización, separados por ;.
  • cotizacion_total: Total de la cotización.
  • cotizacion_exento: Indica si la cotización es exenta (1 = Sí, 0 = No).
  • cotizacion_subtotal: Subtotal de la cotización.
  • cotizacion_descuento_pesos: Descuento en pesos aplicado a la cotización.
  • cotizacion_descuento_porciento: Descuento en porcentaje aplicado a la cotización.
  • cotizacion_neto: Total neto de la cotización.
  • cotizacion_iva: IVA aplicado a la cotización.
  • cotizacion_condiciones: Condiciones de la cotización.
  • cotizacion_observacion: Observaciones adicionales de la cotización.
  • cotizacion_referencia: Referencia de la cotización.
  • cotizacion_internacional: Indica si la cotización es internacional (1 = Sí, 0 = No).
  • cotizacion_moneda: Moneda en que se realiza la cotización (CLP, USD, EUR, etc.).
  • cotizacion_perfil_fantasia: Indica si se usa un perfil de fantasía (1 = Sí, 0 = No).
  • cotizacion_detalle: Array de detalles de la cotización, incluyendo:
    • producto_nombre: Nombre del producto.
    • producto_descripcion: Descripción del producto.
    • producto_exento: Indica si el producto es exento (1 = Sí, 0 = No).
    • codigo_comercial: Código comercial del producto.
    • unidad_medida: Unidad de medida del producto.
    • cantidad: Cantidad del producto.
    • producto_precio: Precio del producto.
    • descuento: Descuento aplicado al producto.
    • descuento_monto: Monto del descuento aplicado al producto.
    • subtotal: Subtotal del producto.
    • ia_codigo: Código de impuestos adicionales aplicables.
    • ia_tasa: Tasa de impuestos adicionales aplicables.
    • ia_monto: Monto de impuestos adicionales aplicables.

Eliminar Cotización

• URL: /ventasCotizaciones.delete.json
• Método: POST
• Descripción: Función no disponible por el momento.
• Parámetros (opcional):
  • Ninguno.

Enviar Cotización por Email

• URL: /ventasCotizaciones.sendEmail.json/{RecursoId}
• Método: POST
• Descripción: Envía la cotización al cliente vía email.
• Parámetros:
  • RecursoId: ID de la cotización a enviar por email (incluido en la URL).

Actualizar Estado de Cotización

• URL: /ventasCotizaciones.updateEstado.json
• Método: POST
• Descripción: Actualiza el estado de una cotización existente.
• Parámetros (JSON Body):
  • cotizacion_id: ID de la cotización a actualizar.
  • estado: Nuevo estado de la cotización.