M OFC IWS 202008 v1.43

Guía Técnica Web Services Integración
Facturación Electrónica
Versión 1.43 – 27 de agosto de 2020

Contenido
Introducción ................................................................................................................... 3
Proceso recepción de transacciones en Noova .............................................................. 4
Estándar comunicación y seguridad ............................................................................... 5
Consumo de servicio web – factura de venta ................................................................. 6
Petición del servicio ............................................................................................................ 6

Respuesta del servicio ..................................................................................................... 27
Petición de Queue Varios documentos ......................................................................... 30
Petición del servicio .......................................................................................................... 30

Consumo de servicio web – Nota debito ...................................................................... 39

Consumo de servicio Web – Nota Crédito .................................................................... 49
I. Petición del servicio ............................................................................................. 49

II. Respuesta del servicio......................................................................................... 58
Casos especiales de facturación proceso versión 3 de facturación electrónica (validación
previa) .......................................................................................................................... 60
I. Facturación con AIU: ............................................................................................ 60

II. Facturación Tercero Mandante - Mandatario: ................................................... 67
III. Facturación con impuesto a las bolsas: ............................................................. 72
IV. Facturación Productos Excluidos: ....................................................................... 77
V. Facturación Productos Exentos: ......................................................................... 79
Acuse recibido DIAN / Cliente....................................................................................... 83
VI. Petición del servicio ............................................................................................. 83

VII. Respuesta del servicio......................................................................................... 83
Acuse recibido cliente .................................................................................................. 85
I. Petición del servicio ............................................................................................. 85

II. Respuesta del servicio......................................................................................... 85
www.noova.com.co www.mentum.group Tel: (571+) 744 15 15

Consulta documentos .................................................................................................. 87

Notificación aceptación o rechazo................................................................................ 90

Consulta numeración resolución habilitada ................................................................. 93

Enviar documento adjunto a factura ............................................................................ 95
I. Petición del servicio ....................................................................................................... 96

II. Respuesta del servicio ................................................................................................. 97
Solicitar Token de autenticación .................................................................................. 98

Control de cambios .................................................................................................... 100
Versión 1.25 .................................................................................................................... 100

Versión 1.36 .................................................................................................................... 100
Versión 1.37 .................................................................................................................... 100
Versión 1.38 .................................................................................................................... 100
Versión 1.39 .................................................................................................................... 100
Versión 1.40 .................................................................................................................... 101
Versión 1.41 .................................................................................................................... 101
Versión 1.42 .................................................................................................................... 101
Anexos ........................................................................................................................ 102

Introducción
Noova ha desarrollado servicios web para el proceso de operación de facturación electrónica. Estos
servicios permiten la integración entre los sistemas externos facturadores de tipo ERP, POS, entre
otros y por medio de estos se recibe en la aplicación las transacciones que están inmersas en el
proceso (factura de venta, nota débito y nota crédito).
Por medio de este documento se realiza el apoyo técnico del servicio web de integración de facturación
electrónica en Noova.
-URL Base servicio REST: https://{instancia}/api/{metodos}

-URL Base servicio SOAP: https://{instancia}/services/{endpoint}
La variable {instancia} en el proceso de implantación corresponde a la instancia de la aplicación ya sea

en entorno de pruebas o en entorno de producción según corresponda.
En los casos que el servicio no esté expuesto por algunas de estas URL se le indicara al usuario

Proceso recepción de transacciones en Noova
El proceso consiste en la generación de transacciones digitales desde un sistema ERP, facturador, o

sistema POS. Una vez se tengan definidos estos documentos y verificados respectivamente, se hace
el consumo de los servicios web dependiendo del tipo de transacción (factura de venta, nota débito y
nota crédito) expuestos por Noova en la aplicación y se hace la respectiva recepción efectiva de los
mismos para iniciar el proceso de facturación electrónica el cual consiste en la firma electrónica del
documento; paralelo a esto se envía la representación gráfica al cliente; generación del documento
tipo XML; y por último se realiza el respectivo envió a la DIAN. Este corresponde al ciclo en el proceso
de cada uno de los documentos recibidos en la integración.
En Noova, los documentos enviados a través del Web Services se listan en la opción del menú
denominada relación facturas Enterprise y es desde allí donde el sistema ejecuta automáticamente el
proceso paso a paso de envió de transacciones al ente regulador de la DIAN:

Estándar comunicación y seguridad
SEGURIDAD DEL SERVICIO DESCRIPCIÓN:

- El servicio está expuesto mediante REST y SOAP.
- Para Autenticación del servicio se utiliza “Basic Auth” o “Bearer”.
- Transporte del mensaje se realiza mediante HTTPS.
- El Request se puede realizar mediante JSON, o XML al servicio REST.

Consumo de servicio web – factura de venta
Petición del servicio
a. Consumo del servicio mediante REST
Especificación técnica petición del servicio web Invoice (factura de venta):

El consumo se envía mediante HTTPS,
POST URL: https://{instancia}/{instancia}/api/FacFacturas
Ejemplo de cabecera autenticacion usuario y password:
Authorization: Basic dXN1YXJpb19pbnRlZ3JhY2lvbjpwYXNzd29yZF9pbnRlZ3JhY2lvbg==

Content-Type: application/json
Host: localhost
Content-Length: 967
Expect: 100-continue
Connection: Keep-Alive
Autorización se utiliza mediante usuario y password entregados por Noova,

Authorization: Basic {base64_encode(username:password)}
Ejemplo de cabecera autenticacion Token:
Authorization: Bearer
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1bmlxdWVfbmFtZSI6IlZpbGxlZ2FzbGciLCJuYmYiOjE1
OTI4NzU5OTAsImV4cCI6MTU5Mjg5Mzk5MCwiaWF0IjoxNTkyODc1OTkzLCJpc3MiOiJodHRwOi8vb
G9jYWxob3N0L25vb3ZhYXBpIiwiYXVkIjoiaHR0cDovL2xvY2FsaG9zdC9ub292YWFwaSJ9.8P0RzTf
K9qJYi6GwH_H1O51XGywGZ3c9BWE7zhHmY5w
Los vectores en verde no son obligatorios y depende del proceso de implantación
Ejemplo de cuerpo:
{
“lDetalle”:[
{
“Nvfac_dcop”:1,
“Nvpro_codi”:”144652.0005.150”,
“Nvpro_nomb”:”SAMANTA”,
“Nvuni_desc”:”MT”,
“Nvfac_cant”:12,
“Nvfac_valo”:”20000.00”,
“Nvfac_pdes”:0,

“Nvfac_desc”:”0.00”,
“Nvfac_stot”:”240000.00”,
“Nvimp_cdia”:”01”,
“Nvdet_piva”:”19.00”,
“Nvdet_viva”:”45600.00”,
“Nvdet_tcod”:””,
“Nvpro_cean”:””,
“Nvdet_entr”:””,
“Nvdet_nota”:””,
“Nvdet_padr”:””,
“Nvdet_marc”:””,
“Nvdet_mode”:””,
“Nvuni_quan”:0,
“lLotesDetalle”: [
{
“Nvlot_seri”: “”,
“Nvlot_loid”: “L20180705”,
“Nvlot_expr”: “2018-07-05T00:00:00.00”,
“Nvlot_nomb”: “Cant”,
“Nvlot_quan”: “2”
},
{
“Nvlot_loid”: “L20170705”,
“Nvlot_expr”: “2018-07-05T00:00:00.00”,
}
],
“lAdicionalDetalle”:[
{
“Nvfac_atri”:”1”,
“Nvfac_vatr”:”50”,
“Nvfac_natr”:”Valor1”
},
{
}],
“lImpuestosDetalle”:[
{
“Nvimp_desc”:”INC”,
“Nvimp_oper”:”R”,
“Nvimp_base”:”240000.00”,
“Nvimp_porc”:8,
“Nvimp_valo”:”19200.00”
}]
},

{
“Nvfac_dcop”:3,
“Nvpro_codi”:”4054.0005.150”,
“Nvpro_nomb”:”ENTRETELA 5125 FREUDENBERG”,
“Nvfac_cant”:1,
“Nvfac_valo”:”3550.00”,
“Nvfac_pdes”:0,
“Nvfac_stot”:”3550.00”,
“Nvdet_viva”:”674.50”,
“Nvuni_quan”:0,
“Nvdet_orde”:””,
“Nvdet_rece”:””,
{
},
{
}],
{
“Nvimp_base”:”240000.00”,
“Nvimp_porc”:8,
“Nvimp_valo”:”19200.00”
}]
},
{
“Nvfac_dcop”:4,
“Nvpro_codi”:”19384.0401.160”,
“Nvpro_nomb”:”FRANELA LYCRA CENTAURO”,
“Nvfac_cant”:3,

“Nvfac_valo”:”2765.00”,
“Nvfac_pdes”:0,
“Nvfac_stot”:”8295.00”,
“Nvdet_viva”:”1576.05”,
“Nvuni_quan”:0,
{
},
{
}],
{
“Nvimp_base”:”240000.00”,
“Nvimp_porc”:8,
“Nvimp_valo”:”19200.00”
}]
},
{
“Nvfac_dcop”:5,
“Nvpro_codi”:”19384.7821.160”,
“Nvfac_cant”:3.69,
“Nvfac_valo”:”11000.00”,
“Nvfac_pdes”:0,
“Nvfac_stot”:”40623.00”,

“Nvdet_viva”:”7718.37”,
“Nvuni_quan”:0,
{
},
{
}],
{
“Nvimp_base”:”240000.00”,
“Nvimp_porc”:8,
“Nvimp_valo”:”19200.00”
}]
}],
“lImpuestos”:[
{
“Nvimp_desc”:”IVA”,
“Nvimp_oper”:”S”,
“Nvimp_base”:”292468.00”,
“Nvimp_porc”:16,
“Nvimp_valo”:”46795.00”
},
{
“Nvimp_desc”:”Retención en la fuente”,
“Nvimp_base”:”292468.00”,
“Nvimp_valo”:”29247.00”
}],
“lCodigoBarras”:[
{
”Nvbar_cons” : “1”,

“Nvbar_codi”: “(415)779900005553(8020)01359587868125028140(3900)00000000056080”
}],
“TerminosEntrega”: {
“Nvter_inco”: “FOB”,
“Nvter_entr”: “PUERTO COLOMBIA”
},
“MediosPago”: {
“Nvmed_banc”: “BANCOLOMBIA”,
“Nvmed_cuen”: “64648564648”,
“Nvmed_name”: “CTA CTE-64648564648”
},
“Entrega”: {
“Nvent_terc”: “Carlos Alfonso Suarez”,
“Nvent_dire”: “Calle 13 N° 70 – 56 BODEGA 15”,
“Nvent_iden”: “8905588225”,
“Nvent_ciud”: “Bogota”,
“Nvent_pais”: “Colombia”,
“Nvent_tele”: “3202051571”,
“Nvent_pnet”: “15”,
“Nvent_pbru”: “17”,
“Nvent_puni”: “KGM”,
“Nvent_paic”: “170”,
“Nvent_zipc”: “11001”,
“Nvent_orig”: “Bogotá, Colombia”,
“Nvent_tran”: “Camión”,
“Nvent_fech”: “2020-05-15”
},
“lResumenFactura”:[{
“Nvres_cont”:”1”,
“Nvres_unim”:”Empaques”,
“Nvres_cant”:”100”
},{
“Nvres_unim”:”sacos”,
}],
“TasaCambio”:{
“Nvtas_sour”: “COP”,
“Nvtas_targ”: “USD”,
“Nvtas_calc”: “2800”,
“Nvtas_fech”: “2018-01-01”
},”lAranceles”:[{
“Nvara_orig”: “3920430000”,
“Nvara_dest”: “3920.43.50.00”,
“Nvara_desc”: “Plastico”,
“Nvara_valo”: “18”
}],
“Nvfac_orig”:”E”,
“Nvemp_nnit”:”830000001”,

“Nvres_nume”:”1122334455”,
“Nvfac_tipo”:”FE”,
“Nvfac_tcru”:””,
“Nvfac_cdet”:”4”,
“Nvfac_nume”:”00010RI514”,
“Nvfac_fech”:”2020-05-08T14:14:02”,
“Nvfac_venc”:”2020-05-08T00:00:00”,
“Nvper_fini”:”2020-01-01”,
“Nvper_ffin”:”2020-12-31”,
“Nvsuc_codi”:”1011200”,
“Nvmon_codi”:”COP”,
“Nvfor_codi”:”2”,
“Nvven_nomb”:””,
“Nvfac_fpag”:”10”,
“Nvcli_cper”:”1”,
“Nvcli_cdoc”:”31”,
“Nvcli_docu”:”830000001-0”,
“Nvcli_pais”:””,
“Nvcli_depa”:”Valle del cauca””,
“Nvcli_ciud”:”Cali@76001”,
“Nvcli_loca”:””,
“Nvcli_dire”:””,
“Nvcli_regi”:””,
“Nvcli_fisc”:””,
“Nvcli_nomb”:”nombre de adquiriente”,
“Nvcli_pnom”:””,
“Nvcli_snom”:””,
“Nvcli_apel”:””,
“Nvcli_mail”:”correo@correo.com”
“Nvema_copi”:”correo@correo.com”,
“Nvfac_obse”:””,
“Nvfac_orde”:””,
“Nvfac_remi”:””,
“Nvfac_rece”:””,
“Nvfac_entr”:””,
“Nvfac_stot”:”292468.00”,
“Nvdes_codi”: “”,
“Nvfac_anti”:”0.00”,
“Nvfac_carg”:”0.00”,
“Nvfac_tota”:”0.00”,
“Nvfac_totp”:”310016.00”,
“Nvfac_vcop”: “0”,
“Nvfac_coid”:””,
“Nvfac_numb”:””,
“Nvfac_fecb”:”1899-12-31T00:00:00”,
“Nvcon_codi”:””,
“Nvcon_desc”:””,
“Nvfac_obsb”:””,
“lAdicionales”:[

{
“Nvfac_vatr”:”VFS768”
},
{
“Nvfac_vatr”:”2017/11/10”
}],
“Referencia”: {
“Nvref_codi”: “789456”
}
}
b. Consumo del servicio mediante SOAP
Especificación técnica petición del servicio web Invoice (factura de venta):

URL: https://{instancia}/{instancia}/services/FacFacturas.asmx
WSDL: https://{instancia}/{instancia}/services/FacFacturas.asmx?wsdl
Metodo: SetFacFacturas
<soapenv:Envelope xmlns:soapenv=”http://schemas.xmlsoap.org/soap/envelope/”
xmlns:noov=”http://Noova/”>
<soapenv:Header>
<noov:AuthHeader>
<!–Usuario base64:→
<noov:Username>dXN1YXJpb19pbnRlZ3JhY2lvbg==</noov:Username>
<!–Password base64:→
<noov:Password>cGFzc3dvcmRfaW50ZWdyYWNpb24=</noov:Password>
</noov:AuthHeader>
</soapenv:Header>
<soapenv:Body>
<noov:SetFacFacturas>
<noov:dtoFacFacturasInput>
<noov:lDetalle>
<noov:DTOFacDetallefacturas>
<noov:lAdicionalDetalle>
<noov:DTOFacAdicionalesdetallefacturas>
<noov:Nvfac_atri>1</noov:Nvfac_atri>
<noov:Nvfac_vatr>AZUL</noov:Nvfac_vatr>
<noov:Nvfac_natr>Color</noov:Nvfac_natr>
</noov:DTOFacAdicionalesdetallefacturas>
</noov:lAdicionalDetalle>
<noov:Nvfac_dcop>1</noov:Nvfac_dcop>
<noov:Nvpro_codi>555522</noov:Nvpro_codi>
<noov:Nvpro_nomb>Procucto 1</noov:Nvpro_nomb>
<noov:Nvuni_desc>CAJA</noov:Nvuni_desc>
<noov:Nvfac_cant>10</noov:Nvfac_cant>
<noov:Nvfac_valo>25000</noov:Nvfac_valo>
<noov:Nvfac_pdes>0</noov:Nvfac_pdes>
<noov:Nvfac_desc>0</noov:Nvfac_desc>
<noov:Nvfac_stot>250000</noov:Nvfac_stot>
<noov:Nvimp_cdia >01</noov:Nvimp_cdia>
<noov:Nvdet_piva>19</noov:Nvdet_piva>
<noov:Nvdet_viva>47500</noov:Nvdet_viva>
<noov:Nvdet_tcod></noov:Nvdet_tcod>
<noov:Nvdet_entr></noov:Nvdet_entr>
<noov:Nvpro_cean></noov:Nvpro_cean>
<noov:Nvdet_padr></noov: Nvdet_padr>
<noov:Nvdet_nota></noov:Nvdet_nota>
<noov:Nvdet_marc></noov:Nvdet_marc>
<noov:Nvdet_mode></noov:Nvdet_mode>
<noov:Nvdet_orde></noov:Nvdet_orde>
<noov:Nvdet_rece></noov:Nvdet_rece>
</noov:DTOFacDetallefacturas>
<noov:Nvfac_vatr>ROJO</noov:Nvfac_vatr>
<noov:lLotesDetalle>
<noov:DTOFacLotesdetallefacturas>
<noov:Nvlot_seri>01</noov:Nvlot_seri>
<noov:Nvlot_loid>L20180705</noov:Nvlot_loid>
<noov:Nvlot_expr>2018-07-05</noov:Nvlot_expr>
<noov:Nvlot_nomb>Cant</noov:Nvlot_nomb>
<noov:Nvlot_quan>2</noov:Nvlot_quan>
</noov:DTOFacLotesdetallefacturas>
</noov:lLotesDetalle>
<noov:lImpuestosDetalle>
<noov:DTOFacImpuestosdetallefacturas>
<noov:Nvimp_cdia>04</noov:Nvimp_cdia>
<noov:Nvimp_desc>INC</noov:Nvimp_desc>
<noov:Nvimp_oper>S</noov:Nvimp_oper>
<noov:Nvimp_base>2548</noov:Nvimp_base>
<noov:Nvimp_porc>8</noov:Nvimp_porc>
<noov:Nvimp_valo>125</noov:Nvimp_valo>
</noov:DTOFacImpuestosdetallefacturas>
</noov:lImpuestosDetalle>

