Paso 1: Configurar Credenciales
Subí tu certificado digital, configurá el timbrado y obtené tu API key para empezar a emitir documentos.
En este paso vas a configurar todo lo que hace falta en Sifende para hacer tu primera llamada a la API.
1.1 Crear tu cuenta y contribuyente
Si es tu primera vez, ingresá a app.sifende.com.py y creá tu cuenta. Después, creá un Contribuyente.
Llená la información que pide: RUC, datos básicos, datos de contacto, ubicación fiscal y actividades económicas.
1.2 Subir el certificado digital
Desde el panel de Sifende, andá a Contribuyente → Certificado digital y subí tu archivo PKCS12 junto con la contraseña. Cargá el IdCSC y el CSC del ambiente de pruebas según la guía del panel.
1.3 Configurar el timbrado
Desde Contribuyente → Timbrado, elegí el ambiente de pruebas e ingresá la fecha de inicio de tu timbrado. El número se completa solo con tu RUC.
Si estás en el ambiente de pruebas:
- Número de Timbrado: el panel lo completa con tu RUC sin dígito verificador, rellenado con ceros a la izquierda hasta 8 dígitos. No lo podés editar.
- Fecha de Inicio: la fecha en que tu Formulario 364 quedó "Aceptado" (debe coincidir exactamente con la de SET, o vas a recibir el rechazo
1107).
Estos datos tienen que coincidir con el dataset que SET provisiona al habilitarte. Ver El ambiente de prueba (TEST).
1.4 Crear tu API key
Desde API Keys, seleccioná Crear API Key y elegí DEV — Pruebas con SIFEN. Guardá el valor generado: no se muestra de nuevo.
# Te recomendamos guardar tu API Key, la vas a usar en los próximos pasos.
export SIFENDE_API_KEY="sk_test_..."¿Querés probar tu API key en segundos? La Sifende CLI te deja emitir tu primer documento con 3 comandos, sin escribir código.
Tu API key tiene permisos completos para el contribuyente. Tratala como una contraseña: nunca la incluyas en el código fuente ni en repositorios públicos.
Cuando esté todo listo, seguí con Paso 2: Tu primera Factura Electrónica.
Requisitos Previos
Qué necesitás tener antes de integrar Sifende — certificado digital, CSC, timbrado electrónico y ambiente de pruebas.
Paso 2: Tu Primera Factura Electrónica
Emití tu primera factura electrónica con un POST a la API de Sifende, interpretá la respuesta con el CDC y corregí los errores más comunes.