MANUAL DE USO

WEB SERVICE
CLIENTE
V 2.0 Noviembre 2014

FESAECUADOR 2014

CONTENIDO
Antecedentes ..................................................................................................................................................... 2
Ubicacin del servicio ......................................................................................................................................... 2
Mtodos del Servicio .......................................................................................................................................... 2
GetArchivoXML............................................................................................................................................... 2
Parmetros de Entrada: .............................................................................................................................. 2
Parmetros de salida: ................................................................................................................................. 3
ArchivoZip ...................................................................................................................................................... 4
Parmetros de Entrada ............................................................................................................................... 5
Parmetros de salida: ................................................................................................................................. 6
Consulta Factura ............................................................................................................................................. 7
Parmetros de Entrada: .............................................................................................................................. 7
Parmetros de salida: ................................................................................................................................. 8

ANTECEDENTES
Como parte de la solucin GreenDocs Facturacin Electrnica se encuentra el servicio de Buscador
avanzado, recuperacin de los archivos XML y descarga de archivos Zip que contengan la factura en
formato XML y la firma del documento.
UBICACIN DEL SERVICIO

http://[Servidor]/Ebilling.ServicioWeb/Cliente.asmx
MTODOS DEL SERVICIO
GETARCHIVOXML
Se enva el path del documento a consultar y el mtodo devuelve un string que contiene el archivo
XML de la Factura ms como un campo adicional extra y modificando por lo tanto el archivo firmado
el nmero de autorizacin del documento. Cabe recalcar que este archivo no puede servir para
descarga por que se encuentra modificado.

PARMETROS DE ENTRADA:
numDoc: nmero del Documento en el formato ###-###-#########
rucEmpresa: Ruc de la Empresa Emisora del Documento Electrnico
TipoDoc: Tipo de Documento que se est consultando Ver Tabla 1 en este documento

Tipo Documento

Cdigo

Factura

Nota de Crdito

Nota de Debito

Comprobante de Retencin

Gua de Remisin

6
Tabla 1

POST /Ebilling.ServicioWeb/Cliente.asmx HTTP/1.1

Host: 50.57.72.27
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://tempuri.org/GetArchivoXML"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<GetArchivoXML xmlns="http://tempuri.org/">
<numDoc>string</numDoc>
<rucEmpresa>string</rucEmpresa>
<tipoDoc>string</tipoDoc>
</GetArchivoXML>
</soap:Body>
</soap:Envelope>
POST /Ebilling.ServicioWeb/Cliente.asmx HTTP/1.1
Host: 50.57.72.27
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<GetArchivoXML xmlns="http://tempuri.org/">
<numDoc>string</numDoc>
<rucEmpresa>string</rucEmpresa>
<tipoDoc>string</tipoDoc>
</GetArchivoXML>
</soap12:Body>
</soap12:Envelope>

PARMETROS DE SALIDA:
Result: 0000 Siempre que no existan problemas con la consulta
RespuestaXML: Archivo XML en string
Mensaje: De existir un error la descripcin tendr la descripcin del error.

El nmero de Autorizacin y la fecha de autorizacin se incluyen al final de los campos adicionales

este XML no es vlido para descarga pues se alterna lgicamente para incluir los campos de
Autorizacin y fecha de autorizacin, para facilidad en la visualizacin.
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<GetArchivoXMLResponse xmlns="http://tempuri.org/">
<GetArchivoXMLResult>string</GetArchivoXMLResult>
<RespuestaXML>string</RespuestaXML>
<Mensaje>string</Mensaje>
</GetArchivoXMLResponse>
</soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<GetArchivoXMLResponse xmlns="http://tempuri.org/">
<GetArchivoXMLResult>string</GetArchivoXMLResult>
<RespuestaXML>string</RespuestaXML>
<Mensaje>string</Mensaje>
</GetArchivoXMLResponse>
</soap12:Body>
</soap12:Envelope>

ARCHIVOZIP
Se enva el path del documento y servicio devuelve un arreglo de Bytes que es el archivo Zip de la
Factura.
El Archivo Zip contiene el documento XML, en el formato que retorna el SRI.

Parmetros de Entrada
numDoc: Numero del Documento en formato ###-###-#########
rucEmpresa: Numero de la empresa emisora
tipoDoc: Tipo de Documento segn corresponda ver tabla 1.

