Evento Inutilización

El evento de Inutilización permite dar de baja números de documentos que el sistema pudo haber salteado o que no fueron utilizados. Es útil para mantener la secuencia correcta de numeración.

Tipo de Evento

Para Inutilización, el campo tipoEvento debe ser 1

Casos de Uso

Salto de Numeración

Cuando se saltaron números en la secuencia de documentos

Error de Sistema

Si hubo un error y se generaron números sin usar

Documentos Descartados

Para anular números reservados pero no emitidos

Parámetros del JSON

tipoEvento integer Requerido

Debe ser 1 para Inutilización

timbrado string Requerido

Número de timbrado de los documentos a inutilizar

tipoDoc string Requerido

Tipo de documento: "1" = Factura, "4" = Autofactura, "5" = Nota de Crédito, "7" = Nota de Remisión. Ver tabla iTiDE

establecimiento string Requerido

Código del establecimiento (3 dígitos)

punto string Requerido

Punto de expedición (3 dígitos)

desde string Requerido

Número inicial del rango a inutilizar (7 dígitos). Si es un solo número, desde y hasta deben ser iguales

hasta string Requerido

Número final del rango a inutilizar (7 dígitos). Máximo 1000 números por solicitud

motivo string Requerido

Descripción del motivo de la inutilización

Ejemplo de JSON Inutilización

Inutilizar un Solo Número

JSON

{
  "tipoEvento": 1,
  "timbrado": "1622239",
  "tipoDoc": "1",
  "establecimiento": "001",
  "punto": "001",
  "desde": "0000050",
  "hasta": "0000050",
  "motivo": "Salto de numeracion"
}

Inutilizar un Rango de Números

JSON

{
  "tipoEvento": 1,
  "timbrado": "1622239",
  "tipoDoc": "5",
  "establecimiento": "010",
  "punto": "004",
  "desde": "0000001",
  "hasta": "0000010",
  "motivo": "Numeros no utilizados por error del sistema"
}

Limitaciones

Máximo 1000 números

Solo puedes inutilizar hasta 1000 números consecutivos en una sola solicitud. Para rangos mayores, divide en múltiples solicitudes

Concepto	Límite
Números por solicitud	Máximo 1000
Formato desde/hasta	7 dígitos (ej: 0000001)
Deben ser consecutivos	Sí
Mismo establecimiento/punto	Sí

Ejemplo de Solicitud Completa

JavaScript

const formData = new FormData();

const inutilizacionData = {
  tipoEvento: 1,
  timbrado: "1622239",
  tipoDoc: "1",
  establecimiento: "001",
  punto: "001",
  desde: "0000050",
  hasta: "0000050",
  motivo: "Salto de numeracion"
};

formData.append('dataJson', JSON.stringify(inutilizacionData));
formData.append('recordID', 'TU_RECORD_ID');

fetch('https://api.factpy.com/facturacion-api/evento/', {
  method: 'POST',
  body: formData
})
.then(response => response.json())
.then(data => {
  if (data.status) {
    console.log('✓ Inutilización exitosa:', data.fecha);
  } else {
    console.error('✗ Error:', data.code);
  }
});

Notas Importantes

Números consecutivos

Los números en desde y hasta deben formar un rango consecutivo

Formato correcto

Asegúrate de usar el formato de 7 dígitos con ceros a la izquierda (ej: 0000001)

No se puede revertir

Una vez inutilizados, los números no pueden volver a utilizarse