Skip to main content
POST
POST /v1/de/inutilizar
Marca un rango contiguo de números no emitidos como inutilizados en SIFEN. Sirve para “saltar” números cuando, por ejemplo, se perdió un comprobante físico durante una migración o se desea mantener consistencia secuencial sin emitir. A diferencia de cancelar, este endpoint no opera sobre un CDC — opera sobre un rango de numeración del emisor.

Cuándo usarlo

  • Al migrar de un sistema legacy a e-Miti, hay un gap en la numeración que querés declarar oficialmente como no usado.
  • Pruebas fallidas en homologación dejaron números “quemados” que querés cerrar.
  • Numeración secuencial obligatoria para auditoría — declarás los gaps explícitamente.

Body típico

  • numero_desdenumero_hasta (puede ser el mismo número).
  • El rango no puede solapar con números ya emitidos ni con rangos previamente inutilizados.
  • motivo es obligatorio para SIFEN — string descriptivo.

Para un solo número rechazado

Si tenés un único número proveniente de un DE rechazado (estado R) que querés liberar, usá el atajo POST /v1/de/{cdc}/inutilizar-numero — extrae establecimiento/punto/tipo/número del CDC automáticamente.

Listado de inutilizaciones

Para ver todas las inutilizaciones realizadas del tenant, usá GET /v1/de/inutilizaciones.

Authorizations

Authorization
string
header
required

Body

application/json

Body del endpoint POST /de/inutilizar (FRA-228).

La inutilización informa a SIFEN que un rango de números de un timbrado NO fue emitido y debe marcarse como inválido (MT v150 cap. 11.2).

establecimiento
string
required

Código de establecimiento (EEE), exactamente 3 dígitos.

Required string length: 3
Pattern: ^\d{3}$
punto
string
required

Código de punto de expedición (PPP), exactamente 3 dígitos.

Required string length: 3
Pattern: ^\d{3}$
numero_desde
integer
required

Primer número del rango a inutilizar (1-9999999).

Required range: 1 <= x <= 9999999
numero_hasta
integer
required

Último número del rango a inutilizar (>= numero_desde).

Required range: 1 <= x <= 9999999
tipo_de
integer
required

Tipo de DE del rango (1=Factura, 4=Autofactura, 5=NC, etc.).

Required range: 1 <= x <= 8
motivo
string
required

Motivo de la inutilización — texto libre, viaja al XML del evento SIFEN como mOtInut. Mínimo 5 chars. Máximo 500 (MT v150 cap. 11).

Required string length: 5 - 500

Response

Successful Response