WebService v3.0 para Consultas y Pedidos

Esta versión 3.0 incorpora nuevas funcionalidades además de mejorar las que ya tenía.


Para consumir el servicio utilice los siguientes descriptores en Producción


Descriptores XML Funcionales
//ramos30.suizoargentina.com.ar/webservice/wspedidos2.wsdl

Descriptores ASMX Funcionales
//ramos30.suizoargentina.com.ar/webservicenet/wspedidos.asmx


Para realizar pruebas en modo Desarrollo


Descriptores XML Funcionales
http://pruebas.suizoargentina.com.ar/webservice/wspedidos2.wsdl

Descriptores ASMX Funcionales
http://pruebas.suizoargentina.com.ar/webservicenet/wspedidos.asmx


Dada la variedad de lenguajes de programación que pueden consumir Servicios Web y habiendo encontrado algunas irregularidades es que recomendamos que para el correcto consumo del servicio se respete el uso de mayúsculas y minúsculas en la escritura de cada llamada, tal como se describen más adelante.

Todas las pruebas deben realizarse indefectiblemente sobre el servicio destinado para tal fin utilizando el Descriptor XML o ASP para Modalidad Desarrollo y especificando los siguientes datos para los parámetros
tnEmpresa, tcUsuario y tcClave
Ejemplo: tnEmpresa: 1 ó 2 tcUsuario: webservice tcClave: 123456


Para trabajar con el Descriptor XML o ASMX Funcional usted puede utilizar el usuario y clave con los que habitualmente ingresa en nuestra página web y haciendo referencia a la sucursal correspondiente (Vea el método VerSucursales para más información)

Puede realizar pruebas de llamadas a los métodos del servicio y ver las respuestas en formato XML directamente desde su navegador a través del descriptor ASMX para Modalidad Desarrollo.

Pueden presentarse 2 tipos de errores al intentar contactar el servicio: Errores de Conectividad y Errores de Funcionamiento.

Los Errores de Conectividad originan mensajes propios del SOAP o HTTP. Generalmente vienen acompañados de una breve descripción de la falla.

Los Errores de Funcionamiento están originados porque algún parámetro no era del tipo esperado, no se recibió la estructura esperada en un archivo XML, la cuenta no está en estado Normal, etc. Esto da como resultado SIEMPRE un archivo XML con un solo campo denominado ‘descripcion’ que contiene el detalle del error y las posibles alternativas para su solución

Llamadas Disponibles en el Servicio

HolaMundo

Propósito: Pensado solo para hacer pruebas de conectividad durante la programación de un cliente del servicio.
Parámetros: Ninguno.

VerSucursales

Propósito: Devuelve los códigos de las sucursales disponibles para trabajar con el servicio.
Parámetros: Ninguno.

VerCodigosDeErrorEnPedido

Propósito: Conocer el significado del código de error devuelto en cada línea de un pedido.
Parámetros: Ninguno.

ValidarUsuario

Propósito:Valida si el usuario y la clave son correctos para la sucursal especificada. Si bien no es necesario ejecutar esta llamada antes que cualquier otra, es conveniente para saber instantáneamente el estado de cuenta del cliente asociado al usuario.
Parámetros: tnEmpresa As Integer, tcUsuario As Character, tcClave As Character.
Ejemplo Llamada: ValidarUsuario(1, “webservice”, “123456”)
Respuesta: Cadena XML.

Dato Tipo Inicio Fin Longitud
Número de Cuenta Numérico 1 6 6
Nombre de la Cuenta Caracter 7 31 25
Estado Numérico 32 33 2
Descripción de Estado Caracter 34 63 30


Pedido

Propósito: Envía un archivo de pedido en formato XML y recibe una respuesta en el mismo formato.
Parámetros: tnEmpresa As Integer, tcUsuario As Character, tcClave As Character, tcPedidoXML As Character, tnFormato As Integer, tcTipo As Character, tcEntrega As Character.

