Contribuyente
Qué es un contribuyente en Sifende — la entidad jurídica que emite documentos electrónicos.
Un contribuyente es la persona física o jurídica registrada ante la SET (Secretaría de Estado de Tributación) y la DNIT como facturador electrónico. Es la entidad que emite los documentos: la "razón social" que aparece en cada factura.
En Sifende, todo documento electrónico se emite a nombre de un contribuyente. Sin un contribuyente configurado no se pueden emitir documentos.
Datos básicos
Cada contribuyente en Sifende guarda estos datos:
| Campo | Descripción |
|---|---|
ruc | Número de RUC sin DV — ej. "80012345" |
digitoVerificador | Dígito verificador del RUC — ej. "1" |
razonSocial | Nombre o razón social registrado en SET |
nombreFantasia | Nombre comercial (opcional) |
actividadEconomica | Código CIIU principal (ej. 47190) |
email | Email de contacto |
direccion | Dirección fiscal del contribuyente |
departamento, distrito, ciudad | Geografía paraguaya |
El RUC se valida contra el padrón de SIFEN al crear el contribuyente. Si no existe o el dígito verificador no coincide, la creación falla con 404 ruc-not-found.
Componentes de un contribuyente
Más allá de los datos básicos, un contribuyente necesita tres elementos para emitir documentos:
1. Certificado digital P12
El certificado digital es la identidad criptográfica del contribuyente ante SIFEN. Es un archivo .p12 (PKCS#12) emitido por una autoridad certificadora habilitada en Paraguay (DOCUMENTA, eFirma, e-Forma, ID-Token, etc.).
Sifende guarda el certificado cifrado y lo usa automáticamente para firmar cada documento. Vos solo lo subís una vez desde el panel.
Contribuyente
└── Certificado P12 (cifrado en reposo)
└── Usado por Sifende para firmar cada DECuando el certificado está por vencer, recibís una notificación. Ver Certificado Digital para detalles operativos.
2. CSC (Código de Seguridad del Contribuyente)
El CSC es un código que genera e-kuatia (la plataforma oficial de la DNIT) y se usa para construir la URL del QR del KuDE. Cada contribuyente tiene su CSC, asignado al habilitarse como facturador electrónico.
El CSC no es secreto en el sentido criptográfico (viaja en el QR del KuDE), pero hace falta para que SIFEN valide los documentos.
3. Timbrado
El timbrado electrónico es la autorización numérica de la SET para emitir documentos. Cada timbrado tiene una validez (fechaInicio, fechaFin) y una numeración asignada por establecimiento. Ver Timbrado y Numeración.
Una cuenta, varios contribuyentes
Una sola cuenta de Sifende puede gestionar varios contribuyentes. Sirve para casos como:
- Estudios contables que facturan a nombre de varios clientes.
- Holdings con varias razones sociales bajo el mismo grupo.
- Desarrolladores que integran Sifende para varias empresas.
Cada contribuyente tiene su propio certificado, CSC, timbrado y API key. Son ambientes lógicamente independientes dentro de la misma cuenta.
Cuenta Sifende (usuario Keycloak)
├── Contribuyente A (RUC 80012345-1)
│ ├── Certificado A.p12
│ ├── Timbrado 12345678
│ └── API key sk_live_aaa...
├── Contribuyente B (RUC 80098765-3)
│ ├── Certificado B.p12
│ ├── Timbrado 87654321
│ └── API key sk_live_bbb...
└── Contribuyente C ...Crear un contribuyente
Desde el panel:
Una vez completados estos pasos, el contribuyente queda listo para emitir documentos electrónicos.
Próximos pasos
- Timbrado y Numeración: cómo se numeran los documentos.
- Autenticación: cómo se vincula la API key al contribuyente.
- Inicio Rápido: emitir tu primer documento.