Centro de ayuda OfiPro

Formato de los ficheros XML para importar datos

Formato de los ficheros XML para importar datos

Anterior Siguiente Apartado sin directorio Expand/collapse all hidden text  

Formato de los ficheros XML para importar datos

Anterior Siguiente La lista de apartados requiere JavaScript Se requiere JavaScript para expandir el texto Se requiere JavaScript para imprimir Enviar consulta acerca de este apartado  

 

En este apartado, reservado para programadores con los necesarios conocimientos técnicos, se describe el formato de los ficheros XML requeridos en la importación de datos.

 

La importación de datos en formato XML está directamente relacionada con la opción Exportación de datos de OfiPro, ya que en ambas coinciden los nombres de los ficheros tratados, los campos que contienen, y el formato interno del fichero XML.

 

Por tanto, ejecutando la opción Exportación de datos podrá ver qué ficheros se pueden importar, con qué nombres, qué campos contienen, etc. Podrá ver que la tabla de Albaranes de venta ha de denominarse Albaranes.xml, mientras que la de Albaranes de compra ha de denominarse Albaranes de compra.xml. En la pantalla de exportación, active la casilla Incluir los campos requeridos en la importación para ver qué campos de cada tabla son requeridos como mínimo para poder realizar la importación.

 

Por ejemplo, si desea importar Artículos, ejecute la opción Exportación de datos, seleccionando el fichero de Artículos, activando la casilla Incluir los campos requeridos en la Importación. Se habrá generado un fichero denominado Artículos.xml en la carpeta Datos exportados (situada en Mis Documentos\OfiPro). Haciendo doble clic sobre él, se podrá observar, en el navegador de Internet, la estructura y campos requeridos en la importación.

 

Formato de los ficheros de importación a OfiPro

Formato de los ficheros de importación a OfiPro

 

 

 

hmtoggle_plus1Exportación de datos desde Delphi

 

Si Vd. trabaja con Delphi como lenguaje de programación, podrá generar fácilmente los ficheros XML necesarios para su importación en OfiPro.

 

Para generar un fichero XML en el formato requerido por OfiPro, utilice el componente TClientDataset:

 

 ClientDataset.SaveToFile('ExportacionGesPro.xml', dfXMLUTF8);

 

 

hmtoggle_plus1Estructura del fichero

 

La estructura del fichero tiene dos partes claramente diferenciadas: la definición de los campos (metadata) y los valores de los mismos (rowdata).

 

 

hmtoggle_plus1MetaData

 

En este apartado se declara cada campo definiendo las características que tiene: tipo, anchura etc.

 

 

hmtoggle_plus1RowData

 

Los valores que ha de rellenar en cada campo deben estar en concordancia con su tipo de dato. Por ejemplo para el código de una Factura debe asignársele un valor numérico.

 

 

hmtoggle_plus1Campos ID

 

Existen una serie de campos especiales que sirven para identificar registros dentro de cada tabla y que son necesarios para realizar la importación de los datos. Son los campos ID (Identificadores).

 

Estos campos están compuestos por uno o más valores que identifican al registro de manera única, es decir, actúan como índices. En una tabla exportada pueden existir varios campos de este tipo (que a partir de ahora llamaremos Campos Id). Son fácilmente identificables ya que empiezan por ID_ (existe una excepción que es el campo Id_Cierre de la tabla Cierres de Caja que es un campo normal no ID).

 

Un Campo Id puede identificar al propio registro o a un registro de otra tabla y estará formado a su vez por uno o más campos separados por comas. Por ejemplo el campo ID_FACTURA_VENTA está formado por los campos Serie y Código.

 

Cuando el Campo Id es de la propia tabla se utiliza en la importación para saber si este registro ya está dado de alta en la BD. Con esto se consigue que se pueda repetir la importación tantas veces como se desee con los mismos ficheros ya que los valores que ya están dados de alta no se van a volver a insertar.

 

Cuando el Campo Id es de una tabla externa se utiliza en la importación para buscar dicho identificador en la tabla externa. Por ejemplo dentro de una Factura el identificador de Clientes se utiliza para buscar dicho cliente en la tabla Clientes.

 

