Servicio Timbrado

Esquema de Retenciones

Fecha: 25 de febrero de 2022

Ver 1.0

1
Contenido
1 Introducción ........................................................................................................... 3

2 Prerrequisitos ......................................................................................................... 3

3 Modo de Uso para Servicios ................................................................................... 3

4 Autenticación para Servicios................................................................................... 3

5 Servicio de Timbrado .............................................................................................. 5

Timbrar .................................................................................................................................................. 5

2
1 Introducción
El presente documento contiene la información necesaria para conocer y utilizar los siguientes elementos
que forman parte del Esquema de CFDI de Retenciones del Servicio de Administración Tributaria, que
expone para consumo de los Entes Públicos.

• Timbrado de CFDI de Retenciones.

2 Prerrequisitos
Tener conexión a Internet.

Contar con la E.firma y Certificado de Sello Digital (CSD) vigentes.

Estar dado de alta como emisor y usuario de la solución de Timbrado de CFDI de Retenciones.

3 Modo de Uso para Servicios

A fin de utilizar los servicios descritos en el presente documento es necesario crear el cliente con los
métodos REST habituales, para hacer llamadas a una API REST y obtener resultados de esta.

Para el caso del servicio de timbrado de retenciones se deberá utilizar la siguiente url:

https://timbmasivoretuat.azurewebsites.net

NOTA: La url corresponde al ambiente de pruebas de UAT, dicha url cambiará entre los diferentes
ambientes, sin embargo, el modo de consumirlo y las operaciones se mantienen.

Se deberá realizar una petición HTTP de tipo POST hacia la operación api/Timbrar, más adelante del
presente documento se describen los elementos necesarios para hacer uso de esta operación, quedando
la url de la siguiente manera:

https://timbmasivoretuat.azurewebsites.net/api/Timbrar?rfcPeticion=rfcEmisor

Una vez que se creó el cliente el siguiente paso es verificar el tipo de certificado a enviar para poder
realizar la autenticación y posterior consumo de los servicios.

En el siguiente paso se habla específicamente de cómo realizar dicha autenticación.

4 Autenticación para Servicios

Adicionalmente, para utilizar los servicios web descritos en el presente documento es necesario
autenticarse ante el servidor de servicios web mediante un par de llaves proporcionados por el SAT, estas
llaves son las correspondientes al certificado E.firma.

Autenticación Timbrado

3
Para utilizar el servicio de timbrado en el presente documento es necesario autenticarse ante el servidor
de servicios web mediante un par de llaves proporcionados por el SAT al momento de tramitar la E.firma.

Para mayor información acerca de la e.Firma consulte:

http://www.sat.gob.mx/sitio_internet/e_sat/tu_firma/60_11498.html

A fin de facilitar la autenticación mediante el uso de la e.Firma, se recomienda utilizar el almacén local de
llaves criptográficas para almacenar y recuperar una llave para utilizarla posteriormente, a continuación,
se muestra un ejemplo de código en C# de cómo obtener un certificado específico.

Ejemplo:

Una vez seleccionado el certificado a utilizar como medio de autenticación se tiene que mandar dentro de
la petición hacia el servicio, esto se realiza de la siguiente manera:

Ejemplo:

El código mostrado anteriormente es en C#, pero sirve como ejemplo para ilustrar como enviar estos
certificados a los servicios descritos.

Si la autenticación hacia el servicio de timbrado que se explica en este documento es satisfactoria se podrá
hacer uso de los métodos expuestos, en caso contrario se mandará una excepción de autenticación y no
se podrá hacer eso del servicio, generando un código de respuesta 403.

4
Es importante mencionar también que para poder hacer uso de los Servicios Web de Timbrado de
Retenciones hay que estar registrado como usuario de timbrado de retenciones, de no ser así la
autenticación no será satisfactoria.

El registro como usuario de timbrado de retenciones que se seguirá, será el definido por el SAT.

5 Servicio de Timbrado
Es un servicio web que permite el timbrado de los comprobantes recibidos en formato XML que envíen
las dependencias de acuerdo con el estándar publicado en el anexo 20, por lo que es necesario cumplir
con los requisitos técnicos y de operación plasmados en el estándar.

A fin de utilizar este servicio, es necesario que el archivo XML se encuentre sellado por el Emisor.

Este WS está compuesto por las siguientes operaciones de tipo REST:

Timbrar
Al ser una operación REST se puede enviar como una petición HTTP y no es necesario hacer una referencia
al servicio Web.

Esta operación realiza la validación de los comprobantes de retenciones, así mismo regresa un acuse con
el resultado o estatus en el que se encuentra el comprobante enviado.

Los parámetros que requiere dicha operación son los siguientes:

Parámetro Tipo de Dato Descripción Tipo de Parámetro
rfcPeticion String Contiene el RFC del Ente Entrada
Público que emitió el
comprobante y del cual se
está solicitando el
timbrado.
Contenido MultipartFormDataContent Contiene el contenido de Entrada
la petición que se
compone de un
streamcontent, un nombre
y el nombre del archivo
por cada uno de los
comprobantes a enviar.

5
Metodo HttpMethod Indica que método acepta Entrada
la acción pertinente y para
estos casos es POST.
Acuse Acuse Contiene el acuse con el Salida
código de respuesta o
estatus del comprobante
que se envió y el archivo
timbrado.

Ejemplo de código en C# para poder solicitar el timbrado de comprobantes de retención:

Este código que se muestra a continuación es solo el llamado al método, porque antes de esto según lo
que se ha indicado en este mismo documento primero hay que obtener el certificado que se utilizara
como autenticación.

6
Ejemplo de petición al servicio de timbrado de comprobantes de retención:

En el ejemplo anterior se puede visualizar que la petición va dividida en dos partes:

• La primera de ellas es el Header.

• La segunda es aquella que contiene la petición hacia el servicio con los parámetros ya establecidos
anteriormente.

Ejemplo de Respuesta del Servicio de timbrado de comprobantes de retención:

7
En el ejemplo mostrado en la imagen anterior se puede ver que la respuesta contiene dos partes:

• La primera de ellas es el Header que contiene temas relacionados con la seguridad.

• La segunda de ellas es el body que contendrá los parámetros de salida mencionados
anteriormente, es decir, el acuse.

Mensajes Recibidos desde el servicio: Catálogo de Incidencias Timbrado de Retenciones

En caso de que se haya realizado la petición al servicio de manera satisfactoria, se recibirá un código 200,
adicionalmente el servicio de timbrado estará respondiendo un acuse, la cual contendrá un código de
respuesta y una descripción de dicho código, estos puntos se describen a continuación.

Códigos de Encabezado:

Evento Mensaje

8
 800 Archivo recibido exitosamente

801 Autenticación inválida.

803 Comprobante vacío o nulo

804 XML no codificado en UTF-8.
805 El archivo no es XML.
806 Emisor no corresponde al que se autenticó.
807 Estructura no válida.
822 Estructura completa no válida
823 Comprobante no pudo ser timbrado

Detalle de Errores:

Evento Mensaje

808 XML error de esquema

809 Sello no corresponde al emisor

810 Certificado usado no es de tipo CSD

811 La fecha de emisión no está dentro de la vigencia del CSD del Emisor
813 Sello mal formado o inválido
814 Certificado usado no fue expedido por el SAT
815 Certificado no registrado
816 Certificado y obligaciones reportan incidencias
817 Certificado reporta incidencia
818 Obligaciones reporta incidencia
819 Problema con la LCO
827 No cumple con validaciones adicionales
828 Versión de comprobante no válido.

Fin del documento.