MANUAL DE INTEGRACION

PARA FACTURACION ELECTRONCIA

ECOM

Este documento contiene las especificaciones técnicas de los webservice

para la carga de documentos para la facturación electrónica de Ecom.
A continuación se detallara cada una de las operaciones con parámetros y
datos de retorno que pertenecen a la integración.
Dirección de implementación:
https://app.ecom.com.co/eforce/wsecomfe/interface.php?wsdl

1. Método Factura
 setFactura
Este método permite la carga de las facturas a Ecom, Recibe como
parámetro estructura XML.
CAMPOS CARÁCTER TIPO DE LONGITUD OBSERVACION
CAMPO
Login
ServidorBaseDatos Obligatorio Alfanumérico 15 Dato proporcionado por Ecom
bdcliente Obligatorio Alfanumérico 20 Dato proporcionado por Ecom
usuario Obligatorio Alfanumérico 30 Dato proporcionado por Ecom
password Obligatorio Alfanumérico 10 Dato proporcionado por Ecom
Encabezado
codigocliente Obligatorio Alfanumérico 15
tipopersona Obligatorio Numérico 1 juridica(1) Natural(2)
tipodocumento Obligatorio Numérico 1 cedula(1) Tarjeta De
Extranjeria(2) NIT(3)
documento Obligatorio Numérico 15
nombrecliente Obligatorio Alfanumérico 100
apellidocliente Obligatorio Alfanumérico 100
nombredepartamento Obligatorio Alfanumérico 80
nombreciudad Obligatorio Alfanumérico 45
direccion Obligatorio Alfanumérico 50
razonsocial Obligatorio Alfanumérico 100
telefono Obligatorio Numérico 50
regimencliente Obligatorio Numérico 1 Simplificado(1) Comun(2)
emailcliente Obligatorio Alfanumérico 50
factura Obligatorio Alfanumérico 15
fechafactura Obligatorio Fecha 10 Formato: AAAA-MM-DD
horafactura Obligatorio Hora 8 Formato:HH24:MI:SS
observacion Opcional Alfanumérico 200
porreteiva Opcional Numérico
valorreteiva Opcional Numérico
porreteica Opcional Numérico
valorreteica Opcional Numérico
porretefuente Opcional Numérico
valorretefuente Opcional Numérico
Detalle
codigoproducto Obligatorio Alfanumérico 15
nombreproducto Obligatorio Alfanumérico 50
cantidad Obligatorio Numérico 10,2 10 enteros 2 decimales
valorunitario Obligatorio Numérico 10,2 10 enteros 2 decimales
porcentajeiva Obligatorio Numérico 10,2 10 enteros 2 decimales
porcentajedescuento Obligatorio Numérico 10,2 10 enteros 2 decimales
tipoproducto Obligatorio Alfanumérico 1 N(Normar),O(Obsequio)
C(Cambio)

Estructura XML

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

<general>
<login>
<servidorBaseDatos></servidorBaseDatos>
<bdcliente></bdcliente>
<usuario></usuario>
<password></password>
</login>
<data>
<codigocliente></codigocliente>
<tipopersona></tipopersona>
<tipodocumento></tipodocumento>
<documento></documento>
<nombrecliente></nombrecliente>
<apellidocliente></apellidocliente>
<nombredepartamento></nombredepartamento>
<nombreciudad></nombreciudad>
<direccion></direccion>
 <razonsocial></razonsocial>
<telefono></telefono>
<regimencliente></regimencliente>
<emailcliente></emailcliente>
<factura></factura>
<fechafactura></fechafactura>
<horafactura></horafactura>
<observacion></observacion>
<porreteiva></porreteiva>
<valorreteiva></valorreteiva>
<porreteica></porreteica>
<valorreteica></valorreteica>
<porretefuente></porretefuente>
<valorretefuente></valorretefuente>
<detalle>
<codigoproducto></codigoproducto>
<nombreproducto></nombreproducto>
<cantidad></cantidad>
<valorunitario></valorunitario>
<porcentajeiva></porcentajeiva>
<porcentajedescuento></porcentajedescuento>
<tipoproducto></tipoproducto>
</detalle>
<detalle>
<codigoproducto></codigoproducto>
<nombreproducto></nombreproducto>
<cantidad></cantidad>
<valorunitario></valorunitario>
<porcentajeiva></porcentajeiva>
<porcentajedescuento></porcentajedescuento>
<tipoproducto></tipoproducto>
</detalle>
</data>
</general>