<noov:Nvimp_cdia >01</noov:Nvimp_cdia>
<noov:Nvdet_tcod></noov:Nvdet_tcod>
<noov:Nvdet_entr></noov:Nvdet_entr>
<noov:Nvpro_cean></noov:Nvpro_cean>
<noov:Nvdet_padr></noov: Nvdet_padr>
<noov:Nvdet_nota></noov:Nvdet_nota>
<noov:Nvdet_marc></noov:Nvdet_marc>
<noov:Nvdet_mode></noov:Nvdet_mode>
<noov:Nvdet_orde></noov:Nvdet_orde>
<noov:Nvdet_rece></noov:Nvdet_rece>
</noov:lDetalle>
<noov:lImpuestos>
<noov:DTOFacImpuestosfacturas>
<noov:Nvimp_desc>IVA</noov:Nvimp_desc>
</noov:DTOFacImpuestosfacturas>
</noov:lImpuestos>
<noov:lAdicionales>
<noov:DTOFacAdicionalesfacturas>
<noov:Nvfac_vatr>Orden de venta 52258</noov:Nvfac_vatr>
</noov:DTOFacAdicionalesfacturas>
</noov:lAdicionales>
<noov:lCodigoBarras>
<noov:DTOFacBarcode>
<noov:Nvbar_cons>1</noov:Nvbar_cons>
<noov:Nvbar_codi>(797)9585879587858(788)90678969(698)98696</noov:Nvbar_codi>
</noov:DTOFacBarcode>
</noov:lCodigoBarras>
<noov:TerminosEntrega>
<noov:Nvter_entr>FOB</noov:Nvter_entr>
<noov:Nvter_inco>PUERTO COLOMBIA</noov:Nvter_inco>
</noov:TerminosEntrega>
<noov:MediosPago>
<noov:Nvmed_banc>BANCOLOMBIA</noov:Nvmed_banc>
<noov:Nvmed_cuen>22555886698</noov:Nvmed_cuen>
<noov:Nvmed_name>CTA CTE-
22555886698</noov:Nvmed_name>
</noov:MediosPago>
<noov:Entrega>

<noov:Nvent_terc>Carlos Alfonso Suarez</noov:Nvent_terc>
<noov:Nvent_dire>Casa de los libertadores</noov:Nvent_dire>
<noov:Nvent_iden>8905588225</noov:Nvent_iden>
<noov:Nvent_ciud>Bogota</noov:Nvent_ciud>
<noov:Nvent_pais>Colombia</noov:Nvent_pais>
<noov:Nvent_tele>3202051571</noov:Nvent_tele>
<noov:Nvent_pnet>15</noov:Nvent_pnet>
<noov:Nvent_pbru>17</noov:Nvent_pbru>
<noov:Nvent_puni>KGM</noov:Nvent_puni>
<noov:Nvent_paic>170</noov:Nvent_paic>
<noov:Nvent_zipc>11001</noov:Nvent_zipc>
<noov:Nvent_orig>Bogotá, Colombia</noov:Nvent_orig>
<noov:Nvent_tran>Camión</noov:Nvent_tran>
<noov:Nvent_fech>2020-05-15</noov:Nvent_fech>
</noov:Entrega>
<noov:TasaCambio>
<noov:Nvtas_sour>USD</noov:Nvtas_sour>
<noov:Nvtas_targ>COP</noov:Nvtas_targ>
<noov:Nvtas_calc>2899</noov:Nvtas_calc>
<noov:Nvtas_fech>2018-01-01</noov:Nvtas_fech>
</noov:TasaCambio>
<noov:lResumenFactura>
<noov:DTOFacResumenFacturas>
<noov:Nvres_cont>1</noov:Nvres_cont>
<noov:Nvres_unim>Bolsas</noov:Nvres_unim>
<noov:Nvres_cant>20</noov:Nvres_cant>
</noov:DTOFacResumenFacturas>
<noov:DTOFacResumenFacturas>
<noov:Nvres_cont>2</noov:Nvres_cont>
<noov:Nvres_unim>Cajas</noov:Nvres_unim>
<noov:Nvres_cant>2</noov:Nvres_cant>
</noov:DTOFacResumenFacturas>
</noov:lResumenFactura>
<noov: lAranceles>
<noov: DTOArancel>
<noov:Nvara_orig>3920430000</noov:Nvara_orig>
<noov:Nvara_dest>3920.43.50.00</noov:Nvara_dest>
<noov:Nvara_desc>Plastico</noov:Nvara_desc>
<noov:Nvara_valo>18</noov:Nvara_valo>
</noov: DTOArancel>
</noov: lAranceles>
<noov:Nvfac_orig>E</noov:Nvfac_orig>
<noov:Nvemp_nnit>900100200</noov:Nvemp_nnit>
<noov:Nvfac_tipo>FV</noov:Nvfac_tipo>
<noov:Nvfac_fech>2020-05-08</noov:Nvfac_fech>
<noov:Nvfac_venc>2020-05-30</noov:Nvfac_venc>
<noov:Nvper_fini>2020-01-01</noov:Nvper_fini>
<noov:Nvper_ffin>2020-12-31</noov:Nvper_ffin >
<noov:Nvfac_cdet>2</noov:Nvfac_ cdet>
<noov:Nvcli_cper>2</noov:Nvcli_cper>

<noov:Nvcli_cdoc>31</noov:Nvcli_cdoc>
<noov:Nvcli_docu>80019310-0</noov:Nvcli_docu>
<noov:Nvcli_mail>mail@mail.com</noov:Nvcli_mail>
<noov:Nvema_copi >mail@mail.com</noov:Nvema_copi>
<noov:Nvcli_depa>VALLE</noov:Nvcli_depa>
<noov:Nvcli_ciud>CALI@76001</noov:Nvcli_ciud>
<noov:Nvcli_loca>.</noov:Nvcli_loca>
<noov:Nvcli_pais>CO</noov:Nvcli_pais>
<noov:Nvcli_dire>Direccion del adquiriente</noov:Nvcli_dire>
<noov:Nvcli_ntel>225588558</noov:Nvcli_ntel>
<noov:Nvcli_ncon>Luis Gabriel</noov:Nvcli_ncon>
<noov:Nvcli_regi>1</noov:Nvcli_regi>
<noov:Nvcli_fisc>O-99</noov:Nvcli_fisc>
<noov:Nvcli_nomb>Luis Gabriel Villegas</noov:Nvcli_nomb>
<noov:Nvcli_pnom>Luis</noov:Nvcli_pnom>
<noov:Nvcli_snom>Gabriel</noov:Nvcli_snom>
<noov:Nvcli_apel>Villegas</noov:Nvcli_apel>
<noov:Nvfac_nume>PRUE98002585</noov:Nvfac_nume>
<noov:Nvres_nume>155225458</noov:Nvres_nume>
<noov:Nvdes_codi>0</noov:Nvdes_codi>
<noov:Nvfac_anti>0</noov:Nvfac_anti>
<noov:Nvfac_carg>0</noov:Nvfac_carg>
<noov:Nvfac_tota>500000</noov:Nvfac_tota>
<noov:Nvfac_totp>595000</noov:Nvfac_totp>
<noov:Nvfac_vcop>0</noov:Nvfac_vcop>
<noov:Nvfac_obse>Pagar contra entrega</noov:Nvfac_obse>
<noov:Nvven_nomb>.</noov:Nvven_nomb>
<noov:Nvsuc_codi>01</noov:Nvsuc_codi>
<noov:Nvfac_fpag>10</noov:Nvfac_fpag>
<noov:Nvmon_codi>COP</noov:Nvmon_codi>
<noov:Nvfor_codi>1</noov:Nvfor_codi>
<noov:Nvfac_orde>0</noov:Nvfac_orde>
<noov:Nvfac_remi></noov:Nvfac_remi>
<noov:Nvfac_rece></noov:Nvfac_rece>
<noov:Nvfac_entr></noov:Nvfac_entr>
<noov:Referencia>
<noov:DTOFacReferencia>
<noov:Nvref_codi>789456</noov:Nvref_codi>
</noov:DTOFacReferencia >
</noov:Referencia>
</noov:dtoFacFacturasInput>
</noov:SetFacFacturas>
</soapenv:Body>
</soapenv:Envelope>
Tabla relación de atributos en la petición:

Nombre del
DTOFacFacturas
Objeto
CAMPO DESCRIPCIÓN TIPO DE DATO TAMAÑO OBLIGATORIO OBSERVACIONES

E=Enterprise, P=Pyme,
Esta propiedad es
utilizada por la integración
para realizar, la
canalización al modelo de
implantación realizado con
la empresa, cuando es un
sistema de información el
que controla la
información del proceso
de facturación se envía E,
si la plataforma es la que
valida los clientes,
productos es utilizado la
NVFAC_ORIG Tipo de Servicio String 1 S integración con P.
Número del Nit del
obligado a facturas, no
debe llevar digito de
NVEMP_NNIT Código Empresa Int 10 S chequeo
NVRES_NUME Número Resolución Facturación String 40 S Valido solo para números
FV= Factura de Venta,
FE=Factura Exportación,
NVFAC_TIPO Tipo de Documento Factura String 2 S FC=Factura Contingencia
Debe incluir el prefijo y no
debe contener
separadores como
NVFAC_NUME Corresponde al Número de Factura String 40 S guiones o espacios
Formato UTC “YYYY-MM-
NVFAC_FECH Fecha y Hora de Emisión de Factura Datetime 0 S DDTHH:MM:SS”
La cantidad total de
Cantidad de líneas de detalles de la detalles enviados en el
NVFAC_CDET Factura Int 1 S documento electronico
NVFAC_VENC Fecha de Vencimiento Datetime 0 S DDTHH:MM:SS”
NVPER_FINI Inicio período de facturación Datetime 0 N DDTHH:MM:SS”
NVPER_FFIN Fin período de facturación Datetime 0 N DDTHH:MM:SS”
NVSUC_CODI Código Sucursal String 50 S
COP=Peso colombiano,
USD= Dólar EEUU
NVMON_CODI Código Estándar Internacional Moneda String 3 S (estándar ISO 4217)
NVFOR_CODI Formato de Impresión String 10 S
NVVEN_NOMB Nombre Vendedor String 250 S
Tabla DIAN – Formas de
Pago, (1 Instrumento no
definido 10 Efectivo, 20
Cheque, 41 Transferencia
bancaria, 42 Consignación
bancaria) (Estándar 4461
de UN/CEFACT versión
06B), Sí no esta presente
sigue las reglas de
NVFAC_CONV si es 0,
tomara por defecto el valor
1, obligatorio si
NVFAC_FPAG Forma de Pago String 2 S NVFAC_CONV = 1
Tabla de DIAN de la
condición de venta
(1=Contado, 2=crédito)
Sí no esta presente o es 0
(cero) se calcula la
NVFAC_CONV Condición de venta string 5 S diferencia de

NVFAC_FECH y
NVFAC_VENC, si dicha
diferencia es 0 se
determina que es
Contado(1), si es mayor a
cero se determina que es
Crédito (2).
NVCLI_CPER Clase Persona Adquiriente SmallInt 4 S 1=Jurídica, 2=Natural
Tabla DIAN – Tipos
Documento (11 Registro
civil, 12 Tarjeta de
identidad, 13 Cédula de
ciudadanía, 21 Tarjeta de
extranjería, 22 Cédula de
extranjería, 31 NIT, 41
Pasaporte, 42 Documento
de identificación
NVCLI_CDOC Código Documento SmallInt 4 S extranjero)
Número del documento
del adquiriente, cedula o
NIT, si el documento es
NIT enviar digito de
verificación separado por
NVCLI_DOCU Número de Documento String 20 S guion (-)
CO=Colombia, CL=Chile,
Código Estándar Internacional País (estándar ISO 3166-1, en
NVCLI_PAIS Adquiriente String 2 S formato 2 dígitos)
Nombre del departamento
NVCLI_DEPA Departamento Adquiriente String 40 S del cliente
Nombre de la cuidad con
el código de la cuidad
separado por el carácter
‘@’ Ejemplo:
BOGOTA@11001.
Cuando la factura es de
exportación tipo FE, el
valor de este campo no
debe llevar la información
de complemento de
código de ciudad DANE a
NVCLI_CIUD Ciudad Adquiriente String 40 S partir de la arroba (@)
Si no se tiene se envía en
NVCLI_LOCA Localidad Adquiriente String 40 S blanco
NVCLI_DIRE Dirección Adquiriente String 250 S
Es el número de teléfono
del adquiriente para que
salga en la representación
NVCLI_NTEL Teléfono Adquiriente String 200 N grafica
Corresponde al nombre
del contacto que saldrá en
NVCLI_NCON Nombre del contacto del adquiriente String 200 N la representación grafica
Tabla DIAN – Régimen
Tributario (48 responsable
del impuesto sobre las
ventas –IVA, 49 No
NVCLI_REGI Régimen Tributario Adquiriente SmallInt 4 S responsable de IVA )
Tabla DIAN – Uno o más
códigos de las
responsabilidades fiscales
del Adquiriente,
separadas por punto y
coma. Ej.: 0-99;0-39. Si
este dato no se envía, por
defecto se enviará en el
XML 0-99 (otro tipo de
obligado)
Código Responsabilidades fiscales del Ver tabla
NVCLI_FISC Adquiriente String 400 N Responsabilidades

Si es una Persona
NVCLI_NOMB Razón Social Cliente String 250 S Natural, va en blanco
Si es una Razón Social,
NVCLI_PNOM Primer Nombre String 100 S va en blanco
NVCLI_SNOM Segundo Nombre String 100 S va en blanco
NVCLI_APEL Apellidos String 100 S va en blanco
Correo electrónico de
notificación del
documento, en caso de
requerir más de una
dirección deben estar
separadas por “;” (punto y
NVCLI_MAIL Mail de Notificación Adquiriente String 250 S coma)
notificación del
NVEMA_COPI Mail al que se enviara copia de la factura String 250 N coma)
Texto libre para adicionar
a los documentos
NVFAC_OBSE Observaciones String 4000 S descripciones
Número de orden de
NVFAC_ORDE Orden de compra String 40 N compra
Número de remisión “Especial”, Número de
NVFAC_REMI (cac:AdditionalDocumentReference/cbc:ID) String 40 N remisión de la mercancía
“Especial”, Nota de
Nota de recepción recepción o aviso de
NVFAC_RECE (cac:ReceiptDocumentReference/cbc:ID) String 40 N recibo
EAN tienda entrega “Especial”, EAN tienda
NVFAC_ENTR (fe:Delivery/fe:DeliveryLocation/cbc:ID) String 40 N entrega
Este campo corresponde
al resultado de las
NVFAC_STOT Subtotal Factura Float 12,2 S (cantidades*valor)
Código de descuento
aplicado, obligatorio si
NVFAC_DESC > 0
Tabla códigos descuento

NVDES_CODI Código de descuento String 2 S DIAN
al valor total de los
descuentos condicionados
a la factura. Este valor se
resta del total a pagar
después de calculados los
impuestos y retenciones,
EJ: subtotal 4200000 +
IVA 798000 = total
4998000, a este valor se
resta el descuento
condicionado de la
factura: 4998000 –
descuento 1000000 = total
a pagar 3998000. Estos
descuentos condicionados
son diferentes a los
descuentos que se
Descuentos Factura Condicionales manejan por detalle o ítem
NVFAC_DESC (Comerciales) Float 12,2 S en la factura.
al valor total de los
anticipos pagados a la
factura. Este valor se resta
del total a pagar después
NVFAC_ANTI Total, de los anticipos Float 12,2 N de calculados los

impuestos y retenciones,
EJ: subtotal 4200000 +
IVA 798000 = total
4998000, a este valor se
resta el anticipo de la
factura: 4998000 –
anticipo 1000000 = total a
pagar 3998000.
Este campo es el valor
NVFAC_CARG Total, de fletes Float 12,2 N total de fletes
al resultado de las
(cantidades*valor)
corresponde al mismo
valor del campo
NVFAC_TOTA Subtotal Factura Float 12,2 S NVFAC_STOT
al valor total del
documento después de
descuentos, anticipos e
NVFAC_TOTP Total, Factura a pagar Float 12,2 S impuestos
Es el valor de la moneda
de recaudo si se requiere
mostrar en moneda
NVFAC_VCOP Valor en la moneda de recaudo Float 12,2 N diferente al valor a pagar.
El valor total incluido
NVFAC_TIMP Valor total incluido en el impuesto Float 12.2 N impuestos
Código de Contingencia Entregado por la Solo si es Factura
NVFAC_COID DIAN String 20 N Contingencia
Solo si es Factura
NVFAC_NUMB Número de Documento Referenciado String 40 N Contingencia
Solo si es Factura
Contingencia, Formato
UTC “YYYY-MM-
NVFAC_FECB Fecha de Documento Referenciado Date 0 N DDTHH:MM:SS”
Solo si es Factura
NVFAC_OBSB Observaciones Contingencia String 250 N Contingencia
Lista del detalle de la
lDetalle Lista de objetos Detalle de la factura List<lDetalle> S factura
Lista de objetos Lista de impuestos
lImpuestos Detalle de impuestos List<lImpuestos> N totalizados de la factura
Lista de objetos adicionales a los campos Detalle de campos Lista de campos
lAdicionales de la estructura base del objeto maestro adicionales N adicionales
Lista de código de barras
que se creara en el
reporte para recaudo por
lCodigoBarras Lista de objetos código de barras List<lCodigoBarras> N bancos
Objeto que representa los
terminios de entrega en
TerminosEntrega Objeto términos de entrega TerminosEntrega N exportaciones
MediosPago Medio de pago esperado MediosPago N Medios de pago esperado,
Ligar y persona de entrega de la
Entrega mercancia Entrega N Entrega de la mercancia
DETALLE FACTURA
Nombre del List<DTOFacDetallefacturas>

Objeto lDetalle
CAMPO DESCRIPCIÓN TIPO DE TAM OBLIG OBSERVACIONES
DATO AÑO ATORI
O
NVFAC_DCOP Consecutivo Detalle por SmallInt 4 S Este consecutivo se utilizará para ordenar el detalle en
Factura las facturas
NVPRO_CODI Código de Producto String 40 S

NVPRO_NOM Descripción del Producto String 250 S
B
NVUNI_DESC Unidad de Medida String 40 S
NVFAC_CANT Cantidad Float 8.2 S
NVFAC_VALO Valor Unitario Producto Float 12.2 S
NVIMP_CDIA Código del impuesto String 2 S Código de impuesto aplicado en el detalle referenciado
(01 IVA, 04 Ipoconsumo, 22 Impuesto a las bolsas
plásticas, 00 Productos Excluidos)
Ver Tabla de tributos

