Método Cancelar_CFDI_Seguro
Enlaces al servicio
Consumo de créditos
Por cada petición de UUID a cancelar: 1 crédito (cuando se haga un uso del servicio cancelar_cdfi, consultar_peticiones_pendientes y procesar_respuesta y dicha petición de cancelación sea exitosa)
Petición al servicio
El servicio de “cancelar_cfdi_seguro” te permitirá conectarte de manera síncrona (bajo las mismas condiciones de seguridad) para realizar cancelaciones de manera automatizada al servicio de Timbox. El usuario debe enviar peticiones firmadas utilizando el Certificado de Sello Digital del emisor de los CFDI, bajo el estándar XML Digital Signature establecido por el W3C identificando cada uno de los CFDI a cancelar por medio del identificador único incluido en el Timbre Fiscal Digital.
Las solicitudes pueden contener de 1 hasta 500 UUID’s por cada petición al servicio y en la misma respuesta recibirá el acuse de cancelación o error por cada uno de los UUID’s enviados.
Queremos solucionar tus dudas
ContáctanosParámetros de la petición
Nombre | Descripción | Requerido |
username | Usuario del web service. | Sí |
password | Contraseña del web service. | Sí |
firma_base64 | Solicitud de cancelación firmada en base64 al estándar XML Digital Signature | Sí |
Ejemplo de petición al servicio
A continuación mostramos un ejemplo de cómo debe ser construida la petición al servicio
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:WashOut"> <soapenv:Header/> <soapenv:Body> <urn:cancelar_cfdi_seguro soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"> <username xsi:type="xsd:string">AAA010101000</username> <password xsi:type="xsd:string">h6584D56fVdBbSmmnB</password> <firma_base64 xsi:type="xsd:string">PD94bWwgdmVyc2lvbj0iMS4wIj8+CjxDYW5jZWxhY2lvbiB4bWxucz0iaHR0cDovL2NhbmNlbGFjZmQuc2F0LmdvYi5teCIgeG1sbnM6eHNkPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYSIgeG1sbnM6eHNpPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYS1pbnN0YW5jZSIgRmVjaGE9IjIwMTktMDctMjVUMTI6MDc6MzAiIFJmY0VtaXNvcj0iTUlTQzQ5MTIxNEI4NiI+PEZvbGlvcz48VVVJRD45NzQwOERBNi05NUU5LTQ3QzctQUJFQi0zQjA1NUYyQjBFRjU8L1VVSUQ+PC9Gb2xpb3M+PFNpZ25hdHVyZSB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC8wOS94bWxkc2lnIyI+PFNpZ25lZEluZm8+PENhbm9uaWNhbGl6YXRpb25NZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy9UUi8yMDAxL1JFQy14bWwtYzE0bi0yMDAxMDMxNSIvPjxTaWduYXR1cmVNZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjcnNhLXNoYTEiLz48UmVmZXJlbmNlIFVSST0iIj48VHJhbnNmb3Jtcz48VHJhbnNmb3JtIEFsZ29yaXRobT0iaHR0cDovL3d3dy53My5vcmcvMjAwMC8wOS94bWxkc2lnI2VudmVsb3BlZC1zaWduYXR1cmUiLz48L1RyYW5zZm9ybXM+PERpZ2VzdE1ldGhvZCBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDkveG1sZHNpZyNzaGExIi8+PERpZ2VzdFZhbHVlPlNzZ2pxVDljZHhOeEVZek9wVlpLYno3UTFBZz08L0RpZ2VzdFZhbHVlPjwvUmVmZXJlbmNlPjwvU2lnbmVkSW5mbz48U2lnbmF0dXJlVmFsdWU+SFk3Q3Q0YlNPendXc0tPclYxb1NiUVMyVmhneHQwSm40N293c3pvOVZOWXdvSGV0OWg3ajJEck93TDlIWXpic2UyaHpabXJFU2hPOTZGYU03VXhRUHMvTTBGZUUwVXV2eVpxMTBDTzBoZTczZUNGZmtDZXhOa0hmenFXeDJvL2U0N2F1N3U2U3RVZW9YMFFBTlZEYS9qOXpyTEx1ck96bnkwV3pPNVI4R3JMSllPbDIwMzVrdE9qMTFxTk8yZmlaMTNMcFJMR09XVXNBamVoYmlvc2lxQWFtZTdTZjFQM3c5L295NG55bVhHV1B1VE1Qb1JGUTRuL054NWIydjFac2RQcUlkdTBiTjEwMTNyY3FtcVp6OVJjOGFUQkRYRmloM3h6RWdMMHgvb0NlT0t5ZTB2bnhITWlTSklVamlZaFlwVW5mMHdoUDVmSStZMXR4d1VaVkhRPT08L1NpZ25hdHVyZVZhbHVlPjxLZXlJbmZvPjxYNTA5RGF0YT48WDUwOUlzc3VlclNlcmlhbD48WDUwOUlzc3Vlck5hbWU+Q049QUMgVUFULE89U0VSVklDSU8gREUgQURNSU5JU1RSQUNJT04gVFJJQlVUQVJJQSxPVT1TQVQtSUVTIEF1dGhvcml0eSxlbWFpbEFkZHJlc3M9b3NjYXIubWFydGluZXpAc2F0LmdvYi5teCxzdHJlZXQ9M3JhIGNlcnJhZGEgZGUgY2FkaXoscG9zdGFsQ29kZT0wNjM3MCxDPU1YLFNUPUNJVURBRCBERSBNRVhJQ08sTD1DT1lPQUNBTix4NTAwVW5pcXVlSWRlbnRpZmllcj0yLjUuNC40NSx1bnN0cnVjdHVyZWROYW1lPXJlc3BvbnNhYmxlOiBBQ0RNQS1TQVQ8L1g1MDlJc3N1ZXJOYW1lPjxYNTA5U2VyaWFsTnVtYmVyPjI5MjIzMzE2Mjg3MDIwNjAwMTc1OTc2NjE5ODQ0NDMyNjIzNDU3NDAzODQ0Njg5ODwvWDUwOVNlcmlhbE51bWJlcj48L1g1MDlJc3N1ZXJTZXJpYWw+PFg1MDlDZXJ0aWZpY2F0ZT5NSUlGbGpDQ0EzNmdBd0lCQWdJVU16QXdNREV3TURBd01EQTBNREF3TURJek16SXdEUVlKS29aSWh2Y05BUUVMQlFBd2dnRXJNUTh3RFFZRFZRUUREQVpCUXlCVlFWUXhMakFzQmdOVkJBb01KVk5GVWxaSlEwbFBJRVJGSUVGRVRVbE9TVk5VVWtGRFNVOU9JRlJTU1VKVlZFRlNTVUV4R2pBWUJnTlZCQXNNRVZOQlZDMUpSVk1nUVhWMGFHOXlhWFI1TVNnd0pnWUpLb1pJaHZjTkFRa0JGaGx2YzJOaGNpNXRZWEowYVc1bGVrQnpZWFF1WjI5aUxtMTRNUjB3R3dZRFZRUUpEQlF6Y21FZ1kyVnljbUZrWVNCa1pTQmpZV1JwZWpFT01Bd0dBMVVFRVF3Rk1EWXpOekF4Q3pBSkJnTlZCQVlUQWsxWU1Sa3dGd1lEVlFRSURCQkRTVlZFUVVRZ1JFVWdUVVZZU1VOUE1SRXdEd1lEVlFRSERBaERUMWxQUVVOQlRqRVJNQThHQTFVRUxSTUlNaTQxTGpRdU5EVXhKVEFqQmdrcWhraUc5dzBCQ1FJVEZuSmxjM0J2Ym5OaFlteGxPaUJCUTBSTlFTMVRRVlF3SGhjTk1Ua3dOVEk1TVRnME5EVTNXaGNOTWpNd05USTVNVGcwTkRVM1dqQ0J2VEVnTUI0R0ExVUVBeE1YUTBWRFNVeEpRU0JOU1ZKQlRrUkJJRk5CVGtOSVJWb3hJREFlQmdOVkJDa1RGME5GUTBsTVNVRWdUVWxTUVU1RVFTQlRRVTVEU0VWYU1TQXdIZ1lEVlFRS0V4ZERSVU5KVEVsQklFMUpVa0ZPUkVFZ1UwRk9RMGhGV2pFV01CUUdBMVVFTFJNTlRVbFRRelE1TVRJeE5FSTROakViTUJrR0ExVUVCUk1TVFVsVFF6UTVNVEl4TkUxRFExSk9RekF4TVNBd0hnWURWUVFMRXhkRFJVTkpURWxCSUUxSlVrRk9SRUVnVTBGT1EwaEZXakNDQVNJd0RRWUpLb1pJaHZjTkFRRUJCUUFEZ2dFUEFEQ0NBUW9DZ2dFQkFKekF6U241T2VXb1ZmS0N6cFR1ZHZlSFNBeGEvY1VOYW9vT1VqclBKaFdSc0tLdFlBclo2N0NEWVpTYnFiaklCd2IzRHY2QWdyMU5ISGJZVCtoNjU3ckpPQzNaaG1tNGQ0YTA1VW9pelpUREF0WTVjM1hBS3BkS3VKMm9nZ1p1U1I5SDdtU1ExUDNXZlQ1djNUUmc2eGdFUXdtTWRiN3YzQzBBSzFQVE9LdGpoam1uZTlOcWh6ckVIZTNuZmlXcVg2Sm44WHQrbHJQQXo5azQwQk9XSmlQeTlnTXRoQUhQWGdYWVVNc21mRlZZdWJjTlhWSVgraUVsZWhMNmo1QWluNC9TK0ZCcXFwMFJ2dUVGNlZmWmlJNVN1WGxINjlSdzdCd1VjRmpndjloT21SYyt2WWVhYXNvcUxtZkY1U3VrKzZvRVRodmgyQU8yNHlpcSsxbTNzY1VDQXdFQUFhTWRNQnN3REFZRFZSMFRBUUgvQkFJd0FEQUxCZ05WSFE4RUJBTUNCc0F3RFFZSktvWklodmNOQVFFTEJRQURnZ0lCQUpVME9HMkVlTFFXVlZpanBhT0JGVHlHMytLWUN5K2hKWXlvNi9oY1VVQ1JGQkFpTlRiODl0eWxVa1JLcEo5cDhkaWdZTGtlZW1taE9rUDVVTm53cGl5MG5mZ0tEbE5IWDNCV1dCQzJYNnZjSFhGOWZPTWYxQ3hZYURNaHBxekhJK3JOZSs3RTlHWCtZNTVCdXRrMVJYR05icnByRGtGNEhLcGM4cmoxQ3RseXZtVWpKSjlpV0NPeWFwOC9rNU5XbjFMWkE5V2RCNkpvQTVESVgyTTRHQ2toNjdiSGVOdGVvZzhXOERFdFlBZWtrSTdVZmU3NEVJNWUzTkIzeExPMkVacm11bGE1V0VPcEVHdXZMZGk5cHFpWXpTU2FiRkIveGYxcGFweVpZdktrV1dpdzZPT0VvNVYyWjJFWGQvc0RBTVdRaHlKeWdIalVoMmFqWFFGZktJNTc3b21VUWYzNDZkbGhKWGk3UE1rMk4vMjZsdnRKVDVoWUx5cmJrNUs5WGlZQmZKS2tJZWRuOWVvQ1pJeE1INTlKOGthMlEyM3JMbmlsMXJ3NGw4a1ZaOXdBaEdhemVLNE5mem0zOEI4MWo2cTM4R2k3eDVHYXBhcnJPcitiQTVCcnIyL2U1bUg4WUdRWFVQUk5LNGFnL04rS2dnbk9IL2ZIWkJIMG1LU0pab0xoc2l6R1hhaGNhenp1RWpxRU5YRi9DKzBRRzh2dWltRXR5eUNGeng0Snp6QjVHMWkrWkVoR01IN25rUlNVZi84UnE4Zk4ydTBTTllFNUpFQjRpcEZhZXIySkdsUnJ6U01QNWlOa0NIMnd4V3Bock1IUldxVnF4OTdQcE00NW5FMEpjdWt2T2J3NzJUYUtGaG9oUTJVNnlNYi9mcXFQNXA3QzFaNWFmMzhIPC9YNTA5Q2VydGlmaWNhdGU+PC9YNTA5RGF0YT48L0tleUluZm8+PC9TaWduYXR1cmU+PC9DYW5jZWxhY2lvbj4K</firma_base64> </urn:cancelar_cfdi_seguro> </soapenv:Body> </soapenv:Envelope>
Respuesta del servicio
Si hubo un error con alguno de los parámetros o en el servicio de cancelación, se le notificará por medio de un mensaje de error, de lo contrario recibirá la estructura “cancelar_cfdi_seguro_result” compuesta de lo siguiente:
Parámetros de la respuesta
Nombre | Descripción |
folios_cancelacion | Información de los comprobantes cancelados. Contiene el UUID |
acuse_cancelacion | Contiene el acuse de cancelación que se obtiene desde el servicio del SAT. |
Ejemplo de respuesta del servicio
A continuación mostramos la respuesta que regresa el servicio una vez invocado.
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:tns="urn:WashOut"> <soap:Body> <tns:cancelar_cfdi_seguro_response> <cancelar_cfdi_seguro_result xsi:type="tns:cancelar_cfdi_seguro_result"> <folios_cancelacion xsi:type="xsd:string"><folios_cancelacion type="array"> <folio_cancelacion> <uuid>97408DA6-95E9-47C7-ABEB-3B055F2B0EF5</uuid> <codigo>201</codigo> <mensaje>Cancelado Exitosamente</mensaje> </folio_cancelacion> </folios_cancelacion>]]></folios_cancelacion> <acuse_cancelacion xsi:type="xsd:string"><Acuse Fecha="2019-07-25T14:08:29.0601995" RfcEmisor="MISC491214B86"> <Folios> <UUID>97408DA6-95E9-47C7-ABEB-3B055F2B0EF5</UUID> <EstatusUUID>201</EstatusUUID> </Folios> <Signature xmlns="http://www.w3.org/2000/09/xmldsig#" Id="SelloSAT"> <SignedInfo> <CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/> <SignatureMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#hmac-sha512"/> <Reference URI=""> <Transforms> <Transform Algorithm="http://www.w3.org/TR/1999/REC-xpath-19991116"> <XPath>not(ancestor-or-self::*[local-name()='Signature'])</XPath> </Transform> </Transforms> <DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha512"/> <DigestValue>6Jh0BJiRhGVoFwLRmY7ybbxOvNcGGa572vQ0faxqJg39tYTpJGYjRGmxM3fi7nSLT1upemS/lGBfWmCC8nyP+A==</DigestValue> </Reference> </SignedInfo> <SignatureValue>vxBC/k5d2QQwfHO8cZn9uhI1nz6ScGQfoapLZ2SwkdK87e1GbU/SRRweOz/gE6Brmczk+o8LogUHsr2FkWSctA==</SignatureValue> <KeyInfo> <KeyName>BF66E582888CC845</KeyName> <KeyValue> <RSAKeyValue> <Modulus>n5YsGT0w5Z70ONPbqszhExfJU+KY3Bscftc2jxUn4wxpSjEUhnCuTd88OK5QbDW3Mupoc61jr83lRhUCjchFAmCigpC10rEntTfEU+7qtX8ud/jJJDB1a9lTIB6bhBN//X8IQDjhmHrfKvfen3p7RxLrFoxzWgpwKriuGI5wUlU=</Modulus> <Exponent>AQAB</Exponent> </RSAKeyValue> </KeyValue> </KeyInfo> </Signature> </Acuse>]]></acuse_cancelacion> </cancelar_cfdi_seguro_result> </tns:cancelar_cfdi_seguro_response> </soap:Body> </soap:Envelope>
Queremos solucionar tus dudas
ContáctanosCódigo a nivel folio
Código |
Descripción |
201 |
UUID Cancelado exitosamente |
202 |
UUID Previamente cancelado |
203 |
UUID no corresponde al RFC del Emisor |
204 |
UUID no aplicable para cancelación |
205 |
UUID No existe |
CANC101 |
UUID no fue timbrado por Timbox, por lo tanto no se puede cancelar |
CANC104 |
UUID no corresponde al RFC del Receptor |
CANC105 |
Total no corresponde al CFDI |
Códigos de error a nivel petición
Los siguientes códigos de error se generarán a nivel general de la solicitud de cancelación:
Código |
Descripción |
CANC001 |
Los datos de autentificación enviados son incorrectos |
CANC002 |
Se han agotado la cantidad de timbres |
CANC003 |
Parámetro inválido |
CANC301 |
El XML recibido no contiene una estructura válida |
**CANC302 |
El certificado de producción no se puede utilizar en ambiente de pruebas |
CANC401 |
Error especifico de la estructura de la petición |
CANC402 |
Sello del XML mal formado o inválido |
CANC403 |
Sello del XML no corresponde al Emisor |
CANC404 |
Certificado del XML revocado o caduco |
CANC405 |
Certificado enviado en XML no es válido |
CANC406 |
Uso de certificado en XML de e.firma inválido |
CANC501 |
Hay 499 o más UUIDS en una sola petición |
CANC998 |
Error de comunicación con el servicio del SAT, se genero un timeout en la petición al servicio del SAT |
CANC999 |
Error de comunicación con el servicio de cancelación |
**CANC302.- Solo aplica para el ambiente de pruebas. Es importante mencionar que para obtener la cancelación exitosa es necesario realizar todo el ciclo desde el timbrado y la cancelación con los certificados de pruebas.