2014 09 05 Webservice Siimed

Descargar como pdf o txt
Descargar como pdf o txt
Está en la página 1de 35

WEBSERVICE SIIMED

V1.1.0

En este documento se describe el funcionamiento del


WebService proporcionado por SIIMED S.A.S. para la
obtencin e ingreso de informacin al Sistema SIIGO.NET.

Septiembre de 2014
Contenido
INTRODUCCION ................................................................................................................................... 3
INSTALACION ....................................................................................................................................... 3
Requisitos ........................................................................................................................................ 3
Configuracin .................................................................................................................................. 3
UTILIZACION DEL WEBSERVICE ........................................................................................................... 8
Servicios de consulta de informacin ............................................................................................. 8
ExisteTercero ............................................................................................................................... 8
ObtenerBodegas.......................................................................................................................... 9
ObtenerCartera ......................................................................................................................... 10
ObtenerCarteraTercero ............................................................................................................. 11
ObtenerCarteraDetalladaTercero ............................................................................................. 12
ObtenerCentrosDeCosto ........................................................................................................... 13
ObtenerCosto ............................................................................................................................ 14
ObtenerCuentas ........................................................................................................................ 15
ObtenerDocumentos................................................................................................................. 16
ObtenerFormasDePago ............................................................................................................. 17
ObtenerProductos ..................................................................................................................... 18
ObtenerSaldoInventario ............................................................................................................ 19
ObtenerTerceros ....................................................................................................................... 20
ObtenerVendedores .................................................................................................................. 21
ObtenerZonas ............................................................................................................................ 22
ObtenerMovimiento ................................................................................................................. 23
ObtenerExtracontable ............................................................................................................... 24
Servicios de Registro de Datos ...................................................................................................... 26
GuardarTercero ......................................................................................................................... 26
GuardarContable ....................................................................................................................... 28
AnularContable ......................................................................................................................... 32
GuardarExtracontable ............................................................................................................... 33

2
INTRODUCCION

Este documento es una gua para la utilizacin del WebService de SIIMED S.A.S. para la consulta y
registro de informacin en el Sistema SIIGO.NET. En primera instancia se muestra cmo se debe
configurar el WebService para su utilizacin. Luego se detallan los mtodos de consulta y
finalmente los mtodos para registrar informacin.

INSTALACION

Requisitos
- SIIGO.NET v5.2.26 o superior
- IIS 7.0 o superior
- 50 MB en DD
- 1 GB RAM o Superior (Dependiendo de la cantidad de usuarios que accedan
concurrentemente puede ser mayor)

Configuracin
Los pasos para Configurar el WebService son los siguientes:

1. Instale SIIGO.NET (v5.2 o superior) en el equipo en el cual va a quedar el WebService. Este


equipo puede ser el mismo servidor donde est alojado SQL Server, pero si va a tener
bastante carga de usuarios, se sugiere que se haga en un servidor individual que tenga
conexin con el servidor de SQL Server.

2. Instale IIS (v7.0 o superior) en el equipo en el cual instal SIIGO.NET. En este link
http://technet.microsoft.com/es-es/library/cc725762.aspx encuentra como hacer la
instalacin

3. En la carpeta de instalacin de SIIGO.NET (usualmente C:\Archivos de


Programa\Informtica & Gestin S.A\Siigo.NET) cree dos nuevas Carpetas Bin y Servicios.
En la carpeta Bin copie las dlls que estn en SIIGO.NET y adicionalmente el archivo
SIIGO.WebService.dll (provedo por SIIMED S.A.S.). Tambin copie el archivo SIIGO.cfg.

4. En la carpeta Servicios que cre, copie el archivo ServiciosSIIMED.asmx y en la Carpeta


SIIGO.NET copie el archivo Web.config. Estos archivos los provee SIIMED S.A.S.

5. Abra IIS y en Grupo de Aplicaciones cree una nueva aplicacin que se llame
WebServiceSIIMED

3
Por favor tener en cuenta que la versin del Framework de .NET debe ser la v4.0

NOTA: Si el servidor tiene arquitectura de 32 bits, abrir la configuracin avanzada y


habilitar la opcin correspondiente.

4
6. En el Sitio Web por Defecto (Default Web Site) Agregue un nuevo Directorio Virtual con los
siguientes datos:

5
Observe que la ruta fsica corresponde a la carpeta de instalacin de SIIGO.NET.

