Timbrado CFDI de Retención v20150216 - Tralix

25
1 Timbrado y Cancelación CFDI de Retención Tabla de contenido 1. Dirección Productiva y Pruebas ................................................................................ 2 2. Timbrado CFDI de Retención .................................................................................... 2 2.1. Parámetros ........................................................................................................................................................... 3 2.2. Códigos de Respuesta ...................................................................................................................................... 4 2.3. Ejemplo de la petición ..................................................................................................................................... 5 2.4. Ejemplo de una respuesta correcta ........................................................................................................... 7 2.5. Ejemplo de respuesta con error .................................................................................................................. 8 3. Cancelación 1 a 1 de CFDI de Retención................................................................... 9 3.1. Parámetros ........................................................................................................................................................ 10 3.2. Códigos de Respuesta ................................................................................................................................... 11 3.3. Ejemplo de petición ....................................................................................................................................... 12 3.4. Ejemplo respuesta correcta con código http 200 y código de estatus 1201......................... 14 3.5. Ejemplo respuesta con error código http 200 y código de estatus 1XXX............................... 15 3.6. Ejemplo de error con código http 400 y código de estatus XXX ................................................. 16 3.7. Ejemplo de error con código http 400 y sin código de estatus ................................................... 16 4. Cancelación de más de un CFDI de Retención ......................................................... 17 4.1. Parámetros ........................................................................................................................................................ 17 4.2. Códigos de Respuesta ................................................................................................................................... 18 4.3. Ejemplo de petición ....................................................................................................................................... 19 4.4. Ejemplo de respuesta.................................................................................................................................... 22 5. Consulta de Acuse de Cancelación.......................................................................... 23 5.1. Parámetros ........................................................................................................................................................ 23 5.2. Códigos de respuesta .................................................................................................................................... 24 5.3. Ejemplo de petición ....................................................................................................................................... 24 5.4. Ejemplo de respuesta.................................................................................................................................... 24

Transcript of Timbrado CFDI de Retención v20150216 - Tralix

Page 1: Timbrado CFDI de Retención v20150216 - Tralix

 1  

Timbrado  y  Cancelación  CFDI  de  Retención  

Tabla  de  contenido  

1.   Dirección  Productiva  y  Pruebas  ................................................................................  2  

2.   Timbrado  CFDI  de  Retención  ....................................................................................  2  2.1.   Parámetros  ...........................................................................................................................................................  3  2.2.   Códigos  de  Respuesta  ......................................................................................................................................  4  2.3.   Ejemplo  de  la  petición  .....................................................................................................................................  5  2.4.   Ejemplo  de  una  respuesta  correcta  ...........................................................................................................  7  2.5.   Ejemplo  de  respuesta  con  error  ..................................................................................................................  8  

3.   Cancelación    1  a  1  de  CFDI  de  Retención  ...................................................................  9  3.1.   Parámetros  ........................................................................................................................................................  10  3.2.   Códigos  de  Respuesta  ...................................................................................................................................  11  3.3.   Ejemplo  de  petición  .......................................................................................................................................  12  3.4.   Ejemplo  respuesta  correcta  con  código  http  200  y  código  de  estatus  1201  .........................  14  3.5.   Ejemplo  respuesta  con  error  código  http  200  y  código  de  estatus  1XXX  ...............................  15  3.6.   Ejemplo  de  error  con  código  http  400  y  código  de  estatus  XXX  .................................................  16  3.7.   Ejemplo  de  error  con  código  http  400  y  sin  código  de  estatus  ...................................................  16  4.   Cancelación  de  más  de  un  CFDI  de  Retención  .........................................................  17  4.1.   Parámetros  ........................................................................................................................................................  17  4.2.   Códigos  de  Respuesta  ...................................................................................................................................  18  4.3.   Ejemplo  de  petición  .......................................................................................................................................  19  4.4.   Ejemplo  de  respuesta  ....................................................................................................................................  22  5.   Consulta  de  Acuse  de  Cancelación  ..........................................................................  23  5.1.   Parámetros  ........................................................................................................................................................  23  5.2.   Códigos  de  respuesta  ....................................................................................................................................  24  5.3.   Ejemplo  de  petición  .......................................................................................................................................  24  5.4.   Ejemplo  de  respuesta  ....................................................................................................................................  24          

Page 2: Timbrado CFDI de Retención v20150216 - Tralix

 2  

1. Dirección  Productiva  y  Pruebas    Dirección  Productiva:  https://timbrador.tralix.com:7070/retenciones    Dirección  de  Pruebas:  https://pruebastfd.tralix.com:7070/retenciones  

2. Timbrado  CFDI  de  Retención  Con  este  servicio  se  podrá  realizar  el  timbrado  de  un  CFDI  de  retención  (exclusivamente)    Documentación  sobre  retenciones      El  servicio  responderá  a  las  peticiones  con  un  código  de  respuesta  http  200  sin  importar  si  la  operación  fue  exitosa  o  con  error,  este  código  indica  que  se  recibió  la  petición  correctamente  y  que  el  recurso  esta  disponible.    En  caso  de  que  la  petición  este  incompleta  (falta  de  parámetros),  se  regresará  un  código  http  400    En  caso  de  que  el  recurso  no  este  disponible,  se  regresará  un  código  http  404.    

 

 Es  sumamente  importante  NO  confundir  los  códigos  de  respuesta  http  con  los  códigos  de  respuesta  del  servicio,  son  completamente  diferentes  e  independientes.  

Ejemplo código http:

HTTP/1.1 200 OK

Ejemplo código de respuesta del servicio:

<Error código="301">

Para  la  firma  de  las  peticiones  se  utiliza  el  estándar  XML  Security,  este  bloque  de  XML  se  tiene  que  generar  en  este  estándar  NO  generar  manualmente    El  esquema  para  manejo  especifico  usando  XML  Signature,  parte  de  XML  Security  es:  http://www.w3.org/TR/2002/REC-xmldsig-core-20020212/xmldsig-core-schema.xsd

Page 3: Timbrado CFDI de Retención v20150216 - Tralix

 3  

Específicamente hay que utilizar: Método de digestión: SHA-1 Método de canonización: INCLUSIVE Método de firmado: RSA_SHA1 Tipo de certificado para sellado: x509  

   

2.1. Parámetros    

Tipo  de  Petición:  POST  http  1.1    Ruta:  https://[SERVIDOR]:[PUERTO]/retenciones/    La  solicitud  es  1  a  1,  no  se  puede  incluir  mas  de  un  XML.  El  XSD  del  XML  se  incluye  como  archivo  separado.      

   

Parámetro Tipo Valor Requerido Observaciones

Content-Type

Header text/xml; charset=UTF-8

SI El valor debe de ser tal cual se muestra.

customerKey Header CUSTOMER_KEY SI Debe de ir el customerkey del cliente que desea timbrar su comprobante de retenciones

Contenido Contenido XML_DE_RETENCIONES SI Este es el contenido de la llamada, es el xml de retenciones a timbrar de acuerdo al estándar técnico que a continuación se proporciona la liga: XSD del XML

 Respuesta:  XML  del  timbre  o  XML  con  error.    

