Saltearse al contenido
Host Admin

Consulta un CFE recibido por su UUID

GET
/v1/cfe/recibidos/{id}

Detalle de un CFE recibido: los datos del listado más el emisor, el receptor, los totales desglosados, las líneas (detalle), las referencias (notas de crédito/débito), el CAE con el que se emitió, la adenda, el motivo de DGI y el código de seguridad.

El id es el mismo cfeRecibidoId que llega en los webhooks cfe_recibido.creado y cfe_recibido.actualizado: con el webhook te enterás de que llegó un comprobante y con GET /v1/cfe/recibidos/{id} traés su detalle.

Qué se expone

Un subconjunto definido del formato de DGI, con nombres propios en español (no el XML ni los nombres de DGI): por ejemplo totales.netoIvaTasaBasica es MntNetoIVATasaBasica. Un dato que el comprobante no trae viene en null. detalle[].retenciones sólo tiene filas en un e-Resguardo. codigoSeguridad son los 6 primeros caracteres del DigestValue de la firma del emisor (null si no se pudo leer). El XML firmado no viaja acá.

Disponible para toda empresa, aunque no emita comprobantes (por ejemplo, una institución que sólo recibe facturas de sus proveedores). Los recibidos son de la empresa, no de una sucursal: una credencial fijada a una sucursal ve todos.

Alcance requerido: recibidos:leer. Si la credencial no lo tiene, la respuesta es 403 API_ALCANCE_INSUFICIENTE con la lista en error.requerido. Las credenciales creadas antes del modelo de alcances (alcances: null) conservan acceso total.

Autorizaciones

Sección titulada «Autorizaciones »

Parámetros

Sección titulada « Parámetros »

Parámetros de path

Sección titulada «Parámetros de path »
id
required

UUID del CFE recibido (el cfeRecibidoId de los webhooks cfe_recibido.*)

string format: uuid

UUID del CFE recibido (el cfeRecibidoId de los webhooks cfe_recibido.*)

Parámetros de header

Sección titulada «Parámetros de header »
x-cuenta-id
string format: uuid
Ejemplo
0199d1b0-0000-7000-8000-000000000000

Sólo para credenciales de cuenta proveedora (revendedor). UUID de la subcuenta de la cartera sobre la que se quiere operar: la cuenta efectiva del request pasa a ser esa.

Una credencial que no es de proveedor, o una subcuenta que no está en su cartera, recibe 403 API_CUENTA_FUERA_DE_CARTERA. Sin la cabecera, la cuenta es siempre la de la credencial.

Respuestas

Sección titulada « Respuestas »

200

Sección titulada «200 »

Detalle del CFE recibido

