Sifende
Conceptos

Contribuyente

Qué es un contribuyente en Sifende — la entidad jurídica que emite documentos electrónicos.

Actualizado el

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:

CampoDescripción
rucNúmero de RUC sin DV — ej. "80012345"
digitoVerificadorDígito verificador del RUC — ej. "1"
razonSocialNombre o razón social registrado en SET
nombreFantasiaNombre comercial (opcional)
actividadEconomicaCódigo CIIU principal (ej. 47190)
emailEmail de contacto
direccionDirección fiscal del contribuyente
departamento, distrito, ciudadGeografí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

Firma de cada DE

Sifende lo usa al emitir

Cuando 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. Configurá el IdCSC y el CSC de cada ambiente en el panel.

Guardá el CSC como una credencial y cargalo en el ambiente que corresponde. El certificado activo es el mismo para pruebas y producción.

3. Timbrado

El timbrado electrónico es la autorización numérica de la SET para emitir documentos. Cargá el número y las fechas de inicio y fin por ambiente. Los establecimientos y puntos se envían en cada emisión. 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

Contribuyente A

RUC 80012345-0

  • Certificado:Certificado A.p12
  • Timbrado:Timbrado 12345678
  • API key:sk_live_aaa…

Contribuyente B

RUC 80098765-9

  • Certificado:Certificado B.p12
  • Timbrado:Timbrado 87654321
  • API key:sk_live_bbb…
Más contribuyentes…

Crear un contribuyente

Desde el panel:

Andá a Contribuyente → Datos básicos y presioná Crear contribuyente. Se abre un asistente.
En Tu empresa, escribí el RUC y presioná Buscar. Completá los datos que falten (Teléfono, Email, el domicilio si falta y Actividades económicas) y presioná Continuar.
Cargá el Timbrado y el Código de seguridad (CSC).
Si querés, definí los Establecimientos y puntos; es un paso opcional.
Subí el Certificado P12 y su contraseña, y emití la Factura de prueba.

El asistente no crea la API key: generala aparte en API Keys (sk_test_ para DEV, sk_live_ para PROD o sk_sandbox_ para SANDBOX). Más detalles en API Keys.

Próximos pasos

En esta página

Usamos cookies necesarias para que el sitio funcione. Con tu permiso, también usamos herramientas de analítica para entender cómo se usa el sitio y para medir nuestras campañas publicitarias. Política de privacidad