Page 4: Timbrado CFDI de Retención v20150216 - Tralix

 4  

2.2. Códigos  de  Respuesta    

Código Tipo Descripción

200 SUCCESS Se pudo timbrar el comprobante y se regresa el timbre.

301 ERROR El XML no está construido conforme al W3C y/o con la estructura del XSD publicado en el Anexo 20 del RMF

302 ERROR El sello del emisor no está generado correctamente.

303 ERROR El CSD del emisor no corresponda al RFC establecido como emisor del comprobante.

304 ERROR El CSD del emisor ha sido revocado

305 ERROR La fecha de emisión no se encuentre dentro de la vigencia del CSD del emisor.

306 ERROR El certificado utilizado corresponde a una FIEL

307 ERROR El XML ya cuenta con un nodo TimbreFiscalDigital

308 ERROR El CSD del emisor no es un certificado emitido por la autoridad del SAT

401 ERROR El rango de la fecha de generación es mayor a 72 horas con base en la fecha de emisión

402 ERROR El RFC del emisor no está autorizado para emisión de CFDI (no se encuentra en la lista autorizada del SAT)

901 ERROR El cliente con el key #CUSTOMER_KEY no es válido.

902 ERROR El RFC #RFC no está registrado

903 ERROR El RFC #RFC se encuentra inactivo por el momento

904 ERROR No cuenta con licencia para realizar peticiones

905 ERROR El RFC #RFC no pertenece al cliente con el key #KEY

907 ERROR Debe invocar al servicio con el customerkey que le fue asignado

910 ERROR No se puede determinar el cliente a partir del RFC #RFC, verifique que el

Page 5: Timbrado CFDI de Retención v20150216 - Tralix

 5  

Código Tipo Descripción

valor de la cabecera de customerkey

990 ERROR Su comprobante es válido, pero no se puede generar un timbre fiscal por el momento.

999 ERROR Error interno en el servidor, por favor intente más tarde

   

2.3. Ejemplo  de  la  petición  

POST /retenciones/ HTTP/1.1 Accept-Encoding: gzip,deflate Content-Type: text/xml;charset=UTF-8 customerkey: b391655ac2242d85ddd36d37b482259b1b7dfc1a Content-Length: 4506 Host: 10.0.4.122:9000 Connection: Keep-Alive User-Agent: Apache-HttpClient/4.1.1 (java 1.5) <retenciones:Retenciones xmlns:retenciones="http://www.sat.gob.mx/esquemas/retencionpago/1" xmlns:c_retenciones="http://www.sat.gob.mx/esquemas/retencionpago/1/catalogos" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.sat.gob.mx/esquemas/retencionpago/1 http://www.sat.gob.mx/esquemas/retencionpago/1/retencionpagov1.xsd" Version="1.0" FolioInt="WrFWxxpdiw" CveRetenc="14" DescRetenc="czEZd3kKTYg5C7CDBf5qVpvnE8uhLU" Sello="H8Eoo93RfhyV28PlXVBXRuu4tYIVR8Qu6jcqZA8V032l0pkkrzh30mcxbyWRPzNzJc7pZdMItD1ffsS+NnpQEGgB1rJlnI7wFhvJLkk3nQQ6jWVJdMTgXvFxPcCtH4d1FYL/4NcLw1XF6PWEM/vkQp1QeUovRoWqQQpDUa3kx0RGN5Ed8mz8cBh5q38GkfyqlrYoi2cF40w3S4oclfmLTONdF4moOVS8WcXPh4S1f0NQHNF0GDUNMvQaGGI+95UYg1101x70uPEPa3vaBCUWBy7ab2zfELFy8UOpreXEVXzFsnMkY4jwDLcAaSSZjBpnYkmkkEWZNB7Mj2QCkdE1lg==" NumCert="20001000000300004872" Cert="MIIGEDCCA/igAwIBAgIUMjAwMDEwMDAwMDAzMDAwMDQ4NzIwDQYJKoZIhvcNAQELBQAwggFmMSAwHgYDVQQDDBdBLkMuIDIgZGUgcHJ1ZWJhcyg0MDk2KTEvMC0GA1UECgwmU2VydmljaW8gZGUgQWRtaW5pc3RyYWNpw7NuIFRyaWJ1dGFyaWExODA2BgNVBAsML0FkbWluaXN0cmFjacOzbiBkZSBTZWd1cmlkYWQgZGUgbGEgSW5mb3JtYWNpw7NuMSkwJwYJKoZIhvcNAQkBFhphc2lzbmV0QHBydWViYXMuc2F0LmdvYi5teDEmMCQGA1UECQwdQXYuIEhpZGFsZ28gNzcsIENvbC4gR3VlcnJlcm8xDjAMBgNVBBEMBTA2MzAwMQswCQYDVQQGEwJNWDEZMBcGA1UECAwQRGlzdHJpdG8gRmVkZXJhbDESMBAGA1UEBwwJQ295b2Fjw6FuMRUwEwYDVQ

Page 6: Timbrado CFDI de Retención v20150216 - Tralix

 6  