object
Ejemplos
{
  "data": {
    "id": "3c1e9f62-8a4b-4d7e-b0c2-5f6a7b8c9d0e",
    "tipo": 111,
    "tipoDescripcion": "e-Factura",
    "serie": "A",
    "numero": 4521,
    "rutEmisor": "214567890018",
    "razonSocialEmisor": "Proveedora del Sur S.A.",
    "proveedorId": "9d8c7b6a-5f4e-4d3c-2b1a-0f9e8d7c6b5a",
    "fechaEmision": "2026-10-01",
    "moneda": "UYU",
    "tipoCambio": 1,
    "subtotal": 10000,
    "iva": 2200,
    "total": 12200,
    "estado": "aceptado",
    "estadoDgi": "A",
    "aceptadoPorDgi": true,
    "estadoComercial": "pendiente",
    "anulado": false,
    "origenRecepcion": "WEBSERVICE",
    "recibidoEn": "2026-10-01T14:32:10.000Z",
    "xmlDisponible": true,
    "formaPago": 2,
    "fechaVencimiento": "2026-10-31",
    "preciosIncluyenIva": false,
    "emisor": {
      "rut": "214567890018",
      "razonSocial": "Proveedora del Sur S.A.",
      "nombreComercial": "Proveedora del Sur",
      "giro": null,
      "correo": "facturacion@proveedoradelsur.com.uy",
      "sucursal": null,
      "codigoSucursalDgi": 1,
      "domicilioFiscal": "Av. 18 de Julio 1234",
      "ciudad": "Montevideo",
      "departamento": "Montevideo"
    },
    "receptor": {
      "tipoDocumento": 2,
      "codigoPais": "UY",
      "documento": "219999990019",
      "razonSocial": "Institución Receptora",
      "direccion": "Bv. Artigas 500",
      "ciudad": "Montevideo",
      "departamento": "Montevideo",
      "pais": "Uruguay",
      "compraId": "OC-2026-118"
    },
    "totales": {
      "moneda": "UYU",
      "tipoCambio": null,
      "montoNoGravado": 0,
      "montoExportacionYAsimilados": null,
      "montoImpuestoPercibido": null,
      "montoIvaEnSuspenso": null,
      "netoIvaTasaMinima": 0,
      "netoIvaTasaBasica": 10000,
      "netoIvaOtraTasa": null,
      "tasaIvaMinima": 10,
      "tasaIvaBasica": 22,
      "ivaTasaMinima": 0,
      "ivaTasaBasica": 2200,
      "ivaOtraTasa": null,
      "montoTotal": 12200,
      "montoTotalRetenido": null,
      "montoTotalCreditoFiscal": null,
      "montoNoFacturable": null,
      "montoAPagar": 12200,
      "cantidadLineas": 1
    },
    "detalle": [
      {
        "numeroLinea": 1,
        "codigos": [
          {
            "tipo": "INT1",
            "codigo": "SRV-01"
          }
        ],
        "indicadorFacturacion": 3,
        "nombre": "Servicio de mantenimiento",
        "descripcion": "Mantenimiento mensual - setiembre",
        "cantidad": 1,
        "unidadMedida": "N/A",
        "precioUnitario": 10000,
        "descuentoPorcentaje": null,
        "descuentoMonto": null,
        "recargoPorcentaje": null,
        "recargoMonto": null,
        "montoItem": 10000,
        "retenciones": []
      }
    ],
    "referencias": [],
    "cae": {
      "id": "90230001234",
      "desde": 1,
      "hasta": 10000,
      "vencimiento": "2027-12-31"
    },
    "adenda": null,
    "motivoDgi": null,
    "fechaEstadoDgi": "2026-10-01T14:40:02.000Z",
    "motivoAnulacion": null,
    "codigoSeguridad": "aB3dE9"
  }
}

401

Sección titulada «401 »

No autenticado. La API_KEY no fue enviada, no es válida o la credencial está desactivada.

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. No parsearlo: puede cambiar

string
details
Any of:
object
requerido

Sólo en 403 API_ALCANCE_INSUFICIENTE: alcances que habilitan la operación

Array<string>
Allowed values: cfe:emitir cfe:leer recibidos:leer consultas clientes:leer clientes:escribir pagos:leer pagos:cobrar pagos:tarjetas pagos:suscripciones pagos:configurar webhooks:gestionar
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"
}

403

Sección titulada «403 »

Acceso prohibido. La credencial es válida pero algo del contexto lo impide. Las cinco causas se corrigen de forma distinta y ninguna se arregla reintentando:

CodeQué pasóCómo se corrige
API_FEATURE_DISABLEDLa cuenta no tiene la API habilitada en su planPedir la habilitación a soporte o al proveedor
API_ALCANCE_INSUFICIENTELa credencial no tiene el alcance de la operación (va en error.requerido)Editar la credencial en Integraciones → API
API_ALCANCE_NO_DISPONIBLELa credencial tiene el alcance pero la cuenta no lo admite: sin cobros habilitados (pagos:*), sin facturación (cfe:*) o no es cuenta proveedora (webhooks:gestionar). Va en error.detailsPedir la habilitación a soporte o al proveedor
API_ACCESS_BRANCH_MISMATCHx-branch-id distinto de la sucursal fijada en la credencialQuitar la cabecera o usar otra credencial
API_CUENTA_FUERA_DE_CARTERAx-cuenta-id apunta a una cuenta que no es de la carteraRevisar el UUID de la subcuenta
object
error
required
object
code
required

