PDF de CFE emitido
Referencia tecnica del endpoint PDF de CFE emitido.
Descripcion
Genera y devuelve la representación impresa (PDF) de un CFE ya emitido. El comprobante puede identificarse por uuid o por la combinación tipo_cfe + serie + numero.
Es el equivalente cloud de POST /pdf del módulo local Tauri: mismo contrato de request, misma respuesta binaria.
Endpoint
- Metodo:
POST - Path:
/api/v1/cfeemitido/pdf
Autenticación
- JWT:
Authorization: Bearer <token> - API Key:
Authorization: ApiKey <key>— elidEmpresase deriva automáticamente de la clave
Campos de request
| Campo | Obligatoriedad | Descripción |
|---|---|---|
uuid | recomendado | Identificador externo del comprobante; alternativa a tipo_cfe + serie + numero |
tipo_cfe | condicional | Obligatorio si no se envía uuid |
serie | condicional | Obligatorio si no se envía uuid |
numero | condicional | Obligatorio si no se envía uuid |
variant | opcional | Variante o plantilla de representación impresa; si se omite usa la configurada en la empresa |
cod_comercio | opcional | Aceptado por compatibilidad con el módulo local; ignorado |
cod_terminal | opcional | Aceptado por compatibilidad con el módulo local; ignorado |
impresora | opcional | Aceptado por compatibilidad con el módulo local; ignorado |
fallback_copies | opcional | Aceptado por compatibilidad con el módulo local; ignorado |
Se debe enviar uuid, o bien los tres campos tipo_cfe + serie + numero. Si no se envía ninguno de los dos conjuntos, la solicitud es rechazada.
Response en éxito
- HTTP
200 Content-Type: application/pdf- Body: binario PDF de la representación impresa
En ambientes distintos de producción, el PDF incluye una marca de agua con el texto Representacion impresa de prueba sin valor fiscal.
Response en error
JSON con estructura:
{
"ok": false,
"error": "<descripción del error>"
}
| HTTP | Situación |
|---|---|
400 | Faltan campos de identificación o idEmpresa no resoluble |
403 | Sin permisos sobre la empresa o el CFE |
404 | CFE no encontrado |
500 | Error de generación del PDF |
Formas de identificar el comprobante
Por uuid (recomendado)
{ "uuid": "venta-pos-000123" }
Por folio
{
"tipo_cfe": 101,
"serie": "A",
"numero": 301
}
Plantilla de representación impresa
El campo variant controla la plantilla usada para generar el PDF:
- Si se omite, se usa el
FormatoRepImpresaconfigurado en la empresa (por defecto"Estandar"). - Si se envía, sobreescribe el formato de la empresa para esa solicitud.
Valores comunes: "Estandar", "Rollo", o el nombre de una plantilla personalizada configurada en la empresa.
Interoperabilidad con el módulo local
Este endpoint comparte el contrato de POST /pdf del módulo local Tauri, con estas diferencias:
| Aspecto | Módulo local (/pdf) | API REST (/cfeemitido/pdf) |
|---|---|---|
| Autenticación | Sin auth (localhost) | JWT o API Key |
impresora | Requerido (ej. "pdf") | Aceptado, ignorado |
fallback_copies | Funcional | Aceptado, ignorado |
idEmpresa | Derivado del perfil local | De la API Key o sesión |
| Error shape | {"ok": false, "error": "..."} | {"ok": false, "error": "..."} (idéntico) |
Recomendaciones
- Persistir siempre el
uuiden el momento de emisión para poder recuperar el PDF sin depender del folio. - No usar este endpoint para confirmar si un comprobante fue emitido; usarlo solo sobre CFEs cuya emisión ya fue confirmada (
CodigoRespuesta = "00"en/comprobante/firmarXmlo/comprobante/emitir).