Gestionar los documentos soporte en API te permite registrar y respaldar las compras o pagos realizados a proveedores que no están obligados a emitir factura electrónica. Este documento se genera cuando no se recibe una factura electrónica ni un documento equivalente, garantizando que la transacción quede correctamente contabilizada, con mayor control, trazabilidad y en cumplimiento de la normativa vigente.
Para gestionar los documentos soporte, sigue estos pasos:
1. Para crear un documento soporte, realiza la solicitud POST al siguiente endpoint: https://api.siigo.com/v1/purchase-support-documents y define el cuerpo (payload) de la siguiente manera:
Importante: para conocer el detalle de cada campo requerido, te invitamos a consultar nuestra documentación técnica.
2. Si la solicitud es válida, recibirás una respuesta con el código de estado, lo que indica que el documento soporte fue creado correctamente y visualizarás el documento directamente desde tu entorno en Siigo Nube.
3. Es necesario tener en cuenta los siguientes apartados:
- Stamp: este es un campo opcional el cual se debe enviar en «true» para que permita reportar el documento a la Dirección de Impuestos y Aduanas Nacionales (DIAN). Si no se envía este campo, toma por defecto «false».
- Si tienes alguna duda de este proceso, consulta la documentación técnica y conoce a detalle este procedimiento.
4. Para editar un documento soporte, utiliza el endpoint: PUT https://api.siigo.com/v1/purchase-support-documents/string
Importante: dentro del manejo de este endpoint es importante tener en cuenta que hay varios campos que no será posible modificarlos, como por ejemplo el document.id, supplier.identification, currency.code y number.
5. Consulta los documentos soporte creados, utilizando el siguiente endpoint: GET https://api.siigo.com/v1/purchase-support-documents/ID o https://api.siigo.com/v1/purchase-support-documents para consultarlos todos.
Este endpoint permite obtener la información de los documentos soporte creados en tu base de Siigo Nube a través de la Siigo API. Puedes consultar un documento específico mediante su ID, o realizar una búsqueda general para listar todos los documentos soporte disponibles.
6. Recibirás una respuesta con el siguiente código de estado:
7. Para consultar los tipos de comprobante de documento soporte creados en Siigo Nube con su respectiva configuración, utiliza el endpoint GET https://api.siigo.com/v1/document-types?type=DS
8. Recibirás una respuesta con el código de estado.
9. Si requieres borrar un documento soporte, deberás utilizar el endpoint DELETE https://api.siigo.com/v1/purchase-support-documents/ID
10. Cuando el ID es válido y el documento soporte 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!
