Llama Gratis 01800 788 0195

Timbrar Retención

Método Timbrar_Retencion

 

Esquema de Factura de Retenciones e Información de Pagos

 

La factura de retenciones e información de pagos es un documento distinto a una factura ya que no es un comprobante de ingreso, egreso o traslado.

Se integra por conjunto de datos generales, a los cuales se les puede incorporar un complemento.

Cuando en la realización de una actividad económica estés obligado a expedir una constancia por las retenciones de impuestos que efectúas, o bien por los pagos realizados, genera una factura de retenciones o información de pagos. Por ejemplo, en el caso de enajenación de acciones, dividendos o utilidades distribuidas, regalías por derechos de autor, pagos realizados a favor de residentes en el extranjero, intereses reales deducibles por créditos hipotecarios.

 


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 timbrado exitosa: 1 crédito. 

 

Petición al servicio

El servicio de “timbrar_retencion” se utiliza para realizar el timbrado de un comprobante, si dicho comprobante es válido se timbrará con éxito. Es requerido el usuario y contraseña para utilizar el servicio.

 

Parámetros de la petición

 

Nombre Descripción Requerido
username Usuario del web service
password Contraseña del web service
sxml El xml del comprobante convertido a una cadena en base64.

Ejemplo de 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:timbrar_retencion soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
         <username xsi:type="xsd:string">AAA010101000</username>
         <password xsi:type="xsd:string">h6584D56fVdBbSmmnB</password>
         <sxml xsi:type="xsd:string">PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHJldGVuY2lvbmVzOlJldGVuY2lvbmVzIHhtbG5zOnJldGVuY2lvbmVzPSJodHRwOi8vd3d3LnNhdC5nb2IubXgvZXNxdWVtYXMvcmV0ZW5jaW9ucGFnby8xIiB4bWxuczp4c2k9Imh0dHA6Ly93d3cudzMub3JnLzIwMDEvWE1MU2NoZW1hLWluc3RhbmNlIiBWZXJzaW9uPSIxLjAiIEZvbGlvSW50PSIxMjMiIFNlbGxvPSJDcHV0ODlOMHFHVWI2RnMwcThXUENuc3NjMjhFclVTQzVrWW1qcWJ6Z0llcjJyajhsWms2NXVhS1k0eC9mZXd4c05LUVdMMVVOVlA3bHBiRUZYeFowMFRnY1VSSm50ZTdnaEtqT3QrOWgwZ1pLUWZ3d3UxeUFUNVIzZmNiUjBYenBvQnh3VTJHclJtWTFzSDZORGY4bjNPNjF0bXdEa3ZxVWF4L1VmTEtCdlJOY3EwS01GQzd6RTVacy9qNENaa255YjRLUzhDeC9kanFkOU5wUS83czd6aU1xODF1VGk2T2t2VDJvTVEySGFrTGxjWGlFRWtWSXZTVWUwRkNkdU94MHYvVFBSYlBUOVZVY2RuYmpVUE9rTzRlRWZlSlhUbDFYUEszcWNEODF1dXRTaUdEdnI4S2xndkFHZ3AzWHZTaDNNUFB5V2pRV1c3THRpbUJnV1lSQlE9PSIgTnVtQ2VydD0iMzAwMDEwMDAwMDAzMDAwMjM3MDgiIENlcnQ9Ik1JSUYrVENDQStHZ0F3SUJBZ0lVTXpBd01ERXdNREF3TURBek1EQXdNak0zTURnd0RRWUpLb1pJaHZjTkFRRUxCUUF3Z2dGbU1TQXdIZ1lEVlFRRERCZEJMa011SURJZ1pHVWdjSEoxWldKaGN5ZzBNRGsyS1RFdk1DMEdBMVVFQ2d3bVUyVnlkbWxqYVc4Z1pHVWdRV1J0YVc1cGMzUnlZV05wdzdOdUlGUnlhV0oxZEdGeWFXRXhPREEyQmdOVkJBc01MMEZrYldsdWFYTjBjbUZqYWNPemJpQmtaU0JUWldkMWNtbGtZV1FnWkdVZ2JHRWdTVzVtYjNKdFlXTnB3N051TVNrd0p3WUpLb1pJaHZjTkFRa0JGaHBoYzJsemJtVjBRSEJ5ZFdWaVlYTXVjMkYwTG1kdllpNXRlREVtTUNRR0ExVUVDUXdkUVhZdUlFaHBaR0ZzWjI4Z056Y3NJRU52YkM0Z1IzVmxjbkpsY204eERqQU1CZ05WQkJFTUJUQTJNekF3TVFzd0NRWURWUVFHRXdKTldERVpNQmNHQTFVRUNBd1FSR2x6ZEhKcGRHOGdSbVZrWlhKaGJERVNNQkFHQTFVRUJ3d0pRMjk1YjJGanc2RnVNUlV3RXdZRFZRUXRFd3hUUVZRNU56QTNNREZPVGpNeElUQWZCZ2txaGtpRzl3MEJDUUlNRWxKbGMzQnZibk5oWW14bE9pQkJRMFJOUVRBZUZ3MHhOekExTVRnd016VTBOVFphRncweU1UQTFNVGd3TXpVME5UWmFNSUhsTVNrd0p3WURWUVFERXlCQlEwTkZUU0JUUlZKV1NVTkpUMU1nUlUxUVVrVlRRVkpKUVV4RlV5QlRRekVwTUNjR0ExVUVLUk1nUVVORFJVMGdVMFZTVmtsRFNVOVRJRVZOVUZKRlUwRlNTVUZNUlZNZ1UwTXhLVEFuQmdOVkJBb1RJRUZEUTBWTklGTkZVbFpKUTBsUFV5QkZUVkJTUlZOQlVrbEJURVZUSUZORE1TVXdJd1lEVlFRdEV4eEJRVUV3TVRBeE1ERkJRVUVnTHlCSVJVZFVOell4TURBek5GTXlNUjR3SEFZRFZRUUZFeFVnTHlCSVJVZFVOell4TURBelRVUkdVazVPTURreEd6QVpCZ05WQkFzVUVrTlRSREF4WDBGQlFUQXhNREV3TVVGQlFUQ0NBU0l3RFFZSktvWklodmNOQVFFQkJRQURnZ0VQQURDQ0FRb0NnZ0VCQUpkVWNzSElFSWd3aXZ2QWFudEduWVZJTzMrN3lUZEQxdGtLb3BiTCt0S1NqUkZvMUVyUGRHSnhQM2d4VDVPK0FDSURRWE4rSFM5dU1XRFluYVVSYWxTSUY5Q09GQ2RoL09IMlBuK1Vta040Y3VscjJEYW5LenRWSU84aWRYTTZjOWFIbjVoT283aER4WE1DM3VPdUdWM0ZTNE9ia3hUVis5TnN2T0FWMmxNZTI3U0hyU0IwRGh1THVyVWJad1htKy9yNGR0ejNiMnVMZ0JjK0RpeTk1UEcrTUl1N29OS004OWFCTkdjalRKdys5aytXekppUGQzWnBRZ0llZFlCRCs4UVd4bFlDZ3hobnRhM2s5eWxnWEtZWENZazBrMHFhdXZCSjFqU1JWZjVCampJVWJPc3RhUXA1OW5rZ0hoNDVjOWdud0pSVjYxOE5XMGZNZUR6dUtSMENBd0VBQWFNZE1Cc3dEQVlEVlIwVEFRSC9CQUl3QURBTEJnTlZIUThFQkFNQ0JzQXdEUVlKS29aSWh2Y05BUUVMQlFBRGdnSUJBQktqMERDTkwxbGg0NHkrT2NXRnJUMmljbktGN1d5U09WaWh4MG9SK0hQcldLQk1YeG85S3Ryb2RuQjF0Z0l4OGYrWGpxeXBoaGJ3K2p1RFNlRHJiOTlQaEM0K0U2SmVYT2tkUWNKdDUwS3lvZGw5VVJwQ1ZXTldqVWIzRi95cGE4b1RjZmYvZU1mdFFaVDdNUTFMcWh0K3htM1FoVm94VElBU2NlMGpqc25CVEdEMkpRNHVUM29DZW04Ym1vTVhWL2ZrOWFKM3YwK1pJTDQyTXBZNFBPR1VhL2lUYWF3a2xLUkFMMVhqOUlkSVIwNlJLNjhSUzZ4ckdrNmp3YkRURUt4SnBtWjNTUEx0bHNtUFVUTzFrcmFUUElvOUZDbVUvelprV0dwZDhaRUFBRncrWmZJK2JkWEJmdmREd2FNMmlNR1RRWlRURWdVNUtLVEl2a0FuSG85TzQ1U3FTSndxVjlOTGZQQXhDbzVlUlIyT0dpYmQ5amhIZTgxelVzcDVHZEUxbVppU3FKVTgySDNjdTZCaUUrRDNZYlplWm5qck5TeEJnS1RJZjh3K0tOWVBNNGFXbnVVTWwwbUxndE94VFVYaTlNS25VY2NxM0daTEE3Yng3Wm4yMTF5UFJxRWpTQXF5YlVNVklPaG82YXF6a2ZjM1dMWjZMbkdVK2h5SHVaVWZQd2JuQ2xiN29GRnoxUGx2R09wTkRzVWIwcVA0MlFDR0JpVFVzZUd1Z0F6cU9QNkVZcFZQQzczZ0ZvdXJtZEJRZ2ZheWFFdmkzeGpOYW5Ga1BsVzFYRVlOcllKQjR5TmpwaEZydld3VFk4NnZMMm84Z1pOMFV0bWM1Zm5vQlRmTTlyMnpWS21FaTZGVWVKMWlhRGFWTnY0N3RlOWlTMWFpNFY0dkJZOHIiIEZlY2hhRXhwPSIyMDE4LTEyLTI2VDE4OjQ1OjQxLTA2OjAwIiBDdmVSZXRlbmM9IjI1IiBEZXNjUmV0ZW5jPSJPdHJvIHRpcG8gZGUgcmV0ZW5jaW9uZXMiIHhzaTpzY2hlbWFMb2NhdGlvbj0iaHR0cDovL3d3dy5zYXQuZ29iLm14L2VzcXVlbWFzL3JldGVuY2lvbnBhZ28vMSBodHRwOi8vd3d3LnNhdC5nb2IubXgvZXNxdWVtYXMvcmV0ZW5jaW9ucGFnby8xL3JldGVuY2lvbnBhZ292MS54c2QiPgogIDxyZXRlbmNpb25lczpFbWlzb3IgUkZDRW1pc29yPSJBQUEwMTAxMDFBQUEiIE5vbURlblJhelNvY0U9IlNFTlRJRU5UIFNBIERFIENWIi8+CiAgPHJldGVuY2lvbmVzOlJlY2VwdG9yIE5hY2lvbmFsaWRhZD0iTmFjaW9uYWwiPgogICAgPHJldGVuY2lvbmVzOk5hY2lvbmFsIFJGQ1JlY2VwPSJJQUQxMjEyMTRCMzQiIE5vbURlblJhelNvY1I9IklUIFNXIERldmVsb3BtZW50IFNvbHV0aW9ucyBkZSBNZXhpY28gUyBkZSBSTCBkZSBDViIgQ1VSUFI9IkNYR084MzAyMDdIQkNTWlMwOCIvPgogIDwvcmV0ZW5jaW9uZXM6UmVjZXB0b3I+CiAgPHJldGVuY2lvbmVzOlBlcmlvZG8gTWVzSW5pPSIxIiBNZXNGaW49IjEwIiBFamVyYz0iMjAxNiIvPgogIDxyZXRlbmNpb25lczpUb3RhbGVzIG1vbnRvVG90T3BlcmFjaW9uPSIxNjUwLjAwIiBtb250b1RvdEdyYXY9IjIwMC4wMCIgbW9udG9Ub3RFeGVudD0iMTQ1MC4wMCIgbW9udG9Ub3RSZXQ9IjIwMC4wMCI+CiAgICA8cmV0ZW5jaW9uZXM6SW1wUmV0ZW5pZG9zIEJhc2VSZXQ9IjIwMC4wMCIgSW1wdWVzdG89IjAxIiBtb250b1JldD0iMjAwLjAwIiBUaXBvUGFnb1JldD0iUGFnbyBkZWZpbml0aXZvIi8+CiAgPC9yZXRlbmNpb25lczpUb3RhbGVzPgo8L3JldGVuY2lvbmVzOlJldGVuY2lvbmVzPg==</sxml>
      </urn:timbrar_retencion>
   </soapenv:Body>
