Versiones comparadas

Clave

  • Se ha añadido esta línea.
  • Se ha eliminado esta línea.
  • El formato se ha cambiado.

Sumario

1.Objetivo

2.Comprobantes

3.Formato y campos

3.1Tipos de Datos

3.2Sección Comprobante

3.2.1Campos por Comprobante

3.2.2SubSección Cliente

3.2.3SubSección Proveedor

3.2.4SubSección Prestador

3.2.5SubSección Asesor

3.2.6SubSección Detalles

3.2.7SubSección Importes

3.2.8SubSección Valores

3.2.9SubSección Imputaciones

3.2.10SubSección Impuestos

4. Instalación del Servicio

5. Almacenamiento de XML y Log en S3

Objetivo

El objetivo de esta herramienta es generar archivos en formato XML de cada comprobante generado dentro del sistema. Permite generar archivos XMLs con toda la información necesaria de facturas, notas de crédito, recibos, etc.

Comprobantes

Se genera información XML de los siguientes comprobantes:

  • Transferencia

  • Orden de Pago a Cliente

  • Anulación de Orden de Pago a Cliente - (Version 3.4.51.15 y posteriores)

  • Factura Cliente

  • Nota de Crédito Cliente

  • Nota de Débito Cliente

  • Recibo Cliente

  • Anulación de Recibo Cliente - (Version 3.4.51.15 y posteriores)

  • Factura Proveedor

  • Nota de Crédito Proveedor

  • Orden de Pago a Proveedor

  • Egreso de Caja

  • Ingreso de Caja

  • Liquidación de Valores

  • Cruce de Documentos

  • Anulación de Cruce de Documentos

Formato y campos

Bloque de código
   <?xml version="1.0" encoding="utf-8"?>
   <Comprobante xmlns:xsd="" xmlns:xsi="">
     <idComprobante>FACTU</idComprobante>
     <Sucursal>1</Sucursal>
     <Numero>10</Numero>
     <Fecha>19/08/2015</Fecha>
     <FechaVencimiento>19/08/2015</FechaVencimiento>
     <CentroCostos>8010000</CentroCostos>
     <CodigoTipoComprobante>FA</CodigoTipoComprobante>
     <DescripcionTipoComprobante>Factura</DescripcionTipoComprobante>
     <CotizacionBase>1</CotizacionBase>
     <CotizacionAlter>0.000333</CotizacionAlter>
     <Total>10000</Total>
     <TotalAlter>3.33</TotalAlter>
     <TotalBase>10000</TotalBase>
     <Letra />
     <CajaOrigenBanco>false</CajaOrigenBanco>
     <CajaDestinoBanco>false</CajaDestinoBanco>
     <Cliente>
       <Codigo>1</Codigo>
       <Nombre>PEREZ, JUAN</Nombre>
       <RazonSocial />
     </Cliente>
     <Moneda>COP</Moneda>
     <BaseImponible>0</BaseImponible>
     <Alicuota>0</Alicuota>
     <Detalles>
       <Detalle>
         <Codigo>AN-</Codigo>
         <Descripcion>F:1 TN:9385468316 A:AV</Descripcion>
         <Importes>
           <ImporteItem>
             <Importe>10000</Importe>
             <CategoriaIVA>EXENT</CategoriaIVA>
             <ImporteIVA>0</ImporteIVA>
             <PorcIVA>0</PorcIVA>
           </ImporteItem>
         </Importes>
         <Proveedor>
           <Codigo>33</Codigo>
           <Nombre>BSP</Nombre>
           <RazonSocial>IATA</RazonSocial>
         </Proveedor>
         <Prestador>
           <Codigo>16</Codigo>
           <Nombre>NOMBRE AEROLINEA</Nombre>
           <RazonSocial>RAZON SOCIAL</RazonSocial>
         </Prestador>
       </Detalle>
     </Detalles>
     <Valores />
     <Imputaciones />
     <Impuestos />
   </Comprobante>

Para Versión 3.4.0.0 y Posteriores., el formato cambia. Se crea un nuevo nodo principal "XMLFile" el cual tiene una colección de comprobantes, quedando de esta manera:

Bloque de código
<?xml version="1.0" encoding="utf-8"?>
<XMLFile xmlns:xsd="" xmlns:xsi="">
  <Comprobantes>
    <Comprobante>
    ...
    </Comprobante>
  </Comprobantes>
</XMLFile>

