Lista CFE emitidos con filtros y paginación

GET

/v1/cfe/listar-emitidos

Producción
Homologación / pruebas

Listado paginado de los CFE emitidos por la cuenta autenticada.

Filtros

Todos los query params son opcionales y combinables (AND):

tipo — TipoCFE numérico (101, 111, etc.).
serie + numero — Búsqueda exacta por serie + número.
clienteId — UUID exacto de cliente del catálogo.
productoId — UUID de un ítem del catálogo (devuelve CFE que lo contienen).
moneda — UYU, USD, ARS, BRL, EUR.
sucursalId / puntoEmisionId — UUID de sucursal y punto. Si tu ApiAccess está fijado a una sucursal, sucursalId se ignora silenciosamente (no podés ver CFE de otras sucursales).

Paginación

pagina (default 1, mínimo 1).
porPagina (default 20, máximo 200).

La metadata viene en meta.paginacion.

Autorizaciones

BearerAuth

Parámetros

Parámetros de query

pagina

integer

>= 1

porPagina

integer

>= 1 <= 200

clienteId

string format: uuid

moneda

string

Allowed values: UYU USD ARS BRL EUR

tipo

integer

numero

integer

serie

string

productoId

string format: uuid

sucursalId

string format: uuid

puntoEmisionId

string format: uuid

Respuestas

200

Listado paginado de CFE emitidos

nullable

Ejemplos

Listado paginado (página 1 de 12, mostrando 2 ítems)

{
  "data": [
    {
      "id": "8a7b6c5d-4e3f-2a1b-9c8d-7e6f5a4b3c2d",
      "tipo": 111,
      "tipoDescripcion": "e-Factura",
      "serie": "A",
      "numero": 1234,
      "moneda": "UYU",
      "total": 15250,
      "estado": "aceptado",
      "fechaCreacion": "2026-05-17T13:42:10.000Z"
    },
    {
      "id": "1c2d3e4f-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
      "tipo": 101,
      "tipoDescripcion": "e-Ticket",
      "serie": "A",
      "numero": 1233,
      "moneda": "UYU",
      "total": 244,
      "estado": "aceptado",
      "fechaCreacion": "2026-05-17T13:20:05.000Z"
    }
  ],
  "meta": {
    "paginacion": {
      "pagina": 1,
      "porPagina": 20,
      "totalFilas": 234,
      "totalPaginas": 12
    }
  }
}

401

No autenticado. La API_KEY no fue enviada o no es válida.

Códigos posibles: API_AUTH_HEADER_MISSING, API_AUTH_HEADER_INVALID, API_ACCESS_INVALID.

object

error

required

object

code

required

Identificador estable del error en SCREAMING_SNAKE_CASE

string

message

required

Mensaje legible en español

string

details

Información adicional (puede ser objeto, array o string)

nullable

requestId

UUID de correlación; mismo valor que el header X-Request-ID

string format: uuid

Ejemplos

Falta header Authorization

{
  "error": {
    "code": "API_AUTH_HEADER_MISSING",
    "message": "Se esperaba la cabecera Authorization con esquema Bearer"
  },
  "requestId": "5b2c7c8a-1f6e-4d29-9a0b-7c3a8d1e2f4c"
}

Secret key inválida o revocada

{
  "error": {
    "code": "API_ACCESS_INVALID",
    "message": "Acceso no autorizado"
  },
  "requestId": "5b2c7c8a-1f6e-4d29-9a0b-7c3a8d1e2f4c"
}

403

Acceso prohibido. La credencial es válida pero el plan o el alcance de sucursal lo impiden.

Códigos posibles: API_FEATURE_DISABLED, API_ACCESS_BRANCH_MISMATCH.

object

error

required

object

code

required

Identificador estable del error en SCREAMING_SNAKE_CASE

string

message

required

Mensaje legible en español

string

details

Información adicional (puede ser objeto, array o string)

nullable

requestId

UUID de correlación; mismo valor que el header X-Request-ID

string format: uuid

Ejemplos

El plan no incluye API

{
  "error": {
    "code": "API_FEATURE_DISABLED",
    "message": "El plan de esta cuenta no tiene habilitado el acceso a la API"
  },
  "requestId": "5b2c7c8a-1f6e-4d29-9a0b-7c3a8d1e2f4c"
}

Header x-branch-id distinto al fijo del ApiAccess

{
  "error": {
    "code": "API_ACCESS_BRANCH_MISMATCH",
    "message": "El ApiAccess está fijado a otra sucursal y no coincide con x-branch-id"
  },
  "requestId": "5b2c7c8a-1f6e-4d29-9a0b-7c3a8d1e2f4c"
}

429

Rate limit excedido. Esperá los segundos indicados en el header Retry-After.

object

error

required

object

code

required

Identificador estable del error en SCREAMING_SNAKE_CASE

string

message

required

Mensaje legible en español

string

details

Información adicional (puede ser objeto, array o string)

nullable

requestId

UUID de correlación; mismo valor que el header X-Request-ID

string format: uuid

Ejemplos

Excediste el rate limit

{
  "error": {
    "code": "API_RATE_LIMITED",
    "message": "Se superó el límite de requests para esta API key"
  },
  "requestId": "5b2c7c8a-1f6e-4d29-9a0b-7c3a8d1e2f4c"
}

Headers

Retry-After

integer

Ejemplo

Segundos hasta que se libera la ventana de rate limit