Facturas, notas y remisiones
Factura electrónica, nota de crédito (total, por ítems o por monto), nota de débito y nota de remisión para mercadería en tránsito. Cada tipo con su propia numeración.
FacturaNota de créditoNota de débitoNota de remisión
API de facturación parasistemas de gestión, tiendas online, puntos de venta, ERP a medida y apps móviles
Facturación electrónica en Paraguay, directo a SIFEN.
Emite facturas, notas de crédito y notas de remisión electrónicas con una sola llamada a una API REST. Tiendy Factu numera, firma el XML con tu certificado y lo envía a la DNIT, sin intermediarios.
Ambiente de prueba incluido · Conexión directa con SIFEN · Documentado con OpenAPI
- tipos de documento electrónico
- 4
- eventos notificados por webhook
- 11
- intermediarios entre tu RUC y SIFEN
- 0
- Manual Técnico SIFEN implementado
- v150
Una factura electrónica válida exige XML firmado, numeración sin saltos, timbrado vigente, envío a SIFEN y seguimiento de cada respuesta. Tu sistema solo envía los datos de la venta. Del resto se ocupa Tiendy Factu.
De tu venta a un documento aprobado por la DNIT, en cuatro pasos.
Tu sistema habla con una API REST. Tiendy Factu habla con SIFEN, el Sistema Integrado de Facturación Electrónica Nacional, con el certificado de tu propio RUC.
01 Conecta tu RUC
Carga los datos fiscales, el timbrado, tus establecimientos y puntos de expedición, y sube el certificado digital .p12 con su CSC. Queda cifrado y el panel te indica qué falta para poder emitir.
02 Envía la venta por API
Un POST /v1/documents con el receptor, los ítems, la condición y el pago. La API valida todo antes de tomar un número, asigna la numeración y el CDC, y responde de inmediato con202.
03 Tiendy Factu firma y envía a SIFEN
El documento entra en una cola persistente. Un proceso dedicado arma el XML, lo firma con tu certificado, lo envía a los servicios de la DNIT y consulta el resultado hasta tener una respuesta definitiva.
04 Recibe el resultado y el KuDE
Un webhook firmado avisa a tu sistema si el documento fue aprobado o rechazado, con el motivo de SIFEN. El KuDE en PDF queda listo para descargar y el XML firmado, archivado.
Todo el ciclo del documento electrónico, no solo la emisión.
Emitir es el primer paso. Corregir, anular, reintentar y avisar a tu sistema también están resueltos.
Cancelación, inutilización y nominación
Cancela un documento aprobado, inutiliza rangos de numeración y nomina una factura innominada. Cada documento informa qué acciones admite en ese momento y por qué.
Webhooks firmados
Once eventos, desde document.approved hastainutilization.rejected. Firma HMAC-SHA256, reintentos escalonados durante 24 horas y reenvío manual de cualquier entrega.
KuDE en PDF con tu marca
La representación gráfica del documento, en A4, con el código QR y el CDC, generada desde el XML firmado y archivado. Define el color de acento y el pie de página de cada RUC.
Certificados bajo llave
El certificado, su contraseña y el CSC se guardan cifrados con AES-256-GCM y solo se abren para la llamada a SIFEN que los necesita. De cada API key se guarda únicamente su hash.
Varios RUC, prueba y producción
Una cuenta administra todos los RUC que necesites, cada uno con sus establecimientos, puntos de expedición y timbrado. Cada RUC empieza en el ambiente de prueba de SIFEN y pasa a producción cuando está listo.
Una API REST predecible para integrar en una tarde.
Sin SOAP, sin firmar XML a mano y sin estudiar el Manual Técnico. JSON de entrada, JSON de salida y errores que dicen qué corregir.
- Reintentos seguros. Con Idempotency-Key la misma venta nunca consume dos números.
- Especificación OpenAPI. Publicada en/openapi.json para generar tu cliente.
- Errores legibles. Un código estable para tu sistema y un mensaje en español para la persona.
- Validación previa. Certificado vencido, punto inactivo o RUC incompleto se rechazan antes de tomar un número.
curl https://api-factu.tiendy.com.py/v1/documents -H "Authorization: Bearer $FACTU_API_KEY" -H "Idempotency-Key: pedido-4821" -H "Content-Type: application/json" -d '{ "expeditionPointId": "ID_DEL_PUNTO_DE_EXPEDICION", "receptor": { "kind": "RUC", "taxId": "80012345-0", "name": "Ferretería Don Bosco S.A." }, "items": [ { "description": "Taladro percutor 650 W", "quantity": 2, "unitPrice": 420000, "ivaRate": "IVA_10" } ], "condition": "CONTADO", "payment": { "method": "TRANSFER" }, "externalReference": "pedido-4821" }'
# Numerado y en cola para SIFEN HTTP/1.1 202 Accepted { "document": { "id": "ID_DEL_DOCUMENTO", "status": "QUEUED", "documentType": "FACTURA", "number": "001-001-0004821", "cdc": "01800123456001001000004821202611111234567890", "externalReference": "pedido-4821" } } # Después: KuDE en PDF, cuando SIFEN lo aprueba GET /v1/documents/ID_DEL_DOCUMENTO/kude
# Tiendy Factu llama a tu endpoint HTTPS POST https://tu-sistema.com/webhooks/factu X-Factu-Event-Id: ID_DEL_EVENTO X-Factu-Delivery-Id: ID_DE_LA_ENTREGA X-Factu-Timestamp: 1794526800 X-Factu-Signature: v1=BASE64_HMAC_SHA256 { "id": "ID_DEL_EVENTO", "type": "document.approved", "createdAt": "2026-11-12T14:20:00Z", "data": { "document": { "status": "APPROVED", "number": "001-001-0004821" } } } # Responde 2xx. Si no, se reintenta: 1 min, 5 min, 30 min, 2 h…
Cada documento y su estado ante SIFEN, en un solo lugar.
Configura tus RUC, crea API keys y webhooks, y consulta lo emitido con filtros por estado, tipo y referencia. La emisión se hace por API. El control, desde el panel.
DocumentosFerretería Don Bosco S.A. · 80012345-0
Ambiente de prueba| Número | Tipo | Receptor | Total | Estado |
|---|---|---|---|---|
| 001-001-0004821 | Factura | Constructora Itá S.R.L. | G. 935.000 | Aprobado |
| 001-001-0004820 | Factura | María Benítez | G. 1.840.000 | En proceso |
| 001-001-0000312 | Nota de crédito | Constructora Itá S.R.L. | G. 95.000 | Aprobado |
| 001-001-0004819 | Factura | Agroservicios del Este S.A. | G. 4.250.000 | Rechazado · RUC del receptor inexistente |
| 001-001-0000087 | Nota de remisión | Depósito Luque | Sin monto | Cancelado |
Pagas por los documentos que emites.
El uso se cuenta por documento emitido en cada mes calendario. Los documentos del ambiente de prueba se miden por separado.
[PLAN INICIAL]
[PRECIO] / mes
Hasta [CANTIDAD] documentos por mes.
Crear cuenta[PLAN NEGOCIO]
[PRECIO] / mes
Hasta [CANTIDAD] documentos por mes.
Crear cuenta[PLAN VOLUMEN]
A medida
Para integradores y software con muchos RUC.
Hablar con ventasFacturación electrónica en Paraguay, sin vueltas.
Lo que conviene saber antes de integrar SIFEN a tu sistema.
¿Qué es la facturación electrónica y qué es SIFEN?
SIFEN es el Sistema Integrado de Facturación Electrónica Nacional de la DNIT. Un documento electrónico es un archivo XML firmado digitalmente por el contribuyente y validado por SIFEN, que le asigna validez tributaria. Su representación impresa o en PDF se llama KuDE.
¿Qué necesito para empezar a emitir?
Un RUC habilitado como facturador electrónico, un timbrado vigente, tu certificado digital en formato .p12 y el código de seguridad del contribuyente (CSC). Con eso cargado, registras al menos un establecimiento con un punto de expedición y ya puedes emitir.
¿Tiendy Factu es un intermediario ante la DNIT?
No. Tiendy Factu se conecta directamente a los servicios web de SIFEN y firma cada documento con el certificado de tu propio RUC. Los documentos se emiten a tu nombre, con tu timbrado y tu numeración.
¿Qué documentos electrónicos puedo emitir?
Factura electrónica (a un RUC, a una cédula o innominada), nota de crédito, nota de débito y nota de remisión. También puedes cancelar documentos aprobados, inutilizar numeración y nominar facturas innominadas.
¿Cómo sé si SIFEN aprobó un documento?
De dos formas. Tu sistema recibe un webhook firmado cuando el documento es aprobado o rechazado, y en cualquier momento puedes consultar su estado, la última respuesta de SIFEN y su historial completo por API o desde el panel.
¿Puedo probar antes de emitir en producción?
Sí. Cada RUC se registra por defecto en el ambiente de prueba de SIFEN, donde los documentos no tienen validez tributaria. Cuando la integración está lista, cambias el RUC a producción y cargas el timbrado de producción.
¿Cómo se protege mi certificado digital?
El certificado, su contraseña y el CSC se almacenan cifrados con AES-256-GCM y se abren únicamente para la llamada a SIFEN que los requiere. La contraseña y el CSC nunca se devuelven por la API, y una copia de la base de datos por sí sola no permite abrir ningún certificado.
¿Necesito un equipo técnico para usarlo?
La emisión se hace por API, así que tu sistema de gestión, tienda online o punto de venta debe integrarse una vez. La configuración de RUC, certificados, API keys y webhooks, y la consulta de documentos, se hacen desde el panel web sin escribir código.
Tu primera factura electrónica de prueba, hoy mismo.
Crea tu cuenta, registra tu RUC en el ambiente de prueba y emite contra SIFEN antes de escribir una sola línea de XML.