Version: 1.0.11

Cotización Electrónica

Descripción General

La API de Cotizaciones Electrónicas permite la generación, gestión y seguimiento de ofertas comerciales para sus clientes. Por cada operación, obtendrá una representación impresa en PDF y la posibilidad de convertir posteriormente la cotización en un comprobante electrónico válido.

Tipos de Cotizaciones Disponibles

En esta sección encontrará endpoints para los siguientes tipos de cotizaciones:

• Cotización Estándar - Para ofertas comerciales regulares
• Cotización con Descuentos - Incluyendo promociones especiales
• Cotización por Tiempo Limitado - Con fecha de caducidad definida
• Cotización en Moneda Extranjera - Con tipo de cambio incluido
• Cotización por Etapas - Para proyectos con entregas parciales
• Cotización con Condiciones Especiales - Términos personalizados

Funcionalidades Principales

• Emisión de cotizaciones con múltiples ítems y diferentes tasas impositivas
• Soporte para descuentos a nivel de ítem y documento completo
• Cálculo automático de impuestos según normativa vigente
• Generación de representación impresa personalizable
• Historial y trazabilidad de cotizaciones emitidas
• Conversión directa a facturas, boletas u otros comprobantes electrónicos

Beneficios

• Agilización del proceso comercial de ofertas a clientes
• Presentación profesional y consistente de propuestas comerciales
• Integración con el proceso de facturación electrónica
• Seguimiento eficiente del estado de cotizaciones emitidas
• Reducción de errores en cálculos y presentación de ofertas

Autenticación

OAuth 2.0

Security Scheme Type:	oauth2
OAuth Flow (implicit):	Authorization URL: https://empresa1.demo3pro6.ibu.pe Scopes: write: Modificar cotizaciones read: Leer cotizaciones

Implementación

Para implementar la emisión de cotizaciones electrónicas en su sistema, siga estos pasos:

1. Obtener Credenciales: Solicite sus credenciales de API en el panel de administración de Pro 7
2. Validar Conexión: Utilice el endpoint de prueba para verificar la correcta configuración
3. Preparar Payload: Estructure los datos según el tipo de cotización a emitir
4. Realizar Petición: Envíe la solicitud al endpoint correspondiente
5. Procesar Respuesta: Almacene y distribuya el documento PDF generado

Estructura Base de Petición

Todas las solicitudes de cotizaciones comparten una estructura base similar:

{
  "prefix": "COT",
  "establishment_id": 1,
  "date_of_issue": "2022-02-08",
  "time_of_issue": "10:17:26",
  "customer_id": 4,
  "currency_type_id": "PEN",
  "exchange_rate_sale": 4.078,
  "total_prepayment": 0,
  "total_charge": 0,
  "total_discount": 0,
  "total_exportation": 0,
  "total_free": 0,
  "total_taxed": 29.66,
  "total_unaffected": 0,
  "total_exonerated": 0,
  "total_igv": 5.34,
  "total_taxes": 5.34,
  "total_value": 29.66,
  "total": 35,
  "subtotal": 35,
  "items": [
    {
      "item_id": 3,
      "quantity": 1,
      "unit_value": 29.66,
      "price_type_id": "01",
      "unit_price": 35,
      "total_base_igv": 29.66,
      "percentage_igv": 18,
      "total_igv": 5.34,
      "total_taxes": 5.34,
      "total_value": 29.66,
      "total": 35,
      "attributes": []
    }
  ],
  "actions": {
    "format_pdf": "a4"
  },
  "payments": [
    {
      "date_of_payment": "2022-02-08",
      "payment_method_type_id": "01",
      "payment_destination_id": "cash",
      "payment": 35
    }
  ]
}

Ejemplos por Tipo de Cotización

Cotización Estándar

La cotización estándar es el tipo más común, aplicable a la mayoría de propuestas comerciales. Para su emisión, utilice el endpoint /api/quotations con el método POST.

Cotización con Descuentos

Para aplicar descuentos en la cotización, agregue los siguientes elementos:

"discounts": [
  {
    "discount_type_id": "00",
    "description": "Descuento promocional",
    "factor": 0.10,
    "amount": 3.5
  }
]

Cotización en Moneda Extranjera

Para emitir una cotización en dólares u otra moneda extranjera:

"currency_type_id": "USD",
"exchange_rate_sale": 3.65

Funcionalidades Avanzadas

Seguimiento de Estado

Las cotizaciones pueden ser consultadas posteriormente mediante el endpoint /api/quotations/{id} para verificar su estado, pudiendo ser: Pendiente, Aceptada, Rechazada o Vencida.

Conversión a Comprobante

Para convertir una cotización aceptada en una factura, boleta u otro comprobante, utilice el endpoint /api/quotations/{id}/convert con los parámetros de tipo de documento destino.

Notificaciones

Configure notificaciones automáticas para:

• Envío inicial de cotización
• Recordatorios antes del vencimiento
• Notificación de aceptación o rechazo

Consideraciones Importantes

• Verifique la correcta configuración de impuestos según el tipo de operación
• Las cotizaciones tienen un período de validez que debe ser especificado
• Mantenga actualizados los precios y disponibilidad de productos
• Establezca claramente las condiciones comerciales y plazos de entrega

Referencias y Soporte

Para más información sobre la gestión de cotizaciones, consulte la sección de Referencias.

Si experimenta problemas con la implementación, contacte a nuestro equipo de soporte a través del canal oficial indicado en su panel de administración.