Consulta directa de comprobantes

Estas rutas sirven para recuperar un comprobante puntual por id, por id externo o descargar su PDF.

Lectura rápida

1. Usá GET /comprobantes/{id} si ya tenés el id interno.
2. Usá GET /comprobantes/e/{id} si tu integración guarda un id externo.
3. Usá GET /comprobantes/{id}/pdf para obtener la representación PDF.

GET /comprobantes/{id}

GET https://api-test.facturaelectronica.com.uy/comprobantes/5037362
Authorization: Bearer ACCESS_TOKEN
X-Emisor: 219999830019

Obtiene los datos de un comprobante a partir de su id interno.

Headers requeridos

Header	Tipo o valor esperado	Requerido	Descripción
Authorization	Bearer ACCESS_TOKEN	Sí	Bearer token obtenido en Autenticación.
X-Emisor	String o Int64	Sí	RUT de la empresa emisora asociada al comprobante.

Parámetros de ruta

Parámetro	Tipo	Requerido	Descripción
id	Int64	Sí	Identificador interno del comprobante.

Campos esperables en la respuesta

Campo	Tipo	Descripción
id	Int64	Identificador interno del comprobante.
id_externo	String	Identificador externo informado al crear el CFE, si existe.
tipo_comprobante	Int	Tipo de CFE.
serie	String	Serie fiscal del comprobante.
numero	Int	Número fiscal del comprobante.
fecha_emision	DateTime	Fecha de emisión del documento.
fecha_firma	DateTime	Fecha y hora de firma electrónica.
emisor	Obj	Datos de la empresa emisora.
receptor	Obj	Datos de la empresa receptora.
totales	Obj	Importes principales del comprobante.
items	Array de objetos	Líneas detalladas del comprobante.

GET /comprobantes/e/{id}

GET https://api-test.facturaelectronica.com.uy/comprobantes/e/MI-ID-EXTERNO-001
Authorization: Bearer ACCESS_TOKEN

Obtiene un comprobante a partir del id externo usado por tu sistema.

Headers requeridos

Header	Tipo o valor esperado	Requerido	Descripción
Authorization	Bearer ACCESS_TOKEN	Sí	Bearer token obtenido en Autenticación.

Parámetros de ruta

Parámetro	Tipo	Requerido	Descripción
id	String	Sí	Identificador externo del comprobante en tu integración.

Sobre X-Emisor

La colección Postman publicada no incluye X-Emisor para esta ruta. Por eso esta guía documenta solo Authorization como requisito explícito.

Campos esperables en la respuesta

Campo	Tipo	Descripción
id	Int64	Identificador interno del comprobante.
id_externo	String	Identificador externo consultado.
tipo_comprobante	Int	Tipo de CFE.
serie	String	Serie fiscal del comprobante.
numero	Int	Número fiscal del comprobante.
fecha_emision	DateTime	Fecha de emisión del documento.
fecha_firma	DateTime	Fecha y hora de firma electrónica.
emisor	Obj	Datos de la empresa emisora.
receptor	Obj	Datos de la empresa receptora.
totales	Obj	Importes principales del comprobante.
items	Array de objetos	Líneas detalladas del comprobante.

GET /comprobantes/{id}/pdf

GET https://api-test.facturaelectronica.com.uy/comprobantes/5037362/pdf?tipo=ticket80
Authorization: Bearer ACCESS_TOKEN
X-Emisor: 219999830019

Devuelve el PDF del comprobante indicado.

Headers requeridos

Header	Tipo o valor esperado	Requerido	Descripción
Authorization	Bearer ACCESS_TOKEN	Sí	Bearer token obtenido en Autenticación.
X-Emisor	String o Int64	Sí	RUT de la empresa emisora asociada al comprobante.

Parámetros de ruta

Parámetro	Tipo	Requerido	Descripción
id	Int64	Sí	Identificador interno del comprobante.

Query params

Query param	Tipo	Requerido	Descripción
tipo	String	No	Formato del PDF. Default: A4. Usá ticket80 para impresora térmica de 80 mm.

Formato de impresión

Si no enviás tipo, la API usa A4. Para tickets térmicos, enviá tipo=ticket80.

Respuesta

Campo	Tipo	Descripción
body	File (application/pdf)	Archivo PDF binario del comprobante solicitado.

Cuándo usar estas rutas

Necesidad	Ruta recomendada
Ya tenés el id interno FEU	GET /comprobantes/{id}
Guardaste un identificador propio	GET /comprobantes/e/{id}
Necesitás una representación imprimible	GET /comprobantes/{id}/pdf