Características Técnicas del archivo prototipo para comunicación con la interface Facturak-[ERP].

Transcripción

1 Características Técnicas del archivo prototipo para comunicación con la interface Facturak-[ERP]. Contenido Control de Versiones... 2 Objetivo... 3 Archivo de Interface Facturak-[ERP]... 3 Reglas Generales:... 3 TEMPLATE DE ARCHIVO ENCABEZADO (HEADER.DIG)... 4 TEMPLATE DE ARCHIVO DETALLE (DETAILS.CPO)... 11

2 Control de Versiones Fecha Versión Descripción Realizó Revisó Creación del documento. Ing. Sergio Luna Ing. Adelfo Gallardo Se agrega campo EsEditable Ing. Adelfo Gallardo Se agregan campos observaciones y Ing. Adelfo Gallardo extranumérico en detalles. Se agregan campos para IEPS Se agregó campo Ing. Sergio R. Luna -ExcluirDelCFD -ExcluirDeImpresion Sirve para identificar elementos (detalle) que no se desean incluir en XML de salida Se agregó campo -ISHPorciento -ISHImporte Sirven para indicar el valor del Impuesto Sobre Hospedaje en la Interfase Files para configuración de Hoteles [Encabezado] Ing. Sergio R. Luna Se agregó campo -NumCtaPago -SerieFiscalOriginal -FolioFiscalOriginal -MontoFiscalOriginal -FechaFiscalOriginal Correspondiente a los cambios del SAT del Se agregó campo - Observaciones 6,7,8,9,10 - Extranumerico 6,7,8,9, Se agregó campo -PDFFile Se agregan campos nuevos para la versión CFDI 3.3 Ing. Manuel Alejandro Garza Enríquez Ing. Manuel Alejandro Garza Enríquez Ing. Sergio R. Luna Ing. Adelfo Gallardo

3 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. Reglas Generales: 1. Los archivos deberán ser creados con el formato de texto simple, con extensión DIG para el archivo de Encabezado y extensión CPO para el archivo de Detalle. 2. Ninguno de los atributos que conforman los archivo deberá contener el carácter ( pipe ) debido a que este será utilizado como carácter de control para la lectura de información de los archivo. 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 campo de que el campo sea de tipo numérico, debe expresar al menos el valor El final de cada registro dentro de los archivos se marcara mediante un carácter ( pipe ) sencillo. 8. 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 _ dig (Archivo con información de Encabezado) _ cpo (Archivo con información de Detalle)

4 TEMPLATE DE ARCHIVO ENCABEZADO (HEADER.DIG) No. Campo Descripción Tamaño Obligatorio? 1 Version Version del layout. Debe escribir Fijo Valor 3.3 Alfanumérico 1-10 Caracteres 2 RFC RFC del Emisor de la factura. Valor Alfanumérico 1-10 caracteres 3 Tipo Documento Indica el tipo de documento a generar F - Factura CR Nota Crédito CA Nota Cargo RH Rec. Honorarios CP Carta Porte 4 No. Factura/Folio No. de Folio por asignar al CFD. Nota: Solo se especifica cuando el consecutivo será generado por el [ERP] origen. Por default especificar 0 para que Facturak asigne el consecutivo. 5 Serie Serie de facturas a utilizar para la generación de CFD. Ejemplo AAA 6 Clave Sucursal Clave de la Sucursal que emite la factura. Si quiere que el CFDI se genere con una sucursal en particular especificar el Id de la sucursal en facturak. 7 Fecha Fecha de generación de documento del ERP. No es la fecha de facturación. 8 *Forma de Pago Forma de pago de la factura como Efectivo, cheque, etc. Favor de consultar documento anexo con los catálogos. 9 Condiciones de Pago Se pueden registrar las condiciones comerciales aplicables para el pago del comprobante fiscal, cuando existan éstas y cuando el 6 Caracteres 1-10 Caracteres 0-10 Valor permitido yyyymmdd HH:mm:ss 1-50 Caracteres 1-50 Caracteres

