Documentación

  • Servicio Web desarrollado para proporcionar el acceso a la funcionalidad de timbrado y cancelación de comprobantes de retención e información de pagos. La documentación está orientada a la integración de soluciones "consumidoras" de Servicios Web, disponibles actualmente en la plataforma. Constituye la descripción funcional y de interfaz, detallando los parámetros de entrada y salida de cada uno de los métodos.

    El conocimiento de estas funciones y su interfaz (parámetros de entrada y salida), permite la integración en aplicaciones terceras.

    Timbrado

    RecibeRetencion

    Parámetros de entrada

    Nombre Descripción
    usuario Usuario de timbrado.
    password Contraseña del servicio de timbrado.
    xmlRetencion XML a enviar para timbrado en webservice.

    Request:

    Response:

         
        
        
                
                
                        
                                
                                        <?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" Cert="MIIFxTCCA62gAwIBAgIUMjAwMDEwMDAwMDAzMDAwMjI4MTUwDQYJKoZIhvcNAQELBQAwggFmMSAwHgYDVQQDDBdBLkMuIDIgZGUgcHJ1ZWJhcyg0MDk2KTEvMC0GA1UECgwmU2VydmljaW8gZGUgQWRtaW5pc3RyYWNpw7NuIFRyaWJ1dGFyaWExODA2BgNVBAsML0FkbWluaXN0cmFjacOzbiBkZSBTZWd1cmlkYWQgZGUgbGEgSW5mb3JtYWNpw7NuMSkwJwYJKoZIhvcNAQkBFhphc2lzbmV0QHBydWViYXMuc2F0LmdvYi5teDEmMCQGA1UECQwdQXYuIEhpZGFsZ28gNzcsIENvbC4gR3VlcnJlcm8xDjAMBgNVBBEMBTA2MzAwMQswCQYDVQQGEwJNWDEZMBcGA1UECAwQRGlzdHJpdG8gRmVkZXJhbDESMBAGA1UEBwwJQ295b2Fjw6FuMRUwEwYDVQQtEwxTQVQ5NzA3MDFOTjMxITAfBgkqhkiG9w0BCQIMElJlc3BvbnNhYmxlOiBBQ0RNQTAeFw0xNjEwMjUyMTUyMTFaFw0yMDEwMjUyMTUyMTFaMIGxMRowGAYDVQQDExFDSU5ERU1FWCBTQSBERSBDVjEaMBgGA1UEKRMRQ0lOREVNRVggU0EgREUgQ1YxGjAYBgNVBAoTEUNJTkRFTUVYIFNBIERFIENWMSUwIwYDVQQtExxMQU43MDA4MTczUjUgLyBGVUFCNzcwMTE3QlhBMR4wHAYDVQQFExUgLyBGVUFCNzcwMTE3TURGUk5OMDkxFDASBgNVBAsUC1BydWViYV9DRkRJMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAgvvCiCFDFVaYX7xdVRhp/38ULWto/LKDSZy1yrXKpaqFXqERJWF78YHKf3N5GBoXgzwFPuDX+5kvY5wtYNxx/Owu2shNZqFFh6EKsysQMeP5rz6kE1gFYenaPEUP9zj+h0bL3xR5aqoTsqGF24mKBLoiaK44pXBzGzgsxZishVJVM6XbzNJVonEUNbI25DhgWAd86f2aU3BmOH2K1RZx41dtTT56UsszJls4tPFODr/caWuZEuUvLp1M3nj7Dyu88mhD2f+1fA/g7kzcU/1tcpFXF/rIy93APvkU72jwvkrnprzs+SnG81+/F16ahuGsb2EZ88dKHwqxEkwzhMyTbQIDAQABox0wGzAMBgNVHRMBAf8EAjAAMAsGA1UdDwQEAwIGwDANBgkqhkiG9w0BAQsFAAOCAgEAJ/xkL8I+fpilZP+9aO8n93+20XxVomLJjeSL+Ng2ErL2GgatpLuN5JknFBkZAhxVIgMaTS23zzk1RLtRaYvH83lBH5E+M+kEjFGp14Fne1iV2Pm3vL4jeLmzHgY1Kf5HmeVrrp4PU7WQg16VpyHaJ/eonPNiEBUjcyQ1iFfkzJmnSJvDGtfQK2TiEolDJApYv0OWdm4is9Bsfi9j6lI9/T6MNZ+/LM2L/t72Vau4r7m94JDEzaO3A0wHAtQ97fjBfBiO5M8AEISAV7eZidIl3iaJJHkQbBYiiW2gikreUZKPUX0HmlnIqqQcBJhWKRu6Nqk6aZBTETLLpGrvF9OArV1JSsbdw/ZH+P88RAt5em5/gjwwtFlNHyiKG5w+UFpaZOK3gZP0su0sa6dlPeQ9EL4JlFkGqQCgSQ+NOsXqaOavgoP5VLykLwuGnwIUnuhBTVeDbzpgrg9LuF5dYp/zs+Y9ScJqe5VMAagLSYTShNtN8luV7LvxF9pgWwZdcM7lUwqJmUddCiZqdngg3vzTactMToG16gZA4CWnMgbU4E+r541+FNMpgAZNvs2CiW/eApfaaQojsZEAHDsDv4L5n3M1CC7fYjE/d61aSng1LaO6T1mh+dEfPvLzp7zyzz+UgWMhi5Cs4pcXx1eic5r7uxPoBwcCTt3YI1jKVVnV7/w=" CveRetenc="23" FechaExp="2020-01-24T09:44:13-06:00" FolioInt="0" NumCert="20001000000300022815" Sello="ELTACcUNkH4s5c0/6Zn1JEPiBx6KXnXebi0JoEAf3delJlH54+1dnJRglLjWNimGdnJzT8GlszEyUVm8ciDITzGokxc5NpF7Tub08KPAWkyDxMPuQSxUz8ZIlhamjnYpf3xAb+NiIo2SRe8MA1mb11cxzP0ISvXCEm16RZTEhkclGwqKxma9v8hrOi7I/XK98lCoer+i6x18gMFbg0IVHS6igkhLOuvX4/2zLapTnEgfSHJ/aY+02P2QfR+Z9vZ3osPo6Kap3reBIuU4w7JVFGV8jaNRLzcB3bYS7qKWBKvdOlqD18ydttK4DVNA7ch+AN+Rk4rW6cB+taZq0PBJXw==" Version="1.0" xsi:schemaLocation="http://www.sat.gob.mx/esquemas/retencionpago/1 http://www.sat.gob.mx/esquemas/retencionpago/1/retencionpagov1.xsd">
          <retenciones:Emisor CURPE="OIBR780920HDFRNNO9" NomDenRazSocE="FORMAS Y SERVICIOS DIGITALES S.A. DE C.V." RFCEmisor="LAN7008173R5" />
          <retenciones:Receptor Nacionalidad="Nacional">
            <retenciones:Nacional CURPR="HEAF780919HNLRLR08" NomDenRazSocR="Formas Digitales SA de CV" RFCRecep="FSD100413758" />
          </retenciones:Receptor>
          <retenciones:Periodo Ejerc="2014" MesFin="6" MesIni="5" />
          <retenciones:Totales montoTotExent="1000.0" montoTotGrav="1000.0" montoTotOperacion="1000.0" montoTotRet="1000.0">
            <retenciones:ImpRetenidos BaseRet="10.2" Impuesto="01" TipoPagoRet="Pago definitivo" montoRet="10000.0" />
          </retenciones:Totales>
          <retenciones:Complemento>
            <planesderetiro11:Planesderetiro xmlns:planesderetiro11="http://www.sat.gob.mx/esquemas/retencionpago/1/planesderetiro11" HuboRetirosAnioInmAnt="SI" HuboRetirosAnioInmAntPer="NO" MontIntRealesDevengAniooInmAnt="0.00" MontTotAportAnioInmAnterior="100.00" MontTotExedenteAnioInmAnt="50.00" MontTotExentRetiradoAnioInmAnt="100.00" MontTotRetiradoAnioInmAnt="1000.00" MontTotRetiradoAnioInmAntPer="150.00" NumReferencia="numreferencia" SistemaFinanc="NO" Version="1.1" xsi:schemaLocation="http://www.sat.gob.mx/esquemas/retencionpago/1/planesderetiro11 http://www.sat.gob.mx/esquemas/retencionpago/1/planesderetiro11/planesderetiro11.xsd">
              <planesderetiro11:AportacionesODepositos MontAportODep="0.00" RFCFiduciaria="AAA010101AAA" TipoAportacionODeposito="a" />
            </planesderetiro11:Planesderetiro>
            <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/timbrefiscaldigital/TimbreFiscalDigital.xsd" version="1.0" UUID="A9679517-D5BD-4AA1-863C-B6A199B153A3" FechaTimbrado="2020-01-24T09:44:28" selloCFD="ELTACcUNkH4s5c0/6Zn1JEPiBx6KXnXebi0JoEAf3delJlH54+1dnJRglLjWNimGdnJzT8GlszEyUVm8ciDITzGokxc5NpF7Tub08KPAWkyDxMPuQSxUz8ZIlhamjnYpf3xAb+NiIo2SRe8MA1mb11cxzP0ISvXCEm16RZTEhkclGwqKxma9v8hrOi7I/XK98lCoer+i6x18gMFbg0IVHS6igkhLOuvX4/2zLapTnEgfSHJ/aY+02P2QfR+Z9vZ3osPo6Kap3reBIuU4w7JVFGV8jaNRLzcB3bYS7qKWBKvdOlqD18ydttK4DVNA7ch+AN+Rk4rW6cB+taZq0PBJXw==" noCertificadoSAT="20001000000300022323" selloSAT="frfaxvTy4SD0zoOw90YaLXZPfE/4eVxySKWpu2X+gAC1RhrGT7EFQSLvMQTVwdjVH2M57O9/ciSZlA9FfEflPK+vGQeN+0qmpsDqqV51VKrz/SeUnvKRZees+aGvz4Dxnk6kIWUPqYCktyx1mesA3CLpR7oNObd+1emXll3BSq3QnRlBs3LZjTyqxK/JJ4GGQrujOJMVzSYmVV89+PIIt25aDjCkcsQGt3zCHntdKpdZazsFh3LjTPtpctsOsA4kOSSyjE31DyivMl22wfTfXQA4ae0o3atUF28qbBgDjkRDsZWNYKrZKW0Z4BoA54QRvJaRpGURwIQcfq/XJjlBWw==" />
          </retenciones:Complemento>
        </retenciones:Retenciones>
        
                                        
                                
                        
                
        
         
                                        

    Ejemplos anexos

    Cancelación

    Cancela

    Parámetros de entrada/salida:

    Nombre Descripción
    folios Listado de UUIDs de los comprobantes a cancelar.
    password_certs Contraseña de la llave privada del CSD del cliente.
    password_servicio Contaseña del servicio de timbrado en webservice.
    privatekey Llave privada en base64.
    publickey Llave pública en base64.
    rfc RFC de emisor del comprobante.
    usuario_servicio Usuario de timbrado.

    Request:

         
        
        
                
                        
                                
                                        A9679517-D5BD-4AA1-863C-B6A199B153A3
                                        12345678a
                                        pruebasWS
                                        MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQCC+8KIIUMVVphfvF1VGGn/fxQta2j8soNJnLXKtcqlqoVeoRElYXvxgcp/c3kYGheDPAU+4Nf7mS9jnC1g3HH87C7ayE1moUWHoQqzKxAx4/mvPqQTWAVh6do8RQ/3OP6HRsvfFHlqqhOyoYXbiYoEuiJorjilcHMbOCzFmKyFUlUzpdvM0lWicRQ1sjbkOGBYB3zp/ZpTcGY4fYrVFnHjV21NPnpSyzMmWzi08U4Ov9xpa5kS5S8unUzeePsPK7zyaEPZ/7V8D+DuTNxT/W1ykVcX+sjL3cA++RTvaPC+SuemvOz5KcbzX78XXpqG4axvYRnzx0ofCrESTDOEzJNtAgMBAAECggEAZmlD4z3mfoOTZZ8YdlU9Y1fPxedqUdGdVuvhM5pJ1Jfr6V4T0t9SkjSByH7XmmGkKqa+DzirhntyEvbkgAw8T5220La11d2YSIBApm+wHOH7sepPTRSQOMsoJ+Fzpz93uvs+obAXcq+B8TPbPhhewm1qQ+CcR7YROaIFV4WUtjPT2yrh4+L1KhaZ1Tgd7RcDETBJTnWcX6/zOOYdMHq6gS/6Nua+EbycyVgz4TSQuxy0ngTJELlIfGk4YTITGhz+apbX6YzQl99BNuSi1cgxGuw0bd9QzsuDw9YOimjdfsjyf1aywZwYrfqEYehRHQTGpcIquk4UIpkitlPMeidwQQKBgQDZ54PYaKIPcGp9mVxOAX/rV4JmU0A4mzzETdEGLQaqXGBvjTQ4uvNIOf7F8TUd2i1MQNOVPGlPlKNKTnG6MuxoHRNxWPCYLYt1H6bsxYN1lVn+dqO983w2ANm2UBTiyimfTM6tbqbjtodQZvJ/mN3NNq/l1y8jRgyfqYhwCA35vQKBgQCZ4gd1j6O4tBe+tueRPWIcQxhElVD6ty0HOfBRhkOc6/dtyTpZDU0L15Z7D5eWgpKnhrdniRL59PcX6I9nIPY+BMgzzyr4sU3N7tK7M43aVQsvUByANzfs79dTTyFqYFnkEK7u9YQuH1FvBZITHov8ENCn6+3lWMD4arxOOfajcQKBgQCRhJCB1u5TDSmwktgXp9y7V4dXukTrCJB+L9FlJHCNGH+2P0AemoqZM1G28qwcMXWKtMgXo25YnNSnbNd6F0PVC4XObizOE6xMHUUmXYi633BoBOa4lX/fuJWrsLMh+QvuvCZRn9GHxH987CMJnxaQUvMItLlf/wmzHk5lMpvSqQKBgGjewESfAm2i1jfTwJabpZwrIYPD2q8yXI57LsrwXG255iK8q3X6+ZHjd5sgMieRjs56ocz+fp84EZkKlYgrz4TOj323ZsqbUrHQW27WoIq1wGybBQFgIE3p2e3dlKFBTqF9uSoCyfUAxOeLfVRoUfATqY922uadCM2DOBd7qxkRAoGAUq47U4CIkIYp1SdcMCL5zD9gww2Qf9/g4KnAcy+Ec6EtBZQ5Wf6j131vfD6GxCMuCJJ4RUuha7mzGVqWtlDJwmU5n6b0hpAVDf90B9AoIpy/lVbc0WyR1QnvwBeUSjL80yqP3p6nXBohs45XsbF1kEGx50X8z7yLGNYY34YDPI=
                                        MIIFxTCCA62gAwIBAgIUMjAwMDEwMDAwMDAzMDAwMjI4MTUwDQYJKoZIhvcNAQELBQAwggFmMSAwHgYDVQQDDBdBLkMuIDIgZGUgcHJ1ZWJhcyg0MDk2KTEvMC0GA1UECgwmU2VydmljaW8gZGUgQWRtaW5pc3RyYWNpw7NuIFRyaWJ1dGFyaWExODA2BgNVBAsML0FkbWluaXN0cmFjacOzbiBkZSBTZWd1cmlkYWQgZGUgbGEgSW5mb3JtYWNpw7NuMSkwJwYJKoZIhvcNAQkBFhphc2lzbmV0QHBydWViYXMuc2F0LmdvYi5teDEmMCQGA1UECQwdQXYuIEhpZGFsZ28gNzcsIENvbC4gR3VlcnJlcm8xDjAMBgNVBBEMBTA2MzAwMQswCQYDVQQGEwJNWDEZMBcGA1UECAwQRGlzdHJpdG8gRmVkZXJhbDESMBAGA1UEBwwJQ295b2Fjw6FuMRUwEwYDVQQtEwxTQVQ5NzA3MDFOTjMxITAfBgkqhkiG9w0BCQIMElJlc3BvbnNhYmxlOiBBQ0RNQTAeFw0xNjEwMjUyMTUyMTFaFw0yMDEwMjUyMTUyMTFaMIGxMRowGAYDVQQDExFDSU5ERU1FWCBTQSBERSBDVjEaMBgGA1UEKRMRQ0lOREVNRVggU0EgREUgQ1YxGjAYBgNVBAoTEUNJTkRFTUVYIFNBIERFIENWMSUwIwYDVQQtExxMQU43MDA4MTczUjUgLyBGVUFCNzcwMTE3QlhBMR4wHAYDVQQFExUgLyBGVUFCNzcwMTE3TURGUk5OMDkxFDASBgNVBAsUC1BydWViYV9DRkRJMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAgvvCiCFDFVaYX7xdVRhp/38ULWto/LKDSZy1yrXKpaqFXqERJWF78YHKf3N5GBoXgzwFPuDX+5kvY5wtYNxx/Owu2shNZqFFh6EKsysQMeP5rz6kE1gFYenaPEUP9zj+h0bL3xR5aqoTsqGF24mKBLoiaK44pXBzGzgsxZishVJVM6XbzNJVonEUNbI25DhgWAd86f2aU3BmOH2K1RZx41dtTT56UsszJls4tPFODr/caWuZEuUvLp1M3nj7Dyu88mhD2f+1fA/g7kzcU/1tcpFXF/rIy93APvkU72jwvkrnprzs+SnG81+/F16ahuGsb2EZ88dKHwqxEkwzhMyTbQIDAQABox0wGzAMBgNVHRMBAf8EAjAAMAsGA1UdDwQEAwIGwDANBgkqhkiG9w0BAQsFAAOCAgEAJ/xkL8I+fpilZP+9aO8n93+20XxVomLJjeSL+Ng2ErL2GgatpLuN5JknFBkZAhxVIgMaTS23zzk1RLtRaYvH83lBH5E+M+kEjFGp14Fne1iV2Pm3vL4jeLmzHgY1Kf5HmeVrrp4PU7WQg16VpyHaJ/eonPNiEBUjcyQ1iFfkzJmnSJvDGtfQK2TiEolDJApYv0OWdm4is9Bsfi9j6lI9/T6MNZ+/LM2L/t72Vau4r7m94JDEzaO3A0wHAtQ97fjBfBiO5M8AEISAV7eZidIl3iaJJHkQbBYiiW2gikreUZKPUX0HmlnIqqQcBJhWKRu6Nqk6aZBTETLLpGrvF9OArV1JSsbdw/ZH+P88RAt5em5/gjwwtFlNHyiKG5w+UFpaZOK3gZP0su0sa6dlPeQ9EL4JlFkGqQCgSQ+NOsXqaOavgoP5VLykLwuGnwIUnuhBTVeDbzpgrg9LuF5dYp/zs+Y9ScJqe5VMAagLSYTShNtN8luV7LvxF9pgWwZdcM7lUwqJmUddCiZqdngg3vzTactMToG16gZA4CWnMgbU4E+r541+FNMpgAZNvs2CiW/eApfaaQojsZEAHDsDv4L5n3M1CC7fYjE/d61aSng1LaO6T1mh+dEfPvLzp7zyzz+UgWMhi5Cs4pcXx1eic5r7uxPoBwcCTt3YI1jKVVnV/w=
                                        LAN7008173R5
                                        pruebasWS
                                
                        
                
        
         
                                        

    Response:

         
        
        
                
                
                        
                                
                                        0
                                        
                                                201
                                                UUID Cancelado
                                                A9679517-D5BD-4AA1-863C-B6A199B153A3
                                        
                                
                        
                
        
         
                                        

    Ejemplos anexos

  • Servicio Web desarrollado para proporcionar el acceso a la funcionalidad de timbrado y cancelación de comprobantes de retención e información de pagos. La documentación está orientada a la integración de soluciones "consumidoras" de Servicios Web, disponibles actualmente en la plataforma. Constituye la descripción funcional y de interfaz, detallando los parámetros de entrada y salida de cada uno de los métodos.

    El conocimiento de estas funciones y su interfaz (parámetros de entrada y salida), permite la integración en aplicaciones terceras.

    Timbrado

    RecibeRetencion

    Parámetros de entrada/salida:

    Nombre Descripción
    usuario Usuario de timbrado.
    password Contraseña del servicio de timbrado.
    xmlRetencion XML a enviar para timbrado en webservice.

    Request:

    Response:

    Ejemplos anexos

    Cancelación

    Cancela

    Parámetros de entrada/salida:

    Nombre Descripción
    folios Listado de objetos tipo folio en donde se encuentra el uuid, motivo y folio de sustició del comprobante a cancelar.
    motivo Codigo del motivo por le cual se cancelará el comprobante.
    foliosustitucion Folio por el cual remplazará al comprobante a cancelar.
    UUID Indica el uuid del comprobante que se enví a cancelar.
    password_certs Contraseña de la llave privada del CSD del cliente.
    password_servicio Contaseña del servicio de timbrado en webservice.
    privatekey Llave privada en base64.
    publickey Llave pública en base64.
    rfc RFC de emisor del comprobante.
    usuario_servicio Usuario de timbrado.

    Request:

    Response:

    Ejemplos anexos

  • <Developers/> Formas Digitales®

    Secciones relevantes:

    A continuación se muestran los atributos que puede llevar el nodo Retenciones.

    Tabla de atributos.
    <>

    A continuación se muestran los atributos que puede llevar el nodo CfdiRetenRelacionados.

    Tabla de atributos.
    <>

    A continuación se muestran los atributos que puede llevar el nodo Emisor.

    Tabla de atributos.
    <>

    A continuación se muestran los atributos que puede llevar el nodo Receptor.

    Tabla de atributos.
    <>

    A continuación se muestran los atributos que puede llevar el nodo Nacional.

    Tabla de atributos.
    <>

    A continuación se muestran los atributos que puede llevar el nodo Extranjero.

    Tabla de atributos.
    <>

    A continuación se muestran los atributos que puede llevar el nodo Periodo.

    Tabla de atributos.
    <>

    A continuación se muestran los atributos que puede llevar el nodo Totales.

    Tabla de atributos.
    <>

    A continuación se muestran los atributos que puede llevar el nodo ImpRetenidos.

    Tabla de atributos.
    <>
  • Pruebas Producción
    Timbrado https://dev.facturacfdi.mx:8081/retenciones/wsreciberetencionservice?wsdl https://www.facturacfdi.mx/retenciones/wsreciberetencionservice?wsdl
    Cancelación https://dev.facturacfdi.mx:8081/retenciones/wscancelaretenciones?wsdl https://www.facturacfdi.mx/retenciones/wscancelaretenciones?wsdl

    Datos de acceso (Pruebas)