7. Convierta el directorio virtual en una Aplicacin Web, para lo cual debe seleccionar la
aplicacin creada en el punto 5.

6
8. Pruebe que el sitio Web est funcionando, para ello vaya a su navegador preferido y digite
la siguiente direccin http://localhost/SIIMEDWebService/Servicios/ServiciosSIIMED.asmx.
Debe mostrar algo semejante a lo siguiente:

7
UTILIZACION DEL WEBSERVICE
Mediante el WebService es posible realizar consultas y tambin ingresar alguna informacin a
SIIGO.NET. En trminos generales lo que se hace es ejecutar un mtodo que recibe unos
parmetros y siempre devuelve una respuesta. Los parmetros de entrada siempre deben indicar
la empresa a la cual se conectar, el ao, el mes y el da. La respuesta es un XML con la
informacin que retorne el servicio consultado.

Servicios de consulta de informacin


Para todos los servicios de consulta (empiezan con Obtener o Existe) siempre se debe pasar la
empresa a la cual se conectar, el ao, el mes y el da. Por ejemplo ObtenerZonas(1, 2013, 12, 31)
indica que se conectar a la empresa 1 en la fecha 2013/12/31.

A continuacin se detalla cada uno de los servicios de consulta ofrecidos.

ExisteTercero
Este servicio permite saber si existe un tercero en la base de datos de SIIGO.NET

Parmetros
NroEmpresa
Tipo: Entero
Nmero de empresa a conectarse.

8
AnoIngreso
Tipo: Entero
Ao de ingreso al Sistema.

MesIngreso
Tipo: Entero
Mes de ingreso al Sistema.

DiaIngreso
Tipo: Entero
Da de ingreso al Sistema.

Identificacion
Tipo: Entero Largo
Nmero de Identificacin del tercero a consultar.

Sucursal
Tipo: Entero
Nmero de Sucursal del tercero a consultar.

Valor devuelto
Tipo: XML
La respuesta en formato XML que contiene el siguiente esquema:

En caso que no exista el resultado es false.

ObtenerBodegas
Este servicio obtener todas las bodegas y sub bodegas parametrizadas en SIIGO.NET

Parmetros
NroEmpresa
Tipo: Entero
Nmero de empresa a conectarse.

AnoIngreso
Tipo: Entero
Ao de ingreso al Sistema.

MesIngreso
Tipo: Entero
Mes de ingreso al Sistema.

DiaIngreso
Tipo: Entero
Da de ingreso al Sistema.

9
Valor devuelto
Tipo: XML
La respuesta en formato XML que contiene el siguiente esquema:

ObtenerCartera
Este servicio permite obtener toda la cartera que existe en SIIGO.NET en la empresa solicitada.

Parmetros
NroEmpresa
Tipo: Entero
Nmero de empresa a conectarse.

AnoIngreso
Tipo: Entero
Ao de ingreso al Sistema.

MesIngreso
Tipo: Entero
Mes de ingreso al Sistema.

DiaIngreso

10
Tipo: Entero
Da de ingreso al Sistema.

Valor devuelto
Tipo: XML
La respuesta en formato XML que contiene el siguiente esquema:

ObtenerCarteraTercero
Este servicio permite obtener toda la cartera que existe en SIIGO.NET para un tercero
determinado.

Parmetros
NroEmpresa
Tipo: Entero
Nmero de empresa a conectarse.

AnoIngreso
Tipo: Entero
Ao de ingreso al Sistema.

MesIngreso

11
Tipo: Entero
Mes de ingreso al Sistema.

DiaIngreso
Tipo: Entero
Da de ingreso al Sistema.

Identificacion
Tipo: Entero Largo
Identificacin del tercero para el cual se desea consultar la cartera.

Sucursal
Tipo: Entero
Sucursal del tercero para el cual se desea consultar la cartera.

FechaCorte
Tipo: Cadena de texto
Fecha de la forma AAAAMMDD que indica la fecha de corte que se tendr en cuenta para
la consulta.

Valor devuelto
Tipo: XML
La respuesta en formato XML que contiene el siguiente esquema:

ObtenerCarteraDetalladaTercero
Este servicio permite obtener la cartera detallada de un tercero en una fecha de corte especfica.

Parmetros
NroEmpresa
Tipo: Entero
Nmero de empresa a conectarse.

AnoIngreso

12
Tipo: Entero
Ao de ingreso al Sistema.

MesIngreso
Tipo: Entero
Mes de ingreso al Sistema.