5 tipo de comprobante sea I (Ingreso) o E (Egreso). Ejemplo: 3 meses 10 *Método de Pago 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) 1-50 Caracteres 11 Motivo de Descuento Motivo de Descuento de la factura 0-50 Caracteres 12 *Moneda Tipo de moneda a facturar. MXN, USD 1-30 Caracteres 13 Tipo de Cambio Paridad o tipo de cambio a utilizar en la factura. Si no se especifica valor se considera valor No. de Control Numero de Factura o Folio emitido por el [ERP] Caracteres 15 No. de Orden Numero de Orden Interno al ERP Caracteres 16 No. de Remisión Numero de Remisión generado en el [ERP]. 17 TipoRelacion Es el tipo de relación cuando el comprobante debe ir relacionado a un comprobante fiscal previamente generado. 01 Notas de crédito, 02 Notas de Debito, 03 Devolucion de mercancía, 04 Sustitución de CFDIs, 05 Traslado de mercancía, 06 Factura generada por traslados Valor 18 CFDIsRelacionados Debe especificar el o los UUIDs relacionados a este documento separados por coma, 0-50 Caracteres Valor alfanumérico 0-50 Caracteres Valor alfanumérico caracteres 19 Clave [Receptor] Clave o identificador del Cliente 1-10 Caracteres 20 RFC [Receptor] RFC del Cliente

6 21 Nombre Comercial [Receptor] Nombre comercial del Cliente Caracteres Caracteres 22 Razón Social [Receptor] Razón Social del Cliente Caracteres 23 Calle [Receptor] Calle [Dir. Fiscal] del Cliente 1-80 Caracteres 24 No. Exterior [Receptor] No. Exterior [Dir. Fiscal] del Cliente 1-30 Caracteres 25 No. Interior [Receptor] No. Interior [Dir. Fiscal] del Cliente 0-30 Caracteres 26 Referencia [Receptor] Referencia [Dir. Fiscal] del Cliente 0-60 Caracteres 27 Colonia [Receptor] Colonia [Dir. Fiscal] del Cliente 1-80 Caracteres 28 Localidad [Receptor] Localidad [Dir. Fiscal] del Cliente 0-60 Caracteres 29 Municipio [Receptor] Municipio [Dir. Fiscal] del Cliente 1-60 Caracteres 30 Estado [Receptor] Estado [Dir. Fiscal] del Cliente 1-60 Caracteres 31 País [Receptor] País [Dir. Fiscal] del Cliente 1-60 Caracteres 32 Código Postal [Receptor] C.P. [Dir. Fiscal] del Cliente 1-10 Caracteres 33 [Receptor] Correo electrónico al cual se enviara la factura. Si se especifican varias direcciones deberán separarse mediante ; (punto y coma) 34 Entregar a Nombre [Receptor] 35 Entregar a RazonSocial [Receptor] 36 Entregar a Dirección [Receptor] 37 Entregar a Estado [Receptor] Nombre a quien se entrega productos o servicios Razón Social a la que se entrega producto o servicio Dirección de entrega de producto o servicio Entidad de entrega de producto o servicio

7 38 ReceptorResidenciaFisc al 39 ReceptorNumRegIdTri b Atributo condicional para registrar la clave del país de residencia para efectos fiscales del receptor del comprobante, cuando se trate de un extranjero, y que es conforme con la especificación ISO alpha-3. Es requerido cuando se incluya el complemento de comercio exterior o se registre el atributo NumRegIdTrib. Atributo condicional para expresar el número de registro de identidad fiscal del receptor cuando sea residente en el extranjero. Es requerido cuando se incluya el complemento de comercio exterior 40 Subtotal Subtotal de la factura. Debe estar dado por la sumatoria de los importes del Detalle. Valor alfanumérico 0-50 caracteres Valor Alfanumérico 0-50 Caracteres 41 Descuento [%] Porcentaje de Descuento a aplicar Descuento [Importe] Importe de Descuento a aplicar. 43 IVA [Retenido] Importe de IVA Retenido 44 ISR [Retenido] Importe de ISR Retenido 45 IVA [%] Porcentaje de IVA a aplicar IVA [Importe] Importe de IVA calculado. 47 Total Factura Total de la factura. Debe estar dado por Total = Subtotal Descuento + ImpuestosTraslados - ImpuestosRetenidos. 48 Estatus Campo que indica el estatus del Documento [C = Cancelado] C

