Manual técnico de DropShipping -...
Transcript of Manual técnico de DropShipping -...
Manual técnico de DropShipping
Versión 1.90
2
Contenido Introducción .................................................................................................................................. 4
Proceso ...................................................................................................................................... 4
Funcionamiento vía Servicios Web ............................................................................................... 6
Introducción .............................................................................................................................. 6
La API ......................................................................................................................................... 7
Login ...................................................................................................................................... 7
Logout .................................................................................................................................... 7
ListaArticulos ......................................................................................................................... 7
Stock ...................................................................................................................................... 7
EnviaPedidos ......................................................................................................................... 7
ListaArticulosPaginando ........................................................................................................ 8
IncidenciasEntreFechas ......................................................................................................... 8
IncidenciasPorPedido ............................................................................................................ 8
ResuelveIncidencia ................................................................................................................ 9
PedidosEntreFechas .............................................................................................................. 9
Obtener Tracking ................................................................................................................... 9
Los Datos ................................................................................................................................. 10
ArticuloDTO ......................................................................................................................... 10
ArticuloStockDTO ................................................................................................................ 10
PedidoDTO .......................................................................................................................... 11
LineaPedidoDTO .................................................................................................................. 11
LineaPedidoCompletoDTO .................................................................................................. 11
DirecionDTO ........................................................................................................................ 12
ErroresImportacionDTO ...................................................................................................... 12
IncidenciaDTO ..................................................................................................................... 13
TrackingDTO ........................................................................................................................ 13
PedidoCompletoDTO ........................................................................................................... 14
Funcionamiento vía HTTP............................................................................................................ 15
Introducción ............................................................................................................................ 15
Uso detallado .......................................................................................................................... 15
URL Base .............................................................................................................................. 16
3
Listado de Artículos, operación “listadoarticulos” .............................................................. 16
Actualizar Stock, operación “actualizastock” ...................................................................... 16
Enviar Pedidos, operación “enviapedidos” ......................................................................... 17
Incidencias por Pedido, operación “incidenciasporpedido” ............................................... 17
Incidencias entre Fechas, operación “incidenciasentrefechas” .......................................... 18
Resolver Incidencia, operación “resuelveincidencia” ......................................................... 18
Estado de los Pedidos por Fechas, operación “estadopedidosporfechas” ......................... 18
Información de los Pedidos por Fechas, operación “pedidosentrefechas” ........................ 19
Obtener Tracking del pedido, operación “obtenertracking” .............................................. 19
Imagen del producto ........................................................................................................... 20
Funcionamiento vía Web ............................................................................................................ 21
Crear un pedido ....................................................................................................................... 21
Estructura interna del pedido ............................................................................................. 21
Ejemplo de pedido .................................................................................................................. 22
Crear un pedido con extensión “.txt” usando Microsoft Excel 2007 ...................................... 22
Crear un pedido con extensión “.csv” usando Microsoft Excel 2007 ..................................... 23
Mandar más de un pedido en el mismo archivo ..................................................................... 26
4
Introducción
El sistema de DropShipping de Nova Engel ofrece a sus clientes la posibilidad de efectuar
ventas al cliente final sin tener que preocuparse de tener un stock propio de productos. Nova
Engel se encarga de enviar los productos necesarios al cliente final mediante un transportista
serio y eficaz.
Nova Engel ofrece tres sistemas distintos para enviar y recibir información de sus clientes. Una
API utilizando servicios web (ideal para volúmenes no triviales de datos), una API auxiliar en
complemento de la primera vía http y una página web de soporte en la cual también se
pueden enviar pedidos y recibir los artículos.
Proceso
El proceso que se sigue viene resumido en la figura siguiente:
5
1. Login: Nos identifica en el sistema. Todos los clientes tienen un usuario y un password
que les permite acceder tanto a la web como a los servicios web.
2. Descargar Artículos: Permite actualizar los datos sobre los productos que ofrece Nova
Engel a sus clientes. Es conveniente descargar frecuentemente los artículos con los que
se trabaja, tanto para tener al día las novedades como para saber de qué stock se
dispone en cada momento.
3. Enviar Pedidos: Esta opción permite enviar a Nova Engel los pedidos necesarios que se
desean que se sirvan al cliente final. Cada pedido debe ser identificado por el cliente
de manera única. Por limitaciones del transportista los números de pedido deben ser
NUMÉRICOS.
4. Recibir Incidencias: Lamentablemente a veces nos podemos quedar sin stock, desde
recibir incidencias se notifica los pedidos que no se pueden servir tal como están. Es
importante señalar que esta información estará disponible después de que nuestro
departamento de facturación haya comprobado los pedidos que le han llegado.
5. Resolver Incidencias: Es posible indicar que hacer con los pedidos que no se pueden
servir tal cual, por ejemplo por una falta de stock. Se puede ordenar su cancelación o
bien el servirlos tal como están.
6. Logout: Desconectamos del sistema.
6
Funcionamiento vía Servicios Web
Introducción
Los servicios web están en la URL:
http://dropshipping.novaengel.com/Servicios/ServiciosCliente.svc?wsdl y están basados en
WS-BasicProfile 1.1 y SOAP 1.1 lo cual garantiza un alto nivel de compatibilidad con todo tipo
de sistemas. Algunas herramientas trabajan mejor o bien precisan de un formato de fichero
único y este se encuentra en
http://dropshipping.novaengel.com/Servicios/ServiciosCliente.svc?singleWsdl
En ambos casos el punto operacional utilizar es el mismo,
http://dropshipping.novaengel.com/Servicios/ServiciosCliente.svc
Por favor, tengan en cuenta que los datos que se obtengan están sujetos a cambios en
cualquier momento, por lo que depende de su sistema la actualización de los mismos.
7
La API
Los métodos que el servicio web expone se explican a continuación. La sintaxis exacta de
llamada depende totalmente de la plataforma desde la cual se llaman.
Login
Esta llamada nos identifica en el sistema. Acepta un nombre de usuario y un password. Si todo
funciona correctamente nos devuelve una cadena con un token que deberá utilizarse para
llamar al resto de métodos. Si por alguna razón falla nos devolverá nulo.
string Login(string usuario, string password)
Logout
Esta llamada invalida el token que estamos utilizando. No es imprescindible, pero si
aconsejable por motivos de seguridad.
void Logout(string token)
ListaArticulos
Esta llamada nos devuelve todos los artículos disponibles para el DropShipping en Nova Engel.
Para que funcione correctamente es preciso proporcionarle el token que previamente nos
habrá dado el Login.
IList<ArticuloDTO> ListaArticulos(string token)
Stock
Esta llamada nos devuelve el stock y precio de todos los artículos disponibles para el DropShipping. La información transmitida es la mínima por lo que es un método ideal para mantener actualizado el stock y los precios de los productos. IList<ArticuloStockDTO> Stock(string token)
EnviaPedidos
Nos permite notificar los pedidos que deseamos que Nova Engel sirva al cliente final. Acepta
como parámetros el token devuelto por el Login y una lista con los pedidos a servir. Devuelve
una lista con los errores al incorporar los pedidos.
IList<ErroresImportacionDTO> EnviaPedidos(string token, IList<PedidoDTO> pedidos)
8
ListaArticulosPaginando
Esta llamada nos devuelve una página de elementos de los artículos disponibles para el
DropShipping en Nova Engel. Para que funcione correctamente es preciso proporcionarle el
token que previamente nos habrá dado el Login, el número de página que queremos descargar
(empezando por la 0) y el número de elementos de cada página. En el momento que el
número de artículos devueltos sean inferiores a los elementos pedidos significa que hemos
descargado todos los datos.
public IList<ArticuloDTO> ListaArticulosPaginando(string token, int pagina, int elementos)
Si por ejemplo queremos descargar 50 elementos cada vez las llamadas serian algo como:
articulos = ListaArticulosPaginando(token, 0, 50)
articulos = ListaArticulosPaginando(token, 1, 50)
…….
Hasta que el número de artículos sea inferior a 50.
IncidenciasEntreFechas
Esta llamada nos permite conocer las incidencias que han ocurrido entre dos fechas. Acepta
como parámetros el token devuelto por el Login y un rango de fechas sobre las que efectuar la
consulta.
IList<IncidenciaDTO> IncidenciasEntreFechas(string token, DateTime inicio, DateTime final)
IncidenciasPorPedido
Esta llamada nos permite conocer las incidencias que han ocurrido en unos pedidos
determinados. Acepta como parámetros el token devuelto por el Login y una colección de
números de pedidos
IList<IncidenciaDTO> IncidenciasPorPedido(string token, IList<string> pedidos)
9
ResuelveIncidencia
Esta llamada permite indicar a NovaEngel que hacer en el caso de que un pedido tenga una
incidencia abierta. El pedido se puede cancelar o bien servir tal como está. Acepta como
parámetro el token devuelto por el Login, el número de pedido, la resolución y unas notas para
NovaEngel.
void ResuelveIncidencia(string token, string numeroPedido, ResolucionIncidencia resolucion, string notasIncidencia)
Donde ResolucionIncidencia { SinResolver = 0, CancelarPedido = 1, ServirPedido = 2 }
PedidosEntreFechas
Este método sirve para obtener los pedidos realizados entre dos fechas y conocer su estado
general.
IList<PedidoCompletoDTO> PedidosEntreFechas(string token, DateTime inicio, DateTime final, FiltroPedidos filtro)
Donde FiltroPedidos { Todos = 0, SinIncidencias = 1, ConIncidencias = 2 }
Obtener Tracking
Este método nos permite obtener toda la información disponible relacionada con la
localización de nuestros pedidos.
public IList<TrackingDTO> ObtenerTracking(string token, IList<string>
listPedidos)
10
Los Datos
A continuación se explican las estructuras de los objetos utilizados en las API previamente
mencionadas.
ArticuloDTO
Contiene la información sobre los productos con los que Nova Engel está trabajando. Su
formato es el siguiente:
public class ArticuloDTO {
public string[14] EAN { get; set; } public string[120] Descripcion { get; set; } public Sexo Sexo { get; set; } public decimal PVR { get; set; } public decimal Precio { get; set; } public int Stock { get; set; } public string[60] Marca { get; set; }
}
EAN: EAN13 correspondiente al producto.
Descripcion: Descripción del producto, incluyendo su contenido.
Sexo: Sexo al que va dirigido el producto. Puede ser Unisex, Femenino o Masculino.
PVR: Precio de venta recomendado para este producto. Es el precio que el fabricante del
mismo da como indicación.
Precio: Precio al que NovaEngel vende este producto.
Stock: Stock actual de NovaEngel
Marca: Nombre de la marca a la que pertenece el producto.
ArticuloStockDTO
Contiene la información sobre el stock y precios actuales de los productos con los que Nova
Engel está trabajando. Su formato es el siguiente:
public class ArticuloStockDTO {
public string[14] EAN { get; set; } public decimal Precio { get; set; } public int Stock { get; set; }
}
EAN: EAN13 correspondiente al producto.
Precio: Precio al que NovaEngel vende este producto.
Stock: Stock actual de NovaEngel
11
PedidoDTO
Contiene el pedido a enviar a NovaEngel. Su estructura es:
public class PedidoDTO {
public string[15] NumeroPedido { get; set; } public decimal Valoracion { get; set; } public string[max] NotasTransportista { get; set; } public IList<LineaPedidoDTO> Lineas { get; set; } public DireccionDTO DireccionEnvio { get; set; }
}
NumeroPedido: Es el número de pedido asignado por el cliente. Puede tener una
longitud máxima de 15. Debido a una limitación del transportista a la hora de escanear
códigos de barras deberá ser un código numérico.
NotasTransportista: Instrucciones para el transportista
Lineas: Colección de productos y cantidades a servir.
DireccionEnvio: Datos de la dirección a donde debe ir la mercancía.
Valoracion: Parámetro opcional con la valoración.
LineaPedidoDTO
Detalle de cada pedido. Indica el artículo y cantidad a servir. Su formato es el siguiente:
public class LineaPedidoDTO { public string[14] EAN { get; set; } public int Unidades { get; set; } }
EAN: EAN13 correspondiente al producto.
Unidades: Número de unidades a servir.
LineaPedidoCompletoDTO
Amplia la información obtenida en LineaPedidoDTO. Incluye el descuento y el precio asociado.
public class LineaPedidoCompletoDTO { public string EAN { get; set; } public int Unidades { get; set; } public decimal Precio { get; set; } public decimal Dto { get; set; } }
12
DirecionDTO
Dirección a la que se envía el pedido.
public class DireccionDTO { public string[100] Nombre { get; set; } public string[60] Calle { get; set; } public string[50] Poblacion { get; set; } public string[10] CP { get; set; } public string[50] Provincia { get; set; } public string[50] Pais { get; set; } public string[50] Telefono { get; set; } public string[50] Movil { get; set; } public string[50] Fax { get; set; } public string[100] EMail { get; set; } }
Nombre: Nombre y apellidos del receptor del envío.
Calle: Dirección del envío.
Población: Población de envío.
CP: Código postal.
Provincia: Provincia del envío.
Pais: País del envío en formato ISO-2, esto es España = ES
Telefono: Teléfono para que el transportista pueda comunicarse con la dirección de envío. Es opcional.
Movil: Teléfono móvil para que el transportista pueda comunicarse con la dirección de envío. Es opcional.
Fax: Fax del destinatario. Opcional
Email: Correo electrónico del destinatario. Es opcional, pero si esta hay transportistas que lo usan para el aviso del estado del envío.
ErroresImportacionDTO
Muestra información sobre los errores que se hayan producido al importar los pedidos. Su
formato es:
public class ErroresImportacionDTO { public string[15] NumeroPedido { get; set; }
public string Mensaje { get; set; } }
NumeroPedido: Número del pedido con problemas.
Mensaje: Mensaje de texto explicando la incidencia.
13
IncidenciaDTO
Indica las incidencias que pueda tener un pedido. La incidencia más común es sin duda una
rotura de stock.
public class IncidenciaDTO { public string[15] NumeroPedido { get; set; }
public string[14] EAN { get; set; } public string[max] DescripcionIncidencia { get; set; } public int Unidades { get; set; }
}
NumeroPedido: Número de pedido con la incidencia.
EAN: EAN13 correspondiente al producto.
DescripcionIncidencia: Explicación del tipo de incidencia.
Unidades: Unidades afectadas.
TrackingDTO
Indica la información relacionada con el seguimiento del envío del pedido .
public class TrackingDTO { public string[15] DocumentoCliente { get; set; } public string[40] Tracking { get; set; } public string[20] Expedicion { get; set; } public string[15] Transportista { get; set; } }
DocumentoCliente: Es el número de pedido asignado por el cliente. Puede tener una
longitud máxima de 15. Debido a una limitación del transportista a la hora de escanear
códigos de barras deberá ser un código numérico.
Tracking: Número de seguimiento que el transportista asigna al paquete.
Expedicion: Número de expedición del paquete en nuestro sistema.
Transportista: Transportista que realiza el envío.
14
PedidoCompletoDTO
Contiene el pedido después de ser enviado a Nova Engel. Su estructura es:
public class PedidoCompletoDTO { public string[15] NumeroPedido { get; set; } public string[15] Factura { get; set; } public DateTime FechaDocumento { get; set; } public decimal Bruto { get; set; } public decimal Dto1 { get; set; } public decimal ValorDto1 { get; set; } public decimal Dto2 { get; set; } public decimal ValorDto2 { get; set; } public decimal Cargo1 { get; set; } public decimal ValorCargo1 { get; set; } public decimal Cargo2 { get; set; } public decimal ValorCargo2 { get; set; } public decimal IVA { get; set; } public decimal ValorIVA { get; set; } public decimal Recargo { get; set; } public decimal ValorRecargo { get; set; } public decimal Total { get; set; } public int Cliente { get; set; } public string[max] NotasTransportista { get; set; } public byte Estado { get; set; } public decimal Valoracion { get; set; } public TrackingDTO InfoEnvio { get; set; } public IList<LineaPedidoCompletoDTO> Lineas { get; set; } public DireccionDTO DireccionEnvio { get; set; } public IList<IncidenciaDTO> Incidencias { get; set; } }
Estado puede tomar los valores: {Recibido = 0, EnEngel = 1, Facturado = 2, Enviado = 3, Incidencias = 4, Cancelado = 5}
15
Funcionamiento vía HTTP
Introducción
Es una manera alternativa de acceder a los métodos de la API principal por comandos lanzados
tanto con GET como POST.
Está pensada para ofrecer apoyo auxiliar a la API en caso de encontrar alguna dificultad con
ella, pero no la sustituye.
Para llamar a los métodos disponibles podemos usar un programa creado por nuestro
proveedor de servicios informáticos el cual trabaje a base de POST para obtener los
parámetros o podemos directamente mandar GET desde la URL teniendo en cuenta la
compatibilidad de caracteres. En este manual mostraremos la manera de llamar a los métodos
desde URL.
Las llamadas se realizarán con una codificación válida con el estándar http. Los resultados se
obtendrán en http estándar por web.
Uso detallado
Todas las llamadas se lanzan a
http://dropshipping.novaengel.com/servicios/dropshipping.ashx? añadiendo los parámetros
necesarios.
Cada parámetro está formado de la siguiente manera: “&parámetro=valor”.
Los parámetros principales son:
&usuario, identificador del usuario.
&password, contraseña del usuario.
&operacion, indica el método deseado.
Dependiendo de la operación encontraremos parámetros adicionales que definiremos más
adelante.
A modo de ejemplo usaremos un usuario llamado “CyP1420” con password “190706”
A continuación detallaremos como llamar a cada método mostrando un posible ejemplo de
uso.
16
URL Base
Siempre debe incluirse usuario y contraseña, por lo que el login viene implícito en todas las
llamadas. Además el usuario siempre incluirá la operación que desee realizar, por lo que la url
base será:
http://dropshipping.novaengel.com/servicios/dropshipping.ashx?&usuario=CyP1420&passwor
d=190706&operacion=
Listado de Artículos, operación “listadoarticulos”
Esta llamada nos devuelve todos los artículos disponibles para el DropShipping en Nova Engel.
Los datos obtenidos serán: CODIGO MARCA, REFERENCIA, EAN, DESCRIPCION, PVR, PRECIO,
STOCK, SEXO, NOMBRE MARCA.
http://dropshipping.novaengel.com/servicios/dropshipping.ashx?&usuario=CyP1420&passwor
d=190706&operacion=listadoarticulos
Si deseamos obtener una determinada marca (por ejemplo la 10) podemos incluir el
parámetro “&marca” de la siguiente manera
http://dropshipping.novaengel.com/servicios/dropshipping.ashx?&usuario=CyP1420&passwor
d=190706&operacion=listadoarticulos&marca=10
Actualizar Stock, operación “actualizastock”
Esta llamada nos devuelve los datos indispensables de todos los artículos disponibles para el
DropShipping. La información transmitida es la mínima por lo que es un método ideal para
mantener actualizado el stock y los precios de los productos.
Los datos obtenidos serán: EAN, PRECIO, STOCK.
http://dropshipping.novaengel.com/servicios/dropshipping.ashx?&usuario=CyP1420&passwor
d=190706&operacion=actualizastock
Si deseamos obtener una determinada marca (por ejemplo la 10) podemos incluir el
parámetro “&marca” de la siguiente manera
http://dropshipping.novaengel.com/servicios/dropshipping.ashx?&usuario=CyP1420&passwor
d=190706&operacion=actualizastock&marca=10
17
Enviar Pedidos, operación “enviapedidos”
Permite enviar los a que Nova Engel. Mediante el parámetro “&pedidos” se le suministrará los
pedidos deseados. La estructura es similar a la usada en el Funcionamiento vía Web y
usaremos de ejemplo los mismos datos que los usados en Ejemplo de Pedido.
Los datos del pedido pueden ser multilínea, pero si se desea crear la llamada en una sola línea
(para llamar desde URL por ejemplo) es posible igualmente incluir los datos del pedido y lo
mostraremos de ejemplo. Para cada salto de línea usaremos como sustituto una doble
virgulilla “~~”. Los caracteres deben tener una codificación válida con el estándar http.
http://dropshipping.novaengel.com/servicios/dropshipping.ashx?&usuario=CyP1420&passwor
d=190706&operacion=enviapedidos&pedidos=P%3B0000001240%3B%22Entregar%20antes%2
0de%20las%2015%3A30%2C%20lunes%20cerrado.%22~~A%3B0000001240%3B33515009804
00%3B2~~A%3B0000001240%3B3574896512004%3B1~~A%3B0000001240%3B300014597210
6%3B5~~D%3B0000001240%3B%22Ram%C3%B3n%20Delgado%20Gual%22%3B%22C%2F%20
Repozuelo%20N%C2%BA2%20Bajos%22%3B07008%3B%22Palma%20de%20Mallorca%22%3B
%22Baleares%22%3B%22Espa%C3%B1a%22%3B%3B646756842%3B%3B%22ramon%40empre
sa.com%22
Incidencias por Pedido, operación “incidenciasporpedido”
Esta llamada nos permite conocer las incidencias asociadas a pedidos determinados por el
parámetro “&pedidos”. Los pedidos pueden tener una estructura multilínea o usar como
sustituta la doble virgulilla “~~” para tenerlos en la misma línea.
Los datos obtenidos si se encuentran incidencias serán: Nº PEDIDO, EAN, DESCRIPCION
INCIDENCIA, UNIDADES AFECTADAS.
http://dropshipping.novaengel.com/servicios/dropshipping.ashx?&usuario=CyP1420&passwor
d=190706&operacion=incidenciasporpedido&pedidos=1001~~1002~~1003
18
Incidencias entre Fechas, operación “incidenciasentrefechas”
Esta llamada nos permite conocer todas las incidencias asociadas a todos los pedidos
encontrados entre la fecha inicial y la fecha final proporcionada (parámetros “&fechaini” y
“&fechafin” respectivamente). La fecha proporcionada tendrá estructura yyyy,mm,dd
haciendo referencia a año, mes y día.
Los datos obtenidos si se encuentran incidencias serán: Nº PEDIDO, EAN, DESCRIPCION
INCIDENCIA, UNIDADES AFECTADAS.
http://dropshipping.novaengel.com/servicios/dropshipping.ashx?&usuario=CyP1420&passwor
d=190706&operacion=incidenciasentrefechas&fechaini=2010,10,20&fechafin=2011,01,25
Resolver Incidencia, operación “resuelveincidencia”
Esta llamada permite indicar a NovaEngel que hacer en el caso de que un pedido tenga una
incidencia abierta. Como parámetros obligatorios tenemos “&pedido” y “&resolucion” y como
opcional el parámetro “¬as”.
http://dropshipping.novaengel.com/servicios/dropshipping.ashx?&usuario=CyP1420&passwor
d=190706&operacion=resuelveincidencia&pedido=1001&resolucion=2¬as="sigan
adelante”
Estado de los Pedidos por Fechas, operación “estadopedidosporfechas”
Este método sirve para obtener los pedidos realizados entre dos fechas y conocer su estado
general. Como parámetros obligatorios tenemos las fechas de inicio y fin “&fechaini” y
“&fechafin” y como opcional el parámetro “&filtropedidos” que será “0” por defecto.
Donde &filtropedidos será un número (todos = 0, sin incidencias = 1, con incidencias = 2).
Los datos obtenidos serán: Nº PEDIDO, FECHA DOCUMENTO, ESTADO.
http://dropshipping.novaengel.com/servicios/dropshipping.ashx?&usuario=CyP1420&passwor
d=190706&operacion=estadopedidosporfechas&fechaini=2010,10,20&fechafin=2011,01,25
19
Información de los Pedidos por Fechas, operación “pedidosentrefechas”
Este método sirve para obtener los pedidos realizados entre dos fechas y obtener los datos
detallados. Como parámetros obligatorios tenemos las fechas de inicio y fin “&fechaini” y
“&fechafin” y como opcional el parámetro “&filtropedidos” que será “0” por defecto.
Donde &filtropedidos será un número (todos = 0, sin incidencias = 1, con incidencias = 2).
Los datos obtenidos serán la información del pedido, la información de las líneas del pedido y
las incidencias encontradas, se obtendrán los siguientes datos para cada uno de ellos:
Información de pedido: IDENTIFICADOR_P, Nº PEDIDO, FACTURA, FECHA DOCUMENTO,
BRUTO, DTO1, VALORDTO1, DTO2, VALORDTO2, CARGO1, VALORCARGO1, CARGO2,
VALORCARGO2, IVA, VALOR IVA, RECARGO, VALORRECARGO, TOTAL, CLIENTE,
NOTASTRANSPORTISTA, ESTADO, TRACKING, EXPEDICION, TRANSPORTISTA, VALORACION.
Información de líneas de pedido: IDENTIFICADOR_A, EAN, UNIDADES, PRECIO, DTO.
Información de incidencias: IDENTIFICADOR_I, EAN, UNIDADES, DESCIPCIONINCIDENCIA.
http://dropshipping.novaengel.com/servicios/dropshipping.ashx?&usuario=CyP1420&passwor
d=190706&operacion=pedidosentrefechas&fechaini=2010,10,20&fechafin=2011,01,25
Obtener Tracking del pedido, operación “obtenertracking”
Esta llamada permite obtener la información necesaria para proceder a la localización del
envío de nuestro pedido. Como parámetro obligatorio tenemos los pedidos a comprobar
“&pedidos”. Los pedidos pueden tener una estructura multilínea o usar como sustituta la
doble virgulilla “~~” para tenerlos en la misma línea.
Los datos obtenidos serán: PEDIDO CLIENTE, TRACKING, EXPEDICION, TRANSPORTISTA.
http://dropshipping.novaengel.com/servicios/dropshipping.ashx?&usuario=CyP1420&passwor
d=190706&operacion=obtenertracking&pedidos=1001~~1002~~1003
20
Imagen del producto
Esta llamada permite obtener la imagen asociada con un producto. Como parámetro
obligatorio hay que indicar el EAN del producto. El resultado de esta llamada es una
redirección a la imagen que estamos buscando.
Un ejemplo de la llamada podría ser la siguiente la cual muestra la imagen en cualquier
navegador:
http://dropshipping.novaengel.com/servicios/dropshipping.ashx?&usuario=CyP1420&passwor
d=190706&operacion=imagen&ean=4045787048926
21
Funcionamiento vía Web
La web se puede encontrar en la URL: http://dropshipping.novaengel.com/
Crear un pedido
Los pedidos pueden ser creados manualmente o utilizando un programa creado por su
proveedor de servicios informáticos. En cualquier caso el resultado final será un archivo con
extensión “.csv” o “.txt”.
Estructura interna del pedido
La estructura de un pedido es fija, cumple unos estándares ya fijados y deben mantenerse en
todo momento. Si desea no escribir nada en un campo obligatorio créelo vacío. Cada campo se
separará por punto y coma y se escribirá entrecomillado, no deben usarse comillas extras.
Un pedido consta de:
Una línea de pedido con cuatro campos:
1. Identificador de pedido: identifica un pedido, valor fijo "P".
2. Número de pedido: número (máximo 15 cifras) que identifica su pedido.
3. Notas de pedido: permite escribir un mensaje corto para el transportista.
4. Valoración: Parámetro opcional con la valoración.
Una o varias líneas de artículos con cuatro campos:
1. Identificador de artículo: identifica un artículo, valor fijo "A".
2. Número de pedido: número (máximo 15 cifras) que identifica su pedido.
3. EAN-13: código de referencia suministrado en la lista de productos.
4. Cantidad: número que indica el número de unidades solicitadas.
Una línea de dirección con doce campos:
1. Identificador de dirección: identifica una dirección, valor fijo "D".
2. Número de pedido: número (máximo 15 cifras y sólo dígitos) que identifica su
pedido.
3. Nombre completo.
4. Dirección.
5. Código Postal.
6. Población.
7. Provincia.
8. País (código ISO)
9. Teléfono (fijo)
10. Teléfono (móvil)
11. Fax
12. Email
22
Ejemplo de pedido
A continuación mostraremos como crear un pedido tanto en .txt como en .csv usando los
datos inventados siguientes:
Tenemos una empresa de perfumería donde usamos un sistema que me ordena mis pedidos
usando 10 cifras. Un cliente llamado Ramón que tiene una pequeña tienda me ha comprado
tres artículos. No tengo ni su teléfono fijo ni su fax y no usa valoraciones. Crearemos un nuevo
pedido:
Línea de pedido:
"P";"0000001240";"Entregar antes de las 15:30, lunes cerrado."
Líneas de artículos:
"A";"0000001240";"3351500980400";"2"
"A";"0000001240";"3574896512004";"1"
"A";"0000001240";"3000145972106";"5"
Línea de dirección:
"D";"0000001240";"Ramón Delgado Gual";"C/ Repozuelo Nº2 Bajos";"07008";"Palma
de Mallorca";"Baleares";"ES";"";"646756842";"";"[email protected]"
Crear un pedido con extensión “.txt” usando Microsoft Excel 2007
Cree un archivo con extensión .txt. Usaremos para este caso “Demostracion.txt”.
23
Simplemente introducimos el texto de ejemplo línea a línea. El resultado es el siguiente:
Figura1
Crear un pedido con extensión “.csv” usando Microsoft Excel 2007
Abriremos una hoja de cálculo para crear el archivo que llamaremos para este caso
“Demostracion.csv”. Pulse F12 y guarde el archivo como se muestra en la Figura2.
24
Figura2
Si aparece un mensaje de advertencia tras guardar el archivo pulse “Aceptar”.
Si aparece de nuevo otro mensaje pulse “Si”.
25
Introduzca cada campo en una celda tal y como se refleja en la Figura3.
Figura3
Como se puede comprobar no es necesario entrecomillar los datos en Microsoft Excel 2007, ya
que el mismo se ocupa de darle el formato correcto tras ser guardado, pero debe recordarse
que los campos vacíos obligatoriamente deberán incluir "" para que el formato sea correcto.
Recomendamos usar el formato “Texto” al introducir los datos (marcado en rojo en la Figura3).
26
Mandar más de un pedido en el mismo archivo
En el caso de que desee realizar dos o más pedidos simplemente siga cumplimentando línea a
línea el archivo.
Ejemplo práctico:
Mi empresa vende en un mismo día a tres clientes diferentes. Mi sistema está preparado de
tal manera que me almacena los pedidos y al final del día me permite crear un archivo.csv para
tramitar los pedidos.
Así pues si los introduzco a mano lo haré línea a línea. Si mi proveedor de servicios
informáticos me ha creado un programa que automatiza la tarea ya estará listo. Como
resultado obtendremos la Figura4.
Figura4