DiaIngreso
Tipo: Entero
Da de ingreso al Sistema.

Identificacion
Tipo: Entero Largo
Identificacin del tercero para el cual se desea consultar la cartera.

Sucursal
Tipo: Entero
Sucursal del tercero para el cual se desea consultar la cartera.

FechaCorte
Tipo: Cadena de texto
Fecha de la forma AAAAMMDD que indica la fecha de corte que se tendr en cuenta para
la consulta.

Valor devuelto
Tipo: XML
La respuesta en formato XML que contiene el siguiente esquema:

ObtenerCentrosDeCosto
Este servicio permite obtener todos los Centros de Costo que estn parametrizados en SIIGO.NET
para la empresa seleccionada.

13
Parmetros
NroEmpresa
Tipo: Entero
Nmero de empresa a conectarse.

AnoIngreso
Tipo: Entero
Ao de ingreso al Sistema.

MesIngreso
Tipo: Entero
Mes de ingreso al Sistema.

DiaIngreso
Tipo: Entero
Da de ingreso al Sistema.

Valor devuelto
Tipo: XML
La respuesta en formato XML que contiene el siguiente esquema:

ObtenerCosto
Este servicio permite obtener el costo de un producto parametrizado en SIIGO.NET para la
empresa seleccionada. Este costo depende del tipo de costeo que se haya definido en el Registro
de Control.

14
Parmetros
NroEmpresa
Tipo: Entero
Nmero de empresa a conectarse.

AnoIngreso
Tipo: Entero
Ao de ingreso al Sistema.

MesIngreso
Tipo: Entero
Mes de ingreso al Sistema.

DiaIngreso
Tipo: Entero
Da de ingreso al Sistema.

CodigoProducto
Tipo: Cadena de Texto
Cdigo del producto con el formato XXX-XXXX-XXXXXX. Los tres primeros dgitos
corresponden a la lnea, los cuatro siguientes al grupo y los ltimos seis al producto.
Ejemplo: 001-0001-000123

Valor devuelto
Tipo: XML
La respuesta en formato XML que contiene el siguiente esquema:

ObtenerCuentas
Este servicio permite obtener el Plan de Cuentas parametrizado en SIIGO.NET para la empresa
seleccionada.

Parmetros
NroEmpresa
Tipo: Entero
Nmero de empresa a conectarse.

AnoIngreso
Tipo: Entero
Ao de ingreso al Sistema.

MesIngreso
Tipo: Entero
Mes de ingreso al Sistema.

DiaIngreso

15
Tipo: Entero
Da de ingreso al Sistema.

Valor devuelto
Tipo: XML
La respuesta en formato XML que contiene el siguiente esquema:

ObtenerDocumentos
Este servicio permite obtener todos los Documentos parametrizados en SIIGO.NET para la
empresa seleccionada.

Parmetros
NroEmpresa
Tipo: Entero
Nmero de empresa a conectarse.

AnoIngreso
Tipo: Entero
Ao de ingreso al Sistema.

MesIngreso
Tipo: Entero
Mes de ingreso al Sistema.

DiaIngreso

16
Tipo: Entero
Da de ingreso al Sistema.

Valor devuelto
Tipo: XML
La respuesta en formato XML que contiene el siguiente esquema:

ObtenerFormasDePago
Este servicio permite obtener todas las Formas de Pago parametrizadas en SIIGO.NET para la
empresa seleccionada.

Parmetros
NroEmpresa
Tipo: Entero
Nmero de empresa a conectarse.

AnoIngreso
Tipo: Entero
Ao de ingreso al Sistema.

MesIngreso
Tipo: Entero
Mes de ingreso al Sistema.

DiaIngreso

17
Tipo: Entero
Da de ingreso al Sistema.

Valor devuelto
Tipo: XML
La respuesta en formato XML que contiene el siguiente esquema:

ObtenerProductos
Este servicio permite obtener todos Productos parametrizados en SIIGO.NET para la empresa
seleccionada.

Parmetros
NroEmpresa
Tipo: Entero
Nmero de empresa a conectarse.

AnoIngreso
Tipo: Entero
Ao de ingreso al Sistema.

MesIngreso
Tipo: Entero
Mes de ingreso al Sistema.

DiaIngreso
Tipo: Entero
Da de ingreso al Sistema.

18
Valor devuelto
Tipo: XML
La respuesta en formato XML que contiene el siguiente esquema:

