Importación y exportación de documentos de venta en modo texto

Exportación e importación de documentos de venta en formato texto

Gestwin permite realizar la exportación e importación de movimientos de venta utilizando un formato simple de texto: CSV o valores delimitados por comas.

En total se utilizan 3 ficheros distintos, denominados Movimiento.txt, GrupoLineaMovimiento.txt y LineaMovimiento.txt. El proceso ha sido diseñado para realizar la transferencia únicamente de los datos contenidos en los propios movimientos, por lo que la información correspondiente a los ficheros relacionados con los mismos (datos de clientes, artículos, etc..) ya deben existir en la Empresa destino.

Su estructura es la siguiente :

Movimiento.txt

#	Nombre	Tipo	Tamaño	Descripción

1	Ejercicio	Entero	-	El ejercicio al que corresponde el movimiento
2	NroOperacion	Entero	-	Valor generado automáticamente por la aplicación y que sirve para identificar de forma inequívoca el documento. También se utiliza para relacionarlo con las líneas de detalle.
3	TipoMovimiento	Entero	-	Para movimientos de venta, su valor puede ser : Presupuestos = 13, Pedidos de venta = 14 y albaranes de venta = 15.
4	Propietario	Texto	5	El código del propietario del documento. En los documentos de venta es el código del cliente.
5	Serie	Texto	2	Un código de hasta 2 caracteres con el número de serie del documento.
6	NroDocumento	Entero	-	El número del documento.
7	UUID	Texto	-	Identificador único en formato UUID. Por ejemplo {4AD2299A-4020-4089-9CF6-2901797FBBED}. Si no se indica la aplicación asignará uno nuevo de forma automática.
8	Fecha	Fecha	10	La fecha del documento en formato DD/MM/AAAA.
9	FechaAplicacion	Fecha	10	En los pedidos, la fecha de entrega.
10	FechaEmision	Fecha	10	Uso interno (debe dejarse vacío)
11	FechaAuxiliar	Fecha	10	Uso interno (debe dejarse vacío)
12	GrupoFacturacion	Texto	3	El grupo del cliente o de facturación.
13	RegistroAuxiliar	Texto	3	Código del registro auxiliar.
14	CodigoVendedor	Texto	2	Código del vendedor.
15	CodigoOperario	Texto	5	Código del operario.
16	CentroCoste	Texto	3	Código del centro de coste.
17	FormaEnvio	Texto	3	Código de la forma de envío.
18	EjercicioFactura	Entero	-	Si el documento es un albarán y ha sido facturado, el ejercicio de la factura.
19	PropietarioFactura	Texto	-	Si el documento es un albarán y ha sido facturado, el código del propietario de la factura.
20	SerieFactura	Texto	-	Si el documento es un albarán y ha sido facturado, la serie de la factura.
21	NroFactura	Texto	-	Si el documento es un albarán y ha sido facturado, el número de la factura.
22	NoFacturar	Booleano	-	Indica que el documento es un albarán y que no debe ser facturado.
23	Facturado	Booleano	-	Indica que el documento es un albarán y que ha sido facturado.
24	Traspasado	Booleano	-	Indica que el documento es un albarán y que ha sido contabilizado o traspasado a la gestión contable.
25	Opcion	Entero	-	Uso interno (debe dejarse vacío)
26	Origen	Entero	-	Indica el origen del documento. Es de uso interno y debe pasarse un 0.
27	EjercicioOrigen	Entero		Indica el ejercicio del documento origen. Es de uso interno y debe pasarse un 0.
28	NroOperacionOrigen	Entero		Indica el número de operación del documento origen. Es de uso interno y debe pasarse un 0.
29	NroDocumentoPropietario	Texto	15	Un texto con la referencia a este documento indicado por el propietario del mismo.
30	EntregaACuenta	Decimal	16.2	En pedidos de venta y albaranes, el importe de las entregas a cuenta.
31	EntregaEfectivo	Decimal	16.2	En lo albaranes de venta (en concreto en los tickets del módulo de preventa), la entrega en efectivo.
32	CodigoTransportista	Texto	2	El código del transportista.
33	IVAIncluido	Booleano		Indica si el documento ha sido creado con la opción de IVA incluido activada
34	Portes	Decimal	16.2	En pedidos y albaranes, el importe de los portes.
35	CodigoFormaCobro	Texto	2	El código de la forma de cobro.
36	OrganismoPublico	Texto	12	En documentos que se puedan emitir mediante FACe, el código del organismo público. Este valor se indica finalmente en la factura, por lo que no es obligatorio.
37	Situacion	Entero	-	En los presupuestos el estado : 0 = Pendiente, 1 = Aceptado y 2 = Cancelado. En los pedidos, la situación : 0 = Pendiente, 1 = parcialmente servido y 2 = totalmente servido.
38	DescripcionMovimiento	Texto	30	Una descripción asociada al documento.
39	CampoLibre1	Texto	40	Un campo de libre configuración.
40	CampoLibre2	Texto	40	Un campo de libre configuración.
41	CampoLibre3	Texto	40	Un campo de libre configuración.
42	CampoLibre4	Texto	40	Un campo de libre configuración.
43	CampoLibre5	Texto	40	Un campo de libre configuración.
44	TipoVentaPeriodica	Entero	-	El código del tipo de venta periódica utilizado para generar el documento.
45	Creado	Fecha y hora	-	La fecha y hora de creación del documento, en formato DD/MM/AAAA HH:MM:SS. Por ejemplo '07/03/2017 10:36:21'.
46	Revisado	Booleano	-	Indica que el documento ha sido marcado como revisado (como todos los campos booleanos o lógicos el valor puede ser 'True' o 'False').
47	Suministrado	Booleano		Uso interno (debe dejarse vacío)
48	FechaEnvioPorCorreo	Fecha	-	Fecha de uso interno. Puede pasarse vacío.
49	Anotacion	Texto RTF o simple	-	Un texto de longitud indeterminada con una anotación asociada al documento. El contenido puede ser texto ordinario o RTF (formato de texto enriquecido).
50	Firma	Texto		Vacío (no se exportan los campos que contienen imágenes)

