Ir al contenido

Referencia · Ventas

Imprimir un CFE

POST/imprimirCFE

Genera 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.

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

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 — —

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": ""
}

Devuelve urlA4, urlTicket (ticket térmico) y htmlTicket para imprimir o mostrar el comprobante.

{
"idCFE": "REEMPLAZAR_CON_ID_CFE"
}