Descargar KuDE en ticket
GET /api/v1/documento-electronico/:cdc/kude/ticket — el KuDE en cinta de papel de 80 o 58 mm, en PDF o como imagen para impresoras térmicas ESC/POS.
El KuDE en cinta de papel es la representación gráfica del documento para impresoras térmicas de punto de venta, según el formato de cinta del Manual Técnico de SIFEN (sección 13.6). Está disponible para facturas (FE), notas de crédito (NCE) y notas de débito (NDE).
El ticket se genera en cada pedido a partir del XML firmado, así que siempre responde 200 con el archivo o un error: no hay 202 ni polling como en el KuDE A4. El KuDE A4 sigue siendo el que se guarda y se envía por email.
GET /api/v1/documento-electronico/:cdc/kude/ticket
Devuelve el ticket en PDF: una sola página del ancho del papel y del alto del contenido. Para imprimirlo desde el navegador o el sistema operativo, elegí la impresora térmica y el tamaño de papel correspondiente.
Autenticación
Authorization: Bearer {api-key} — requerido
Query parameters
| Parámetro | Tipo | Default | Descripción |
|---|---|---|---|
ancho | integer | 80 | Ancho del papel en mm: 80 o 58 |
resumen | boolean | false | Ticket resumen (sección 13.7): sin detalle de ítems ni de impuestos, con la cantidad de ítems, los totales y la liquidación del IVA. Se entrega cuando el cliente lo pide |
Respuesta
200 OK — Content-Type: application/pdf, Content-Disposition: inline; filename="{cdc}-ticket.pdf" y Cache-Control: no-store.
GET /api/v1/documento-electronico/:cdc/kude/ticket/imagen
Devuelve el mismo ticket como PNG de 1 bit con el ancho exacto de una línea de la impresora a 203 dpi. Está pensado para imprimir directo por ESC/POS con el comando de imagen ráster GS v 0, que soportan casi todas las térmicas, sin depender de páginas de códigos para las tildes ni del comando de QR de cada impresora.
Query parameters
| Parámetro | Tipo | Default | Descripción |
|---|---|---|---|
puntos | integer | 576 | Puntos por línea de la impresora: 576 o 512 para papel de 80 mm, 384 para 58 mm |
resumen | boolean | false | Igual que en el PDF |
Respuesta
200 OK — Content-Type: image/png, Content-Disposition: inline; filename="{cdc}-ticket.png" y Cache-Control: no-store.
Si no sabés cuántos puntos tiene tu impresora, la hoja de autotest que imprime al encenderla con el botón de avance apretado suele indicarlo. Con 512 el ticket entra en cualquier impresora de 80 mm.
Errores
| Status | Tipo | Descripción |
|---|---|---|
| 400 | invalid-format | ancho o puntos con un valor no admitido |
| 403 | document-archived | El período de acceso del plan actual finalizó |
| 404 | documento-electronico-not-found | Documento no encontrado o no accesible para esta clave |
| 500 | kude-generation-error | Error técnico al generar el ticket |
| 501 | kude-not-supported | El tipo de documento no tiene ticket: autofacturas y notas de remisión sólo tienen KuDE A4 |
Ejemplo
curl -sS -f -o ticket.pdf \
"https://api.sifende.com.py/api/v1/documento-electronico/$CDC/kude/ticket?ancho=80" \
-H "Authorization: Bearer $SIFENDE_API_KEY"Para imprimir por ESC/POS, ver la guía Imprimir el ticket en una impresora térmica.
Descargar KuDE
GET /api/v1/documento-electronico/:cdc/kude — descargá el KuDE (comprobante) en PDF o seguí la preparación asincrónica cuando todavía no está disponible.
Descargar XML
GET /api/v1/documento-electronico/:cdc/xml — descargá el XML firmado del documento, con el código QR, tal como se envió a SIFEN.