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 Valor Alfanumérico 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 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 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 Débito, 03 Devolución 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 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 Entregar a País [Receptor] 39 ReceptorResidenciaFisc al 40 ReceptorNumRegIdTri b País de entrega de producto o servicio 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 Valor alfanumérico 0-50 caracteres Valor Alfanumérico 0-50 Caracteres 41 UsoCFDI Atributo requerido para expresar la clave del uso que dará a esta factura el receptor del CFDI. 42 Subtotal Subtotal de la Debe estar dado por la sumatoria de los importes del Detalle. Valor Alfanumérico 0-50 Caracteres 43 Descuento [%] Porcentaje de Descuento a aplicar Descuento [Importe] Importe de Descuento a aplicar. 45 IepsPorcentaje Indica el porcentaje de Impuesto IEPS para la factura 46 IepsImporte Indica el importe de impuesto IEPS aplicable para esta factura 47 IshPorciento Indica el porcentaje de Impuesto Sobre Hospedaje para la 48 IshImporte Indica el importe de Impuesto Sobre Hospedaje para la 49 IVA [Retenido] Importe de IVA Retenido

8 50 ISR [Retenido] Importe de ISR Retenido 51 IVA [%] Porcentaje de IVA a aplicar IVA [Importe] Importe de IVA calculado. 53 Total Factura Total de la Debe estar dado por Total = Subtotal Descuento + ImpuestosTraslados - ImpuestosRetenidos. 54 Estatus Campo que indica el estatus del Documento [C = Cancelado] C 55 Observaciones1 Campo de observaciones adicionales de la 56 Observaciones2 Campo de observaciones adicionales de la 57 Observaciones3 Campo de observaciones adicionales de la 58 Observaciones4 Campo de observaciones adicionales de la 59 Observaciones5 Campo de observaciones adicionales de la 60 Observaciones6 Campo de observaciones adicionales de la 61 Observaciones7 Campo de observaciones adicionales de la 62 Observaciones8 Campo de observaciones adicionales de la 63 Observaciones9 Campo de observaciones adicionales de la 64 Observaciones10 Campo de observaciones adicionales de la 65 ExtraNumerico1 Valor numérico extra, para incluir en la 66 ExtraNumerico2 Valor numérico extra, para incluir en la

9 67 ExtraNumerico3 Valor numérico extra, para incluir en la 68 ExtraNumerico4 Valor numérico extra, para incluir en la 69 ExtraNumerico5 Valor numérico extra, para incluir en la 70 Extranumerico6 Valor numérico extra, para incluir en la 71 Extranumerico7 Valor numérico extra, para incluir en la 72 Extranumerico8 Valor numérico extra, para incluir en la 73 Extranumerico9 Valor numérico extra, para incluir en la 74 Extranumerico10 Valor numérico extra, para incluir en la 75 EsEditable Indica si la prefactura podrá ser editada antes de generar el CFD 76 NumCtaPago Indica los cuatro últimos dígitos del número de cuenta con la que se realizó el pago. 77 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 78 FolioFiscalOriginal Número de folio fiscal del comprobante que se hubiese expedido por el valor total del comprobante, tratándose del pago en parcialidades. 79 MontoFolioFiscalOriginal Total importe del comprobante que se hubiese expedido por el valor total de la operación, tratándose del pago en parcialidades. 80 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 0 = No editable 1 = Editable 0-4 Caracteres 0-10 Caracteres Valores Permitidos Valores Permitidos Valor permitido yyyymmdd HH:mm:ss

10 aaaa-mm-ddthh:mm:ss, de acuerdo con la especificación ISO PdfFile Nombre de archivo (ruta y archivo) para adjuntar a correo electrónico.

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 Ieps [Porcentaje] Indica el porcentaje de impuesto IEPS aplicable a este concepto. 15 Ieps [Importe] Indica el importe de impuesto IEPS aplicable a este concepto. 16 Importe Importe total de los bienes o servicios del presente concepto. Importe = Cantidad x Valor Unitario 17 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 Pedimento Numero de pedimento, puede especificar varios pedimentos separados por comas 22 FhaPedimento Fecha de los pedimentos, deben estar en formato yyyy-mm-dd. Puede especificar más de una fecha pedimento separadas por comas. 23 Aduana Indica el número de aduana, puede especificar más de una aduena, separada por comas. 24 Observación Observaciones o comentarios específicos del bien o servicio del presente concepto 25 Observaciones2 Campo de observaciones adicionales del detalle de la 26 Observaciones3 Campo de observaciones adicionales del detalle de la

13 27 Observaciones4 Campo de observaciones adicionales del detalle de la 28 Observaciones5 Campo de observaciones adicionales del detalle de la 29 Observaciones6 Campo de observaciones adicionales del detalle de la 30 Observaciones7 Campo de observaciones adicionales del detalle de la 31 Observaciones8 Campo de observaciones adicionales del detalle de la 32 Observaciones9 Campo de observaciones adicionales del detalle de la 33 Observaciones10 Campo de observaciones adicionales del detalle de la 34 ExtraNumerico1 Valor numérico extra, para incluir en 35 ExtraNumerico2 Valor numérico extra, para incluir en 36 ExtraNumerico3 Valor numérico extra, para incluir en 37 ExtraNumerico4 Valor numérico extra, para incluir en 38 ExtraNumerico5 Valor numérico extra, para incluir en 39 Extranumerico6 Valor numérico extra, para incluir en 40 Extranumerico7 Valor numérico extra, para incluir en 41 Extranumerico8 Valor numérico extra, para incluir en

