especificaciones estructura archivo txt - zendesk...es importante que el emisor este inscrito y no...

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 abril 2017

Actualizaciones: Se agrega información del nodo RELACIONCFDI y ENTIDADSNCF a nivel emisor.

DotNet Desarrollo de Sistemas

Calle Sauce No. 2, SM 43, Cancún, Quintana Roo Tel. (998) 872 32 93 y (998) 206 10 61 [email protected]

2017

mailto:[email protected]

WSCFDI 2.0 Recibos de Nómina

of 23

Contenido Control del Documento ........................................................................................................................................................... 3

Especificaciones archivo TXT ....................................................................................................................................................... 4

Especificaciones Información nómina ......................................................................................................................................... 5

DICCIONARIO DE TOKENS ............................................................................................................................................................ 6


of 23

Control del Documento

Revisado y aprobado por:

Nombre Firmas Versión documento

Hebert Ricardo Peña serna

Business Analyst facturador.com Electrónico

1.0

Enrique Poot Poot Project Manager

1.0


of 23

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 administrativa1.

• 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 8601.

• 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 100.00

• 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 o que no corresponden al comprobante que se quiere crear.


of 23

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 está 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 o 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.

NOTA: En caso de relacionar un comprobante de nomina es necesario hacer uso del nodo |RELACIONCFDI| especificando

el UUID del comprobante a relacionar.


of 23

Ejemplo de cada token

TOKEN DESCRIPCIÓN EJEMPLO TIPO LÓGICA SIZE

NOMINA1_2

TIPO DE COMPROBANTE EGRESO Texto Requerido 6 CHAR

SERIE DEL COMPROBANTE Sin Serie Texto Requerido 10

CHAR

VERSION

VERSION DEL ESQUEMA SAT 3.2 Decimal Requerido 3 CHAR

SUBTOTAL

SUBTOTAL 100.00 Moneda Requerido 14,2

TOTAL

TOTAL DEL COMPROBANTE 140.00 Moneda Requerido 14,2

DESCUENTO

IMPORTE DEL DESCUENTO 10.00 Moneda Opcional 14,2

PDF

GENERAR PDF [1] SI

1 Bit Requerido 1

Bit

CORREOS

EL O LOS CORREOS A DONDE LLEGARA EL RECIBO DE NÓMINA UNA VEZ GENERADO, LA SEPARACION DE CORREOS ES MEDIANTE LA COMA ,

pruebasQgmail.com, [email protected] Texto Opcional

100 CHAR

INFOEXTRA

Información adicional Nota o Aviso que se desea que aparezca en el PDF

No olvides pedir tus días de vacaciones Text Opcional 100

CHAR

|NOMINA1_2|egreso|Sin Serie|VERSION|3.2|SUBTOTAL|100.00|TOTAL|150.00|DESCUENTO|10.00|PDF|1| CORREOS|[email protected],[email protected]|No olvides pedir tus días de vacaciones|

mailto:CORREOS%[email protected],[email protected]%7CNo


of 23


DETALLE

FECHA DE EMISIÓN DEL COMPROBANTE (ISO 8601) Formato aaaa-MM-ddTHH:mm:ss

2014-01-19T12:28:00 Datetime Requerido DATE

TIME

|DETALLE|2014-01-19T12:28:00|


RELACIONCFDI OPCIONAL

Folio fiscal (UUID) de un CFDI de nomina Relacionado que sustituye al cancelado. Este dato debe seguir la expresión regular del SAT

5FB2822E-396D-4725-8521-CDC4BDD20CCF String Requerido

36 CHAR

|RELACIONCFDI|5FB2822E-396D-4725-8521-CDC4BDD20CCF|


of 23

TOKEN DESCRIPCIÓN EJEMPLO TIPO LÓGICA SIZE EMISOR

RFC DEL EMISOR Este dato debe seguir la

expresión regular del SAT2

GOYA780416GM0 Texto Requerido 12-13 CHAR

REGIMEN DE PEQUEÑO CONTRIBUYENTE Conforma a catálogo del SAT

612 Texto Requerido 3 ENTERO

RFC PATRON RFC del último patrón (Solo jubilados o indemnización)

