características técnicas del archivo prototipo para la ......de la factura. en esta sección se...

Características Técnicas del archivo prototipo para la importación de documentos [SQL-Facturak].

Contenido Control de Versiones ................................................................................................................................................... 2

Objetivo ............................................................................................................................................................................. 3

Interface Genérica SQL-[Facturak]. .................................................................................................................. 3

Reglas Generales: ..................................................................................................................................................... 3

Descripción de los campos de FacturaEncabezado ........................................................................................ 4

Descripción de los campos de FacturaDetalle .................................................................................................. 9

Script para la construcción de las tablas para documentos previos a factura. ................................ 12

Control de Versiones Fecha Versión Descripción Realizó Revisó

2010-11-02 1.0.0 Creación del documento. Ing. Adelfo Gallardo

2011-01-20 1.0.1 Actualización de campos Ing. Adelfo Gallardo

2011-01-24 1.0.2 Se agregan campos para control de errores Ing. Adelfo Gallardo

2011-06-06 2.0.1 Se agregó campo RFC en Encabezado para

identificar Empresa Emisora.

Ing. Sergio R. Luna

Saavedra

2011-06-14 2.0.2 Se agregó campo

-ExcluirDelCFD

-ExcluirDeImpresion

Sirve para identificar elementos (detalle) que no

se desean incluir en XML de salida.

Ing. Sergio R. Luna

Saavedra


-NumCtaPago

-SerieFiscalOriginal

-FolioFiscalOriginal

-MontoFiscalOriginal

-FechaFiscalOriginal

Correspondiente a los cambios del SAT del

2012.

Ing. Manuel

Alejandro Garza

Enríquez


- Observaciones 6,7,8,9,10

- Extranumerico 6,7,8,9,10

Ing. Manuel

Alejandro Garza

Enríquez

Objetivo

Interface Genérica SQL-[Facturak]. Al optar por el protocolo de comunicación mediante esquema de tablas genéricas de SQL entre

el [ERP] de la Empresa y el sistema de Facturación Electrónica Facturak, el cliente deberá llenar las

tablas de documentos previos a facturación mediante las siguientes indicaciones:

Reglas Generales: 1. Debe generar las estructuras de las tablas de documentos previos a facturar en el servidor SQL

utilizando el script proporcionado más adelante en el punto D.

2. Una vez ejecutado el script deberá verificar que las tablas de documentos previos a facturar se

hayan creado.

3. El script genera 4 tablas las cuales se definen a continuación:

a) TipoDocumento: Esta tabla se crea para especificar las opciones disponibles a utilizar

como tipos de documentos posteriormente en los documentos de facturas. Esta tabla debe

mantenerse fija y sin modificarse.

b) Moneda: Esta tabla se crea y se llena con la finalidad de proporcionar las guias de los

valores que se espera utilice posteriormente en los campos de moneda, al generar un

documento previo a facturar.

c) FacturaEncabezado: Esta tabla contiene todos los campos que deben llenarse dentro del

encabezado de la factura. La especificación y descripción de los campos se especifica más

adelante en el punto B de este manual.

d) FacturaDetalle: Esta tabla contiene todos los campos que deben llenarse dentro del detalle

de la factura. En esta sección se llena la información de los conceptos que componen la

factura. La especificación y descripción de los campos se especifica más adelante en el

punto C de este manual.

4. Deberá llenar todos los campos que se especifican en esta documentación, deberá tener

cuidado de no omitir ningún campo que viene considerado como campo obligatorio.

5. En caso de uno utilizar un campo que no es obligatorio (opcional) puede dejarlo vacio con el

valor NULL o con el string vacio (“”). En el caso de que sea un campo numérico favor de

especificar 0.

6. Se debe dejar un registro en FacturaEncabezado por cada factura, y N registros para

FacturaDetalle, dependiendo de los conceptos que requiere en su factura.

7. Existen unos campos cuyo nombre inicia con la palabra “Facturak”, ejemplo:

FacturakProcesado, FacturakFolio, etc. Dicos campos son de uso interno de facturak por lo que

solo deberá utilizarlos para lectura.

