Operación pdf

Objetivo

POST /pdf genera el PDF de un comprobante ya emitido.

Endpoint

POST /pdf

Cuándo usarlo

• descarga de representación impresa
• generación de adjuntos
• visualización posterior de comprobantes ya emitidos

Formas de localizar el comprobante

La forma más recomendada es por uuid.

Cuando no se dispone de uuid, el integrador debería conservar al menos:

• tipo_cfe
• serie
• numero
• cod_comercio
• cod_terminal

Campos de request

Ejemplo de request

curl -X POST http://127.0.0.1:18787/pdf \
  -H 'Content-Type: application/json' \
  -d '{
    "uuid": "venta-pos-000123",
    "impresora": "pdf",
    "variant": "personalizado",
    "fallback_copies": 1,
    "cod_comercio": "1",
    "cod_terminal": "1"
  }' \
  --output comprobante.pdf

Response esperada

Escenarios de error típicos

comprobante inexistente

Resultado esperado:

• no se obtiene PDF
• el endpoint debería rechazar la solicitud según la implementación del daemon

uuid no localizable

Resultado esperado:

• rechazo de la operación
• la aplicación debería revisar si persistió correctamente la referencia del comprobante emitido

contexto de ruteo incorrecto

Resultado esperado:

• imposibilidad de resolver el comprobante dentro del perfil indicado

plantilla o variante inexistente

Resultado esperado:

• error de generación de representación impresa

Recomendaciones

• usar siempre uuid si está disponible
• persistir uuid, serie y numero desde la emisión
• no mezclar generación de PDF con confirmación fiscal; el PDF presupone que el comprobante ya fue emitido