Esta funcionalidad permite registrar detalladamente las cantidades, precios, descuentos e impuestos de los productos y/o servicios que estás ofreciendo a tus clientes. A continuación, te explicamos el proceso:
1. Con este recurso desde la API puedes:
- Crear nuevas cotizaciones.
- Editar cotizaciones creadas o existentes.
- Consultar cotizaciones creadas.
- Eliminar cotizaciones que ya no sean necesarias.
2. Consulta la documentación técnica para conocer en detalle cómo utilizar este recurso y aprovechar al máximo sus capacidades.
3. Antes de crear una cotización a través de la API de Siigo, asegúrate de contar con lo siguiente:
- Un cliente o tercero previamente creado en Siigo Nube.
- Productos o servicios activos en tu cuenta.
- Impuestos creados y configurados.
- Comprobante de cotización creado y previamente configurado.
4. Para crear una cotización utilizando la API de Siigo, realiza la solicitud POST al siguiente endpoint: https://api.siigo.com/v1/quotations y define el cuerpo (payload) de la solicitud.
Importante: para conocer el detalle de cada campo requerido, te invitamos a consultar nuestra documentación.
Si la solicitud es válida, recibirás una respuesta con el código de estado HTTP 201 Created, lo que indica que la cotización fue creada correctamente y visualiza la cotización directamente desde tu entorno en Siigo Nube o comparte el enlace público incluido en la respuesta.
5. Para editar una cotización registrada, utiliza el endpoint: PUT https://api.siigo.com/v1/quotations/id
Importante: el ID de la cotización lo obtienes en la respuesta al momento de su creación. Cada cotización tiene un identificador único.
Para este ejemplo, se utilizará el ID generado en el caso anterior: PUT https://api.siigo.com/v1/quotations/864ba12f-e431-4929-b5c1-596d172e0ef55
Envía en el cuerpo (payload) de la solicitud el contenido completo de la cotización, incluyendo los cambios que deseas aplicar. En este caso, se modificará el valor unitario del producto.
Si la solicitud es exitosa, recibirás una respuesta HTTP 200 OK, indicando que la cotización fue actualizada correctamente. El sistema reflejará los nuevos valores y podrás visualizar la cotización editada en Siigo Nube o mediante el enlace público.
6. Consulta las cotizaciones creadas, utilizando el siguiente endpoint: GET https://api.siigo.com/v1/quotations?
Esta solicitud te mostrará un listado con todas las cotizaciones registradas en tu cuenta, incluyendo datos clave como el número del documento, cliente, fecha y total.
7. Si requieres eliminar una cotización previamente creada. A través de la API de Siigo, puedes hacerlo utilizando el endpoint: DELETE https://api.siigo.com/v1/quotations/quotation_id
Importante: reemplaza quotation_id por el identificador único de la cotización que deseas eliminar. Este ID lo obtuviste al momento de crearla o al consultar el listado de cotizaciones.
Para eliminar la cotización utilizada en los ejemplos anteriores, el endpoint sería el siguiente: DELETE https://api.siigo.com/v1/quotations/864ba12f-e431-4929-b5c1-596d172e0ef5
Cuando el ID es válido y la cotización existe, recibirás una respuesta con el código de estado.
Si tienes dudas o necesitas ayuda con este endpoint, no dudes en escribirnos a través de cualquiera de nuestros canales de soporte:
Esperamos que esta guía haya sido de utilidad. ¡Estamos aquí para apoyarte!