Descripción de los campos de FacturaEncabezado

No. Campo Descripción Tamaño ¿Obligatorio?

1 Id Identificador único de la factura N/A SI

2 RFC RFC de la Empresa Emisora Valor alfanumérico

13 Caracteres

SI

3 TipoDocumento Indica el tipo de documento a generar F - Factura

CR –Nota Crédito

CA – Nota Cargo

RH – Rec.

Honorarios

SI

4 NoFactura No. de Folio por asignar al CFD.

Nota: Solo se especifica cuando el consecutivo

será generado por el [ERP] origen. (No

recomendado)

Valor alfanumérico

6 Caracteres

NO

5 Serie Serie de facturas a utilizar para la generación

de CFD.

Valor alfanumérico

1-10 Caracteres

SI

6 ClaveSucursal Clave de la Sucursal que emite la factura. Valor alfanumérico

0-10

NO

7 Fecha Fecha de generación de documento del ERP.

No es la fecha de facturación.

Valor permitido

yyyyMMdd

HH:mm:ss

NO

8 FormaDePago Forma de pago de la factura Valor alfanumérico

1-50 Caracteres

SI

9 CondicionesDePago Condiciones de pago de la factura Valor alfanumérico

1-50 Caracteres

SI

10 MetodoDePago Método de pago de la factura Valor alfanumérico

1-50 Caracteres

SI

11 MotivoDeDescuento Motivo de Descuento de la factura Valor alfanumérico

0-50 Caracteres

NO

12 Moneda Tipo de moneda a facturar. PESOS, DOLAR,

EUROS

Valor alfanumérico

1-30 Caracteres

SI

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

14 NoDeControl Numero de Facturo o Folio emitido por el

[ERP].

Valor alfanumérico

0-50 Caracteres

SI

15 NoDeOrden Numero de Orden Interno al ERP. Valor alfanumérico

0-50 Caracteres

NO

16 NoDeRemisión Numero de Remisión generado en el [ERP]. Valor alfanumérico

0-50 Caracteres

NO

17 ReceptorClave Clave o identificador del Cliente Valor alfanumérico

1-10 Caracteres

SI

18 ReceptorRFC RFC del Cliente Valor alfanumérico

12-13 Caracteres

SI

19 ReceptorNombreComerci

al

Nombre comercial del Cliente Valor alfanumérico

1-100 Caracteres

SI

20 ReceptorRazónSocial Razón Social del Cliente Valor alfanumérico

1-100 Caracteres

SI

21 ReceptorCalle Calle [Dir. Fiscal] del Cliente Valor alfanumérico

1-80 Caracteres

SI

22 ReceptorNoExterior No. Exterior [Dir. Fiscal] del Cliente Valor alfanumérico

1-30 Caracteres

SI

23 ReceptorNoInterior No. Interior [Dir. Fiscal] del Cliente Valor alfanumérico

0-30 Caracteres

NO

24 ReceptorReferencia Referencia [Dir. Fiscal] del Cliente Valor alfanumérico

0-60 Caracteres

NO

25 ReceptorColonia Colonia [Dir. Fiscal] del Cliente Valor alfanumérico

1-80 Caracteres

SI

26 ReceptorLocalidad Localidad [Dir. Fiscal] del Cliente Valor alfanumérico

0-60 Caracteres

NO

27 ReceptorMunicipio Municipio [Dir. Fiscal] del Cliente Valor alfanumérico

1-60 Caracteres

SI

28 ReceptorEstado Estado [Dir. Fiscal] del Cliente Valor alfanumérico

1-60 Caracteres

SI

29 ReceptorPais País [Dir. Fiscal] del Cliente Valor alfanumérico

1-60 Caracteres

SI

30 ReceptorCodigoPostal C.P. [Dir. Fiscal] del Cliente Valor alfanumérico

1-10 Caracteres

SI

31 ReceptorEmail Correo electrónico al cual se enviara la

factura. Si se especifican varias direcciones

deberán separarse mediante ‘;’ (punto y

coma)

Valor alfanumérico

0-500 Caracteres

NO