8 49 Observaciones 1 Campo de observaciones adicionales de la Factura. 50 Observaciones 2 Campo de observaciones adicionales de la Factura. 51 Observaciones 3 Campo de observaciones adicionales de la Factura. 52 Observaciones 4 Campo de observaciones adicionales de la Factura. 53 Observaciones5 Campo de observaciones adicionales de la Factura. 54 ExtraNumerico1 Valor numérico extra, para incluir en la información del comprobante. 55 ExtraNumerico2 Valor numérico extra, para incluir en la información del comprobante. 56 ExtraNumerico3 Valor numérico extra, para incluir en la información del comprobante. 57 ExtraNumerico4 Valor numérico extra, para incluir en la información del comprobante. 58 ExtraNumerico5 Valor numérico extra, para incluir en la información del comprobante. 59 EsEditable Indica si la prefactura podrá ser editada antes de generar el CFD 60 IepsPorcentaje Indica el porcentaje de Impuesto IEPS para la factura 61 IepsImporte Indica el importe de impuesto IEPS aplicable para esta factura 62 IshPorciento Indica el porcentaje de Impuesto Sobre Hospedaje para la factura. 63 IshImporte Indica el importe de Impuesto Sobre Hospedaje para la factura. 64 NumCtaPago Indica los cuatro últimos dígitos del número de cuenta con la que se realizó el pago. 65 SerieFolioFiscalOriginal Nombre de la serie del folio del comprobante que se hubiese expedido por el valor total del comprobante, tratándose del pago en parcialidades 0 = No editable 1 = Editable 0-4 Caracteres 0-10 Caracteres

9 66 FolioFiscalOriginal Número del folio fiscal del comprobante que se hubiese expedido por el valor total del comprobante, tratándose del pago en parcialidades. 67 MontoFolioFiscalOriginal Total importe del comprobante que se hubiese expedido por el valor total de la operación, tratándose del pago en parcialidades. 68 FechaFolioFiscalOriginal Fecha de expedición del comprobante que se hubiese emitido por el valor total del comprobante, tratándose del pago en parcialidades. Se expresa en la forma aaaa-mm-ddthh:mm:ss, de acuerdo con la especificación ISO Observaciones6 Campo de observaciones adicionales de la Factura. 70 Observaciones7 Campo de observaciones adicionales de la Factura. 71 Observaciones8 Campo de observaciones adicionales de la Factura. 72 Observaciones9 Campo de observaciones adicionales de la Factura. 73 Observaciones10 Campo de observaciones adicionales de la Factura. 74 Extranumerico6 Valor numérico extra, para incluir en la información del comprobante. 75 Extranumerico7 Valor numérico extra, para incluir en la información del comprobante. 76 Extranumerico8 Valor numérico extra, para incluir en la información del comprobante. 77 Extranumerico9 Valor numérico extra, para incluir en la información del comprobante. 78 Extranumerico10 Valor numérico extra, para incluir en la información del comprobante. 79 PdfFile Nombre de archivo (ruta y archivo) para adjuntar a correo electrónico. Valores Permitidos Valores Permitidos Valor permitido yyyymmdd HH:mm:ss

10

11 TEMPLATE DE ARCHIVO DETALLE (DETAILS.CPO) No. Campo Descripción Tamaño Obligatorio? 1 No. Partida Consecutivo de registro ClaveProdServ Atributo requerido para expresar Valor la clave del producto o del servicio amparado por el presente concepto. Es requerido y deben utilizar las claves del catálogo de productos y servicios, cuando los conceptos que registren por sus actividades correspondan con dichos conceptos. Alfanumérico 0-50 Caracteres 3 Cantidad Cantidad de bienes o servicios ClaveUnidad Atributo requerido para precisar la clave de unidad de medida estandarizada aplicable para la cantidad expresada en el concepto. La unidad debe corresponder con la descripción del concepto 5 Unidad Unidad de medida aplicable para la cantidad expresada en el concepto. 6 No. Identificación Número de identificación del servicio o producto. 7 Código Código interno del servicio o producto. Valor Alfanumérico 0 50 Caracteres 0-50 Caracteres 0-50 Caracteres 0-50 Caracteres 8 Descripción Descripción del bien o servicio Caracteres 9 Valor Unitario Valor o precio unitario del bien o servicio. Sin impuesto 10 Descuento [%] Porcentaje de Descuento aplicado al bien o servicio

