Esteo - Importación de pedidos
Indice
Estructura del fichero
El fichero de importación de pedidos es un fichero ASCII desglosado en "líneas" o "registros" de longitud fija separados entre sí por un simple salto de línea, es decir, por los caracteres de control CR/LF (ASCII 13/10 ó HEX 0D/0A).

Cada línea o registro tiene una longitud total de 146 caracteres: 144 caracteres repartidos entre quince campos de longitud fija sin ningún tipo de separadores ni espacios entre ellos y los 2 caracteres del salto de línea. Esto implica que la longitud del fichero debe ser necesariamente múltiplo de 146 (ver nota 1).

Cada línea del fichero se corresponde con una línea de pedido y el programa las procesa de manera correlativa agrupando en un mismo pedido todas aquellas que tengan el mismo valor en el campo "Número de pedido". Así pues, todas las líneas del mismo pedido deben estar juntas en el fichero y se insertarán en el pedido en el mismo orden en que aparezcan en él.

El programa tomará como datos para la cabecera del pedido los de la primera línea que procese, despreciando el contenido de dichos campos en el resto de líneas salvo el campo "Número de pedido" que, como ya se ha dicho, produce el cierre del pedido en proceso y la apertura de uno nuevo al cambiar su valor de una línea a la siguiente. En su descripción indicaremos estos campos como "Dato de cabecera".

Cualquier error en el procesamiento de una línea producirá la omisión del pedido completo.

Notas:

  1. El programa acepta dos posibles longitudes para la descripción del artículo: 35 ó 60 caracteres. En este segundo caso, las posiciones de los siguientes campos de la tabla y la longitud total de la línea deben ser incrementadas en 25. El programa detecta automáticamente (buscando y posicionando el salto de línea) si el fichero utiliza 35 ó 60 caracteres para este campo, por lo que su uso es indistinto.
  2. Los pedidos se crearán siempre en la situación de confirmados.
  3. Se utilizará como forma de cobro la especificada en la ficha del cliente.
  4. En los artículos no codificados ('.') y abonos ('+'), la clasificación contable quedará en blanco y el precio medio a cero.
  5. El proceso redondeará el valor de las unidades, precio unitario, importe y comisión representante al número de decimales que les corresponda según la configuración y la moneda.
  6. El proceso no realizará comprobación alguna de que el importe de cada línea se corresponda con el resultado de operar las unidades, precio y descuento aplicado.
  7. Si el campo 'Descripción del artículo' comienza con un interrogante ('?'), el programa utilizará la descripción que figura en la ficha del artículo (versión 1.11).
  8. Si el campo 'Descuento línea' comienza con un interrogante ('?'), el programa hará caso omiso de los campos precio, descuento, importe, iva incluido y comisión aplicables, obteniéndolos de las tarifas correspondientes. (versión 1.11).
Descripción de los campos
A continuación se describen los campos de cada línea:
Campo Pos. Lon. Descripción
Número de pedido 1 8 Este valor se utilizará para crear el pedido y debe tener exactamente el mismo formato que exige Esteo, es decir, 8 caracteres de longitud: el primero indica la serie y puede ser un cero o una letra mayúscula de la 'A' a la 'Z' (no la 'Ñ') y los siete restantes deben ser dígitos numéricos del '0' al '9'. Ejemplo: "B0006428"
Fecha del pedido 9 8 Dato de cabecera obligatorio. Formato 'dd?mm?aa' con cualquier separador. Los años menores de 40 se asumirán mayores de 2000. Ejemplos: "12-05-98" es el 12 de Mayo de 1998; "31 12 02" es el 31 de Diciembre de 2002
Código del cliente 17 10 Dato de cabecera. El código del cliente completo con prefijo y rellenado con espacios por la derecha si es necesario. No se aceptan códigos en blanco o inexistentes. Ejemplo: "43000453 "
Código del representante 27 10 Dato de cabecera. El código del representante completo con prefijo y rellenado con espacios por la derecha si es necesario. Se aceptan códigos en blanco pero no códigos inexistentes. Ejemplo: "41000129 "
Código del almacén 37 2 Dato de cabecera. El código del almacén completo con dos dígitos numéricos. Si el campo está en blanco se asumirá el almacén "00". Ejemplo: "03"
Código del artículo 39 16 El código completo del artículo rellenado con espacios por la derecha si es necesario. Se aceptan códigos en blanco (comentarios), que comiencen por '.' (no codificados) ó por '+' (cargos/abonos), pero no códigos inexistentes
Descripción del artículo 55 35 (ó 60) Campo de contenido libre que se traspasará integramente al texto correspondiente de la línea del pedido. ver notas 1 y 7
Unidades 90 12 El número de unidades sin separadores en los miles y separando los decimales con un punto si procede. Debe rellenarse con blancos a la izquierda o a la derecha indistintamente. Un valor en blanco se interpretará como cero. En el caso de líneas de comentario (blanco) o de abono ('+') debe valer cero. Ejemplo: "1456.12 "
Precio unitario 102 12 El precio por unidad sin separadores en los miles y separando los decimales con un punto si procede. Debe rellenarse con blancos a la izquierda o a la derecha indistintamente. Un valor en blanco se interpretará como cero. En el caso de líneas de comentario (blanco) o de abono ('+') debe valer cero. Ejemplo: "234600 "
Descuento línea 114 8 El valor del descuento con el mismo formato que exige Esteo. Se admiten, como en Esteo, descuentos múltiples y debe ser rellenado con espacios por la derecha. Ver notas. Ejemplo: "15+2 "
Importe línea 122 12 El importe de la línea sin separadores en los miles y separando los decimales con un punto si procede. Debe rellenarse con blancos a la izquierda o a la derecha indistintamente. Un valor en blanco se interpretará como cero. En el caso de líneas de comentario (blanco) debe valer cero. Ejemplo: "2137600 "
Tipo de IVA 134 3 El tipo de IVA de la tabla a aplicar, rellenado con blancos a la izquierda o a la derecha indistintamente. Un valor en blanco se interpretará como cero. El valor de este campo es el valor interno de Esteo, que varía de 0 a 9 en lugar de 1 a 10, es decir, uno menos que la presentación del programa al usuario. Ejemplo: "0 "
IVA incluido 137 1 Indicador de IVA incluido en el precio. Debe valer "S" (por IVA incluido si) ó "N" (por IVA incluido no) y en mayúsculas. Ejemplo: "S"
Comisión del representante 138 6 El porcentaje de comisión del representante para la línea separando los decimales con un punto si procede. Debe rellenarse con blancos a la izquierda o a la derecha indistintamente. Un valor en blanco se interpretará como cero. En el caso de líneas de comentario (blanco) debe valer cero. Ejemplo: "4.2 "
Reserva 144 1 Sin uso actualmente. Debe dejarse en blanco.
Salto de línea 145 2 Espacio que alberga los caracteres del salto de línea. Obligatoriamente los valores 13 y 10 (0x0d y 0x0a hexadecimal)