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 el certificado de un prestador autorizado y los datos de habilitación de la SET. Esta página explica qué es cada uno y cómo conseguirlo.
Estos requisitos corresponden a DEV y PROD. Si todavía no tenés timbrado o CSC, podés usar SANDBOX con tu certificado activo, dirección y actividad económica.
Certificado Digital (PKCS12)
El certificado digital es el equivalente a tu firma electrónica. Sifende 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 el identificador de 4 caracteres y el código CSC de 32 caracteres de cada ambiente.
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 de vigencia y no tiene fecha de fin.
- Cargá su número y fecha de inicio por ambiente desde Contribuyente → Timbrado.
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:
- Usá el mismo certificado digital que vas a usar en producción.
- 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
- Fecha de inicio de vigencia del timbrado (
fechaInicio) - Número de establecimiento y punto de expedición
- API key
sk_test_y timbrado y CSC de pruebas
Una vez que tenés todo esto, seguí con Paso 1: Configurar tus credenciales.