Referencia · Ventas
Imprimir un CFE
/imprimirCFEGenera o regenera las URLs e HTML de impresión de un CFE emitido. Útil si el CFE ya existe pero se necesita volver a obtener sus URLs de impresión.
La respuesta incluye:
-
urlA4: comprobante A4 en PDF. -
urlTicket: ticket térmico en PDF (formato estrecho). -
htmlTicket: ticket en HTML (útil para preview o impresión web).
La guía correspondiente está en Imprimir un CFE.
Solicitud
Sección titulada «Solicitud»La ruta POST /imprimirCFE 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»CFE encontrado. Respuesta incluye urlA4, urlTicket y htmlTicket
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 | — | — |
motivoRechazoDGI |
string | No | — | — |
urlTicket |
string | No | URL del ticket térmico en PDF. Formato estrecho para impresoras de ticket. | — |
htmlTicket |
string | No | Ticket en HTML. Útil para preview en pantalla o impresión desde el navegador. | — |
pdfBase64 |
string | No | PDF del comprobante en formato A4, en base64. | — |
xml |
string | No | — | — |
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»Obtener ticket y PDF de un CFE
Sección titulada «Obtener ticket y PDF de un CFE»Devuelve urlA4, urlTicket (ticket térmico) y htmlTicket para imprimir o mostrar el comprobante.
{ "idCFE": "REEMPLAZAR_CON_ID_CFE"}