Realizar operaciones básicas con la Siigo API se facilita enormemente al utilizar Postman, una herramienta poderosa para probar, validar y monitorear APIs sin necesidad de escribir código. Con Postman puedes autenticarte, crear productos y clientes, y emitir facturas electrónicas de manera controlada, validando cada respuesta del sistema. Antes de comenzar, es importante contar con la configuración adecuada en Siigo Nube, lo que te permitirá ejecutar las pruebas correctamente y aprovechar al máximo las funcionalidades de la API en un entorno seguro y confiable.
A continuación, te explicamos cómo realizar las operaciones básicas más comunes con Postman:
1. Asegúrate de instalar Postman en tu equipo.
2. Para interactuar con los endpoints, es necesario autenticarte en la API, accede mediante la ruta: Token – POST Token- Auth Siigo – Send. Por defecto, Postman asigna credenciales de prueba, pero si lo necesitas, puedes generar tus propias credenciales.
3. Antes de ejecutar las pruebas, verifica que Siigo Nube cuente con la configuración adecuada:
- Impuestos creados
- Formas de pago establecidas
- Vendedores registrados
- Grupos de inventario configurados
- Comprobantes listos para transacciones (Recibo de caja, Factura electrónica de venta, Nota crédito electrónica)
4. Crea tus productos desde la API:
- Dirígete a la ruta: SiigoAPi_Pruebas-Products – Product_Basic_Create
- Selecciona el código del producto, el nombre y el grupo de inventarios, pulsamos en el botón Send .
- Si todo sale bien, responderá con un código HTTP 201 Created, indicando que el producto se creó correctamente.
5. Para registrar un nuevo cliente:
- Accede a la ruta: SiigoAPi_Pruebas-Customers– Customers basic-create.
- Completa los datos requeridos para registrar al cliente.
- Consulta más detalles sobre los campos en nuestra documentación: Siigo API · Apiary.
6. Crea una factura utilizando Siigo API:
- Dirígete a la ruta: SiigoAPi_Pruebas-Invoices – Invoice-Create
- La API ya tiene un JSON preconfigurado, reemplaza los datos del cliente y del producto que creaste previamente.
Ejemplo de JSON para crear una factura:
Identificadores clave en Siigo Api:
– Document_id : identificador único del comprobante creado en Siigo Nube para Facturación Electrónica; puedes acceder a él mediante GET-Document_Types.
– Seller: ID del vendedor, consulta este catalogó a través de GET_Users(Seller).
– Taxes: identificadores de los diferentes impuestos creados y configurados en siigo Nube, accede a este catálogo con Get_Taxes.
– Payments_ID: identificadores de las formas de pago creadas y configuradas en siigo nube, disponible a través de GET – Invoices – Payments-Types.
Importante: para obtener más información sobre los catálogos, puedes consultar nuestra documentación: Siigo API · Apiary.
Si tienes alguna duda, escríbenos al correo: soporteapi@siigo.com.
Con esta guía, puedes realizar operaciones básicas con Postman de manera rápida y sencilla.
