# Timbrado y Numeración (/docs/conceptos/timbrado-numeracion)



El **timbrado** autoriza al contribuyente a emitir documentos desde su fecha de inicio de vigencia. El timbrado electrónico no tiene fecha de fin. En Sifende lo cargás por ambiente: pruebas y producción tienen su propia configuración.

El manejo del timbrado y la numeración está en la sección 10.5 del [Manual Técnico V150](https://www.dnit.gov.py/web/e-kuatia/documentacion-tecnica).

## Cargar el timbrado [#cargar-el-timbrado]

Desde **Contribuyente → Timbrado**, elegí el **Ambiente del timbrado** y completá:

| Dato               | Qué cargar                           |
| ------------------ | ------------------------------------ |
| Número de timbrado | El número asignado para ese ambiente |
| Fecha de inicio    | La fecha exacta registrada en la SET |

Los establecimientos y puntos de expedición se envían en cada emisión. No forman parte de los datos que cargás con el timbrado. Seguí la [guía del panel](/docs/panel/timbrado) para cargarlo o actualizarlo.

## Establecimiento y punto de expedición [#establecimiento-y-punto-de-expedición]

El establecimiento identifica la sucursal. El punto de expedición identifica la caja o canal dentro de esa sucursal.

En la solicitud de emisión enviá `numeroEstablecimiento` y `puntoExpedicion` como enteros. Por ejemplo, para la segunda sucursal y su primera caja:

```json
{
  "numeroEstablecimiento": 2,
  "puntoExpedicion": 1
}
```

Este fragmento se agrega a los demás campos del [documento que vas a emitir](/docs/referencia/documentos-electronicos/emitir). Ambos campos son obligatorios.

## Numeración automática [#numeración-automática]

Por defecto, Sifende asigna el siguiente número al emitir. Si tu sistema ya numera sus comprobantes, usá la [numeración desde tu sistema](#numeración-desde-tu-sistema). La secuencia es independiente por contribuyente, ambiente, tipo de documento, establecimiento y punto de expedición.

El número formateado tiene tres partes:

<DesgloseCodigo
  separador="-"
  segmentos="[
{ valor: '002', nombre: 'Establecimiento', detalle: '3 dígitos' },
{ valor: '001', nombre: 'Punto de expedición', detalle: '3 dígitos' },
{ valor: '0000025', nombre: 'Número del documento', detalle: '7 dígitos' },
]"
/>

La respuesta de emisión incluye `numeroFormateado`. La consulta de estado devuelve `numeroDocumento` como un número entero.

## Numeración desde tu sistema [#numeración-desde-tu-sistema]

Si tu ERP o sistema de facturación asigna el número de cada comprobante, enviálo en la emisión y Sifende lo usa tal cual en lugar de asignar el siguiente. Estos campos son opcionales y se suman a los demás de la [solicitud de emisión](/docs/referencia/documentos-electronicos/emitir):

| Campo             | Tipo      | Descripción                                                                        |
| ----------------- | --------- | ---------------------------------------------------------------------------------- |
| `numeroDocumento` | `integer` | Número del documento, de 1 a 9.999.999. Activa la numeración desde tu sistema      |
| `codigoSeguridad` | `string`  | Código de seguridad de 9 dígitos. Si lo omitís, Sifende genera uno al azar         |
| `numeroTimbrado`  | `integer` | Timbrado con el que numera tu sistema. Sifende lo compara con el que tenés cargado |

```json
{
  "numeroEstablecimiento": 1,
  "puntoExpedicion": 3,
  "numeroDocumento": 1234,
  "codigoSeguridad": "123456789",
  "numeroTimbrado": 12345678
}
```

Enviá siempre `numeroTimbrado`: si tu sistema quedó configurado con otro timbrado, la emisión falla en el acto en lugar de generar documentos con un timbrado que no corresponde.

### Punto de expedición exclusivo [#punto-de-expedición-exclusivo]

Dedicá un punto de expedición a tu sistema y no emitas en él desde el panel ni desde la app. Mezclar ambas formas en un mismo punto está permitido: Sifende recuerda el número más alto que recibió, así que la numeración automática continúa después de los números de tu sistema. Pero si los dos numeran a la vez, tarde o temprano chocan, y el choque se informa como `409`.

### Reglas del número [#reglas-del-número]

* Un número solo puede pertenecer a un documento. Si ya lo usa uno aprobado, cancelado, en proceso o con error, la emisión responde `409` con [`document-number-in-use`](/docs/solucion-problemas/document-number-in-use) y el `cdc` del documento existente. Si tu sistema reintenta tras un corte de red, ese `cdc` te dice que el documento ya se emitió: consultá su estado en lugar de volver a emitir.
* Un número que ya inutilizaste ante SIFEN no se puede volver a usar: responde `409` con [`document-number-voided`](/docs/solucion-problemas/document-number-voided).
* Si enviás `numeroTimbrado` y no coincide con el timbrado cargado para el ambiente, responde `422` con [`timbrado-mismatch`](/docs/solucion-problemas/timbrado-mismatch). En `SANDBOX` no se compara: ese ambiente no usa tu timbrado.
* El CDC no incluye el ambiente: el mismo número, la misma fecha de emisión y el mismo `codigoSeguridad` generan el mismo CDC en `SANDBOX`, `DEV` y `PROD`, y un CDC solo puede existir una vez. Si repetís esos tres datos en otro ambiente, responde `409` con `document-number-in-use`: usá un `codigoSeguridad` distinto en cada ambiente, o no lo envíes y dejá que Sifende lo genere.
* Podés saltar números. SIFEN no exige que la numeración sea correlativa, solo que no se repita.

### Documentos rechazados [#documentos-rechazados]

Un número cuyo documento fue rechazado no se puede volver a emitir. La emisión responde `422` con [`document-number-requires-voiding`](/docs/solucion-problemas/document-number-requires-voiding) y el `cdc` del rechazado: [inutilizá el número](/docs/guias/inutilizar-numeracion) y emití el documento corregido con otro número.

## Rechazos y números sin utilizar [#rechazos-y-números-sin-utilizar]

Con la numeración automática, si corregís y volvés a emitir un documento rechazado, Sifende asigna un número y un CDC nuevos. El número del rechazado queda libre y se puede [inutilizar](/docs/guias/inutilizar-numeracion).

No reemitas un documento que sigue en proceso o está en `ERROR`. Consultá el [ciclo de vida](/docs/conceptos/ciclo-de-vida) antes de decidir qué hacer.

Si migrás desde otro sistema, [fijá el próximo número antes de emitir](/docs/panel/numeracion).

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

* [Timbrado en el panel](/docs/panel/timbrado).
* [Múltiples establecimientos](/docs/guias/multiples-establecimientos).
* [CDC](/docs/conceptos/cdc).