NVFAC_PDES Porcentaje Descuento Float 3.2 S porcentaje del descuento
NVFAC_DESC Valor Descuento Float 12.2 S Valor del descuento (cantidad*valor)*porcentaje
NVFAC_STOT Valor Total por Detalle Float 12.2 S Incluye el valor del descuento, es el valor final del
detalle, (cantidad*valor)-descuentos
NVDET_PIVA Porcentaje de impuesto Float 12.2 N Porcentaje del impuesto (IVA- 01 o Ipoconsumo – 04),
aplicado al total por detalle numero entero, ejemplo 19
NVDET_VIVA Valor calculado del impuesto Float 12.2 N Valor del Impuesto (IVA- 01 o Ipoconsumo – 04).
aplicado por detalle
NVDET_TCOD Número de aviso de recibo String 40 N Número de aviso de recibo
(fe:InvoiceLine/cac:DocumentR
eference/cbc:ID)
NVPRO_CEAN EAN del 22ínea22t String 40 N EAN del producto
(fe:InvoiceLine/fe:Item/cac:Stan
dardItemIdentification/cbc:ID)
NVDET_ENTR EAN de la dependencia String 40 N EAN de la dependencia
(fe:InvoiceLine/cac:Delivery/cac
:DeliveryLocation/cbc:ID)
NVUNI_QUAN Cantidades pedidas (unidad de Float 12.2 N Cantidad de productos por cada unidad de empaque.
empaque)
(/fe:InvoiceLine/fe:Item/cbc:Pac
kQuantity)
NVDET_NOTA Nota de la 22ínea String 4000 N Nota de la linea
(fe:InvoiceLine/cbc:Note)
NVDET_PADR Número asociado con el Int N En el caso de requerir reportar kits, en este número debe
número del detalle llevar asociado el detalle padre del kit
NVDET_MARC Marca String 250 N Debe ser enviado en las facturas de exportación, de lo
contrario recibirá notificación, (advertencia) de parte de
la DIAN en la respuesta, pero no es bloqueante para la
validación previa.
NVDET_MODE Modelo String 250 N Debe ser enviado en las facturas de exportación, de lo
contrario recibirá notificación, (advertencia) de parte de
la DIAN en la respuesta, pero no es bloqueante para la
validación previa.
NVDET_ORDE Numero de orden de compra 40 N Construe
por detalle <cac:OrderLineReference><cbc:LineID>1</cbc:LineID>
<cac:OrderReference><cbc:ID>ORDEN 1</cbc:ID>
NVDET_RECE Numero de recepción por 40 N <cac:ReceiptLineReference><cbc:LineID>1</cbc:LineI
detalle D><cac:DocumentReference><cbc:ID>RECEPCION
1</cbc:ID>
lAdicionalDetall Lista de campos adicionales a List<lAdicio N Lista de detalle que se asocian a cada detalle, se utiliza
e cada detalle nalDetalle> para enviar propiedades que no están en cada detalle
lLotesDetalle Lista de campos especificando List<lLotesD N Lista de lotes que se asocia a cada detalle
lotes de cada detalle etalle>

lImpuestosDeta Lista impuestos asociados a List<lImpue N Este vector se puede utilizar para reportar impuestos
lle cada detalle stosDetalle> que no se relacionan en el detelle en las propiedades
Nvdet_piva, Nvdet_viva, un uso puede ser que se
reporte el iva en las propiedades del detalle y en esta
lista el Impuesto nacional al consumo
CAMPOS ADICIONALES DEL DETALLE

Nombre del List<DTOFacAdicionalesfacturas>
Objeto lAdicionalDetalle
CAMPO DESCRIPCIÓN TIPO DE TAMAÑO OBLIGATORIO OBSERVACIONES
DATO
NVFAC_ATRI Consecutivo Atributo SmallInt 4 S
NVFAC_VATR Valor Atributo String 250 S
NVFAC_NATR Nombre Atributo String 250 N
Lotes y Seriales
Nombre del List<DTOFacLotesdetallefacturas>
Objeto lLotesDetalle
Nvlot_Seri Código de identificación Serial String 40 S
Nvlot_loid Código de identificación del lote String 40 S
Nvlot_expr Fecha de expiración Date S Formato UTC
“YYYY-MM-
DDTHH:MM:SS”
Nvlot_nomb Unidad de medida usada en el lote String 40 S
Nvlot_quan Cantidad de medida usada en el lote Float 12.2 S
IMPUESTOS DETALLE FACTURA

Nombre del List<DTOFacImpuestosfacturas>
Objeto lImpuestosDetalle
DATO
NVIMP_CDIA Código Impuesto String 2 S Tabla de impuestos de la
Dian (01 VALOR TOTAL DE
IVA
03 VALOR TOTAL DE ICA
04 VALOR TOTAL DE
IMPUESTO AL CONSUMO
05 RETENCIÓN EN LA
FUENTE POR IVA
06 RETENCIÓN EN LA
FUENTE POR RENTA
07 RETENCIÓN EN LA
FUENTE POR ICA, 00
Productos Excluidos)
NVIMP_DESC Nombre del Impuesto String 40 S
NVIMP_OPER Operación Impuesto (S=Suma, String 1 S
R=Resta)
NVIMP_BASE Valor Base Impuesto Float 12.2 S Valor total base del mismo
impuesto
NVIMP_PORC Porcentaje Impuesto Float 3.2 S porcentaje aplicado al valor
base

NVIMP_VALO Valor Impuesto Float 12.2 S valor del impuesto (valor
base*porcentaje)
IMPUESTOS FACTURA
Objeto lImpuestos
DATO
NVIMP_CDIA Código Impuesto String 2 S Tabla de impuestos de la
Dian (01 VALOR TOTAL DE
IVA
04 VALOR TOTAL DE
IMPUESTO AL CONSUMO
05 RETENCIÓN EN LA
FUENTE POR IVA
06 RETENCIÓN EN LA
FUENTE POR RENTA
07 RETENCIÓN EN LA
FUENTE POR ICA)
NVIMP_OPER Operación Impuesto (S=Suma, String 1 S
R=Resta)
NVIMP_BASE Valor Base Impuesto Float 12.2 S Valor total base del mismo
impuesto
NVIMP_PORC Porcentaje Impuesto Float 3.2 S porcentaje aplicado al valor
base
base*porcentaje)
CAMPOS ADICIONALES DEL MAESTRO

Objeto lAdicionales
DATO
CODIGO DE BARRAS
Nombre del List<DTOFacBarcode>
Objeto lCodigoBarras
DATO
NVBAR_CONS Consecutivo de código de barras, en SmallInt 4 S Cuando se requiere solo un
el caso que sean varios, de lo código de barras por
contrario se envía 1 representación se envía 1.
NVBAR_CODI Valor Atributo String 250 S Es la cadena de código que
se requiere representar en

los códigos de
barras, EAN128
TERMINOS DE ENTREGA
Nombre del DTOFacTerminosEntrega
Objeto TerminosEntrega
CAMPO DESCRIPCIÓN TIPO DE TAMAÑO OBLIGA OBSERVACIONES
DATO TORIO
NVTER_INCO Código Incoterms String 5 S Código incoterms, valores posibles
EXW,FCA,FAS,FOB,CFR,CIF,CPT,
CIP,DAT,DAP,DDP
NVTER_ENTR Lugar donde se entrega la mercancía String 250 S Es el lugar donde se entrega la
mercancía, Puerto y ciudad. Por
plataforma (PYME) este campo
equivale al valor de dirección de
entrega (Nvent_dire)
MEDIOS DE PAGO
Nombre del DTOFacMediosPago
Objeto MediosPago
DATO TORIO
NVMED_BANC Nombre del banco donde se recibe String 250 S
el pago
NVMED_CUEN Número de cuenta donde se recibe String 30 S
el pago
NVMED_NAME Nombre de la cuenta donde se string 100 S
recibe el pago
ENTREGA
Nombre del DTOFacEntrega
Objeto Entrega
DATO TORIO
NVENT_TERC Nombre del tercero que recibe String 250 S cac:delivery/cac:deliveryparty/cac:co
ntact/cbc:name
NVENT_DIRE Dirección del lugar de entrega String 250 S cac:delivery/cac:deliveryaddress/cac
:addressline/cbc:line
NVENT_IDEN Identificación del tercero que String 20 S cac:delivery/cac:deliveryparty/cac:co
recibe ntact/cbc:id
NVENT_CIUD Ciudad de entrega String 250 S cac:delivery/cac:deliveryaddress/cac
:cityname
NVENT_PAIS País de entrega String 250 S cac:delivery/cac:deliveryaddress/cac
:country/cbc:name
NVENT_TELE Teléfono del que recibe String 50 S cac:delivery/cac:deliveryparty/cac:co
ntact/cbc:telephone
NVENT_PNET Peso neto de la mercancía String 10 S cac:delivery/cac:shipment/cbc:netwei
ghtmeasure
NVENT_PBRU Peso bruto de la mercancía String 10 S cac:delivery/cac:shipment/cbc:gross
weightmeasure
NVENT_PUNI Unidad de peso, según tabla UBL String 20 S Unitcode valores posibles
http://www.datypic.com/sc/ubl20/a-
unitCode-3.html
NVENT_PAIC Código de país String 20 S cac:delivery/cac:deliveryaddress/cac
:country/cbc:identificationcode

NVENT_ZIPC Código de ciudad String 20 S cac:delivery/cac:deliveryaddress/cac
:postalzone
NVENT_ORIG Origen de mercancía String 250 S cac:delivery/cac:shipment/cac:origin
address/cac:addresline/cbc:line
NVENT_TRAN Medio de transporte String 250 S cac:delivery/cac:shipment/
cac:TransportHandlingUnit/
cac:TransportMeans/
cbc:TransportMeansTypeCode
NVENT_FECH Fecha de entrega Date S Formato UTC “YYYY-MM-
DDTHH:MM:SS”
…//cac:Delivery/cac:ActualD
eliveryDate
TASA DE CAMBIO
Nombre del DTOTasaCambio
Objeto TasaCambio
DATO TORIO
NVTAS_SOUR Código de la moneda desde donde String 3 S COP=Peso colombiano, USD= Dólar
se genera el cambio EEUU (estándar ISO 4217)
NVTAS_TARG Código de la moneda hacia donde String 3 S COP=Peso colombiano, USD= Dólar
se genera el cambio EEUU (estándar ISO 4217)
NVTAS_CALC Factor del cálculo de la moneda Float S Valor de la tase de cambio
NVTAS_FECH Fecha del valor de la tasa String 10 S Formato de la fecha YYYY-MM-DD
PARTIDA ARANCELARIA
Nombre del List<DTOArancel> lAranceles
Objeto
DATO TORIO
NVARA_ORIG Código partida origen String 20 N
NVARA_DEST Código partida destino String 30 N
NVARA_DESC Descripcion de la partida String 250 N
arancelaria
NVARA_VALO Valor de la partida arancelaria Float N
RESUMEN FACTURA
Nombre del List<DTOFacResumenFacturas>
Objeto lResumenFactura
DATO TORIO
NVRES_CONT Consecutivo del resumen int S
NVRES_UNIM Unidad de medida String 50 S
NVRES_CANT Cantidad float S
NOTAS
Nombre del List<DTOFacNotasFacturas>
Objeto lNotas
DATO TORIO
NVNOT_DESC Notas a la factura String 4000 S

REFERENCIA
Nombre del DTOFacReferencia
Objeto
DATO
NVREF_CODI Código/Número de referencia String 255 N
Respuesta del servicio
a. Respuesta servicio REST
Especificación técnica respuesta del servicio web Invoice (factura de venta):

Ejemplo de respuesta:
Cuerpo
JSON Respuesta fallida
{
"Result":1,
"Description":"Error al consumir: Forma de pago invalida, valores posibles '10', '20', '41', '42'",
"Id":"0",
"Cufe":"",
"QrCode":"",
“Signature”: “”,
“State”: “”,
“Validated”: “”
}
JSON Respuesta exitosa
{
"Result":0,
"Description":"",
"Id":"34456434",
”DocumentNumber”:”PREF00117836”,
“Reference”: “”
"Cufe":"1f5ff4dc691b8aa3e157b32a38e997bc63b7d1b4",
"QrCode":"NumFac:PREF00117836 FecFac: 20140319105605 NitFac: 808183133 DocAdq:
8081972684 ValFac: 1000.00 ValIva: 160.00 ValOtroIm: 0.00 ValFacIm: 1160.00 CUFE:
2836a15058e90baabbf6bf2e97f05564ea0324a6",
“Signature”:
“ZBYWey8Id83XOtY3ogDSwDEoTQ0+CKa7216atfGLF1SJhRXt8d0R2XH4K2DUBv7CHA6UeJQYw
YujobKiK5RouOhdoftgR4ZxaoXw8YWZJwfDaEyeOGuHFV4xWq9OS7jraweTb7ge0PaEfwYGS8my9
V5jwoAf0yd2TxIJX31B41L8reRydtU/lbHfyNeQ==”
, “State”:”Exitosa”
, “Validated”:”2019-07-16T16:20:58-05:00”
}
b. Respuesta servicio SOAP
Respuesta fallida
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<SetFacFacturasResponse xmlns="http://Noova/">
<SetFacFacturasResult>
<Result>1</Result>
<Description>Error al consumir: El usuario no es valido</Description>
<Id>0</Id>
<DocumentNumber/>
<Cufe/>
<Cufe/>
<Signature/>
<State/>
<Validated/>
</SetFacFacturasResult>
</SetFacFacturasResponse>
</soap:Body>
</soap:Envelope>

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<SetFacFacturasResponse xmlns="http://Noova/">
<SetFacFacturasResult>
<Result>0</Result>
<Description></Description>
<Id>352258</Id>
<DocumentNumber>SEPT254848<DocumentNumber/>
<Reference>789456</Reference>
<Cufe>1f5ff4dc691b8aa3e157b32a38e997bc63b7d1b4<Cufe/>
<Signature>
ZBYWey8Id83XOtY3ogDSwDEoTQ0+CKa7216atfGLF1SJhRXt8d0R2XH4K2DUBv7CHA6UeJQYwYuj
obKiK5RouOhdoftgR4ZxaoXw8YWZJwfDaEyeOGuHFV4xWq9OS7jraweTb7ge0PaEfwYGS8my9V5jwo
Af0yd2TxIJX31B41L8reRydtU/lbHfyNeQ==<Signature/>
<State>Exitoso<State/>
<Validated>2019-07-16T16:20:58-05:00<Validated/>
</SetFacFacturasResult>
</SetFacFacturasResponse>
</soap:Body>
</soap:Envelope>
RESPUESTA SERVICIO
CAMPO DESCRIPCIÓN
RESULT 1=Ocurrió un Error, 0 = El servicio fue consumido Correctamente
DESCRIPTION Descripción del Error si RESULT=1
ID Consecutivo Interno Documento si RESULT=0
DocumentNumber Número de documento autorizado
Referece Código/Número de referencia de documento
CUFE CUFE en el caso de las facturas, “Codigo Unico Factura Electronica”
QrCode Cadena de texto para ser representado el QR
Signature Cadena de texto de la firma del XML
State Estado de la factura en el momento de la respuesta
Validated Fecha de validación del XML contra la DIAN

{"Result":0,"Description":"","Id":"34456434","Cufe":"1f5ff4dc691b8aa3e157b32a38e997bc63b7d1b4","QrCode":"NumFac:
PREF00117836 FecFac: 20140319105605 NitFac: 808183133 DocAdq: 8081972684 ValFac: 1000.00 ValIva: 160.00
ValOtroIm: 0.00 ValFacIm: 1160.00 CUFE: 2836a15058e90baabbf6bf2e97f05564ea0324a6", “Signature”:
“ZBYWey8Id83XOtY3ogDSwDEoTQ0+CKa7216atfGLF1SJhRXt8d0R2XH4K2DUBv7CHA6UeJQYwYujobKiK5RouOhdoftgR
4ZxaoXw8YWZJwfDaEyeOGuHFV4xWq9OS7jraweTb7ge0PaEfwYGS8my9V5jwoAf0yd2TxIJX31B41L8reRydtU/lbHfyNeQ=
EJEMPLO en JSON =”, “State”:”Exitosa”, “Validated”:”2019-07-16T16:20:58-05:00”}

Petición de Queue Varios documentos
c. Consumo del servicio mediante REST
Especificación técnica petición del servicio web múltiples Invoice (factura de venta):
POST URL: https://{servidor}/{instancia}/api/FacFacturasList
Ejemplo de cabecera autenticacion usuario y password:
Authorization: Basic dXN1YXJpb19pbnRlZ3JhY2lvbjpwYXNzd29yZF9pbnRlZ3JhY2lvbg==

Host: localhost
Content-Length: 967