32 ReceptorEntregarANomb

re

Nombre a quien se entrega productos o

servicios

Valor alfanumérico

0-200

NO

33 ReceptorEntregarARazon

Social

Razón Social a la que se entrega producto o

servicio

Valor alfanumérico

0-200

NO

34 ReceptorEntregarADirecc

ión

Dirección de entrega de producto o servicio Valor alfanumérico

0-200

NO

35 ReceptorEntregarAEstad

o

Entidad de entrega de producto o servicio Valor alfanumérico

0-200

NO

36 Subtotal Subtotal de la factura. Debe estar dado por la

sumatoria de los importes del Detalle.

Valores permitidos

0.00-9999999.99

SI

37 DescuentoPorcentaje Porcentaje de Descuento a aplicar. Valores permitidos

0-100

NO

38 DescuentoImporte Importe de Descuento a aplicar. Valores permitidos

0.00-9999999.99

NO

39 IepsPorcentaje Porcentaje de impuesto IEPS Valores permitidos

0.00-9999999.99

NO

40 IepsImporte Importe de impuesto IEPS Valores permitidos

0.00-9999999.99

NO

41 IvaRetenido Importe de IVA Retenido Valores permitidos

0.00-9999999.99

NO

42 IsrRetenido Importe de ISR Retenido Valores permitidos

0.00-9999999.99

NO

43 ISHPorcentaje Porcentaje de Impuesto sobre hospedaje Valores permitidos

0.00-9999999.99

NO

44 ISHImporte Importe de Impuesto sobre Hospedaje Valores permitidos

0.00-9999999.99

NO

45 IvaPorcentaje Porcentaje de IVA a aplicar. Valores permitidos

0-100

SI

46 IvaImporte Importe de IVA calculado. Valores permitidos

0.00-9999999.99

SI

47 TotalFactura Total de la factura. Debe estar dado por Total

= Subtotal –Descuento + ImpuestosTraslados

- ImpuestosRetenidos.

Valores permitidos

0.00-9999999.99

SI

48 Estatus Campo que indica el estatus del Documento

[C = Cancelado]

Valores permitidos

‘C’

NO

49 Observaciones 1 Campo de observaciones adicionales de la

Factura.

Valor alfanumérico

0-500 Caracteres

NO


Factura.

Valor alfanumérico

0-500 Caracteres

NO


Factura.

Valor alfanumérico

0-500 Caracteres

NO


Factura.

Valor alfanumérico

0-500 Caracteres

NO

53 Observaciones5 Campo de observaciones adicionales de la

Factura.

Valor alfanumérico

0-500 Caracteres

NO


Factura.

Valor alfanumérico

0-500 Caracteres

NO


Factura.

Valor alfanumérico

0-500 Caracteres

NO


Factura.

Valor alfanumérico

0-500 Caracteres

NO


Factura.

Valor alfanumérico

0-500 Caracteres

NO


Factura.

Valor alfanumérico

0-500 Caracteres

NO

59 ExtraNumerico1 Valor numérico extra, para incluir en la

información del comprobante.

Valores permitidos

0.00- 9999999.99

NO



Valores permitidos

0.00- 9999999.99

NO



Valores permitidos

0.00- 9999999.99

NO



Valores permitidos

0.00- 9999999.99

NO



Valores permitidos

0.00- 9999999.99

NO



Valores permitidos

0.00- 9999999.99

NO



Valores permitidos

0.00- 9999999.99

NO



Valores permitidos

0.00- 9999999.99

NO



Valores permitidos

0.00- 9999999.99

NO



Valores permitidos

0.00- 9999999.99

NO

69 EsEditable Indica si el registro de esta factura debe

importarse únicamente como prefactura para

poder editarla manualmente.

0 o 1 NO

70 NumCtaPago Indica los cuatro últimos dígitos del número

de cuenta con la que se realizó el pago.

Valor alfanumérico

0-4 Caracteres

NO

71 SerieFolioFiscalOriginal Nombre de la serie del folio del comprobante

que se hubiese expedido por el valor total del

comprobante, tratándose del pago en

