Método Cancelar_Retencion

Enlaces al servicio

Pruebas: https://staging.ws.timbox.com.mx/retencion/wsdl

Producción: https://sistema.timbox.com.mx/retencion/wsdl

Consumo de créditos

Por cada petición de UUID a cancelar: 1 crédito

Petición al servicio

El servicio de “cancelar_retencion” se utiliza para cancelación de un comprobante de retención que ya fue timbrado. Se requiere usuario y contraseña para utilizar el servicio.

Queremos solucionar tus dudas

Contáctanos

Parámetros de la petición

Nombre Descripción Requerido
username Usuario del web service. Sí
password Contraseña del web service. Sí
rfcemisor El rfc que emitió el comprobante que desea cancelar. Sí
uuid Se manda el UUID del comprobante que desea cancelar.  El UUID debe de cumplir con la expresión regular de UUID’s. Sí
cert_pem El certificado, en formato pem, que corresponde al emisor del comprobante. Sí
llave_pem La llave, formato pem, que corresponde al emisor del comprobante. 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_retencion soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
         <username xsi:type="xsd:string">AAA010101000</username>
         <password xsi:type="xsd:string">h6584D56fVdBbSmmnB</password>
         <rfcemisor xsi:type="xsd:string">MISC491214B86</rfcemisor>
         <uuids xsi:type="urn:uuid">
            <!--Zero or more repetitions:-->
            <uuid xsi:type="xsd:string">6DB9BD60-38A0-4D94-81A7-102613A584D9</uuid>
         </uuids>
         <cert_pem xsi:type="xsd:string">-----BEGIN CERTIFICATE-----
MIIFljCCA36gAwIBAgIUMzAwMDEwMDAwMDA0MDAwMDIzMzIwDQYJKoZIhvcNAQEL
BQAwggErMQ8wDQYDVQQDDAZBQyBVQVQxLjAsBgNVBAoMJVNFUlZJQ0lPIERFIEFE
TUlOSVNUUkFDSU9OIFRSSUJVVEFSSUExGjAYBgNVBAsMEVNBVC1JRVMgQXV0aG9y
aXR5MSgwJgYJKoZIhvcNAQkBFhlvc2Nhci5tYXJ0aW5lekBzYXQuZ29iLm14MR0w
GwYDVQQJDBQzcmEgY2VycmFkYSBkZSBjYWRpejEOMAwGA1UEEQwFMDYzNzAxCzAJ
BgNVBAYTAk1YMRkwFwYDVQQIDBBDSVVEQUQgREUgTUVYSUNPMREwDwYDVQQHDAhD
T1lPQUNBTjERMA8GA1UELRMIMi41LjQuNDUxJTAjBgkqhkiG9w0BCQITFnJlc3Bv
bnNhYmxlOiBBQ0RNQS1TQVQwHhcNMTkwNTI5MTg0NDU3WhcNMjMwNTI5MTg0NDU3
WjCBvTEgMB4GA1UEAxMXQ0VDSUxJQSBNSVJBTkRBIFNBTkNIRVoxIDAeBgNVBCkT
F0NFQ0lMSUEgTUlSQU5EQSBTQU5DSEVaMSAwHgYDVQQKExdDRUNJTElBIE1JUkFO
REEgU0FOQ0hFWjEWMBQGA1UELRMNTUlTQzQ5MTIxNEI4NjEbMBkGA1UEBRMSTUlT
QzQ5MTIxNE1DQ1JOQzAxMSAwHgYDVQQLExdDRUNJTElBIE1JUkFOREEgU0FOQ0hF
WjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAJzAzSn5OeWoVfKCzpTu
dveHSAxa/cUNaooOUjrPJhWRsKKtYArZ67CDYZSbqbjIBwb3Dv6Agr1NHHbYT+h6
57rJOC3Zhmm4d4a05UoizZTDAtY5c3XAKpdKuJ2oggZuSR9H7mSQ1P3WfT5v3TRg
6xgEQwmMdb7v3C0AK1PTOKtjhjmne9NqhzrEHe3nfiWqX6Jn8Xt+lrPAz9k40BOW
JiPy9gMthAHPXgXYUMsmfFVYubcNXVIX+iElehL6j5Ain4/S+FBqqp0RvuEF6VfZ
iI5SuXlH69Rw7BwUcFjgv9hOmRc+vYeaasoqLmfF5Suk+6oEThvh2AO24yiq+1m3
scUCAwEAAaMdMBswDAYDVR0TAQH/BAIwADALBgNVHQ8EBAMCBsAwDQYJKoZIhvcN
AQELBQADggIBAJU0OG2EeLQWVVijpaOBFTyG3+KYCy+hJYyo6/hcUUCRFBAiNTb8
9tylUkRKpJ9p8digYLkeemmhOkP5UNnwpiy0nfgKDlNHX3BWWBC2X6vcHXF9fOMf
1CxYaDMhpqzHI+rNe+7E9GX+Y55Butk1RXGNbrprDkF4HKpc8rj1CtlyvmUjJJ9i
WCOyap8/k5NWn1LZA9WdB6JoA5DIX2M4GCkh67bHeNteog8W8DEtYAekkI7Ufe74
EI5e3NB3xLO2EZrmula5WEOpEGuvLdi9pqiYzSSabFB/xf1papyZYvKkWWiw6OOE
o5V2Z2EXd/sDAMWQhyJygHjUh2ajXQFfKI577omUQf346dlhJXi7PMk2N/26lvtJ
T5hYLyrbk5K9XiYBfJKkIedn9eoCZIxMH59J8ka2Q23rLnil1rw4l8kVZ9wAhGaz
eK4Nfzm38B81j6q38Gi7x5GaparrOr+bA5Brr2/e5mH8YGQXUPRNK4ag/N+KggnO
H/fHZBH0mKSJZoLhsizGXahcazzuEjqENXF/C+0QG8vuimEtyyCFzx4JzzB5G1i+
ZEhGMH7nkRSUf/8Rq8fN2u0SNYE5JEB4ipFaer2JGlRrzSMP5iNkCH2wxWphrMHR
WqVqx97PpM45nE0JcukvObw72TaKFhohQ2U6yMb/fqqP5p7C1Z5af38H
-----END CERTIFICATE-----</cert_pem>
         <llave_pem xsi:type="xsd:string">-----BEGIN PRIVATE KEY-----
MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQCcwM0p+TnlqFXy
gs6U7nb3h0gMWv3FDWqKDlI6zyYVkbCirWAK2euwg2GUm6m4yAcG9w7+gIK9TRx2
2E/oeue6yTgt2YZpuHeGtOVKIs2UwwLWOXN1wCqXSridqIIGbkkfR+5kkNT91n0+
b900YOsYBEMJjHW+79wtACtT0zirY4Y5p3vTaoc6xB3t534lql+iZ/F7fpazwM/Z
ONATliYj8vYDLYQBz14F2FDLJnxVWLm3DV1SF/ohJXoS+o+QIp+P0vhQaqqdEb7h
BelX2YiOUrl5R+vUcOwcFHBY4L/YTpkXPr2HmmrKKi5nxeUrpPuqBE4b4dgDtuMo
qvtZt7HFAgMBAAECggEAWsi/CgQxp/Sqcl2Xz2GcvRc4fw9j0fBHN9W7ghve7rcG
GfFXonE7s2sj5LGSxlXy2/HSWUuMbJ5wUdRN01L7So6nXsaQtkID15yE/z7Q2ctn
pTJ40EWPZTf9XDHvvFG7P8alJtFKygijWLno3yESh0JQoQMcXo0Ec3uZnF7Ef12j
5nOHas2f9VB6aqzSaMOLXH7ZgyTwon7KaFwAfhH8Pdo4cDvGYxxeNXkk61ve23eZ
OZhc5x7GNAPYUGftKbiA3bNPBArBgoEjcl5q0yyBjaxoF7IzwauA23E6UnVTJ80v
BtUKZuTPCpS5N64bfgdc/EpCkqUyegt9lpt+YVG7AQKBgQD1ENmACuiJQVawTVV1
7dBztT+1jinT6wOUfOnPftbukMpin2jHnI2+Bnxccl7kHQvdBCub7l2pu21He47M
AaCJCa61QIY2BumCw47+XK+ZD59EnxKxMrHK7kCsv8GPDi6b/uoY01K1U/XrQTXh
MbJKArMv5qnNfuVRCg1DkaHE8QKBgQCjvz2+SIOlaSSWeoI+B6CXWSM6wOhjqVAf
0jdBXqNcDQ7nVKHO1FXuVLlPsWYo8AjzyM4EaGybUzmxVdWXI4bYgyVWFhzNomoh
YfNctlGkpD3z5NlX9Vu5LwANECB5hCrJukhjAwJOit8QsqrBxRrKcwKsAFenBt6F
4latM1MqFQKBgQCxVrUeDEbD9E1IHV5HjYV4BeQJfMvV985KaK5FohLk5lAeWB7Z
u/dyWH0r5PO3/TD1iiwIldCfn+rvfIEULeU+5YvQy9WTSSM3pk5W0Tmc+IoXfUlo
gzfXktuoZscpv2iJKEm9F0dVwmFGEZVs1aqgFh4W/sNH2pkVMMHycHNw8QKBgHcp
vDgWs18TxiGQI+oaSN77amzeZ//m/j06ESYMRhu+EQN+Dobi9WoM1BLPycWu8QTg
NDT2/VqH1WtdSKPFoeM8hVZBn1JyiIOksaLdt0p2j/NGrniZQNfiAUqAWvGzoiPN
4dHUJcCcxTp0m1mKJDYCPoaHdUJC+Hs8PNGskTAFAoGBAKqSqHW9v7Xp8IMsD0+j
KFKtyYVpvpgXWEcnFkr7YMlT3IddmF8MksifUnafMrfHD3sYTEkDjCHvQr8L6T5d
LIJz64Ohlo/kd/Sv7GkuuAAhDjNb/IXkRGfJCedEFpdUj4pDBwFhV9iDWlVG1AlV
nhLDLnHC0PZAjoWl1z2zIQ11
-----END PRIVATE KEY-----</llave_pem>
      </urn:cancelar_retencion>
   </soapenv:Body>
