Referencia · Ventas
Consultar una venta
POST
/ventaConsultaConsulta el estado y datos de un CFE emitido previamente.
La guía correspondiente está en Consultar un CFE.
Solicitud
Sección titulada «Solicitud»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 |
Respuesta 200
Sección titulada «Respuesta 200»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. | — |
Errores
Sección titulada «Errores»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 |
HTTP 500
Sección titulada «HTTP 500»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": ""}Ejemplos
Sección titulada «Ejemplos»Consultar estado de un CFE
Sección titulada «Consultar estado de un CFE»{ "idCFE": "REEMPLAZAR_CON_ID_CFE"}