Valores posibles para tnFormato:
1: Código de Barras: La búsqueda del producto se realiza exclusivamente por el código de barras especificado para ese producto
2: Formato SIAF: en el campo referencia debe estar el código SIAF del producto ocupando los 7 primeros lugares en formato 9999999, relleno con ceros por la izquierda. Los 13 lugares restantes se ignoran. La búsqueda se realiza por este código y si el producto no pudiera ser localizado, se utilizaría recién entonces el código de barras
3: Formato Multicuenta: en el campo de referencia debe estar el Código Droguería del producto, ocupando los 7 primeros lugares en formato 9999999, relleno con ceros por la izquierda. Los 13 lugares restantes se ignoran. La búsqueda se realiza por este código y si el producto no pudiera ser localizado, se utilizaría recién entonces el código de barras. Este formato tiene la particularidad de que si bien envía sólo un archivo XML puede generar pedidos para distintas cuentas sin tener que cambiar el usuario. Hay que tener en cuenta que:

a. Todos los códigos de clientes especificados en el archivo deben pertenecer al mismo grupo.
b.El grupo lo rige el código de cliente especificado en el usuario con el que se autentica. NOTA: Si no sabe si sus cuentas están en un grupo, póngase en contacto con la administración de la sucursal correspondiente.
Valores posibles para tcTipo:
CONFIRMA el archivo XML pasado debe ser tomado como un pedido real.

Valores posibles para tcEntrega:
Fecha de entrega en formato dd/mm/aaaa . Especifica la fecha en la que se requiere que sean entregados los productos. Si no se la especifica se utiliza la fecha de hoy. No puede ser inferior a la fecha del día actual ni superior a la fecha actual más 15.
Formato 1 y 2 del archivo XML de pedido con esquema interno

Campo Tipo Longitud Descripción
Cod_Barra Numérico 13 Código de Barras
Cantidad Numérico 5 Cantidad pedida
Referencia Caracter 20 Código de producto del cliente

Formato 3 del archivo XML de pedido con esquema interno
Campo Tipo Longitud Descripción
Cod_Barra Numérico 13 Código de Barras
Cantidad Numérico 5 Cantidad pedida
Referencia Caracter 20 Código de producto del cliente
Cliente Numérico 7 Número de Cuenta Corriente

IMPORTANTE
Para confirmar un pedido, el estado de la cuenta debe ser 00 (Normal). Para una consulta no se contempla el estado de la cuenta.
Ejemplo Llamada: Pedido(1, “webservice”, “123456”, [CadenaXML], 1, “CONFIRMA”, “20/05/2007”)
Respuesta: Cadena XML.

Formato del archivo XML con esquema interno
Campo Tipo Longitud Descripción
Cod_Barra Numérico 14 Código de Barras
Referencia Caracter 20 Referencia recibida
Cantidad Numérico 5 Cantidad solicitada
Sugerido Numérico 5 Cantidad sugerida para comprar
Falta Numérico 5 Cantidad que no pudo ser enviada
NumError Numérico 1 Código de ERROR en esta línea del pedido
Descrip Carácter 40 Nombre del producto
Precio_Far Numérico 15,2 Precio farmacia $
Precio_Pub Numérico 15,2 Precio público $
IVA Numérico 5,2 Alícuota de IVA %
Oferta Numérico 6,2 Descuento %
Desc_Final Numérico 6,2 Descuento equivalente sobre público %
UniFactura Numérico 4 Unidades mínimas del Transfer
Bonifica Numérico 4 Unidades bonificadas
TipPrecio Caracter 1 Tipo de Precio 'D'roguería, 'F'armacia, 'P'úblico, Fi'J'o
Desto Numérico 7,2 Descuento de producto en Transfer $
Transfer Carácter 30 Descripción del Transfer
Codigo Numérico 7 Código Droguería (SIAF compatible)
Cliente Numérico 7 Número de Cuenta Corriente


IMPORTANTE
Cantidad en archivo de respuesta = Cantidad en archivo de pedido
Falta = Cantidad no disponible en stock.
Enviado= Cantidad – Falta
Los artículos de perfumería no tienen Precio Público



PedidoID

