# Preguntas Frecuentes (/docs/solucion-problemas/faq)



## Qué es Sifende y en qué se diferencia de e-kuatia'i [#qué-es-sifende-y-en-qué-se-diferencia-de-e-kuatiai]

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](https://www.dnit.gov.py/web/e-kuatia/ekuatia-i)).

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](/docs/plataforma/planes).

## Qué documentos electrónicos se pueden emitir [#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 [#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:

1. Genera el XML según el Manual Técnico V150.
2. Firma con tu certificado P12.
3. Envía el documento a SIFEN.
4. 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 [#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](/docs/solucion-problemas/certificado-digital).

## Qué pasa si el servidor de la DNIT está caído [#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](/docs/panel/lotes) 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 [#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](/docs/plataforma/planes).
* Todos los planes tienen acceso al ambiente de pruebas de SIFEN.

Andá al [Inicio Rápido](/docs/inicio-rapido) para emitir tu primer documento.

## Ambiente de sandbox [#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](/docs/conceptos/ambientes) e [Ir a Producción](/docs/guias/ir-a-produccion).

## Usar Sifende sin el timbrado listo [#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 [#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](/docs/plataforma/planes).

## Qué reglas aplica Sifende [#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 [#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](/docs/referencia/padron).

## SDKs oficiales [#sdks-oficiales]

Sifende publica [`@sifende/sdk`](https://www.npmjs.com/package/@sifende/sdk) en npm para TypeScript y JavaScript, y el [SDK para Go](https://github.com/ithdev/sifende-go). También hay un [CLI en Python](/docs/herramientas/sifende-cli) y un [servidor MCP](https://github.com/ithdev/sifende-mcp). Para otros lenguajes, generá un cliente desde la [especificación OpenAPI](/docs/referencia/openapi).

## 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](/docs/referencia/openapi).

## Cómo facturar a una empresa extranjera [#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.

<Callout type="info">
  Los valores aceptados para `tipoDocumento` son: `CEDULA_PARAGUAYA`, `PASAPORTE`, `CEDULA_EXTRANJERA`, `CARNET_DE_RESIDENCIA`, `INNOMINADO`, `TARJETA_DIPLOMATICA`, `OTRO`. Consultá [Enumeraciones](/docs/referencia/enumeraciones#receptortipodocumento) para la referencia completa.
</Callout>

Ver [Moneda Extranjera](/docs/guias/moneda-extranjera).