PESH8805072Q Texto Opcional CHAR 12-13

CURP Curp del emisor, solo si es persona física

PESH880507HVZXRB00 Texto Opcional CHAR 20

LugarExpedición 01000 Entero Requerido 5 ENTERO

ENTIDADSNCF Condicional

OrigenRecurso Conforme a Catálogo del SAT

IM Texto Requerido C_OrigenRecurso

MontoRecursoPropio 2669.54 ImporteMXN Requerido 14,2

|EMISOR|GOYA780416GM0|Régimen de pequeño contribuyente|||01000|ENTIDADSNCF|IM|2669.54|

NOTA: Es importante que el emisor este inscrito y no cancelado. Este nodo solo aplica para las entidades federativas, así como sus

respectivos organismos autónomos y entidades paraestatales y paramunicipales, En caso de no hacer uso del nodo no será necesario ingresarlo en la estructura de su archivo.

2 Para más información consultar el esquema del SAT: http://www.sat.gob.mx/cfd/3/cfdv32.xsd

La demás información del emisor se toma de la establecida en facturador electrónico.

RFC debe ir en mayúscula


of 23


RECEPTOR

RFC DEL RECEPTOR Este dato debe seguir la expresión

regular del SAT3

AVV880912DQ4 Texto Requerido 12-13 CHAR

NOMBRE DE LA EMPRESA/CONTRIBUYENTE

Jose Perez Hernandez Texto Requerido 150

CHAR

|RECEPTOR|AVV880912DQ4|jose perez hernandez |

3 Para más información consultar el tipo t_RFC en el esquema del SAT: http://www.sat.gob.mx/cfd/3/cfdv32.xsd

RFC debe ir en mayúscula


of 23


CONCEPTO

VALOR UNITARIO 100.00 Moneda Requerido 14,4

IMPORTE 100.00 Moneda Requerido 14,4

|CONCEPTO|100.00|100.00|


of 23


DETALLENOMINA

NOMBRE DE LA NÓMINA Mi primer nomina Texto Requerido 100

CHAR

TIPO DE LA NÓMINA [O] - Ordinaria [E] - Extraordinaria

O Texto Requerido 1

CHAR

PERIODO

FECHA DE INICIO Formato yyyy-mm-dd

2017-01-01 DATE Requerido Date

FECHA DE TERMINO Formato yyyy-mm-dd

2017-01-15 DATE Requerido Date

NOMBRE PERIODO [01],[02]…[09],99

01 ENTERO Requerido 2

ENTEREO

F_PAGO

FECHA DE PAGO Formato yyyy-mm-dd 2017-01-15 DATE Requerido Date

D

DIAS En caso de no conocer los días pagados, especificar 1

30 Entero Requerido 1 - 3

Entero

TOTAL_P

G

GRAVADO DEL TOTAL DE PERCEPCIONES 23.00 Moneda Requerido 14,2

E

EXCENTO DEL TOTAL DE PERCEPCIONES

0.00 Moneda Requerido 14,2

OP

Total de Otros Pagos 200 Moneda Opcional 14,2

TOTAL_D

I

IMPORTE TOTAL DE DEDUCCIONES 10.00 Moneda Requerido 14,2

REGPATRONAL

CLAVE O NUMERO REGISTRO PATRONAL

5689846157 Texto Requerido 100

CHAR

CLAVE

4 1 Entero Requerido

1 Entero

|DETALLENOMINA|Mi primer

nomina|O|PERIODO|01/01/2014|01/02/2014|01|F_PAGO|15/01/2014|D|30|TOTAL_P|G|23.00|E|0.0|OP|0|TOTAL_D|I|10.00|REGPATRONAL|5689846157|1|

4 Consultar documento catalogoscomplementonomina apartado 3.Riesgo Puesto


of 23


PUESTO

CLAVE DEL PUESTO 09B Texto Requerido 5

CHAR

NOMBRE DEL PUESTO Jefe de sistemas Texto Requerido 100

CHAR

SD_B

SALARIO DIARIO BASE 56.00 Moneda Requerido 14,2

SD_I

SALARIO DIARIO INTEGRAL 62.00 Moneda Requerido 14,2

