Requisitos Previos
Qué necesitás tener antes de integrar Sifende — certificado digital, CSC, timbrado electrónico y ambiente de pruebas.
Antes de emitir tu primer documento electrónico con Sifende, necesitás obtener algunos datos directamente de la SET (Subsecretaría de Estado de Tributación). Esta página explica qué es cada uno y cómo conseguirlo.
Certificado Digital (PKCS12)
El certificado digital es el equivalente a tu firma electrónica. SIFEN lo usa para firmar cada documento electrónico que emitís.
¿Qué necesitás?
- Un archivo
.p12o.pfx(formato PKCS12). - La contraseña del certificado.
¿Cómo obtenés el certificado?
- Solicitalo a un prestador de servicios de certificación autorizado. La lista oficial vigente está en acraiz.gov.py — son empresas privadas habilitadas por el Estado para emitir certificados digitales con validez legal.
- El proceso incluye verificación presencial o digital de tu identidad y de tu RUC según el tipo de contribuyente.
- El prestador te entrega el archivo
.p12(o.pfx) y la contraseña que vas a usar en Sifende.
El certificado tiene fecha de vencimiento. Sifende te avisa cuando se acerca el vencimiento, pero renovarlo a tiempo queda de tu lado.
CSC (Código de Seguridad del Contribuyente)
La SET asigna a cada contribuyente un identificador de 4 caracteres y un código CSC de 32 caracteres para generar el código QR del KuDE.
¿Cómo obtenés el CSC?
- Se solicita junto con la habilitación como facturador electrónico en la SET.
- Configurá en Sifende tanto el identificador de 4 caracteres como el código CSC de 32 caracteres.
Timbrado Electrónico
El timbrado es la habilitación de la SET para emitir documentos. El timbrado electrónico (e-timbrado) es distinto al timbrado tradicional en papel: es específico para documentos electrónicos.
¿Cómo obtenés el timbrado electrónico?
- Se solicita a través de Marangatu una vez que estás habilitado como facturador electrónico.
- Tiene una fecha de inicio y fecha de fin de vigencia.
- Un timbrado es válido para un establecimiento y punto de expedición específico.
Si ya tenés timbrado para documentos en papel, no es el mismo. Necesitás solicitar un timbrado electrónico aparte.
Ambiente de Pruebas (QA)
Antes de ir a producción, podés probar tu integración en el ambiente de pruebas de SIFEN.
Credenciales de prueba:
- La SET provee certificados de prueba para el ambiente QA. Consultá la documentación de SIFEN o contactá a soporte para obtenerlos.
- Los timbrados de prueba son distintos a los de producción.
- Las RUCs de receptores también tienen valores de prueba definidos por la SET.
Para emitir en el ambiente de prueba, tu RUC tiene que estar habilitado como facturador electrónico (Formulario 364) y SET provisiona un dataset de prueba con una convención fija (timbrado = tu RUC sin DV, establecimiento 001, puntos 001/002/003, CSC genéricos). Ver El ambiente de prueba (TEST).
Checklist antes de integrar
- Certificado digital PKCS12 + contraseña
- Identificador de 4 caracteres y código CSC de 32 caracteres
- Número de timbrado electrónico
- Fechas de vigencia del timbrado (
fechaInicio,fechaFin) - Número de establecimiento y punto de expedición
- Credenciales de ambiente QA (para pruebas)
Una vez que tenés todo esto, seguí con Paso 1: Configurar tus credenciales.