Propósito: Envía un archivo de pedido en formato XML y recibe una respuesta en el mismo formato y el ID del pedido web asociado.
Parámetros: tnEmpresa As Integer, tcUsuario As Character, tcClave As Character, tcPedidoXML As Character, tnFormato As Integer, tcTipo As Character, tcEntrega As Character.

Valores posibles para tnFormato:
1: Código de Barras: La búsqueda del producto se realiza exclusivamente por el código de barras especificado para ese producto
2: Formato SIAF: en el campo referencia debe estar el código SIAF del producto ocupando los 7 primeros lugares en formato 9999999, relleno con ceros por la izquierda. Los 13 lugares restantes se ignoran. La búsqueda se realiza por este código y si el producto no pudiera ser localizado, se utilizaría recién entonces el código de barras
3: Formato Multicuenta: en el campo de referencia debe estar el Código Droguería del producto, ocupando los 7 primeros lugares en formato 9999999, relleno con ceros por la izquierda. Los 13 lugares restantes se ignoran. La búsqueda se realiza por este código y si el producto no pudiera ser localizado, se utilizaría recién entonces el código de barras. Este formato tiene la particularidad de que si bien envía sólo un archivo XML puede generar pedidos para distintas cuentas sin tener que cambiar el usuario. Hay que tener en cuenta que:

a. Todos los códigos de clientes especificados en el archivo deben pertenecer al mismo grupo.
b.El grupo lo rige el código de cliente especificado en el usuario con el que se autentica. NOTA: Si no sabe si sus cuentas están en un grupo, póngase en contacto con la administración de la sucursal correspondiente.
Valores posibles para tcTipo:
CONFIRMA el archivo XML pasado debe ser tomado como un pedido real.

Valores posibles para tcEntrega:
Fecha de entrega en formato dd/mm/aaaa . Especifica la fecha en la que se requiere que sean entregados los productos. Si no se la especifica se utiliza la fecha de hoy. No puede ser inferior a la fecha del día actual ni superior a la fecha actual más 15.
Formato 1 y 2 del archivo XML de pedido con esquema interno

Campo Tipo Longitud Descripción
Cod_Barra Numérico 13 Código de Barras
Cantidad Numérico 5 Cantidad pedida
Referencia Caracter 20 Código de producto del cliente

Formato 3 del archivo XML de pedido con esquema interno
Campo Tipo Longitud Descripción
Cod_Barra Numérico 13 Código de Barras
Cantidad Numérico 5 Cantidad pedida
Referencia Caracter 20 Código de producto del cliente
Cliente Numérico 7 Número de Cuenta Corriente

IMPORTANTE
Para confirmar un pedido, el estado de la cuenta debe ser 00 (Normal). Para una consulta no se contempla el estado de la cuenta.
Ejemplo Llamada: Pedido(1, “webservice”, “123456”, [CadenaXML], 1, “CONFIRMA”, “20/05/2007”)
Respuesta: Cadena XML.

Formato del archivo XML con esquema interno
Campo Tipo Longitud Descripción
Cod_Barra Numérico 14 Código de Barras
Referencia Caracter 20 Referencia recibida
Cantidad Numérico 5 Cantidad solicitada
Sugerido Numérico 5 Cantidad sugerida para comprar
Falta Numérico 5 Cantidad que no pudo ser enviada
NumError Numérico 1 Código de ERROR en esta línea del pedido
Descrip Carácter 40 Nombre del producto
Precio_Far Numérico 15,2 Precio farmacia $
Precio_Pub Numérico 15,2 Precio público $
IVA Numérico 5,2 Alícuota de IVA %
Oferta Numérico 6,2 Descuento %
Desc_Final Numérico 6,2 Descuento equivalente sobre público %
UniFactura Numérico 4 Unidades mínimas del Transfer
Bonifica Numérico 4 Unidades bonificadas
TipPrecio Caracter 1 Tipo de Precio 'D'roguería, 'F'armacia, 'P'úblico, Fi'J'o
Desto Numérico 7,2 Descuento de producto en Transfer $
Transfer Carácter 30 Descripción del Transfer
Codigo Numérico 7 Código Droguería (SIAF compatible)
Cliente Numérico 7 Número de Cuenta Corriente