12 11 Descuento [Importe] Descuento calculado aplicado al bien o servicio 12 IVA [%] Porcentaje de IVA aplicable al bien o servicio IVA [Importe] IVA calculado para el bien o servicio. 14 Importe Importe total de los bienes o servicios del presente concepto. Importe = Cantidad x Valor Unitario 15 Observación Observaciones o comentarios específicos del bien o servicio del presente concepto 16 Pedimento Numero de pedimento, puede especificar varios pedimentos separados por comas 17 FhaPedimento Fecha de los pedimentos, deben estar en formato yyyy-mm-dd. Puede especificar más de una fecha pedimento separadas por comas. 18 Aduana Indica el número de aduana, puede especificar más de una aduena, separada por comas. 19 Ieps [Porcentaje] Indica el porcentaje de impuesto IEPS aplicable a este concepto. 20 Ieps [Importe] Indica el importe de impuesto IEPS aplicable a este concepto. 21 IVARetenidoPorcentaje Porcentaje del IVA Retenido Valores Permitidos IVARetenidoImporte Importe del IVA Retenido Valores Permitidos ISRPorcentaje Porcentaje de ISR Retenido Valores Permitidos ISRImporte Importe del ISR Retenido Valores Permitidos Observaciones2 Campo de observaciones adicionales del detalle de la Factura. 26 Observaciones3 Campo de observaciones adicionales del detalle de la Factura.

13 27 Observaciones4 Campo de observaciones adicionales del detalle de la Factura. 28 Observaciones5 Campo de observaciones adicionales del detalle de la Factura. 29 ExtraNumerico1 Valor numérico extra, para incluir en la información del detalle de la factura. 30 ExtraNumerico2 Valor numérico extra, para incluir en la información del detalle de la factura. 31 ExtraNumerico3 Valor numérico extra, para incluir en la información del detalle de la factura. 32 ExtraNumerico4 Valor numérico extra, para incluir en la información del detalle de la factura. 33 ExtraNumerico5 Valor numérico extra, para incluir en la información del detalle de la factura. 34 ExcluirDelCFD Campo utilizado para indicar si el registro (detalle) será excluido en el XML de salida. 0 ó (null) Indica que el ítem será Incluido en el XML; 1 Indica que el ítem será Excluido del XML. 35 ExcluirDeImpresion Campo utilizado para indicar si el registro (detalle) será excluido de la impresión en el PDF de salida. 0 ó (null) Indica que el ítem será Incluido de la impresión PDF; 1 Indica que el ítem será Excluido de la impresión PDF. 36 Observaciones6 Campo de observaciones adicionales del detalle de la Factura. 37 Observaciones7 Campo de observaciones adicionales del detalle de la Factura. 38 Observaciones8 Campo de observaciones adicionales del detalle de la Factura. 0 ó 1 0 ó 1

14 39 Observaciones9 Campo de observaciones adicionales del detalle de la Factura. 40 Observaciones10 Campo de observaciones adicionales del detalle de la Factura. 41 Extranumerico6 Valor numérico extra, para incluir en la información del detalle de la factura. 42 Extranumerico7 Valor numérico extra, para incluir en la información del detalle de la factura. 43 Extranumerico8 Valor numérico extra, para incluir en la información del detalle de la factura. 44 Extranumerico9 Valor numérico extra, para incluir en la información del detalle de la factura. 45 Extranumerico10 Valor numérico extra, para incluir en la información del detalle de la factura. Ejemplo de un archivo de encabezado DIG 3.3 NTE E9 F 100 AAA :07: PUE MXN No requerida NTE E9 Materiales Piña Distribuidora de Materiales Piña de Tekax S.A. de C.V. Calle 43 No. 211 Col. San Ignacio Tekax de Álvaro Obregón YUC MEX corelprub@gmail.com G :59: [Versión] NTE E9 - [RFC]