|PUESTO|09B|jefe de sistemas|SD_B|56.00|SD_I|62.00|


of 23


EMPLEADO

NÚMERO DEL EMPLEADO A980 Texto Requerido 15

CHAR

CURP Esta información debe seguir la

expresión regular del SAT5

GOFC861015HCHMNR04 Texto Requerido

18 CHAR

NSS

NÚMERO DE SEGURIDAD SOCIAL 532346 Texto Requerido

1 - 15 CHAR

LABORAL

RC

RÉGIMEN DE CONTRATACIÓN6

[02], [03], [04], [05]… [11],[99] 02 Entero Requerido

1 Entero

C

TIPO DE CONTRATO [01], [02]….[10],[99]


CHAR

I

FECHA DE INGRESO DEL EMPLEADO Formato yyyy-mm-dd 01/07/2013 Date Requerido Date

Antiguedad7

P10Y8M15D P52W P3D

TEXTO OPCIONAL

J

TIPO DE JORNADA [01],[02]…..[08],[99]

[08] Texto Requerido 20

CHAR

CLAVE BANCO8 002 Texto Opcional

1 - 3 CHAR

CLABE INTERBANCARIA 124515421542154215 Texto Opcional

18 CHAR

CEF

Clave Entidad Federativa AGU Texto Requerido

Sindicalizado

Especificar si es sindicalizado o no [0],[1]

0 Entero OPCIONAL 1 INT

DEPTO

Departamento Contabilidad TEXTO OPCIONAL

100 CHAR

ISPT

5 Para más información consultar el tipo t_CURP en el esquema nomina: http://www.sat.gob.mx/sitio_internet/cfd/nomina/nomina11.xsd 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


of 23

Impuesto Sobre El Producto De Trabajo

100.00 Moneda Opcional 14,2

FOAHO

FOAHO Empleado 100.00 Moneda Opcional 14,2

FOAHO Empresa 100.00 Moneda Opcional 14,2

|EMPLEADO|A980|GOFC861015HCHMNR04|NSS|532346|LABORAL|RC|01|C|03|I|01/07/2013|P10Y8M15D|J|02|002|123456789012345678|CEF|AGU|Sindicaliza

do|1|DEPTO|Contabilidad|ISPT|100.00|FOAHO|100.00|100.00|

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 = 2017-09-23 Fecha Ingreso del Empleado = 2016-01-01 Antiguedad = P1Y8M22D

• Cuadno tengas dias de diferencia Fecha termino = 2016-09-23 Fecha Ingreso del Empleado = 2016-09-01 Antiguedad = P22D

• Cuando tengas meses y días de diferencia Fecha termino = 2016-09-23 Fecha Ingreso del Empleado = 2016-08-01 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.

La clabe interbancaria se vuelve requerida cuando el campo Clave Banco se establece.


of 23


PERCEPCION

TIPO DE PERCEPCIÓN9 001 Texto Requerido 1 - 3

Enteros

CLAVE DE LA PERCEPCIÓN FF0 Texto Requerido 3 - 15

CHAR

DESCRIPCIÓN SUELDO Texto Requerido 100

CHAR

G

GRAVADO DE LA PERCEPCIÓN 10.00 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 total parcialidad ni monto diario


TOTAL PARCIALIDAD En caso de aplicar no debe existir el campo total de una exhibición


MONTO DIARIO 100.00 Moneda Opcional 14,2

INGRESO ACUMULABLE Moneda Requerido 14,2

INGRESO NO ACUMULABLE Moneda Requerido 14,2

|JUBILACIONPENSION|1000|||200|200|

9 Para más información consultar documento catalogoscomplementonomina.pdf apartado 4.Atributo:TipoPercepcion


of 23


SEPARACIONIND

Total Pagado 5000.00 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|1000|15|4000|200|200|


ACCIONESOTITULOS

Tipo Percepción 045 Texto Requerido 1-3

CHAR

Clave de la Percepción 233 Texto Requerido 3-15

CHAR

Descripción ACCIONES O TITULOS Texto

VALOR MERCADO 5000 Moneda Requerido 14,2

