XML para gastos de envío

Transcripción

1 XML para gastos de envío El XML de gastos de envío replica la estructura de los gastos de envío tal como se utilizan en el Menú Personal de SoloStocks. Debe ser un archivo de XML independiente al fichero de productos. Desde el Menú Personal, apartado Configuración, se pueden crear los gastos con una configuración básica o bien avanzada. La diferencia entre una y otra es que la configuración avanzada permite crear rangos de precios, es decir, precios de gastos de envío que dependen de la cantidad de productos que se compran o bien del coste total del pedido. Ejemplo orientativo de gastos de envío en web:

2 El XML de gastos de envío sigue un solo modelo tanto para configuración básica como para avanzada. Los rangos de precio que se usan en configuración avanzada son un campo más que se utiliza de forma no obligatoria. Importante: Si los grupos de gastos de envío ya se han creado para la empresa desde el Menú Personal, no se debe confeccionar el XML de gastos de envío. Los ID de grupos de gastos de envío se solicitarán a SoloStocks a través del correo El archivo XML de gastos de envío debe ser accesible permanentemente a través de una dirección URL para su descarga automática. Asimismo, la estructura del XML debe responder con exactitud a la que se detalla a continuación. De otra forma, no será posible importar los productos a la web. Una vez terminado el XML, puedes descargar este archivo XSD para comprobar que su estructura es correcta. Información de apertura del XML de gastos de envío: - Encabezado: El fichero XML llevará el encabezamiento, con la versión de xml y el encoding o codificado. La codificación debe ser UTF-8, no es posible aplicar ninguna otra codificación. <?xml versión= 1.0 encoding= UTF-8?> - Shipping_info_details: Elemento raíz de todo el xml, es la tag que engloba todas las demás. <shipping_info_details> - Group: Elemento raíz del grupo de gastos de envío. Es el total de lo que se le asigna a un producto. Debe tener todas las opciones necesarias para un producto. Si son necesarios varios grupos de gastos de envío, se creará una etiqueta group para cada uno de ellos. <group> - Group Name: Nombre que se le da al grupo. No es visible para los usuarios, sólo utilizado por el vendedor para identificar cada grupo <group_name><![cdata[grupo de gastos de envío para textil]]></group_name> - Group Alias: Elemento utilizado para la relación del XML de productos con el XML de gastos de envío. Su valor es un identificador nuevo a elección de la empresa, que se incluirá después en el XML de productos con la etiqueta <TRANSPORT_OPTION>. <group_alias>3</group_alias> - Type: Elemento raíz, dentro de cada grupo, para cada tipo de gastos de envío. El tipo de gastos de envío son las opciones de envío que se eligen para los pedidos. Por ejemplo, los tipos se pueden referir a cada agencia de mensajería (correos, MRW), o se pueden usar para definir si el envío es urgente, ordinario Se pueden añadir en un grupo tantos tipos como sea necesario. <type>

3 - Type Name: Nombre que se le da al tipo. Es el nombre que ve el comprador a la hora de seleccionar el tipo de gastos de envío que desea para su pedido. < type_name><![cdata[mrw]]></type_name> - Geo Zone: Elemento raíz de la zona de envío. Las zonas de envío son territorios geográficos (provincias o grupos de zonas geográficas) que tienen sus propias posibilidades y condiciones de envío. Por tanto, se pueden repetir tantas <geo_zone> como sean necesarias si las condiciones para el envío cambian. < geo_zone> - Zones: Dentro de Geo Zone, es el elemento raíz que contiene la información de la zona a la que se refiere el tipo de envío. La zona puede especificarse con agrupaciones de zonas o bien por provincias. Para ello, se debe incluir una de estas dos subetiquetas: - Zone Group: Agrupaciones de provincias muy frecuentes, que evitan tener que nombrar cada una de las provincias que la componen por separado. Deben ser referidas con la nomenclatura de SoloStocks. Por el momento Ceuta, Melilla y Canarias no están disponibles como zonas de envío. <zones> <zone_group>755472</zone_group> </zones> Las agrupaciones existentes son: Península y Baleares Baleares Península - Zone: Si se opta por indicar provincias, cada etiqueta zone debe contener una provincia de envío. Para referirse a las provincias, es necesario usar la nomenclatura de SoloStocks. La lista de relaciones entre provincias y sus identificadores está disponible en el Fichero de provincias. <zones> <zone>19</zone> <zone>20</zone> <zone>16</zone> <zone>29</zone> <zone>31</zone> <zone>26</zone> </zones> - Shipping Time: Dentro de Geo Zone, es el elemento raíz para indicar las condiciones y precio de envío posibles en una zona geográfica. < shipping_time> - Time hours: Dentro de Shipping Time, es el tiempo de entrega indicado en horas correspondiente a las zonas especificadas. < time_hours>24</time_hours>