QtEwxTQVQ5NzA3MDFOTjMxITAfBgkqhkiG9w0BCQIMElJlc3BvbnNhYmxlOiBBQ0RNQTAeFw0xNDEwMDgxNTA5MzBaFw0xODEwMDcxNTA5MzBaMIHKMSAwHgYDVQQDExdIRUNUT1IgVkFaUVVFWiBCRUNFUlJJTDEgMB4GA1UEKRMXSEVDVE9SIFZBWlFVRVogQkVDRVJSSUwxIDAeBgNVBAoTF0hFQ1RPUiBWQVpRVUVaIEJFQ0VSUklMMQswCQYDVQQGEwJNWDEgMB4GCSqGSIb3DQEJARYRcHJ1ZWJhQHNhdC5nb2IubXgxFjAUBgNVBC0TDUdBVkE3MzA3MTdBRTExGzAZBgNVBAUTEkdBVkE3MzA3MTdIREZSR1IwNTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAJjnMOxpkQkTGXmJpXf0qnBSRatOtkbi8c0iHAKYS1XASXrxkJLXt2ZkFg83EkkZxyRZ7+5qFG7qKUET3BDmdLW8RTBuWSLzonlUAjNfSTjuNNG0ZNxpTGHHsOenRUfPwNx9yopzU6YKHAfNoeoyXsbsLg1Iyezal/vu86pa5Bonb/hTj6GMHg7Wj7oFit3ilVUu5Bc9a1djT3JJVuCXaT+Mspd3UiwtYxZihD4hZhuT8wqYEFfulUykofIeuexCKBdV6ugaD9Ub1/GOyhzNymYzM1WlPfgKxCed6KQ1CaJLM3jo3U79izakxfH45ghlol7SxXHidF3tYpgknv6TgU8CAwEAAaNPME0wDAYDVR0TAQH/BAIwADALBgNVHQ8EBAMCA9gwEQYJYIZIAYb4QgEBBAQDAgWgMB0GA1UdJQQWMBQGCCsGAQUFBwMEBggrBgEFBQcDAjANBgkqhkiG9w0BAQsFAAOCAgEAkRIj1K/mOCyd/cyxb9m9HpAWgUUwKG00gQXwiM6cJYMGhjk6e2kclCUPUnp2Ct8Gn4JoHA8jTI8JOv1C7sJor0eO+xAtElvYh4d7NmGZvpZ1BkCt43EAt0gq/NVH37GLWuPC934dlLiq0m9Tv/7UqjVKQKWAKnQc008GJTY+vI8bk1rRctY6RqvhiKnDcwJeNvQfWAnFUJ2L6+ffphvbvuuWZrAvi8CNIZ6ZFwCkGpFAoKXErPTy4lyTPfsPpg5B6BxhskJH5g5QL8KrpkCheMHgYfQv+YxOKK8ohpcxaEK+CF/QQkfWGSfzTjKO/fN+uht18UYiuGblwXkGV+N0OLPQZUzjtwEJSLFHLI+3BuDU96baJXmxC31RhdNnRepqoKtALKNVDadpaoCZtTICb6y1FAvI31RrPOUh1O7GbGGhqGQL96eD3q8UvG99/FRc0Ah4xRCjOg52TLbnhx7eQFA2HIccRBdceELUSGE3YoadB6q1AE68Q6hfP8Ohi20TvgmLZOTfncVIqszK3jn+e71nYCQdH1D6ZsLIx0L5h7CiWRvliiMulloiA9UxjJ1nwssVNHgNBhqAOFPw0rYnHrsbcKW5yiNPAhZinqPVdxBWgeIP3ClyhhrV5jG6GxEUQcf0CWdwHLYTxcWksqqBvkRhj++ft29e5p/lm47XThE=" FechaExp="2014-12-31T00:12:44-06:00"> <retenciones:Emisor NomDenRazSocE="B12qqJPvbzicLteYX4lAFgZyIGV_SCDqsscR9yDfvA" CURPE="OUQS071135HTKDMM71" RFCEmisor="GAVA730717AE1"></retenciones:Emisor> <retenciones:Receptor Nacionalidad="Nacional"> <retenciones:Nacional RFCRecep="ROMS840217334" NomDenRazSocR="yF_mXEVfVFSqjLmZNYkTNFCEB" CURPR="ROMS840217HDFBNL08"></retenciones:Nacional> </retenciones:Receptor> <retenciones:Periodo MesIni="1" MesFin="1" Ejerc="2018"></retenciones:Periodo> <retenciones:Totales montoTotOperacion="-1042100477.129960" montoTotGrav="-611198413.368977" montoTotExent="390722533.198222" montoTotRet="290337479.363040"> <retenciones:ImpRetenidos BaseRet="-2127950176.684901" Impuesto="01" montoRet="-2034498177.324182" TipoPagoRet="Pago

Page 7: Timbrado CFDI de Retención v20150216 - Tralix

 7  

definitivo"></retenciones:ImpRetenidos> <retenciones:ImpRetenidos BaseRet="1475898795.992613" Impuesto="03" montoRet="-1004131097.820072" TipoPagoRet="Pago definitivo"></retenciones:ImpRetenidos> </retenciones:Totales> <retenciones:Complemento> <sectorfinanciero:SectorFinanciero xmlns:sectorfinanciero="http://www.sat.gob.mx/esquemas/retencionpago/1/sectorfinanciero" xsi:schemaLocation="http://www.sat.gob.mx/esquemas/retencionpago/1/sectorfinanciero http://www.sat.gob.mx/esquemas/retencionpago/1sectorfinanciero/sectorfinanciero.xsd" Version="1.0" IdFideicom="10" NomFideicom="Nombre" DescripFideicom="Descripcion"></sectorfinanciero:SectorFinanciero> </retenciones:Complemento> <retenciones:Addenda> </retenciones:Addenda> </retenciones:Retenciones>

2.4. Ejemplo  de  una  respuesta  correcta  

HTTP/1.1 200 OK Content-Type: text/xml;charset=utf-8 Content-Length: 1111 <?xml version="1.0" encoding="utf-8"?> <tfd:TimbreFiscalDigital xmlns:tfd="http://www.sat.gob.mx/TimbreFiscalDigital" xsi:schemaLocation="http://www.sat.gob.mx/TimbreFiscalDigital http://www.sat.gob.mx/TimbreFiscalDigital/TimbreFiscalDigital.xsd" version="1.0" UUID="5DBA5276-EFD7-4933-9312-A93228508B49" FechaTimbrado="2015-01-02T12:15:01" selloCFD="H8Eoo93RfhyV28PlXVBXRuu4tYIVR8Qu6jcqZA8V032l0pkkrzh30mcxbyWRPzNzJc7pZdMItD1ffsS+NnpQEGgB1rJlnI7wFhvJLkk3nQQ6jWVJdMTgXvFxPcCtH4d1FYL/4NcLw1XF6PWEM/vkQp1QeUovRoWqQQpDUa3kx0RGN5Ed8mz8cBh5q38GkfyqlrYoi2cF40w3S4oclfmLTONdF4moOVS8WcXPh4S1f0NQHNF0GDUNMvQaGGI+95UYg1101x70uPEPa3vaBCUWBy7ab2zfELFy8UOpreXEVXzFsnMkY4jwDLcAaSSZjBpnYkmkkEWZNB7Mj2QCkdE1lg==" noCertificadoSAT="20001000000300003693" selloSAT="rQ4u/te+tikTs6n+deDt8uqqH1PrkeDClLjcL96b3e0gSLLwUpGJkhWnKmRuaK9bIB+TJjJboJoacRcdSk3grUhC+U9DIUlX20FwXUKQIlEBJMHevzu6nK3KMKUEkvt9dr4ufSNtwva++DsRw0v6Is1uQcjWKz9lxBazLjUVRAk=" />

Page 8: Timbrado CFDI de Retención v20150216 - Tralix

 8  

 

2.5. Ejemplo  de  respuesta  con  error      

Para conocer la estructura del XML de respuesta se anexa en este paquete de documentación su XSD en /Cancelacion/Individual/AcuseCancelacionIndividual_Error.xsd  

HTTP/1.1 200 OK Content-Type: text/xml;charset=utf-8 Content-Length: 356 <?xml version="1.0" encoding="utf-8"?> <Error código="301"> <descripcionError> El CFD no cumple con la estructura correcta: org.xml.sax.SAXParseException; lineNumber: 2; columnNumber: 141; The element type &quot;retenciones:Emisores&quot; must be terminated by the matching end-tag &quot;&lt;/retenciones:Emisores&gt;&quot;.</descripcionError> </Error>

   

Page 9: Timbrado CFDI de Retención v20150216 - Tralix

 9  

3. Cancelación    1  a  1  de  CFDI  de  Retención  Con  este  servicio  se  podrá  cancelar  un  CFDI  de  retención  (exclusivamente)  obteniendo  un  acuse  de  cancelación  a  manera  de  comprobante.    

 

 Es  sumamente  importante  NO  confundir  los  códigos  de  respuesta  http  con  los  códigos  de  respuesta  del  servicio,  son  completamente  diferentes  e  independientes.  

