timbrado cfdi de retención v20150216 - tralix
TRANSCRIPT
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
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
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.
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
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="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" 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
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=" />
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 "retenciones:Emisores" must be terminated by the matching end-tag "</retenciones:Emisores>".</descripcionError> </Error>
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:
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
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
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
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
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"
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
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
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/
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
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-
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
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
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>
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
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
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>