# Contribuyente (/docs/conceptos/contribuyente)



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 [#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                     |

<Callout type="info">
  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`.
</Callout>

## Componentes de un contribuyente [#componentes-de-un-contribuyente]

Más allá de los datos básicos, un contribuyente necesita tres elementos para emitir documentos:

### 1. Certificado digital P12 [#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.

<Cadena
  pasos="[
{ titulo: 'Contribuyente' },
{ titulo: 'Certificado P12', detalle: 'Cifrado en reposo' },
{ titulo: 'Firma de cada DE', detalle: 'Sifende lo usa al emitir' },
]"
/>

Cuando el certificado está por vencer, recibís una notificación. Ver [Certificado Digital](/docs/solucion-problemas/certificado-digital) para detalles operativos.

### 2. CSC (Código de Seguridad del Contribuyente) [#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](/docs/panel/certificado-y-csc).

<Callout type="info">
  Guardá el CSC como una credencial y cargalo en el ambiente que corresponde. El certificado activo es el mismo para pruebas y producción.
</Callout>

### 3. Timbrado [#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](/docs/conceptos/timbrado-numeracion).

## Una cuenta, varios contribuyentes [#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.

<EstructuraCuenta
  contribuyentes="[
{ nombre: 'Contribuyente A', ruc: '80012345-0', certificado: 'Certificado A.p12', timbrado: 'Timbrado 12345678', apiKey: 'sk_live_aaa…' },
{ nombre: 'Contribuyente B', ruc: '80098765-9', certificado: 'Certificado B.p12', timbrado: 'Timbrado 87654321', apiKey: 'sk_live_bbb…' },
]"
/>

## Crear un contribuyente [#crear-un-contribuyente]

Desde el panel:

<Steps>
  <Step>
    Andá a 

    **Contribuyente → Datos básicos**

     y presioná 

    **Crear contribuyente**

    . Se abre un asistente.
  </Step>

  <Step>
    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**

    .
  </Step>

  <Step>
    Cargá el 

    **Timbrado**

     y el 

    **Código de seguridad (CSC)**

    .
  </Step>

  <Step>
    Si querés, definí los 

    **Establecimientos y puntos**

    ; es un paso opcional.
  </Step>

  <Step>
    Subí el 

    **Certificado**

     P12 y su contraseña, y emití la 

    **Factura de prueba**

    .
  </Step>
</Steps>

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](/docs/panel/api-keys).

## Próximos pasos [#próximos-pasos]

* [Timbrado y Numeración](/docs/conceptos/timbrado-numeracion): cómo se numeran los documentos.
* [Autenticación](/docs/conceptos/autenticacion): cómo se vincula la API key al contribuyente.
* [Inicio Rápido](/docs/inicio-rapido): emitir tu primer documento.