Identificador estable del error en SCREAMING_SNAKE_CASE

string
message
required

Mensaje legible en español. No parsearlo: puede cambiar

string
details
Any of:
object
requerido

Sólo en 403 API_ALCANCE_INSUFICIENTE: alcances que habilitan la operación

Array<string>
Allowed values: cfe:emitir cfe:leer recibidos:leer consultas clientes:leer clientes:escribir pagos:leer pagos:cobrar pagos:tarjetas pagos:suscripciones pagos:configurar webhooks:gestionar
requestId

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

string format: uuid
Ejemplos

Falta el alcance

{
  "error": {
    "code": "API_ALCANCE_INSUFICIENTE",
    "message": "La credencial de API no tiene ninguno de los alcances necesarios para esta operación (pagos:cobrar)",
    "requerido": [
      "pagos:cobrar"
    ]
  },
  "requestId": "3f6b1c2e-9a4d-4f80-bc11-7e2d5a8f0c31"
}

404

Sección titulada «404 »

No existe, o es de otra empresa (los dos casos responden igual)

object
error
required
object
code
required

Identificador estable del error en SCREAMING_SNAKE_CASE

string
message
required

Mensaje legible en español. No parsearlo: puede cambiar

string
details
Any of:
object
requerido

Sólo en 403 API_ALCANCE_INSUFICIENTE: alcances que habilitan la operación

Array<string>
Allowed values: cfe:emitir cfe:leer recibidos:leer consultas clientes:leer clientes:escribir pagos:leer pagos:cobrar pagos:tarjetas pagos:suscripciones pagos:configurar webhooks:gestionar
requestId

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

string format: uuid
Ejemplos

No encontrado

{
  "error": {
    "code": "CFE_RECIBIDO_NO_ENCONTRADO",
    "message": "CFE recibido no encontrado (3c1e9f62-8a4b-4d7e-b0c2-5f6a7b8c9d0e)"
  },
  "requestId": "7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d"
}

422

Sección titulada «422 »

El id no es un UUID (VALIDATION_ERROR)

object
error
required
object
code
required

Identificador estable del error en SCREAMING_SNAKE_CASE

string
message
required

Mensaje legible en español. No parsearlo: puede cambiar

string
details
Any of:
object
requerido

Sólo en 403 API_ALCANCE_INSUFICIENTE: alcances que habilitan la operación

Array<string>
Allowed values: cfe:emitir cfe:leer recibidos:leer consultas clientes:leer clientes:escribir pagos:leer pagos:cobrar pagos:tarjetas pagos:suscripciones pagos:configurar webhooks:gestionar
requestId

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

string format: uuid
Ejemplos

Id inválido

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "La petición no pasó la validación",
    "details": [
      {
        "campo": "id",
        "codigo": "invalid_format",
        "mensaje": "Invalid UUID"
      }
    ]
  },
  "requestId": "7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d"
}

429

Sección titulada «429 »

Rate limit excedido. Esperá los segundos del header Retry-After. La cuota va por credencial: 60 req/min en cuentas estándar, 600 en cuentas proveedor.

object
error
required
object
code
required

Identificador estable del error en SCREAMING_SNAKE_CASE

string
message
required

Mensaje legible en español. No parsearlo: puede cambiar

string
details
Any of:
object
requerido

Sólo en 403 API_ALCANCE_INSUFICIENTE: alcances que habilitan la operación

Array<string>
Allowed values: cfe:emitir cfe:leer recibidos:leer consultas clientes:leer clientes:escribir pagos:leer pagos:cobrar pagos:tarjetas pagos:suscripciones pagos:configurar webhooks:gestionar
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

Sección titulada «Headers »
Retry-After
integer
Ejemplo
42

Segundos hasta que se libera la ventana de rate limit