Tipos de Datos

  • string: cadena de texto de cero o mas caracteres. Se informa en cada caso, tamaños máximo o habitual de cada campo.

  • int: numero entero sin decimales.

  • double: numero con decimales.

  • datetime: fecha y hora.

Sección Comprobante

Esta sección cuenta con la siguiente información:

Bloque de código
   <Comprobante xmlns:xsd="" xmlns:xsi="">
     <idComprobante>FACTU</idComprobante>
     <Sucursal>1</Sucursal>
     <Numero>10</Numero>
     <NumeroCompleto>10000010</NumeroCompleto>
     <Fecha>19/08/2015</Fecha>
     <FechaVencimiento>19/08/2015</FechaVencimiento>
     <CondicionPago>EF</CondicionPago>
     <CentroCostos>8010000</CentroCostos>
     <CodigoTipoComprobante>FA</CodigoTipoComprobante>
     <DescripcionTipoComprobante>Factura</DescripcionTipoComprobante>
     <CotizacionBase>1</CotizacionBase>
     <CotizacionAlter>0.000333</CotizacionAlter>
     <Total>10000</Total>
     <TotalAlter>3.33</TotalAlter>
     <TotalBase>10000</TotalBase>
     <CodigoCajaOrigen />
     <DescripcionCajaOrigen />
     <CodigoCajaDestino />
     <DescripcionCajaDestino />
     <Letra />
     <CajaOrigenBanco>false</CajaOrigenBanco>
     <CajaDestinoBanco>false</CajaDestinoBanco>
     <CajaOrigenDescripcion />
     <CajaDestinoDescripcion />
     <Cliente />
     <Proveedor />
     <Asesor />
     <Moneda>COP</Moneda>
     <BaseImponible>0</BaseImponible>
     <Alicuota>0</Alicuota>
     <Detalles />
     <Valores />
     <Imputaciones />
     <Impuestos />
   </Comprobante>
  • idComprobante: [string, 5] Es el identificador del comprobante. Se informa en todos los comprobantes. Ver mas.

  • Sucursal: [int] Es el identificador de la sucursal del comprobante. Se informa en todos los comprobantes. Ver mas.

  • Numero: [int] Es el numero que identifica a este comprobante. Por ejemplo el numero de factura, recibo, etc. Se informa en todos los comprobantes.

  • NumeroCompleto: [string, 11] Es la concatenación de la sucursal y el numero del comprobante, completando el numero con ceros a izquierda hasta 7 dígitos. Para Versión 3.4.0.0 y Posteriores.

  • Consecutivo:[int] Es el consecutivo interno de cada comprobante. Para Versión 3.4.51.15 y Posteriores.

  • idElectrónico:[string] Es identificador electrónico del comprobante, formado por el prefijo y el numero. Para Versión 3.4.51.15 y Posteriores.

  • Fecha: [datetime] Es la fecha de emisión del comprobante. Se informa en todos los comprobantes.

  • FechaVencimiento: [datetime] Es la fecha de vencimeinto del comprobante. Se informa en factura de cliente y proveedor únicamente. Para Versión 3.4.0.0 y Posteriores.

  • CondiciónPago: [string, 5] Es la condición de pago, efectivo, 15 días, 30 días, etc. Para Versión 3.4.0.0 y Posteriores.

  • CentroCostos: [string, 20] Es el código de centro de costo del comprobante. Se informa únicamente en Factura, Nota de débito y nota de crédito de cliente. Ver mas.

  • CódigoTipoComprobante y DescripciónTipoComprobante: [string, 2] y [string, 100] Son el código de descripción de uno de los siguientes tipos de comprobantes del sistema:

Bloque de código
   CD - Cruce de Documentos
   EC - Egreso de Caja
   FA - Factura
   IC - Ingreso de Caja
   LI - Liquidacion
   NC - Notas de Credito
   ND - Notas de Debito
   OC - Orden de Pago Cliente
   OP - Orden de Pago Proveedor
   PC - Notas de Credito Proveedor
   PF - Factura Proveedor
   RE - Recibo
   TC - Transferencia de Caja

