Documentos de Académico
Documentos de Profesional
Documentos de Cultura
VERSIN 1.1
NDICE
PRELIMINARES ........................................................................................................................... 3 ARQUITECTURA DE INTEGRACIN ............................................................................................. 4 MAPEO DE DATOS DEL CERTIFICADO DE RETENCIN .............................................................. 5 ESTADOS DEL CERTIFICADO DE RETENCIN ............................................................................ 9 FLUJO PARA ALMACENAMIENTO DE INFORMACIN EN AMBIENTE INTERMEDIO. .................... 10 PREGUNTAS FRECUENTES....................................................................................................... 12 ANEXOS .................................................................................................................................... 13 ANEXO 1: REQUERIMIENTOS TCNICOS ............................................................................. 13 ANEXO 2: LISTA DE CDIGOS ISO MONEDAS .................................................................... 14 ANEXO 3: LISTA DE CDIGOS ISO UNIDADES.................................................................... 15 ANEXO 4: TIPO DE COMPROBANTES DE PAGO ................................................................... 18
PRELIMINARES Para el proceso de integracin debemos incluir las siguientes actividades en paralelo mientras vamos desarrollando la interfase de extraccin de datos. Entrega y configuracin del Equipo de integracin (desarrollo y produccin). Obtener y enviar tabla de equivalencia de Monedas en su sistema, Tabla Monedas (ver Anexo 2). Los datos necesarios son Cdigo ISO y descripcin en su sistema. Obtener y enviar tabla de equivalencia de unidades en su sistema, Tabla Unidades (ver Anexo 3). Los datos necesarios son Cdigo ISO y descripcin en su sistema. Logotipo de la empresa en formato gif. La imagen del logo de la empresa cliente debe tener las siguientes propiedades: Fondo color blanco Ancho 185 pxeles, alto 68 pxeles Resolucin entre 300 ppp - 600 ppp (puntos por pulgada) Tamao entre 3KB - 5KB Autorizacin, rangos y fecha de autorizacin de impresin que aparece en las impresiones de comprobantes de retenciones; emitidos por SUNAT Firma y sello de la empresa que va en el certificado de retencin, escaneada, en formato gif, debe tener las siguientes propiedades: Ancho 540 pxeles, alto 200 pxeles Resolucin entre 300 ppp - 600 ppp (puntos por pulgada) Tamao entre 10KB y 15KB. En caso de emitir certificados de retencin en papel pre-impreso, solicitar el permiso respectivo a la SUNAT para emitir certificados de retencin de forma computarizada.
Mediante carta simple firmada por el Representante Legal de la empresa, comunicar a la SUNAT que se va a emitir las retenciones va electrnica.
Pg. 3
ARQUITECTURA DE INTEGRACIN
1. La Interfaz de Comunicacin extrae la informacin del Sistema de Informacin del Cliente. 2. La informacin extrada se guarda en la Base de Datos Intermedia. 3. El Componente de Integracin consulta la informacin de la Base de Datos Intermedia. 4. El Componente de Integracin genera un archivo XML con la informacin consultada y lo coloca en el MQ. 5. El MQ enva la informacin al Portal Web a travs de internet. 6. El archivo XML recibido por el MQ de Ebiz llega a Portal Web.
Pg. 4
M APEO DE DATOS DEL CERTIFICADO DE RETENCIN A continuacin se muestra la vista de impresin de un certificado de retencin en el Portal.
1 2 3 4 7 8 9 10 11 12 16 17 13 14 15
5 6
18
19
20
21
22
23 27
24
25
26
28
29
30
Usted, como ente emisor de Certificados de Retencin se encargar de dejar los datos del cliente de retencin en la base de datos intermedia, es decir, sus programas deben realizar los pasos 1 y 2 descritos en la seccin ARQUITECTURA DE INTEGRACIN. La estructura de informacin contendr 2 grupos de informacin: 1. Cabecera: Es siempre obligatoria y contendr la informacin propia del Certificado de Retencin. Se almacenar en los campos de la tabla RETENCION que se muestran en la Tabla 1. 2. Detalle: Es siempre obligatoria y contendr la informacin de cada tem que se almacenar en los campos de la tabla RETENTIONITEM que se muestran en la Tabla 1.
Pg. 5
Id
RUC
RETENTION
RucComprador
VARCHAR
30
SI
6 SI 20 100 SI SI SI
RUC Proveedor
RETENTION
RucProveedor
VARCHAR
30
SI
SI
9 10
RETENTION RETENTION
DireccionProveedor RetentionDate
VARCHAR VARCHAR
100 10
SI SI
SI SI
Pg. 6
11
Run N
12
Obs
13
Tipo de Cambio
Numero correlativo en el sistema del cliente (Cdigo interno) con el cual identifican la transaccin del pago de manera que les permite saber que documentos han sido cancelados con dicho movimiento Observaciones al Comprobante de Retencin Tipo de cambio con el que se realiza el Pago. Si el comprobante est en SOLES enviar 1 (uno), caso contrario enviar el tipo de cambio respectivo. Banco en que se realiza la transaccin del Pago y el Nro de cheque Numero de documento interno del sistema ERP del Emisor Cdigo ISO de la moneda del Comprobante de Retencin, en caso del Per es PEN Se manejan los estados estndar. No se enva por integracin Monto total en la moneda origen del Comprobante de Pago Monto total que se ha pagado por todos los Comprobantes de Pago. En Per estar en Nuevos Soles. Monto total que se ha retenido por todos los Comprobantes de Pago Estado Inicial del Documento: PC = Preparacin Completa. El Documento est en Revisin, el documento no es visualizado por el proveedor hasta que el cliente ingrese a la web y apruebe el documento. Si no envan el estado inicial, el estado inicial del Documento ser Activa.
RETENTION
CorridaNumero
VARCHAR
30
NO
NO
RETENTION
Obs
VARCHAR
254
NO
RETENTION
TipoCambio
DECIMAL
15,4
NO
14 15 16 17 27
Banco/ Nro Cheque Nro. Doc. Interno ERP Cliente Moneda Estado Total Importe Operacin/ Origen Total Monto pagado Total Importe Retenido
30 50 5 1 15,4
NO NO SI NO NO
NO SI SI SI
SI
28 29
RETENTION RETENTION
TotalMontoPago TotalMontoRetenido
DECIMAL DECIMAL
15,4 15,4
SI SI
SI
SI
EstadoInicial
RETENTION
EstadoInicial
VARCHAR
NO
30
Se emplea para imprimir el rango de nmeros de retencin, emitido por la SUNAT (Sper Intendencia Nacional de Administracin Tributaria). Esta informacin debe ser entregada por el cliente (ver PRELIMINARES). Estos datos datos se cargan directamente en la base de datos del portal.
18
Tipo
RETENTIONITEM TipoDocumento
VARCHAR
10
SI
SI
19 20 21 22 23
Serie Nro documento Fecha emisin Moneda Original Importe Operacin/ Origen Monto Pagado S/. Importe Retenido S/.
RETENTIONITEM SerieDocumento RETENTIONITEM NumeroDocumento RETENTIONITEM FechaDocumento RETENTIONITEM Moneda RETENTIONITEM MontoOrigen
8 30 10 5 15,4
SI SI SI NO NO
SI SI SI Si
SI
24
RETENTIONITEM MontoPago
DECIMAL
15,4
SI
SI
25
RETENTIONITEM MontoRetenido
DECIMAL
15,4
SI
SI
Pg. 7
26
RETENTIONITEM NroDocERPItem
VARCHAR
50
NO
SI
Para la carga de informacin en la base de datos, es necesario tener en cuenta lo siguiente: En caso de los campos Numricos de tipo decimal, con tamao (x, y), indica que se puede enviar hasta nmero de x dgitos con un mximo de y decimales. Es decir el siguiente formato: 12345678910.1234 (11 dgitos en la parte entera, 4 dgitos en la parte decimal separados por el punto decimal) En caso no tengan valor se debe colocar cero 0 y NO valores NULL o vacos.
Todos los campos deben cumplir con la condicin de Obligatoriedad indicados en la seccin Descripcin de la tabla RETENTION Y RETENTIONITEM . Si algn campo es OPCIONAL, pero se cuenta con la informacin en su sistema ERP, debe ser almacenado en base de datos. De esta forma, la retroalimentacin al proveedor ser mucho mejor. Descripcin de la tabla CHECKPOINT_INTEGRACION
Nro 1 2 Descripcin Indica el documento que el componente est gestionando. Indica el ID en la tabla respectiva del documento. Indica si el documento ya fue procesado. Ejm: '0': Nuevo '1': Procesando '2': Procesado '3': Errado Indica la va de comunicacin del mensaje. Ejm: 'E': Entrada 'S': Salida Fecha de registro en la tabla Checkpoint_Integracion Nombre Campo BD CodigoAccion NroDocumento Tamao 3 4 Tipo Campo VARCHAR INTEGER Obligatorio SI SI
FlagProcesado
VARCHAR
SI
TipoBandeja
VARCHAR
SI
FechaRegistro
DATETIME
SI
Pg. 8
ESTADOS DEL CERTIFICADO DE RETENCIN Estados de Certificado de Retencin En Revisin Activa Anulada Impresa
Tabla 4. Estados de los Certificados de Retenciones
Cdigo de Accin R1 R1
1. Publicar el Certificado de Retencin en estado En Revisin: El certificado de retencin se almacenar con el valor PC en el campo EstadoInicial. En este estado el Cliente puede ingresar al Portal para modificar el Certificado y activarlo para la visualizacin por parte del proveedor. Mientras el cliente no active el Certificado de Retencin, el proveedor no podr visualizar el comprobante. 2. Publicar el Certificado de Retencin en estado Activa: El certificado de retencin se almacenar con el valor VACIO o NULL en el campo EstadoInicial. En este estado, el proveedor ya podr visualizar el comprobante. Nota: No se puede publicar una retencin ms de una vez por integracin. Esta debe anularse por la Web antes de republicar alguna de ellas. 3. Anular el Certificado de Retencin: La anulacin del comprobante de retencin se realizar por el portal Web, debido a que es necesario realizar una verificacin previa de que si el documento se encuentra impreso por el proveedor o no. El usuario ingresara al portal, buscar dicho documento y har clic en el botn ANULAR. 4. Imprimir el Certificado de Retencin: Si el proveedor ingresa al Portal Web e imprime el comprobante de Retencin, el estado del documento cambia a IMPRESA.
Pg. 9
RETENCION
Obtener el ID de la tabla Retention para su almacenamiento con la siguiente Query: Select Correlative from Correlativo where tablename = RETENTION
Actualizar el correlativo de la tabla Correlativo con el siguiente query: Update correlativo set correlative = correlative +1 where tablename=RETENTION
Guardar la informacin del Certificado de Retencin en un registro de la tabla RETENTION y RETENTIONITEM segn el mapeo de datos.
Guardar un registro en la tabla checkpoint_integracion: ID: Autogenerado CodigoAccion: R1 FlagProcesado: 0 TipoBandeja: S FechaRegistro: FechaActual (yyyy/MM/dd) Nrodocumento: Id del registro de la tabla Retention
Base de Datos
SI
NO FIN
Pg. 10
Ejemplo de carga de informacin en la base de datos intermedia (tablas RETENTION, RETENTIONITEM, CHECKPOINT_INTEGRACION y CORRELATIVO). Los datos han sido extrados del Prototipo de Comprobante de Retencin (ver figura 2).
Id 1 2 3 5 6 7 8 RETENTION 9 10 11 12 13 14 15 16 17 27 28 29 18 19 RETENTIONITEM 20 21 22 23 24 25 26 Base de Datos Integracin Tabla Nombre Campo RazonSocialCliente DireccionCliente TelefonoCliente RucComprador RetentionSerie RetentionNumber Valor ingresado COMPAA MINERA ANTAMINA S.A. Av. El Derby N 055, Torre 1, Oficina 801, Santiago de Surco, Lima 217-3000 PE20330262428 012 0014580
RazonSocialProveedor ECCO CONSTRUCTION SRL RucProveedor DireccionProveedor RetentionDate CorridaNumero Obs TipoCambio Banco NroDocPagoERP Moneda Status TotalMontoOrigen TotalMontoPago TotalMontoRetenido TipoDocumento SerieDocumento NumeroDocumento FechaDocumento Moneda MontoOrigen MontoPago MontoRetenido NroDocERPItem Tabla 5. Tablas Retention y Retentionitem SOL I 1,205.10 3,634.58 218.09 01 001 103 06/18/2009 USD 1205.10 3,634.58 218.09 3.0160 BCP / USD 20445789641 MZ A LOTE 13 JR. MIGUEL GRAU HUARMEY ANCASH 07/16/2009 000835
Id 1 2 3 4 9
Base de Datos Integracin Tabla Nombre Campo CHECKPOINT_INTEGR ACION CodigoAccion NroDocumento FlagProcesado TipoBandeja FechaRegistro Valor ingresado R1 ID de la tabla RETENTION 0 S 2011/07/11 1 2 Id
Base de Datos Integracin Tabla Nombre Campo CORRELATI VO TableName Correlative Tabla 7. Tabla Correlativo Valor ingresado ID de la Tabla RETENTION
Pg. 11
PREGUNTAS FRECUENTES 1. Los campos tienen un tamao indicado, al almacenar la informacin Se debe necesariamente ocupar este tamao, es decir relleno con espacios vacos u otro caracter? R. No es necesario que se ocupe el tamao mximo del campo, pero este no debe excederse de lo indicado 2. Se debe de incluir los signos en los valores de los campos numricos? R. Slo si estos incluyen cifras negativas, en el caso de cantidades positivas, es tcito. 3. Cmo se puede hacer para modificar o corregir un documento? R. En el caso de cualquier modificacin en los certificados de retencin, el documento debe ser anulado en el Portal Web y luego este puede volver a ser republicado. Si el documento no est anulado, la nueva retencin no se almacenar. A nivel de base de datos, solo har falta actualizar los campos de la retencin y colocar este documento pendiente de procesar (ver flujo de ingreso de datos Pgina 10)
Pg. 12
ANEXOS ANEXO 1: REQUERIMIENTOS TCNICOS 1. Requerimientos de Hardware y Software Para los proyectos de integracin, se requiere de 02 equipos, ya sean fsicos (PCs) o virtuales, los cuales debern ser destinados exclusivamente para este fin, con las siguientes caractersticas: Procesador de ltima generacin (32 bits). Memoria mnima 2GB Disco duro mnimo: 160 GB Tarjeta de Red : 100 Mbps Sistemas Operativos: Windows 2003 Server o Superior. IP Publica Fija (adquirida por el cliente), para el servidor donde se encontrara el MQ desarrollo y MQ de produccin. 2 puertos para el equipo de desarrollo, 2 puertos para el equipo de produccin, todos los puertos definidos por Ebiz. 2. Software a ser instalados por ebiz en los equipos de desarrollo y produccin Componente Integracin Ebiz. Microsoft SQL Server 2005 Express (libre) u otro motor de Base de Datos proporcionado por el cliente. Tambin se puede emplear Base de Datos libres, en caso que el nmero de transacciones sea menor a 100 documentos por da. Java: o En el equipo de desarrollo se instalar Java Development Kit (JDK) v1.6. o En el equipo de produccin se instalar Java Runtime Environment (JRE) v1.6_14. IBM MQ Series Server v 7.0 (MQ) IBM MQ Series Internet Pass-Thru v 2.0 (MQ) 3. Software a ser instalados por el cliente en los equipos de desarrollo y produccin Sistema Operativo y sus parches. Mantenimiento de nuevos parches. 4. Requerimientos de comunicaciones solicitados al cliente IPs Pblicas Fijas de los equipos de integracin (Desarrollo y/o produccin), para que estas sean habilitadas en los servidores de Ebiz. Las IPs pblicas sern utilizadas por el Servidor MQSeries del Equipo de Integracin para comunicacin con los servidores de Ebiz. Se puede trabajar con la misma IP publica en Desarrollo (DEV) y Produccin (PRD) Habilitacin de 2 puertos, cada uno de entrada y salida en el servidor MQSeries del Equipo de integracin, para las comunicaciones con la IP publica del Servidor MQ de Ebiz. Estos puertos sern habilitados por Ebiz. IP publica Ebiz (Desarrollo) 190.223.43.101 IP publica IBM(Produccin) 190.81.188.57
Se deben realizar pruebas de comunicacin con Ebiz, siguiendo los siguientes pasos: o Enviar la IP Pblica para que habiliten el acceso a dicha IP en el Servidor MQ de Ebiz. o Habilitar los puertos de entrada y salida indicados por Ebiz en los cortafuegos (firewall) o servidores proxy del cliente para la IP pblica del Servidor de Ebiz. o Una vez que Ebiz confirme la habilitacin de puertos se harn pruebas de comunicacin a la IP Pblica del servidor MQ de Ebiz en los puertos designados.
Pg. 13
Acceso al servidor de correos del cliente para el envo de correos de control (usuario y password), para los ambientes de desarrollo y produccin.
5. Requerimientos adicionales Acceso VPN.- se requiere acceso, a travs de una VPN, a los ambientes de desarrollo y produccin del ERP del Cliente, y as poder realizar los trabajos de desarrollo e implantacin desde las instalaciones de Ebiz. Acceso Remoto Habilitado.- se requiere que los equipos de desarrollo y produccin tengan el acceso remoto habilitado para poder acceder a los equipos. Acceso a Internet.- el acceso a Internet es necesario para las actualizaciones automticas y/o parches de Java, del SQL Server 2005 Express Edition y del Sistema Operativo.
Pg. 14
Cdigo ISO MHz None oz Ha km m mm cm in ft kg gln doc sobr blk jab lt m3 % cc sco Cont Drum Kit Pall Ampl Bid. Cap. Comp Fco. Grag Ovul Pkt Sup. Tab. Tubo Vial yd Bale Can
Descripcin MegaHertz None Ounce Ha Kilometer Meter Millimeter Centimeter Inch Feet Kilogram galon Docena Sobre Block Jaba Litro Metro cubico Porcentaje Centimetros Cubicos Saco Container Cilindro Kit Pallet Ampolla Bidon Capsula Comprimido Frasco Gragea Ovulo Packet Supositorio Tableta Tubo Vial Yarda Lata Lata Pg. 15
Cdigo ISO Ball Gros Lgth gln(UK) Cr. Fa. Pl. Pza. Var. Serv. Ch. ot ml mg Bld. Est. Lote ft3 Env. pt Gsa dec Bob. hora(s) cono atado bulto Pal. min(s) mes Kw/h Mw/h H-H H-M dia Bln Barril ml. m/min ton/m3
Descripcin Ball Gross Length Galon (UK) Cartucho Fardo Plancha Pieza Varilla Servicios Chisguete Onza Troy Mililitro Miligramo Balde Estuche Lote Pies Cubicos Envase Pinta Gruesa Decena Bobina Hora Cono Atado Bulto Paleta Minuto Mes Kilowatts/Hora Megawatts/Hora Horas - Hombres Horas - Maquina Dia Balon Barril Mililitro Metro/Minuto ton/m3
Cdigo ISO Pote PATCH m2 cm2 ft2 in2 ton gr Und. Set Roll Cja. Bol. Pqt. Rma. Par Plg. Btl. Cil. Hja. Lta. Mllr. Cto. RPM Kph HP Kw w Poise gr/cms KGS kph/m2 PSI mmHg BAR ATM Kg/m3 gr/cc Hz Volt
Descripcin Pote PATCH Metros Cuadados Centimetros Cuadados Pies Cuadados Pulgadas Cuadadas Toneladas Gramos Unidades Set Rollo Caja Bolsa Paquete Resma. Par Pliego Botella Cilindro Hoja Lata Millar Ciento. Revoluciones por Minuto Kilometros por Hora Caballos de Fuerza Kilowatt Watt Poise gr/cms Kilogramo/Segundo kph/m2 PSI mmHg BAR ATM Kg/m3 gr/cc Hertz Voltaje
Cdigo ISO None ft3 lb Tal Case C/U Jgo. Eqp. Glb. Tramo Tira. UP UA Quart EA dm Viaje assy pad conj C37 C36 DAY DPR UND VM KNM A93 KPA MTH MTS PRS PA TNE DR MTR FOT BG MTQ CS
Descripcin None Pies Cubicos Libra Talonario Case Cada Uno Juego Equipo Global Tramo Tira Unidad de Potencia Unidad de Actividad Quart EA Decimetro Viaje Assembly Pad Conjunto Milimol por litro Mol por metro cubico Dias Nro. Disparos Unidad Viaje Minero Kilonewton por metro cuadrado g/m3 Kilopascal Metro/Hora Metro/Segundo Numero de personas Paquete Tonela Metrica Tambor Metro Pie BOL MTQ CS
Pg. 16
Cdigo ISO GLL KGM BX LTR PR PCE RO RM PCE TNE usd ream 5GL Assortment Board foot Book Bote Bushel Pastel Tarjeta Garrafon HCF CFT Centegramo Cajon Crema Cubeta Cuete Quintal Display Disco Dry Onza Liq Medio Gal Gota Madeja Pul Cub Inyector Jar
Descripcin Galon Kg BX Litro Par Pieza Rollos Resma Unidad Tonelada USD Ream 5Gl Asst Bft Book Bote Bu Cake Card Cboy Ccf Cft Cg Cjn Crem Cube Cun Cwt Dis Disk Dry Floz Glh Gota Hnk In3 Inye Jar
Pg. 17
14 15 16 17 18 19 20 21 22 23 24 25
26
27
28 29 30 31 32 34 35 36 37 50 52 53 54
Tarifa Unificada de Uso de Aeropuerto Documentos emitidos por la COFOPRI en calidad de oferta de venta de terrenos, los correspondientes a las subastas pblicas y a la retribucin de los servicios que presta Documentos emitidos por las empresas que desempean el rol adquirente en los sistemas de pago mediante tarjetas de crdito y dbito Gua de Remisin - Transportista Documentos emitidos por las empresas recaudadoras de la denominada Garanta de Red Principal a la que hace referencia el numeral 7.6 del artculo 7 de la Ley N 27133 Ley de Promocin del Desarrollo de la Industria del Gas Natural Documento del Operador Documento del Partcipe Recibo de Distribucin de Gas Natural Documentos que emitan los concesionarios del servicio de revisiones tcnicas vehiculares, por la prestacin de dicho servicio Declaracin nica de Aduanas - Importacin definitiva Despacho Simplificado - Importacin Simplificada Declaracin de Mensajera o Courier Liquidacin de Cobranza BVME para transporte ferroviario de pasajeros Cdigo y denominacin incorporados por la Cuarta Disposicin Complementaria y Final de la Resolucin de Superintendencia N 1732008/SUNAT, publicada el 16.09.2008) Nota de Crdito Especial Nota de Dbito Especial Comprobante de No Domiciliado Exceso de crdito fiscal por retiro de bienes Nota de Crdito - No Domiciliado Nota de Dbito - No Domiciliado Otros - Consolidado de Boletas de Venta
55
87 88 91 96 97 98 99
Pg. 19