Ejemplo código http:

HTTP/1.1 200 OK

Ejemplo código de respuesta del servicio:

<Error código="301">

Cuando se genera un error http 400 y estatus XXX

La respuesta se entrega en texto plano, en formato JSON. Ejem. {"errorCodigo":"902", "descripcionError":" El RFC "GAVA730717AE1" no está registrado."}

Cuando se genera un error http 400 y sin código de estatus

La respuesta se entrega en texto plano, en formato JSON. Ejem. Falta Header: ipAddress

Para  la  firma  de  las  peticiones  se  utiliza  el  estándar  XML  Security,  este  bloque  de  XML  se  tiene  que  generar  en  este  estándar  NO  generar  manualmente    El  esquema  para  manejo  especifico  usando  XML  Signature,  parte  de  XML  Security  es:  http://www.w3.org/TR/2002/REC-xmldsig-core-20020212/xmldsig-core-schema.xsd Específicamente hay que utilizar:

Page 10: Timbrado CFDI de Retención v20150216 - Tralix

 10  

Método de digestión: SHA-1 Método de canonización: INCLUSIVE Método de firmado: RSA_SHA1 Tipo de certificado para sellado: x509  

   

3.1. Parámetros    

Tipo  de  petición:  POST  http  1.1    Ruta:  https://[SERVIDOR]:[PUERTO]/retenciones/cancelaUNO/    En  esta  petición  solo  se  puede  cancelar  un  CFDI  de  retención.  El  XSD  del  XML  se  incluye  como  archivo  separado.  

   

Parámetro Tipo Valor Requerido Observaciones

Content-Type

Header text/xml; charset=UTF-8

SI El valor debe de ser tal cual se muestra.

idCustomer Header CUSTOMER_KEY SI Debe de ir el customerkey del cliente que desea cancelar su comprobante de retenciones.

ipAddress Header IP_CLIENTE SI Esta ip con la que se está intentado cancelar.

Contenido Contenido XML_DE_CANCELACION SI Xml de cancelación de acuerdo al estándar del SAT Anexo en este paquete de documentación como /Cancelacion/XMLCancelacion.xsd

 Resultado:  XML  acuse  de  cancelación  o  XML  de  error  

     

Page 11: Timbrado CFDI de Retención v20150216 - Tralix

 11  

3.2. Códigos  de  Respuesta    

Código HTTP

Código Tipo Descripción

200 1201 SUCCESS UUID Cancelado

200 1202 ERROR Previamente cancelado

200 1203 ERROR UUID no corresponde con el emisor

200 1205 ERROR UUID No existe

200 1300 ERROR Autenticación no válida

200 1301 ERROR XML mal formado

200 1302 ERROR Estructura de folios no válida

200 1303 ERROR Estructura de RFC no válida

200 1304 ERROR Estructura de fecha no válida

200 1305 ERROR Certificado no corresponde al emisor

200 1306 ERROR Certificado no vigente

200 1307 ERROR Uso de FIEL no permitido

200 1308 ERROR Certificado revocado o caduco

200 1309 ERROR Firma mal formada o inválida

400 308 ERROR El CSD del emisor no es un certificado emitido por la autoridad del SAT.

400 401 ERROR El rango de la fecha de generación es mayor a 72 horas con base en la fecha de emisión

400 901 ERROR El cliente con el CustomerKey proporcionado no es válido

400 902 ERROR El RFC no esta registrado como cliente

400 903 ERROR El RFC se encuentra inactivo por el momento

Page 12: Timbrado CFDI de Retención v20150216 - Tralix

 12  

Código HTTP

Código Tipo Descripción

400 904 ERROR No cuenta con licencia para realizar peticiones

400 905 ERROR El RFC no pertenece al cliente con el CustomerKey que proporciono

400 910 ERROR No se puede determinar el cliente a partir del RFC

400 999 ERROR Error interno en el servidor

400 407 ERROR Error en el servicio de Cancelación del SAT

400 ERROR Cuando faltan parámetros requeridos en la petición

3.3. Ejemplo  de  petición  

POST /retenciones/cancelaUno/ HTTP/1.1 Accept-Encoding: gzip,deflate Content-Type: text/xml; charset=UTF-8 idCustomer: b391655ac2242d85ddd36d37b482259b1b7dfc1a ipAddress: 10.0.0.88 Content-Length: 4007 Host: 10.0.4.122:9000 Connection: Keep-Alive User-Agent: Apache-HttpClient/4.1.1 (java 1.5) <Cancelacion xmlns="http://cancelaretencion.sat.gob.mx" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Fecha="2014-12-31T13:14:53" RfcEmisor="GAVA730717AE1"><Folios><UUID>0E6F67DD-6765-46EC-9447-D8CD759D2286</UUID></Folios><Signature xmlns="http://www.w3.org/2000/09/xmldsig#"><SignedInfo><CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"></CanonicalizationMethod><SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"></SignatureMethod><Reference URI=""><Transforms><Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"></Transform></Transforms><DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"></DigestMethod><DigestValue>WMQbS6vPsNK9Qj0ItYXpT2MORWA=</DigestValue></Reference></SignedInfo><SignatureValue>GlFeSOMtP7gHMHXF0XT2XmqsS1f2Qg6xINwmO6V6K3ft8s4O3MoSw6fxnxEFLlOeojOadSaPL+py OJSQqIF8XChyeE2J1dAdvqmZV3jWN2jX0TyY3FwBd/QClVY3vLvIxIiroJgkG

Page 13: Timbrado CFDI de Retención v20150216 - Tralix

 13  