Se informa en todos los comprobantes.

  • CotizacionBase: [double] Es la cotización o tasa de cambio entre la moneda del comprobante y moneda base. No se informa en Transferencias de Caja.

  • CotizacionAlter: [double] Es la cotización o tasa de cambio entre la moneda del comprobante y moneda alternativa. No se informa en Transferencias de Caja.

  • Total: [double] Es el importe total del comprobante en la moneda del mismo. En en Transferencias de Caja se informa siempre en moneda base.

  • TotalAlter: [double] Es el importe total del comprobante en moneda alternativa.

  • TotalBase: [double] Es el importe total del comprobante en moneda base.

  • Puntos: [double] Es la cantidad de puntos aplicados al comprobante.

  • Reintegro: [double] Es el importe de reintegro de IVA en comprobantes T de Argentina.

  • CódigoCajaOrigenDescripciónCajaOrigenCódigoCajaDestino y DescripciónCajaDestino: [int] y [string, 100] Son el código y descripción de las cajas origen y destino respectivamente. Solo se informan en Transferencias de Caja. Ver mas.

  • Letra: [string, 1] Es la letra del comprobante. La letra no se utiliza en todos los países. Se informa únicamente en Factura, Nota de débito y nota de crédito de cliente. Y también en Factura y Nota de Crédito proveedor.

  • CajaOrigenBanco y CajaDestinoBanco: [string, 5] Indica si la caja origen y destino son de tipo banco o no. Solo se informan en Transferencias de Caja. Los valores posibles son 'true' y 'false'.

  • CajaOrigenDescripción y CajaDestinoDescripción: [string, 100] Son la caja origen y destino del comprobante. Solo se informan en liquidaciones de valores. Para Versión 3.4.0.0 y Posteriores. estos campos se eliminaron y esta información se incluye en los campos DescripciónCajaOrigen y DescripciónCajaDestino respectivamente.

  • Cliente: SubSección opcional, solo se informa en comprobantes con Cliente (Factura cliente, nota crédito cliente, nota débito cliente, recibo cliente, orden de pago cliente y cruce de documentos de cliente). Ver detalle mas abajo.

  • Proveedor: SubSección opcional, solo se informa en comprobantes con Proveedor (Factura proveedor, nota crédito proveedor, orden de pago proveedor y cruce de documentos de proveedor y mixtos). Ver detalle mas abajo.

  • Asesor: SubSección asesor, se informa en todos los comprobantes (actualmente no se visualiza en liquidaciones, factura de proveedor y nota crédito de proveedor). Ver detalle mas abajo. Para Versión 3.4.0.0 y Posteriores.

  • Moneda: [string, 5] Es la moneda del comprobante. Se indica con el código IATA de monedas. En Transferencias de Caja se informa siempre moneda base.

  • BaseImponible y Alicuota: [double] y [double] Son la base imponible y alícuota de un concepto en el comprobante parametrizado con porcentaje. Solo se informa en Factura, nota de crédito y nota de débito de cliente en caso de tener al menos un concepto con porcentaje. En caso que el comprobante tenga dos o mas conceptos con porcentaje solo se vera la información de uno de ellos.

  • Detalles: SubSección opcional, solo se informa en comprobantes con Detalles (Factura cliente, nota crédito cliente, nota débito cliente, recibo cliente, factura proveedor, nota crédito proveedor y orden de pago proveedor). Ver detalle mas abajo.

  • Valores: SubSección opcional, solo se informa en comprobantes con Valores (Recibo cliente, orden pago cliente, orden pago proveedor, ingreso de caja, egreso de caja, transferencia de caja y liquidación de valores ). Ver detalle mas abajo.

  • Imputaciones: SubSección opcional, solo se informa en comprobantes con Imputaciones (Nota crédito cliente, Recibo cliente, orden pago cliente, nota crédito proveedor, orden pago proveedor y cruce de documentos ). Ver detalle mas abajo.

  • Impuestos: SubSección opcional, solo se informa en comprobantes con Impuestos (Orden pago cliente y orden pago proveedor). Ver detalle mas abajo.

Campos por Comprobante

Factura Cliente

Nota de Crédito Cliente

Nota de Débito Cliente

Recibo Cliente

Orden de Pago a Cliente

Cruce de Documentos

Factura Proveedor

Nota de Crédito Proveedor

Orden de Pago a Proveedor

Egreso de Caja

Ingreso de Caja

Transferencia

Liquidación de Valores

idComprobante

X

X

X

X

X

X

X

X

X

X

X

X

X

Sucursal

X

X

X

X

X

X

X

X

X

X

X

X

X

Numero

X

X

X

X

X

X

X

X

X

X

X

X

X

Fecha

X

X

X

X

X

X

X