Valor alfanumérico

0-10 Caracteres

NO

parcialidades

72 FolioFiscalOriginal Número del folio fiscal del comprobante que

se hubiese expedido por el valor total del


parcialidades.

Valores Permitidos

1 – 9999999

NO

73 MontoFolioFiscalOriginal Total importe del comprobante que se

hubiese expedido por el valor total de la

operación, tratándose del pago en

parcialidades.

Valores Permitidos

1.00 – 9999999.00

NO

74 FechaFolioFiscalOriginal Fecha de expedición del comprobante que se

hubiese emitido por el valor total del


parcialidades. Se expresa en la forma aaaa-

mm-ddThh:mm:ss, de acuerdo con la

especificación ISO 8601.

Valor permitido

yyyyMMdd

HH:mm:ss

NO

75 FacturakProcesado Indica si la interfaz con facturak ha procesado

este registro. 0 = No procesado, 1 =

Procesado

0 ó 1 NO

76 FacturakFolio Al generar el CFD, facturak regresa en este

campo el Folio asignado a este registro.

Valores permitidos

0.00- 9999999.99

NO

77 FacturakSerie Al generar el CFD, facturak regresa en este

campo la serie asignada a este registro.

Valor alfanumérico

1-10 Caracteres

NO

78 FacturakSerieFolio Al generar el CFD, facturak regresa en este

campo la serie y folio asignados a este

registro.

Valor alfanumérico

1-10 Caracteres

NO

79 FacturakXML Al generar el CFD, facturak regresa en este

campo el XML generado para este registro

Valor alfanumérico

1-10000 Caracteres

NO

80 FacturakFileNameTXT En caso de que este registro haya sido

importado de un archivo, este campo se

graba el nombre del archivo origen

Valor alfanumérico

1-50 Caracteres

NO

81 ERPProcesado Puede utilizar este campo para marcar los

registros que el ERP ha procesado de regreso

0 ó 1 NO

82 FacturakFhaHoraCFD Al generar el CFD, Facturak regresa en este

campo la fecha y hora a la cual se generó este

registro.

N/A NO

83 FacturakError Indica si el registro ha regresado un error. 0 ó 1 NO

84 FacturakErrorMessage Indica el mensaje de error que ha provocado

este registro.

Valor alfanumérico

1-10000 Caracteres

NO

Descripción de los campos de FacturaDetalle

No. Campo Descripción Tamaño ¿Obligatorio?

1 IdEncabezado Id del encabezado al cual pertenece esta

factura.

Valores permitidos

1-999999

SI

2 No. Partida Consecutivo de registro Valores permitidos

1-999999

SI

3 Cantidad Cantidad de bienes o servicios Valores permitidos

1-9999999

SI

4 Unidad Unidad de medida aplicable para la

cantidad expresada en el concepto.

Valor alfanumérico

0-50 Caracteres

NO

5 No. Identificación Número de identificación del servicio o

producto.

Valor alfanumérico

0-50 Caracteres

NO

6 Código Código interno del servicio o producto. Valor alfanumérico

0-50 Caracteres

NO

7 Descripción Descripción del bien o servicio Valor alfanumérico

1-200 Caracteres

SI

8 Valor Unitario Valor o precio unitario del bien o servicio.

Sin impuesto

Valores permitidos

0.00-9999999.99

SI

9 Descuento [%] Porcentaje de Descuento aplicado al bien o

servicio

Valores permitidos

0.00-9999999.99

NO

10 Descuento

[Importe]

Descuento calculado aplicado al bien o

servicio

Valores permitidos

0.00-9999999.99

NO

11 IVA [%] Porcentaje de IVA aplicable al bien o

servicio

Valores permitidos

0-100

NO

12 IVA [Importe] IVA calculado para el bien o servicio. Valores permitidos

0.00-9999999.99

NO

13 IepsPorcentaje Indica el porcentaje de impuesto IEPS

aplicable a este concepto.

Valores permitidos

0.00-9999999.99

NO

14 IepsImporte Indica el importe de impuesto IEPS

aplicable a este concepto

Valores permitidos