eduefYy3DC4cC6V QwvwAkTwRi9SnYuROb5f/NAmsLnB5aTLTen0eNDS8PFTnMfkxnb5e5dP+aBxV4wo5oANez11ABYu 1OctfRcdVuJ371Hr16qUSgFGi6kCYJ1TIwj07qdXOaDK+FebNYBOQzwqd0AQRSYADUBeJRtBiaWl h6ij/NsHBjvboz1m8uBGsUsOJOCAAG13CSIOSQ==</SignatureValue><KeyInfo><X509Data><X509IssuerSerial><X509IssuerName>OID.1.2.840.113549.1.9.2=Responsable: ACDMA, OID.2.5.4.45=SAT970701NN3, L=Coyoac[0xc3][0xa1]n, ST=Distrito Federal, C=MX, OID.2.5.4.17=06300, STREET="Av. Hidalgo 77, Col. Guerrero", [email protected], OU=Administraci[0xc3][0xb3]n de Seguridad de la Informaci[0xc3][0xb3]n, O=Servicio de Administraci[0xc3][0xb3]n Tributaria, CN=A.C. 2 de pruebas(4096)</X509IssuerName><X509SerialNumber>286524172099382162235533054548081509954831791922</X509SerialNumber></X509IssuerSerial><X509Certificate>MIIGEDCCA/igAwIBAgIUMjAwMDEwMDAwMDAzMDAwMDQ4NzIwDQYJKoZIhvcNAQELBQAwggFmMSAw HgYDVQQDDBdBLkMuIDIgZGUgcHJ1ZWJhcyg0MDk2KTEvMC0GA1UECgwmU2VydmljaW8gZGUgQWRt aW5pc3RyYWNpw7NuIFRyaWJ1dGFyaWExODA2BgNVBAsML0FkbWluaXN0cmFjacOzbiBkZSBTZWd1 cmlkYWQgZGUgbGEgSW5mb3JtYWNpw7NuMSkwJwYJKoZIhvcNAQkBFhphc2lzbmV0QHBydWViYXMu c2F0LmdvYi5teDEmMCQGA1UECQwdQXYuIEhpZGFsZ28gNzcsIENvbC4gR3VlcnJlcm8xDjAMBgNV BBEMBTA2MzAwMQswCQYDVQQGEwJNWDEZMBcGA1UECAwQRGlzdHJpdG8gRmVkZXJhbDESMBAGA1UE BwwJQ295b2Fjw6FuMRUwEwYDVQQtEwxTQVQ5NzA3MDFOTjMxITAfBgkqhkiG9w0BCQIMElJlc3Bv bnNhYmxlOiBBQ0RNQTAeFw0xNDEwMDgxNTA5MzBaFw0xODEwMDcxNTA5MzBaMIHKMSAwHgYDVQQD ExdIRUNUT1IgVkFaUVVFWiBCRUNFUlJJTDEgMB4GA1UEKRMXSEVDVE9SIFZBWlFVRVogQkVDRVJS SUwxIDAeBgNVBAoTF0hFQ1RPUiBWQVpRVUVaIEJFQ0VSUklMMQswCQYDVQQGEwJNWDEgMB4GCSqG SIb3DQEJARYRcHJ1ZWJhQHNhdC5nb2IubXgxFjAUBgNVBC0TDUdBVkE3MzA3MTdBRTExGzAZBgNV BAUTEkdBVkE3MzA3MTdIREZSR1IwNTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAJjn MOxpkQkTGXmJpXf0qnBSRatOtkbi8c0iHAKYS1XASXrxkJLXt2ZkFg83EkkZxyRZ7+5qFG7qKUET 3BDmdLW8RTBuWSLzonlUAjNfSTjuNNG0ZNxpTGHHsOenRUfPwNx9yopzU6YKH

Page 14: Timbrado CFDI de Retención v20150216 - Tralix

 14  

AfNoeoyXsbsLg1I yezal/vu86pa5Bonb/hTj6GMHg7Wj7oFit3ilVUu5Bc9a1djT3JJVuCXaT+Mspd3UiwtYxZihD4h ZhuT8wqYEFfulUykofIeuexCKBdV6ugaD9Ub1/GOyhzNymYzM1WlPfgKxCed6KQ1CaJLM3jo3U79 izakxfH45ghlol7SxXHidF3tYpgknv6TgU8CAwEAAaNPME0wDAYDVR0TAQH/BAIwADALBgNVHQ8E BAMCA9gwEQYJYIZIAYb4QgEBBAQDAgWgMB0GA1UdJQQWMBQGCCsGAQUFBwMEBggrBgEFBQcDAjAN BgkqhkiG9w0BAQsFAAOCAgEAkRIj1K/mOCyd/cyxb9m9HpAWgUUwKG00gQXwiM6cJYMGhjk6e2kc lCUPUnp2Ct8Gn4JoHA8jTI8JOv1C7sJor0eO+xAtElvYh4d7NmGZvpZ1BkCt43EAt0gq/NVH37GL WuPC934dlLiq0m9Tv/7UqjVKQKWAKnQc008GJTY+vI8bk1rRctY6RqvhiKnDcwJeNvQfWAnFUJ2L 6+ffphvbvuuWZrAvi8CNIZ6ZFwCkGpFAoKXErPTy4lyTPfsPpg5B6BxhskJH5g5QL8KrpkCheMHg YfQv+YxOKK8ohpcxaEK+CF/QQkfWGSfzTjKO/fN+uht18UYiuGblwXkGV+N0OLPQZUzjtwEJSLFH LI+3BuDU96baJXmxC31RhdNnRepqoKtALKNVDadpaoCZtTICb6y1FAvI31RrPOUh1O7GbGGhqGQL 96eD3q8UvG99/FRc0Ah4xRCjOg52TLbnhx7eQFA2HIccRBdceELUSGE3YoadB6q1AE68Q6hfP8Oh i20TvgmLZOTfncVIqszK3jn+e71nYCQdH1D6ZsLIx0L5h7CiWRvliiMulloiA9UxjJ1nwssVNHgN BhqAOFPw0rYnHrsbcKW5yiNPAhZinqPVdxBWgeIP3ClyhhrV5jG6GxEUQcf0CWdwHLYTxcWksqqB vkRhj++ft29e5p/lm47XThE=</X509Certificate></X509Data></KeyInfo></Signature></Cancelacion>

3.4. Ejemplo  respuesta  correcta  con  código  http  200  y  código  de  estatus  1201    

Para conocer la estructura del XML de respuesta se anexa en este paquete de documentación su XSD en /Cancelacion/Individual/AcuseCancelacionIndividual.xsd  

HTTP/1.1 200 OK Cache-Control: no-cache Pragma: no-cache Content-Length: 1501 Content-Type: application/xml; charset=utf-8 Expires: -1 Server: Microsoft-IIS/8.5 X-AspNet-Version: 4.0.30319 X-Powered-By: ASP.NET Date: Wed, 31 Dec 2014 19:17:53 GMT <?xml version="1.0"?><Acuse xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

Page 15: Timbrado CFDI de Retención v20150216 - Tralix

 15  

Fecha="2014-12-31T13:17:53.0816119" RfcEmisor="GAVA730717AE1" WorkProcessId="108fe0ae-0402-41ea-b603-bba3b338057e" xmlns="http://www.sat.gob.mx/esquemas/retencionpago/1"><Folios><UUID>CF93C8F6-E9EE-4AD5-9CC0-4E771CE726B6</UUID><EstatusUUID>1201</EstatusUUID></Folios><Signature Id="SelloSAT" xmlns="http://www.w3.org/2000/09/xmldsig#"><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>XG1pp/m3TuS2j971YCxqMa7aTi2MW/pHNElJwEzFB9So5QEjgcRXnyC4xoEJDG5yZF8yqo9aNWuDMkfwAvQKQA==</DigestValue></Reference></SignedInfo><SignatureValue>s8trd9ZLoW2axhyXXssfa4MeBrCK0T5p1JfuRGOFbj8JCF5f3+hqgx5tSyvuEWo3leDGpSs7gmYjgBCc4xF7gw==</SignatureValue><KeyInfo><KeyName>20001000000300003586</KeyName><KeyValue><RSAKeyValue><Modulus>n77fbi0dTENVn43LCUOIF/8iyQObFg/AaTRBdpf0fVuozOOy48INue46sN54AHL+I50s1U8Nh6Dq+MRvRNc8WyHPQWsnmSaicT5vAkkzqucVj004WyLcmpysY45DrCxSitPMRzop3XboPr1msWd3EuyduUtbu3QmNRin8uzpYg8=</Modulus><Exponent>AQAB</Exponent></RSAKeyValue></KeyValue></KeyInfo></Signature></Acuse>