X

X

X

X

X

X

FechaVencimiento

X

X

CentroCostos

X

X

X

CodigoTipoComprobante

X

X

X

X

X

X

X

X

X

X

X

X

X

DescripcionTipoComprobante

X

X

X

X

X

X

X

X

X

X

X

X

X

CotizacionBase

X

X

X

X

X

X

X

X

X

X

X

X

CotizacionAlter

X

X

X

X

X

X

X

X

X

X

X

X

Total

X

X

X

X

X

X

X

X

X

X

X

X

TotalAlter

X

X

X

X

X

X

X

X

X

X

X

X

TotalBase

X

X

X

X

X

X

X

X

X

X

X

X

CodigoCajaOrigen

X

DescripcionCajaOrigen

X

X

CodigoCajaDestino

X

DescripcionCajaDestino

X

X

Letra

X

X

X

CajaOrigenBanco

X

CajaDestinoBanco

X

CajaOrigenDescripcion

X

CajaDestinoDescripcion

X

Cliente

X

X

X

X

X

O

Proveedor

O

X

X

X

X

Asesor

X

X

X

X

X

X

X

X

X

X

Moneda

X

X

X

X

X

X

X

X

X

X

X

X

BaseImponible

X

X

X

Alicuota

X

X

X

Detalles

X

X

X

X

X

Valores

X

X

X

X

X

X

X

Imputaciones

X

X

X

X

X

X

Impuestos

X

X


SubSección Cliente

Bloque de código
 <Cliente>
   <Codigo>1</Codigo>
   <Nombre>Apellido, Nombre</Nombre>
   <RazonSocial />
   <TipoIdentificacion>1</TipoIdentificacion>
   <NumeroIdentificacion>12345678</NumeroIdentificacion>
   <PaisCodigo>CO</PaisCodigo>
   <CiudadNombre>Medellin, Colombia</CiudadNombre>
   <CiudadCodigo>MDE</CiudadCodigo>
   <CiudadCodigoMap>5001</CiudadCodigoMap>
   <ProvinciaCodigoMap>05</ProvinciaCodigoMap>
   <Direccion>CARRERA 48 # 34 A SUR-29</Direccion>
   <Telefono>4443234</Telefono>
 </Cliente>
  • Código: [int] Identificador de cliente.

  • Nombre: [string, 202] Apellido y nombre del cliente, separados por coma. Para clientes individuales.

  • RazónSocial: [string, 100] Razon social del cliente. Para clientes no individuales.

  • TipoIdentificación: [string, 5] Es el tipo de identificación del cliente. Por ejemplo el cedula o pasaporte. Para Versión 3.4.0.0 y Posteriores.

  • NumeroIdentificación: [string, 30] Es el número de identificación del cliente. Por ejemplo el numero de cedula o de pasaporte. Para Versión 3.4.0.0 y Posteriores.

  • PaisCódigo: [string, 2] Código IATA del pais de dirección del cliente.

  • CiudadNombre: [string, 150] Nombre de la ciudad de la dirección principal del cliente.

  • CiudadCódigo: [string, 3] Código de la ciudad de la dirección principal del cliente. Si es una ciudad con código IATA será el mismo código IATA, para las direcciones que se incorporaron a Netoffice y no son IATA sera el código con que se incorporaron a Netoffice.

  • CiudadCódigoMap: [string, 10] Código de la ciudad de la dirección principal del cliente según mapeo en reportes regionales.

  • ProvinciaCódigoMap: [string, 10] Código de la provincia o departemento de la dirección principal del cliente segun mapeo en reportes regionales.

  • Dirección: [string, 100] Dirección principal del cliente si se tiene.

  • Teléfono: [string, 30] Teléfono principal del cliente si se tiene.

SubSección Proveedor

Bloque de código
 <Proveedor>
   <Codigo>1</Codigo>
   <Nombre />
   <RazonSocial>Razón Social</RazonSocial>
   <TipoIdentificacion>1</TipoIdentificacion>
   <NumeroIdentificacion>12345678</NumeroIdentificacion>
 </Proveedor>
  • Codigo: [int] Identificador de proveedor.

  • Nombre: [string, 100] Nombre comercial del proveedor.

  • RazonSocial: [string, 100] Razón social del proveedor.

  • TipoIdentificacion: [string 5] Es el tipo de identificación del proveedor. Por ejemplo el cedula o pasaporte. Para Versión 3.4.0.0 y Posteriores.

  • NumeroIdentificacion: [string, 25] Es el número de identificación del proveedor. Por ejemplo el numero de cedula o de pasaporte. Para Versión 3.4.0.0 y Posteriores.