ObtenerSaldoInventario
Este servicio permite obtener el Saldo en Inventario para un Producto determinado en SIIGO.NET
para la empresa seleccionada.

Parmetros
NroEmpresa
Tipo: Entero
Nmero de empresa a conectarse.

AnoIngreso
Tipo: Entero
Ao de ingreso al Sistema.

19
MesIngreso
Tipo: Entero
Mes de ingreso al Sistema.

DiaIngreso
Tipo: Entero
Da de ingreso al Sistema.

CodigoProducto
Tipo: Cadena de Texto
Cdigo del producto con el formato XXX-XXXX-XXXXXX. Los tres primeros dgitos
corresponden a la lnea, los cuatro siguientes al grupo y los ltimos seis al producto.
Ejemplo: 001-0001-000123

Valor devuelto
Tipo: XML
La respuesta en formato XML que contiene el siguiente esquema:

ObtenerTerceros
Este servicio permite obtener todos los Terceros parametrizados en SIIGO.NET para la empresa
seleccionada. En la respuesta se hace diferencia entre clientes, proveedores y otros.

Parmetros
NroEmpresa
Tipo: Entero
Nmero de empresa a conectarse.

AnoIngreso
Tipo: Entero
Ao de ingreso al Sistema.

MesIngreso
Tipo: Entero
Mes de ingreso al Sistema.

DiaIngreso
Tipo: Entero
Da de ingreso al Sistema.

Valor devuelto
Tipo: XML

20
La respuesta en formato XML que contiene el siguiente esquema:

ObtenerVendedores
Este servicio permite obtener todos los Vendedores parametrizados en SIIGO.NET para la empresa
seleccionada.

Parmetros
NroEmpresa
Tipo: Entero
Nmero de empresa a conectarse.

AnoIngreso
Tipo: Entero
Ao de ingreso al Sistema.

MesIngreso
Tipo: Entero
Mes de ingreso al Sistema.

DiaIngreso

21
Tipo: Entero
Da de ingreso al Sistema.

Valor devuelto
Tipo: XML
La respuesta en formato XML que contiene el siguiente esquema:

ObtenerZonas
Este servicio permite obtener todas las Zonas parametrizadas en SIIGO.NET para la empresa
seleccionada.

Parmetros
NroEmpresa
Tipo: Entero
Nmero de empresa a conectarse.

AnoIngreso
Tipo: Entero
Ao de ingreso al Sistema.

MesIngreso
Tipo: Entero
Mes de ingreso al Sistema.

DiaIngreso
Tipo: Entero
Da de ingreso al Sistema.

Valor devuelto
Tipo: XML

22
La respuesta en formato XML que contiene el siguiente esquema:

ObtenerMovimiento
Este servicio permite obtener el movimiento de Documentos guardados en el Sistema durante un
periodo determinado.

Parmetros
NroEmpresa
Tipo: Entero
Nmero de empresa a conectarse.

AnoIngreso
Tipo: Entero
Ao de ingreso al Sistema.

MesIngreso
Tipo: Entero
Mes de ingreso al Sistema.

DiaIngreso
Tipo: Entero
Da de ingreso al Sistema.

FechaInicial
Tipo: Cadena de Caracteres
Fecha inicial de bsqueda con formato AAAAMMDD.

FechaFinal
Tipo: Cadena de Caracteres
Fecha final de bsqueda con formato AAAAMMDD.

TipoDocumento
Tipo: Cadena de Caracteres
Tipo de Documento a filtrar.

23
Comprobante
Tipo: Entero
Comprobante a filtrar.

Numero
Tipo: Entero
Nmero de documento a filtrar.

Valor devuelto
Tipo: XML
La respuesta en formato XML que contiene el siguiente esquema:

ObtenerExtracontable
Este servicio permite obtener los Documentos extracontables (Pedidos, Cotizaciones, rdenes de
Compra) guardados en el Sistema durante un periodo determinado.

Parmetros
NroEmpresa
Tipo: Entero
Nmero de empresa a conectarse.

AnoIngreso

24
Tipo: Entero
Ao de ingreso al Sistema.

MesIngreso
Tipo: Entero
Mes de ingreso al Sistema.

DiaIngreso
Tipo: Entero
Da de ingreso al Sistema.

FechaInicial
Tipo: Cadena de Caracteres
Fecha inicial de bsqueda con formato AAAAMMDD.