</soapenv:Envelope>

Respuesta del servicio

La respuesta del servicio de timbrado se encontrará en el nodo “timbrar_retencion_response”, en donde encontraremos el XML, una vez que dicho comprobante haya pasado todas las validaciones correspondientes. En caso contrario regresará un código y un mensaje de error en el cual se describe el motivo por el cual no cumple con la validación.

 

Parámetros de respuesta

 

Nombre Descripción
xml Campo que contiene el comprobante con el nodo TFD (Timbre Fiscal Digital).

Ejemplo de respuesta del servicio

 

<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:timbrar_retencion_response>
         <timbrar_retencion_result xsi:type="tns:timbrar_retencion_result">
            <xml xsi:type="xsd:string"><?xml version="1.0" encoding="UTF-8"?>
<retenciones:Retenciones xmlns:retenciones="http://www.sat.gob.mx/esquemas/retencionpago/1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Version="1.0" FolioInt="123" Sello="Cput89N0qGUb6Fs0q8WPCnssc28ErUSC5kYmjqbzgIer2rj8lZk65uaKY4x/fewxsNKQWL1UNVP7lpbEFXxZ00TgcURJnte7ghKjOt+9h0gZKQfwwu1yAT5R3fcbR0XzpoBxwU2GrRmY1sH6NDf8n3O61tmwDkvqUax/UfLKBvRNcq0KMFC7zE5Zs/j4CZknyb4KS8Cx/djqd9NpQ/7s7ziMq81uTi6OkvT2oMQ2HakLlcXiEEkVIvSUe0FCduOx0v/TPRbPT9VUcdnbjUPOkO4eEfeJXTl1XPK3qcD81uutSiGDvr8KlgvAGgp3XvSh3MPPyWjQWW7LtimBgWYRBQ==" NumCert="30001000000300023708" Cert="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" FechaExp="2018-12-26T18:45:41-06:00" CveRetenc="25" DescRetenc="Otro tipo de retenciones" xsi:schemaLocation="http://www.sat.gob.mx/esquemas/retencionpago/1 http://www.sat.gob.mx/esquemas/retencionpago/1/retencionpagov1.xsd">
  <retenciones:Emisor RFCEmisor="AAA010101AAA" NomDenRazSocE="SENTIENT SA DE CV"/>
  <retenciones:Receptor Nacionalidad="Nacional">
    <retenciones:Nacional RFCRecep="IAD121214B34" NomDenRazSocR="IT SW Development Solutions de Mexico S de RL de CV" CURPR="CXGO830207HBCSZS08"/>
  </retenciones:Receptor>
  <retenciones:Periodo MesIni="1" MesFin="10" Ejerc="2016"/>
  <retenciones:Totales montoTotOperacion="1650.00" montoTotGrav="200.00" montoTotExent="1450.00" montoTotRet="200.00">
    <retenciones:ImpRetenidos BaseRet="200.00" Impuesto="01" montoRet="200.00" TipoPagoRet="Pago definitivo"/>
  </retenciones:Totales>
  <retenciones:Complemento>
    <tfd:TimbreFiscalDigital xmlns:tfd="http://www.sat.gob.mx/TimbreFiscalDigital" xsi:schemaLocation="http://www.sat.gob.mx/TimbreFiscalDigital http://www.sat.gob.mx/sitio_internet/cfd/TimbreFiscalDigital/TimbreFiscalDigital.xsd" version="1.0" UUID="4AD449BD-71B6-4C02-A19F-8FD3B7BC5F6F" FechaTimbrado="2018-12-27T11:26:12" selloCFD="Cput89N0qGUb6Fs0q8WPCnssc28ErUSC5kYmjqbzgIer2rj8lZk65uaKY4x/fewxsNKQWL1UNVP7lpbEFXxZ00TgcURJnte7ghKjOt+9h0gZKQfwwu1yAT5R3fcbR0XzpoBxwU2GrRmY1sH6NDf8n3O61tmwDkvqUax/UfLKBvRNcq0KMFC7zE5Zs/j4CZknyb4KS8Cx/djqd9NpQ/7s7ziMq81uTi6OkvT2oMQ2HakLlcXiEEkVIvSUe0FCduOx0v/TPRbPT9VUcdnbjUPOkO4eEfeJXTl1XPK3qcD81uutSiGDvr8KlgvAGgp3XvSh3MPPyWjQWW7LtimBgWYRBQ==" noCertificadoSAT="30001000000300036825" selloSAT="Gyodvosb7YC2vEi0QlMHV6gPhUKyPCszMA/Ld6NxjiAjY7xmUDOZdZxC0TijTpGp4GNjz+j6Ao2g9AehZIEvdJ5g9up6B/2KF9nudaydSwyuXQPHjveD8kmX+DQfcaszgNZdJ1B2PnPUz1CkRvPyDYYDvS0Uc3LPlQ5Iu4X2JRujz+vudruuNWN+cIqdkr0zh+BFPxjU26fjTrTdK36uU0AWm8ajBRFLriseOL+PsbYfU+1ggroXs3il/mlYn1LTqa0I2DCxp+VmH6sIA7tOop3yIBKib5n1hRoK3M2O0Z20dj5lAVwOlvJa7pzxkrF9+cK0M2yl3FxCDUPw6QFd9Q=="/>
  </retenciones:Complemento>
</retenciones:Retenciones>]]></xml>
         </timbrar_retencion_result>
      </tns:timbrar_retencion_response>
   </soap:Body>
</soap:Envelope>

Códigos de error a nivel petición

El siguiente lista se muestra los códigos de error proporcionados por el SAT.

 

Código Error
RET001 Los datos de autentificación enviados son incorrectos
RET002 Se han agotado la cantidad de timbres
RET003  Parámetro inválido
RET004  Error en el certificado, el certificado es inválido.
RET301  El XML recibido no contiene una estructura válida.
RET302  El sello del emisor es inválida
RET303  Certificado del comprobante no corresponde al RFC emisor.
RET304  El certificado está revocado o caduco.
RET305  La fecha de emisión no esta dentro de la vigencia del CSD del Emisor.
RET306  El certificado utilizado es de tipo FIEL, no es un CSD.
RET307  El comprobante ya tiene un timbre previo, revisar el nodo complemento.
RET308  El certificado no fue expedido por el SAT.
RET309  El rango de la fecha de generación es mayor a las 72 horas.