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áctanos

Parámetros de la petición

Nombre Descripción Requerido
username Usuario del web service.
password Contraseña del web service.
firma_base64 Solicitud de cancelación firmada en base64 al estándar XML Digital Signature

 

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áctanos

Có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.

Zendesk Widget