4 - Unit: Dentro de Shipping Time, es el elemento raíz para establecer precio del envío. Para un gasto de envío único, es necesario anidar la etiqueta <price> que indicará el valor del precio, y la etiqueta <applies_to>, que indica si el precio del envío es por cada unidad comprada o por el pedido completo. < price>10</price> - Price: Dentro de Unit. Elemento para establecer el precio de envío. Es un valor numérico solo, debe estar en euros y con decimales separados por puntos. No usar el punto como separador de miles ni fórmulas como o similar. < price>10</price> - Applies to: Subetiqueta de Unit. Elemento para establecer si el precio que se indica se aplica a la cantidad de productos comprados o al total del pedido. Es un campo con dos valores codificados por SoloStocks. Los valores a utilizar serán: 0 Precio de pedido 1 Unidades Etiquetas adicionales en Unit para gastos de envío con rangos (configuración avanzada) Para casos en los que el precio del envío varía según la cantidad comprada, se pueden añadir tantas etiquetas Unit como sean necesarias. Cada Unit corresponderá a un rango de precio, y para ello habrá que indicar como etiquetas anidadas: - Min: Dentro de Unit, indica el valor mínimo del rango al que aplica el precio del envío. < min>1</min> - Max: Dentro de Unit, es el elemento que indica el valor máximo del rango al que aplica el precio del envío < max>10</max> - Price: Dentro de Unit, es el elemento para establecer el precio de envío de cada rango de precios. Es un valor numérico solo, debe estar en euros y con decimales separados por puntos. No usar el punto como separador de miles ni fórmulas como o similar. < price>3</price> - Applies to: Elemento para establecer si el precio que se indica se aplica a la cantidad de productos comprados o al total del pedido. Es un campo con dos valores codificados por SoloStocks. Los valores a utilizar serán: 0 Precio de pedido 1 Unidades

5 Así, las etiquetas unit para configurar rangos de precio quedarían como en este ejemplo: <min>1</min> <max>10</max> < price>10</price> <min>11</min> <max>50</max> < price>7</price> <min>51</min> <max>0</max> < price>5</price> Etiquetas adicionales para grupos de gastos de envío con recogida en almacén Los productos que admiten la recogida por parte del comprador (sin envío), deberán indicar en su grupo de gasto de envío esta opción y la dirección a la que se puede acudir para retirar el pedido. Esta opción debe ser gratuita para el comprador, y se puede indicar en todos los grupos de gastos de envío que se desee. Recogida en almacén en el Menú Personal - Store: Anidada dentro del grupo de gastos de envío (group) es la etiqueta que contendrá toda la información de la recogida en tienda o almacén <store>

6 - Pickup: Dentro de store, sirve para definir si se admite la opción de recogida en almacén. Puede tener dos valores solo, YES si la recogida es posible y NO si se quiere desactivar esta opción. -YES -NO Así, si se desea retirar en algún momento la opción de recogida, basta con cambiar esta etiqueta a NO sin perder los demás datos. <pickup>yes</pickup> - Adress: Etiqueta para indicar la dirección donde se encuentra el almacén o tienda donde se retira el pedido. Indicar la vía, nombre de la misma, piso, puerta e información adicional sin población, provincia ni código postal, que irán en etiquetas adicionales. <address>avenida 1, planta 3 </address> - Town: Etiqueta para indicar la ciudad o población donde se ubica el almacén. <town>barcelona</town> - Province: Tag para especificar la provincia donde se ubica el almacén. Su valor debe estar indicado con la nomenclatura de SoloStocks. Se obtiene al descargar la relación de códigos y provincias en el Fichero de provincias. <province> 28</province> - Country: Indica el país donde se ubica el almacén, según la nomenclatura de SoloStocks. El código para España es el 67, que será el valor de este campo. <country>67 </country> - Postal: Es el código postal que corresponde a la dirección del almacén o tienda. <postal>08001</postal> - Notes: Es un campo adicional para añadir observaciones (indicaciones adicionales, un horario de apertura ). Se puede incluir CDATA para indicar que el contenido de este campo es texto. La extensión máxima para este campo son 900 caracteres. <notes>horario de recogida: de lunes a viernes de a y de a </notes> Así, la etiqueta store para configurar los datos de recogida en almacén quedarían así:: <shipping_info_details> <group> <group_name>grupo de gastos de envío para textil</group_name> <group_alias>3</group_alias> <store> <pickup>yes</pickup> <address>avenida Barcelona 2,4 1</address> <town>barcelona </town> <province>28</province> <country>67</country> <postal>08001</postal> <notes></notes> </store>

7 <type> [... ] </type> <type> [... ] </type> </group> </shipping_info> Para completar esta información, puedes ver un Ejemplo de XML de gastos de envío.