PDF del comprobante

Genera (la primera vez) y devuelve la URL del PDF de un comprobante ya emitido con WSFEv1. El PDF incluye los datos fiscales, el CAE y el código QR de ARCA.

Podés pedirlo en dos formatos de representación impresa: hoja (A4/Carta, el formato oficial de ARCA) y tique de 80 mm para impresora térmica.

Endpoint

POST /api/wsfe/comprobante/pdf

El comprobante se identifica por la misma tupla que el resto de la API: environment, representada, ptoVta, cbteTipo y cbteNro.

Request

curl -X POST https://arca.api.com.ar/api/wsfe/comprobante/pdf \
  -H "Authorization: Bearer ak_TuSecretoAqui" \
  -H "Content-Type: application/json" \
  -d '{
    "environment": "homologacion",
    "representada": "27111111118",
    "ptoVta": 1,
    "cbteTipo": 6,
    "cbteNro": 42
  }'

Tique de 80 mm

curl -X POST https://arca.api.com.ar/api/wsfe/comprobante/pdf \
  -H "Authorization: Bearer ak_TuSecretoAqui" \
  -H "Content-Type: application/json" \
  -d '{
    "environment": "homologacion",
    "representada": "27111111118",
    "ptoVta": 1,
    "cbteTipo": 6,
    "cbteNro": 42,
    "formato": "tique"
  }'

Respuesta

{
  "pdfUrl": "https://cdn.api.com.ar/3f9a…c2.pdf"
}

Formato tique (80 mm)

El tique es una representación gráfica alternativa del mismo comprobante: una Factura B pedida en tique sigue siendo una Factura B, con la misma letra, el mismo código, el mismo CAE y el mismo QR. No se emite ni se registra un comprobante distinto.

• 80 mm de ancho (el mínimo que el Anexo IV de la RG 1415 le exige a un tique) y alto variable según el contenido, con un piso de 50 mm: el rollo es continuo y no se pagina.
• Blanco y negro puro, sin grises ni fondos: el cabezal térmico es binario y cualquier tono intermedio se trama y sale sucio.
• Lleva todos los datos fiscales del PDF de hoja —emisor, receptor con su condición frente al IVA, tipo, letra y código, punto de venta y número, fecha, ítems, totales, CAE con su vencimiento y el QR— reordenados en una sola columna. No lleva el recuadro grande de la letra, que es del modelo Factura y ningún tique usa.
• Sólo para comprobantes de mercado interno (WSFEv1). El endpoint de WSFEX devuelve siempre el formato de hoja: imprimir una factura de exportación en térmica no tiene caso de uso.
• Al imprimirlo, mandá el PDF al papel a escala 1:1 (sin "ajustar a la página"): el documento ya viene del ancho exacto del rollo.

Cómo funciona

• Generación perezosa (lazy): el PDF se genera la primera vez que lo pedís y se cachea. Las llamadas siguientes devuelven la misma URL sin volver a renderizar.
• Un cache por formato: la hoja y el tique del mismo comprobante son dos archivos con dos URLs distintas. Pedir uno no genera ni reemplaza al otro.
• El PDF generado no se regenera: una vez que existe, su URL y su contenido quedan fijos. Un cambio posterior en el diseño del CUIT, en el plan de tu cuenta o en los defaults del sistema aplica sólo a comprobantes nuevos o todavía sin renderizar.
• URL permanente y no adivinable: cada PDF vive en https://cdn.api.com.ar/<hash>.pdf con un hash aleatorio. El link es la llave: es público pero imposible de adivinar, y lo sirve el CDN directamente (la descarga no pasa por la API).
• Desacoplado de la emisión: emitir un comprobante nunca depende del PDF. Si el generador está caído, la factura se emite igual y el PDF se puede pedir después.

Diseño del PDF

El diseño se configura por CUIT desde el dashboard, en Diseño de PDF: logo, colores, texto de footer, tamaño de hoja (A4/Carta) y márgenes. Lo que configurás ahí se aplica automáticamente al generar el PDF de cualquier comprobante de ese CUIT. Si un CUIT no configuró nada, se usa un diseño por defecto. Podés previsualizar el resultado en vivo —en hoja y en tique— y descargar un PDF de muestra antes de emitir.

El tamaño de hoja y los márgenes describen la hoja: el tique los ignora, porque su ancho lo fija el rollo. La identidad del emisor (logo, nombre de fantasía, datos fiscales) sí se aplica a los dos.

Marca del servicio

Los PDFs llevan al pie la línea "Emitido con arca.api.com.ar", en los dos formatos. El plan enterprise no la lleva. Como el PDF es inmutable, vale el plan al momento de generarlo: subir a enterprise no le saca la marca a los comprobantes que ya tenían PDF.

Errores