Cruces de documentos

Los cruces de documentos pueden ser de tipo:

  • Cliente, todos los comprobantes relacionados en el cruce, son de cliente.

  • Proveedor, todos los comprobantes relacionados en el cruce, son de proveedor.

  • Mixtos, hay comprobantes relacionados de cliente y de proveedor, adicional el cliente y proveedor estan relacionados en los maestros de cliente y proveedor.

Al generar el XML de un cruce solo se informa uno de los nodos Cliente o Proveedor. Si es un cruce de tipo proveedor o mixto se informa el nodo proveedor y si es un cruce de tipo cliente se informa el nodo cliente.

SubSección Prestador

Bloque de código
 <Prestador>
   <Codigo>1</Codigo>
   <Nombre />
   <RazonSocial>Razón Social</RazonSocial>
   <TipoIdentificacion>1</TipoIdentificacion>
   <NumeroIdentificacion>12345678</NumeroIdentificacion>
 </Prestador>
  • Código: [int] Identificador de prestador.

  • Nombre: [string, 200] Nombre comercial del prestador.

  • RazonSocial: [string, 200] Razón social del prestador.

  • TipoIdentificación: [string, 5] Es el tipo de identificación del prestador. Por ejemplo el cedula o pasaporte. Para Versión 3.4.0.0 y Posteriores.

  • NumeroIdentificación: [string, 32] Es el número de identificación del prestador. Por ejemplo el numero de cédula o de pasaporte. Para Versión 3.4.0.0 y Posteriores.

SubSección Asesor

Para Versión 3.4.0.0 y Posteriores.

Bloque de código
 <Asesor>
   <Codigo>1</Codigo>
   <Nombre>Juan Perez</Nombre>
   <RazonSocial />
   <TipoIdentificacion/>
   <NumeroIdentificacion>12345678</NumeroIdentificacion>
 </Asesor>
  • Codigo: [int] Identificador de asesor.

  • Nombre: [string, 100] Nombre del asesor.

  • RazonSocial: Siempre vacio.

  • TipoIdentificacion: Siempre vacio.

  • NumeroIdentificacion: [string, 50] Es el número de identificación del asesor. Por ejemplo el numero de cedula.

SubSección Detalles

Bloque de código
   <Detalle>
     <Codigo>AN-</Codigo>
     <Descripcion>F:1 TN:9383768316 A:AV</Descripcion>
     <CostoVenta>23270</CostoVenta>
     <TipoTarifa>TP</TipoTarifa>
     <TasaConversion>3027.55</TasaConversion>
     <ImporteTarifaServicio>17900</ImporteTarifaServicio>
     <ImporteIVAServicio>5370</ImporteIVAServicio>
     <ImporteImpoconsumoServicio>0</ImporteImpoconsumoServicio>
     <ImporteDescuentoServicio>0</ImporteDescuentoServicio>
     <ImporteOtrosImpuestosServicio>0</ImporteOtrosImpuestosServicio>
     <Importes />
     <Proveedor />
     <Prestador />
   </Detalle>

Es una colección de objetos 'Detalle' cada 'Detalle' representa una linea de detalle del comprobante.

  • Código y Descripción: [string, 5] y [string, 150] Es el código y la descripción del servicio o concepto.

Bloque de código
   Código y descripción de servicios 
   AI - Aereo Internacional
   AN - Aereo Nacional
   BI - Barco Internacional
   BN - Barco Nacional
   HI - Hotel Internacional
   HN - Hotel Nacional
   PI - Paquete Internacional
   PN - Paquete Nacional
   RI - Rent a Car Internacional
   RN - Rent a Car Nacional
   SI - Asistencia Internacional
   SN - Asistencia Nacional
   VI - Vario Internacional
   VN - Vario Nacional
   Para los servicios VARIO, se concatena el código de subtipo, según tabla tipo.

Para el caso de conceptos de comprobantes, código y descripción se informan según su parametrizacion ver mas

ver mas

  • CostoVenta: [double] Es el importe proveedor del servicio, el cual representa el costo estimado de cada servicio. En el caso de detalles de gastos/fee o conceptos, no tendrá importe esta campo. Para Versión 3.4.0.0 y Posteriores.

  • TipoTarifa: [string, 2] Se indica el tipo de tarifa por ejemplo comisionable o neta. Para Versión 3.4.0.0 y Posteriores.