FechaFinal
Tipo: Cadena de Caracteres
Fecha final de bsqueda con formato AAAAMMDD.

TipoDocumento
Tipo: Cadena de Caracteres
Tipo de Documento a filtrar.

Valor devuelto
Tipo: XML

25
La respuesta en formato XML que contiene el siguiente esquema:

Servicios de Registro de Datos


Este conjunto de servicios se utilizan para guardar informacin en SIIGO.NET y tratan de
proporcionar la funcionalidad bsica como es creacin de terceros y manipulacin de
comprobantes.

GuardarTercero
Este servicio permite guardar un Tercero en SIIGO.NET, incluyendo las caractersticas bsicas que
requiere para su creacin y buen funcionamiento.

Parmetros
NroEmpresa
Tipo: Entero
Nmero de empresa a conectarse.

AnoIngreso
Tipo: Entero
Ao de ingreso al Sistema.

MesIngreso
Tipo: Entero
Mes de ingreso al Sistema.

26
DiaIngreso
Tipo: Entero
Da de ingreso al Sistema.

Datos
Tipo: Cadena de Caracteres
Este es un XML que tiene la siguiente estructura:

<?xml version="1.0" encoding="UTF-8"?>


<Terceros>
<Tercero>
<Identificacion></Identificacion>
<Sucursal></Sucursal>
<UsaSucursal></UsaSucursal>
<Nombre></Nombre>
<Tipo></Tipo>
<Contacto></Contacto>
<Direccion></Direccion>
<Telefono1></Telefono1>
<Email></Email>
<Estado></Estado>
<CodigoPais></CodigoPais>
<CodigoCiudad></CodigoCiudad>
<TipoIdentificacionTributaria></TipoIdentificacionTributaria>
<ClasificacionTributaria></ClasificacionTributaria>
<Cliente ListaPrecio = "0" Calificacion = "0" FormaDePago = "0"
Vendedor = "0" Cobrador = "0"></Cliente>
<Proveedor Calificacion = "0" FormaDePago = "0"></Proveedor>
</Tercero>
</Terceros>
CAMPO TIPO VALORES
Identificacion Entero Largo 1 - 9,223,372,036,854,775,807
Sucursal Entero 0 - 99
UsaSucursal Lgico true o false
Nombre Alfanumrico
Tipo Alfanumrico Cliente, Proveedor
Contacto Alfanumrico
Direccion Alfanumrico
Telefono1 Alfanumrico
Email Alfanumrico
Estado Entero 0o1
CodigoPais Entero 1 99
CodigoCiudad Entero 1 999
TipoIdentificacionTributaria Entero Nit = 2,
Cedula = 3,
Ruc = 4,
Ci = 5,
Pasaporte = 6,
Cedula Extranjera = 7,
Tarjeta Identidad = 8,

27
Registro Civil = 9,
Tarjeta Extranjeria = 10
ClasificacionTributaria Entero GranContribuyente = 2,
EmpresaDelEstado = 3,
RegimenComun = 4,
RegimenSimplificado = 5,
RegimenSimplificadoNoResidentePais = 6,
NoResidentePais = 7,
NoResponsableIva = 8
ListaPrecio Entero 1 12
Calificacion Entero 1 99
FormaDePago Entero 1 99
Vendedor Entero 1 999
Cobrador Entero 1 999

NOTAS:
- Todos los campos son obligatorios.
- Segn el campo Tipo (Cliente o Proveedor) se debe diligenciar la seccin correspondiente.
Si por ejemplo es cliente, el TAG Proveedor debe ir vaco (<Proveedor/>)
- Si el Tercero ya existe, se sobreescribe la informacin. Por favor use el mtodo
ExisteTercero para comprobar su existencia si es el caso.
- Es posible enviar varios Terceros para que se guarden, cada uno debe tener la informacin
completa para que el programa no genere errores.

Valor devuelto
Tipo: XML
La respuesta en formato XML que contiene el siguiente esquema:
<Respuesta>
<Estado></Estado>
<Descripcion></Descripcion>
<Errores>
<Error>
<Numero></Numero>
<Descripcion></Descripcion>
</Error>
<Errores>
</Respuesta>
Si Estado es 1, es porque el proceso se ejecut satisfactoriamente, si es 0 es porque ocurri algn
error y estos se muestran en la lista de Errores.

GuardarContable
Este servicio permite guardar un Comprobante Contable (Facturas, Recibos, Devoluciones, etc) en
SIIGO.NET.