Ejemplo de cabecera autenticacion Token:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1bmlxdWVfbmFtZSI6IlZpbGxlZ2FzbGciLCJuYmYiOjE1
OTI4NzU5OTAsImV4cCI6MTU5Mjg5Mzk5MCwiaWF0IjoxNTkyODc1OTkzLCJpc3MiOiJodHRwOi8vb
G9jYWxob3N0L25vb3ZhYXBpIiwiYXVkIjoiaHR0cDovL2xvY2FsaG9zdC9ub292YWFwaSJ9.8P0RzTf
K9qJYi6GwH_H1O51XGywGZ3c9BWE7zhHmY5w
Los vectores en verde no son obligatorios y depende del proceso de implantación
Ejemplo de cuerpo:
{
"Nvemp_nnit": 901999899,
"Nvfac_orig": "Q",
"Nvfac_toke": "Token",
"lFacFacturas": [
{
“lDetalle”:[
{
“Nvfac_dcop”:1,
“Nvpro_codi”:”144652.0005.150”,
“Nvpro_nomb”:”SAMANTA”,

“Nvfac_cant”:12,
“Nvfac_valo”:”20000.00”,
“Nvfac_pdes”:0,
“Nvfac_stot”:”240000.00”,
“Nvdet_viva”:”45600.00”,
“Nvuni_quan”:0,
“lLotesDetalle”: [
{
“Nvlot_loid”: “L20180705”,
“Nvlot_expr”: “2018-07-05T00:00:00.00”,
},
{
“Nvlot_loid”: “L20170705”,
“Nvlot_expr”: “2018-07-05T00:00:00.00”,
}
],
{
},
{
}],
{
“Nvimp_base”:”240000.00”,
“Nvimp_porc”:8,

“Nvimp_valo”:”19200.00”
}]
},
{
“Nvfac_dcop”:3,
“Nvpro_codi”:”4054.0005.150”,
“Nvpro_nomb”:”ENTRETELA 5125 FREUDENBERG”,
“Nvfac_cant”:1,
“Nvfac_valo”:”3550.00”,
“Nvfac_pdes”:0,
“Nvfac_stot”:”3550.00”,
“Nvdet_viva”:”674.50”,
“Nvuni_quan”:0,
{
},
{
}],
{
“Nvimp_base”:”240000.00”,
“Nvimp_porc”:8,
“Nvimp_valo”:”19200.00”
}]
},
{
“Nvfac_dcop”:4,
“Nvpro_codi”:”19384.0401.160”,

“Nvfac_cant”:3,
“Nvfac_valo”:”2765.00”,
“Nvfac_pdes”:0,
“Nvfac_stot”:”8295.00”,
“Nvdet_viva”:”1576.05”,
“Nvuni_quan”:0,
{
},
{
}],
{
“Nvimp_base”:”240000.00”,
“Nvimp_porc”:8,
“Nvimp_valo”:”19200.00”
}]
},
{
“Nvfac_dcop”:5,
“Nvpro_codi”:”19384.7821.160”,
“Nvfac_cant”:3.69,
“Nvfac_valo”:”11000.00”,
“Nvfac_pdes”:0,

“Nvfac_stot”:”40623.00”,
“Nvdet_viva”:”7718.37”,
“Nvuni_quan”:0,
{
},
{
}],
{
“Nvimp_base”:”240000.00”,
“Nvimp_porc”:8,
“Nvimp_valo”:”19200.00”
}]
}],
“lImpuestos”:[
{
“Nvimp_desc”:”IVA”,
“Nvimp_oper”:”S”,
“Nvimp_base”:”292468.00”,
“Nvimp_valo”:”46795.00”
},
{
“Nvimp_desc”:”Retención en la fuente”,
“Nvimp_base”:”292468.00”,
“Nvimp_valo”:”29247.00”
}],

“lCodigoBarras”:[
{
”Nvbar_cons” : “1”,
“Nvbar_codi”: “(415)779900005553(8020)01359587868125028140(3900)00000000056080”
}],
“TerminosEntrega”: {
“Nvter_inco”: “FOB”,
“Nvter_entr”: “PUERTO COLOMBIA”
},
“MediosPago”: {
“Nvmed_banc”: “BANCOLOMBIA”,
“Nvmed_cuen”: “64648564648”,
“Nvmed_name”: “CTA CTE-64648564648”
},
“Entrega”: {
“Nvent_terc”: “Carlos Alfonso Suarez”,
“Nvent_dire”: “Calle 13 N° 70 – 56 BODEGA 15”,
“Nvent_iden”: “8905588225”,
“Nvent_ciud”: “Bogota”,
“Nvent_pais”: “Colombia”,
“Nvent_tele”: “3202051571”,
“Nvent_pnet”: “15”,
“Nvent_pbru”: “17”,
“Nvent_puni”: “KGM”,
“Nvent_paic”: “170”,
“Nvent_zipc”: “11001”,
“Nvent_orig”: “Bogotá, Colombia”,
“Nvent_tran”: “Camión”,
“Nvent_fech”: “2020-05-15”
},
“lResumenFactura”:[{
“Nvres_unim”:”Empaques”,
},{
“Nvres_unim”:”sacos”,
}],
“TasaCambio”:{
“Nvtas_sour”: “COP”,
“Nvtas_targ”: “USD”,
“Nvtas_calc”: “2800”,
“Nvtas_fech”: “2018-01-01”
},”lAranceles”:[{
“Nvara_orig”: “3920430000”,
“Nvara_dest”: “3920.43.50.00”,
“Nvara_desc”: “Plastico”,
“Nvara_valo”: “18”

}],
“Nvfac_orig”:”E”,
“Nvemp_nnit”:”830000001”,
“Nvres_nume”:”1122334455”,
“Nvfac_tipo”:”FE”,
“Nvfac_tcru”:””,
“Nvfac_cdet”:”4”,
“Nvfac_nume”:”00010RI514”,
“Nvfac_fech”:”2020-05-08T14:14:02”,
“Nvfac_venc”:”2020-05-08T00:00:00”,
“Nvper_fini”:”2020-01-01”,
“Nvper_ffin”:”2020-12-31”,
“Nvsuc_codi”:”1011200”,
“Nvmon_codi”:”COP”,
“Nvfor_codi”:”2”,
“Nvven_nomb”:””,
“Nvfac_fpag”:”10”,
“Nvcli_cper”:”1”,
“Nvcli_cdoc”:”31”,
“Nvcli_docu”:”830000001-0”,
“Nvcli_pais”:””,
“Nvcli_depa”:”Valle del cauca””,
“Nvcli_ciud”:”Cali@76001”,
“Nvcli_loca”:””,
“Nvcli_dire”:””,
“Nvcli_regi”:””,
“Nvcli_fisc”:””,
“Nvcli_nomb”:”nombre de adquiriente”,
“Nvcli_pnom”:””,
“Nvcli_snom”:””,
“Nvcli_apel”:””,
“Nvcli_mail”:”correo@correo.com”
“Nvema_copi”:”correo@correo.com”,
“Nvfac_obse”:””,
“Nvfac_orde”:””,
“Nvfac_remi”:””,
“Nvfac_rece”:””,
“Nvfac_entr”:””,
“Nvfac_stot”:”292468.00”,
“Nvdes_codi”: “”,
“Nvfac_anti”:”0.00”,
“Nvfac_carg”:”0.00”,
“Nvfac_tota”:”0.00”,
“Nvfac_totp”:”310016.00”,
“Nvfac_vcop”: “0”,
“Nvfac_coid”:””,
“Nvfac_numb”:””,
“Nvfac_fecb”:”1899-12-31T00:00:00”,
“Nvcon_codi”:””,

“Nvcon_desc”:””,
“Nvfac_obsb”:””,
“lAdicionales”:[
{
“Nvfac_vatr”:”VFS768”
},
{
“Nvfac_vatr”:”2017/11/10”
}],
“Referencia”: {
“Nvref_codi”: “789456”
}
}
]
}
Nombre del Objeto DTOFacFacturasList

Número del Nit del
obligado a facturas, no
debe llevar digito de
NVEMP_NNIT Código Empresa Int 10 S chequeo
Q=Queue Esta propiedad
siempre debe llevar el
valor Q, que indica que los
documentos serán
encolados para ser
procesados de forma
NVFAC_ORIG Tipo de Servicio String 1 S asincrona.
Si no es enviado el
sistema retornara este
valor para llevar
Es un token que representa el grupo de trazabilidad al bloque de
NVFAC_TOKE procesamiento String 40 N procesamiento
Lista de documentos electrónicos que Máximo 50
List<DTOFacFacturas> serán trasmitidos List<DTOFacFacturas> documentos S
c. Respuesta servicio REST
Especificación técnica respuesta del servicio web Invoice (factura de venta):

Cuerpo

{
"Result": 0,
"Description": "",
"Id": "0",
"DocumentNumber": "",
"Reference": "-1",
"Cufe": "",
"QrCode": "",
"URL": "",
"Request": "",
"ErrorList": [],
"Signature": "",
"State": "Queued",
"Validated": ""
}
RESPUESTA SERVICIO
CAMPO DESCRIPCIÓN
Result 1=Ocurrió un Error, 0 = El servicio fue consumido Correctamente
Description Descripción del Error si RESULT=1
Id
DocumentNumber
Referece
CUFE
QrCode
Signature
State Queued

Consumo de servicio web – Nota debito
Especificación técnica petición del servicio web nota debito:

Ejemplo de cabecera:
Authorization: Basic dmlsbGVnYXNsZzp2aWxsZWdhc2xn

Host: localhost
Content-Length: 967

Ejemplo de cuerpo:
{
"lDetalle":[
{
"Nvfac_dcop":1,
"Nvpro_codi":"144652.0005.150",
"Nvpro_nomb":"SAMANTA",
"Nvuni_desc":"MT",
"Nvfac_cant":12,
"Nvfac_valo":"20000.00",
"Nvfac_pdes":0,
"Nvfac_desc":"0.00",
"Nvfac_stot":"240000.00",
"Nvimp_cdia":"01",
"Nvdet_piva":"19.00",
"Nvdet_viva":"45600.00",
},
{
"Nvfac_dcop":3,
"Nvpro_codi":"4054.0005.150",
"Nvpro_nomb":"ENTRETELA 5125 FREUDENBERG",
"Nvuni_desc":"MT",
"Nvfac_cant":1,
"Nvfac_valo":"3550.00",
"Nvfac_pdes":0,

"Nvfac_stot":"3550.00",
"Nvimp_cdia":"01",
"Nvdet_viva":"674.50"
},
{
"Nvfac_dcop":4,
"Nvpro_codi":"19384.0401.160",
"Nvpro_nomb":"FRANELA LYCRA CENTAURO",
"Nvuni_desc":"MT",
"Nvfac_cant":3,
"Nvfac_valo":"2765.00",
"Nvfac_pdes":0,
"Nvfac_stot":"8295.00",
"Nvimp_cdia":"01",
"Nvdet_viva":"1756.05",
},
{
"Nvfac_dcop":5,
"Nvpro_codi":"19384.7821.160",
"Nvuni_desc":"MT",
"Nvfac_cant":3.69,
"Nvfac_valo":"11000.00",
"Nvfac_pdes":0,
"Nvfac_stot":"40623.00",
"Nvimp_cdia":"01",
"Nvdet_viva":"7718.37",
}],
"lImpuestos":[
{
"Nvimp_cdia":"01",
"Nvimp_desc":"IVA",
"Nvimp_oper":"S",
"Nvimp_base":"292468.00",
"Nvimp_porc":16,
"Nvimp_valo":"46795.00"
},
{
"Nvimp_cdia":"04",
"Nvimp_desc":"Retención en la fuente",
"Nvimp_oper":"R",
"Nvimp_base":"292468.00",
"Nvimp_porc":10,
"Nvimp_valo":"29247.00"

}],
"Nvfac_orig":"E",
"Nvemp_nnit":"830000001",
"Nvfac_tipo":"DV",
"Nvfac_tcru":"L",
"Nvfac_cdet":"4",
"Nvfac_nume":"00010RI514",
"Nvfac_fech":"2017-03-08T14:14:02",
"Nvfac_venc":"2017-03-08T14:14:02",
“Nvper_fini”:”2020-01-01”,
“Nvper_ffin”:”2020-12-31”,
"Nvsuc_codi":"1011200",
"Nvfor_codi":"2",
"Nvfac_fpag":"10",
"Nvcli_cper":"1",
"Nvcli_cdoc":"31",
"Nvcli_docu":"830000001-0",
"Nvcli_pais":"CO",
"Nvcli_depa":"BOGOTA D.C.",
"Nvcli_ciud":"BOGOTA D.C@11001",
"Nvcli_loca":"BARRIOS UNIDOS",
"Nvcli_dire":"DIRECCION DEL CLIENTE",
"Nvcli_regi":"2",
"Nvcli_fisc":"",
"Nvcli_nomb":"nombre de adquiriente",
"Nvcli_pnom":"Primer nombre",
"Nvcli_snom":"Segundo nombre",
"Nvcli_apel":"Apellidos",
"Nvcli_mail":"mail@mail.com",
"Nvfac_obse":"",
"Nvfac_orde":"",
"Nvfac_stot":"292468.00",
"Nvfac_tota":"0.00",
"Nvfac_totp":"310016.00",
"Nvfac_numb":"",
"Nvfac_fecb":"1899-12-31T00:00:00",
"Nvcon_codi":"",
"Nvcon_desc":"",
"Nvfac_obsb":""
}
Especificación técnica petición del servicio web DebiteNote (Nota Debito):

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:noov="http://Noova/">
<soapenv:Header>
<noov:AuthHeader>

<noov:Username>dXN1YXJpbw==</noov:Username>

<noov:Password>cGF3d3NvcmQ=</noov:Password>
</noov:AuthHeader>
</soapenv:Header>
<soapenv:Body>
<noov:lDetalle>

</noov:lDetalle>
<noov:lImpuestos>
</noov:lImpuestos>
<noov:lAdicionales>
<noov:Nvfac_vatr>Atributo de nota</noov:Nvfac_vatr>
<noov:Nvfac_tipo>DV</noov:Nvfac_tipo>
<noov:Nvfac_tcru>R</noov:Nvfac_tcru>
<noov:Nvfac_cdet>2</noov:Nvfac_cdet>
<noov:Nvper_fini>2020-01-01</noov:Nvper_fini>
<noov:Nvper_ffin>2020-12-31</noov:Nvfac_ffin>

<noov:Nvfac_nume>98002585</noov:Nvfac_nume>
<noov:Nvfac_obse>Descuento</noov:Nvfac_obse>
<noov:Nvfac_numb>PRUE98002585</noov:Nvfac_numb>
<noov:Nvfac_fecb>2018-05-01</noov:Nvfac_fecb>
<noov:Nvcon_codi>2</noov:Nvcon_codi>
<noov:Nvcon_desc>Gastos por cobrar</noov:Nvcon_desc>
</soapenv:Body>
</soapenv:Envelope>
Nombre del
DTOFacFacturas
Objeto

E=Enterprise, P=Pyme Esta propiedad
es utilizada por la integración para
realizar, la canalización al modelo de
implantación realizado con la empresa,
cuando es un sistema de información el
que controla la información del proceso
de facturación se envía E, si la
plataforma es la que valida los clientes,
productos es utilizado la integración con
NVFAC_ORIG Tipo de Servicio String 1 S P.
Número del Nit del obligado a facturas,
NVEMP_NNIT Código Empresa Int 10 S no debe llevar digito de chequeo
DV=Debito Venta, DE=Debito
NVFAC_TIPO Tipo de Documento – Nota Debito String 2 S Exportación, DC=Debito Contingencia
Cantidad de líneas de detalles de la La cantidad total de detalles enviados en
NVFAC_CDET Factura Int 1 S el documento electrónico
Tipo de cruce de la nota, este debe ser
siempre referenciado =’R’. Es el único
valor posible. Siempre que se emita una
nota débito, debe estar si o si,
referenciada a una factura venta o
factura de exportación emitida
NVFAC_TCRU Tipo de cruce String 1 S previamente.
Corresponde al Número de la Nota
NVFAC_NUME Emitida String 40 S

Fecha del documento, en el formato, si
la hora no aplica envié 00:00:00 YYYY-
NVFAC_FECH Fecha y Hora de Emisión de Nota Datetime 0 S MM-DDTHH:MM:SS
Fecha del vencimiento s no aplica envié
Fecha y hora de vencimiento del la misma fecha del documento
NVFAC_VENC documento Datetime formato YYYY-MM-DDTHH:MM:SS
NVPER_FINI Inicio período facturación Datetime 0 N Fecha inicio período de facturación
NVPER_FFIN Fin período facturación Datetime 0 N Fecha fin período facturación
COP=Peso colombiano, USD= Dólar
NVMON_CODI Código Estándar Internacional Moneda String 3 S EEUU (estándar ISO 4217)
NVCLI_CPER Clase Persona Adquiriente SmallInt 4 S 1=Jurídica, 2=Natural
Tabla DIAN - Tipos Documento (11
Registro civil, 12 Tarjeta de identidad, 13
Cédula de ciudadanía, 21 Tarjeta de
extranjería, 22 Cédula de extranjería, 31
NIT, 41 Pasaporte, 42 Documento de
NVCLI_CDOC Código Documento SmallInt 4 S identificación extranjero)
Número del documento del adquiriente,
cedula o NIT, si el documento es NIT
enviar digito de verificación separado
NVCLI_DOCU Número de Documento String 20 S por guion (-)
CO=Colombia, CL=Chile, (estándar ISO
NVCLI_PAIS Código País Adquiriente String 2 S 3166-1, en formato 2 dígitos)
NVCLI_DEPA Departamento Adquiriente String 40 S Nombre del departamento del cliente
Nombre de la cuidad con el código de la
cuidad separado por el carácter ‘@’
NVCLI_CIUD Ciudad Adquiriente String 40 S Ejemplo: BOGOTA@11001
NVCLI_LOCA Localidad Adquiriente String 40 S
Es el número de teléfono del adquiriente
para que salga en la representación
NVCLI_NTEL Teléfono Adquiriente String 200 N grafica
Corresponde al nombre del contacto que
NVCLI_NCON Nombre del contacto del adquiriente String 200 N saldrá en la representación grafica
Tabla DIAN – Régimen Tributario (48
responsable del impuesto sobre las
ventas –IVA, 49 No responsable de IVA
NVCLI_REGI Régimen Tributario Adquiriente SmallInt 4 S )
Tabla DIAN – Uno o más códigos de las
responsabilidades fiscales del
Adquiriente, separadas por punto y
coma. Ej.: 0-99;0-39. Si este dato no se
envía, por defecto se enviará en el XML
Código Responsabilidades fiscales del 0-99 (otro tipo de obligado)
NVCLI_FISC Adquiriente String 400 N Ver tabla Responsabilidades
NVCLI_NOMB Razón Social Cliente String 250 S Si es una Persona Natural, va en blanco
NVCLI_PNOM Primer Nombre String 100 S Si es una Razón Social, va en blanco
NVCLI_SNOM Segundo Nombre String 100 S Si es una Razón Social, va en blanco
NVCLI_APEL Apellidos String 100 S Si es una Razón Social, va en blanco
Correo electrónico de notificación del
documento, en caso de requerir más de
una dirección deben estar separadas
NVCLI_MAIL Mail de Notificación Adquiriente String 250 S por “;” (punto y coma)
NVFAC_OBSE Observaciones String 4000 S
NVFAC_ORDE Número de orden de compra String 40 N Numero de orden de compra
Este campo corresponde al resultado de
NVFAC_STOT Subtotal Factura Float 12,2 S las (cantidades*valor)
Este campo corresponde al valor total
de los descuentos condicionados a la
NVFAC_DESC Total, descuentos nota Float 12,2 S nota. Este valor se resta del total a