3.5. Ejemplo  respuesta  con  error  código  http  200  y  código  de  estatus  1XXX    

Para conocer la estructura del XML de respuesta se anexa en este paquete de documentación su XSD en /Cancelacion/Individual/AcuseCancelacionIndividual_Error.xsd  

HTTP/1.1 200 OK Cache-Control: no-cache Pragma: no-cache Content-Length: 1409 Content-Type: application/xml; charset=utf-8 Expires: -1 Server: Microsoft-IIS/8.5 X-AspNet-Version: 4.0.30319 X-Powered-By: ASP.NET Date: Wed, 31 Dec 2014 20:46:59 GMT <?xml version="1.0"?><Acuse xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" CodEstatus="1301" Fecha="2014-12-31T14:46:59.5187095" RfcEmisor="" WorkProcessId="238a0fec-8004-426d-a846-cd69103f7288" xmlns="http://www.sat.gob.mx/esquemas/retencionpago/1"><Signa

Page 16: Timbrado CFDI de Retención v20150216 - Tralix

 16  

ture Id="SelloSAT" xmlns="http://www.w3.org/2000/09/xmldsig#"><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>KVsuu6MBIq35WvJZ4regrxHPg9UEtiMizXsX14P6o2Dm0UbI1BHz7xUW5AqZ5HzY399PTzRSAPgmT8DEDQQjkg==</DigestValue></Reference></SignedInfo><SignatureValue>LpABcSjt+vbvRp876GcR0l1UajX5Z5P6/f4qilRyIH1Y06DWYbmy74Fnc3iyKtTqXDSPkPzg7J3Ktfyc7WbSuw==</SignatureValue><KeyInfo><KeyName>20001000000300003586</KeyName><KeyValue><RSAKeyValue><Modulus>n77fbi0dTENVn43LCUOIF/8iyQObFg/AaTRBdpf0fVuozOOy48INue46sN54AHL+I50s1U8Nh6Dq+MRvRNc8WyHPQWsnmSaicT5vAkkzqucVj004WyLcmpysY45DrCxSitPMRzop3XboPr1msWd3EuyduUtbu3QmNRin8uzpYg8=</Modulus><Exponent>AQAB</Exponent></RSAKeyValue></KeyValue></KeyInfo></Signature></Acuse>

3.6. Ejemplo  de  error  con  código  http  400  y  código  de  estatus  XXX  

HTTP/1.1 400 Bad Request Content-Type: text/plain; charset=utf-8 Content-Length: 88 {"errorCodigo":"902", "descripcionError":" El RFC "GAVA730717AE1" no está registrado."}

3.7. Ejemplo  de  error  con  código  http  400  y  sin  código  de  estatus  

HTTP/1.1 400 Bad Request Content-Type: text/plain; charset=utf-8 Content-Length: 23 Falta Header: ipAddress

   

Page 17: Timbrado CFDI de Retención v20150216 - Tralix

 17  

4. Cancelación  de  más  de  un  CFDI  de  Retención  Con  este  servicio  se  podrá  cancelar  mas  de  un  CFDI  de  retención  (exclusivamente)  y  se  obtendrá  el  acuse  de  cada  documento  cancelado(una  sola  respuesta  que  contiene  todos  los  acuses).      

 

 Es  sumamente  importante  NO  confundir  los  códigos  de  respuesta  http  con  los  códigos  de  respuesta  del  servicio,  son  completamente  diferentes  e  independientes.  

Ejemplo código http:

HTTP/1.1 200 OK

Ejemplo código de respuesta del servicio:

<Error código="301">

Para  la  firma  de  las  peticiones  se  utiliza  el  estándar  XML  Security,  este  bloque  de  XML  se  tiene  que  generar  en  este  estándar  NO  generar  manualmente    El  esquema  para  manejo  especifico  usando  XML  Signature,  parte  de  XML  Security  es:  http://www.w3.org/TR/2002/REC-xmldsig-core-20020212/xmldsig-core-schema.xsd Específicamente hay que utilizar: Método de digestión: SHA-1 Método de canonización: INCLUSIVE Método de firmado: RSA_SHA1 Tipo de certificado para sellado: x509  

   

4.1. Parámetros    Tipo  de  petición:  POST  http  1.1    Ruta:    https://[SERVIDOR]:[PUERTO]/retenciones/cancela/    

Page 18: Timbrado CFDI de Retención v20150216 - Tralix

 18  

El  XSD  del  XML  se  incluye  como  archivo  separado.      

Parámetro Tipo Valor Requerido Observaciones

Content-Type

Header text/xml; charset=UTF-8

SI El valor debe de ser tal cual se muestra.

idCustomer Header CUSTOMER_KEY SI Debe de ir el customerkey del cliente que desea cancelar su comprobante de retenciones.

ipAddress Header IP_CLIENTE SI Esta ip con la que se está intentado cancelar.

Contenido Contenido XML_DE_CANCELACION SI Xml de cancelación de acuerdo al estándar del SAT Anexo en este paquete de documentación como /Cancelacion/XMLCancelacion.xsd

 Respuesta:  XML  del  folio  de  seguimiento  de  la  cancelación  o  XML  con  error.  

 

4.2. Códigos  de  Respuesta    

Código HTTP

Código Tipo Descripción

200 SUCCESS Se pudo hacer la petición de cancelación y se regresa el folio que regresa el servicio del SAT.

400 308 ERROR El CSD del emisor no es un certificado emitido por la autoridad del SAT.

400 401 ERROR El rango de la fecha de generación es mayor a 72 horas con base en la fecha de emisión

400 901 ERROR El cliente con el CustomerKey proporcionado no es válido

400 902 ERROR El RFC no esta registrado como cliente

Page 19: Timbrado CFDI de Retención v20150216 - Tralix

 19  

Código HTTP

Código Tipo Descripción

400 903 ERROR El RFC se encuentra inactivo por el momento

400 904 ERROR No cuenta con licencia para realizar peticiones

400 905 ERROR El RFC no pertenece al cliente con el CustomerKey que proporciono

400 910 ERROR No se puede determinar el cliente a partir del RFC

400 999 ERROR Error interno en el servidor

400 407 ERROR Error en el servicio de Cancelación del SAT

400 ERROR Cuando faltan parámetros requeridos en la petición

4.3. Ejemplo  de  petición  