</soapenv:Envelope>

Queremos solucionar tus dudas

Contáctanos

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_masivo_response” compuesta de lo siguiente:

Parámetros de la respuesta

Nombre Descripción
uuid 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_retencion_response>
         <cancelar_retencion_result xsi:type="tns:cancelar_retencion_result">
            <acuse_cancelacion xsi:type="xsd:string"><![CDATA[<Acuse Fecha="2018-12-27T12:08:50" RfcEmisor="MISC491214B86"><Folios><UUID>6DB9BD60-38A0-4D94-81A7-102613A584D9</UUID><EstatusUUID>1201</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>ML2rVJ79GS6cQNjRI7wmoRu5aFykTgian5alYvohYhR5Dh3QB43LX1RadDFutgMIM3q60LozLGdtmLVDdnhZsg==</DigestValue></Reference></SignedInfo><SignatureValue>lO73l44krAoObyw+HGI/ychDJa3PpxiqDWZ0tLqUrhDj0E4Dv5mWE1t4wzOST26zJENixF4ZBGAk8Jj+fM8Kuw==</SignatureValue><KeyInfo><KeyName>00001088888800000016</KeyName><KeyValue><RSAKeyValue><Modulus>xnL2zDPtH5jDsAZDTIfMqbKGrve+At8Kyx2EZvbfXbpK9uVExWS874oMelFzNq69/YqSReT3I7I8wr+joy5O7ouZH+4KWdIGp4Si6lHe0kntxzNmuuKyOPkJ9tMcntnFmQ4bfxFxlg/Ud2hCtuoy3j2xYkIXu5O4pGM98Nz8pAM=</Modulus><Exponent>AQAB</Exponent></RSAKeyValue></KeyValue></KeyInfo></Signature></Acuse>]]></acuse_cancelacion>
            <comprobantes_cancelados xsi:type="xsd:string"><![CDATA[<comprobante_cancelado>
      <uuid>6DB9BD60-38A0-4D94-81A7-102613A584D9</uuid>
      <EstatusUUID>Cancelado Exitosamente</EstatusUUID>
    </comprobante_cancelado>]]></comprobantes_cancelados>
         </cancelar_retencion_result>
      </tns:cancelar_retencion_response>
   </soap:Body>
</soap:Envelope>

Códigos a nivel folio

Los siguientes códigos de error se repetirán tantas veces como se repita el nodo folios en la solicitud:

Código Descripción
1201 UUID Cancelado
1202 UUID Previamente cancelado
1203 UUID No encontrado o no corresponde en el emisor
1205 UUID No existe

Códigos de error a nivel folio petición

Código Descripción
CRE001 Los datos de autentificación enviados son incorrectos
CRE002 Se han agotado la cantidad de timbres
CRE201 Hay más de un UUID, favor de hacer la solicitud a este servicio: “Cancelar_retencion_masivo”
CRE202 Hay un solo UUID, favor de hacer la solicitud a este servicio: “Cancelar_retencion”
CRE203 Parámetro inválido.
CRE204 Parámetro llave_pem inválido
CRE205 Parámetro cer_pem inválido
CRE206 Hay más de 10,000 UUID’s en una sola petición.
CRE301 XML mal formado, el UUID recibido no tiene una estructura válida.
CRE303 La estructura de RFC no es válida.
CRE305 El certificado no corresponde al emisor.
CRE306 El certificado ha caducado.
CRE307 El certificado utilizado es de tipo FIEL. No es un CSD.
CRE308 El certificado no se encuentra en la lista LCO del SAT.
CRE309 El certificado no fue expedido por el SAT.
CRE999 Error de comunicación con el servicio de cancelación.
Soporte

Zendesk Widget