POST /Ebilling.ServicioWeb/Cliente.asmx HTTP/1.1

Host: 50.57.72.27
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://tempuri.org/ArchivoZip"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ArchivoZip xmlns="http://tempuri.org/">
<numDoc>string</numDoc>
<rucEmpresa>string</rucEmpresa>
<tipoDoc>string</tipoDoc>
</ArchivoZip>
</soap:Body>
</soap:Envelope>
POST /Ebilling.ServicioWeb/Cliente.asmx HTTP/1.1
Host: 50.57.72.27
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">

<soap12:Body>
<ArchivoZip xmlns="http://tempuri.org/">
<numDoc>string</numDoc>
<rucEmpresa>string</rucEmpresa>
<tipoDoc>string</tipoDoc>
</ArchivoZip>
</soap12:Body>
</soap12:Envelope>

PARMETROS DE SALIDA:

result: 0000 Siempre que no existan problemas con la consulta

archivoZip: Arreglo de bytes del archivo Zip
Mensaje: De existir un error la descripcin tendr la descripcin del error.

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ArchivoZipResponse xmlns="http://tempuri.org/">
<ArchivoZipResult>string</ArchivoZipResult>
<archivoZip>base64Binary</archivoZip>
<Mensaje>string</Mensaje>
</ArchivoZipResponse>
</soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<ArchivoZipResponse xmlns="http://tempuri.org/">
<ArchivoZipResult>string</ArchivoZipResult>
<archivoZip>base64Binary</archivoZip>

<Mensaje>string</Mensaje>
</ArchivoZipResponse>
</soap12:Body>
</soap12:Envelope>

CONSULTA FACTURA

Se refiere al buscado avanzado donde se puede enviar varios parmetros o uno y el buscador
consultara las facturas acorde a lo especificado.

PARMETROS DE ENTRADA:

IdentificacionFacturaE: Criterios de Busqueda por los cuales se identificara la

Factura(s)
EstablecimientoDesde: Lmite Inferior de los Nmeros de Establecimiento
PuntoEmisionDesde: Lmite Inferior del Punto de Establecimiento
SecuencialDesde: Lmite Inferior del Secuencial del Establecimiento
EstablecimientoHasta: Lmite Superior de los Nmeros de Establecimiento
PuntoEmisionHasta: Lmite Superior del Punto de Establecimiento
SecuencialHasta: Lmite Superior del Secuencial del Establecimiento
FechaEmisionDesde: Fecha Inicial de Bsqueda
FechaEmisionHasta: Fecha Final de Bsqueda
TipoDocumento: Tipo de Documento que se est consultando Ver Tabla 1 en este
documento

RucCliente: Ruc del Cliente que Recibe el Documento Electrnico

RucEmpresa: Ruc de la Empresa Emisora del Documento Electrnico

FORMATOS DE PARMETROS DE ENTRADA:

Formato de Fecha Desde y Hasta: dd/mm/yyyy

TipoDocumento: Son arreglos de string que permite enviar ms de un nmero de telfono, nmero
de cuenta o tipo de documento.
Como respuesta se obtendr un XML que contendr los documentos consultados.
CONSIDERACIONES EN LOS PARMETROS DE ENTRADA

RucEmpresa es un parmetro mandatorio.

Los dems parmetros pueden ser enviados o no, ya que se realiza una bsqueda de acuerdo a los
parmetros de entrada.
PARMETROS DE SALIDA:

Result: 0000 Siempre que no existan problemas con la consulta

RespuestaXML: Archivo XML en cadena
Mensaje: De existir un error la descripcin tendr la descripcin del error.
FORMATO DEL XML DE SALIDA
<?xml version="1.0" encoding="UTF-8"?>
<Facturas>
<DatosFacturas>
<fecha_emision>07/12/2011 0:00:00</fecha_emision>
<id_tipo_documento>1</id_tipo_documento>
<nombre_tipo_documento>FACTURA</nombre_tipo_documento>
<numero_factura>001-126-000000008</numero_factura>
<path_documento>
C:\FCT-1-1234567890-001-126-000000008.xml
</path_documento>
</DatosFacturas>
</Facturas>