0.00-9999999.99

NO

13 Importe Importe total de los bienes o servicios del

presente concepto.

Importe = Cantidad x Valor Unitario

Valores permitidos

0.00-9999999.99

SI

14 NumeroDeSerie Número de serie del bien o servicio en caso

de que aplique. Puede especificar más de un

número de serie separándolos con coma.

Valor alfanumérico

1-500 Caracteres

NO

15 Pedimento Pedimento que corresponde al producto o

bien especificado, puede especificar más de

un pedimento separándolos con coma.

Valor alfanumérico

1-500 Caracteres

NO

16 FechaPedimento Fecha del pedimento correspondiente al

producto o bien especificado. La fecha

deberá estar especificada en el formato

(“yyyy-MM-dd”). Puede indicar más de una

fecha de pedimento separándolas con

coma.

Valor alfanumérico

1-500 Caracteres

NO

17 Aduana Aduana correspondiente al producto o bien

especificado. Puede indicar más de una

aduana separándolas con coma.

Valor alfanumérico

1-500 Caracteres

NO

18 Observación Observaciones o comentarios específicos

del bien o servicio del presente concepto

Valor alfanumérico

0-500 Caracteres

NO

19 Observaciones2 Observaciones o comentarios específicos


Valor alfanumérico

0-500 Caracteres

NO



Valor alfanumérico

0-500 Caracteres

NO



Valor alfanumérico

0-500 Caracteres

NO



Valor alfanumérico

0-500 Caracteres

NO



Valor alfanumérico

0-500 Caracteres

NO



Valor alfanumérico

0-500 Caracteres

NO



Valor alfanumérico

0-500 Caracteres

NO



Valor alfanumérico

0-500 Caracteres

NO



Valor alfanumérico

0-500 Caracteres

NO

28 ExtraNumerico1 Valor Numérico adicional relacionado al

bien o servicio del presente concepto.

Valores permitidos

0.00-9999999.99

NO



Valores permitidos

0.00-9999999.99

NO



Valores permitidos

0.00-9999999.99

NO



Valores permitidos

0.00-9999999.99

NO



Valores permitidos

0.00-9999999.99

NO



Valores permitidos

0.00-9999999.99

NO



Valores permitidos

0.00-9999999.99

NO



Valores permitidos

0.00-9999999.99

NO



Valores permitidos

0.00-9999999.99

NO



Valores permitidos

0.00-9999999.99

NO

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

Valores permitidos

0 ó 1

NO

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

Valores permitidos

0 ó 1

NO

Script para la construcción de las tablas para documentos previos a factura.

if exists (select * from dbo.sysobjects where id = object_id(N'[dbo].[FacturaEncabezado]')

and OBJECTPROPERTY(id, N'IsUserTable') = 1)

drop table [dbo].[FacturaDetalle]

if exists (select * from dbo.sysobjects where id = object_id(N'[dbo].[FacturaEncabezado]')

and OBJECTPROPERTY(id, N'IsUserTable') = 1)

drop table [dbo].[FacturaEncabezado]

if exists (select * from dbo.sysobjects where id = object_id(N'[dbo].[TipoDocumento]') and

OBJECTPROPERTY(id, N'IsUserTable') = 1)

drop table [dbo].[TipoDocumento]

if exists (select * from dbo.sysobjects where id = object_id(N'[dbo].[Moneda]') and

OBJECTPROPERTY(id, N'IsUserTable') = 1)

drop table [dbo].[Moneda]

create table TipoDocumento

(

Clave nvarchar(50) not null unique,

Nombre nvarchar(50) not null unique

)

insert into TipoDocumento(Clave, Nombre) values('F', 'Factura')

insert into TipoDocumento(Clave, Nombre) values('CR', 'Nota Credito')

insert into TipoDocumento(Clave, Nombre) values('CA', 'Nota Cargo')

insert into TipoDocumento(Clave, Nombre) values('RH', 'Rec. Honorarios')

create table Moneda

(

Nombre nvarchar(30) not null unique,

Abreviacion nvarchar(5) not null

)