15 F - [TipoDocumento] [NoFactura] AAA - [Serie] - [ClaveSucursal] :07:24 - [Fecha] 01 - [FormaDePago] 01 - [CondicionesDePago] PUE - [MetodoDePago] - [MotivoDeDescuentoDeLaFactura] MXN - [Moneda] 1 - [TipoDeCambio] [NoDeControl] No requerida - [NoDeOrden] - [TipoRelacion] - [CFDIsRelacionados] [NoDeRemisión] [ReceptorClave {Cliente}] NTE E9 - [ReceptorRFC {Cliente}] Materiales Piña - [ReceptorNombreComercial] Distribuidora de Materiales Piña de Tekax S.A. de C.V. - [ReceptorRazónSocial] Calle 43 - [ReceptorCalle]

16 No [ReceptorNoExterior] - [ReceptorNoInterior] Col. San Ignacio - [ReceptorColonia] - [ReceptorReferencia] - [ReceptorLocalidad] Tekax de Álvaro Obregón - [ReceptorMunicipio] YUC - [ReceptorEstado] MEX - [ReceptorPaís] [ReceptorCodigoPostal] corelprub@gmail.com - [Receptor ] - [ReceptorEntregarANombre] - [ReceptorEntregarARazonSocial] - [ReceptorEntregarADireccion] - [ReceptorEntregarAEstado] - [ReceptorEntregarAResidenciaFiscal] - [ReceptorNumRedIdTrib] G01 - [UsoCFDI] [Subtotal] 0 - [DescuentoPorcentaje] 0 - [DescuentoImporte] 0 - [IepsPorcentaje]

17 0 - [IepsImporte] 0 - [IvaRetenido] 0 - [IsrRetenido] 0 - [ISHPorciento] 0 - [ISHImporte] 16 - [IvaPorcentaje] [IvaImporte] [TotalFactura] - [Estatus] - [Observaciones1] - [Observaciones2] - [Observaciones3] - [Observaciones4] - [Observaciones5] - [Observaciones6] - [Observaciones7] - [Observaciones8] - [Observaciones9] - [Observaciones10] 0 - [ExtraNumerico1] 0 - [ExtraNumerico2]

18 0 - [ExtraNumerico3] 0 - [ExtraNumerico4] 0 - [ExtraNumerico5] 0 - [ExtraNumerico6] 0 - [ExtraNumerico7] 0 - [ExtraNumerico8] 0 - [ExtraNumerico9] 0 - [ExtraNumerico10] 0 - [EsEditable] - [NumCtaPago] - [SerieFolioFiscalOriginal] 0 - [MontoFolioFiscalOriginal] :59:59 - [FechaFolioFiscalOriginal] Ejemplo de un archivo de detalle CPO H87 No Aplica VEC-V27 VEC-V27 Venta materiales de construcción [IdEncabezado] 1 - [NoPartida] [ClaveProdServ] 1 - [Cantidad]

19 H87 - [ClaveUnidad] No Aplica - [Unidades] VEC-V27 - [Identificacion] VEC-V27 - [Codigo] Venta materiales de construcción - [Descripcion] [ValorUnitario] 0 - [DescuentoPorciento] 0 - [DescuentoImporte] 16 - [IvaPorciento] [IvaImporte] 0 - [IepsPorcentaje] 0 - [IepsImporte] [Importe] 0 - [IvaRetenidoPorcentaje] 0 - [IvaRetenidoImporte] 0 - [ISRPorcentaje] 0 - [ISRImporte] - [NumeroDeSerie] - [Pedimento] - [FECHAPedimento] - [AduanaPedimento]

20 - [Observacion] - [Observacion2] - [Observacion3] - [Observacion4] - [Observacion5] - [Observacion6] - [Observacion7] - [Observacion8] - [Observacion9] - [Observacion10] 0 - [ExtraNumerico1] 0 - [ExtraNumerico2] 0 - [ExtraNumerico3] 0 - [ExtraNumerico4] 0 - [ExtraNumerico5] 0 - [ExtraNumerico6] 0 - [ExtraNumerico7] 0 - [ExtraNumerico8] 0 - [ExtraNumerico9] 0 - [ExtraNumerico10] 0 - [ExcluirDelCFD]

21 0 - [ExcluirDeImpresion]