POST /retenciones/cancela/ HTTP/1.1 Accept-Encoding: gzip,deflate Content-Type: text/xml;charset=UTF-8 idCustomer: b391655ac2242d85ddd36d37b482259b1b7dfc1a ipAddress: 10.0.0.88 Content-Length: 5261 Host: 10.0.4.122:9000 Connection: Keep-Alive User-Agent: Apache-HttpClient/4.1.1 (java 1.5) <Cancelacion xmlns="http://cancelaretencion.sat.gob.mx" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Fecha="2014-12-31T13:38:14" RfcEmisor="GAVA730717AE1"><Folios><UUID>0E6F67DD-6765-46EC-9447-D8CD759D2286</UUID></Folios><Folios><UUID>831D6E47-06C3-439F-BCC6-473175906444</UUID></Folios><Folios><UUID>492C6E43-0FE4-4C8B-83A8-EEEE3BE2C754</UUID></Folios><Folios><UUID>2D6A7EF8-3F9B-4A57-A3B2-7999EEBD9A3B</UUID></Folios><Folios><UUID>0ACC3361-61D4-40B5-A3D1-6C335E393F71</UUID></Folios><Folios><UUID>F739A0B9-8B38-4730-B5AC-42C5271B6891</UUID></Folios><Folios><UUID>DFC7BB92-B9AF-4BD6-8763-60E3BFEAAD3F</UUID></Folios><Folios><UUID>1B531C94-D84C-426D-852C-4278F1DB6CFD</UUID></Folios><Folios><UUID>DEA6708F-67D4-4412-9DF7-4E7ED7E7E38C</UUID></Folios><Folios><UUID>DCD4549A-F31D-4A68-BC4F-7DCF32CC7326</UUID></Folios><Folios><UUID>10319845-5A3D-

Page 20: Timbrado CFDI de Retención v20150216 - Tralix

 20  

4BE2-96D4-D55D72684355</UUID></Folios><Folios><UUID>8F38DA84-98AD-46A5-954D-7024CEF61E11</UUID></Folios><Folios><UUID>09DECA07-5FFC-41D7-9CEB-D1CC51954E87</UUID></Folios><Folios><UUID>49836521-04D3-4682-8D63-6643E7B124B8</UUID></Folios><Folios><UUID>61C9C84C-6D85-4FBE-A896-B2C92A01E191</UUID></Folios><Folios><UUID>D2845C71-76D9-4DFD-9145-2634573FF890</UUID></Folios><Folios><UUID>8F4C9B22-BE4B-483F-9F87-321ACD13DA61</UUID></Folios><Folios><UUID>019086D5-0D41-4406-88C7-7918A4066F47</UUID></Folios><Folios><UUID>A9A86DF0-64EE-4C72-AC47-0BC1BDAF28AC</UUID></Folios><Folios><UUID>A56257FE-3EAB-4BDB-8C8F-E9A4067E114D</UUID></Folios><Signature xmlns="http://www.w3.org/2000/09/xmldsig#"><SignedInfo><CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"></CanonicalizationMethod><SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"></SignatureMethod><Reference URI=""><Transforms><Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"></Transform></Transforms><DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"></DigestMethod><DigestValue>bKsi7Hjc9Y0jFkvOlEhERL8IuJI=</DigestValue></Reference></SignedInfo><SignatureValue>F9iIdKs9UA3rbF2NtSevMxcZq2irKO6cCvLhdPpVMtyMaNQJFvrZdssQa1r9LgmTqAVcG67GrP/w gYbunn4D51+BCbCz4bQ7hbmVbnKQOcqUVllbMZ5O+cj881qenCzLI9DoWgwWb6xrTmuMF1jCab1z VgOsOnwKJT129lrnE+n6S3YglRFgvuTWhUN4JpsfSyIQsAM4pAovXztpcF3aiWILkGZaxvNYMnp2 YTEFRXtJDnLIcgYug0u3t/XeYdHjtd+yJ80MxT03FsJehmnD701p6vnu98P8H/1FuEeq+scKIBgQ YJZxOs9kAqW1djODLgEoLXXX0OrZiABJyI26dQ==</SignatureValue><KeyInfo><X509Data><X509IssuerSerial><X509IssuerName>OID.1.2.840.113549.1.9.2=Responsable: ACDMA, OID.2.5.4.45=SAT970701NN3, L=Coyoac[0xc3][0xa1]n, ST=Distrito Federal, C=MX, OID.2.5.4.17=06300, STREET="Av. Hidalgo 77, Col. Guerrero", [email protected], OU=Administraci[0xc3][0xb3]n de Seguridad de la Informaci[0xc3][0xb3]n, O=Servicio de Administraci[0xc3][0xb3]n Tributaria, CN=A.C. 2 de pruebas(4096)</X509IssuerName><X509SerialNumber>286524172099382162235533054548081509954831791922</X509SerialNumber></X509IssuerSerial><X509Certificate>MIIGEDCCA/igAwIBAgIUMjAwMDEwMDAw

Page 21: Timbrado CFDI de Retención v20150216 - Tralix

 21  

MDAzMDAwMDQ4NzIwDQYJKoZIhvcNAQELBQAwggFmMSAw HgYDVQQDDBdBLkMuIDIgZGUgcHJ1ZWJhcyg0MDk2KTEvMC0GA1UECgwmU2VydmljaW8gZGUgQWRt aW5pc3RyYWNpw7NuIFRyaWJ1dGFyaWExODA2BgNVBAsML0FkbWluaXN0cmFjacOzbiBkZSBTZWd1 cmlkYWQgZGUgbGEgSW5mb3JtYWNpw7NuMSkwJwYJKoZIhvcNAQkBFhphc2lzbmV0QHBydWViYXMu c2F0LmdvYi5teDEmMCQGA1UECQwdQXYuIEhpZGFsZ28gNzcsIENvbC4gR3VlcnJlcm8xDjAMBgNV BBEMBTA2MzAwMQswCQYDVQQGEwJNWDEZMBcGA1UECAwQRGlzdHJpdG8gRmVkZXJhbDESMBAGA1UE BwwJQ295b2Fjw6FuMRUwEwYDVQQtEwxTQVQ5NzA3MDFOTjMxITAfBgkqhkiG9w0BCQIMElJlc3Bv bnNhYmxlOiBBQ0RNQTAeFw0xNDEwMDgxNTA5MzBaFw0xODEwMDcxNTA5MzBaMIHKMSAwHgYDVQQD ExdIRUNUT1IgVkFaUVVFWiBCRUNFUlJJTDEgMB4GA1UEKRMXSEVDVE9SIFZBWlFVRVogQkVDRVJS SUwxIDAeBgNVBAoTF0hFQ1RPUiBWQVpRVUVaIEJFQ0VSUklMMQswCQYDVQQGEwJNWDEgMB4GCSqG SIb3DQEJARYRcHJ1ZWJhQHNhdC5nb2IubXgxFjAUBgNVBC0TDUdBVkE3MzA3MTdBRTExGzAZBgNV BAUTEkdBVkE3MzA3MTdIREZSR1IwNTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAJjn MOxpkQkTGXmJpXf0qnBSRatOtkbi8c0iHAKYS1XASXrxkJLXt2ZkFg83EkkZxyRZ7+5qFG7qKUET 3BDmdLW8RTBuWSLzonlUAjNfSTjuNNG0ZNxpTGHHsOenRUfPwNx9yopzU6YKHAfNoeoyXsbsLg1I yezal/vu86pa5Bonb/hTj6GMHg7Wj7oFit3ilVUu5Bc9a1djT3JJVuCXaT+Mspd3UiwtYxZihD4h ZhuT8wqYEFfulUykofIeuexCKBdV6ugaD9Ub1/GOyhzNymYzM1WlPfgKxCed6KQ1CaJLM3jo3U79 izakxfH45ghlol7SxXHidF3tYpgknv6TgU8CAwEAAaNPME0wDAYDVR0TAQH/BAIwADALBgNVHQ8E BAMCA9gwEQYJYIZIAYb4QgEBBAQDAgWgMB0GA1UdJQQWMBQGCCsGAQUFBwMEBggrBgEFBQcDAjAN BgkqhkiG9w0BAQsFAAOCAgEAkRIj1K/mOCyd/cyxb9m9HpAWgUUwKG00gQXwiM6cJYMGhjk6e2kc lCUPUnp2Ct8Gn4JoHA8jTI8JOv1C7sJor0eO+xAtElvYh4d7NmGZvpZ1BkCt43EAt0gq/NVH37GL WuPC934dlLiq0m9Tv/7UqjVKQKWAKnQc008GJTY+vI8bk1rRctY6RqvhiKnDcwJeNvQfWAnFUJ2L 6+ffphvbvuuWZrAvi8CNIZ6ZFwCkGpFAoKXErPTy4lyTPfsPpg5B6BxhskJH5g5QL8KrpkCheMHg