IMPORTANTE
Cantidad en archivo de respuesta = Cantidad en archivo de pedido
Falta = Cantidad no disponible en stock.
Enviado= Cantidad – Falta
Los artículos de perfumería no tienen Precio Público



GetPedidosAsoc

Propósito:Realiza una consulta del pedido web asociado, para obtener los datos del mismo.
Parámetros: tnEmpresa As Integer, tcUsuario As Character, tcClave As Character, tcIdPedidoAsoc As Integer

Ejemplo Llamada: GetPedidosAsoc(“1”,“webservice”, “123456”, “1730”)
Respuesta: Cadena XML.

Campo Tipo Longitud Descripción
pedido_web Numérico 10 Pedido Web
pedido_asoc Numérico 10 Pedido Asociado Web
fecha Date 8 Fecha que ingreso el pedido a la web.
cliente Numérico 10 Código de cliente interno
sucursal Numérico 2 Código de Sucursal
articulo Numérico 7 Código interno de artículo
cod_Barra Numérico 13 Código de Barras
cantidad Numérico 4 Cantidad solicitada
falta Numérico 4 Faltas, productos sin stock
estado_web Numérico 4 Estado web del pedido
ingreso_suc Date 8 Fecha de ingreso del pedido en la sucursal



Facturas

Propósito: Consultar la facturación (incluye Facturas, Notas de Crédito y Notas de Débito) o percepciones de un periodo determinado.
Parámetros: tnEmpresa As Integer, tcUsuario As Character, tcClave As Character, tcGrupo As Character, tnCuenta As Integer, tcDesde As Character, tcHasta As Character, tcItems As Character.

Valores posibles para tcGrupo:
G: la información devuelta corresponde al grupo de cuentas al cual pertenece la cuenta asociada al usuario utilizado para la autenticación.
C: la información devuelta corresponde sólo a una cuenta; si no se especifica ningún código en tnCuenta, se toma la cuenta asociada al usuario utilizado para la autenticación. En caso de especificar tnCuenta, debe pertenecer al mismo grupo que la cuenta del usuario utilizado para la autenticación

Valores posibles para tcDesde y tcHasta:
Rango de fechas en formato dd/mm/aaaa. El rango de consulta no puede superar los 7 días.

Valores posibles para tcItems
F la información devuelta corresponde a las cabeceras de los comprobantes.
D la información devuelta corresponde al detalle de líneas que componen los comprobantes.
P la información devuelta corresponde al detalle de las percepciones de los comprobantes.

Formato del archivo XML de COMPROBANTES con esquema interno

Campo Tipo Longitud Descripción
Sucursal Integer 4 Código de sucursal donde se emitió el comprobante
Comprobante Caracter 3 Tipo de Comprobante
Letra Caracter 1 Letra del Comprobante
Terminal Integer 4 Punto de venta donde se emitió el comprobante
Numero Integer 4 Número del comprobante
Hojas Integer 4 Cantidad de hojas que componen el comprobante
Fecha Date 8 Fecha del comprobante
CtaCte Integer 4 Código de cliente en droguería
CliSuc Integer 4 Sucursal a la que pertenece el cliente
BrutoGrav Numérico 15,2 Importe Bruto Gravado $
BrutoNoGra Numérico 15,2 Importe Bruto NO Gravado $
Descuento Numérico 15,2 Descuento obtenido $
NetoGrav Numérico 15,2 Importe Neto Gravado $
IVARI Numérico 15,2 Importe IVA Resp. Inscripto $
PercIB Numérico 15,2 Importe Percepción Ing. Brutos $
PercIVA Numérico 15,2 Importe Percepción IVA
IInt Numérico 15,2 Importe Imp. Internos
NetoNoGrav Numérico 15,2 Importe Neto NO Gravado
Total Numérico 15,2 Importe Total del comprobante
Items Integer 4 Cantidad de ítems en el comprobante
Unidades Integer 4 Cantidad de unidades en el comprobante
CAI Numérico 16 CAEA del comprobante (originalmente CAI)
VtoCAI Date 8 Fecha de vencimiento del CAEA
MarNC Caracter 2 Tipo de nota de crédito/débito

