Consultar CUFD activo

GET/api/v1/codigos/cufd/:puntoVentaId

Devuelve el último CUFD persistido que todavía está vigente para el punto de venta local indicado.

Header requerido X-API-KeyVer operaciones de Códigos fiscales

Contrato de la operación

Devuelve el último CUFD persistido que todavía está vigente para el punto de venta local indicado.

Autorización y parámetros

Requiere X-API-Key con permiso codigos.consultar. puntoVentaId es el UUID de un punto activo de la empresa de la clave; su ambiente también lo define la clave. No requiere cuerpo, Bearer, X-Tenant-ID ni Idempotency-Key.

Respuestas

200 OK contiene el CUFD activo y activo: true. 401 o 403, clave inválida o sin permiso; 404, UUID inválido, punto ajeno/inexistente o sin CUFD vigente. Regenera el CUFD mediante POST /api/v1/codigos/cufd cuando no exista uno vigente.

El endpoint no llama al SIAT: devuelve el último resultado almacenado para el punto de venta.

El backend deriva sucursal y código SIAT desde el UUID. Consulta [migracion.md](migracion.md).

Ejemplo

Solicitud de ejemplo

Clave ficticia; no se ejecuta desde esta página

cURL · GET

export FALMUS_API_URL='https://staging-api.falmus.com/api/v1'
export FALMUS_API_KEY='flm_test_REEMPLAZA_CON_TU_CLAVE'
export PUNTO_VENTA_ID='REEMPLAZA_CON_PUNTO_VENTA_ID'

curl --request GET \
  --url "$FALMUS_API_URL/codigos/cufd/${PUNTO_VENTA_ID}" \
  --header "X-API-Key: $FALMUS_API_KEY"

Este ejemplo no incluye un cuerpo. Revisa el contrato para conocer los parámetros de ruta y consulta.

Respuesta

Ejemplo de respuesta

200 OKapplication/json

JSON

{
  "message": "CUFD activo obtenido",
  "data": {
    "cufd": "BQW5FZ...",
    "codigoControl": "A1B2C3",
    "vigencia": "2026-08-28T00:00:00Z",
    "activo": true
  }
}

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

Volver a Códigos fiscales