14 42 Extranumerico9 Valor numérico extra, para incluir en 43 Extranumerico10 Valor numérico extra, para incluir en 44 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. 45 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. 0 ó 1 0 ó 1

15 EJEMPLO DE ARCHIVO DE ENCABEZADO.DIG 3.3 NTE E9 F 1001 AAA :07:24 03 CONTADO PUE MXN Orden Remision NTE E9 GRUPO NASA NASA Tecnologia S.C. RETOR 1 No. 208 Piso 1 Col. EMPLEADOS SFEO Monterrey MTY NL MEX sluna@nasa.com.mx Entrega1 Entregar Entrega3 Entrega4 Entregar5 G A OBS1 OBS2 OBS3 OBS4 OBS5 OBS6 OBS7 OBS8 OBS9 OBS IDENTIFICADO :59: [Versión] NTE E9 - [RFC] F - [TipoDocumento] [NoFactura] AAA - [Serie] 1 - [ClaveSucursal] :07:24 - [Fecha] 03 - [FormaDePago] CONTADO - [CondicionesDePago] PUE - [MetodoDePago] - [MotivoDeDescuentoDeLaFactura] MXN - [Moneda] 1 - [TipoDeCambio] [NoDeControl] Orden - [NoDeOrden] Remision - [NoDeRemisión] - [TipoRelacion] [CFDIsRelacionados] [ReceptorClave {Cliente}] NTE E9 - [ReceptorRFC {Cliente}] GRUPO NASA - [ReceptorNombreComercial] NASA Tecnologia S.C. - [ReceptorRazónSocial] RETOR 1 - [ReceptorCalle] No [ReceptorNoExterior] Piso 1 - [ReceptorNoInterior] - [ReceptorReferencia] Col. EMPLEADOS SFEO - [ReceptorColonia] Monterrey - [ReceptorLocalidad]

16 MTY - [ReceptorMunicipio] NL - [ReceptorEstado] MEX - [ReceptorPaís] [ReceptorCodigoPostal] sluna@nasa.com.mx - [Receptor ] Entrega1 - [ReceptorEntregarANombre] Entrega2 - [ReceptorEntregarARazonSocial] Entrega3 - [ReceptorEntregarADireccion] Entrega4 - [ReceptorEntregarAEstado] Entrega5 - [ReceptorEntregarAPaís] - [ReceptorEntregarAResidenciaFiscal] - [ReceptorNumRedIdTrib] G03 - [UsoCFDI] [Subtotal] 0 - [DescuentoPorcentaje] [DescuentoImporte] 0 - [IepsPorcentaje] 0 - [IepsImporte] 0 - [ISHPorciento] 0 - [ISHImporte] 0 - [IvaRetenido] 0 - [IsrRetenido] 16 - [IvaPorcentaje] [IvaImporte] [TotalFactura] A - [Estatus] OBS1 - [Observaciones1] OBS2 - [Observaciones2] OBS3 - [Observaciones3] OBS4 - [Observaciones4] OBS5 - [Observaciones5] OBS6 - [Observaciones6] OBS7 - [Observaciones7] OBS8 - [Observaciones8] OBS9 - [Observaciones9] OBS10 - [Observaciones10] 1 - [ExtraNumerico1] 2 - [ExtraNumerico2]

17 3 - [ExtraNumerico3] 4 - [ExtraNumerico4] 5 - [ExtraNumerico5] 6 - [ExtraNumerico6] 7 - [ExtraNumerico7] 8 - [ExtraNumerico8] 9 - [ExtraNumerico9] 10 - [ExtraNumerico10] 0 - [EsEditable] IDENTIFICADO - [NumCtaPago] - [SerieFolioFiscalOriginal] 0 - [MontoFolioFiscalOriginal] :59:59 - [FechaFolioFiscalOriginal] EJEMPLO DE ARCHIVO DE DETALLE.CPO H87 PIEZA VEC-V27 VEC-V27 Venta de Licencia de Software Facturak CFDI v OBS1 OBS2 OBS3 OBS4 OBS5 OBS6 OBS7 OBS8 OBS9 OBS [NoPartida] [ClaveProdServ] 1 - [Cantidad] H87 - [ClaveUnidad] PIEZA - [Unidades] VEC-V27 - [Identificacion] VEC-V27 - [Codigo] Venta de Licencia de Software Facturak CFDI v3.3 - [Descripcion] [ValorUnitario] 0 - [DescuentoPorciento] [DescuentoImporte] 16 - [IvaPorciento] [IvaImporte] 0 - [IepsPorcentaje] 0 - [IepsImporte] [Importe] 0 - [IvaRetenidoPorcentaje] 0 - [IvaRetenidoImporte]

18 0 - [ISRPorcentaje] 0 - [ISRImporte] - [Pedimento] - [FECHAPedimento] - [AduanaPedimento] OBS1 - [Observacion] OBS2 - [Observacion2] OBS3 - [Observacion3] OBS4 - [Observacion4] OBS5 - [Observacion5] OBS6 - [Observacion6] OBS7 - [Observacion7] OBS8 - [Observacion8] OBS9 - [Observacion9] OBS10 - [Observacion10] 1 - [ExtraNumerico1] 2 - [ExtraNumerico2] 3 - [ExtraNumerico3] 4 - [ExtraNumerico4] 5 - [ExtraNumerico5] 6 - [ExtraNumerico6] 7 - [ExtraNumerico7] 8 - [ExtraNumerico8] 9 - [ExtraNumerico9] 10 - [ExtraNumerico10] 0 - [ExcluirDelCFD] 0 - [ExcluirDeImpresion]