Timbrado y Numeración
Qué es el timbrado electrónico, cómo se relaciona con los establecimientos y cómo se forma el número de documento.
Actualizado el
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.
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 para cargarlo o actualizarlo.
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:
{
"numeroEstablecimiento": 2,
"puntoExpedicion": 1
}Este fragmento se agrega a los demás campos del documento que vas a emitir. Ambos campos son obligatorios.
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. La secuencia es independiente por contribuyente, ambiente, tipo de documento, establecimiento y punto de expedición.
El número formateado tiene tres partes:
- 1002 · Establecimiento — 3 dígitos
- 2001 · Punto de expedición — 3 dígitos
- 30000025 · Número del documento — 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
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:
| 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 |
{
"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
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
- 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
409condocument-number-in-usey elcdcdel documento existente. Si tu sistema reintenta tras un corte de red, esecdcte 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
409condocument-number-voided. - Si enviás
numeroTimbradoy no coincide con el timbrado cargado para el ambiente, responde422contimbrado-mismatch. EnSANDBOXno 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
codigoSeguridadgeneran el mismo CDC enSANDBOX,DEVyPROD, y un CDC solo puede existir una vez. Si repetís esos tres datos en otro ambiente, responde409condocument-number-in-use: usá uncodigoSeguridaddistinto 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
Un número cuyo documento fue rechazado no se puede volver a emitir. La emisión responde 422 con document-number-requires-voiding y el cdc del rechazado: inutilizá el número y emití el documento corregido con otro número.
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.
No reemitas un documento que sigue en proceso o está en ERROR. Consultá el ciclo de vida antes de decidir qué hacer.
Si migrás desde otro sistema, fijá el próximo número antes de emitir.