pagar después de calculados los
impuestos y retenciones, EJ: subtotal
4200000 + IVA 798000 = total 4998000,
a este valor se resta el descuento
condicionado de la factura: 4998000 -
descuento 1000000 = total a pagar
3998000. estos descuentos
condicionados son diferentes a los
descuentos que se manejan por detalle
o ítem en la nota.
Este campo corresponde al resultado de
las (cantidades*valor) corresponde al
NVFAC_TOTA Subtotal nota Float 12,2 S mismo valor del campo NVFAC_STOT
Este campo corresponde al valor total
del documento después de descuentos,
NVFAC_TOTP Total Nota Float 12,2 S anticipos e impuestos
NVFAC_NUMB Número de Documento Referenciado String 40 S
NVFAC_FECB Fecha de Documento Referenciado Date 0 S
Tabla DIAN - Conceptos Notas (1
Intereses, 2 Gastos por cobrar, 3
NVCON_CODI Código Concepto String 3 S Cambio del valor)
NVCON_DESC Nombre Concepto String 250 S Tabla DIAN - Conceptos Notas
NVFAC_OBSB Observaciones Nota Debito String 250 S
lDetalle Lista de objetos Detalle de la factura List<lDetalle> S Lista del detalle de la factura
Lista de objetos Lista de impuestos totalizados de la
lImpuestos Detalle de impuestos List<lImpuestos> N factura
Lista de objetos adicionales a los Detalle de
campos de la estructura base del objeto campos
lAdicionales maestro adicionales N Lista de campos adicionales
DETALLE NOTA DEBITO
Nombre del Objeto List<DTOFacDetallefacturas> lDetalle

NVFAC_DCOP Consecutivo Detalle por Nota SmallInt 4 S Este consecutivo se utilizará para
ordenar el detalle en las facturas
NVPRO_NOMB Descripción del Producto String 250 S
NVFAC_DESC Valor Descuento Float 12.2 S Valor del descuento (cantidad*valor)
*porcentaje
NVFAC_STOT Valor Total por Detalle Float 12.2 S Incluye el valor del descuento, es el
valor final del detalle,
(cantidad*valor)-descuentos
NVIMP_CDIA Código del impuesto String 2 S Código de impuesto aplicado en el
detalle referenciado (01 IVA, 04
Ipoconsumo, 22 Impuesto a las
bolsas plásticas, 00 Productos
Excluidos)
NVDET_PIVA Porcentaje de impuesto aplicado al total Float 12.2 N Porcentaje del impuesto (IVA- 01 o
por detalle Ipoconsumo - 04), numero entero,
ejemplo 19

NVDET_VIVA Valor calculado del impuesto aplicado por Float 12.2 N Valor del Impuesto (IVA- 01 o
detalle Ipoconsumo - 04).


IMPUESTOS DE NOTA DEBITO

Objeto lImpuestos
NVIMP_CDIA Código Impuesto String 2 S Tabla de impuestos de la Dian (01
VALOR TOTAL DE IVA
04 VALOR TOTAL DE IMPUESTO
AL CONSUMO
05 RETENCIÓN EN LA FUENTE
POR IVA
POR RENTA
POR ICA)
NVIMP_OPER Operación Impuesto (S=Suma, R=Resta) String 1 S
NVIMP_BASE Valor Base Impuesto Float 12.2 S Total valor base del mismo
impuesto
NVIMP_PORC Porcentaje Impuesto Float 3.2 S porcentaje aplicado al valor base
base*porcentaje)
CAMPOS ADICIONALES
Nombre del Objeto List<DTOFacAdicionalesfacturas>

lAdicionales

DATO

Especificación técnica respuesta del servicio web nota debito:

Cuerpo
{"Result":1,"Description":"Error al consumir: Forma de pago invalida, valores posibles '10', '20',
'41', '42' ","Id":"0","Cufe":""}
RESPUESTA SERVICIO
CAMPO DESCRIPCIÓN
RESULT 1=Ocurrió un Error, 0=El Servicio se Consumió Correctamente
<DTOSalidaxmlns:i="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://schemas.datacontract.org/2004/07/NoovaBO.Facturacion.DTO">
<Description>Error al consumir: Tipo de documentos invalido, valores posibles

es F=Facturas, N=Notas</Description>
EJEMPLO
<Id>0</Id>
<Result>1</Result>
</DTOSalida>

Consumo de servicio Web – Nota Crédito
I. Petición del servicio
Especificación técnica petición del servicio web nota crédito:


Host: localhost
Content-Length: 967

Ejemplo de cuerpo:
{
"lDetalle":[
{
"Nvfac_dcop":1,
"Nvpro_codi":"144652.0005.150",
"Nvpro_nomb":"SAMANTA",
"Nvuni_desc":"MT",
"Nvfac_cant":12,
"Nvfac_valo":"20000.00",
"Nvfac_pdes":0,
"Nvfac_stot":"240000.00",
"Nvimp_cdia":"01",
"Nvdet_viva":"45600.00"
},
{
"Nvfac_dcop":3,
"Nvpro_codi":"4054.0005.150",
"Nvpro_nomb":"ENTRETELA 5125 FREUDENBERG",
"Nvuni_desc":"MT",
"Nvfac_cant":1,
"Nvfac_valo":"3550.00",
"Nvfac_pdes":0,

"Nvfac_stot":"3550.00",
"Nvimp_cdia":"01",
},
{
"Nvfac_dcop":4,
"Nvpro_codi":"19384.0401.160",
"Nvuni_desc":"MT",
"Nvfac_cant":3,
"Nvfac_valo":"2765.00",
"Nvfac_pdes":0,
"Nvfac_stot":"8295.00",
"Nvimp_cdia":"01",
},
{
"Nvfac_dcop":5,
"Nvpro_codi":"19384.7821.160",
"Nvuni_desc":"MT",
"Nvfac_cant":3.69,
"Nvfac_valo":"11000.00",
"Nvfac_pdes":0,
"Nvfac_stot":"40623.00",
"Nvimp_cdia":"01",
}],
"lImpuestos":[
{
"Nvimp_cdia":"01",
"Nvimp_desc":"IVA",
"Nvimp_oper":"S",
"Nvimp_base":"292468.00",
"Nvimp_porc":16,
"Nvimp_valo":"46795.00"
},
{
"Nvimp_cdia":"04",
"Nvimp_desc":"Retención en la fuente",
"Nvimp_oper":"R",
"Nvimp_base":"292468.00",
"Nvimp_porc":10,
"Nvimp_valo":"29247.00"

}],
"Nvfac_orig":"E",
"Nvemp_nnit":"830000001",
"Nvfac_tipo":"CV",
"Nvfac_tcru":"L",
"Nvfac_cdet":"4",
"Nvfac_nume":"00010RI514",
"Nvfac_fech":"2017-03-08T14:14:02",
"Nvfac_venc":"2017-03-08T14:14:02",
“Nvper_fini”:”2020-01-01”,
“Nvper_ffin”:”2020-12-31”,
"Nvsuc_codi":"1011200",
"Nvfor_codi":"3",
"Nvfac_fpag":"10",
"Nvcli_cper":"1",
"Nvcli_cdoc":"31",
"Nvcli_docu":"830000001-0",
"Nvcli_pais":"CO",
"Nvcli_depa":"BOGOTA D.C.",
"Nvcli_ciud":"BOGOTA D.C@11001",
"Nvcli_loca":"BARRIOS UNIDOS",
"Nvcli_dire":"DIRECCION DEL CLIENTE",
"Nvcli_regi":"2",
"Nvcli_fisc":"O-99",
"Nvcli_nomb":"nombre de adquiriente",
"Nvcli_pnom":"Primer nombre",
"Nvcli_snom":"Segundo nombre",
"Nvcli_apel":"Apellidos",
"Nvcli_mail":"mail@mail.com",
"Nvfac_obse":"",
"Nvfac_orde":"",
"Nvfac_stot":"292468.00",
"Nvfac_tota":"0.00",
"Nvfac_totp":"310016.00",
"Nvfac_numb":"",
"Nvfac_fecb":"1899-12-31T00:00:00",
"Nvcon_codi":"",
"Nvcon_desc":"",
"Nvfac_obsb":""
}

Especificación técnica petición del servicio web CreditNote (Nota Credito):

<soapenv:Header>
<noov:AuthHeader>
</noov:AuthHeader>
</soapenv:Header>
<soapenv:Body>
<noov:lDetalle>
<noov:Nvimp_cdia>01</noov: Nvimp_cdia>

<noov:Nvfac_natr>ROJO</noov:Nvfac_natr>
<noov:Nvimp_cdia>01</noov: Nvimp_cdia>
</noov:lDetalle>
<noov:lImpuestos>
</noov:lImpuestos>
<noov:lAdicionales>
<noov:Nvfac_vatr>Atributo de nota</noov:Nvfac_vatr>
<noov:Nvfac_tipo>CV</noov:Nvfac_tipo>
<noov:Nvfac_cdet>2</noov:Nvfac_cdet>
<noov:Nvper_fini >2020-01-01</noov:Nvper_fini>
<noov:Nvper_ffin>2020-12-31</noov:Nvper_ffin>

<noov:Nvfac_nume>98002585</noov:Nvfac_nume>
<noov:Nvfac_obse>Descuento</noov:Nvfac_obse>
<noov:Nvfac_numb>PRUE98002585</noov:Nvfac_numb>
<noov:Nvfac_fecb>2018-05-01</noov:Nvfac_fecb>
<noov:Nvcon_codi>1</noov:Nvcon_codi>
<noov:Nvcon_desc>Devolución de parte de los bienes; no aceptación de
partes del servicio</noov:Nvcon_desc>
</soapenv:Body>
</soapenv:Envelope>
Nombre del
DTOFacFacturas
Objeto
E=Enterprise, P=Pyme Esta
propiedad es utilizada por la
integración para realizar, la
implantación realizado con la
empresa, cuando es un
sistema de información el que
controla la información del
proceso de facturación se
envía E, si la plataforma es la
que valida los clientes,
Número del NIT del obligado a
facturas, no debe llevar digito
NVEMP_NNIT Código Empresa Int 10 S de chequeo

CV=Debito Venta, CE=Debito
Exportación, CC=Debito
NVFAC_TIPO Tipo de Documento – Nota Crédito String 2 S Contingencia
Tipo de cruce de la nota, este
debe ser siempre referenciado
=’R’. Es el único valor posible.
Siempre que se emita una nota
crédito, debe estar si o si,
referenciada a una factura
venta o factura de exportación
NVFAC_TCRU Tipo de cruce String 1 S emitida previamente.
La cantidad total de detalles
enviados en el documento
NVFAC_CDET Cantidad de líneas de detalles de la Factura Int 1 S electronico
NVFAC_NUME Corresponde al Número de la Nota Emitida String 40 S
NVFAC_FECH Fecha y Hora de Emisión de Nota Datetime 0 S
NVPER_FINI Inicio período facturación Datetime 0 N
NVPER_FFIN Fin período facturación Datetime 0 N
COP=Peso colombiano, USD=
Dólar EEUU (estándar ISO
NVMON_CODI Código Estándar Internacional Moneda String 3 S 4217)
NVCLI_CPER Clase Persona Adquiriente 1=Jurídica, 2=Natural SmallInt 4 S
Tabla DIAN – Tipos
Documento (11 Registro civil,
12 Tarjeta de identidad, 13
Cédula de ciudadanía, 21
Tarjeta de extranjería, 22
Cédula de extranjería, 31 NIT,
41 Pasaporte, 42 Documento
NVCLI_CDOC Código Documento SmallInt 4 S de identificación extranjero)
Número del documento del
adquiriente, cedula o NIT, si el
documento es NIT enviar digito
de verificación separado por
NVCLI_DOCU Número de Documento String 20 S guion (-)
CO=Colombia, CL=Chile,
(estándar ISO 3166-1, en
NVCLI_PAIS Código País Adquiriente String 2 S formato 2 dígitos)
Nombre del departamento del
NVCLI_DEPA Departamento Adquiriente String 40 S cliente
Nombre de la cuidad con el
código de la cuidad separado
por el carácter ‘@’ Ejemplo:
NVCLI_CIUD Ciudad Adquiriente String 40 S BOGOTA@11001
NVCLI_LOCA Localidad Adquiriente String 40 S
Es el número de teléfono del
adquiriente para que salga en
NVCLI_NTEL Teléfono Adquiriente String 200 N la representación grafica
Corresponde al nombre del
contacto que saldrá en la
NVCLI_NCON Nombre del contacto del adquiriente String 200 N representación grafica
Tabla DIAN – Régimen
Tributario (48 responsable del
impuesto sobre las ventas –
IVA, 49 No responsable de IVA
NVCLI_REGI Régimen Tributario Adquiriente SmallInt 4 S )
Tabla DIAN – Uno o más
códigos de las
responsabilidades fiscales del
Adquiriente, separadas por
punto y coma. Ej.: 0-99;0-39. Si
NVCLI_FISC Código Responsabilidades fiscales del Adquiriente String 400 N este dato no se envía, por

defecto se enviará en el XML
0-99 (otro tipo de obligado)
Ver tabla Responsabilidades
Si es una Persona Natural, va
NVCLI_NOMB Razón Social Cliente String 250 S en blanco
Si es una Razón Social, va en
NVCLI_PNOM Primer Nombre String 100 S blanco
NVCLI_SNOM Segundo Nombre String 100 S blanco
NVCLI_APEL Apellidos String 100 S blanco
notificación del documento, en
caso de requerir más de una
NVCLI_MAIL Mail de Notificación Adquiriente String 250 S coma)
NVFAC_OBSE Observaciones String 4000 S
NVFAC_ORDE Numero de orden de compra String 40 N Numero de orden de compra
Este campo corresponde al
resultado de las
NVFAC_STOT Subtotal Factura Float 12,2 S (cantidades*valor)
valor total de los descuentos
condicionados a la nota. Este
valor se resta del total a pagar
impuestos y retenciones, EJ:
subtotal 4200000 + IVA 798000
= total 4998000, a este valor se
resta el descuento
condicionado de la factura:
4998000 – descuento 1000000
= total a pagar 3998000. Estos
descuentos condicionados son
diferentes a los descuentos
que se manejan por detalle o
NVFAC_DESC Total Descuentos Nota Float 12,2 S ítem en la nota.
valor total de los anticipos
pagados a la nota. Este valor
se resta del total a pagar
impuestos y retenciones, EJ:
subtotal 4200000 + IVA 798000
= total 4998000, a este valor se
resta el anticipo de la nota:
4998000 – anticipo 1000000 =
NVFAC_ANTI Total, de los anticipos Float 12,2 N total a pagar 3998000.
resultado de las
(cantidades*valor) corresponde
al mismo valor del campo
NVFAC_TOTA Subtotal Nota Float 12,2 S NVFAC_STOT
valor total del documento
después de descuentos,
NVFAC_TOTP Total Nota a pagar Float 12,2 S anticipos e impuestos
Si Tipo Cruce es L, va en
NVFAC_NUMB Número de Documento Referenciado String 40 S blanco
NVFAC_FECB Fecha de Documento Referenciado Date 0 S
Tabla DIAN – Conceptos Notas
(1 Devolución de parte de los
bienes; no aceptación de
partes del servicio, 2 Anulación
de factura electrónica, 3
NVCON_CODI Código Concepto String 3 S Rebaja total aplicada, 4

Descuento total aplicado, 5
Rescisión: nulidad por falta de
requisitos, 6 Otros)
NVCON_DESC Nombre Concepto String 250 S Tabla DIAN – Conceptos Notas
NVFAC_OBSB Observaciones Nota Crédito String 250 S
lDetalle Lista de objetos Detalle de la factura List<lDetalle> S Lista del detalle de la nota
Lista de objetos Lista de impuestos totalizados
lImpuestos Detalle de impuestos List<lImpuestos> N de la nota
Detalle de
Lista de objetos adicionales a los campos de la campos
lAdicionales estructura base del objeto maestro adicionales N Lista de campos adicionales
DETALLE NOTA
Nombre del Objeto List<DTOFacDetallefacturas> lDetalle

NVFAC_DCOP Consecutivo Detalle por Nota SmallInt 4 S Este consecutivo se utilizará para
ordenar el detalle en las facturas
NVPRO_NOMB Descripción del Producto String 250 S
NVFAC_DESC Valor Descuento Float 12.2 S Valor del descuento (cantidad*valor)
*porcentaje
NVFAC_STOT Valor Total por Detalle Float 12.2 S Incluye el valor del descuento, es el
valor final del detalle,
(cantidad*valor)-descuentos
NVIMP_CDIA Código del impuesto String 2 S Código de impuesto aplicado en el
detalle referenciado (01 IVA, 04
Ipoconsumo, 22 Impuesto a las
bolsas plásticas, 00 Productos
Excluidos)
NVDET_PIVA Porcentaje de impuesto aplicado al total Float 12.2 N Porcentaje del impuesto (IVA- 01 o
por detalle Ipoconsumo – 04), numero entero,
ejemplo 19
NVDET_VIVA Valor calculado del impuesto aplicado por Float 12.2 N Valor del Impuesto (IVA- 01 o
detalle Ipoconsumo – 04).


IMPUESTOS DE NOTA

Objeto lImpuestos
NVIMP_CDIA Código Impuesto String 2 S Tabla de impuestos de la Dian (01
VALOR TOTAL DE IVA
04 VALOR TOTAL DE IMPUESTO
AL CONSUMO
POR IVA
POR RENTA
POR ICA)
NVIMP_OPER Operación Impuesto (S=Suma, R=Resta) String 1 S
NVIMP_BASE Valor Base Impuesto Float 12.2 S Total valor base del mismo
impuesto
NVIMP_PORC Porcentaje Impuesto Float 3.2 S porcentaje aplicado al valor base
base*porcentaje)
CAMPOS ADICIONALES

Objeto lAdicionales
DATO
II. Respuesta del servicio