PRECIO AL OTORGARSE 2000 Moneda Requerido 14,2

G

Gravado de la Percepción 100 Moneda Requerido 14,2

E

Exento de la Percepción 50.00 Moneda Requerido 14,2

|ACCIONESOTITULOS|045|233|ACCIONES O TITULOS|500|200|G|100|E|50.00|


of 23


DEDUCCION

TIPO DE LA DEDUCCIÓN10 004 Texto Requerido 1 - 3

Enteros

CLAVE DE LA DEDUCCIÓN FG0 Texto Requerido 3 - 15

CHAR

DESCRIPCIÓN Otros Texto Requerido 100

CHAR

I

IMPORTE DE LA DEDUCCION 10.00 Moneda Requerido 14,2

|DEDUCCION|004|FG0|Otros|I|10.0|

10 Para más información consultar documento catalogoscomplementonomina.pdf apartado 4.Atributo:TipoDeduccion


of 23


HEXTRA

TIPO DE LA PERCEPCIÓN11 019 Texto Requerido 1 - 3

Enteros

CLAVE DE LA PERCEPCION 233 Texto Requerido 3 - 15

CHAR

DESCRIPCION HORA EXTRA Texto Requerido 100

CHAR

TIPO HORAS [01],[02],[03]


CHAR

H

HORAS 4 Texto Requerido

1 - 3 Char

D

DIAS 5 Entero Requerido

1 - 3 Entero

G

GRAVADO DE LA PERCEPCIÓN 100.00 Moneda Requerido 14,2

E

EXENTO DE LA PERCEPCIÓN 50.00 Moneda Requerido 14,2

T

TOTAL DE LA PERCEPCIÓN 150.00 Moneda Requerido 14,2

|HEXTRA|019|233|HORA EXTRA|DOBLES|H|4|D|5|G|100.00|E|50.00|T|150.00|

11 Para más información consultar documento catalogoscomplementonomina.pdf apartado 4.Atributo:TipoPercepcion

Los enumeradores de tipos de horas deben ir en mayúsculas


of 23


INCAPACIDAD

Tipo [P] [D] P Texto Requerido 1 Char

Clave del Catalogo de Deducción o

Percepción 12 006 Texto Requerido

1 - 3 Enteros

CLAVE DE LA DEDUCCION 111 Texto Requerido 3 - 15

CHAR

DESCRIPCION Riesgo de Trabajo Texto Requerido 100

CHAR

TIPO_I

TIPO INCAPACIDAD [01] [02] [03]

01 Entero Requerido 2

Entero

D

DIAS INCAPACIDAD 5 Entero Requerido

1 - 3 CHAR

I

IMPORTE DE LA DEDUCCION 150.00 Moneda Opcional 14,2

G

Gravado de la percepción 100.00 Moneda Opcional 14,2

E

Exento de la percepción 50.00 Moneda Opcional 14,2

T

Total de la percepción 150.00 Moneda Opcional 14,2

|INCAPACIDAD|P|006|111|Riesgo de Trabajo|TIPO_I|01|D|5|I|150.00|G|100.00|E|50.00|T|150.00|

12 Para más información consultar documento catalogoscomplementonomina.pdf apartado 4.Atributo:TipoDeduccion

Los enumeradores de tipo de incapacidad deben ir en mayúsculas.


of 23


OTROPAGO

TIPO OTRO PAGO[001][002]..[99]

001 TEXTO Requerido 1-3

CHAR

CLAVE

002 TEXTO Requerido 3-15

CHAR

CONCEPTO

Subsidio para el empleado TEXTO Requerido 100

CHAR

IMPORTE

100 MONEDA Requerido 14,2

SUBSIDIOALEMPLEO

SUBSIDIOCAUSADO 100 MONEDA Requerido 14,2

COMPSALDOFAVOR

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||||


of 23


SUBCONTRATACION

RFC LABORAL 004 Texto Requerido 12-13

CHAR

PORCENTAJE TIEMPO 100.000 MONEDA Requerido 3,3

|SUBCONTRATACION|OIMM870826K2A|100.00|

especificaciones estructura archivo txt - zendesk...es importante que el emisor este inscrito y no...

Documents