Por ejemplo, si exporta la tabla de Albaranes, verá que el fichero generado tiene los siguientes campos Id:

 

ID_ALBARAN_VENTA: Está formado por la Serie y el Código separado por comas (ej.: "A,22")
ID_CLIENTE: Identifica al Cliente mediante su Código.
ID_DIRECCION: Identifica la Dirección de Envío del Cliente mediante el Código de dicha Dirección de Envío.
ID_FORMA_COBRO: Identifica a la Forma de Cobro mediante su Código.
ID_DIVISA: Identifica a la Divisa mediante su Código.
ID_AGENTE: Identifica al Agente mediante su Código.
ID_TRANSPORTISTA: Identifica al Transportista mediante su Código.
ID_FACTURA_VENTA: Si este albarán se ha utilizado para crear una factura este identificador está formado por la Serie y el Código dicha factura (ej.: "B,17").

 

En la mayoría de los casos los Campos Id sólo están formados por un campo (campo Código). Si está formado por más campos (por ejemplo Serie, Código) los valores deben estar separados por comas.

 

Existen una serie de normas de formateo para rellenar los valores de los Campos Id que son de tipo cadena (por ejemplo el ID_ARTICULO que contiene la Referencia del Artículo):

 

1.Si el valor contiene espacios debe encerrarse entre comillas dobles (sin contar las que se visualizan en color azul en Internet Explorer). Ej.: Mesa Recta -> "Mesa Recta".

 

Formato campos ID en ficheros Xml para importar a OfiPro

 

