SatCancelarCFDI

Descripción

Cancela ante el SAT un CFDI que ya fue timbrado, usando el mismo PAC configurado en la credencial. Requiere el UUID (folio fiscal) del comprobante y el motivo de cancelación según el catálogo del SAT. Cuando el motivo es “01” (errores con relación), es obligatorio indicar el UUID de la factura sustituta. Según el monto y el tiempo transcurrido desde el timbrado, el SAT puede exigir la aceptación del receptor antes de completar la cancelación.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial SAT (CSD + PAC)
uuid	text	Sí	UUID (folio fiscal) del CFDI a cancelar
motivo	select	Sí	Motivo de cancelación SAT (default: 02)
sustitución	text	No	UUID de la factura sustituta (obligatorio si motivo es 01)

Motivos de cancelación SAT

Código	Descripción
01	Comprobante emitido con errores con relación (requiere sustitución)
02	Comprobante emitido con errores sin relación (default)
03	No se llevó a cabo la operación
04	Operación nominativa relacionada en factura global

Credenciales

Este módulo requiere una credencial de tipo sat con:

• CSD: certificado de sello digital (.p12 o .cer + .key) y su contraseña
• RFC del emisor, razón social, régimen fiscal y código postal
• PAC: proveedor de timbrado (facturama, finkok o sw) y sus credenciales de acceso
• Entorno: test o production

Salida

{
  "success": true,
  "uuid": "A1B2C3D4-E5F6-4A5B-9C8D-1234567890AB",
  "estado": "cancelled",
  "motivo": "02",
  "motivoDescripcion": "Errores sin relación",
  "estatus": "Cancelado sin aceptación",
  "acuse": "acuse de cancelación devuelto por el PAC"
}

Ejemplo de Uso

Cancelar por error sin relación (motivo 02)

{
  "credentials_id": "cred-sat-prod",
  "uuid": "A1B2C3D4-E5F6-4A5B-9C8D-1234567890AB",
  "motivo": "02"
}

Cancelar con CFDI sustituto (motivo 01)

{
  "credentials_id": "cred-sat-prod",
  "uuid": "A1B2C3D4-E5F6-4A5B-9C8D-1234567890AB",
  "motivo": "01",
  "sustitucion": "B2C3D4E5-F6A7-4B5C-9D8E-234567890ABC"
}

Notas

• El motivo 01 exige indicar sustitucion (UUID de la factura que reemplaza a la cancelada); si falta, el nodo devuelve error antes de llamar al PAC.
• La cancelación se ejecuta con el mismo PAC configurado en la credencial usada para timbrar el CFDI original.
• El campo estatus refleja si la cancelación quedó firme o si está pendiente de la aceptación del receptor.

Nodos Relacionados

• SatTimbrarCFDI - Timbrar un CFDI
• SatConsultarEstatus - Consultar si un CFDI está vigente o cancelado