Sincronizar catálogos

POST/api/v1/catalogos-siat/sincronizar

Sin...

Header requerido X-API-KeyVer operaciones de Catálogos SIAT

Contrato de la operación

Sincronizar catálogos SIAT

Descarga y reemplaza atómicamente los catálogos oficiales del contexto fiscal resuelto por X-API-Key.

Autorización

Requiere exclusivamente X-API-Key con permiso catalogos.sincronizar. La clave determina empresa, ambiente, sucursal y punto de venta. No envíes Bearer, X-Tenant-ID, NIT, ambiente, Idempotency-Key, Token Delegado, CUIS ni certificados.

Solicitud

catalogo: opcional. En snake_case, por ejemplo productos_servicios o metodos_pago. Descarga y reemplaza únicamente ese catálogo; los demás permanecen intactos.
Omite el cuerpo (o catalogo) para descargar todos los catálogos en una única operación atómica, incluido productos_servicios, necesario para emitir facturas.
También se acepta camelCase; el backend lo normaliza.

Concurrencia y límites

El resultado es idempotente: reemplaza el catálogo completo de forma atómica. Una segunda sincronización concurrente devuelve 409; no existe estado parcial. Máximo: 5 solicitudes por minuto por clave.

Respuestas

200 OK: sincronización completa.
401 Unauthorized: clave ausente, inválida, vencida, revocada o sin permiso.
409 Conflict: sincronización simultánea o clave idempotente reutilizada de forma distinta.
422 Unprocessable Entity: integración SIAT inactiva o credenciales rechazadas.
503 Service Unavailable: SIAT no disponible temporalmente.

Sin...

Ejemplo

Solicitud de ejemplo

Clave ficticia; no se ejecuta desde esta página

JSON · cuerpo de solicitud

{}

Respuesta

Ejemplo de respuesta

200 OKapplication/json

JSON

{
  "message": "Operación realizada correctamente",
  "data": {
    "syncedAt": "2026-08-22T10:00:00Z",
    "totalRecords": 588,
    "catalogs": [
      "actividades",
      "metodos_pago",
      "productos_servicios"
    ]
  }
}

Datos ficticios; los identificadores y valores cambian en cada respuesta.

Volver a Catálogos SIAT