Especificaciones Estructura Archivo TXT

Transcripción

1 2017 Especificaciones Estructura Archivo TXT Versión documento 1.0 Este documento contiene las especificaciones y descripciones de los campos del archivo TXT de Recibo de Nómina versión 1.2 que será requerido a partir de Enero 2017 DotNet Desarrollo de Sistemas Calle Sauce No. 2, SM 43, Cancún, Quintana Roo Tel. (998) y (998) info@dotnet.com.mx

2 Contenido Control del Documento... 3 Especificaciones archivo TXT... 4 Especificaciones Información nómina... 5 DICCIONARIO DE TOKENS...6 Page 2 of

3 Control del Documento Revisado y aprobado por: Nombre Firmas Versión documento Hebert Ricardo Peña serna Business Analyst facturador.com 1.0 Electrónico Enrique Poot Poot Project Manager 1.0 Page 3 of

4 Especificaciones archivo TXT Al generar su archivo de texto es importante que tome en cuenta las siguientes observaciones: El archivo debe contener solo texto plano, es decir solo caracteres. El archivo debe estar codificado en UTF-8. Un archivo de texto, representa un solo recibo de nómina. Es importante que la información que vaya a estar manejando en el archivo de texto haya sido verificada por su contador o área administrativa 1. La lógica del archivo contiene las siguientes propiedades importantes: o Datos: descripciones, fechas, cantidades o TOKENS: Palabras que engloban o conglomeran cierta información sobre una línea. Ejemplo: EMISOR o PIPES: Carácter que sirve de limitador de datos o TOKENS Cada token debe ir en el orden mostrado en este documento. El dato del campo fecha no debe tener más de 72hrs de creación. El campo Fecha se expresa en la forma aaaa-mm-ddthh:mm:ss, de acuerdo con la especificación ISO Cuando la información de un campo es requerida los pipes deben encerrar la información que corresponda. Ejemplo: Pesos Cuando la información del campo es opcional solo se establecen los pipes. Ejemplo. Datos de tipo moneda, por ejemplo: importes, totales, etc. Deberán manejar el punto decimal. Ejemplo Los datos decimales deben seguir la siguiente regla 14,4 quiere decir: o 14 : Es el número total máximo de dígitos decimales que se pueden establecer, tanto a la izquierda como a la derecha del punto decimal. o 4 : El número de dígitos decimales que se soportan a la derecha del punto decimal Ciertos datos como RFC, CURP, NSS, deben seguir las expresiones regulares que se especifican en los esquemas del SAT. Si uno de los correos establecidos está mal formado, se rompe todo el proceso y se regresa error al conector. 1 Esto evita que en ocasiones se generen comprobantes con datos no válidos, no aplicables ó que no corresponden al comprobante que se quiere crear. Page 4 of

5 Especificaciones Información nómina El Cliente debe tener configurado un lugar de expedición como mínimo en Facturador Web. El cliente debe estar dado de alta en Facturador Electrónico con su información Las claves de percepciones, deducciones, bancos u otros datos de la nómina, deben establecerse conforme los catálogos del SAT. Si manejan incapacidad debe ir el token INCAPACIDAD correspondiente. Si manejan hora extra debe ir el token HEXTRA correspondiente. Si el empleado es pensionado o jubilado debe ir el token JUBILACIONPENSION Si se esta realizando una indemnización debe ir el token SEPARACIONIND Si al empleado se le paga con acciones o títulos debe ir el token ACCIONESOTITULOS El archivo txt siempre debe tener o una percepción o una deducción o ambas ó una hora extra o incapacidad o ambas. Los campos donde se establecen valores entre corchetes son diversas opciones que se pueden manejar para ese campo por ejemplo: NOMBRE PERIODO [02] [03] [04] [05] [06] Estos valores deben establecerse según lo descrito en este documento, de lo contrario marcarán error. Page 5 of

