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

Para emitir Documentos Electrónicos que ampara Retenciones e Información de Pagos en Reachcore por archivo de integración de texto plano, conforme lo definido por el SAT en la siguiente liga Retenciones SAT, se debe de considerar 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 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 numéricos con fracción hasta seis decimales, definido por el SAT.
• Fecha/Hora – Tipo definido para definir fecha y hora que se expresa en la forma yyyy-mm-ddThh:mm:ssZ, de acuerdo con la especificación ISO 8601. Ej: 2013-12-31T23:59:59-06:00
• 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 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.

**Nota importante: Para esta línea, solo debes poner uno de los indicadores, ya sea Nacional o Extranjero. No puedes poner los dos indicadores, ya que son excluyentes, es decir, solo puede ponerse uno de los dos.

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 5 líneas, marcadas en rojo:

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

Este es un ejemplo de un TXT con los datos más utilizados y requeridos

LoteRetenciones
Documento|Cfd|Intereses Hipotecarios
Retenciones|1.0|A123BC||2014-12-15T00:00:00-06:00|01|01
Emisor|AAA010101AAA|Razón social del Emisor|OIBR780920HDFRNNO9
Receptor|Nacional|BBB020202BBB|Nombre o denominación del receptor|OIBR780920HDFRNNO9
Periodo|1|12|2004
Totales|1.123456|1.123456|1.123456|1.123456|ImpRet|1.123456|02|1.123456|Pago definitivo

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 DescRetenc="01" Sello="ZenqoD5bMHVgFuXbK6Odh0dw9WAQrl7UnhVYZsqQinDH83f5T9Va2vgDdjnk6tkF/D07aW/b4RGVXgyx+aN/o/NEqyW7Xmn2H9HSek9LlMBjErwBIe+rCjD0S5FDvYP0AmECzVScMGPcXv6dMAUCRXGbRNlUkBQpWN/fIGDA3Vs=" Version="1.0" xmlns:retenciones="http://www.sat.gob.mx/esquemas/retencionpago/1" Cert="MIIEdDCCA1ygAwIBAgIUMjAwMDEwMDAwMDAxMDAwMDU4NjcwDQYJKoZIhvcNAQEFBQAwggFvMRgwFgYDVQQDDA9BLkMuIGRlIHBydWViYXMxLzAtBgNVBAoMJlNlcnZpY2lvIGRlIEFkbWluaXN0cmFjacOzbiBUcmlidXRhcmlhMTgwNgYDVQQLDC9BZG1pbmlzdHJhY2nDs24gZGUgU2VndXJpZGFkIGRlIGxhIEluZm9ybWFjacOzbjEpMCcGCSqGSIb3DQEJARYaYXNpc25ldEBwcnVlYmFzLnNhdC5nb2IubXgxJjAkBgNVBAkMHUF2LiBIaWRhbGdvIDc3LCBDb2wuIEd1ZXJyZXJvMQ4wDAYDVQQRDAUwNjMwMDELMAkGA1UEBhMCTVgxGTAXBgNVBAgMEERpc3RyaXRvIEZlZGVyYWwxEjAQBgNVBAcMCUNveW9hY8OhbjEVMBMGA1UELRMMU0FUOTcwNzAxTk4zMTIwMAYJKoZIhvcNAQkCDCNSZXNwb25zYWJsZTogSMOpY3RvciBPcm5lbGFzIEFyY2lnYTAeFw0xMjA3MjcxNzAyMDBaFw0xNjA3MjcxNzAyMDBaMIHbMSkwJwYDVQQDEyBBQ0NFTSBTRVJWSUNJT1MgRU1QUkVTQVJJQUxFUyBTQzEpMCcGA1UEKRMgQUNDRU0gU0VSVklDSU9TIEVNUFJFU0FSSUFMRVMgU0MxKTAnBgNVBAoTIEFDQ0VNIFNFUlZJQ0lPUyBFTVBSRVNBUklBTEVTIFNDMSUwIwYDVQQtExxBQUEwMTAxMDFBQUEgLyBIRUdUNzYxMDAzNFMyMR4wHAYDVQQFExUgLyBIRUdUNzYxMDAzTURGUk5OMDkxETAPBgNVBAsTCFVuaWRhZCAxMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC2TTQSPONBOVxpXv9wLYo8jezBrb34i/tLx8jGdtyy27BcesOav2c1NS/Gdv10u9SkWtwdy34uRAVe7H0a3VMRLHAkvp2qMCHaZc4T8k47Jtb9wrOEh/XFS8LgT4y5OQYo6civfXXdlvxWU/gdM/e6I2lg6FGorP8H4GPAJ/qCNwIDAQABox0wGzAMBgNVHRMBAf8EAjAAMAsGA1UdDwQEAwIGwDANBgkqhkiG9w0BAQUFAAOCAQEATxMecTpMbdhSHo6KVUg4QVF4Op2IBhiMaOrtrXBdJgzGotUFcJgdBCMjtTZXSlq1S4DG1jr8p4NzQlzxsdTxaB8nSKJ4KEMgIT7E62xRUj15jI49qFz7f2uMttZLNThipunsN/NF1XtvESMTDwQFvas/Ugig6qwEfSZc0MDxMpKLEkEePmQwtZD+zXFSMVa6hmOu4M+FzGiRXbj4YJXn9Myjd8xbL/c+9UIcrYoZskxDvMxc6/6M3rNNDY3OFhBK+V/sPMzWWGt8S1yjmtPfXgFs1t65AZ2hcTwTAuHrKwDatJ1ZPfa482ZBROAAX1waz7WwXp0gso7sDCm2/yUVww==" NumCert="20001000000100005867" FechaExp="2014-12-15T00:00:00-06:00" CveRetenc="01">
  <retenciones:Emisor RFCEmisor="AAA010101AAA" CURPE="OIBR780920HDFRNNO9" NomDenRazSocE="Razón social del Emisor" />
  <retenciones:Receptor Nacionalidad="Nacional">
    <retenciones:Nacional CURPR="OIBR780920HDFRNNO9" RFCRecep="BBB020202BBB" NomDenRazSocR="Nombre o denominación del receptor" />
  </retenciones:Receptor>
  <retenciones:Periodo Ejerc="2004" MesFin="12" MesIni="1" />
  <retenciones:Totales montoTotOperacion="1.123456" montoTotExent="1.123456" montoTotRet="1.123456" montoTotGrav="1.123456">
    <retenciones:ImpRetenidos Impuesto="02" montoRet="1.123456" BaseRet="1.123456" TipoPagoRet="Pago definitivo" />
  </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/TimbreFiscalDigital/TimbreFiscalDigital.xsd" version="1.0" UUID="BBB9534F-E5A5-4A0A-BAA3-A645ACF14D74" FechaTimbrado="2014-12-16T11:22:36" selloCFD="ZenqoD5bMHVgFuXbK6Odh0dw9WAQrl7UnhVYZsqQinDH83f5T9Va2vgDdjnk6tkF/D07aW/b4RGVXgyx+aN/o/NEqyW7Xmn2H9HSek9LlMBjErwBIe+rCjD0S5FDvYP0AmECzVScMGPcXv6dMAUCRXGbRNlUkBQpWN/fIGDA3Vs=" noCertificadoSAT="20001000000300003693" selloSAT="ZKiyfsjK/KddTLCnspqabqqBUseW7b6iM4mafnaYe5eANsk1aigboMokFiGYQNgopTHyivC2uTHoLff3IjQ2zw3RUB6KTuD9X0tobNM0QbntMH+zuoxC5OqTQJbtMesUXXgeXD2COZjhStDXNUalmkKLLFjOL9QIWhCJi5g7ui0=" />
  </retenciones:Complemento>
</retenciones:Retenciones>

Catálogos

A continuación se muestra el catalogo definido 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.

Retenciones

Impuestos

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