2. Método Nota Credito

 setNc
Este método permite la carga de las notas crédito a Ecom, Recibe como
parámetro estructura XML.
CAMPOS CARÁCTER TIPO DE LONGITUD OBSERVACION
CAMPO
Login
ServidorBaseDatos Obligatorio Alfanumérico 15 Dato proporcionado por Ecom
bdcliente Obligatorio Alfanumérico 20 Dato proporcionado por Ecom
usuario Obligatorio Alfanumérico 30 Dato proporcionado por Ecom
password Obligatorio Alfanumérico 10 Dato proporcionado por Ecom
Encabezado
codigocliente Obligatorio Alfanumérico 15
tipopersona Obligatorio Numérico 1 juridica(1) Natural(2)
tipodocumento Obligatorio Numérico 1 cedula(1) Tarjeta De
Extranjeria(2) NIT(3)
documento Obligatorio Numérico 15
nombrecliente Obligatorio Alfanumérico 100
apellidocliente Obligatorio Alfanumérico 100
nombredepartamento Obligatorio Alfanumérico 80
nombreciudad Obligatorio Alfanumérico 45
direccion Obligatorio Alfanumérico 50
razonsocial Obligatorio Alfanumérico 100
telefono Obligatorio Numérico 50
regimencliente Obligatorio Numérico 1 Simplificado(1) Comun(2)
emailcliente Obligatorio Alfanumérico 50
Factura Obligatorio Alfanumérico 15 Numero de Factura que
afecta
nota Obligatorio Alfanumérico 15 Codigo de nota credito
fechanota Obligatorio Fecha 10 Formato: AAAA-MM-DD
horanota Obligatorio Hora 8 Formato:HH24:MI:SS
observacion Opcional Alfanumérico 200
Detalle
codigoproducto Obligatorio Alfanumérico 15
nombreproducto Obligatorio Alfanumérico 50
cantidad Obligatorio Numérico 10,2 10 enteros 2 decimales
valorunitario Obligatorio Numérico 10,2 10 enteros 2 decimales
porcentajeiva Obligatorio Numérico 10,2 10 enteros 2 decimales
porcentajedescuento Obligatorio Numérico 10,2 10 enteros 2 decimales
tipoproducto Obligatorio Alfanumérico 1 N(Normar),O(Obsequio)
C(Cambio)

Estructura XML

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

<general>
<login>
<servidorBaseDatos></servidorBaseDatos>
<bdcliente></bdcliente>
<usuario></usuario>
<password></password>
</login>
<data>
<codigocliente></codigocliente>
 <tipopersona></tipopersona>
<tipodocumento></tipodocumento>
<documento></documento>
<nombrecliente></nombrecliente>
<apellidocliente></apellidocliente>
<nombredepartamento></nombredepartamento>
<nombreciudad></nombreciudad>
<direccion></direccion>
<razonsocial></razonsocial>
<telefono></telefono>
<regimencliente></regimencliente>
<emailcliente></emailcliente>
<factura></factura>
<nota></nota>
<fechanota></fechanota>
<horanota></horanota>
<observacion></observacion>
<detalle>
<codigoproducto></codigoproducto>
<nombreproducto></nombreproducto>
<cantidad></cantidad>
<valorunitario></valorunitario>
<porcentajeiva></porcentajeiva>
<porcentajedescuento></porcentajedescuento>
<tipoproducto></tipoproducto>
</detalle>
<detalle>
<codigoproducto></codigoproducto>
<nombreproducto></nombreproducto>
<cantidad></cantidad>
<valorunitario></valorunitario>
<porcentajeiva></porcentajeiva>
<porcentajedescuento></porcentajedescuento>
<tipoproducto></tipoproducto>
</detalle>
</data>
</general>