6 DICCIONARIO DE TOKENS Descripción TOKEN NOMINA VERSION SUBTOTAL FUNCION/DESCRIPCION Establece el tipo de documento del archivo Establece la versión del documento. Establece la suma de los importes de los conceptos. PDF CORREOS DETALLE MONEDA DOMICILIO EMISOR RECEPTOR CONCEPTO IMPT_R IMPT_T DETALLENOMINA PERIODO F_PAGO D TOTAL_P G E TOTAL_D REGPATRONAL PUESTO SD_B SD_I EMPLEADO NSS LABORAL RC C Establece si genera pdf Establece el o los correos a donde llegará una vez se genere el recibo. Establece el detalle base del comprobante. Establece el nombre de la moneda y el tipo de cambio. Establece el domicilio fiscal de Emisor o Receptor. Establece los datos base del Emisor de la factura. Establece los datos del receptor de la factura. Establece el bien o servicio que se está realizando en la transacción de esta factura. Establece impuesto Retenido Establece impuesto Trasladado Establece el detalle base de la nomina Establece el periodo a la que pertenece esta nomina Establece la fecha de pago de la nómina Establece número de días Establece el total de las percepciones Establece el monto gravado Establece el monto excento Establece el total de las deducciones Establece el registro patronal de la nomina Establece un puesto Establece el sueldo diario base Establece el sueldo diario Integral Establece los datos base de un empleado Establece el numero social del empleado Establece los datos que complementan al empleado Establece el régimen de contratación Establece el tipo de contrato Page 6 of

7 I Establece la Fecha de ingreso del empleado J Establece la Jornada Laboral del Trabajador HEXTRA Establece un tipo de percepción de hora extra DOBLES Establece el tipo de percepción de horas dobles TRIPLES Establece el tipo de percepción de horas triples H Establece horas T Establece el total de la hora extra o incapacidad INCAPACIDAD Establece el nodo incapacidad TIPO_I Establece el tipo de incapacidad OP Establece el total de otros pagos que no corresponden con el salario del empelado JUBILACIONPENSION Establece la información del pago por pensión a un empleado SEPARACIONIND Establece la información cuando se realiza un comprobante por indemnización ACCIONESOTITULOS Establece cuando a un empleado se le paga con acciones o propiedades Page 7 of

8 Ejemplo de cada token NOMINA1_2 TIPO DE COMPROBANTE EGRESO Texto Requerido 6 SERIE DEL COMPROBANTE Sin Serie Texto Requerido 10 VERSION VERSION DEL ESQUEMA SAT 3.2 Decimal Requerido 3 SUBTOTAL TOTAL DESCUENTO SUBTOTAL Moneda Requerido 14,2 TOTAL DEL COMPROBANTE Moneda Requerido 14,2 IMPORTE DEL DESCUENTO Moneda Opcional 14,2 PDF CORREOS INFOEXTRA GENERAR PDF [1] SI EL O LOS CORREOS A DONDE LLEGARA EL RECIBO DE NÓMINA UNA VEZ GENERADO, LA SEPARACION DE CORREOS ES MEDIANTE LA COMA, Información adicional Nota o Aviso que se desea que aparezca en el PDF 1 Bit Requerido dmadrigal@dotnet.com.mx, esanchez@dotnet.com.mx Texto Opcional No olvides pedir tus días de vacaciones Text Opcional 1 Bit NOMINA1_2 egreso Sin Serie VERSION 3.2 SUBTOTAL TOTAL DESCUENTO PDF 1 CORREOS dmadrigal@dotnet.com.mx,esanchez@dotnet.com.mx INFOEXTRA No olvides perdir tus días de vacaciones Page 8 of

9 DETALLE T12:28:00 Datetime Requerido DATE TIME FECHA DE EMISIÓN DEL COMPROBANTE (ISO 8601) Formato aaaa-mm-ddthh:mm:ss DETALLE T12:28:00 Page 9 of