Parmetros
NroEmpresa
Tipo: Entero
Nmero de empresa a conectarse.

28
AnoIngreso
Tipo: Entero
Ao de ingreso al Sistema.

MesIngreso
Tipo: Entero
Mes de ingreso al Sistema.

DiaIngreso
Tipo: Entero
Da de ingreso al Sistema.

Datos
Tipo: Cadena de Caracteres
Este es un XML que tiene la siguiente estructura:

<?xml version="1.0" encoding="ISO-8859-1"?>


<Comprobantes>
<Comprobante>
<Encabezado>
<TipoDocumento></TipoDocumento>
<Comprobante></Comprobante>
<Numero></Numero>
<Identificacion></Identificacion>
<Sucursal></Sucursal>
<CentroCosto CentroCosto="" SubCentroCosto=""></CentroCosto>
<Vendedor></Vendedor>
<FechaDocumento></FechaDocumento>
</Encabezado>
<Detalle>
<Secuencia>
<Cuenta></Cuenta>
<Producto>000-0000-000000</Producto>
<Bodega Bodega = "0" Ubicacion = "0" ></Bodega>
<Cantidad></Cantidad>
<Valor></Valor>
<Descuentos>
<Descuento Porcentaje = "0" Valor = "0">1</Descuento>
<Descuento Porcentaje = "0" Valor = "0">2</Descuento>
<Descuento Porcentaje = "0" Valor = "0">3</Descuento>
</Descuentos>
<Cargos>
<Cargo Porcentaje = "0" Valor = "0">1</Cargo>
<Cargo Porcentaje = "0" Valor = "0">2</Cargo>
<Cargo Porcentaje = "0" Valor = "0">3</Cargo>
</Cargos>
<Impuestos>
<IVA Porcentaje = "0" Valor = "0"></IVA>
<Retencion Porcentaje = "0" Valor = "0"></Retencion>
<RetencionCREE Porcentaje = "0" Valor = "0"></RetencionCREE>
<ImpoConsumo Porcentaje = "0" Valor = "0"></ImpoConsumo>
<ImpoDeporte Porcentaje = "0" Valor = "0"></ImpoDeporte>

29
</Impuestos>
<Cruce TipoDocumento = "" Comprobante = "" Numero = "0"
Secuencia = "0" FechaVencimiento="19000101"></Cruce>
</Secuencia>
</Detalle>
<Total>
<FormaDePago>
<Codigo></Codigo>
<Vencimiento></Vencimiento>
<Cruce TipoDocumento = "" Comprobante = "" Numero = "0"
Secuencia = "0" FechaVencimiento = "19000101"></Cruce>
<Valor></Valor>
</FormaDePago>
</Total>
</Comprobante>
</Comprobantes>

CAMPO TIPO VALORES


ENCABEZADO
TipoDocumento Alfanumrico Tipo de documento contable en SIIGO
Comprobante Entero 1 99
Numero Entero Largo 0 - 9,223,372,036,854,775,807
Identificacion Entero Largo 1 - 9,223,372,036,854,775,807
Sucursal Entero 0 - 99
CentroCosto Entero 1 999
SubCentroCosto Entero 0 999
Vendedor Entero 1 999
FechaDocumento Fecha AAAAMMDD
DETALLE
Cuenta Alfanumrico Cdigo Contable
Producto Alfanumrico Cdigo del producto XXX-XXXX-XXXXXX
Bodega Entero 1 - 999
Ubicacion Entero 0 999
Cantidad Doble
Valor Doble
Cruce Informacin del documento cruce
TOTAL
Codigo Entero 1 999
Vencimiento Entero 1 999
Valor Doble
Cruce Informacin del documento cruce

NOTAS:
- Si el campo Numero del Encabezado se enva con valor 0, el programa automticamente
genera este valor.
- Exceptuando Vendedor, los campos del Encabezado son obligatorios. El Vendedor solo
aplica para Factura y Devolucin.