Page 22: Timbrado CFDI de Retención v20150216 - Tralix

 22  

YfQv+YxOKK8ohpcxaEK+CF/QQkfWGSfzTjKO/fN+uht18UYiuGblwXkGV+N0OLPQZUzjtwEJSLFH LI+3BuDU96baJXmxC31RhdNnRepqoKtALKNVDadpaoCZtTICb6y1FAvI31RrPOUh1O7GbGGhqGQL 96eD3q8UvG99/FRc0Ah4xRCjOg52TLbnhx7eQFA2HIccRBdceELUSGE3YoadB6q1AE68Q6hfP8Oh i20TvgmLZOTfncVIqszK3jn+e71nYCQdH1D6ZsLIx0L5h7CiWRvliiMulloiA9UxjJ1nwssVNHgN BhqAOFPw0rYnHrsbcKW5yiNPAhZinqPVdxBWgeIP3ClyhhrV5jG6GxEUQcf0CWdwHLYTxcWksqqB vkRhj++ft29e5p/lm47XThE=</X509Certificate></X509Data></KeyInfo></Signature></Cancelacion>

4.4. Ejemplo  de  respuesta    

Para conocer la estructura del XML como respuesta se anexa en este paquete de documentación su XSD en /Cancelacion/Masiva/SeguimientoCancelacion.xsd  

HTTP/1.1 200 OK Content-Type: text/plain; charset=utf-8 Content-Length: 1501 <?xml version="1.0"?><SeguimientoCancelacion xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.sat.gob.mx/esquemas/retencionpago/1"><Folio>8049CD44-F0F6-4C73-BDDE-6DE3E25C6407</Folio></SeguimientoCancelacion>

   

Page 23: Timbrado CFDI de Retención v20150216 - Tralix

 23  

5. Consulta  de  Acuse  de  Cancelación  Este  servicio  recibe  el  folio  de  acuse  que  se  quiere  consultar  para  obtener  su  correspondiente  acuse  en  XML.  Esto  es  útil  si  por  alguna  razón  se  requiere  obtener  el  acuse  posterior  a  la  solicitud  de  cancelación  que  se  realizo  previamente.      

 

 Es  sumamente  importante  NO  confundir  los  códigos  de  respuesta  http  con  los  códigos  de  respuesta  del  servicio,  son  completamente  diferentes  e  independientes.  

Ejemplo código http:

HTTP/1.1 200 OK

Ejemplo código de respuesta del servicio:

<Error código="301">

 

5.1. Parámetros    

Tipo  petición:  GET  http  1.1    Ruta:  https://[SERVIDOR]:[PUERTO]/retenciones/consultaacuse/[FOLIO_DE_ACUSE]/      

Parámetro Tipo Valor Requerido Observaciones

Content-Type

Header text/xml; charset=UTF-8

SI El valor debe de ser tal cual se muestra.

ipAddress Header IP_CLIENTE SI Esta ip con la que se está intentado cancelar.

Folio de acuse

Recurso FOLIO_DE_ACUSE SI Es el folio que regresa el servicio de cancela del cual se quiere consultar su acuse.

 Respuesta:  XML  del  acuse  de  cancelación  o  XML  de  error  

Page 24: Timbrado CFDI de Retención v20150216 - Tralix

 24  

 

5.2. Códigos  de  respuesta    

Código Tipo Descripción

200 SUCCESS Existe el acuse y se regresa el que en su momento el SAT nos entregó. Dentro de la respuesta viene el acuse para cada folio solicitado, similar a como se regresa cuando es la cancelación de un único uuid.

400 ERROR La petición no es correcta, falta algún parámetro requerido o el folio solicitado no existe

500 ERROR En caso de algún error interno al hacer la llamada

 

5.3. Ejemplo  de  petición  

GET /retenciones/consultaacuse/CF95C49A-CA7C-40D2-8173-447C87CE7CE9 HTTP/1.1 Accept-Encoding: gzip,deflate ipAddress: 10.0.0.88 Host: 10.0.4.122:9000 Connection: Keep-Alive User-Agent: Apache-HttpClient/4.1.1 (java 1.5)

5.4. Ejemplo  de  respuesta    Para conocer la estructura del XML de respuesta se anexa en este paquete de documentación su XSD en /Cancelacion/ConsultaAcuse/ConsultaAcuseCancelacion.xsd  

HTTP/1.1 200 OK Content-Type: text/plain; charset=utf-8 Content-Length: 1409 <?xml version="1.0"?><Acuse xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" CodEstatus="1301" Fecha="2015-01-02T13:35:36.3947756" RfcEmisor="" WorkProcessId="a7b0a61f-ef31-49ed-a885-3351afba7f03" xmlns="http://www.sat.gob.mx/esquemas/retencionpago/1"><Signature Id="SelloSAT" xmlns="http://www.w3.org/2000/09/xmldsig#"><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

Page 25: Timbrado CFDI de Retención v20150216 - Tralix

 25  

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>x0Rw8rzRsfWMvqhlGnrCFWRYWaHhK9SpaLkpnpiOQKA7tHi3iqJDN3yEasBfPU70seFMkBDRxmSOx8pz6/YRyA==</DigestValue></Reference></SignedInfo><SignatureValue>+ImQOR5cOm/vEgZaKJx+EkeHAOXAluARCTKwO4biOqksWXk7O0LrkvM4CePvsiJOqkaQQUc1YBuCUVj/Rh2XEg==</SignatureValue><KeyInfo><KeyName>20001000000300003586</KeyName><KeyValue><RSAKeyValue><Modulus>n77fbi0dTENVn43LCUOIF/8iyQObFg/AaTRBdpf0fVuozOOy48INue46sN54AHL+I50s1U8Nh6Dq+MRvRNc8WyHPQWsnmSaicT5vAkkzqucVj004WyLcmpysY45DrCxSitPMRzop3XboPr1msWd3EuyduUtbu3QmNRin8uzpYg8=</Modulus><Exponent>AQAB</Exponent></RSAKeyValue></KeyValue></KeyInfo></Signature></Acuse>