10 EMISOR RFC DEL EMISOR Este dato debe seguir la expresión regular del SAT 2 GOYA780416GM0 Texto Requerido REGIMEN DE PEQUEÑO CONTRIBUYENTE Conforma a catálogo del SAT RFC PATRON RFC del último patrón (Solo jubilados o indemnización) CURP Curp del emisor, solo si es persona física 612 Texto Requerido PESH Q Texto Opcional PESH880507HVZXRB00 Texto Opcional LugarExpedición Entero Requerido ENTERO ENTERO EMISOR GOYA780416GM0 Régimen de pequeño contribuyente La demás información del emisor se toma de la establecida en facturador electrónico. RFC debe ir en mayúscula 2 Para más información consultar el esquema del SAT: Page 10 of

11 RECEPTOR RFC DEL RECEPTOR Este dato debe seguir la expresión AVV880912DQ4 Texto Requerido regular del SAT 3 NOMBRE DE LA EMPRESA/CONTRIBUYENTE Jose Perez Hernandez Texto Requerido RECEPTOR AVV880912DQ4 jose perez hernandez RFC debe ir en mayúscula 3 Para más información consultar el tipot_rfc en el esquema del SAT: Page 11 of

12 CONCEPTO VALOR UNITARIO Moneda Requerido 14,4 IMPORTE Moneda Requerido 14,4 CONCEPTO Page 12 of

13 DETALLENOMINA NOMBRE DE LA NÓMINA Mi primer nomina Texto Requerido 100 O Texto Requerido 1 PERIODO F_PAGO D TOTAL_P G E OP TOTAL_D I REGPATRONAL TIPO DE LA NÓMINA [O] - Ordinaria [E] - Extraordinaria FECHA DE INICIO Formato yyyy-mm-dd FECHA DE TERMINO Formato yyyy-mm-dd NOMBRE PERIODO [01],[02] [09],99 FECHA DE PAGO Formato yyyy-mm-dd DIAS En caso de no conocer los días pagados, especificar 1 GRAVADO DEL TOTAL DE PERCEPCIONES EXCENTO DEL TOTAL DE PERCEPCIONES DATE Requerido Date DATE Requerido Date 01 ENTERO Requerido DATE Requerido Date 30 Entero Requerido 2 ENTEREO 1-3 Entero.00 Moneda Requerido 14, Moneda Requerido 14,2 Total de Otros Pagos 200 Moneda Opcional 14,2 IMPORTE TOTAL DE DEDUCCIONES Moneda Requerido 14,2 CLAVE O NUMERO REGISTRO PATRONAL Texto Requerido CLAVE 4 1 Entero Requerido Entero DETALLENOMINA Mi primer nomina O PERIODO 01/01/ /02/ F_PAGO 15/01/2014 D 30 TOTAL_P G.00 E 0.0 OP 0 TOTAL_D I REGPATRONAL Consultar documento catalogoscomplementonomina apartado 3.Riesgo Puesto Page 13 of

14 PUESTO CLAVE DEL PUESTO 09B Texto Requerido 5 NOMBRE DEL PUESTO Jefe de sistemas Texto Requerido 100 SD_B SALARIO DIARIO BASE Moneda Requerido 14,2 SD_I SALARIO DIARIO INTEGRAL Moneda Requerido 14,2 PUESTO 09B Jefe de sistemas SD_B SD_I Page 14 of