30
- La Cuenta en el Detalle es opcional (puede ir con un tag vaco <Cuenta/>), si es una
Factura o una Devolucin este campo se llena con la Cuenta correspondiente del
Producto. Sin embargo es posible usar la cuenta sin definir un Producto (debe ir con
cdigo 000-0000-000000) para los casos en los que no se tiene instalado el mdulo de
Inventarios.
- Si se define un Producto, debe ir obligatoriamente la informacin de la Bodega.
- En el detalle se pueden manejar hasta 3 Descuentos y 3 Cargos, pero estos deben estar
parametrizados en el documento correspondiente. Si no se tienen Descuentos o Cargos se
puede enviar un TAG vaco (Ej. <Descuentos/>)
- Si no aplica algn impuesto, puede enviar el Porcentaje y el Valor en 0.
- El Cdigo de la Forma de Pago se puede obtener mediante el Servicio
ObtenerFormasDePago.
- El Cruce tanto en la Secuencia como en la Forma de Pago, es necesario cuando la Cuenta
est detallada por Cobrar o por Pagar. En la Secuencia todos los campos del cruce son
obligatorios y se usan para los Recibos de Caja o para cruzar datos de Cartera. En la Forma
de Pago el Numero puede ir en 0.
- Es posible enviar varios Comprobantes para que se guarden, cada uno debe tener la
informacin completa para que el programa no genere errores.

Valor devuelto
Tipo: XML
La respuesta en formato XML que contiene el siguiente esquema:
<Respuesta>
<Estado></Estado>
<Descripcion></Descripcion>
<Errores>
<Error>
<Numero></Numero>
<Descripcion></Descripcion>
</Error>
<Errores>
</Respuesta>
Si Estado es 1, es porque el proceso se ejecut satisfactoriamente, si es 0 es porque ocurri algn
error y estos se muestran en la lista de Errores.

Ejemplo de una Factura


<?xml version="1.0" encoding="ISO-8859-1"?>
<Comprobantes>
<Comprobante>
<Encabezado>
<TipoDocumento>F</TipoDocumento>
<Comprobante>1</Comprobante>
<Numero>0</Numero>
<Identificacion>860002693</Identificacion>
<Sucursal>0</Sucursal>
<CentroCosto CentroCosto="150" SubCentroCosto="151"></CentroCosto>
<Vendedor>1</Vendedor>
<FechaDocumento>20131231</FechaDocumento>
</Encabezado>
<Detalle>
<Secuencia>

31
<Cuenta/>
<Producto>001-0001-000001</Producto>
<Bodega Bodega="1" Ubicacion="0"></Bodega>
<Cantidad>15</Cantidad>
<Valor>150000</Valor>
<Descuentos>
<Descuento Porcentaje = "2" Valor = "3000">1</Descuento>
</Descuentos>
<Cargos/>
<Impuestos>
<IVA Porcentaje="16" Valor="23520"></IVA>
<Retencion Porcentaje="0" Valor="0"></Retencion>
<ImpoConsumo Porcentaje="0" Valor="0"></ImpoConsumo>
<ImpoDeporte Porcentaje="0" Valor="0"></ImpoDeporte>
</Impuestos>
<Clasificaciones/>
<Cruce/>
</Secuencia>
</Detalle>
<Total>
<FormaDePago>
<Codigo>1</Codigo>
<Vencimiento>1</Vencimiento>
<Cruce TipoDocumento="F" Comprobante="1" Numero="0" Secuencia="1"
FechaVencimiento="20140131"></Cruce>
<Valor>170520</Valor>
</FormaDePago>
</Total>
</Comprobante>
</Comprobantes>

AnularContable
Este servicio permite anular un Comprobante Contable (Facturas, Recibos, Devoluciones, etc) en
SIIGO.NET.

Parmetros
NroEmpresa
Tipo: Entero
Nmero de empresa a conectarse.

AnoIngreso
Tipo: Entero
Ao de ingreso al Sistema.

MesIngreso
Tipo: Entero
Mes de ingreso al Sistema.

DiaIngreso
Tipo: Entero
Da de ingreso al Sistema.

32
TipoDocumento
Tipo: Cadena de Caracteres
Tipo de Documento a anular.

Comprobante
Tipo: Entero
Cdigo del Documento a anular.

Numero
Tipo: Entero Largo
Nmero del Documento a anular.

GuardarExtracontable
Este servicio permite guardar un Comprobante ExtraContable (Cotizacin, Pedido, Orden de
Compra, etc) en SIIGO.NET.

Parmetros
NroEmpresa
Tipo: Entero
Nmero de empresa a conectarse.

AnoIngreso
Tipo: Entero
Ao de ingreso al Sistema.

MesIngreso
Tipo: Entero
Mes de ingreso al Sistema.

DiaIngreso
Tipo: Entero
Da de ingreso al Sistema.

Datos
Tipo: Cadena de Caracteres
Este es un XML que tiene la siguiente estructura:

