Skip to main content
Los catalogos contienen los codigos oficiales del SIAT que se usan en las facturas (actividades economicas, productos, unidades de medida, metodos de pago, etc.). Los catalogos son especificos por NIT y se sincronizan desde el SIAT.
Todos los endpoints de catalogos requieren autenticacion via X-API-Key. Los catalogos son multi-tenant y cada NIT tiene su propio conjunto de datos sincronizados.
No hardcodear codigos. Los codigos de metodos de pago, unidades de medida, actividades economicas, etc. provienen del catalogo SIAT sincronizado. El catalogo tiene 308 metodos de pago, 154 monedas, 126 unidades de medida, y cientos de actividades y productos. Siempre consultar el catalogo sincronizado para obtener los codigos correctos.

​
Sincronizar todos los catalogos

POST /api/v1/siat/sync/all Sincroniza todos los catalogos del SIAT con la base de datos local. Ejecutar al menos una vez al inicio y se recomienda ejecutar diariamente. La sincronizacion es atomica: si algun catalogo falla, todos se revierten para evitar estado parcial. Incluye proteccion contra ejecucion concurrente por tenant.

​
Sincronizar catalogo especifico

POST /api/v1/siat/sync/{catalog} Catalogos disponibles: activities, products, legends, cancellation-reasons, document-types, payment-methods, currencies, unit-measures, significant-events.

​
Consultar actividades economicas

GET /api/v1/siat/sync/catalogs/activities

​
Consultar productos por actividad

GET /api/v1/siat/sync/catalogs/products?activityCode=620100

​
Consultar leyendas

GET /api/v1/siat/sync/catalogs/legends

​
Consultar catalogo generico

GET /api/v1/siat/sync/catalogs/{type} Tipos disponibles: document-types, payment-methods, currencies, unit-measures, cancellation-reasons, significant-events.
El catalogo de metodos de pago tiene 308 codigos que incluyen combinaciones (ej: Efectivo + Tarjeta, Efectivo + Gift Card, etc.). Consultar el catalogo completo para ver todas las opciones disponibles para tu NIT.