2.Por cada comilla doble que contenga el campo debe sustituirse por 2 comillas dobles. Ej.: Televisor 21" -> "Televisor 21""" (observe que al final hay 3 comillas dobles, 2 son para sustituir la comilla doble original y una es porque la cadena contiene espacios).

 

Formato campos Id ficheros Xml para importar a OfiPro

 

3.Por último, si no existe ningún valor para el Campo ID (= null), dicho campo no se incluye en ese registro. Ej.: Como puede observar en las dos imágenes anteriores, en la primera debajo de ID_ARTICULO existen otros Campos Id como son ID_ARTICULO_FAMILIA, ID_ARTICULO_GAMA, etc., sin embargo en la segunda imagen dichos campos no existen porque para este registro éstos estaban a Null.

 

 

hmtoggle_plus1Identificadores Detalle-SubDetalle

 

Algunas tablas donde no tienen ningún índice (formado por uno o varios campos) que tenga valores únicos y que identifique cada elemento de la misma. Para este tipo de tablas se crea un índice especial que es de tipo numérico y que la relaciona con las otras tablas que dependan de ella. Por ejemplo "Líneas de Facturas de Venta" y "Líneas de Facturas de Ventas Propiedades" se relacionan mediante un valor numérico interno, un campo común que contiene el mismo valor para ambas tablas. Además de tener el mismo valor este debe ser negativo para que OfiPro considere que estamos realizando una nueva alta.

 

 

hmtoggle_plus1Otras Consideraciones

 

Los campos de tipo Fecha deben estar en el formato yyyyddmm (año día mes).

 

Los campos Numéricos con decimales debe utilizar el punto como separador decimal.

 

 

hmtoggle_plus1Listado de identificadores en Facturación

 

A continuación se describen todos los identificadores necesarios para cada Fichero.

 

A continuación se muestran los identificadores Detalle-SubDetalle cuyos valores deben ser negativos y pueden ser cualquiera mientras mantengan la correcta relación Detalle-SubDetalle

 

 

Fichero

Identificador

Valores

Agenda de tareas

ID_AGENDA_GESPRO

Tarea, Codigo_Usuario, Codigo_Cliente, Fecha_Alta

Agentes

ID_AGENTE

Codigo

Albaranes de compra

ID_ALBARAN_COMPRA

Serie,Codigo,Codigo_Proveedor

Albaranes de venta

ID_ALBARAN_VENTA

Serie,Codigo

Almacenes

ID_ALMACEN

Codigo

Almacenes de origen

ID_ALMACEN_ORIGEN

Codigo

Almacenes de destino

ID_ALMACEN_DESTINO

Codigo

Articulos

ID_ARTICULO

Referencia

Articulos Hijo

ID_ARTICULO_HIJO

Referencia

Asistencias de Clientes

ID_CLIENTE_ASISTENCIA

Codigo

Asistencias de Proveedores

ID_PROVEEDOR_ASISTENCIA

Codigo

Bancos

ID_BANCO

Codigo

Cajas registradores

ID_REGISTRADORA

Codigo

Categorías de Incidencias

ID_INCIDENCIA_CATEGORIA

Codigo

Categorías de Sugerencias

ID_SUGERENCIA_CATEGORIA

Codigo

Clases de Clientes

ID_CLIENTE_CLASE

Codigo

Clases de Proveedores

ID_PROVEEDOR_CLASE

Codigo

Clasificación de Incidencias

ID_INCIDENCIA_CLASIFICACION

Codigo

Clasificación de Sugerencias

ID_SUGERENCIA_CLASIFICACION

Codigo

Clientes

ID_CLIENTE

Codigo

Clientes Potenciales

ID_CLIENTE_POTENCIAL

Codigo

Cierres de Caja

ID_CAJA_CIERRE

IdCierre

Cobros

ID_COBRO

Codigo_Cliente, Codigo_Divisa,Codigo_Banco, Serie, Fecha_Cobro,Importe, Tipo_Documento, Numero_Documento

Tarifas de Comisión

ID_COMISION

Codigo

Compradores

ID_COMPRADOR

Codigo

Contacto de Bancos

ID_BANCO_CONTACTO

Codigo_Banco, Codigo_Contacto

Contacto de Clientes

ID_CLIENTE_CONTACTO

Codigo_Cliente, Codigo_Contacto

Contacto de Proveedores

ID_PROVEEDOR_CONTACTO

Codigo_Proveedor, Codigo_Contacto

Contacto de Transportistas

ID_TRASPORTISTA_CONTACTO

Codigo_Transportista, Codigo_Contacto

Contactos de Clientes Potenciales

ID_CLIENTE_POTENCIAL_CONTACTO

Codigo_ClientePotencial, Codigo_Contacto

Contratos

ID_CONTRATO

Serie, Codigo

Delegaciones

ID_DELEGACION

Codigo

Depositos

ID_DEPOSITO

Serie, Codigo

Divisas

ID_DIVISA

Codigo

Direcciones de envio

ID_DIRECCION

Codigo_Cliente,Codigo_Direccion

N/Empresas

ID_EMPRESA

Codigo

Ensamblajes de Kits

ID_ENSAMBLAJE

Serie, Codigo

Estado de Incidencias

ID_INCIDENCIA_ESTADO

Codigo

Estado de Sugerencias

ID_SUGERENCIA_ESTADO

Codigo

Familia de Articulos

ID_ARTICULO_FAMILIA

Codigo

Facturas de Compra

ID_FACTURA_COMPRA

Serie, Codigo, Codigo_Proveedor

Facturas de Venta

ID_FACTURA_VENTA

Serie, Codigo

Facturas de Origen de Compra

ID_FACTURA_ORIGEN_COMPRA

Serie_Factura_Origen, Codigo_Factura_Origen, Codigo_Proveedor

Facturas de Origen de Venta

ID_FACTURA_ORIGEN_VENTA

Serie_Factura_Origen, Codigo_Factura_Origen

Formas de Cobro

ID_FORMA_COBRO

Codigo

Formas de Pago

ID_FORMA_PAGO

Codigo

Gama de Articulos

ID_ARTICULO_GAMA

Codigo

Grupos de Agentes

ID_AGENTE_GRUPO

Codigo

Grupos de Articulos

ID_ARTICULO_GRUPO

Codigo

Grupos de Clientes

ID_CLIENTE_GRUPO

Codigo

Grupos de Compradores

ID_COMPRADOR_GRUPO

Codigo

Grupos de Proveedores

ID_PROVEEDOR_GRUPO

Codigo

Idiomas

ID_IDIOMA

Codigo

Incidencias

ID_INCIDENCIA

Codigo

Intercambios

ID_INTERCAMBIO

Serie, Codigo

Mandato

ID_MANDATO

Referencia_Unica

Tipos de IVA

ID_IVA

Tipo_Iva

Movimientos de Caja

ID_CAJA_MOVIMIENTO

Serie

Operaciones de Fabricacion

ID_OPERACION_FABRICACION

Codigo

Operarios

ID_OPERARIO

Codigo

Ordenes de Fabricacion

ID_ORDEN_FABRICACION

Serie, Codigo

Pagos

ID_PAGO

Codigo_Proveedor, Codigo_Divisa,Codigo_Banco, Serie, Fecha_Pago,Importe, Tipo_Documento,Numero_Documento

Partes de Trabajo

ID_PARTE_TRABAJO

Serie, Codigo

Pedidos de Compra

ID_PEDIDO_COMPRA

Serie, Codigo

Pedidos de Venta

ID_PEDIDO_VENTA

Serie, Codigo

Presupuestos de Compra

ID_PRESUPUESTO_COMPRA

Serie, Codigo

Presupuestos de Venta

ID_PRESUPUESTO_VENTA

Serie, Codigo

Prioridad de Incidencia

ID_INCIDENCIA_PRIORIDAD

Codigo

Prioridad de Sugerencia

ID_SUGERENCIA_PRIORIDAD

Codigo

Promociones

ID_PROMOCION

Codigo

Proformas de Compra

ID_PROFORMA_COMPRA

Serie, Codigo

Proformas de Venta

ID_PROFORMA_VENTA

Serie, Codigo

Propiedades de Artículos

ID_ARTICULO_PROPIEDAD

Codigo

Proveedores

ID_PROVEEDOR

Codigo

Regularizaciones

ID_REGULARIZACION

Serie, Codigo

Remesas

ID_REMESA

Serie, Codigo

Secciones de Articulos

ID_ARTICULO_SECCION

Codigo

Secciones de Personal

ID_PERSONAL_SECCION

Codigo

Series

ID_SERIE

Codigo

Sugerencias

ID_SUGERENCIA

Codigo

Sucursales

ID_SUCURSAL

Codigo_Proveedor, Codigo_Sucursal

Stocks

ID_STOCK

Referencia_Articulo, Codigo_Almacen

Terminales de TPV

ID_TERMINAL

Codigo

Tipos de Agentes

ID_AGENTE_TIPO

Codigo

Tipos de Articulos

ID_ARTICULO_TIPO

Codigo

Tipos de Clientes

ID_CLIENTE_TIPO

Codigo

Tipos de Compradores

ID_COMPRADOR_TIPO

Codigo

Tipos de Proveedor

ID_PROVEEDOR_TIPO

Codigo

Tiques

ID_TICKETS

Serie, Codigo

Transportistas

ID_TRANSPORTISTA

Codigo

Valores de Propiedades de Articulos

ID_ARTICULO_PROPIEDAD_VALOR

Referencia, Codigo

Vencimiento_Cobro

ID_VENCIMIENTO_COBRO

Serie, Codigo, Recibo

Vencimiento_Pago

ID_VENTIMIENTO_PAGO

Serie, Codigo, Codigo_Proveedor, Recibo

Zonas de Agentes

ID_AGENTE_ZONA

Codigo

Zonas de Clientes

ID_CLIENTE_ZONA

Codigo

Zonas de Compradores

ID_COMPRADOR_ZONA

Codigo

Zonas de Proveedores

ID_PROVEEDOR_ZONA

Codigo

 

 

A continuación se muestran los identificadores Detalle-SubDetalle cuyos valores deben ser negativos y pueden ser cualquiera mientras mantengan la correcta relación Detalle-SubDetalle

 

Fichero

Identificador

Valores

Componentes de Articulos

ID_ARTICULO_COMPONENTE

Entero negativo

Imágenes de Clientes

ID_CLIENTE_DOCUMENTO

Entero negativo

Imágenes de Proveedores

ID_PROVEEDOR_DOCUMENTO

Entero negativo

Imágenes de Mandatos        

ID_MANDATO_DOCUMENTO

Entero negativo

Lineas de Albaranes de Envio

ID_LINEA_ALBARAN_ENVIO

Entero negativo

Lineas de Albaranes de Compra

ID_LINEA_ALBARAN_COMPRA

Entero negativo

Lineas de Albaranes de Recepcion

ID_LINEA_ALBARAN_RECEPCION

Entero negativo

Lineas de Albaranes de Venta

ID_LINEA_ALBARAN_VENTA

Entero negativo

Lineas de Contrato

ID_LINEA_CONTRATO

Entero negativo

Lineas de Depositos

ID_LINEA_DEPOSITOS

Entero negativo

Lineas de Ensamblaje

ID_LINEA_ENSAMBLAJE

Entero negativo

Lineas de Facturas de Compra

ID_LINEA_FACTURA_COMPRA

Entero negativo

Lineas de Facturas de Venta

ID_LINEA_FACTURA_VENTA

Entero negativo

Lineas de Intercambios

ID_LINEA_INTERCAMBIOS

Entero negativo

Lineas de Ordenes de Fabricacion

ID_LINEA_ORDEN_FABRICACION

Entero negativo

Lineas de Pedidos de Compra

ID_LINEA_PEDIDO_COMPRA

Entero negativo

Lineas de Pedidos de Venta

ID_LINEA_PEDIDO_VENTA

Entero negativo

Lineas de Presupuestos de Compra

ID_LINEA_PRESUPUESTO_COMPRA

Entero negativo

Lineas de Presupuestos de Venta

ID_LINEA_PRESUPUESTO_VENTA

Entero negativo

Lineas de Proformas de Compra

ID_LINEA_PROFORMAS_COMPRA

Entero negativo

Lineas de Proformas de Venta

ID_LINEA_PROFORMA_VENTA

Entero negativo

Lineas de Regularizacion

ID_LINEA_REGULARIZACION

Entero negativo

Lineas de Tiques

ID_LINEA_TICKET

Entero negativo

 

 

hmtoggle_plus1Listado de identificadores en Contabilidad

 

Fichero

Identificador

Valores

Agenda de Tareas

 

ID_AGENDA_CONTAPRO

Tarea, Codigo_Usuario, Codigo_Cliente, Fecha_Alta

Asientos

ID_ASIENTO

Numero,Borrador

Asientos Periódicos

ID_ASIENTO_PERIODICO

Codigo

Asiento Predefinido

ID_ASIENTO_PREDEFINIDO

Codigo

Plan Contable

ID_CUENTA

Cuenta

Plan Contable (Proveedor)

ID_CUENTA_PROVEEDOR

Cuenta

Plan Contable (Dotación)

ID_CUENTA_DOTACION

Cuenta

Plan Contable (Amortizacion acumulada)

ID_CUENTA_AMORTIZACION_ACUM

Cuenta

Plan Contable (Cliente)

ID_CUENTA_CLIENTE

Cuenta

Plan Contable (Banco)

ID_CUENTA_BANCO

Cuenta

Plan Contable (Cliente / Proveedor RECC)

ID_CUENTA_CLI_PRO_RECC

Cuenta

Plan Contable (Contrapartida)

ID_CONTRAPARTIDA

Cuenta

Conceptos Tipo

ID_CONCEPTO_TIPO

Codigo

Configuracion del Plan

ID_CONFIGURACION_PLAN

Cuenta

Configuracion Fiscal

ID_CONFIGURACION_FISCAL

Clave

Causas de Baja de Inmovilizado

ID_INMOVILIZADO_CAUSA_BAJA

Codigo

Diarios de Importacion

ID_DIARIO_IMPORTACION

Codigo

Divisas

ID_DIVISA_CONTA

Codigo

Ejercicios

ID_EJERCICIO

Nombre

Grupos de Inmovilizados

ID_INMOVILIZADO_GRUPO

Codigo

Movimientos de caja

ID_CONTRAPARTIDA

Cuenta

Tipos de Inmovilizado

ID_INMOVILIZADO_TIPO

Codigo

Inmovilizados

ID_INMOVILIZADO

Codigo

Socios

ID_SOCIO

Codigo

Ratios financieros

ID_RATIO_FINANCIERO

Codigo

Modelo 130

ID_MODELO130

Ejercicio*,Periodo

Modelo 303

ID_MODELO303

Ejercicio*,Periodo

Modelo 340

ID_MODELO340

Ejercicio*,Periodo

Modelo 390

ID_MODELO390

Ejercicio*

Modelo 347

ID_MODELO347

Ejercicio*

Modelo 349

ID_MODELO349

Ejercicio*,Periodo

Modelo de Balance de Situación

ID_MODELO_BALANCE_SITUACION

Codigo

Modelo de Pérdidas y Ganancias

ID_MODELO_PYG

Codigo

Modelo ECPN IG

ID_MODELO_ECPN_IG

Codigo

Modelo ETCPN

ID_MODELO_ETCPN

Codigo

Modelo de Flujos de Efectivo

ID_MODELO_FLUJOS_EFECTIVO

Codigo

Movimientos de Caja

ID_CAJA_MOVIMIENTO_CONTA

Fecha_Movimiento, Concepto, Importe

Cajas

ID_CAJA_CONTA

Codigo

Vencimientos de Cobro

ID_VTO_COBRO_CONTA

Fecha Emision, Fecha Vencimiento, Cta Cliente, Cta Banco, Documento, Recibo, Concepto, Importe, Cobrado

Vencimientos de Pago

ID_VTO_PAGO_CONTA

Fecha Emision, Fecha Vencimiento, Cta Proveedor, Cta Banco, Documento, Recibo, Concepto, Importe, Pagado

* Indica el Año del Ejercicio, no su Nombre.

 

 

A continuación se muestran los identificadores Detalle-SubDetalle cuyos valores deben ser negativos y pueden ser cualquiera mientras mantengan la correcta relación Detalle-SubDetalle.

 

Fichero

Identificador

Valores

Apuntes

ID_APUNTE

Entero negativo

Apunte Periodico

ID_APUNTE_PERIODICO

Entero negativo

Apunte Predefinido

ID_APUNTE_PREDEFINIDO

Entero negativo

Cambio de Divisas

ID_DIVISA_CONTA_CAMBIO

Entero negativo

Imagen de Inmovilizado

ID_INMOVILIZADO_DOCUMENTO

Entero negativo

Libro de Registro Fras. Expedidas (Modelo 340)

ID_MODELO340_EXPEDIDA

Entero negativo

Libro de Registro Fras. Recibidas (Modelo 340)        

ID_MODELO340_RECIBIDA

Entero negativo

Libro de Registro Bienes Inversión (Modelo 340)

ID_MODELO340_INVERSION

Entero negativo

Libro de Registro Intracomunitarias (Modelo 340)

ID_MODELO340_INTRACOM

Entero negativo

Declarados (Modelo 347)

ID_MODELO347_DECLARADO

Entero negativo

Operadores (Modelo 349)

ID_MODELO349_OPERADOR

Entero negativo

Rectificaciones (Modelo 349)

ID_MODELO349_RECTIFICACION

Entero negativo

Líneas de Modelo de Balance de Situación

ID_MODELO_BALANCE_SIT_LIN

Entero negativo

Líneas de Modelo de Pérdidas y Ganancias

ID_MODELO_PYG_LIN

Entero negativo

Líneas de Modelos de ECPN IG

ID_MODELO_ECPN_IG_LIN

Entero negativo

Líneas de Modelos de ETCPN

ID_MODELO_ETCPN_LIN

Entero negativo

Líneas de Modelos de Flujos de Efectivo

ID_MODELO_FLUJOS_EFECTIVO_LIN

Entero negativo