En el caso de campos de tipo texto, éstos SIEMPRE deben ir delimitados por comillas simples (') o dobles (").

Ejemplo:

2022,948,15,"00793","",656,{0121948C-21D5-409B-B953-6D6301BF58D7},20/04/2022,20/04/2022,19/10/2022,,"10","","","","","",0,"","",0,False,False,False,,0,,,"",,,"",False,,"12","",0,"","","","","","",,20/04/2022 17:56:27,False,False,,"",

GrupoLineaMovimiento.txt

Este fichero se utiliza si se ha activado el módulo de partidas presupuestarias (documentos paginados). Sin embargo es necesario que exista en todos los casos. Cuando el documento no tiene páginas se debe incluir un registro vacío con el número de página 0 (ver el ejemplo posterior).

#	Nombre	Tipo	Tamaño	Descripción

1	Ejercicio	Entero	-	Como en el documento, el ejercicio contable.
2	NroOperacion	Entero	-	El número de la operación. Este campo relaciona el registro de la página con el documento al que pertenece.
3	NroPagina	Entero	-	El número de la página, empezando desde 0.
4	CodigoGrupo	Texto	2	El código del grupo de la página.
5	Descripcion	Texto	30	La descripción de la página.
6	Anotacion	Texto	-	Un texto de longitud indeterminada en formato de texto plano o RTF.

Ejemplo:

2022,948,0,'','Página 1',''

LineaMovimiento.txt

#	Nombre	Tipo	Tamaño	Descripción

1	Ejercicio	Entero	-	El ejercicio al que pertenece el documento.
2	NroOperacion	Entero	-	El número de la operación del documento. Al igual que en las páginas, este valor relaciona la línea con el documento al que pertenece.
3	NroPagina	Entero	-	El número de página al que pertenece la línea. Como en el ejemplo, será siempre 0 si no se han activado los documentos paginados.
4	NroLinea	Entero	-	El número la línea. El valor debe estar comprendido entre 1 y 32767.
5	Fecha	Fecha	-	La fecha del registro. Coincide con la fecha del documento.
6	FechaAplicación	Fecha	.	En los pedidos, la fecha de entrega. Si no se utilizan fechas de entrega por línea, debe ser la misma que la de la cabecera,
7	FechaCaducidad	Fecha	-	En los albaranes, la fecha de caducidad. Solo se utiliza en el módulo de trazabilidad y si se tienen activados los lotes.
8	NroRegistro	Entero	-	Este valor identifica de forma exclusiva a la línea en el fichero. En el proceso de importación se ignora el contenido del campo y la aplicación genera un valor automático.
9	AsignacionOrigen	Entero	-	Método de asignación del documento origen. Los valores permitidos son : Manual o exportación/importación = 0, Número de serie = 1, Lote de fabricación = 2 y Lista de materiales = 3.
10	TipoMovimientoOrigen	Entero	-	El tipo del movimiento del cual procede esta línea (si no ha sido introducida manualmente por el usuario, en cuyo caso no se indica). Los valores habituales para los documentos de venta son : Reubicacion de carga = 2, Albarán de compra = 12, Presupuesto = 13 y Pedido de venta = 14.
11	EjercicioOrigen	Entero	-	El ejercicio del documento origen. Como en el campo anterior, si es una línea manual, se deja vacío.
12	NroOperacionOrigen	Entero	-	El número de operación del documento origen.
13	NroRegistroOrigen	Entero	-	El número de registro de la línea origen.
14	UIDArticulo	Texto	40	Un identificado exclusivo de la línea. El formato es el de un Identificador Global Único (GUID), y se utiliza para identificar a la línea en los procesos de trazabilidad, incluso entre distintas Empresas o equipos. Si no se indica ningún valor Gestwin generará uno de forma automática. El formato típico es el siguiente (ejemplo) : {1EF78F45-467E-4D69-9706-E692AFA64D40}.
15	CodigoArticulo	Texto	13	El código del artículo. En las líneas manuales se utiliza el valor '.' (un punto).
16	CodigoClaseA	Texto	3	Si están activadas las clases de artículos, el código de la primera clase.
17	CodigoClaseB	Texto	3	El código de la segunda clase.
18	CodigoClaseC	Texto	3	El código de la tercera clase.
19	LoteFabricacion	Texto	20	Si se utilizan lotes de fabricación, el de la línea.
20	NumeroSerie	Texto	20	El número de serie, si existe,
21	CampoLibre1	Texto	40	Un campo de libre configuración.
22	CampoLibre2	Texto	40	Un campo de libre configuración.
23	CampoLibre3	Fecha	-	Un campo de libre configuración.
24	CampoLibre4	Decimal	16.4	Un campo de libre configuración.
25	CampoLibre5	Texto	40	Un campo de libre configuración.
26	Descripcion	Texto	60	La descripción de la línea. Habitualmente la descripción del artículo, o un texto introducido manualmente por el usuario.
27	CodigoAlmacen	Texto	2	El código del almacén del que se extrae el material. En Empresas sin gestión de almacenes se utiliza el almacén genérico y se deja vacío.
28	Ubicacion	Texto	6	Dentro del almacén, la ubicación de la que se ha extraído el artículo (si existe).
29	Cantidad	Decimal	16.4	La cantidad (positiva para devoluciones y negativa para salidas de material).
30	CantidadAjustada	Decimal	16.4	En los documentos de venta la cantidad cambiada de signo (positiva para salidas y negativa para devoluciones o entradas). Este campo solo se utiliza en los procesos de edición para simplificar el tratamiento del dato, pero, aun así, debe ser indicado siempre.
31	CantidadProcesada	Decimal	16.4	En los pedidos de venta las cantidades servidas de la línea hasta el momento. No debe indicarse a no ser que se conozca perfectamente el funcionamiento de la aplicación y se sepa que existe un registro de venta que justifique la existencia de esta línea.
32	Procesada	Boolean	2	En los pedidos de venta indica si la línea ha sido completamente procesada, aún cuando la cantidad procesada no alcance la solicitada. Por defecto es False.
33	PrecioDivisa	Decimal	16.4	El precio de la línea expresado en la divisa o moneda del cliente (si existe).
34	Precio	Decimal	16.6	El precio unitario del artículo de la línea.
35	Recargo	Decimal	16.4	El recargo aplicado (€).
36	PuntoVerde	Decimal	16.4	El importe del punto verde o ecotasa (€).
37	Descuento	Decimal	16.2	El descuento de la línea (%). Por ejemplo, 10.50.
38	NroCajas	Decimal	16.0	El número de cajas. Solo se indica si el usuario tiene activadas las cajas en la aplicación.
39	Largo	Decimal	16.4	Indica las medidas del artículo. En este caso el largo.
40	Ancho	Decimal	16.4	El ancho del artículo.
41	Alto	Decimal	16.4	El alto del artículo.
42	Bultos	Decimal	16.0	El número de bultos de la línea.
43	ImporteRecargo	Decimal	16.4	El recargo expresado en Euros.
44	PorcentageRecargo	Decimal	16.4	El recargo expresado como porcentaje del importe bruto.
45	NoCalcularMargen	Booleano	-	En el cálculo de la rentabilidad del documento, indica que no se debe incluir esta línea.
46	TipoLinea	Texto	2	El código del tipo de la línea.
47	Oferta	Booleano	2	Indica que el precio de esta línea es una oferta (ver el mantenimiento de artículos).
48	PesoEnvase	Decimal	16.4	El peso del envase.
49	Tara	Decimal	16.4	La tara. Se utiliza, entre otros casos, en la gestión de envases.
50	Peso	Decimal	16.4	El peso total de los artículos incluídos en la línea.
51	ImporteBruto	Decimal	16.4	El importe bruto de la línea.
52	ImporteDescuento	Decimal	16.4	El importe de los descuentos de la línea.
53	ImporteNeto	Decimal	16.4	El importe neto de la línea.
54	CodigoTipoIVA	Entero	16.2	El código del tipo de I.V.A. de la línea extraído de la tabla de tipos existentes (1..12).
55	CuotaIVA	Decimal	16.4	El importe de la cuota del I.V.A.
56	CuotaRE	Decimal	16.4	El importe de la cuota del recargo de equivalencia (si el cliente está sujeto a él).
57	PrecioIVA	Decimal	16.2	El precio calculado con el I.V.A. incluído.
58	ImporteTotal	Decimal	16.4	El importe total de la línea, con todos los descuentos, recargos e impuestos incluídos.
59	Parametros	Texto	-	Uso interno. Debe pasarse vacío.
60	Anotacion	Texto	-	Un texto de longitud indeterminada en formato RFT o plano.

Los datos correspondientes al ImporteBruto, ImporteDescuento, ImporteNeto, CuotaIVA, CuotaRE, PrecioIVA e ImporteTotal no es necesario que se indiquen en los procesos de importación, puesto que son calculados por la aplicacion de acuerdo con el contenido de los registros de la Empresa. Se pueden pasar valores vacíos (0.0).

Ejemplo:

2022,948,0,1,20/04/2022,20/04/2022,,136474,0,,,,,{927E3A7B-37EA-4B20-A65D-CA156C9E0B36},"00210046","","","","90123435","6789","","2",,,"99","Usuario adicional (hosting)","","",0,0,0,False,0,0,0,0,0,0,0,0,0,,,,False,"",False,,,0,0,0,0,5,0,0,0,0,,""

Actualizado el 13 Diciembre 2022.