Cancelar un CFDI | Timbrify Docs

Motivos de cancelacion SAT

Codigo	Motivo	Requiere aceptacion
01	Comprobante emitido con errores con relacion	No
02	Comprobante emitido con errores sin relacion	Si (si > $1,000 MXN y > 24h)
03	No se llevo a cabo la operacion	Si (si > $1,000 MXN y > 24h)
04	Operacion nominativa relacionada con factura global	No

Cancelar con sustitucion (motivo 01)

Cuando cancelas por error y reexpides, primero emite la factura correcta y luego cancela la original referenciando la nueva:

curl -X POST https://api.timbrify.com/api/v1/merchant/cancellations \
  -H "Cookie: tmb_session=TU_SESSION" \
  -H "Content-Type: application/json" \
  -d '{
    "invoiceId": "uuid-factura-original",
    "motivo": "01",
    "folioSustitucion": "UUID_DE_LA_NUEVA_FACTURA"
  }'

Cancelar sin sustitucion (motivos 02/03)

curl -X POST https://api.timbrify.com/api/v1/merchant/cancellations \
  -H "Cookie: tmb_session=TU_SESSION" \
  -H "Content-Type: application/json" \
  -d '{
    "invoiceId": "uuid-factura",
    "motivo": "02"
  }'

Si la factura tiene mas de 24 horas y su monto supera $1,000 MXN, el SAT requiere aceptacion del receptor. El status sera pending_cancellation hasta que el receptor acepte o pasen 72 horas (se acepta por silencio).

Estados de cancelacion

Estado	Descripcion
`pending_cancellation`	Esperando aceptacion del receptor
`cancelled`	Cancelacion aceptada
`cancel_rejected`	Receptor rechazo la cancelacion