Consultar catálogo

Consultar catálogo SIAT

Devuelve códigos oficiales ya sincronizados para la empresa, ambiente, sucursal y punto de venta asociados a X-API-Key.

Autorización

Requiere X-API-Key con permiso catalogos.consultar. No requiere Bearer, X-Tenant-ID, NIT, ambiente, Token Delegado ni Idempotency-Key.

Cuerpo

• filters.catalogo: opcional. Usa todos (o omítelo) para recorrer todos los catálogos en una sola paginación. Para un catálogo específico: actividades, actividades_documento_sector, leyendas_factura, mensajes_servicios, productos_servicios, eventos_significativos, motivos_anulacion, paises_origen, tipos_documento_identidad, tipos_documento_sector, tipos_emision, tipos_habitacion, metodos_pago, monedas, tipos_punto_venta, tipos_factura, unidades_medida.
• sortBy: opcional. Admite catalogo, codigo, descripcion o codigoActividad; el valor por defecto es catalogo.
• sortDir: opcional. Admite asc o desc; el valor por defecto es asc.
• page: opcional, inicia en 0.
• size: opcional, entre 1 y 100; el valor inicial es 50.
• filters.codigo, filters.descripcion, filters.codigoActividad: filtros opcionales. No existen otros filtros ni ordenamiento configurable.

Respuestas

• 200 OK: resultados paginados, ordenados por catálogo, código y actividad. Cuando se usa todos, cada fila incluye su campo catalogo.
• 400 Bad Request: cuerpo o catálogo inválido.
• 401 Unauthorized: clave ausente, inválida, vencida o revocada.
• 404 Not Found: catálogo aún no sincronizado.
• 429 Too Many Requests: máximo 120...