Archivo integración - TXT: Documento electrónico que ampara Retenciones e Información de Pagos 2.0

Para emitir Documentos Electrónicos que amparan Retenciones e Información de Pagos en su versión 2.0 por medio de la plataforma de emisión por archivo de texto plano de Sovos Reachcore, conforme la estructura definida por el SAT en el Anexo 20 de 2022, se debe seguir la siguiente guía para generar el archivo.

Contenido

• Características
• Secciones
  • LoteRetenciones
  • Documento
  • Retenciones
  • Emisor
  • Receptor
  • Periodo
  • Totales
  • Complementos
  • Addendas
  • Datos de impresión
• Ejemplo TXT
• Catálogos

Características del archivo plano

El archivo de texto plano deberá cumplir con las siguientes características para su correcto procesamiento en Sovos Reachcore:

• Debe ser un archivo de texto plano con extensión .txt.
• La codificación del archivo debe ser UTF-8.
• El fin de línea debe ser en formato Windows, es decir <CR><LF>.
• El carácter que separará los datos es un pipe |.
• El archivo de integración tiene varias líneas, en donde existe Indicadores para delimitar una sección de información; estos indicadores están al inicio de cada línea, así como en diferentes posiciones dentro de la misma línea. En la guía se muestran en color rojo los que son requeridos y en color azul los opcionales.
• En caso de no existir datos para un valor en particular que es opcional dentro de una sección que se está utilizando, se deberá respetar la posición del valor aunque no contenga ningún dato.
  Ej.: Indicador|valor1|valor2||valor4||valor6
• Los indicadores no son sensibles a mayúsculas y minúsculas. Por ejemplo Addendas = addendas.
• No hay restricciones en el nombre de archivo; se sugiere que sea único con fines de seguimiento en el proceso.
• El archivo TXT tiene la capacidad para procesar varios Documentos Electrónicos en un solo archivo.

Secciones del archivo plano

Esta guía define la generación del archivo de texto plano, que se divide en 10 secciones; en cada sección se describen los campos para el procesamiento: los fiscales (conforme la definición del SAT), los que se mostrarán en la representación impresa, así como los que son parte de una addenda.

1. LoteRetenciones.- línea requerida para indicar el inicio del archivo; solo aparece una sola vez en el TXT.
2. Documento.- línea requerida para indicar el inicio de un documento electrónico en el TXT; aparece conforme al número de documentos electrónicos a emitir por archivo. ../../ ../../
3. Receptor.- línea requerida para indicar los datos del receptor del documento electrónico; solo aparece una vez dentro de Retenciones.
4. Periodo.- línea requerida para indicar el periodo del documento electrónico; solo aparece una vez dentro de Retenciones.
5. Totales.- línea requerida donde se indican los totales del documento electrónico; solo aparece una vez dentro de Retenciones.
6. Complemento.- línea opcional en donde se describen los datos para complementos definidos por el SAT, del documento electrónico.
7. Addenda.- línea opcional en donde se indican los datos para la generación de la addenda.
8. Impresion.- línea opcional en donde se indican los datos con el propósito de mostrar en la representación impresa (PDF).

A lo largo de la guía, encontrarás tablas con los siguientes encabezados, para mostrar las características de cada dato en cada posición del archivo de texto plano

La columna "Tipo" hace referencia a los tipos de datos conforme lo siguiente:

