WEB SERVICES DEL SISTEMA DE ADMINISTRACIÓN DE STOCK
Los servicios pueden ser accedidos desde http://bi.oca.com.ar:8100/ws/interfaz_ocastock.asmx
Como consideración general, cada uno de los métodos, debe ser accedido por SOAP utilizando HTTP POST y antes haber coordinado, con el área de Sistemas de OCA, los detalles de su implementación.
El mínimo de interfaces requeridas para una administración de stock automatizada, requieredeimplementar solo cinco métodos: interfazProveedores, interfazProductos, interfazModelos, interfazDestinos e interfazPedidos. Según las necesidades del servicio, las características de los productos y la información requerida por el cliente, requerirá la implementación delos métodos restantes.
Acontinuación, se detallan cada uno de los métodos y el orden en que se recomienda su implementación.
(Todos los métodos requieren tres parámetros idServicio, Usuario y Clave que son datos fijos que serán entregados por OCA. Estos sirven para identificar en forma clara y segura el servicio y la aplicación que esta intentando consumir el ws.)
Estos son los métodos disponibles para realizar pedidos, consultar ingresos,consultar el stock, productos,etc:
interfazProveedores
Parametros:
Entrada: Es un xml con los datos de los proveedores que deben darse de alta y/o modificarse.El primer elemento de este xmles “proveedores” y puede contener elementos “alta” y/o “modifica”, según se desee dar de alta un nuevo proveedor o bien modificar los datos de uno existente.
A su vez estos elementos puedentener los siguientes atributos:
| Atributo | Tipo | Largo | Comentario |
|---|---|---|---|
| idServicio | Entero | Es el IdServicio | |
| codProveedor | Texto | 20 | Identifica el proveedor |
| proveedor | Texto | 200 | Razón social del proveedor |
Ejemplo del parámetro entrada:
Respuesta de la interfazProveedores:
Siempre y cuando el método finalice en menos de 30 segundos, este responderá con un xml con el resultado.
El primer elemento es “entrada“, que contiene los elementos “errores” y “procesados”
“errores”:Por cada error contiene un elemento "proveedor” con el atributo codProveedor y dentro un elemento “error” con la descripción del error producido.
“procesados”:Por cada proveedor procesado en forma exitosa contiene un elemento “proveedor” con los atributos “idProveedor” y “codProveedor” y como valor la acción producida “alta” o “modifica”
Ejemplo de respuesta:
interfazProductos
Parametros:
Entrada: Es un xml con los datos de los productos que deben darse de alta, baja y/o modificarse.El primer elemento de este xml es “productos” y puede contener elementos “alta”, “baja”y/o “modifica”, según se desee dar de alta un nuevo producto, darlo de bajao bien modificar los datos de uno existente.
A su vez estos elementos puedentener los siguientes atributos:
| Atributo | Tipo | Largo | Comentario |
|---|---|---|---|
| idServicio | Entero | Es el IdServicio | |
| codProducto | Texto | 50 | Identifica el producto |
| producto | Texto | 200 | Descpripción del producto |
| Peso | Decimal | El peso en Kg. Es opcional | |
| trazabilidad | Texto | 255 | Solo utilizar cuando los productos deben ser identidicados en forma individual por ejemplo por "serie", esto permite tener una trazabilidad de cada prodcuto. Es opcional |
| esCombo | Booleano | Solo utilizar cuando el producto es un combo, luego utilizar "interfazCombos" y no utilizar "interfazModelos" | |
| fechaBaja | Fecha | fecha de baja del producto, formato AAAA.MM.DD |
Ejemplo del parámetro entrada:
Respuesta de la interfazProductos:
Siempre y cuando el método finalice en menos de 30 segundos, este responderá con un xml con el resultado.
El primer elemento es “entrada“, que contiene los elementos “errores” y “procesados”
“errores”:Por cada error contiene un elemento "producto” con el atributo codProducto y dentro un elemento “error” con la descripción del error producido.
“procesados”:Por cada producto procesado en forma exitosa contiene un elemento “producto” con los atributos “idProducto” y “codProducto” y como valor la acción producida “alta” o “modifica”
Ejemplo de respuesta:
interfazModelos
Parametros:
Entrada: Es un xml con los datos de los modelosque deben darse de alta, de baja y/o modificarse.
El primer elemento de este xml es “modelos” y puede contener elementos “alta”, “baja” y/o “modifica”, según se desee dar de alta un nuevo modelo, darlo de baja o bien modificarlos datos de uno existente.
A su vez estos elementos puedentener los siguientes atributos:
| Atributo | Tipo | Largo | Comentario |
|---|---|---|---|
| idServicio | Entero | Es el idServicio | |
| codProducto | Texto | 50 | Identificar el producto al cual pertenece el modelo |
| codProveedor | Texto | 200 | Identificar el proveedor al cual pertenece el modelo |
| codModelo | Texto | 50 | Identifica el modelo |
| modelo | Texto | 255 | Descripcion del modelo |
| fechaBaja | Fecha | Fecha de baja del modelo, formato AAAA.MM.DD |
Ejemplo del parámetro entrada:
Respuesta de la interfazModelos:
Siempre y cuando el método finalice en menos de 30 segundos, este responderá con un xml con el resultado.
El primer elemento es “entrada“, que contiene los elementos “errores” y “procesados”
“errores”:Por cada error contiene un elemento "modelo” con el atributo codModelo y dentro un elemento “error” con la descripción del error producido.
“procesados”:Por cada modelo procesado en forma exitosa contiene un elemento “modelo” con los atributos “idModelo” y “codModelo” y como valor la acción producida “alta” o “modifica”
Ejemplo de respuesta:
interfazDestinos
Parametros:
Entrada: Es un xml con los datos de los destinosque deben darse de altay/o modificarse.El primer elemento de este xml es “destinos” y puede contener elementos “alta”y/o “modifica”, según se desee dar de alta un nuevo destinoo bien modificar los datos de uno existente.
A su vez estos elementos puedentener los siguientes atributos:
| Atributo | Tipo | Largo | Comentario |
|---|---|---|---|
| idServicio | Entero | Es el idServicio | |
| codDestino | Texto | 20 | Identifica el destino |
| destino | Texto | 255 | Nombre del destinatario |
| idProvincia | Entero | Identifica la provincia (ver maestro de provincias) | |
| domicilio | Texto | 255 | Domicilio generalmente calle + número + piso + dpto |
| localidad | Fecha | Localidad de destino | |
| cp | Entero | Código postal (ver maestro de código postales) | |
| Texto | 300 | Mail del destinatario. Es opcional | |
| celular | Texto | 50 | Celular del destinatario. Es opcional |
| sigla | Texto | 3 | Solo utilizar en entregas en sucursal, Obtenida del WS de E-Pak. |
Ejemplo del parámetro entrada:
Respuesta de la interfazDestinos:
Siempre y cuando el método finalice en menos de 30 segundos, este responderá con un xml con el resultado.
El primer elementoes “entrada“, que contiene los elementos “errores” y “procesados”
“errores”:Por cada error contiene un elemento "destino” con el atributo codDestino y dentro un elemento “error” con la descripción del error producido.
“procesados”:Por cada destino procesado en forma exitosa contiene un elemento “destino” con los atributos “idDestino” y “codDestino” y como valor la acción producida “alta” o “modifica”
Ejemplo de respuesta:
interfazPedidos
Parametros:
Entrada: Es un xml con los datos de los pedidos que deben darse de alta.
El primer elemento de este xml es “pedidos” y debe contener uno o más elementos “alta”.Este elemento puede
tener
los siguientes atributos:
| Atributo | Tipo | Largo | Comentario |
|---|---|---|---|
| idServicio | Entero | Es el idServicio | |
| idOperativa | Entero | Identifica la operativa del pedido. Son valores fijos entregados por OCA | |
| codPedido | Texto | 20 | Identifica el pedido |
| codDestino | Texto | 20 | Identifica el destinatario, previamente informado en "interfazDestinos" |
A su vez el elemento “alta” debe contener el elemento “detallepedido” que deberácontener uno o más elementos
“producto” y este deberá tener los siguientes atributos:
| Atributo | Tipo | Largo | Comentario |
|---|---|---|---|
| codProducto | Texto | 50 | Es el código de producto, previamente informado en "interfazProductos" |
| cantidad | Entero | Cantidad del producto solicitado |
Ejemplo del parámetro entrada:
Respuesta de la interfazPedidos:
Siempre y cuando el método finalice en menos de 30 segundos, este responderá con un xml con el resultado.
El primer elemento es “entrada“, que contiene los elementos “errores” y “procesados”
“errores”:Por cada error contiene un elemento "pedido” con el atributo codPedido y dentro un elemento “error” con la descripción del error producido.
“procesados”:Por cada pedido procesado en forma exitosa contiene un elemento “pedido” con los atributos “idPedido”, “codPedido” e “idDestino” y como valor alta
Ejemplo de respuesta:
interfazProductosPrecios
Parametros:
Entrada: Es un xml con los datos de los precios que deben darse de alta.
El primer elemento de este xml es “productosPrecios” y puede contener elementos “alta”
A su vez este elemento puedetener los siguientes atributos:
| Atributo | Tipo | Largo | Comentario |
|---|---|---|---|
| idServicio | Entero | Es el idServicio | |
| codProducto | Texto | 50 | Es el código de producto, previamente informado en "interfazProducto" |
| precio | Decimal | Valor asegurado del producto. | |
| vigencia | Fecha | Fecha de baja del modelo, formato AAAA.MM.DD |
Ejemplo del parámetro entrada:
Respuesta de la interfazProductosPrecios:
Siempre y cuando el método finalice en menos de 30 segundos, este responderá con un xml con el resultado.
El primer elemento es “entrada“, que contiene los elementos “errores” y “procesados”
“errores”:Por cada error contiene un elemento "productosPrecios” con el atributo “codProducto”y dentro un elemento “error” con la descripción del error producido.
“procesados”:Por cada precio de productoprocesado en forma exitosa contiene un elemento “productosPrecios” con los atributos “codProducto”y“vigencia” y como valor alta
Ejemplo de respuesta:
interfazOrdenesCompra
Parametros:
Entrada: Es un xml con los datos de las ordenes de compra que deben darse de alta.El primer
elemento de este xml es “ordenesCompra” y debe contener uno o más elementos “alta”.Este elemento puede
tener los siguientes atributos:
| Atributo | Tipo | Largo | Comentario |
|---|---|---|---|
| idServicio | Entero | Es el idServicio | |
| oc | Texto | 20 | Identifica la orden de compra |
A su vez el elemento “alta” debe contener uno o más elementos“modelo” y este deberátener los siguientes atributos:
| Atributo | Tipo | Largo | Comentario |
|---|---|---|---|
| codModelo | Texto | 50 | Es el código de modelo, previamente informado en "interfazModelos" |
| cantidad | Entero | Cantidad del modelo que se podrá inresar en la planta |
Ejemplo del parámetro entrada:
Respuesta de la interfazOrdenesCompra
Siempre y cuando el método finalice en menos de 30 segundos, este responderá con un xml con el resultado.
El primer elemento es “entrada“, que contiene los elementos “errores” y “procesados”
“errores”:Por cada error contiene un elemento "ordenesCompra” con el atributo ocy dentro un elemento “error” con la descripción del error producido.
“procesados”:Por cada modelo procesado en forma exitosa contiene un elemento “ordenesCompra” con el atributo “oc” y como valor la acción producida “alta” o “modifica”
Ejemplo de respuesta:
interfazCombos
Parametros:
Entrada: Es un xml con los datos de los combosque deban darse de alta, nunca se modificará
ni eliminaráun combo.El primer elemento de este xml es “combos” y debe contener uno o más elementos
“combo”.Este elemento puede tener
los siguientes atributos:
| Atributo | Tipo | Largo | Comentario |
|---|---|---|---|
| idServicio | Entero | Es el idServicio | |
| codProducto | Texto | 50 | Es el código de producto, previamente informado en "interfazProductos" |
A su vez el elemento “combo” debe contener uno o más elementos “composicion” y este deberá tener los siguientes atributos:
| Atributo | Tipo | Largo | Comentario |
|---|---|---|---|
| codProducto | Texto | 50 | Es el código de producto, previamente informado en "interfazProductos" |
| cantidad | Entero | Cantidad de producto en el producto combo |
Ejemplo de parámetro entrada:
Respesta de la intefazCombos:
Siempre y cuando el método finalice en menos de 30 segundos, este responderá con un xml con el resultado.
El primer elemento es “entrada“, que contiene los elementos “errores” y “procesados”
“errores”:Por cada error contiene un elemento "combo” con el atributo “codProductoCombo” y dentro un elemento “error” con la descripción del error producido.
“procesados”:Por cada precio de comboprocesado en forma exitosa contiene un elemento “combo” con los atributos “codProductoCombo” y como valor alta
Ejemplo de respuesta:
interfazControlIngresos
Parametros:
Entrada: Es un xml con los datos de los ingresos que deban darsede alta, nunca se modificara ni eliminara un control de ingreso.
El primer elemento de este xml es “controlIngresos” y debe contener uno o más elementos “alta”. Este elemento
puede
tener los siguientes atributos:
| Atributo | Tipo | Largo | Comentario |
|---|---|---|---|
| idServicio | Entero | Es el idServicio | |
| oc | Texto | 20 | Identifica la orden de compra, previamente indormada en "interfazOrdenesCompra" |
A su vez el elemento “alta” debe contener uno o más elementos “modelo” y este deberá tener los siguientes atributos:
| Atributo | Tipo | Largo | Comentario |
|---|---|---|---|
| codModelo | Texto | 50 | Es el código de modelo, previamente informado en "interfazModelos" |
Solo para los casos de productos con trazabilidad por serie los modelos contienen elementos “serie”.
Ejemplo del parámetro entrada:
Respuesta de la interfazControlIngresos:
Siempre y cuando el método finalice en menos de 30 segundos, este responderá con un xml con el resultado.
El primer elemento es “entrada“, que contiene los elementos “errores” y “procesados”
“errores”:Por cada error contiene un elemento "controlIngresos” con el atributo ocy dentro un elemento “error” con la descripción del error producido.
“procesados”:Por cada modelo procesado en forma exitosa contiene un elemento “controlIngresos” con el atributo“oc” y como valor la acción producida “alta” o “modifica”
Ejemplo de respuesta:
Stock
El método devuelve el stock disponible, se recomienda utilizarlo una vez al día, luego del horario de corte de armado establecido con la operación.
El xmlcomienza con el elemento “stock” con elementos “producto”. Este elemento puede tener los siguientes atributos:
| Atributo | Tipo | Largo | Comentario |
|---|---|---|---|
| idProducto | Entero | Identificador interno de OCA del producto | |
| codProducto | Texto | 50 | Identifica el producto |
| producto | Texto | 255 | Descripción del producto |
| deposito | Texto | 50 | Nombre del deposito en el cual se encuentra |
A su vez el elemento “producto” contiene uno o más elementos “modelo” y este deberá tener los siguientes atributos:
| Atributo | Tipo | Largo | Comentario |
|---|---|---|---|
| idModelo | Entero | Identificador interno de OCA del modelo | |
| idProveedor | Entero | Identificador interno de OCA del proveedor | |
| codModelo | Texto | 50 | Es el código de modelo, previamente informado en "interfazModelos" |
| codProveedor | Texto | 20 | Es el código de proveedor, previamente informado en "interfazProveedores" |
| stock | Entero | Stock disponible actual |
Ejemplo de respuesta del método:
Ingresos
Parámetros:
FechaDesdeInclusive y FechaHastaNoInclusive: Son las fechas entre las que se desea ver los ingresos a OCA.
El método devuelve el stock disponible, se recomienda utilizarlo una vez al día, luego del horario de corte de armado establecido con la operación.
El xml comienza con el elemento “ingresos” con elementos “producto”. Este elemento tiene los siguientes atributos:
| Atributo | Tipo | Largo | Comentario |
|---|---|---|---|
| idProducto | Entero | Identificador interno de OCA del producto | |
| codProducto | Texto | 50 | Identifica el producto |
| producto | Texto | 255 | Descripción del producto |
Cada elemento “producto” contiene uno o más elementos “proveedor”.Este elemento tiene los siguientes atributos:
| Atributo | Tipo | Largo | Comentario |
|---|---|---|---|
| idProovedor | Entero | Identificador interno de OCA del proveedor | |
| codProveedor | Texto | 20 | Es el código de proveedor, previamente informado en "interfazProveedores" |
| proveedor | Texto | 200 | Proveedor |
A su vez el elemento “proveedor” contiene uno o más elementos “modelo” y este tienelos siguientes atributos:
| Atributo | Tipo | Largo | Comentario |
|---|---|---|---|
| idModelo | Entero | Identificador interno de OCA del modelo | |
| codModelo | Texto | 50 | Es el código de modelo, previamente informado en "interfazModelos" |
| modelo | Texto | 200 | Descripción del modelo |
| fechaIngreso | Fecha | Fecha de ingreso en OCA, formado AAAAMMDD | |
| cantidadIngresada | Entero | Cantidad ingresada a OCA |
Ejemplo de respuesta del método:
Pedidos
Parámetros:
FechaDesdeInclusive y FechaHastaNoInclusive: Son las fechas entre las que se desea ver los pedidos, sé recomienda utilizar como máximo una semana.
idEstadoPedido:Filtra los pedidos según el estado actual. Puede contener uno de los siguientes valores:
| idEstadoPedido | Estado |
|---|---|
| 0 | Muestra todos los pedidos sin importar el estado actual |
| 1 | Armado |
| 2 | Abierto |
| 3 | Solicitado |
| 4 | Confirmado |
| 5 | En paquetería |
| 6 | Reingresado a Stock |
| 7 | PreArmado |
El xml comienza con el elemento “pedidos” con elementos “pedido”. Este elemento tiene los siguientes atributos:
| Atributo | Tipo | Largo | Comentario |
|---|---|---|---|
| idPedido | Entero | Identificador interno de OCA del pedido | |
| codPedido | Texto | 20 | Identifica el pedido, previamente informado en "interfazPedidos" |
| fecha | Texto | Fecha del pedido, formato AAAA-MM-DDTHH:mm:ss.S | |
| estadoPedido | Texto | 255 | Estado actual del pedido, sí es "En paquetería" se pueden consultar estados mas detallados en el sistema E-Pak utilizando el CUIP |
| cuip | Entero | Es un número de 19 dígitos que identifica el envío en el sistema E-Pak | |
| nroRemito | Entero | Es el número de remito | |
| codDestino | Entero | Identifica el destino, previamente informado en "interfazDestinos" | |
| destino | Texto | 255 | Nombre del destinatario |
Cada elemento “pedido” contiene uno o más elementos “producto”.Este elemento tiene los siguientes atributos:
| Atributo | Tipo | Largo | Comentario |
|---|---|---|---|
| idProducto | Entero | Identificador interno de OCA del producto | |
| codProducto | Texto | 50 | Identifica el producto |
| producto | Texto | 255 | Descripción del producto |
| cantidad | Entero | Cantidad solicitada en el pedido |
Cada elemento “producto” contiene uno o más elementos “modelo”.Este elemento tiene los siguientes atributos:
| Atributo | Tipo | Largo | Comentario |
|---|---|---|---|
| idModelo | Entero | Identificador interno de OCA del modelo | |
| codModelo | Texto | 50 | Es el código de modelo, previamente informado en "interfazModelos" |
| modelo | Texto | 200 | Descripcion del modelo |
| cantidad | Entero | Cantidad solicitada en el pedido |
Solo para los casos de productos con trazabilidad por serie los modelos contienen elementos “serie”.
ObtenerRemitosAnulados
Parametros:
FechaDesdeInclusive y FechaHastaNoInclusive: Son las fechas entre las que se desea ver los pedidosanulados, sé recomienda utilizar como máximo una semana.
El xmlcomienza con el elemento “remitosAnulados” con elementos “ped”. Este elemento tiene los siguientes atributos:
| Atributo | Tipo | Largo | Comentario |
|---|---|---|---|
| idPedido | Entero | Identificador interno de OCA del pedido | |
| codPedido | Texto | 20 | Identifica el pedido, previamente informado en "interfazPedidos" |
| operativa | Entero | Identifica la operativa del pedido, Sovales fijos entregados por OCA | |
| nroRemito | Entero | Es el número de remito | |
| fecha | Fecha | Fecha en la que se anilo el pedido, formato AAAA-MM-DDTHH:mm:ss.S |
Ejemplo de respuesta del método:
interfazControlIngresoSalida
Parametros:
oc: Orden de compra que se desea consultar su ingreso en OCA
El xml comienza con el elemento “controlIngresosVuelta” con un elemento “alta” por cada ingreso realizado. Este elemento tiene los siguientes atributos:
| Atributo | Tipo | Largo | Comentario |
|---|---|---|---|
| idServicio | Entero | Es el idServicio | |
| oc | Texto | 20 | Identifica la orden de compra, previamente informada en "interfazOrdenesCompra" |
| nroRemitoIngreo | texto | 50 | Es el remito con el cual se realiza al ingreso a OCA |
Cada elemento “alta” contiene uno o más elementos “modelo”.Este elemento tiene los siguientes atributos:
| Atributo | Tipo | Largo | Comentario |
|---|---|---|---|
| codModelo | Texto | 50 | Es el código de modelo, previamente informado en "interfazModelos" |
| cantidadIngresada | Entero | Cantidad ingresada |
Solo para los casos de productos con trazabilidad por serie los modelos contienen elementos “serie”.
Ejemplo de respuesta del método:
Credenciales
Para obtener las credenciales y acceder a los webservices debes ponerte en contacto con nuestra area de sistemas. Lo podes solicitar en la siguiente casilla de correo: integraciones@oca.com.ar