3. Método Nota Debito

 setNd
Este método permite la carga de las notas crédito a Ecom, Recibe como
parámetro estructura XML.
 CAMPOS CARÁCTER TIPO DE LONGITUD OBSERVACION
CAMPO
Login
ServidorBaseDatos Obligatorio Alfanumérico 15 Dato proporcionado por Ecom
bdcliente Obligatorio Alfanumérico 20 Dato proporcionado por Ecom
usuario Obligatorio Alfanumérico 30 Dato proporcionado por Ecom
password Obligatorio Alfanumérico 10 Dato proporcionado por Ecom
Encabezado
codigocliente Obligatorio Alfanumérico 15
tipopersona Obligatorio Numérico 1 juridica(1) Natural(2)
tipodocumento Obligatorio Numérico 1 cedula(1) Tarjeta De
Extranjeria(2) NIT(3)
documento Obligatorio Numérico 15
nombrecliente Obligatorio Alfanumérico 100
apellidocliente Obligatorio Alfanumérico 100
nombredepartamento Obligatorio Alfanumérico 80
nombreciudad Obligatorio Alfanumérico 45
direccion Obligatorio Alfanumérico 50
razonsocial Obligatorio Alfanumérico 100
telefono Obligatorio Numérico 50
regimencliente Obligatorio Numérico 1 Simplificado(1) Comun(2)
emailcliente Obligatorio Alfanumérico 50
Factura Obligatorio Alfanumérico 15 Numero de Factura que
afecta
notadb Obligatorio Alfanumérico 15 Codigo de nota debito
fechanota Obligatorio Fecha 10 Formato: AAAA-MM-DD
horanota Obligatorio Hora 8 Formato:HH24:MI:SS
observacion Opcional Alfanumérico 200
Detalle
codigoproducto Obligatorio Alfanumérico 15
nombreproducto Obligatorio Alfanumérico 50
cantidad Obligatorio Numérico 10,2 10 enteros 2 decimales
valorunitario Obligatorio Numérico 10,2 10 enteros 2 decimales
porcentajeiva Obligatorio Numérico 10,2 10 enteros 2 decimales
porcentajedescuento Obligatorio Numérico 10,2 10 enteros 2 decimales
tipoproducto Obligatorio Alfanumérico 1 N(Normar),O(Obsequio)
C(Cambio)

Estructura XML

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

<general>
<login>
<servidorBaseDatos></servidorBaseDatos>
<bdcliente></bdcliente>
<usuario></usuario>
<password></password>
</login>
<data>
<codigocliente></codigocliente>
<tipopersona></tipopersona>
<tipodocumento></tipodocumento>
<documento></documento>
<nombrecliente></nombrecliente>
<apellidocliente></apellidocliente>
<nombredepartamento></nombredepartamento>
<nombreciudad></nombreciudad>
<direccion></direccion>
<razonsocial></razonsocial>
<telefono></telefono>
<regimencliente></regimencliente>
<emailcliente></emailcliente>
<factura></factura>
<notadb></notadb>
<fechanota></fechanota>
<horanota></horanota>
<observacion></observacion>
<detalle>
<codigoproducto></codigoproducto>
<nombreproducto></nombreproducto>
<cantidad></cantidad>
<valorunitario></valorunitario>
<porcentajeiva></porcentajeiva>
<porcentajedescuento></porcentajedescuento>
<tipoproducto></tipoproducto>
</detalle>
<detalle>
<codigoproducto></codigoproducto>
<nombreproducto></nombreproducto>
<cantidad></cantidad>
<valorunitario></valorunitario>
<porcentajeiva></porcentajeiva>
<porcentajedescuento></porcentajedescuento>
<tipoproducto></tipoproducto>
</detalle>
</data>
</general>