insert into Moneda(Nombre, Abreviacion) values('PESOS', 'MXN')

insert into Moneda(Nombre, Abreviacion) values('DOLARES', 'DLL')

create table FacturaEncabezado

(

ID bigint primary key identity(1,1),

RFC nvarchar(20),

TipoDocumento nvarchar(50) not null foreign key

references TipoDocumento(Clave),

NoFacturaFolio nvarchar(20),

Serie nvarchar(10),

ClaveSucursal nvarchar(10),

Fecha datetime not null,

FormaDePago nvarchar(50) not null,

CondicionesDePago nvarchar(50) not null,

MetodoDePago nvarchar(50) not null,

MotivoDeDescuento nvarchar(50),

Moneda nvarchar(30) not null foreign key

references Moneda(Nombre),

TipoDeCambio float default (1),

NoDeControl nvarchar(50) not null,

NoDeOrden nvarchar(50),

NoDeRemision nvarchar(50),

ReceptorClave nvarchar(10) not null,

ReceptorRFC nvarchar(20) not null,

ReceptorNombreComercial nvarchar(100) not null,

ReceptorRazonSocial nvarchar(100) not null,

ReceptorCalle nvarchar(80) not null,

ReceptorNoExterior nvarchar(30) not null,

ReceptorNoInterior nvarchar(30) null,

ReceptorReferencia nvarchar(60) null,

ReceptorColonia nvarchar(80) not null,

ReceptorLocalidad nvarchar(60) null,

ReceptorMunicipio nvarchar(60) not null,

ReceptorEstado nvarchar(60) not null,

ReceptorPais nvarchar(60) not null,

ReceptorCodigoPostal nvarchar(10) not null,

ReceptorEmail nvarchar(120) null,

ReceptorEntregarANombre nvarchar(200) null,

ReceptorEntregarARazonSocial nvarchar(200) null,

ReceptorEntregarADireccion nvarchar(200) null,

ReceptorEntregarAEstado nvarchar(200) null,

Subtotal float not null,

DescuentoPorcentaje float null,

DescuentoImporte float null,

IepsPorcentaje float null,

IepsImporte float null,

IvaRetenido float null,

IsrRetenido float null,

IvaPorcentaje float not null,

IvaImporte float not null,

IshPorcentaje float null,

IshImporte float null,

TotalFactura float not null,

Estatus nvarchar(2) null,

Observaciones1 nvarchar(500) null,










ExtraNumerico1 float null,










EsEditable bit null,

--- Cambios 2012

NumCtaPago nvarchar(500) null,

FolioFiscalOriginal nvarchar(500) null,

SerieFolioFiscalOriginal nvarchar(500) null,

FechaFolioFiscalOriginal datetime null,

MontoFolioFiscalOriginal nvarchar(500) null,

--- Cambios 2012

--- Campos que llenará facturak...

FacturakProcesado bit null,

FacturakFolio int null,

FacturakSerie nvarchar(10) null,

FacturakSerieFolio nvarchar(20) null,

FacturakXml nvarchar(max),

FacturakFhaHoraCFD datetime,

FacturakFileNameTXT nvarchar(50) null,

ERPProcesado bit null

)

create table FacturaDetalle

(

ID bigint primary key identity(1,1),

IdEncabezado bigint not null foreign key references

FacturaEncabezado(ID),

NoPartida int not null,

Cantidad float not null,

Unidad nvarchar(50) null,

NoIdentificacion nvarchar(50) null,

Codigo nvarchar(50) null,

Descripcion nvarchar(200) not null,

ValorUnitario float not null,

DescuentoPorcentaje float null,

DescuentoImporte float null,

IvaPorcentaje float null,

IvaImporte float null,

IepsPorcentaje float null,

IepsImporte float null,

Importe float not null,

Observacion nvarchar(500) null,

Pedimento nvarchar(MAX) null,

FhaPedimento nvarchar(MAX) null,

Aduana nvarchar(MAX) null,




















ExcluirDelCFD bit null,

ExcluirDeImpresion bit null

)

características técnicas del archivo prototipo para la ......de la factura. en esta sección se...

Documents