• Texto – Tipo definido para cadena de caracteres alfanuméricos.
• Importe – Tipo definido para expresar importes monetarios en moneda nacional MXN con fracción hasta dos decimales. No se permiten valores negativos. Lo define la siguiente expresión regular: [0-9]{1,18}(.[0-9]{1,2})?.
• Fecha/Hora – Tipo definido para definir fecha y hora que se expresa en la forma yyyy-mm-ddThh:mm:ss, de acuerdo con la especificación ISO 8601. Ej: 2013-12-31T23:59:59
• RFC – tipo definido para expresar el Registro Federal de Contribuyentes (RFC) definido por el SAT, con la siguiente expresión regular: ([A-Z,Ñ,&]{3,4}[0-9]{2}[0-1][0-9][0-3][0-9][A-Z,0-9]?[A-Z,0-9]?[0-9,A-Z]?).
• CURP – Tipo definido para expresar la Clave Única de Registro de Población (CURP), con la siguiente expresión regular: [A-Z][A,E,I,O,U,X][A-Z]{2}[0-9]{2}[0-1][0-9][0-3][0-9][M,H][A-Z]{2}[B,C,D,F,G,H,J,K,L,M,N,Ñ,P,Q,R,S,T,V,W,X,Y,Z]{3}[0-9,A-Z][0-9].

Línea LoteRetenciones

Indica el inicio del archivo de integración y es requerido para su procesamiento. Sólo existe una sola línea en el archivo de texto plano.

Línea Documento

Indica el inicio de la información para la generación de un documento electrónico de retenciones. Puede repetirse varias veces, conforme al número de documentos de retenciones que se necesite procesar en un solo archivo de texto plano.

Los siguientes parámetros pueden utilizarse sin ninguna configuración adicional.

Para hacer uso de los siguientes parámetros, se requiere de una configuración adicional en tu cuenta. Si necesitas esta funcionalidad, por favor contáctanos a MEX-soporte@sovos.com

A continuación el ejemplo de como se deben de incluir los datos de control en la línea DOCUMENTO:

• En color azul los indicadores
• Entre corchetes [ ], se muestra el nombre del campo, en donde se incluye los valores correspondientes, conforme a la definición previa.
• Para los valores Propiedad y Valor, después de los indicadores DatosDeControl y DatoDeControl, se pueden utilizar los parámetros descritos previamente, conforme la funcionalidad que se requiera. Se pueden poner varios indicadores DatoDeControl

DOCUMENTO|Cfd|[TipoDeDocumento]|Receptor|[nombre]|[e-mail]|DatosDeControl|DatoDeControl|[Propiedad]|[Valor]|DatoDeControl|[Propiedad]|[Valor]

Línea Retenciones

Indica los datos del elemento Retenciones; es requerido y sólo existe una línea después de Documento.

Línea CFDI de Retenciones Relacionados

Indica la información de los comprobantes relacionados. Esta línea se puede omitir ya que la información de este nodo es opcional.

Línea Emisor

Indica la información del contribuyente emisor del documento electrónico de retenciones e información de pagos.

Línea Receptor

Indica la información del contribuyente receptor del documento electrónico de retenciones e información de pagos.

Línea Periodo

Indica el periodo que ampara el documento de retenciones e información de pagos.

Línea Totales

Indica el total del documento electrónico de retenciones e información de pagos.

Línea Complementos

Las guías para integrar los datos de un complemento del documento electrónico de retenciones e información de pagos, puedes consultarlas en la siguiente liga.

Línea Addendas

Las guías para integrar los datos para una addenda para el documento electrónico de retenciones e información de pagos, puedes consultarlas en la siguiente liga.

Línea Impresión

Indica el inicio de los datos de impresión con el fin de que sean mostrados en la representación impresa del documento electrónico de retenciones e información de pagos (archivo PDF) y no en el XML.

A continuación se presenta un ejemplo para la sección de datos de impresión

Impresion|Tabla|libro|Atributo|genero|novela
Fila|indice|Atributo|fuente|trebuchet
Fila|prologo|Atributo|fuente|tahoma|Atributo|peso|italica
Fila|capitulo|Atributo|fuente|arial|Atributo|peso|bold|Atributo|color|negro
Tabla|volumen|Atributo|Edicion|1978|Atributo|tomos|15
Fila|uno|Atributo|paginas|120
Fila|dos|Atributo|paginas|154|Atributo|fuente|tahoma
Fila|tres|Atributo|paginas|200|Atributo|peso|bold|Atributo|fuente|arial

