Preguntas Frecuentes
Respuestas a las preguntas más frecuentes sobre Sifende, su integración con SIFEN y los planes de la plataforma.
Actualizado el
Qué es Sifende y en qué se diferencia de e-kuatia'i
Sifende es una plataforma API para integrar facturación electrónica en tu software, ERP o e-commerce. e-kuatia'i, en cambio, es la herramienta gratuita de la DNIT para emitir manualmente desde un navegador, dirigida a pequeños contribuyentes con un solo establecimiento y un único punto de expedición (fuente: DNIT).
Las diferencias principales:
- API REST: Sifende ofrece una integración programática vía JSON; e-kuatia'i no.
- Multi-establecimiento: Sifende permite establecimientos y puntos de expedición ilimitados; e-kuatia'i solo admite un establecimiento y un único punto de expedición.
- Volumen: e-kuatia'i está orientada a bajo volumen de emisión; Sifende envía los documentos por lotes, con reintentos automáticos ante errores transitorios.
- Integración con ERP o software propio: flujo automatizado en vez de carga manual.
- Soporte: Sifende ofrece soporte por WhatsApp y email en todos los planes; el plan MAX suma soporte prioritario. Ver Planes y precios.
Qué documentos electrónicos se pueden emitir
Sifende soporta:
- Factura Electrónica (FE): disponible
- Nota de Crédito Electrónica (NCE): disponible
- Nota de Débito Electrónica (NDE): disponible
- Nota de Remisión Electrónica (NRE): disponible
- Autofactura Electrónica (AFE): disponible
Todos los documentos se firman digitalmente y son rastreables por su CDC. DEV y PROD los envían a SIFEN; SANDBOX permite probar sin enviarlos.
Integrar Sifende no requiere saber SOAP ni XML
Solo necesitás hacer un POST con JSON a la API REST. Sifende se encarga del resto:
- Genera el XML según el Manual Técnico V150.
- Firma con tu certificado P12.
- Envía el documento a SIFEN.
- Consulta los resultados.
Tu equipo trabaja con JSON; Sifende absorbe toda la complejidad de SOAP, XSD y firma digital.
Cómo se maneja el certificado digital P12
Lo subís una sola vez desde el panel web. Sifende lo almacena de forma segura (cifrado en reposo) y lo usa automáticamente para firmar cada documento. Cuando esté próximo a vencer, recibís una notificación.
Si tu certificado tiene problemas, mirá Certificado Digital.
Qué pasa si el servidor de la DNIT está caído
Sifende reintenta automáticamente los errores transitorios. Si el documento termina en ERROR, detené el polling y seguí la guía para reintentar el lote o contactá a soporte; no lo reemitas.
Mientras SIFEN no responde, los documentos quedan en cola y se reintentan; tu sistema conserva el CDC y consulta el resultado cuando se restablece el servicio.
Cuánto lleva integrar Sifende
Una integración básica se completa en horas, no en semanas. Solo necesitás hacer un POST HTTP con JSON.
Para validar sin compromiso:
- El plan gratuito permite pruebas sin límite. El cupo, el precio, los adicionales y el período de acceso a los documentos de cada plan y de cada pack están en Planes y precios.
- Todos los planes tienen acceso al ambiente de pruebas de SIFEN.
Andá al Inicio Rápido para emitir tu primer documento.
Ambiente de sandbox
Usá una clave sk_sandbox_ para probar emisión, KuDE y notificaciones sin enviar documentos a SIFEN. Necesitás los datos del emisor; Sifende proporciona el timbrado y el CSC de prueba, y firma con un certificado de prueba si todavía no cargaste el tuyo. Los documentos no tienen validez fiscal y no admiten cancelación, inutilización ni nominación.
Para probar respuestas y rechazos de SIFEN, usá DEV con una clave sk_test_. Para producción, creá una clave sk_live_ cuando cumplas sus requisitos. El certificado es el mismo y la URL base no cambia. Consultá Ambientes e Ir a Producción.
Usar Sifende sin el timbrado listo
Podés probar en SANDBOX: Sifende proporciona el timbrado y el CSC de prueba, y firma con un certificado de prueba si todavía no tenés el tuyo. Necesitás dirección y actividad económica. Para enviar documentos a SIFEN en DEV o PROD, cargá el timbrado y el CSC de ese ambiente.
Precios, IVA y contratos
- Los precios incluyen IVA. Se facturan en guaraníes (PYG).
- Sin contratos a largo plazo en planes mensuales: se cancelan cuando quieras.
- El plan gratuito no vence ni pide tarjeta, pero no emite en producción: sirve para probar la integración sin límite.
- Los packs de documentos se compran una vez y no generan suscripción.
- Los planes a convenir se rigen por un contrato con condiciones negociadas.
Detalle completo en Planes y precios.
Qué reglas aplica Sifende
Sifende genera y firma los documentos según el Manual Técnico de SIFEN. La API valida los datos de la solicitud y devuelve el resultado que informa SIFEN.
Límite de consultas por minuto
La consulta al padrón admite 60 consultas por minuto por API key y 120 por contribuyente. Si recibís 429 rate-limit-exceeded, esperá el intervalo de Retry-After. Ver Padrón.
SDKs oficiales
Sifende publica @sifende/sdk en npm para TypeScript y JavaScript, y el SDK para Go. También hay un CLI en Python y un servidor MCP. Para otros lenguajes, generá un cliente desde la especificación OpenAPI.
Especificación OpenAPI
Descargá la especificación OpenAPI 3.1 desde https://sifende.com.py/openapi/v1.json o consultá OpenAPI y JSON Schema.
Cómo facturar a una empresa extranjera
Usá tipoDocumento: "PASAPORTE" (o "CARNET_DE_RESIDENCIA" para residentes, "CEDULA_EXTRANJERA" cuando aplique) para el receptor extranjero, junto con monedaOperacion en la moneda correspondiente y pais con el código ISO del país.
Los valores aceptados para tipoDocumento son: CEDULA_PARAGUAYA, PASAPORTE, CEDULA_EXTRANJERA, CARNET_DE_RESIDENCIA, INNOMINADO, TARJETA_DIPLOMATICA, OTRO. Consultá Enumeraciones para la referencia completa.
Ver Moneda Extranjera.