Bloque de código
DC: Diferencia de Costo
OC: Over sobre la Tarifa - Comision
OT: Over sobre la Tarifa
TN: Tarifa Neta
TP: Tarifa Comisionable
  • CentroCostos: [string] Es el código de centro de costos. Para Versión 3.4.51.15 y Posteriores.

  • idProyecto: [string] Es el código de proyecto del servicio o concepto. Para Versión 3.4.51.15 y Posteriores.

  • Proyecto: [string] Es nombre de proyecto del servicio o concepto. Para Versión 3.4.51.15 y Posteriores.

  • idProyectoFile: [string] Es el código de proyecto del expediente. Para Versión 3.4.51.15 y Posteriores.

  • ProyectoFile: [string] Es nombre de proyecto del expediente. Para Versión 3.4.51.15 y Posteriores.

  • CodigoReferencia: [string] Es el código de referencia del servicio. Para Versión 3.4.51.15 y Posteriores.

  • Expediente: [string] Es el código de expediente del servicio. Para Versión 3.4.51.15 y Posteriores.

  • Itinerario: [string] Es el código de itinerario del servicio. Para Versión 3.4.51.15 y Posteriores.

  • IdTipoViaje: [string] Es el código de tipo de viaje del servicio. Para Versión 3.4.51.15 y Posteriores.

  • TipoViaje: [string] Es el nombre de tipo de viaje del servicio. Para Versión 3.4.51.15 y Posteriores.

  • TasaConversión: [double] es la relación entre conversión base y alter en cada servicio. En el caso de aéreos es la conversión BSP o TRM del dia. Para Versión 3.4.0.0 y Posteriores.

  • MonedaAlter: [string] es el código de moneda alternativa del detalle.

  • ImporteTarifaServicio: [double] Es el importe de la tarifa del servicio en el expediente, según porcentaje del servicio facturado y en moneda de la factura. Para Versión 3.4.0.0 y Posteriores.

  • ImporteIVAServicio: [double] Es el importe del IVA del servicio en el expediente, según porcentaje del servicio facturado y en moneda de la factura. Para Versión 3.4.0.0 y Posteriores.

  • ImporteImpoconsumoServicio: [double] Es el importe del impoconsumo del servicio de cada detalle de las facturas o NC de cliente.

  • ImporteDescuentoServicio: [double] Es el importe del descuento del servicio de cada detalle de las facturas o NC de cliente. Para Versión 3.4.29.0 y Posteriores.

  • ImporteOtrosImpuestosServicio: [double] Es el importe de otros impuestos del servicio en el expediente, según porcentaje del servicio facturado y en moneda de la factura. Para Versión 3.4.0.0 y Posteriores.

  • Importes: [double] Se detallan los importes, base imponibles y alícuotas. Ver detalle mas abajo.

  • Proveedor: SubSección opcional, solo se informa en detalles de servicios. Ver en SubSección Proveedor.

  • Prestador: SubSección opcional, solo se informa en detalles de servicios. Ver en SubSección Prestador.

SubSección Importes

Es una colección de objetos 'ImporteItem'.

Bloque de código
       <ImporteItem>
         <Importe>10000</Importe>
         <CategoriaIVA>IVA_A</CategoriaIVA>
         <ImporteIVA>1600</ImporteIVA>
         <PorcIVA>16</PorcIVA>
       </ImporteItem>
  • Importe: [double] Es el importe o base imponible para cada alícuota de IVA.

  • CategoriaIVA: [string, 5] Es el identificador de categoría de IVA.

  • ImporteIVA: [double] Es el importe correspondiente al IVA.

  • PorcIVA: [double] Es el porcentaje de IVA.

SubSección Valores

Es una colección de objetos 'Valor'.