El resultado de la sección en el TXT de los TXT en la estructura XML que se utiliza para generar el PDF:

<DatosDeImpresion>
	<libro genero="novela" >
		<indice fuente="trebuchet" />
		<prologo fuente="tahoma" peso="italica" />
		<capitulo fuente ="arial" peso="bold" color="negro" />
	</libro>
	<volumen edicion="1978" tomos="15" >
		<uno paginas="120" />
		<dos paginas="154" fuente="tahoma" />
		<tres paginas="200" peso="bold" fuente ="arial" />
	</volumen>
</DatosDeImpresion>

Ejemplo del archivo TXT

Finalmente, la estructura de un archivo de integración completo consta de al menos 7 líneas, marcadas en rojo:

1. LoteRetencion
2. Documento
3. Retenciones
4. CfdiRetenRelacionados
5. Emisor
6. Receptor
7. Periodo
8. Totales
9. Complemento
10. Addenda
11. Impresion

Este es un ejemplo de un TXT con los datos básicos para generar un documento de retenciones e información de pagos 2.0

El resultado del TXT del ejemplo anterior, tiene como resultado el siguiente documento electrónico de retenciones e información de pagos - XML.

<?xml version="1.0" encoding="UTF-8"?>
<retenciones:Retenciones Version="2.0" FolioInt="PRODUCTO0005" Sello="OpMZhWLNyBDiTOlB1x0Mdr0+CTWBUHpf59ZvNj8D4/ThnPyj3v/fc3/sSorXEeSgL0RHgRQ4S+nwkYFDbbScrAh/VQDoJlA04lFO/lWeOnsi65GrYSxgBs7zVGv7JdKqCWBduYuQ30x7JFeigEYTSDFeo3EkgaJHEVS7QzXzifNN5bwddspmmOK/fqADqAN0UXMRmTdcs6DY9qXXNLBbf17PnvuxmiLXYBTWnQRy6hpQQ5G//xvtCmTxGplCwdINAzFxKPgNr5gtyfyLPcsbl9SEUxtZM5CfF7jPtCTc5/Js69/YPuBoBHu9EyMp5wfdiJjti1/5mXBK0AJWDjlN5Q==" NoCertificado="30001000000400002434" Certificado="MIIFuzCCA6OgAwIBAgIUMzAwMDEwMDAwMDA0MDAwMDI0MzQwDQYJKoZIhvcNAQELBQAwggErMQ8wDQYDVQQDDAZBQyBVQVQxLjAsBgNVBAoMJVNFUlZJQ0lPIERFIEFETUlOSVNUUkFDSU9OIFRSSUJVVEFSSUExGjAYBgNVBAsMEVNBVC1JRVMgQXV0aG9yaXR5MSgwJgYJKoZIhvcNAQkBFhlvc2Nhci5tYXJ0aW5lekBzYXQuZ29iLm14MR0wGwYDVQQJDBQzcmEgY2VycmFkYSBkZSBjYWRpejEOMAwGA1UEEQwFMDYzNzAxCzAJBgNVBAYTAk1YMRkwFwYDVQQIDBBDSVVEQUQgREUgTUVYSUNPMREwDwYDVQQHDAhDT1lPQUNBTjERMA8GA1UELRMIMi41LjQuNDUxJTAjBgkqhkiG9w0BCQITFnJlc3BvbnNhYmxlOiBBQ0RNQS1TQVQwHhcNMTkwNjE3MTk0NDE0WhcNMjMwNjE3MTk0NDE0WjCB4jEnMCUGA1UEAxMeRVNDVUVMQSBLRU1QRVIgVVJHQVRFIFNBIERFIENWMScwJQYDVQQpEx5FU0NVRUxBIEtFTVBFUiBVUkdBVEUgU0EgREUgQ1YxJzAlBgNVBAoTHkVTQ1VFTEEgS0VNUEVSIFVSR0FURSBTQSBERSBDVjElMCMGA1UELRMcRUtVOTAwMzE3M0M5IC8gWElRQjg5MTExNlFFNDEeMBwGA1UEBRMVIC8gWElRQjg5MTExNk1HUk1aUjA1MR4wHAYDVQQLExVFc2N1ZWxhIEtlbXBlciBVcmdhdGUwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCN0peKpgfOL75iYRv1fqq+oVYsLPVUR/GibYmGKc9InHFy5lYF6OTYjnIIvmkOdRobbGlCUxORX/tLsl8Ya9gm6Yo7hHnODRBIDup3GISFzB/96R9K/MzYQOcscMIoBDARaycnLvy7FlMvO7/rlVnsSARxZRO8Kz8Zkksj2zpeYpjZIya/369+oGqQk1cTRkHo59JvJ4Tfbk/3iIyf4H/Ini9nBe9cYWo0MnKob7DDt/vsdi5tA8mMtA953LapNyCZIDCRQQlUGNgDqY9/8F5mUvVgkcczsIgGdvf9vMQPSf3jjCiKj7j6ucxl1+FwJWmbvgNmiaUR/0q4m2rm78lFAgMBAAGjHTAbMAwGA1UdEwEB/wQCMAAwCwYDVR0PBAQDAgbAMA0GCSqGSIb3DQEBCwUAA4ICAQBcpj1TjT4jiinIujIdAlFzE6kRwYJCnDG08zSp4kSnShjxADGEXH2chehKMV0FY7c4njA5eDGdA/G2OCTPvF5rpeCZP5Dw504RZkYDl2suRz+wa1sNBVpbnBJEK0fQcN3IftBwsgNFdFhUtCyw3lus1SSJbPxjLHS6FcZZ51YSeIfcNXOAuTqdimusaXq15GrSrCOkM6n2jfj2sMJYM2HXaXJ6rGTEgYmhYdwxWtil6RfZB+fGQ/H9I9WLnl4KTZUS6C9+NLHh4FPDhSk19fpS2S/56aqgFoGAkXAYt9Fy5ECaPcULIfJ1DEbsXKyRdCv3JY89+0MNkOdaDnsemS2o5Gl08zI4iYtt3L40gAZ60NPh31kVLnYNsmvfNxYyKp+AeJtDHyW9w7ftM0Hoi+BuRmcAQSKFV3pk8j51la+jrRBrAUv8blbRcQ5BiZUwJzHFEKIwTsRGoRyEx96sNnB03n6GTwjIGz92SmLdNl95r9rkvp+2m4S6q1lPuXaFg7DGBrXWC8iyqeWE2iobdwIIuXPTMVqQb12m1dAkJVRO5NdHnP/MpqOvOgLqoZBNHGyBg4Gqm4sCJHCxA1c8Elfa2RQTCk0tAzllL4vOnI1GHkGJn65xokGsaU4B4D36xh7eWrfj4/pgWHmtoDAYa8wzSwo2GVCZOs+mtEgOQB91/g==" FechaExp="2022-02-18T00:00:00" LugarExpRetenc="26015" CveRetenc="25" DescRetenc="Retención de Prueba" xmlns:retenciones="http://www.sat.gob.mx/esquemas/retencionpago/2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.sat.gob.mx/esquemas/retencionpago/2 http://www.sat.gob.mx/esquemas/retencionpago/2/retencionpagov2.xsd">
  <retenciones:Emisor RfcE="EKU9003173C9" NomDenRazSocE="ESCUELA KEMPER URGATE SA DE CV" RegimenFiscalE="626" />
  <retenciones:Receptor NacionalidadR="Nacional">
    <retenciones:Nacional RfcR="CACX7605101P8" NomDenRazSocR="XOCHILT CASAS CHAVEZ" DomicilioFiscalR="10740" />
  </retenciones:Receptor>
  <retenciones:Periodo MesIni="01" MesFin="12" Ejercicio="2021" />
  <retenciones:Totales MontoTotOperacion="100.00" MontoTotGrav="0.00" MontoTotExent="100.00" MontoTotRet="0.00">
    <retenciones:ImpRetenidos BaseRet="0.00" ImpuestoRet="002" MontoRet="0.00" TipoPagoRet="01" />
  </retenciones:Totales>
  <retenciones:Complemento>
    <tfd:TimbreFiscalDigital xmlns:tfd="http://www.sat.gob.mx/TimbreFiscalDigital" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.sat.gob.mx/TimbreFiscalDigital http://www.sat.gob.mx/sitio_internet/cfd/TimbreFiscalDigital/TimbreFiscalDigitalv11.xsd" Version="1.1" UUID="9EEA7433-40A3-43B6-89ED-33F020D90BDD" FechaTimbrado="2022-02-19T00:46:05" RfcProvCertif="ASE0201179X0" SelloCFD="OpMZhWLNyBDiTOlB1x0Mdr0+CTWBUHpf59ZvNj8D4/ThnPyj3v/fc3/sSorXEeSgL0RHgRQ4S+nwkYFDbbScrAh/VQDoJlA04lFO/lWeOnsi65GrYSxgBs7zVGv7JdKqCWBduYuQ30x7JFeigEYTSDFeo3EkgaJHEVS7QzXzifNN5bwddspmmOK/fqADqAN0UXMRmTdcs6DY9qXXNLBbf17PnvuxmiLXYBTWnQRy6hpQQ5G//xvtCmTxGplCwdINAzFxKPgNr5gtyfyLPcsbl9SEUxtZM5CfF7jPtCTc5/Js69/YPuBoBHu9EyMp5wfdiJjti1/5mXBK0AJWDjlN5Q==" NoCertificadoSAT="30001000000300036825" SelloSAT="EQ1pFYvPfe4QcP7VFcXt1ynKS9hbQfcAMMuqSUdRMNivedvfPoiLHUJStBTFqqHanbNUthDiiN3UqZajUGe5FhaSGn5qwPhkallWsDZsRvCokzoSkCTPTOS5zaAABmpXPzt3OXZyUwTCN0EXWYqBKzQKVu5uQljPWc7ZJc4saDTYwEIOuGIQsjFDhEEGrejKrXMkE3fRQDTnbEvQ9wC97lH9y/udVBgS10izp3V2STufLhVpqduAS5UWmD3n0AkSqmZQFLEOYJ0XtVH6D3ZHlXWiESDU12pdbKc8UQEJVkL1i8rn1l6YZdnrsgACZ24kif8gxPVGx91LMtR9825ooQ==" />
  </retenciones:Complemento>
</retenciones:Retenciones>

Catálogos

Los catálogos específicos de Retenciones, se pueden descargar de la página Actualización factura electrónica – Reforma Fiscal 2022 por medio de la sección de Contenidos Relacionados, subsección Catálogo de retenciones (xls).

A continuación se muestra información de catalogos sdefinido por el SAT para cada uno de los diferentes campos que se utilizan en los documentos electrónicos de retenciones e información de pagos 2.0

Catálogo de códigos postales.

Para Retenciones 2.0 se usa el mismo catálogo de códigos postales que usa CFDI 4.0, el cual se puede descargar desde la página de Formato de factura (Anexo 20). Por el tamaño del catálogo de código postal, no se describe su contenido en esta página.

Catálogo de Retenciones.

Catálogo de tipos de relación entre CFDI.

Catálogo de Régimen Fiscal.

Catálogo periodo.

Catálogo ejercicio.

Catálogo de impuestos.

Catálogo tipo pago de la retención.

Soporte

Para mayor información o aclaración de dudas relacionadas con esta guía, por favor envía un correo a MEX-soporte@sovos.com