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.
| Parametro | Ubicacion | Tipo | Req | Descripcion |
|---|
X-API-Key | Header | string | Si | Tu API Key |
posId | Query | string | No | UUID del punto de venta (usa el default si se omite) |
curl -X POST https://sandbox.cucu.bo/api/v1/siat/sync/all \
-H "X-API-Key: YOUR_API_KEY"
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.
| Parametro | Ubicacion | Tipo | Req | Descripcion |
|---|
X-API-Key | Header | string | Si | Tu API Key |
catalog | Path | string | Si | Nombre del catalogo a sincronizar |
posId | Query | string | No | UUID del punto de venta |
Consultar actividades economicas
GET /api/v1/siat/sync/catalogs/activities
| Parametro | Ubicacion | Tipo | Req | Descripcion |
|---|
X-API-Key | Header | string | Si | Tu API Key |
curl -X GET https://sandbox.cucu.bo/api/v1/siat/sync/catalogs/activities \
-H "X-API-Key: YOUR_API_KEY"
Consultar productos por actividad
GET /api/v1/siat/sync/catalogs/products?activityCode=620100
| Parametro | Ubicacion | Tipo | Req | Descripcion |
|---|
X-API-Key | Header | string | Si | Tu API Key |
activityCode | Query | string | No | Filtrar productos por codigo de actividad economica |
Consultar leyendas
GET /api/v1/siat/sync/catalogs/legends
| Parametro | Ubicacion | Tipo | Req | Descripcion |
|---|
X-API-Key | Header | string | Si | Tu API Key |
activityCode | Query | string | No | Filtrar leyendas por actividad economica |
Consultar catalogo generico
GET /api/v1/siat/sync/catalogs/{type}
Tipos disponibles: document-types, payment-methods, currencies, unit-measures, cancellation-reasons, significant-events.
| Parametro | Ubicacion | Tipo | Req | Descripcion |
|---|
X-API-Key | Header | string | Si | Tu API Key |
type | Path | string | Si | Tipo de catalogo |
{
"success": true,
"data": [
{ "code": "1", "description": "EFECTIVO", "catalogType": "PAYMENT_METHOD" },
{ "code": "2", "description": "TARJETA DE CREDITO", "catalogType": "PAYMENT_METHOD" },
{ "code": "5", "description": "TRANSFERENCIA BANCARIA", "catalogType": "PAYMENT_METHOD" },
{ "code": "27", "description": "GIFT-CARD", "catalogType": "PAYMENT_METHOD" },
{ "code": "35", "description": "EFECTIVO-GIFT CARD", "catalogType": "PAYMENT_METHOD" }
]
}
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.