Bloque de código
   <Valor>
     <Codigo>0</Codigo>
     <Nombre>Nombre</Nombre>
     <RazonSocial>Razon Social</RazonSocial>
     <MainCPP>XX</MainCPP>
     <CodigoCaja>4</CodigoCaja>
     <DescripcionCaja>Caja BSP</DescripcionCaja>
     <CajaBanco>false</CajaBanco>
     <CodigoTipoValor>TC</CodigoTipoValor>
     <DescripcionTipoValor>TARJETA DE CREDITO</DescripcionTipoValor>
     <Moneda>COP  </Moneda>
     <CotizacionBase>1</CotizacionBase>
     <CotizacionAlter>0.000333</CotizacionAlter>
     <Importe>3802980</Importe>
     <ImporteAlter>1266.39</ImporteAlter>
     <ImporteBase>3802980</ImporteBase>
     <PNR>0</PNR>
     <NumeroFactura>0</NumeroFactura>
     <NumeroAutorizacion>794114</NumeroAutorizacion>
     <IdTarjeta>VI</IdTarjeta>
     <BIN>496084</BIN>
     <CodigoUnicoDatafono/>
     <Cupon>123</Cupon>
     <Titular>JUAN PEREZ</Titular>
     <Conceptos />
   </Valor>
  • Código: [int] Es el código del cliente del valor. Solo se utiliza en liquidaciones de valores.

  • Nombre: [string, 202] Es el nombre del cliente del valor. Solo se utiliza en liquidaciones de valores.

  • RazonSocial: [string, 100] Es la razón social del cliente del valor. Solo se utiliza en liquidaciones de valores.

  • MainCPP: [string, 10] Es el PCC del cliente del valor. Solo se utiliza en liquidaciones de valores.

  • CódigoCaja y DescripciónCaja: [int] y [string, 100] Son el código y descripción de la caja del valor. Ver mas.

  • CajaBanco: [bool] Indica si la caja es de tipo banco o no. Los valores posibles son 'true' y 'false'.

  • IdProyecto: [string] Es el código de proyecto de la caja. Para Versión 3.4.51.15 y Posteriores.

  • Proyecto: [string] Es el nombre de proyecto de la caja. Para Versión 3.4.51.15 y Posteriores.

  • CodigoTipoValor y DescripciónTipoValor: [string, 2] y [string, 100] Son el código y descripción del tipo de valor.

  • Moneda: [string, 5] Es la moneda del valor. Se indica con el código IATA de monedas.

  • CotizaciónBase: [double] Es la cotización o tasa de cambio entre la moneda del valor y moneda base.

  • CotizaciónAlter: [double] Es la cotización o tasa de cambio entre la moneda del valor y moneda alternativa.

  • Importe: [double] Es el importe del valor del comprobante en la moneda del mismo.

  • ImporteAlter: [double] Es el importe del valor en moneda alternativa.

  • ImporteBase: [double] Es el importe del valor en moneda base.

  • Puntos: [double] Es la cantidad de puntos de este valor.

  • FechaValor: [string] Es la fecha de este valor.

  • BoletaDeposito: [string] Es el dato de boleta deposito de este valor.

  • Banco: [string] Es el dato de banco de este valor.

  • Numero: [string] Es el dato de numero de este valor.

  • PNR: [string, 10] Es el codigo de PNR asociado al valor. Solo se informa en liquidación de valores.

  • NumeroFactura: [int] Indica el numero de factura relacionado. Solo se informa en liquidación de valores.

  • NumeroAutorizacion: [string, 50] es el número de autorización para pagos con tarjeta. Para Versión 3.4.0.0 y Posteriores.

  • IdTarjeta: [string, 2] Es el ID de la tarjeta del valor para pagos con tarjeta. Para Versión 3.4.0.0 y Posteriores.

  • CodigoEstablecimiento: [string] Es codigo de establecimiento de este valor.

  • IdFranquicia: [string] Es codigo de franquicia de este valor.

  • BIN: [string, 6] Son los primeros 6 dígitos del número de tarjeta. Para Versión 3.4.0.0 y Posteriores.

  • CodigoUnicoDatafono: [string, 50] Es un dato que identifica a cada sucursal o punto de venta. Para Versión 3.4.0.0 y Posteriores.

  • Cupon: [string, 50] Es el numero de cupon por ejemplo para tarjetas de credito. Para Versión 3.4.50.1 y Posteriores.

  • Titular: [string, 50] Es el dato del titular de tarjeta crédito. Para Versión 3.4.50.1 y Posteriores.

  • Conceptos: Es una colección de objetos 'Detalle'. Ver en SubSección Detalles.

SubSección Imputaciones

Es una colección de objetos 'Imputación'. Cada uno representa a un comprobante relacionado.

