Ir al contenido

Referencia · Ventas

Consultar una venta

POST/ventaConsulta

Consulta el estado y datos de un CFE emitido previamente.

La guía correspondiente está en Consultar un CFE.

La ruta POST /ventaConsulta se agrega a la URL base del ambiente.

Enviá los headers x-api-key y x-api-secret. Cómo obtenerlos está en Credenciales.

El cuerpo es JSON (Content-Type: application/json).

Si falta un campo obligatorio, la API rechaza la solicitud.

Campo Tipo Obligatorio Descripción Ejemplo
idCFE string Sí Identificador del CFE devuelto por /ventaCrear. REEMPLAZAR_CON_ID_CFE

Datos del CFE

Si la operación sale bien, codigoError viene vacío.

Campo Tipo Obligatorio Descripción Ejemplo
descripcion string Sí Texto libre. Vacío cuando la operación sale bien. —
codigoError string Sí Vacío cuando la operación sale bien. Con valor, es un código de error de esta operación. —
idCFE string Sí Identificador del CFE en Fixed. Guardalo: lo piden la consulta, la impresión y la devolución. —
numero number Sí Número del comprobante dentro de la serie. —
serie string Sí Serie del comprobante. —
tipoCFE number | string Sí Código numérico del comprobante según DGI. Una venta sin RUT es 101 (e-Ticket) y con RUT es 111 (e-Factura). La nota de crédito correspondiente es 102 o 112. En un error puede venir como texto vacío. —
comprobante string Sí Texto legible armado como «tipo serie número». Por ejemplo, e-Ticket A 1523. —
urlA4 string Sí URL del PDF del comprobante en formato A4. —
urlVerificarCFE string Sí Página para verificar el comprobante. En testing empieza con https://testing.fixed.uy/verificarCFE/ y en producción con https://acceso.fixed.uy/verificarCFE/. —
estadoDGI string No aceptado, rechazado o sinrespuesta. Fixed informa aceptado también cuando DGI respondió reliquidado u observado, y rechazado cuando el sobre o el CFE fueron rechazados. —
motivoRechazoDGI string No Motivo informado por DGI. Vacío si el comprobante no fue rechazado. —

Una respuesta de error trae codigoError y descripcion. El mismo código puede significar cosas distintas según el endpoint. El índice completo está en Códigos de error.

Si fallan las credenciales o el formato del body, aplican los códigos comunes: A01 a A06, V01 y V02.

Código Significado
C03 Empresa no encontrada
C08 El idCFE no existe para la empresa

CFE no encontrado u otro error

{
"descripcion": "El idCFE no existe para la empresa",
"codigoError": "C08",
"idCFE": "",
"estadoDGI": "",
"motivoRechazoDGI": "",
"numero": 0,
"serie": "",
"tipoCFE": "",
"comprobante": "",
"urlA4": "",
"urlVerificarCFE": ""
}
{
"idCFE": "REEMPLAZAR_CON_ID_CFE"
}