Método: cancelar
El método cancelar del Webservice CFDI cancela uno o varios CFDI.
-
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í
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.
Ejemplo de petición
Descargar este ejemplo
Regresa
- Este método retorna un tipo compuesto: RespuestaCancelacion los atributos se describen en la siguiente tabla.
-
Atributos de RespuestaCancelacion
Atributos de ResultadosNombre 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
Descargar este ejemplo
-
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.
- 200 — El proceso de creación se ha completado correctamente.
- 500 — Han ocurrido errores que no han permitido completar el proceso. Reintentar.
- 501 — Error de conexión a la base de datos. Reintentar.
- 502 — Han ocurrido errores al intentar recuperar datos o almacenarlos en la base de datos.
- 503 — Se ha alcanzado el límite de licencias de acceso concurrente a base de datos.
- 601 — Error de autenticación, verifique usuario y contraseña.
- 602 — La cuenta de usuario se encuentra bloqueada.
- 603 — La contraseña de la cuenta ha expirado.
- 604 — Ha excedido el número máximo permitido de intentos de autenticación fallidos, la cuenta se bloqueará.
- 610 — La acción solicitada no está soportada en la implementación porque no se ha configurado para tal fin o no es posible realizarla. En el método importar significa que la implementación no tiene un Conector de importación de comprobantes configurado.
- 611 — No se han especificado todos los parámetros necesarios para realizar la operación. En el caso del método importar significa que el Conector de importación asignado a esta implementación no puede ser utilizado a través de este en este Webservice debido a limitaciones propias del conector.
- 612 — Archivo malformado. El formato de archivo o secuencia binaria no corresponde a la esperada.
- 613 — La secuencia numérica ha llegado al final.
- 620 — No tiene permiso para realizar la acción.
- 621 — Argumento no válido.
- 622 — Operación no soportada para la implementación.
- 623 — Datos no encontrados.
- 624 — Violación de restricción de unicidad.
- 625 — La acción no se puede completar porque requiere que se ejecute una acción previa.
- 626 — Error de configuración de la implementación.
- 630 — El contrato de la implementación ha expirado.
- 631 — La fecha de pago del contrato de la implementación ha expirado.
- 632 — Se ha superado el límite de uso justo para la implementación.
- 633 — La implementación se encuentra inactiva.
-
Códigos de estatus de cancelación
- 200 — El proceso de cancelación se ha completado correctamente.
- 500 — Han ocurrido errores que no han permitido completar el proceso de cancelación.
-
Códigos de respuesta del SAT para la cancelación de CFDI
- 201 — El folio se ha cancelado con éxito.
- 202 — El folio ya se había cancelado previamente.
- 203 — El comprobante que intenta cancelar no corresponde al contribuyente con el que se ha firmado la solicitud de cancelación.
- 204 — El CFDI no aplica para cancelación.
- 205 — No se encuentra el folio del CFDI para su cancelación.