Formato del archivo XML de DETALLE DE COMPROBANTES con esquema interno
Campo Tipo Longitud Descripción
CodBarra Numerico 15 Código de Barras del producto
CtaCte Integer 4 Código de cliente en droguería
CliSuc Integer 4 Sucursal a la que pertenece el cliente
Sucursal Integer 4 Código de sucursal donde se emitió el comprobante
Comprobante Caracter 3 Tipo de Comprobante
Letra Caracter 1 Letra del Comprobante
Terminal Integer 4 Punto de venta donde se emitió el comprobante
Numero Integer 4 Número del comprobante
Fecha Date 8 Fecha del comprobante
Hoja Integer 4 Hoja del comprobante en la que se encuentra el producto
Renglon Integer 4 Posición del producto dentro de la hoja
Articulo Integer 4 Código de producto según Droguería
Cantidad Integer 4 Cantidad facturada del producto
Descrip Caracter 60 Descripción del producto
Precio_L Numérico 15,2 Precio de Lista $ (Incluye IVA si el producto tiene IVA y letra=B)
IVA1 Numérico 15,2 IVA %
Referencia Caracter 20 (Uso Interno)
Lote Caracter 15 Lote (si corresponde)
VtoLote Date 8 Fecha de vencimiento del lote (si corresponde)
Precio_N2 Numérico 15,2 Precio neto unitario de la línea $(Incluye IVA si el producto tiene IVA y letra=B)
Pedido Integer 4 Número de Pedido en Droguería
PreFin Numérico 15,2 (Precio_L * Cantidad) – Dto $
ImpDesc Numérico 15,2 Igual a Dto $
SubTot Numérico 15,2 Precio_L * Cantidad $


Formato del archivo XML de DETALLE DE PERCEPCIONES con esquema interno
Campo Tipo Longitud Descripción
CtaCte Integer 4 Código de cliente en droguería
Comprobante Caracter 3 Tipo de Comprobante
Letra Caracter 1 Letra del Comprobante
Terminal Integer 4 Punto de venta donde se emitió el comprobante
Numero Integer 4 Número del comprobante
Fecha Date 8 Fecha del comprobante
CodJur Integer 4 Código de jurisdicción
Provincia Caracter 1 Código de Provincia
Importe Numérico 20,4 Importe Percibido $
BaseImp Numérico 20,4 Base Imponible
Porcentaje Numérico 10,4 Porcentaje Percibido
DescripFac Integer 25 Descripción de la Resolución de la percepción
PorExen Carácter 8,2 Porcentaje de Exención si lo hubiere %

Stock / Precio

Propósito:Realiza una consulta de stock y precios para el listado de articulos enviados, considerando cliente y sucursal. Permite un máximo de 500 articulos, separados por punto y coma (;).
Parámetros: tcUsuario As Character, tcClave As Character, tcTipo As Integer, tcArticulos As Character, tcCliente as Integer

Valores posibles para tcTipo:
0: Busca por todo (Código suizo, Codigo barra, Alfabeta, Siaf)
1: Solo por código interno suizo
2: Solo por código de barra
3: Solo por código Siaf
4: Solo por código Alfabeta

Ejemplo Llamada: Stock(“webservice”, “123456”, “0”, “26169;7793640000747”, “8000”)
Respuesta con resultados: Cadena XML.

Campo Tipo Longitud Descripción
Código Numérico 7 Código Droguería (SIAF compatible)
Cod_Barra Numérico 13 Código de Barras
Alfabeta Numérico 7 Alfabeta
Descrip Caracter 40 Nombre del producto
Precio_Pub Numérico 15,2 Precio público $
Precio_Far Numérico 15,2 Precio farmacia $
Oferta Numérico 6,2 Descuento %
Stock Caracter 5 Stock disponible. Valores posibles: Si, No, Pocos.


Respuesta sin resultados: Cadena XML.

Campo Tipo Longitud Descripción
Error Caracter 50 Detalle del error



Pruebas WS

Se puede usar SOAPUI para las pruebas, con la versión Open Source alcanza.









Suizo Argentina S.A. © 2005-2024 | Aviso de privacidad