Especificación técnica respuesta del servicio web nota crédito:
Cuerpo
{"Result":1,"Description":"Error al consumir: Forma de pago invalida, valores posibles '10', '20',
'41', '42' ","Id":"0","Cufe":""}
RESPUESTA SERVICIO
CAMPO DESCRIPCIÓN
RESULT 1=Ocurrió un Error, 0=El Servicio se Consumió Correctamente

<DTOSalidaxmlns:i="http://www.w3.org/2001/XMLSchema-instance"
<Description>Error al consumir: Tipo de documentos invalido, valores posibles es

F=Facturas, N=Notas</Description>
EJEMPLO
<Id>0</Id>
<Result>1</Result>
</DTOSalida>

Casos especiales de facturación proceso versión 3 de facturación electrónica
(validación previa)
I. Facturación con AIU:
Para este caso, se debe identificar que la factura de venta electrónica solo contempla tres
(3) detalles que están estructurados de la siguiente manera:
Detalle 1: Este detalle corresponde a la administración. Debe llevar en los campos de

valor unitario (NVFAC_VALO) y en el campo del subtotal del detalle (NVFAC_STOT), el
valor del subtotal de la factura que no se tendrá en cuenta como parte de la base para
liquidar el impuesto del IVA; debe llevar en el campo NVDET_NOTA explícitamente el
texto “Contrato de AIU por concepto de: Servicios” y el valor del campo código de
impuesto NVIMP_CIDA, debe estar registrado como IVA Excluido “00”. A
continuación, el ejemplo de este detalle #1 incluido en el JSON del request
respectivamente:
],
"lDetalle": [
{
"Nvfac_dcop": "1",
"Nvpro_codi": "YV2020",
"Nvpro_nomb": "Administración",
"Nvuni_desc": "UN",
"Nvfac_cant": 1,
"Nvfac_valo": 1500000,
"Nvfac_pdes": 0,
"Nvfac_desc": 0,
"Nvfac_stot": 1500000,
"Nvdet_piva": 0,
"Nvdet_viva": 0,
"Nvimp_cdia": "00",
"Nvdet_nota": "Contrato de AIU por concepto de: Servicios",
"Nvdet_tcod": null,
"Nvpro_cean": null,
"Nvdet_entr": null,
"Nvuni_quan": 0
},
Detalle 2: Este detalle corresponde a los imprevistos y hace referencia al valor que no
se tiene en cuenta para sumar en el subtotal del global de la factura. Debe llevar en
el campo de valor unitario (NVFAC_VALO), el valor de dicho imprevisto, sin
contemplar valores en los campos del impuesto (NVDET_VIVA y NVDET_PIVA); el
campo de cantidad NVFAC_CANT debe ir en cero (0) y el valor del campo código de
impuesto NVIMP_CIDA, debe estar registrado como IVA Excluido “00”. A
continuación, el ejemplo de este detalle #2 incluido en el JSON del request
respectivamente:
{
"Nvfac_dcop": "2",
"Nvpro_nomb": "Imprevistos",
"Nvuni_desc": "UN",
"Nvfac_cant": 0,
"Nvfac_valo": 6000,
"Nvfac_pdes": 0,
"Nvfac_desc": 0,
"Nvfac_stot": 0,
"Nvdet_piva": 0,
"Nvdet_viva": 0,
"Nvimp_cdia": "00",
"Nvdet_nota": null,
"Nvdet_tcod": null,
"Nvpro_cean": null,
"Nvdet_entr": null,
"Nvuni_quan": 0
},
Detalle 3: Este detalle corresponde a la Utilidad y hace referencia al % del valor del
subtotal del global de la factura sobre el cual se liquida el impuesto IVA, es decir
corresponde a la base del impuesto. Debe llevar en el campo de valor unitario
(NVFAC_VALO) y en el campo de subtotal (NVFAC_STOT), el valor porcentual % del
subtotal de la factura como la base sobre la cual se liquida el IVA del documento, y
además debe incluir los datos en los campos del impuesto (NVDET_VIVA y
NVDET_PIVA); y el valor del campo código de impuesto NVIMP_CIDA, debe estar
registrado como IVA Calculado “01”; y el campo de cantidad NVFAC_CANT debe ser
mayor a cero (0):
{
"Nvfac_dcop": "3",
"Nvpro_nomb": "Utilidad",
"Nvuni_desc": "UN",
"Nvfac_cant": 1,
"Nvfac_pdes": 0,
"Nvfac_desc": 0,
"Nvdet_piva": 19,
"Nvdet_viva": 28500,
"Nvimp_cdia": "01",
"Nvdet_nota": null,
"Nvdet_tcod": null,
"Nvpro_cean": null,
"Nvdet_entr": null,
"Nvuni_quan": 0
}
],
A continuación, se relaciona la estructura ejemplo completa del documento electrónico como

corresponde a partir del json respectivo cuando la integración es a través de servicio REST:
{
"lAdicionales": [
{
"Nvfac_atri": "1",
"Nvfac_vatr": "103528"
},
{

"Nvfac_atri": "2",
"Nvfac_vatr": "CLIENTE CREDITO"
},
{
"Nvfac_atri": "16",
"Nvfac_vatr": "31/12/17"
},
{
"Nvfac_atri": "17",
"Nvfac_vatr": "DESCRIPCION 1"
},
{
"Nvfac_atri": "18",
}
],
"lDetalle": [
{
"Nvfac_dcop": "1",
"Nvpro_nomb": "Administración",
"Nvuni_desc": "UN",
"Nvfac_cant": 1,
"Nvfac_pdes": 0,
"Nvfac_desc": 0,
"Nvdet_piva": 0,
"Nvdet_viva": 0,
"Nvimp_cdia": "00",
"Nvdet_nota": "Contrato de AIU por concepto de: Servicios",
"Nvdet_tcod": null,
"Nvpro_cean": null,
"Nvdet_entr": null,
"Nvuni_quan": 0
},
{
"Nvfac_dcop": "2",

"Nvpro_nomb": "Imprevistos",
"Nvuni_desc": "UN",
"Nvfac_cant": 0,
"Nvfac_valo": 6000,
"Nvfac_pdes": 0,
"Nvfac_desc": 0,
"Nvfac_stot": 0,
"Nvdet_piva": 0,
"Nvdet_viva": 0,
"Nvimp_cdia": "00",
"Nvdet_nota": null,
"Nvdet_tcod": null,
"Nvpro_cean": null,
"Nvdet_entr": null,
"Nvuni_quan": 0
},
{
"Nvfac_dcop": "3",
"Nvuni_desc": "UN",
"Nvfac_cant": 1,
"Nvfac_pdes": 0,
"Nvfac_desc": 0,
"Nvdet_piva": 19,
"Nvimp_cdia": "01",
"Nvdet_nota": null,
"Nvdet_tcod": null,
"Nvpro_cean": null,
"Nvdet_entr": null,
"Nvuni_quan": 0
}
],
"lCodigoBarras": [
{

"Nvbar_cons": "1",
"Nvbar_codi": "(415)7709998020375(8020)8600499210(8020)0010008678"
}
],
"LIMPUESTOS": [
"NVIMP_CDIA": "01",
"NVIMP_DESC": "IVA",
"NVIMP_OPER": "S",
"NVIMP_BASE": 150000,
"NVIMP_PORC": 19,
"NVIMP_VALO": 28500
],
"Nvfac_orig": "E",
"Nvemp_nnit": "901108864",
"Nvres_nume": "18760000001",
"Nvfac_tipo": "FV",
"Nvfac_nume": "SETT30097",
"Nvfac_fech": "2019/08/28",
"Nvfac_venc": "2019/09/28",
"Nvsuc_codi": "01",
"Nvmon_codi": "COP",
"Nvfor_codi": "1",
"Nvven_nomb": "EDUARDO VARGAS",

"Nvfac_fpag": "41",
"Nvcli_cper": "1",
"Nvcli_cdoc": "13",
"Nvcli_docu": "1098603522",
"Nvcli_pais": "CO",
"Nvcli_depa": "Bogota",
"Nvcli_ciud": "Bogota@11001",
"Nvcli_loca": "",
"Nvcli_dire": "AV DORADO ENT. 1 INT 20 TERMINAL AEROSUP",
"Nvcli_ntel": "57-7422274",
"Nvcli_ncon": "MAILYN MORENO",
"Nvcli_regi": "04",
"Nvcli_nomb": " ",
"Nvcli_pnom": "Eduardo",
"Nvcli_snom": "Fabio",
"Nvcli_apel": "Vargas Ortega",
"Nvcli_mail": "eduardo.vargas@noova.com.co",
"Nvema_copi": "N",
"Nvfac_obse": "SERVICIO PROTECCION V. INTERNA",
"Nvfac_orde": "1134567",
"Nvfac_desc": 0,
"Nvfac_anti": 0,
"Nvfac_tota": 1650000,
"Nvfac_totp": 1678500,
"Nvfac_coid": "",
"Nvfac_numb": "",
"Nvfac_fecb": null,
"Nvfac_obsb": "",
"Nvfac_carg": 0,
"Nvfac_timp": 0,
"Nvcon_codi": null,
"Nvcon_desc": null,
"Nvfac_tcru": null,
"Nvfac_remi": "8000001",
"Nvfac_rece": null,
"Nvfac_entr": null
}

Esta funcionalidad se acondiciona de igual manera a la estructura XML cuando el consumo se hace a
través de servicio SOAP.
II. Facturación Tercero Mandante - Mandatario:
Para enviar documentos con la característica especial de mandante-mandatario, se adiciono un tag a nivel de
detalle de factura el cual se denomina “NVDET_MAND”. A continuación, se relaciona la información que
contiene este tag y que hace parte del mandante (Tercero proveedor dueño de los servicios o productos que
se están facturando en el documento por a cargo del Mandatario quien cumple el rol de facturador electrónico):
NVMAN_CPER Clase Persona del mandante SmallInt 4 S 1=Jurídica, 2=Natural

Tabla DIAN - Tipos
Documento (11 Registro
civil, 12 Tarjeta de
identidad, 13 Cédula de
ciudadanía, 21 Tarjeta de
extranjería, 22 Cédula de
extranjería, 31 NIT, 41
Pasaporte, 42 Documento
de identificación
NVMAN_CDOC Código Documento SmallInt 4 S extranjero)
Número del documento
del Mandante, cedula o
NIT, si el documento es
NIT enviar digito de
verificación separado por
NVMAN_DOCU Número de Documento String 20 S guion ‘-‘
notificación del
NVMAN_MAIL Mail de Notificación Adquiriente String 250 S coma)
NVMAN_DIRE Dirección Adquiriente String 250 S
Tabla DIAN - Régimen
Tributario (48
Responsable de IVA, 49
NVMAN_REGI Régimen Tributario Mandante SmallInt 4 S No responsable de IVA)
Si es una Persona Natural,
NVMAN_NOMB Razón Social Mandante String 250 S va en blanco
Si es una Razón Social, va
NVMAN_PNOM Primer Nombre String 100 S en blanco
NVMAN_SNOM Segundo Nombre String 100 S en blanco
NVMAN_APEL Apellidos String 100 S en blanco
Es el número de teléfono
del Mandante para que
salga en la representación
NVMAN_NTEL Teléfono Mandante String 200 N grafica
Corresponde al nombre
del contacto que saldrá en
NVMAN_NCON Nombre del contacto del Mandante String 200 N la representación grafica