15 EMPLEADO NÚMERO DEL EMPLEADO A980 Texto Requerido 15 CURP 18 Esta información debe seguir la expresión regular del SAT 5 GOFC861015HCHMNR04 Texto Requerido NSS LABORAL RC C I J CEF Sindicalizado DEPTO ISPT FOAHO NÚMERO DE SEGURIDAD SOCIAL 5346 Texto Requerido RÉGIMEN DE CONTRATACIÓN 6 [02], [03], [04], [05] [11],[99] TIPO DE CONTRATO [01], [02].[10],[99] FECHA DE INGRESO DEL EMPLEADO Formato yyyy-mm-dd Antiguedad 7 TIPO DE JORNADA [01],[02]..[08],[99] 02 Entero Requerido 01 Texto Requerido Entero 10 01/07/2013 Date Requerido Date P10Y8M15D P52W P3D TEXTO OPCIONAL [08] Texto Requerido CLAVE BANCO Texto Opcional CLABE INTERBANCARIA Texto Opcional Clave Entidad Federativa AGU Texto Requerido Especificar si es sindicalizado o no [0],[1] Entero OPCIONAL 1 INT Departamento Contabilidad TEXTO OPCIONAL Impuesto Sobre El Producto De Trabajo Moneda Opcional 14,2 5 Para más información consultar el tipot_curp en el esquema nomina: 6 Para más información consultar el documento catalogoscomplementonomina.pdf apartado 1. Régimen de Contratación del trabajador 7 Se debe de cumplir el regex P seguido de los años 10Y seguidos de los meses 8M seguido de se los días 15D, en caso de no tener Meses o Días deberá ir el valor expresado en semanas P52W, si no se tiene años o meses el valor tiene que ir expresado en días P10D 8 Para más información consultar el documento catalogoscomplementonomina.pdf 2.Catálogo de Bancos Page 15 of

16 FOAHO Empleado Moneda Opcional 14,2 FOAHO Empresa Moneda Opcional 14,2 EMPLEADO A980 GOFC861015HCHMNR04 NSS 5346 LABORAL RC 01 C 03 I 01/07/2013 P10Y8M15D J CEF AGU Sindicaliza do 1 DEPTO Contabilidad ISPT FOAHO La clabe interbancaria se vuelve requerida cuando el campo Clave Banco se establece. Forma de calcular la antiguedad: Restar la Fecha de Termino del token PERIODO Menos Fecha de Ingreso del Empleado del token DETALLENOMINA Cuando tengas años, meses y dias de diferencia Fecha termino = Fecha Ingreso del Empleado = Antiguedad = P1Y8M22D Cuadno tengas dias de diferencia Fecha termino = Fecha Ingreso del Empleado = Antiguedad = P22D Cuando tengas meses y días de diferencia Fecha termino = Fecha Ingreso del Empleado = Antigüedad = P7W para expresar el valor en semanas se tiene que restar la (((fecha de termino - fecha ingreso del empleado) + 1)/7) y el resultado se trunca. Page 16 of

17 PERCEPCION TIPO DE PERCEPCIÓN Texto Requerido 1-3 Enteros CLAVE DE LA PERCEPCIÓN FF0 Texto Requerido 3-15 DESCRIPCIÓN SUELDO Texto Requerido 100 G GRAVADO DE LA PERCEPCIÓN Moneda Requerido 14,2 E EXCENTO DE LA PERCEPCIÓN 0.00 Moneda Requerido 14,2 PERCEPCION 001 FF0 SUELDO G 10.0 E 0.0 JUBILACIONPENSION TOTAL DE UNA EXHIBICIÓN En caso de aplicar no debe existir Moneda Opcional 14,2 total parcialidad ni monto diario TOTAL PARCIALIDAD En caso de aplicar no debe existir el campo total de una exhibición Moneda Opcional MONTO DIARIO Moneda Opcional 14,2 INGRESO ACUMULABLE Moneda Requerido 14,2 INGRESO NO ACUMULABLE Moneda Requerido 14,2 14,2 JUBILACIONPENSION Para más información consultar documento catalogoscomplementonomina.pdf apartado 4.Atributo:TipoPercepcion Page 17 of