Bloque de código
   <Imputacion>
     <idComprobante>FACTU</idComprobante>
     <Sucursal>1</Sucursal>
     <Numero>3</Numero>
     <NumeroCompleto>30000003</NumeroCompleto>
     <Importe>10000</Importe>
     <Moneda>COP  </Moneda>
   </Imputacion>
  • dComprobante: [string, 5] Es el identificador del comprobante. Ver mas.

  • Sucursal: [int] Es el identificador de la sucursal del comprobante. Ver mas.

  • PuntoVenta: [string] Es el código de punto de venta del comprobante.

  • IdElectronico: [string] Es el identificador electronico del comprobante prefijo mas numero. Para Versión 3.4.51.15 y Posteriores.

  • Numero: [int] Es el numero que identifica a este comprobante. Por ejemplo el numero de factura, recibo, etc.

  • NumeroCompleto: [string, 11] Es la concatenación de la sucursal y el numero del comprobante, completando el numero con ceros a izquierda hasta 7 dígitos. Para Versión 3.4.4.0 y Posteriores.

  • Importe: [double] Es el importe a relacionar para este comprobante.

  • Moneda: [string, 5] Es la moneda del comprobante. Se indica con el código IATA de monedas.

SubSección Impuestos

Es una colección de objetos 'Impuesto'.

Bloque de código
   <Impuesto>
     <idComprobante>FACTU</idComprobante>
     <Sucursal>1</Sucursal>
     <Numero>3</Numero>
     <Importe>10000</Importe>
     <Moneda>COP  </Moneda>
   </Impuesto>
  • Código y Descripción: [string, 5] y [string, 100] Es el código y descripción del concepto. Ver mas.

  • CentroCostos: [string] Es el centro de costos del impuesto.

  • Moneda: [string, 5] Es la moneda del concepto. Se indica con el código IATA de monedas.

  • CotizaciónBase: [double] Es la cotización o tasa de cambio entre la moneda del concepto y moneda base.

  • CotizaciónAlter: [double] Es la cotización o tasa de cambio entre la moneda del concepto y moneda alternativa.

  • Importe: [double] Es el importe del concepto.

  • ImporteAlter: [double] Es el importe del concepto en moneda alternativa.

  • ImporteBase: [double] Es el importe del concepto en moneda base.

Instalación del Servicio

  1. Se deben actualizar los datos del archivo de configuración XMLExporterService.exe.config

  • Con los datos de acceso a la base de NetOffice.

  • Setear el nivel de detalle de Log deseado.

  • Setear el timer del servicio (en milisegundos).

  • Setear el path donde se generaran los archivos XML.

  • Setear el archivo de log.

2. Crear un usuario local en la pc donde correrá el servicio.

3. Darle permisos de inicio de sesión como servicio.

  • Panel de Control

  • Herramientas Administrativas

  • Directiva de seguridad local

  • Directivas locales

  • Asignación de derechos de usuario

  • Iniciar sesión como servicio

  • y agregar el usuario creado

4. Ejecutar el archivo Install.bat de esta misma carpeta.

5. Verificar el mensaje en pantalla, si fue satisfactorio o si solicita ajustar algo.

  • Al correrlo va a pedir el usuario que utilizara el servicio.

  • Ingresamos los datos del usuario que creamos.

Almacenamiento de XML y Log en S3 (WI 90425)

A partir de la version 3.6.1.15, es posible almacenar los archivos XMLs y logs del exporter XML en S3.

Para esto se deben seguir los siguientes pasos:

n el archivo de configuracion se agregan las siguientes opciones:

    <add key="AWS:enable" value="true"/>

    <add key="AWS:region" value="us-east-1"/>

    <add key="AWS:accessKey" value="AKIAQSSJCI3BKONXUM32"/>

    <add key="AWS:secretKey" value="QVzt7Oc8Kj572May9QBnZI4Iod6nuQ5nflcylRjQ"/>

    <add key="AWS:bucket" value="netoffice-exporter-testing"/>

  •  AWS:enable: cuando esta key esta en true los .xml de los comprobantes y los archivos de logs se guardaran en S3, si se encuentra en false, no se guardan en S3 si no en la carpeta especificada en el mismo archivo de configuracion.

  •  AWS:region: jamas modificar, region del servidor S3

  •  AWS:accessKey y AWS:secretKey: son las credenciales en AWS que permiten el acceso al Bucket

  •  AWS:bucket: es el nombre del contenedor en AWS que guardara los archivos en S3.

NOTA: a partir de este cambio el exporter XML requiere el framework .net 4.5.