{
"lAdicionales": [
{
"Nvfac_atri": "1",
},
{
"Nvfac_atri": "2",
},
{
"Nvfac_atri": "16",
"Nvfac_vatr": "31/12/17"
},
{
"Nvfac_atri": "17",
},
{
"Nvfac_atri": "18",
}
],
"lDetalle": [
{
"Nvfac_dcop": "1",
"Nvuni_desc": "UN",
"Nvfac_cant": 1,
"Nvfac_pdes": 0,
"Nvfac_desc": 0,
"Nvdet_piva": 19,
"Nvimp_cdia": "01",

"Nvdet_nota": null,
"Nvdet_tcod": null,
"Nvpro_cean": null,
"Nvdet_entr": null,
"Nvuni_quan": 0
"Nvdet_mand":
{
"Nvman_cper":"1",
"Nvman_cdoc":"13",
"Nvman_docu":"1033754048",
"Nvman_mail":"Eduardo.vargas@noova.com.co",
"Nvman_dire":"AV DIRECCION",
"Nvman_regi":"04",
"Nvman_nomb":"",
"Nvman_pnom":"Eduardo",
"Nvman_snom":"Fabio",
"Nvman_apel":"Vargas Ortega",
"Nvman_ntel":"57-7422274",
"Nvman_ncon":"DIEGO LOPEZ"
}
],
"lCodigoBarras": [
{
"Nvbar_cons": "1",
"Nvbar_codi": "(415)7709998020375(8020)8600499210(8020)0010008678"
}
],
"LIMPUESTOS": [

{
"NVIMP_CDIA": "01",
"NVIMP_OPER": "S",
"NVIMP_PORC": 19,
"NVIMP_VALO": 28500
],
"Nvfac_orig": "E",
"Nvemp_nnit": "901108864",
"Nvres_nume": "18760000001",
"Nvfac_tipo": "FV",
"Nvfac_fech": "2019/08/28",
"Nvfac_venc": "2019/09/28",
"Nvsuc_codi": "01",
"Nvfor_codi": "1",
"Nvfac_fpag": "41",
"Nvcli_cper": "1",
"Nvcli_cdoc": "13",
"Nvcli_docu": "1098603522",
"Nvcli_pais": "CO",
"Nvcli_loca": "",
"Nvcli_ntel": "57-7422274",

"Nvcli_regi": "04",
"Nvcli_nomb": " ",
"Nvema_copi": "N",
"Nvfac_orde": "1134567",
"Nvfac_desc": 0,
"Nvfac_anti": 0,
"Nvfac_coid": "",
"Nvfac_numb": "",
"Nvfac_fecb": null,
"Nvfac_obsb": "",
"Nvfac_carg": 0,
"Nvfac_timp": 0,
"Nvcon_codi": null,
"Nvcon_desc": null,
"Nvfac_tcru": null,
"Nvfac_remi": "8000001",
"Nvfac_rece": null,
"Nvfac_entr": null
}
Esta funcionalidad se acondiciona de igual manera a la estructura XML cuando el consumo se

hace a través de servicio SOAP.

III. Facturación con impuesto a las bolsas:
Para enviar documentos con la característica especial de facturación contemplando el

impuesto a las bolsas se debe tener en cuenta las siguientes particularidades:
- Hace referencia a la inclusión de un impuesto al interior del documento electrónico

sin sumarse o afectar el subtotal NVFAC_STOT del global de la factura.
- El campo que tiene en cuenta el valor liquidado del impuesto a las bolsas
corresponde al valor del total a pagar del documento NVFAC_TOTP, es decir que se
suma a este valor como se suma un impuesto respectivo de los comunes (IVA,
IMPOCONUSMO).
- Se debe adicionar un detalle adicional con las siguientes características.
NVUNI_DESC = unidad de medida,

NVFAC_CANT = cantidad de bolsas a facturar,
NVFAC_VALO = valor unitario de la bolsa,
NVFAC_STOT = el valor debe ir 0,
NVIMP_CDIA = código del impuesto a las bolsas = “22”,
NVDET_PIVA = valor unitario de la bolsa,
NVDET_VIVA = valor unitario * cantidad de bolsas.
- Se agrega en el vector de impuestos

NVIMP_CDIA = código del impuesto a las bolsas = “22”,
NVIMP_OPER = valor debe ir en ‘S’,
NVIMP_BASE = el valor debe ir 0,
NVIMP_PORC = valor unitario de la bolsa,
NVIMP_VALO = valor unitario * cantidad de bolsas.

{
"lAdicionales": [
{
"Nvfac_atri": "1",
},
{
"Nvfac_atri": "2",
},
{
"Nvfac_atri": "16",
"Nvfac_vatr": "31/12/17"
},
{
"Nvfac_atri": "17",
},
{
"Nvfac_atri": "18",
}
],

"lDetalle": [
{
"Nvfac_dcop": "1",
"Nvpro_nomb": "Bolsa plastica",
"Nvuni_desc": "UN",
"Nvfac_cant": 3,
"Nvfac_valo": 35,
"Nvfac_pdes": 0,
"Nvfac_desc": 0,
"Nvfac_stot": 0,
"Nvdet_piva": 35,
"Nvdet_viva": 105,
"Nvimp_cdia": "22",
"Nvdet_nota": null,
"Nvdet_tcod": null,
"Nvpro_cean": null,
"Nvdet_entr": null,
"Nvuni_quan": 0
},
{
"Nvfac_dcop": "3",
"Nvuni_desc": "UN",
"Nvfac_cant": 1,
"Nvfac_pdes": 0,
"Nvfac_desc": 0,
"Nvdet_piva": 19,
"Nvimp_cdia": "01",
"Nvdet_nota": null,
"Nvdet_tcod": null,
"Nvpro_cean": null,
"Nvdet_entr": null,
"Nvuni_quan": 0

}
],
"lCodigoBarras": [
{
"Nvbar_cons": "1",
"Nvbar_codi": "(415)7709998020375(8020)8600499210(8020)0010008678"
}
],
"LIMPUESTOS": [
{
"NVIMP_CDIA": "01",
"NVIMP_OPER": "S",
"NVIMP_PORC": 19,
"NVIMP_VALO": 28500
},
{
"NVIMP_CDIA": "22",
"NVIMP_DESC": "Impuesto bolsa plástica",
"NVIMP_OPER": "S",
"NVIMP_BASE": 0,
"NVIMP_PORC": 35,
"NVIMP_VALO": 105
}
],
"Nvfac_orig": "E",
"Nvemp_nnit": "901108864",
"Nvres_nume": "18760000001",
"Nvfac_tipo": "FV",
"Nvfac_fech": "2019/08/28",
"Nvfac_venc": "2019/09/28",
"Nvsuc_codi": "01",
"Nvfor_codi": "1",

"Nvfac_fpag": "41",
"Nvcli_cper": "1",
"Nvcli_cdoc": "13",
"Nvcli_docu": "1098603522",
"Nvcli_pais": "CO",
"Nvcli_loca": "",
"Nvcli_ntel": "57-7422274",
"Nvcli_regi": "04",
"Nvcli_nomb": " ",
"Nvema_copi": "N",
"Nvfac_orde": "1134567",
"Nvfac_desc": 0,
"Nvfac_anti": 0,
"Nvfac_coid": "",
"Nvfac_numb": "",
"Nvfac_fecb": null,
"Nvfac_obsb": "",
"Nvfac_carg": 0,
"Nvfac_timp": 0,
"Nvcon_codi": null,
"Nvcon_desc": null,
"Nvfac_tcru": null,
"Nvfac_remi": "8000001",
"Nvfac_rece": null,
"Nvfac_entr": null
}

IV. Facturación Productos Excluidos:
Para enviar documentos con la característica especial de facturación contemplando

productos Excluidos o No gravados, se deben cumplir las siguientes especificaciones:
- Hace referencia a la inclusión o facturación de productos que no son gravados es

decir cuando el producto o servicio facturado no liquida IVA en ningún caso
porque no está sujeto al mismo.
- El campo del detalle que hace referencia al código de impuesto liquidado por el
producto debe ser NVIMP_CDIA ='00'
- El porcentaje de impuesto aplicado al producto debe ser NVDET_PIVA='0'.
- El valor de impuesto aplicado al producto debe ser NVDET_VIVA='0'.
- En el vector de impuestos no se deben enviar valores asociados a Excluidos, dado
que no se hace referencia a ningún impuesto.
- A continuación, se relaciona la estructura ejemplo completa del documento electrónico como
{
"NVFAC_ORIG": "E",
"NVEMP_NNIT": "901108864",
"NVRES_NUME": "18760000001",
"NVFAC_NUME": "SETT300478",
"NVFAC_FECH": "2020-07-29T13:07:00",
"NVFAC_VENC": "2020-08-28T13:08:00",
"NVSUC_CODI": "01",
"NVMON_CODI": "COP",
"NVFOR_CODI": "1",
"NVVEN_NOMB": "Vendedor 1",
"NVFAC_FPAG": "41",
"NVCLI_CPER": 1,
"NVCLI_CDOC": 31,
"NVCLI_DOCU": "890105652-3",
"NVCLI_PAIS": "CO",

"NVCLI_DEPA": "Boyaca",
"NVCLI_CIUD": "Tunja@15001",
"NVCLI_LOCA": "",
"NVCLI_DIRE": "CLL 26 87 90",
"NVCLI_NTEL": "",
"NVCLI_NCON": "",
"NVCLI_REGI": "48",
"NVCLI_FISC": "R-99-PN",
"NVCLI_NOMB": "Pruebas clientes",
"NVCLI_PNOM": "",
"NVCLI_SNOM": "",
"NVCLI_APEL": " ",
"NVCLI_MAIL": "mail@mail.com",
"NVEMA_COPI": "",
"NVFAC_OBSE": "",
"NVFAC_ORDE": "",
"NVFAC_REMI": "",
"NVFAC_RECE": "",
"NVFAC_ENTR": "",
"NVFAC_STOT": 100000,
"NVFAC_DESC": "0.00",
"NVFAC_ANTI": "0.00",
"NVFAC_CARGO": "0.00",
"NVFAC_TOTA": 100000,
"NVFAC_TOTP": 100000,
"NVFAC_VCOP": "0",
"NVFAC_TIMP": "100000",
"NVFAC_COID": "",
"NVFAC_NUMB": "",
"NVFAC_FECB": "",
"NVCON_CODI": "",
"NVCON_DESC": "",
"NVFAC_OBSB": "",
"NVFAC_CONV": "2",
"NVFAC_TIPO": "FV",
"lDetalle": [
{
"NVUNI_DESC": "94",
"NVFAC_DCOP": 1,
"NVPRO_CODI": "1",

"NVPRO_NOMB": "Producto Excluido",
"NVFAC_CANT": 1,
"NVFAC_VALO": "100000.00",
"NVFAC_PDES": "0.00",
"NVIMP_CDIA": "00",
"NVDET_VIVA": "0.00",
"NVDET_PIVA": "0.00",
"NVDET_TCOD": "",
"NVDET_CEAN": "",
"NVDET_ENTR": "",
"NVUNI_QUAN": "",
"NVDET_NOTA": ""
}
],
"lAdicionales": [
{
"NVFAC_ATRI": "1",
"NVFAC_VATR": ""
}
]
}

V. Facturación Productos Exentos:
Para enviar documentos con la característica especial de facturación contemplando

productos Exentos, se deben cumplir las siguientes especificaciones:
- Hace referencia a la inclusión o facturación de productos gravados con tarifa del 0%,
cuando se está facturando un producto que es sujeto de IVA pero que por alguna
variable (por ejemplo, decreto 682 de 2020), no debe calcular IVA en dicha
operación de facturación particular).
- El campo del detalle que hace referencia al código de impuesto liquidado por el
producto debe ser NVIMP_CDIA ='01'
- El porcentaje de impuesto aplicado al producto debe ser NVDET_PIVA='0'.
- El valor de impuesto aplicado al producto debe ser NVDET_VIVA='0'.
- En el vector de impuestos se deben enviar valores asociados a Exentos, dado que
se hace referencia a impuesto IVA cuya tarifa es 0%.
- A continuación, se relaciona la estructura ejemplo completa del documento
electrónico como corresponde a partir del json respectivo cuando la integración es
a través de servicio REST:
{
"NVFAC_ORIG": "E",
"NVEMP_NNIT": "901108864",
"NVRES_NUME": "18760000001",
"NVFAC_NUME": "SETT300478",
"NVFAC_FECH": "2020-07-29T13:07:00",
"NVFAC_VENC": "2020-08-28T13:08:00",
"NVSUC_CODI": "01",
"NVMON_CODI": "COP",
"NVFOR_CODI": "1",
"NVVEN_NOMB": "Vendedor 1",
"NVFAC_FPAG": "41",
"NVCLI_CPER": 1,
"NVCLI_CDOC": 31,
"NVCLI_DOCU": "890105652-3",
"NVCLI_PAIS": "CO",
"NVCLI_DEPA": "Boyaca",
"NVCLI_CIUD": "Tunja@15001",
"NVCLI_LOCA": "",
"NVCLI_DIRE": "CLL 26 87 90",
"NVCLI_NTEL": "",
"NVCLI_NCON": "",
"NVCLI_REGI": "48",
"NVCLI_FISC": "R-99-PN",
"NVCLI_NOMB": "Pruebas clientes",
"NVCLI_PNOM": "",
"NVCLI_SNOM": "",
"NVCLI_APEL": " ",
"NVCLI_MAIL": "mail@mail.com",
"NVEMA_COPI": "",
"NVFAC_OBSE": "",
"NVFAC_ORDE": "",
"NVFAC_REMI": "",
"NVFAC_RECE": "",
"NVFAC_ENTR": "",
"NVFAC_ANTI": "0.00",
"NVFAC_CARGO": "0.00",
"NVFAC_TOTA": 100000,
"NVFAC_TOTP": 100000,
"NVFAC_VCOP": "0",
"NVFAC_TIMP": "100000",
"NVFAC_COID": "",
"NVFAC_NUMB": "",
"NVFAC_FECB": "",
"NVCON_CODI": "",
"NVCON_DESC": "",
"NVFAC_OBSB": "",
"NVFAC_CONV": "2",
"NVFAC_TIPO": "FV",
"lDetalle": [
{
"NVUNI_DESC": "94",
"NVFAC_DCOP": 1,
"NVPRO_CODI": "1",
"NVPRO_NOMB": "Producto Excluido",
"NVFAC_CANT": 1,
"NVFAC_VALO": "100000.00",
"NVFAC_PDES": "0.00",
"NVIMP_CDIA": "01",
"NVDET_VIVA": "0.00",
"NVDET_PIVA": "0.00",
"NVDET_TCOD": "",
"NVDET_CEAN": "",
"NVDET_ENTR": "",
"NVUNI_QUAN": "",
"NVDET_NOTA": ""
}
],

"lImpuestos": [
{
"NVIMP_CDIA": "01",
"NVIMP_OPER": "S",
"NVIMP_PORC": "0",
"NVIMP_VALO": "0"
}
],
"lAdicionales": [
{
"NVFAC_ATRI": "1",
"NVFAC_VATR": ""
}
]


Acuse recibido DIAN / Cliente
VI. Petición del servicio
PETICION DEL SEVICIO

URL https://{instancia}/{instancia}/api/FacFacturas?e=0&id=173&t=E
METODO GET
E Código de la Empresa, numero de NIT del obligado a facturar
ID Código Interno Retorno del Envío del Documento
T Modelo facturación, fijo "E"
Metodo: GetEnvioDian
<soapenv:Header>
<noov:AuthHeader>
</noov:AuthHeader>
</soapenv:Header>
<soapenv:Body>
<noov:GetEnvioDian>
<noov:e>822554558</noov:e>
<noov:id>5555</noov:id>
<noov:t>E</noov:t>
</noov:GetEnvioDian>
</soapenv:Body>
</soapenv:Envelope>
VII. Respuesta del servicio
RESPUESTA SERVICIO
CAMPO DESCRIPCIÓN
DESCRIPTION Descripción Respuesta de Aceptación o Rechazo
NVENV_FECH Fecha Respuesta DIAN

Código Respuesta DIAN, (200=OK, 100=Error WS, 101,102,103,104=Error
ZIP,300=Documento Invalido, solo Invoice, CreditNote y DebitNote,
NVENV_RESP 310=Parámetro de solicitud no coincide, 500=Error Interno.
NVENV_ESTA Estado Respuesta Cliente (E: Enviada, A: Aceptada, R: Rechazada)
NVENV_OBSE Observaciones de la aceptación o rechazo
NVENV_CFEC Fecha Respuesta Cliente
NVFAC_CUFE Código de CUFE asignado al documento
NVFAC_ESTN Estado del documento en el momento de la consulta.
<DTOSalidaEnvioxmlns:i="http://www.w3.org/2001/XMLSchema-instance"
<Description/>
<ReporteRespuesta>
<DTOFacFacturasenviadas>
<Nvenv_come>Ejemplar recibido exitosamente pasará a
verificación.</Nvenv_come>
<Nvenv_fech>2016-09-08T09:41:51</Nvenv_fech>
EJEMPLO
<Nvenv_resp>200</Nvenv_resp>
<Nvenv_obse>Observaciones factura</Nvenv_obse>
<Nvfac_cufe>a31ab7103fb707e25cac4fc44ffbb2302c5b3d04</Nvfac_cufe>
<Nvfac_estn>Exitosa</Nvfac_estn>
</DTOFacFacturasenviadas>
</ReporteRespuesta>
<Result>0</Result>
</DTOSalidaEnvio>

Acuse recibido cliente
URL https://{instancia}/{instancia}/api/FacFacturasc?e=0&id=544&t=E
METODO GET
RESPUESTA SERVICIO
CAMPO DESCRIPCIÓN
NVACE_FECH Fecha Aceptación Cliente
NVENV_ESTN Estado Envío de Factura a Cliente
NVENV_FECH Fecha Envío Factura a Cliente
NVING_FECH Fecha Ingreso Factura Cliente
NVREC_CODI Concepto Rechazo Cliente
NVREC_DESC Descripción Rechazo Cliente
NVREC_FECH Fecha Rechazo Cliente
NVREC_OBSE Observaciones del Cliente

<DTOSalidaEnvioClientexmlns:i="http://www.w3.org/2001/XMLSchema-
instance"
<Description/>
<ReporteRespuesta>
<DTOFacFacturasenviadasadquiriente>
<Nvace_fech>0001-01-01T00:00:00</Nvace_fech>
<Nvenv_estn>Rechazada</Nvenv_estn>
<Nvenv_fech>2016-10-12T19:09:15</Nvenv_fech>
EJEMPLO
<Nving_fech>2016-10-12T19:36:37</Nving_fech>
<Nvrec_codi>1</Nvrec_codi>
<Nvrec_desc>Sin remision</Nvrec_desc>
<Nvrec_fech>2016-10-12T19:37:20</Nvrec_fech>
<Nvrec_obse>Se requiere la remision</Nvrec_obse>
</DTOFacFacturasenviadasadquiriente>
</ReporteRespuesta>
<Result>0</Result>
</DTOSalidaEnvioCliente>

Consulta documentos
Este servicio web permite la consulta de documentos PDF (representación gráfica) la consulta del XML
Documento electrónico, AttachedDocument (Documento que contiene Documento electrónico y
AplicationResponse) o ApplicationResponse si así se requiere
CONSULTA DOCUMENTOS PORTAL

URL https://{instancia}/{instancia}/api/FacFacturasd?e=0&id=173&t=E&d=PDF
METODO GET
Tipo de documento PDF=Representación Gráfica, XML=Documento Electrónico, ATT=
D AttachedDocument, APP= ApplicationResponse.
Método: GetDocument
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
<soapenv:Header>
<noov:AuthHeader>
<noov:Password>cGFzc3dvcmQ=</noov:Password>
</noov:AuthHeader>
</soapenv:Header>
<soapenv:Body>
<noov:GetDocument>
<noov:e>899003000</noov:e>
<noov:id>17</noov:id>
<noov:t>E</noov:t>

<noov:d>PDF</noov:d>
</noov:GetDocument>
</soapenv:Body>
</soapenv:Envelope>
a. Respuesta del servicio mediante REST
CARACTERISTICAS DE LA RESPUESTA
El servicio responde un objeto complejo con las siguientes características
Result 0=No hay error, 1= Ocurrió un error
Si resultado es 1, en esta propiedad va la descripción del Error
Descripción presentado
Cadena Base64 con el documento codificado, cabe resaltar que el XML
Document debe decodificarse UTF-8
RESPUESTA SERVICIO
CAMPO DESCRIPCIÓN
{
"Result": 0,
"Description": "",
EJEMPLO
"Document":
"JVBERi0xLjcgCiXi48/TIAoxIDAgb2JqIAo8PCAKL1R5cGUg"
}
b.Respuesta del servicio mediante SOAP
Cuando hay un error
<soap:Envelope
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<GetDocumentResponse xmlns="http://Noova/">
<GetDocumentResult>
<Result>1</Result>
<Description>Error al consumir: El usuario no es valido</Description>
</GetDocumentResult>
</GetDocumentResponse>
</soap:Body>
</soap:Envelope>

Exitoso
<soap:Envelope
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<GetDocumentResponse xmlns="http://Noova/">
<GetDocumentResult>
<Result>0</Result>
<Description/>
<Document>JVBERi0xLjMNCjEgMCBvYmoNClsvUERGIC9U=</Document>
</GetDocumentResult>
</GetDocumentResponse>
</soap:Body>
</soap:Envelope>

Notificación aceptación o rechazo
Este servicio web permite que sistemas de información externos notifiquen a la plataforma si un
documento fue aceptado o rechazado por el adquiriente, esta integración es utilizada solo cuando le
plataforma de envió del documento y notificación no es Noova Negocios Electrónicos.
Especificación técnica petición del servicio web


Host: localhost
Content-Length: 967

Ejemplo de cuerpo:
{
"Nvemp_nnit": "860000008",
"Nvfac_cont": 3800111,
"Nvfac_orig": "E",
"Nvenv_esta": "R",
"Nvrec_codi": "02",
"Nvrec_obse": "Factura rechazada, mal liquidada",
"Nvenv_fech": "2012-04-16T00:00:00.00",
"Nving_fech": "2012-04-16T00:00:00.00",
"Nvrec_fech": "2012-04-16T00:00:00.00",
"Nvvie_fech": "2012-04-16T00:00:00.00",
"Nvenv_corr": "correo@noova.com.co"
}

URL: https://servidor/Noovaoneapi/api/FacFacturasEnviada
METODO POST

Número del Nit del obligado a
facturas, no debe llevar digito
NVEMP_NNIT Código Empresa Int 10 S de chequeo
código entregado en el
momento de recibir el
NVFAC_CONT Consecutivo interno int 10 S documento
E=Enterprise, P=Pyme, Esta
propiedad es utilizada por la
integración para realizar, la
implantación realizado con la
empresa, cuando es un
sistema de información el que
controla la información del
proceso de facturación se
envía E, si la plataforma es la
que valida los clientes,
Acción sobre le documento
NVENV_ESTA Estado documento String 1 S A=Aprobado, R=Rechazado
Si el valor de Nvenv_esta es
R, en este campo debe
enviarse el código de motivo
de rechazo el cual debe estar
parametrizado en Noova
NVREC_CODI Código de motivo de rechazo String 3 N negocios electrónicos
Breve descripción del motivo
NVREC_OBSE Observaciones al rechazo String 800 N del rechazo del documento
Fecha y hora en la cual se
yyyy-MM- envió el documento por correo
NVENV_FECH Fecha de envió documento por correo Fecha ddThh:mm:ss S electrónico al adquiriente
Fecha y hora en la cual el
yyyy-MM- usuario ingreso a la plataforma
NVING_FECH Fecha de ingreso a la plataforma Fecha ddThh:mm:ss N y descargar el documento
Fecha y hora en la cual el
yyyy-MM- adquiriente rechaza el
NVREC_FECH Fecha rechazo Fecha ddThh:mm:ss N documento por algún motivo
El caso que la notificación por
correo electrónico cuente con
seguimiento de visualización
de correo, se debe registrar en
yyyy-MM- este campo, la fecha y hora de
NVVIE_FECH Fecha visualización correo Fecha ddThh:mm:ss N visualización
Correo electrónico al cual se
envió la notificación de
NVENV_CORR Correo de notificación String S documento electrónico
yyyy-MM- Fecha en la cual acepta el
NVACE_FECH Fecha de aceptación Fecha ddThh:mm:ss N documento el adquiriente

CARACTERISTICAS DE LA RESPUESTA
El servicio responde un objeto complejo con las siguientes características
Result 0=No hay error, 1= Ocurrió un error
Si resultado es 1, en esta propiedad va la
Descripción descripción del Error presentado
RESPUESTA SERVICIO
CAMPO DESCRIPCIÓN
{
"Result": 1,
"Description": "Error al consumir:
EJEMPLO
Consecutivo documento no fue
encontrado “
}

Consulta numeración resolución habilitada
Este servicio web permite que sistemas de información externos consulten y actualicen en la
plataforma la numeración habilitada por la DIAN
Este servicio permite realizar un pass-through al servicio expuesto por la DIAN, para la consecución
de claves técnicas necesarias para poder calcular CUFE, exigido en el proceso de facturación
electrónica implementado por la DIAN.


Host: localhost
Content-Length: 967

URL http://urlservidor/instancia/api/facresolucion?Nvemp_nnit=9999999
METODO GET
número de NIT del obligado a facturar, el cual debe estar parametrizado en
NVEMP_NNIT la plataforma

El servicio responde la lista de numeraciones vigentes que están asociadas al Obligado a facturar, y
el proveedor tecnológico que las consulta.
{
"Result": 0,
"Description": "",
"lResoluciones": [
{
"NumeroResolucion": "180898786795984",
"FechaResolucion": "2017-03-31T00:00:00-05:00",
"Prefijo": "PRUE",
"RangoInicial": "980099896",
"RangoFinal": "990099896",
"FechaVigenciaDesde": "2017-03-31T00:00:00-05:00",
"FechaVigenciaHasta": "2018-09-30T00:00:00-05:00"
}
]
}
Cada consulta realiza la actualización si es requerida en la plataforma de facturación electrónica, y

retorna la información de numeración, este servicio solo se debe consumir en el momento de solicitar
la numeración por primera vez, y cuando se solicita ampliar los rangos, o activar una numeración
inactiva por vencimiento de fecha.

Enviar documento adjunto a factura
Este servicio web permite que sistemas de información externos envíen documentos a la plataforma
de facturación electrónica, y los cuales queden como documentos anexos a la factura.
Web Services REST
URL: https://[servidor]/[instancia]/api/FacDocumentos
Metodo: POST


Host: localhost
Content-Length: 967

Ejemplo de cuerpo:
{
"Nvemp_nnit" : "875585",
"Nvfac_cont" : 1,
"Nvfac_orig" : "E",
"Nvdoc_tipo" : "nombre del archivo.doc",
"Nvpla_codi" : "011",
"Nvdoc_arch" : "PD94bWwgdmVyc2lvbj0iMS4wIiBl",
"Nvusu_codi" : "usuario1"
}
Ejemplo Respuesta del servicio

{
"Result": 1,
"Description": "Error al consumir: Plantilla de documento no existe: 011"
}

Web Services mediante SOAP
Método: SetFacDocumentos
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
<soapenv:Header>
<noov:AuthHeader>
</noov:AuthHeader>
</soapenv:Header>
<soapenv:Body>
<noov:SetFacDocumentos>
<noov:documento>
<noov:Nvfac_cont>2334</noov:Nvfac_cont>
<noov:Nvdoc_tipo>nombre.txt</noov:Nvdoc_tipo>
<noov:Nvpla_codi>01</noov:Nvpla_codi>
<noov:Nvdoc_arch>louioyioy9697059hlkgh98609ykj</noov:Nvdoc_arch>
<noov:Nvusu_codi>usuario</noov:Nvusu_codi>
</noov:documento>
</noov:SetFacDocumentos>
</soapenv:Body>
</soapenv:Envelope>
Documento expediente electrónico

Nombre del Documento
Objeto
DATO TORIO
NVEMP_NNIT Empresa String 40 S Nit de la compañía

NVFAC_CONT Consecutivo del documento Int 10 S Es el consecutivo interno con el cual
se identifica el documento de factura
en la plataforma.
NVFAC_ORIG Modelo de facturación String 1 S Se utiliza por defecto “E”
NVDOC_TIPO Nombre del documento String 250 S Es el nombre completo de documento
con su respectiva extensión.
Ejemplo: orden compra.pdf
NVPLA_CODI Código de la plantilla String 20 S Código que se asignó a la plantilla en
la empresa. Por defecto es 01
NVDOC_ARCH Archivo String S Base64 del binario del archivo
NVUSU_CODI Código del usuario String 20 S Es el código de usuario al que se le
asignara el documento, en la
integración es el mismo usuario de la
integración.
El servicio responde un objeto de tipo TSalida el cual contiene las siguientes propiedades.
RESPUESTA SERVICIO
CAMPO DESCRIPCIÓN
RESULT 1=Ocurrió un Error, 0 = El servicio fue consumido Correctamente

Solicitar Token de autenticación
Este servicio web permite solicitar token para autenticación en los servicios web o la aplicación web.
A continuación, se describe la especificación técnica para la solicitud del token, el uso de este toquen
depende del servicio que se vaya a utilizar, uno de los servicios que se puede utilizar es el envió de
facturas o notas, también puede ser utilizado para realizar autenticación mediante token en la
aplicación, la vigencia predeterminada de este token es de 5 horas, pasado este periodo de tiempo
deberá solicitar un nuevo token.

URL https://{urlservidor}/{instancia}/api/LoginToken
Username Usuario de autenticación
Password Password de autenticación
Resurso al que se autenticara valores posibles “SITE”=Sitio
Resource Web, “API”=Api de servicios
METODO POST
Ejemplo de body autenticación para API:
{
"Username": "Usuario1",
"Password": "password1",
"Resource": "API"
}
Ejemplo de body autenticación para SITE:
{
"Username": "Usuario1",
"Password": "password1",
"Resource": "SITE"
}
El servicio responde en el body el token que se debe enviar en las peticiones con autenticación por
token en el header Bearer

"eyJhbGciOiJIUzI1NiIsI6+4564IkpXVCJ9.eyJ1bm65465VfbmFtZSI6IlZpbGxlZ2FzbGciLCJuYmYiOjE
1OTI1OTUsssskksI6MTU5MjYxMzk1NCwiaWF0IjoxNTkyNTk1OTU0LCJpc3MiOiJodHRwczovL2Rldi
5ub292YS5jb20uY28vYXBwLXZwaCIsI5646ZCI6Imh0dHBzOi8vZGV2Lm5vb3ZhLmNvbS5jby9hcHAt
dnBoIn0.xktfBnvap9iS6464G2n9pZ9oLl_IQIUUChrlDU7B78"
El mecanismo de autenticación Bearer, en las peticiones de servicio web, se envía en el header

ejemplo:
eyJhbGciOiJIUzI1NiIsI6+4564IkpXVCJ9.eyJ1bm65465VfbmFtZSI6IlZpbGxlZ2FzbGciLCJuYmYiOjE1
OTI1OTUsssskksI6MTU5MjYxMzk1NCwiaWF0IjoxNTkyNTk1OTU0LCJpc3MiOiJodHRwczovL2Rldi5
ub292YS5jb20uY28vYXBwLXZwaCIsI5646ZCI6Imh0dHBzOi8vZGV2Lm5vb3ZhLmNvbS5jby9hcHAtd
nBoIn0.xktfBnvap9iS6464G2n9pZ9oLl_IQIUUChrlDU7B78

Control de cambios
El siguiente numeral se informan los cambios que se realizaran sobre el documento de integración por Web
Service.
Versión 1.25
- Adición de campos:
LDETALLE
Campo Descripción
Nvimp_cdia Código del impuesto aplicado en el detalle del documento.
Versión 1.36
ENTREGA
Campo Descripción
Nvent_fech Fecha de entrega bien/servicio.
Versión 1.37
- Agregada sección ANEXOS al presente documento técnico.
- Ajustada descripción de campos relacionados con códigos de impuestos
NVIMP_CDIA
Versión 1.38
REFERENCIA
Campo Descripción
Nvref_codi Código/Número de referencia de documento
- Modificada respuesta de servicio web para incluir el valor del campo Nvref_codi en
propiedad “Reference”.
Versión 1.39
- Ajustadas las descripciones de los siguientes campos de recepción:
NVFAC_CONV, NVFAC_FPAG, NVCLI_REGI, NVCLI_FISC
- Agregada tabla de referencia RESPONSABILIDADES FISCALES, sección anexos

Versión 1.40
- Implementados campos de detalle en la recepción:
NVDET_ORDE: Orden de compra
NVDET_RECE: Número de recepción
Versión 1.41
- Implementado campo de código de descuento
NVDES_CODI
- Agregada tabla de referencia CODIGOS DESCUENTO, sección anexos
Versión 1.42
- Inclusión de descripciones específicas para manejo de productos Exentos y
Excluidos.
- Agregado dato de referencia código 00 para productos Excluidos en campo
NVIMP_CDIA de detalles.
Versión 1.43
- Aclaración de Métodos (REST) y EndPoint (SOAP)
La mayoría de los servicios REST responden en la URL Base:
https://{instancia}/api/{metodo} los Servicios SOAP responden en la URL
https://{instancia}/services/{endpoint} cuando el servicio no este expuesto por
algunas de estas URL se le indicara al usuario

Anexos
1. Tributos (Resolución 000042, 05 de Mayo de 2020):

cac:TaxScheme/ID, cac:TaxScheme/Name cac:TaxScheme/ID: Columna Identificador cac:TaxScheme/Name:
Columna Nombre
Identificador Nombre Descripción

01 IVA Impuesto de Valor Agregado
02 IC Impuesto al Consumo Departamental Nominal
03 ICA Impuesto de Industria, Comercio y Aviso
04 INC Impuesto Nacional al Consumo
05 ReteIVA Retención sobre el IVA
06 ReteFuente Retención sobre Renta
07 ReteICA Retención sobre el ICA
20 FtoHorticultura Cuota de Fomento Hortifrutícula
21 Timbre Impuesto de Timbre
22 Bolsas Impuesto al Consumo de Bolsa Plástica
23 INCarbono Impuesto Nacional al Carbono
24 INCombustibles Impuesto Nacional a los Combustibles
25 Sobretasa Combustibles Sobretasa a los combustibles
26 Sordicom Contribuciones minoristas (Combustibles)
ZY No causa No responsable de tributo
ZZ Nombre de la figura tributaria Otros tributos, tasas, contribuciones, y similares
Tabla de códigos de tributos
2. Responsabilidades Fiscales (Resolución 000042, 05 de Mayo de 2020):
Código Significado
O-06 Ingresos y patrimonio
O-07 Retención en la fuente a título de renta
O-08 Retención timbre nacional
O-09 Retención en la fuente en el impuesto sobre las ventas
O-13 Gran contribuyente
O-14 Informante de exógena
O-15 Autorretenedor
O-16 Obligación de facturar por ingresos de bienes y/o servicios excluidos
O-17 Profesionales de compra y venta de divisas
O-19 Productor y/o exportador de bienes exentos
O-22 Obligado a cumplir deberes formales a nombre de terceros
O-23 Agente de retención en el impuesto sobre las ventas
O-32 Impuesto Nacional a la Gasolina y al ACPM

O-33 Impuesto Nacional al consumo
O-34 Régimen simplificado impuesto nacional consumo rest y bares
O-36 Establecimiento Permanente
O-37 Obligado a Facturar Electrónicamente Modelo 2242
O-38 Facturación Electrónica Voluntaria Modelo 2242
O-39 Proveedor de Servicios Tecnológicos PST Modelo 2242
O-47 Régimen Simple de Tributación – SIMPLE
O-48 Impuesto sobre las ventas – IVA
O-49 No responsable de IVA
O-52 Facturador electrónico
O-99 Otro tipo de obligado
R-00-PN Clientes del Exterior
R-12-PN Factor PN
R-16-PN Mandatario
R-25-PN Agente Interventor
R-99-PN No responsable
R-06-PJ Apoderado especial
R-07-PJ Apoderado general
R-12-PJ Factor
R-16-PJ Mandatario
R-99-PJ Otro tipo de responsable
A-01 Agente de carga internacional
A-02 Agente marítimo
A-03 Almacén general de depósito
A-04 Comercializadora internacional (C.I.)
A-05 Comerciante de la zona aduanera especial de Inírida, Puerto Carreño, Cumaribo y Primavera
A-06 Comerciantes de la zona de régimen aduanero especial de Leticia
A-07 Comerciantes de la zona de régimen aduanero especial de Maicao, Uribia y Manaure
A-08 Comerciantes de la zona de régimen aduanero especial de Urabá, Tumaco y Guapí
A-09 Comerciantes del puerto libre de San Andrés, Providencia y Santa Catalina
A-10 Depósito público de apoyo logístico internacional
A-11 Depósito privado para procesamiento industrial
A-12 Depósito privado de transformación o ensamble
A-13 Depósito franco
A-14 Depósito privado aeronáutico
A-15 Depósito privado para distribución internacional
A-16 Depósito privado de provisiones de a bordo para consumo y para llevar
A-17 Depósito privado para envíos urgentes
A-18 Depósito privado
A-19 Depósito público
A-20 Depósito público para distribución internacional
A-21 Exportador de café
A-22 Exportador
A-23 Importador
A-24 Intermediario de tráfico postal y envíos urgentes
A-25 Operador de transporte multimodal
A-26 Sociedad de intermediación aduanera
A-27 Titular de puertos y muelles de servicio público o privado

A-28 Transportador 263nfor régimen de importación y/o exportación
A-29 Transportista nacional para operaciones del régimen de tránsito aduanero
A-30 Usuario comercial zona franca
A-32 Usuario industrial de bienes zona franca
A-34 Usuario industrial de servicios zona franca
A-36 Usuario operador de zona franca
A-37 Usuario aduanero permanente
A-38 Usuario altamente exportador
A-39 Usuario de zonas económicas especiales de exportación
A-40 Deposito privado de instalaciones industriales
A-41 Beneficiarios de programas especiales de exportación PEX
A-42 Depósitos privados para mercancías en tránsito San Andrés
A-43 Observadores de las operaciones de importación
A-44 Usuarios sistemas especiales Importación exportación
A-46 Transportador 263nformac régimen de importación y/o exportación
A-47 Transportador terrestre régimen de importación y/o exportación
A-48 Aeropuerto de servicio publico o privado
A-49 Transportador fluvial régimen de importación
A-50 Usuario industrial zona franca especial
A-53 Agencias de aduanas 1
A-54 Usuario Operador Zona Franca Especial
A-58 Transportador aéreo nacional
A-60 Transportador aéreo, marítimo o fluvial modalidad Cabotaje
A-61 Importador de alimentos de consumo humano y animal
A-62 Importador Ocasional
A-63 Importador de maquinaría y sus partes Decreto 2261 de 2012
A-64 Beneficiario Programa de Fomento Industria Automotriz-PROFIA
A-99 Otro tipo de agente aduanero
E-01 Agencia
E-02 Establecimiento de comercio
E-03 Centro de explotación agrícola
E-04 Centro de explotación animal
E-05 Centro de explotación minera
E-06 Centro de explotación de transformación
E-07 Centro de explotación de servicios
E-08 Oficina
E-09 Sede
E-10 Sucursal
E-11 Consultorio
E-12 Administraciones
E-13 Seccionales
E-14 Regionales
E-15 Intendencias
E-16 Local o negocio
E-17 Punto de venta

E-18 Fábrica
E-19 Taller
E-20 Cantera
E-21 Pozo de Petróleo y Gas
E-22 Otro lug de tipo de extrac explotación de recursos naturales
E-99 Otro tipo de establecimiento
A partir del 01 de agosto del 2020 entran en vigencia los siguientes códigos.
Código Significado
O-13 Gran contribuyente
O-15 Autorretenedor
O-23 Agente de retención IVA
O-47 Régimen simple de tributación
R-99-PN No responsable
Tabla responsabilidades fiscales
3. Códigos de descuento (Resolución 000042, 05 de mayo de 2020):

Estos códigos solamente se utilizan para categorizar el tipo de descuento otorgado. Es importante que el
facturador lo mencione en caso de que haga descuentos por impuestos asumidos.
Código Significado
00 Descuento por impuesto asumido
01 Pague uno lleve otro
02 Descuentos contractuales
03 Descuento por pronto pago
04 Envío gratis
05 Descuentos específicos por inventarios
06 Descuento por monto de compras
07 Descuento de temporada
08 Descuento por actualización de productos / servicios
09 Descuento general
10 Descuento por volumen
11 Otro descuento

M OFC IWS 202008 v1.43

Cargado por

Información del documento

Descripción original:

Título original

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

M OFC IWS 202008 v1.43

Cargado por

Copyright:

Formatos disponibles

Guía Técnica Web Services Integración

Versión 1.43 – 27 de agosto de 2020

Proceso recepción de transacciones en Noova .............................................................. 4

Estándar comunicación y seguridad ............................................................................... 5

Consumo de servicio web – factura de venta ................................................................. 6

Petición del servicio ............................................................................................................ 6

Petición de Queue Varios documentos ......................................................................... 30

Petición del servicio .......................................................................................................... 30

Consumo de servicio web – Nota debito ...................................................................... 39

Petición del servicio .......................................................................................................... 39

Consumo de servicio Web – Nota Crédito .................................................................... 49

I. Petición del servicio ............................................................................................. 49

I. Facturación con AIU: ............................................................................................ 60

Acuse recibido DIAN / Cliente....................................................................................... 83

VI. Petición del servicio ............................................................................................. 83

Acuse recibido cliente .................................................................................................. 85

I. Petición del servicio ............................................................................................. 85

www.noova.com.co www.mentum.group Tel: (571+) 744 15 15

Petición del servicio .......................................................................................................... 87

Notificación aceptación o rechazo................................................................................ 90

Petición del servicio .......................................................................................................... 90

Consulta numeración resolución habilitada ................................................................. 93

Petición del servicio .......................................................................................................... 93

Enviar documento adjunto a factura ............................................................................ 95

I. Petición del servicio ....................................................................................................... 96

Solicitar Token de autenticación .................................................................................. 98

Petición del servicio .......................................................................................................... 98

Control de cambios .................................................................................................... 100

Versión 1.25 .................................................................................................................... 100

Anexos ........................................................................................................................ 102

www.noova.com.co www.mentum.group Tel: (571+) 744 15 15

-URL Base servicio REST: https://{instancia}/api/{metodos}

La variable {instancia} en el proceso de implantación corresponde a la instancia de la aplicación ya sea

www.noova.com.co www.mentum.group Tel: (571+) 744 15 15

El proceso consiste en la generación de transacciones digitales desde un sistema ERP, facturador, o

www.noova.com.co www.mentum.group Tel: (571+) 744 15 15

SEGURIDAD DEL SERVICIO DESCRIPCIÓN:

www.noova.com.co www.mentum.group Tel: (571+) 744 15 15

Petición del servicio

a. Consumo del servicio mediante REST

Especificación técnica petición del servicio web Invoice (factura de venta):

Ejemplo de cabecera autenticacion usuario y password:

Authorization: Basic dXN1YXJpb19pbnRlZ3JhY2lvbjpwYXNzd29yZF9pbnRlZ3JhY2lvbg==

Autorización se utiliza mediante usuario y password entregados por Noova,

Ejemplo de cabecera autenticacion Token:

Los vectores en verde no son obligatorios y depende del proceso de implantación

www.noova.com.co www.mentum.group Tel: (571+) 744 15 15

www.noova.com.co www.mentum.group Tel: (571+) 744 15 15

www.noova.com.co www.mentum.group Tel: (571+) 744 15 15

www.noova.com.co www.mentum.group Tel: (571+) 744 15 15

www.noova.com.co www.mentum.group Tel: (571+) 744 15 15

www.noova.com.co www.mentum.group Tel: (571+) 744 15 15

www.noova.com.co www.mentum.group Tel: (571+) 744 15 15

Especificación técnica petición del servicio web Invoice (factura de venta):

www.noova.com.co www.mentum.group Tel: (571+) 744 15 15

www.noova.com.co www.mentum.group Tel: (571+) 744 15 15

www.noova.com.co www.mentum.group Tel: (571+) 744 15 15

Tabla relación de atributos en la petición:

www.noova.com.co www.mentum.group Tel: (571+) 744 15 15

CAMPO DESCRIPCIÓN TIPO DE DATO TAMAÑO OBLIGATORIO OBSERVACIONES

www.noova.com.co www.mentum.group Tel: (571+) 744 15 15

www.noova.com.co www.mentum.group Tel: (571+) 744 15 15