18 SEPARACIONIND Total Pagado Moneda Requerido 14,2 Número de años de servicio 15 Moneda Requerido 14,2 ULTIMO SUELDO MENSUAL 4000 Moneda Requerido 14,2 INGRESO ACUMULABLE 200 Moneda Requerido 14,2 INGRESO NO ACUMULABLE 100 Moneda Requerido 14,2 SEPARACIONIND ACCIONESOTITULOS Tipo Percepción 045 Texto Requerido 1-3 Clave de la Percepción 3 Texto Requerido 3-15 Descripción ACCIONES O TITULOS Texto VALOR MERCADO 5000 Moneda Requerido 14,2 PRECIO AL OTORGARSE 2000 Moneda Requerido 14,2 G E Gravado de la Percepción 100 Moneda Requerido 14,2 Exento de la Percepción Moneda Requerido 14,2 ACCIONESOTITULOS ACCIONES O TITULOS G 100 E Page 18 of

19 DEDUCCION TIPO DE LA DEDUCCIÓN Texto Requerido 1-3 Enteros CLAVE DE LA DEDUCCIÓN FG0 Texto Requerido 3-15 DESCRIPCIÓN Otros Texto Requerido 100 I IMPORTE DE LA DEDUCCION Moneda Requerido 14,2 DEDUCCION 004 FG0 Otros I Para más información consultar documento catalogoscomplementonomina.pdf apartado 4.Atributo:TipoDeduccion Page 19 of

20 HEXTRA TIPO DE LA PERCEPCIÓN Texto Requerido 1-3 Enteros CLAVE DE LA PERCEPCION 3 Texto Requerido 3-15 DESCRIPCION HORA EXTRA Texto Requerido 100 TIPO HORAS [01],[02],[03] Texto Requerido H D G E T HORAS 4 Texto Requerido DIAS 5 Entero Requerido 1-3 Char 1-3 Entero GRAVADO DE LA PERCEPCIÓN Moneda Requerido 14,2 EXENTO DE LA PERCEPCIÓN Moneda Requerido 14,2 TOTAL DE LA PERCEPCIÓN Moneda Requerido 14,2 HEXTRA HORA EXTRA DOBLES H 4 D 5 G E T Los enumeradores de tipos de horas deben ir en mayúsculas 11 Para más información consultar documento catalogoscomplementonomina.pdf apartado 4.Atributo:TipoPercepcion Page 20 of

21 INCAPACIDAD Tipo [P] [D] P Texto Requerido 1 Char TIPO_I D I G E T Clave del Catalogo de Deducción o Percepción Texto Requerido CLAVE DE LA DEDUCCION 111 Texto Requerido DESCRIPCION Riesgo de Trabajo Texto Requerido TIPO INCAPACIDAD [01] [02] [03] 01 Entero Requerido DIAS INCAPACIDAD 5 Entero Requerido 1-3 Enteros Entero 1-3 IMPORTE DE LA DEDUCCION Moneda Opcional 14,2 Gravado de la percepción Moneda Opcional 14,2 Exento de la percepción Moneda Opcional 14,2 Total de la percepción Moneda Opcional 14,2 INCAPACIDAD P Riesgo de Trabajo TIPO_I 01 D 5 I G E T Los enumeradores de tipo de incapacidad deben ir en mayúsculas. 12 Para más información consultar documento catalogoscomplementonomina.pdf apartado 4.Atributo:TipoDeduccion Page 21 of

22 OTROPAGO TIPO OTRO PAGO[001][002]..[99] TEXTO Requerido CLAVE TEXTO Requerido CONCEPTO 100 Subsidio para el empleado TEXTO Requerido IMPORTE 100 MONEDA Requerido 14,2 SUBSIDIOALEMPLEO COMPSALDOFAVOR SUBSIDIOCAUSADO 100 MONEDA Requerido 14,2 Saldo a Favor 500 MONEDA Requerido 14,2 Año 2016 NUMERICO REQUERIDO 4 REMENENTESALFAV 600 MONEDA REQUERIDO 14,2 OTROPAGO 001 TP1 Subsidio para el trabajador 100 SUBSIDIOALEMPLEO COMPSALDOFAVOR Page 22 of

23 SUBCONTRATACION RFC LABORAL 004 Texto Requerido PORCENTAJE TIEMPO MONEDA Requerido 3,3 SUBCONTRATACION OIMM870826K2A Page of