Caracterí sticas Te cnicas del archivo prototipo para ... · PDF filecuentas contables...
Transcript of Caracterí sticas Te cnicas del archivo prototipo para ... · PDF filecuentas contables...
Retorno 1 208 Col. Empleados SFEO, Monterrey Nuevo Leon; Tel. (81) 83477722 [email protected] www.nasa.com.mx
Caracterí sticas Te cnicas del archivo prototipo para comunicacio n con la interface Facturak-[ERP].
Contenido Control de Versiones ........................................................................................................................... 2
Objetivo ............................................................................................................................................... 3
Archivo de Interface Facturak-[ERP] ............................................................................................... 3
Reglas Generales: ............................................................................................................................ 4
TEMPLATE DE ARCHIVO ENCABEZADO (HEADER.DIG) ....................................................................... 5
TEMPLATE DE ARCHIVO DETALLE (DETAILS.CPO) ............................................................................... 9
Script SQL ............................................................................................. ¡Error! Marcador no definido.
Ejemplo sentencia SQL ......................................................................... ¡Error! Marcador no definido.
Ejemplo Archivo (.txt) ........................................................................................................................ 13
Retorno 1 208 Col. Empleados SFEO, Monterrey Nuevo Leon; Tel. (81) 83477722 [email protected] www.nasa.com.mx
Control de Versiones Fecha Versión Descripción Realizó Revisó
2017-08-07 1.0.0 Creación del documento. Ing. Adelfo Gallardo
Retorno 1 208 Col. Empleados SFEO, Monterrey Nuevo Leon; Tel. (81) 83477722 [email protected] www.nasa.com.mx
Objetivo
Archivo de Interface Facturak-[ERP] Al optar por el protocolo de comunicación mediante esquema de archivos entre el [ERP] de la
Empresa y el sistema de Facturación Electrónica Facturak, el cliente deberá generar mediante su [ERP] el
conjunto de archivos con la información a procesar, siguiendo para ello las reglas y la secuencia aquí
especificada.
Retorno 1 208 Col. Empleados SFEO, Monterrey Nuevo Leon; Tel. (81) 83477722 [email protected] www.nasa.com.mx
Reglas Generales: 1. Los archivos deberán ser creados con el formato de texto simple, con extensión PAG.
2. Ninguno de los atributos que conforman los archivos deberán contener el carácter | (‘pipe’) debido
a que este será utilizado como carácter de control para la lectura de información de los archivos.
3. El inicio de cada registro dentro de los archivos se marcara mediante el carácter | (´pipe´) sencillo.
4. Cada campo individual se encontrara separado de su dato subsiguiente, mediante un carácter |
(‘pipe’) sencillo.
5. Se expresara únicamente el valor del campo sin expresar el nombre del atributo. Es decir que desea
expresar que la moneda es MXN, aparecerá en el archivo como “|MXN|”, nunca pondrá el nombre
del campo. “|Moneda=MXN|” esto es incorrecto.
6. En el caso de datos con valor NULL serán expresado en los archivos mediante una cadena vacía,
quedando expresado de la forma | {Cadena Vacía} | = ||. En el so de que el campo sea de tipo
numérico, debe expresar al menos el valor “0”.
7. El final de cada registro dentro de los archivos se marcara mediante un carácter | (´pipe´) sencillo.
8. El archivo se divide por dos secciones (Encabezado “H” y Detalle “D”) , Contando con un
encabezado y N número de detalles, características que se definirán más a delante.
9. El nombre de los archivos se compone de:
a. Numero de control/folio/factura generado por el [ERP]. (6 posiciones)
b. Guion bajo (‘_’).
c. Fecha de generación de archivos a procesar. (yyyyMMddHHmmss) donde:
yyyy: Es el año MM: es el mes dd: es el día
HH: es la hora base 24 mm: es el minuto ss: son los segundos de generación.
Ejemplo de los nombres de archivo a ser enviados a Facturak.
Folio [ERP] + ‘_’ + Fecha
001234_20091105143017.pag (Archivo con información)
Retorno 1 208 Col. Empleados SFEO, Monterrey Nuevo Leon; Tel. (81) 83477722 [email protected] www.nasa.com.mx
TEMPLATE DE ARCHIVO SECCIÓN ENCABEZADO (ARCHIVO.PAG) No. Campo Descripción Tamaño ¿Obligatorio?
1 Header Se debe registrar el carácter “H” indicando que esta sección pertenece al encabezado.
Valor Alfanumérico 1-5 Caracteres
SI
2 Versión Versión del complemento de pago Debe tener el valor 1.0.
Valor Alfanumérico 1-10 Caracteres
SI
3 NoDeControl Numero de Factura o Folio emitido por el [ERP].
Valor Alfanumérico 1-50 Caracteres
SI
4 CuentaPago
Cuenta de banco en la cual se recibe el pago, registrado en el catálogo de cuentas contables de CXC.
Valor Alfanumérico 1-50 Caracteres
NO
5 RFC Rfc del cliente Valor Alfanumérico 1-10 Caracteres
SI
6 RazonSocial Nombre del cliente Valor Alfanumérico 1-10 Caracteres
SI
7 ReceptorEmail Email del cliente Valor Alfanumérico 1-50 Caracteres
NO
8 FechaPago Se debe registrar la fecha y hora en la que el beneficiario recibe el pago. Se expresa en la forma aaaa-mm-ddThh:mm:ss, de acuerdo con la especificación ISO 8601. En caso de no contar con la hora se debe registrar 12:00:00.
Valor permitido yyyyMMdd HH:mm:ss
SI
9 *FormaDePagoP Forma de pago de la factura como Efectivo, cheque, etc. Favor de consultar documento anexo con los catálogos. (01 - Efectivo), Catálogo publicado en el portal del SAT.
Valor alfanumérico 1-50 Caracteres
SI
10 *MonedaP Tipo de moneda a facturar. MXN, USD. (MXN – Peso Mexicano, USD – Dólar Americano), Catálogo publicado en el portal del SAT.
Valor alfanumérico 1-30 Caracteres
SI
11 TipoCambioP Paridad o tipo de cambio a utilizar en la factura. Si no se especifica valor se considera valor 1.
Valores permitidos 0.00-9999999.99
NO
12 IdSucursal Número de identificación de la sucursal que expide la factura.
Valores permitidos 0.00-9999999.99
SI
13 NumOperacion Se puede registrar el número de cheque, número de autorización, número de referencia, clave de rastreo en caso de ser SPEI, línea de captura o algún número de referencia o
Valor Alfanumérico 1-100 Caracteres
NO
Retorno 1 208 Col. Empleados SFEO, Monterrey Nuevo Leon; Tel. (81) 83477722 [email protected] www.nasa.com.mx
identificación análogo que permita identificar la operación correspondiente al pago efectuado.
14 RfcEmisorCtaOrd Se puede registrar la clave del RFC de la entidad emisora de la cuenta origen, es decir, la operadora, el banco, la institución financiera, emisor de monedero electrónico, etc., en caso de ser residente en el extranjero se debe registrar la clave en el RFC genérica XEXX010101000, en caso de que éste no se utilice, la clave en el RFC que se registre debe estar en la lista de claves en el RFC inscritas en el SAT.
Valor Alfanumérico 1-50 Caracteres
NO
15 NomBancoOrdExt Se puede registrar el nombre del banco ordenante, es requerido en caso de ser extranjero, considerar las reglas de obligatoriedad de acuerdo con la columna Nombre del Banco emisor de la cuenta ordenante en caso de extranjero del catálogo c_FormaPago publicado en el Portal del SAT.
Valor Alfanumérico 1-50 Caracteres
NO
16 CtaOrdenante Se puede registrar el número de la cuenta con la que se realizó el pago, considerar las reglas de obligatoriedad de acuerdo con la columna Cuenta Ordenante del catálogo c_FormaPago publicado en el Portal del SAT.
Valor Alfanumérico 10-50 Caracteres
NO
17 RfcEmisorCtaBen Se puede registrar la clave en el RFC de la entidad operadora de la cuenta destino, es decir, la operadora, el banco, la institución financiera, emisor de monedero electrónico, etc. Considerar las reglas de obligatoriedad de acuerdo con la columna RFC del Emisor Cuenta del beneficiario del catálogo c_FormaPago publicado en el Portal del SAT.
Valor Alfanumérico 1-50 Caracteres
NO
18 CtaBeneficiario Se puede registrar el número de cuenta en donde se recibió el pago. Considerar las reglas de obligatoriedad de acuerdo con la columna Cuenta de
Valor Alfanumérico 10-50 Caracteres
NO
Retorno 1 208 Col. Empleados SFEO, Monterrey Nuevo Leon; Tel. (81) 83477722 [email protected] www.nasa.com.mx
Benenficiario del catálogo c_FormaPago publicado en el Portal del SAT.
19 TipoCadPago Se puede registrar la clave del tipo de cadena de pago que genera la entidad receptora del pago. Considerar las reglas de obligatoriedad de acuerdo con la columna Tipo Cadena Pago del catálogo c_FormaPago publicado en el Portal del SAT. Las diferentes claves de tipo cadena se encuentran incluidas en el catálogo c_TipoCadenaPago. Si existe este campo es obligatorio registrar los campos CertificadoPago, CadenaPago y SelloPago, en otro caso estos campos no deben existir.
Valor Alfanumérico 1-50 Caracteres
NO
20 CertPago Es el certificado que corresponde al pago, como una cadena de texto en formato base 64 y es requerido en caso de que el campo “TipoCadPago” contenga información.
Valor Alfanumérico 1-50 Caracteres
NO
21 CadPago Es la cadena original del comprobante de pago generado por la entidad emisora de la cuenta beneficiaria. Es requerido en caso de que el campo TipoCadPago contenga información.
Valor Alfanumérico 1-50 Caracteres
NO
22 SelloPago Es el sello digital que se asocie al pago. La entidad que emite el comprobante de pago, ingresa una cadena original y el sello digital en una sección de dicho comprobante, este sello digital es el que se debe registrar en este campo. Debe ser expresado como una cadena de texto en formato base 64. Es requerido en caso de que el campo TipoCadPago contenga información.
Valor Alfanumérico 1-50 Caracteres
NO
23 Monto Se debe registrar el importe del pago, este debe ser mayor a cero “0”. La suma de los valores registrados en el nodo DoctoRelacionado, campo ImpPagado, debe ser menor o igual que el valor de este campo.
Valores permitidos 0.00-9999999.99
NO
24 Estatus Se puede registrar el carácter “C” indicando que es un pago a cancelar, Caso contrario indica que es un pago
Valor Alfanumérico 0-5 Caracteres
NO
Retorno 1 208 Col. Empleados SFEO, Monterrey Nuevo Leon; Tel. (81) 83477722 [email protected] www.nasa.com.mx
a timbrar, por default este campo viene vacío.
25 Observaciones Campo de observaciones adicionales de la Factura.
Valor alfanumérico 0-500 Caracteres
NO
26 Observaciones2 Campo de observaciones adicionales de la Factura.
Valor alfanumérico 0-500 Caracteres
NO
27 Observaciones3 Campo de observaciones adicionales de la Factura.
Valor alfanumérico 0-500 Caracteres
NO
28 Observaciones4 Campo de observaciones adicionales de la Factura.
Valor alfanumérico 0-500 Caracteres
NO
29 Observaciones5 Campo de observaciones adicionales de la Factura.
Valor alfanumérico 0-500 Caracteres
NO
30 Observaciones6 Campo de observaciones adicionales de la Factura.
Valor alfanumérico 0-500 Caracteres
NO
31 Observaciones7 Campo de observaciones adicionales de la Factura.
Valor alfanumérico 0-500 Caracteres
NO
32 Observaciones8 Campo de observaciones adicionales de la Factura.
Valor alfanumérico 0-500 Caracteres
NO
33 Observaciones9 Campo de observaciones adicionales de la Factura.
Valor alfanumérico 0-500 Caracteres
NO
34 Observaciones10 Campo de observaciones adicionales de la Factura.
Valor alfanumérico 0-500 Caracteres
NO
35 Extranumerico Valor numérico extra, para incluir en la información del comprobante.
Valor alfanumérico 0-500 Caracteres
NO
36 Extranumerico2 Valor numérico extra, para incluir en la información del comprobante.
Valor alfanumérico 0-500 Caracteres
NO
37 Extranumerico3 Valor numérico extra, para incluir en la información del comprobante.
Valor alfanumérico 0-500 Caracteres
NO
38 Extranumerico4 Valor numérico extra, para incluir en la información del comprobante.
Valor alfanumérico 0-500 Caracteres
NO
39 Extranumerico5 Valor numérico extra, para incluir en la información del comprobante.
Valor alfanumérico 0-500 Caracteres
NO
40 Extranumerico6 Valor numérico extra, para incluir en la información del comprobante.
Valor alfanumérico 0-500 Caracteres
NO
41 Extranumerico7 Valor numérico extra, para incluir en la información del comprobante.
Valor alfanumérico 0-500 Caracteres
NO
42 Extranumerico8 Valor numérico extra, para incluir en la información del comprobante.
Valor alfanumérico 0-500 Caracteres
NO
43 Extranumerico9 Valor numérico extra, para incluir en la información del comprobante.
Valor alfanumérico 0-500 Caracteres
NO
44 Extranumerico10 Valor numérico extra, para incluir en la información del comprobante.
Valor alfanumérico 0-500 Caracteres
NO
Retorno 1 208 Col. Empleados SFEO, Monterrey Nuevo Leon; Tel. (81) 83477722 [email protected] www.nasa.com.mx
TEMPLATE DE ARCHIVO SECCIÓN DETALLE (ARCHIVO.PAG) No. Campo Descripción Tamaño ¿Obligatorio?
45 Detail Se debe registrar el carácter “D” indicando que esta sección pertenece al detalle.
Valor Alfanumérico 1-5 Caracteres
SI
46 idDocumento Se debe registrar el folio fiscal (UUID) de un CFDI relacionado con el presente comprobante. (Factura a Pagar)
Valor Alfanumérico 1-50 Caracteres
SI
47 NoDeControl Id del pago que genera el cliente, llenar este campo en caso de no especificar el idDocumento (UUID).
Valor Alfanumérico 1-50 Caracteres
NO
48 Serie Serie de la factura a la cual se va a plicar un pago.
Valor Alfanumérico 1-50 Caracteres
SI
49 Folio Folio de la factura a la cual se generará el pago.
Valor Alfanumérico 1-50 Caracteres
SI
50 *MonedaDR Tipo de moneda a facturar. MXN, USD. (MXN – Peso Mexicano, USD – Dólar Americano), Catálogo publicado en el portal del SAT.
Valor Alfanumérico 1-30 Caracteres
SI
51 *MetodoDePagoDR Se puede registrar la clave que corresponda dependiendo de si se paga en una sola exhibición o en parcialidades, las distintas claves de método de pago se encuentran incluidas en el catálogo c_MetodoPago. Ejemplo: PUE (Pago en una sola exhibición), PPD (Pago en parcialidades o diferido)
Valor Alfanumérico 1-50 Caracteres
SI
53 TipoCambioDR Paridad o tipo de cambio a utilizar en la factura. Si no se especifica valor se considera valor 1.
Valores permitidos 0.00-9999999.99
NO
54 NumParcialidad Es el número de parcialidad que corresponde al pago. Es requerido cuando MetodoDePagoDR contiene “PPD” (Pago en parcialidades o diferido).
En el caso de que el pago sea diferido, en este campo se debe registrar el valor “1”.
Valores permitidos 0.00-9999999.99
SI
55 ImpSaldoAnt Es el monto del saldo insoluto de la parcialidad anterior. Es requerido cuando MetodoDePagoDR contiene “PPD” (Pago en
Valores permitidos 0.00-9999999.99
SI
Retorno 1 208 Col. Empleados SFEO, Monterrey Nuevo Leon; Tel. (81) 83477722 [email protected] www.nasa.com.mx
parcialidades o diferido). En el caso de que sea la primera parcialidad este campo debe contener el importe total del documento relacionado. En el caso de que se reciba el pago diferido, se debe registrar el monto total de la operación del documento relacionado. Este dato debe ser mayor a 0.
56 ImpPagado Es el importe pagado que corresponde al documento relacionado. Este dato es obligatorio cuando exista más de un documento relacionado o cuando existe un documento relacionado y el campo TipoCambioDR tiene un valor. * Si existe solo un documento relacionado es opcional. * Si se registra un valor en este campo, el importe pagado debe ser mayor a 0. * El importe pagado debe corresponder al tipo de moneda registrado en el campo MonedaDR del documento relacionado.
Valores permitidos 0.00-9999999.99
SI
57 ImpSaldoInsoluto Es la diferencia entre el importe del saldo anterior y el monto del pago. Es requerido cuando MetodoDePagoDR contiene “PPD” (Pago en parcialidades o diferido). * Debe ser mayor o igual a 0 y
debe calcularse de los campos: ImpSaldoAnt menos el ImpPagado. * Si el campo ImpPagado no existe en el caso de que solo se registre un documento relacionado, debe calcularse de los campos: ImpSaldoAnt menos el Monto, considerando la conversión a *MonedaDR. * Considerar que este importe
Valores permitidos 0.00-9999999.99
SI
Retorno 1 208 Col. Empleados SFEO, Monterrey Nuevo Leon; Tel. (81) 83477722 [email protected] www.nasa.com.mx
debe corresponder al tipo de moneda registrado en el campo *MonedaDR del documento relacionado.
58 Observaciones Campo de observaciones adicionales de la Factura.
Valor alfanumérico 0-500 Caracteres
NO
59 Observaciones2 Campo de observaciones adicionales de la Factura.
Valor alfanumérico 0-500 Caracteres
NO
60 Observaciones3 Campo de observaciones adicionales de la Factura.
Valor alfanumérico 0-500 Caracteres
NO
61 Observaciones4 Campo de observaciones adicionales de la Factura.
Valor alfanumérico 0-500 Caracteres
NO
62 Observaciones5 Campo de observaciones adicionales de la Factura.
Valor alfanumérico 0-500 Caracteres
NO
63 Observaciones6 Campo de observaciones adicionales de la Factura.
Valor alfanumérico 0-500 Caracteres
NO
64 Observaciones7 Campo de observaciones adicionales de la Factura.
Valor alfanumérico 0-500 Caracteres
NO
65 Observaciones8 Campo de observaciones adicionales de la Factura.
Valor alfanumérico 0-500 Caracteres
NO
67 Observaciones9 Campo de observaciones adicionales de la Factura.
Valor alfanumérico 0-500 Caracteres
NO
68 Observaciones10 Campo de observaciones adicionales de la Factura.
Valor alfanumérico 0-500 Caracteres
NO
69 Extranumerico Valor numérico extra, para incluir en la información del comprobante.
Valor alfanumérico 0-500 Caracteres
NO
70 Extranumerico2 Valor numérico extra, para incluir en la información del comprobante.
Valor alfanumérico 0-500 Caracteres
NO
71 Extranumerico3 Valor numérico extra, para incluir en la información del comprobante.
Valor alfanumérico 0-500 Caracteres
NO
72 Extranumerico4 Valor numérico extra, para incluir en la información del comprobante.
Valor alfanumérico 0-500 Caracteres
NO
73 Extranumerico5 Valor numérico extra, para incluir en la información del comprobante.
Valor alfanumérico 0-500 Caracteres
NO
Retorno 1 208 Col. Empleados SFEO, Monterrey Nuevo Leon; Tel. (81) 83477722 [email protected] www.nasa.com.mx
74 Extranumerico6 Valor numérico extra, para incluir en la información del comprobante.
Valor alfanumérico 0-500 Caracteres
NO
75 Extranumerico7 Valor numérico extra, para incluir en la información del comprobante.
Valor alfanumérico 0-500 Caracteres
NO
76 Extranumerico8 Valor numérico extra, para incluir en la información del comprobante.
Valor alfanumérico 0-500 Caracteres
NO
77 Extranumerico9 Valor numérico extra, para incluir en la información del comprobante.
Valor alfanumérico 0-500 Caracteres
NO
78 Extranumerico10 Valor numérico extra, para incluir en la información del comprobante.
Valor alfanumérico 0-500 Caracteres
NO
Retorno 1 208 Col. Empleados SFEO, Monterrey Nuevo Leon; Tel. (81) 83477722 [email protected] www.nasa.com.mx
Ejemplo Archivo (.PAG) Encabezado (H) y Detalle (D)
H|1.0|1|1141000001|XAXX010101000|Público en General|[email protected]|2017-08-17 05:29:50|01|MXN|1|1|||||||||||580||||||||||||0|0|0|0|0|0|0|0|0|0| D|805B6DE9-7B77-194F-9694-E12C48BCF38A||AAA|32|MXN|PPD|1|1|580|580|0|||||||||||
0|0|0|0|0|0|0|0|0|0|
[Campo]-HEADER
Header - H|
Versión - |1.0|
NoDeControl - |1|
CuentaPago - |1141000001|
RFC - |XAXX010101000|
RazonSocial - |Público en General|
ReceptorEmail - |[email protected]|
FechaPago - |2017-08-17 05:29:50|
*FormaDePagoP - |01|
*MonedaP - |MXN|
TipoCambioP - |1|
IdSucursal - |1|
NumOperacion - ||
RfcEmisorCtaOrd - ||
NomBancoOrdExt - ||
CtaOrdenante - ||
Retorno 1 208 Col. Empleados SFEO, Monterrey Nuevo Leon; Tel. (81) 83477722 [email protected] www.nasa.com.mx
RfcEmisorCtaBen - ||
CtaBeneficiario - ||
TipoCadPago - ||
CertPago - ||
CadPago - ||
SelloPago - ||
Monto - |580|
Estatus - ||
Observaciones - ||
Observaciones2 - ||
Observaciones3 - ||
Observaciones4 - ||
Observaciones5 - ||
Observaciones6 - ||
Observaciones7 - ||
Observaciones8 - ||
Observaciones9 - ||
Observaciones10 - ||
Extranumerico - |0|
Extranumerico2 - |0|
Extranumerico3 - |0|
Extranumerico4 - |0|
Extranumerico5 - |0|
Retorno 1 208 Col. Empleados SFEO, Monterrey Nuevo Leon; Tel. (81) 83477722 [email protected] www.nasa.com.mx
Extranumerico6 - |0|
Extranumerico7 - |0|
Extranumerico8 - |0|
Extranumerico9 - |0|
Extranumerico10 - |0|
[Campo]-DETAIL
Detail - D|
idDocumento - |805B6DE9-7B77-194F-9694-E12C48BCF38A|
NoDeControl - ||
Serie - |AAA|
Folio - |32|
*MonedaDR - |MXN|
*MetodoDePagoDR - |PPD|
TipoCambioDR - |1|
NumParcialidad - |1|
ImpSaldoAnt - |580|
ImpPagado - |580|
ImpSaldoInsoluto - |0|
Observaciones - ||
Observaciones2 - ||
Observaciones3 - ||
Retorno 1 208 Col. Empleados SFEO, Monterrey Nuevo Leon; Tel. (81) 83477722 [email protected] www.nasa.com.mx
Observaciones4 - ||
Observaciones5 - ||
Observaciones6 - ||
Observaciones7 - ||
Observaciones8 - ||
Observaciones9 - ||
Observaciones10 - ||
Extranumerico - |0|
Extranumerico2 - |0|
Extranumerico3 - |0|
Extranumerico4 - |0|
Extranumerico5 - |0|
Extranumerico6 - |0|
Extranumerico7 - |0|
Extranumerico8 - |0|
Extranumerico9 - |0|
Extranumerico10 - |0|