Método: cancelar
Nuevo proceso para cancelacíon entrará en vigencia el 1 de Enero de 2022, para más información ver Cancelación CFDI 3.3, 4.0
El método cancelar del Webservice CFDI cancela uno o varios CFDI.
Emisión CFDI 4.0. puede ser utilizada con base a los ejemplos siguientes que se muestran a continuación.
-
La obligatoriedad de los campos esta representada de la siguiente manera en la columna “Requerido”:
- Sí: el valor de este campo debe enviarse siempre.
- No: el valor de este campo puede enviarse o no.
- Condicional: el valor de este campo puede ser obligatorio o no, dependiendo de otros.
Parámetros:
-
Nombre Descripción Requerido usuario xs:string
Nombre de usuario registrado para el uso del Webservice.
Sí password xs:string
Contraseña del usuario.
Sí solicitudesCancelacion Arreglo de SolicitudCancelacion
Datos que sirven como parámetro para la búsqueda de los CFDI a cancelar.
Sí motivoCancelacion xs:string
Se ingresa el motivo de la cancelación.
Sí
Atributos del tipo complejo SolicitudesCancelacion:Nombre Descripción Requerido folio xs:long
Folio comercial del CFDI
Condicional serie xs:string
Serie del CFDI
Condicional uuid xs:string
Cadena de cancelación que especifique
En el formato:
UUID: el Folio fiscal del documento (opcional si se envía folio y serie)
Motivo: la clave del motivo de cancelación del catálogo del SAT
UUIDSustituye: Folio fiscal del comprobante que sustituye al documento que se cancela (se puede omitir si se especifica FolioSustituye y SerieSustituye)
FolioSustituye: Folio comercial del comprobante que sustituye al documento que se cancela (se puede omitir si se especifica UUIDSustituye)
SerieSustituye: Serie del comprobante que sustituye al documento que se cancela (se puede omitir si se especifica UUIDSustituye)UUID|Motivo|UUIDSustituye|FolioSustituye|SerieSustituye
Condicional
Motivos de cancelación:
-
Clave Descripción 01 Comprobante emitido con errores con relación. 02 Comprobante emitido con errores sin relación. 03 No se llevó a cabo la operación. 04 Operación nominativa relacionada en una factura global. Cuando se seleccione la clave 01, se deberá habilitar un campo adicional para registrar el folio fiscal que sustituye al comprobante.
Cancelar el comprobante 7812 de la serie FA que es sustitído (motivo 01) por el comprobante relacionado 7813 de la misma serie.
Ejemplo de petición
Regresa
- Este método retorna un tipo compuesto: RespuestaCancelacion los atributos se describen en la siguiente tabla.
-
Atributos de RespuestaCancelacionNombre Descripción Requerido status xs:int
El código estatus de la operación, para detalle de los códigos de estatus consulte “Códigos de respuesta generales de encabezado”
Sí mensaje xs:string
El mensaje de respuesta, detalla el estatus de la operación.
Sí resultados Arreglo de Resultados
Un array de CFDIResultadoCancelacion, un tipo compuesto cuyos atributos se detallan en la tabla “Atributos de ResultadoCancelacion”
Condicional acuseSAT xs:string
Mensaje en Base64 que contienen el acuse de cancelación.
Condicional Nombre Descripción Requerido detalle xs:string
El mensaje de respuesta, detalla el estatus de la operación.
Sí estatusUUID xs:string
Estatus de respuesta del SAT para el comprobante que se envió a cancelación, para detalles de los códigos de estatus de cancelación consulte “Códigos de respuesta del SAT para la cancelación de CFDI”.
Condicional folio xs:long
Folio comercial del CFDI
Condicional serie xs:string
Serie del CFDI
Condicional uuid xs:string
Folio fiscal del CFDI.
Condicional
Ejemplo de respuesta
Ejemplo de respuesta cuando se manda cancelar un CFDI ya cancelado
Ejemplo de respuesta cuando un CFDI NO es cancelable
Ejemplo de respuesta cuando un CFDI requiere autorización
Ejemplo de respuesta de reintento cuando el comprobante requiere autorización del receptor
Ejemplo de respuesta Comprobante aún no entregado al SAT
Códigos de respuesta generales de encabezado
Los códigos de respuesta generales de encabezado pueden contener descripciones más específicas en el mensaje. Este estatus se representara en el primer nodo de la respuesta.
- 201- Comprobante cancelable sin aceptación
- 211- Comprobante cancelable con aceptación ó La cancelación está en proceso
- 213- La solicitud de cancelación fue rechazada por el receptor
- 500- Han ocurrido errores que no han permitido completar el proceso. Reintentar.
Códigos statusUUID adicionales de la nueva forma de cancelación
- 201- Cancelado
- 202- Ya se había cancelado el comprobante
- 203- Comprobante a cancelar no corresponde con el emisor
- 204- El comprobante no se puede cancelar
- 205- Comprobante no encontrado
- 208- La fecha de solicitud de cancelación es mayor a la fecha de declaración
UUID's para prueba de cancelación
UUIDs que pueden usarse en el ambiente de pruebas que retornan este código 201, 202 y 204 |
E329DD15-7D0B-44E9-A204-51A7443D1FBE |
5B4B180D-5B6C-4392-B204-252215A1AB84 |
51D8A114-2BA6-40B8-C204-B9721791863B |
1BCA95C3-DA01-44C2-D204-59A9114F94BE |
F4621025-0864-4E62-E204-59EE41B1101E |
UUIDs que pueden usarse en el ambiente de pruebas que retornan este código 211 y 213 |
C5E58106-6C1E-41C9-A211-FB8BAD1CABB0 |
38FB9AC9-DD3E-4601-B211-EB02C007C3BA |
CB917CA9-60D3-4A81-C211-76BD1A6B756D |
7C34D543-E6C9-4990-D211-3F767E0B5142 |
0D62B12C-BC6C-4626-E211-FC8FE727A5BC |