<?xml version="1.0" encoding="ISO-8859-1"?>


<Comprobantes>
<Comprobante>
<Encabezado>
<TipoDocumento></TipoDocumento>
<Comprobante></Comprobante>
<Numero></Numero>
<Identificacion></Identificacion>
<Sucursal></Sucursal>
<CentroCosto CentroCosto="" SubCentroCosto=""></CentroCosto>
<Vendedor></Vendedor>
<FechaDocumento></FechaDocumento>

33
</Encabezado>
<Detalle>
<Secuencia>
<Producto>000-0000-000000</Producto>
<Bodega Bodega = "0" Ubicacion = "0" ></Bodega>
<Cantidad></Cantidad>
<Valor></Valor>
<Descuentos>
<Descuento Porcentaje = "0" Valor = "0">1</Descuento>
<Descuento Porcentaje = "0" Valor = "0">2</Descuento>
<Descuento Porcentaje = "0" Valor = "0">3</Descuento>
</Descuentos>
<Cargos>
<Cargo Porcentaje = "0" Valor = "0">1</Cargo>
<Cargo Porcentaje = "0" Valor = "0">2</Cargo>
<Cargo Porcentaje = "0" Valor = "0">3</Cargo>
</Cargos>
<Impuestos>
<IVA Porcentaje = "0" Valor = "0"></IVA>
</Impuestos>
</Secuencia>
</Detalle>
</Comprobante>
</Comprobantes>

CAMPO TIPO VALORES


ENCABEZADO
TipoDocumento Alfanumrico Tipo de documento extracontable en SIIGO
Comprobante Entero 1 99
Numero Entero Largo 0 - 9,223,372,036,854,775,807
Identificacion Entero Largo 1 - 9,223,372,036,854,775,807
Sucursal Entero 0 - 99
CentroCosto Entero 1 999
SubCentroCosto Entero 0 999
Vendedor Entero 1 999
FechaDocumento Fecha AAAAMMDD
DETALLE
Producto Alfanumrico Cdigo del producto XXX-XXXX-XXXXXX
Bodega Entero 1 - 999
Ubicacion Entero 0 999
Cantidad Doble
Valor Doble

NOTAS:
- Si el campo Numero del Encabezado se enva con valor 0, el programa automticamente
genera este valor.
- Los campos del Encabezado son obligatorios.
- Si se define un Producto, debe ir obligatoriamente la informacin de la Bodega.

34
- En el detalle se pueden manejar hasta 3 Descuentos y 3 Cargos, pero estos deben estar
parametrizados en el documento correspondiente. Si no se tienen Descuentos o Cargos se
puede enviar un TAG vaco (Ej. <Descuentos/>)
- Si no aplica algn impuesto, puede enviar el Porcentaje y el Valor en 0.

Valor devuelto
Tipo: XML
La respuesta en formato XML que contiene el siguiente esquema:
<Respuesta>
<Estado></Estado>
<Descripcion></Descripcion>
<Errores>
<Error>
<Numero></Numero>
<Descripcion></Descripcion>
</Error>
<Errores>
</Respuesta>
Si Estado es 1, es porque el proceso se ejecut satisfactoriamente, si es 0 es porque ocurri algn
error y estos se muestran en la lista de Errores.

Ejemplo de un Pedido
<?xml version="1.0" encoding="ISO-8859-1"?>
<Comprobantes>
<Comprobante>
<Encabezado>
<TipoDocumento>Z</TipoDocumento>
<Comprobante>1</Comprobante>
<Numero>0</Numero>
<Identificacion>860002693</Identificacion>
<Sucursal>0</Sucursal>
<CentroCosto CentroCosto="150" SubCentroCosto="151"></CentroCosto>
<Vendedor>1</Vendedor>
<FechaDocumento>20131231</FechaDocumento>
</Encabezado>
<Detalle>
<Secuencia>
<Producto>001-0001-000001</Producto>
<Bodega Bodega="1" Ubicacion="0"></Bodega>
<Cantidad>15</Cantidad>
<Valor>150000</Valor>
<Descuentos>
<Descuento Porcentaje = "2" Valor = "3000">1</Descuento>
</Descuentos>
<Cargos/>
<Impuestos>
<IVA Porcentaje="16" Valor="23520"></IVA>
</Impuestos>
</Secuencia>
</Detalle>
</Comprobante>
</Comprobantes>

35

También podría gustarte