Inutilizar numeración

La inutilización es un evento SIFEN que marca números de comprobante como no utilizados. A diferencia de la cancelación, no opera sobre un DE aprobado — opera sobre numeración que querés cerrar oficialmente. Hay dos variantes:

Inutilizar un rango — declarar un rango contiguo (numero_desde a numero_hasta) como no emitido. Útil al migrar, en gaps secuenciales, o para cerrar números “quemados” en pruebas.
Inutilizar el número de un DE rechazado — atajo para el caso común: después de un rechazo SIFEN (R), liberás ese número.

Variables del ejemplo

export EMITI_BASE_URL="https://api.emiti.fravelabs.com"
export EMITI_API_KEY="emiti_k_xxxxxxxxxxxxxxxxxxxxxxxx"

Caso 1 — Inutilizar el número de un DE rechazado

Tu DE con CDC 01548...678X fue rechazado por SIFEN. Querés liberar ese número y emitir el siguiente con numero automático:

export CDC="01548730457001001000000112026061712345678X"

curl -s "$EMITI_BASE_URL/v1/de/$CDC/inutilizar-numero" \
  -X POST \
  -H "Authorization: ApiKey $EMITI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "motivo": "DE rechazado — número liberado para evitar gap" }'

El endpoint extrae establecimiento, punto, tipo y número del CDC automáticamente. Solo funciona si el DE está en estado R.

Caso 2 — Inutilizar un rango durante migración

Migrás de un sistema legacy y los números 1000 a 1050 quedaron sin usar. Los declarás como inutilizados todos juntos:

curl -s "$EMITI_BASE_URL/v1/de/inutilizar" \
  -X POST \
  -H "Authorization: ApiKey $EMITI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "establecimiento": "001",
    "punto": "001",
    "tipo_de": 1,
    "numero_desde": 1000,
    "numero_hasta": 1050,
    "motivo": "Migración de sistema legacy — números no emitidos"
  }'

numero_desde ≤ numero_hasta (puede ser el mismo si es un único número).
El rango no puede solapar con números ya emitidos ni con rangos previamente inutilizados.
motivo es obligatorio para SIFEN y debe ser descriptivo.

Listar inutilizaciones previas

Antes de inutilizar un rango nuevo, podés revisar los ya declarados para evitar solapes:

curl -s "$EMITI_BASE_URL/v1/de/inutilizaciones" \
  -H "Authorization: ApiKey $EMITI_API_KEY" | jq

Devuelve la lista con establecimiento, punto, tipo, numero_desde, numero_hasta, motivo, created_at y protocolo SIFEN.

Errores típicos

Código / status	Causa	Acción
`400`	El rango solapa con números ya emitidos o ya inutilizados.	Listar inutilizaciones previas + verificar el último `numero` emitido.
`400`	El DE no está en estado `R` (variante atajo).	Verificar estado del DE.
`409`	El número ya fue inutilizado previamente.	No es necesario reintentar.
`SIFEN_RECHAZO`	SIFEN rechazó el evento.	Revisar `extra.codigo_sifen` — frecuentemente por `motivo` inadecuado.

Inutilización vs. cancelación

	Cancelar	Inutilizar
Opera sobre	CDC de un DE aprobado	Numeración (con o sin CDC)
Plazo	48 horas	Sin límite
Estados destino	`A` → `C`	Reserva el número en SIFEN como “no usado”
Tutorial	cancelar-de	(este)

Empezar

Conceptos

Tutoriales — Emisión

Tutoriales — Eventos y errores

Errores

Inutilizar numeración

Variables del ejemplo

Caso 1 — Inutilizar el número de un DE rechazado

Caso 2 — Inutilizar un rango durante migración

Listar inutilizaciones previas

Errores típicos

Inutilización vs. cancelación

​Variables del ejemplo

​Caso 1 — Inutilizar el número de un DE rechazado

​Caso 2 — Inutilizar un rango durante migración

​Listar inutilizaciones previas

​Errores típicos

​Inutilización vs. cancelación

Variables del ejemplo

Caso 1 — Inutilizar el número de un DE rechazado

Caso 2 — Inutilizar un rango durante migración

Listar inutilizaciones previas

Errores típicos

Inutilización vs. cancelación