Módulo de App Online para descargar todas las líneas de factura de venta de Exact Online

Invantive SQL soporta Exact Online con más de 1.100 tablas. Además, existen productos como Get My Report donde informes predefinidos ponen los datos a disposición como descarga a través de múltiples administraciones de una sola vez.

Sin embargo, a veces es deseable disponer de una herramienta de informes propia en la que los usuarios de la empresa puedan obtener los informes en un formato propio fijo. Con Invantive Cloud esto es posible, incluso sin usar Power BI o Qlik.

Este tema muestra cómo puedes seleccionar y descargar de una sola vez todas las líneas de factura de venta con información adicional mediante tu propia app de Invantive Cloud. El formato de descarga en Excel es un formato muy utilizado por los gerentes de ventas y vendedores que quieren analizar sus actividades comerciales de Exact Online mediante sus propias tablas dinámicas. La consulta SQL de Exact Online es el módulo Líneas de Factura de Venta en Get My Report para Exact Online.

Las cifras de ventas pueden provenir de una sola administración financiera o de varias a la vez, según se haya configurado en la base de datos de Exact Online en Invantive Cloud. Ten en cuenta que los datos financieros del libro de ventas de diferentes administraciones pueden tener una base diferente, por ejemplo en euros y en dólares estadounidenses.

Si una app necesita más de 3 minutos o debe invocarse de forma automatizada, esto puede hacerse mediante Invantive App Online, la hermana de Invantive Bridge Online para Power BI. Consulta también Wat is Invantive App Online?.

Preparativos

Se necesitan los siguientes preparativos:

  • Un código de inicio de sesión en Invantive Cloud.
  • Un código de inicio de sesión en Exact Online con una o varias administraciones.

Definir la base de datos de Exact Online

El primer paso es definir una base de datos de Exact Online. Esto puede hacerse fácilmente siguiendo este plan de pasos:

Esta base de datos de Exact Online puedes usarla para Power BI, Power Query o Azure Data Factory, pero igual de fácilmente, por ejemplo, para Access OData o, como en este caso, como fuente para una aplicación de Invantive Cloud.

Definir la aplicación en la nube

El siguiente paso es definir una app en Invantive Cloud que obtenga las cifras de ventas de Exact Online. Sigue los siguientes pasos:

Crear el archivo Excel y rellenarlo con las cifras de ventas de Exact Online

Este módulo contendrá el código para especificar la configuración y luego crear el archivo Excel con las cifras de ventas de Exact Online.

El código completo se encuentra al final de este artículo.

¿Quieres avanzar rápidamente?

  • Pega el código en el módulo, en el campo “Código fuente”.
  • Elige “My First App” en la ruta de navegación (breadcrumb) en la parte superior.
  • Elige “Ejecutar”.
  • Elige la base de datos de Exact Online (si hay varias bases de datos).
  • Elige “Ejecutar”:
  • Elige el módulo:
  • Rellena la fecha de inicio y de fin:
  • Se descargará el archivo Excel.

Más ejemplos de apps

Más ejemplos de apps propias se pueden encontrar en:

Código fuente del informe de ventas

El siguiente código fuente es la herramienta de informes para descargar la información de ventas de Exact Online como un libro de Excel. Mientras la variable p_run no sea true, se mostrará la pantalla de entrada para la fecha de inicio y de fin. El libro de Excel se descarga cuando la variable p_run se establece en true mediante la pantalla de entrada.

declare
  p_run                         boolean  := false;
  p_cfn_factuur_datum_vanaf     date     := null;
  p_cfn_factuur_datum_tot       date     := null;
  --
  l_workbook                    excel_workbook;
  l_worksheet                   excel_worksheet;
  l_binary                      blob;
begin
  --
  -- Obtener parámetros.
  --
  p_run               := cast(cloud_http.get_request_query_parameter_value('p_run') as boolean);
  --
  p_cfn_factuur_datum_vanaf := to_date(cloud_http.get_request_query_parameter_value('p_cfn_factuur_datum_vanaf'), 'YYYY-MM-DD');
  p_cfn_factuur_datum_tot   := to_date(cloud_http.get_request_query_parameter_value('p_cfn_factuur_datum_tot'), 'YYYY-MM-DD');
  --
  if coalesce(p_run, false) = false
  then
    cloud_http.set_use_template(true);
    cloud_http.set_template_step_name(translate_resources('{res:itgen_parameters}'));
    cloud_http.append_line_to_response_body_text('<form>');
    cloud_http.append_line_to_response_body_text('<input type="hidden" id="p_run" name="p_run" value="true"/>');
    cloud_http.append_line_to_response_body_text('<ul>');
    cloud_http.append_line_to_response_body_text('<li><label for="p_cfn_factuur_datum_vanaf">' || translate_resources('{res:itgen_invoice_date_from}') || '</label></li><li><input id="p_cfn_factuur_datum_vanaf" name="p_cfn_factuur_datum_vanaf" type="date" value="' || to_char(add_months(trunc(sysdateutc, -1), -1), 'YYYY-MM-DD') || '"/></li>');
    cloud_http.append_line_to_response_body_text('<li><label for="p_cfn_factuur_datum_tot">' || translate_resources('{res:itgen_invoice_date_to}') || '</label></li><li><input id="p_cfn_factuur_datum_tot" name="p_cfn_factuur_datum_tot" type="date" value="' || to_char(add_months(trunc(sysdateutc, -1), +1), 'YYYY-MM-DD') || '"/></li>');
    cloud_http.append_line_to_response_body_text('<li><input type="submit" value="Start"/></li>');
    cloud_http.append_line_to_response_body_text('</ul>');
    cloud_http.append_line_to_response_body_text('</form>');
  else
    --
    -- Comprobar parámetros.
    --
    -- Sin comprobaciones.
    --
    -- Crear un libro de Excel.
    --
    l_workbook := excel.new();
    --
    -- Añadir una hoja de cálculo para las líneas de factura de venta de Exact Online.
    --
    l_worksheet := excel.add_worksheet
    ( l_workbook
    , 'SALES SOURCE DATA'
    );
    --
    -- Crear una lista de líneas de factura de venta.
    --
    create or replace table rpt@inmemorystorage
    as
    select /*+ result_set_name("SalesInvoiceLines") */
           sie.invoicenumber
           label 'Invoice Number'
    ,      sle.LineNumber
           label 'Line Number'
    ,      sie.invoicedate
           label 'Invoice Date'
    ,      sie.ordernumber
           label 'Order Number'
    ,      sie.orderdate
           label 'Order Date'
    ,      sie.SalespersonFullName
           label 'Sales Person Full Name'
    ,      actord.code
           label 'Ordered by Code'
    ,      actord.name
           label 'Ordered by Name'
    ,      cttord.fullname
           label 'Ordered by Contact'
    ,      amrord.FullName AccountManagerFullName
           label 'Ordered by Account Manager'
    ,      actord.Email
           label 'Ordered by Email'
    ,      actdlr.code
           label 'Deliver to Company Code'
    ,      actdlr.name
           label 'Deliver to Company Name'
    ,      sie.delivertocontactpersonfullname
           label 'Deliver to Contact'
    ,      adsdlr.addressline1
           label 'Deliver to Address Line 1'
    ,      adsdlr.postcode
           label 'Deliver to Postcode'
    ,      adsdlr.city
           label 'Deliver to City'
    ,      adsdlr.country
           label 'Deliver to Country'
    ,      actdlr.email
           label 'Deliver to Email'
    ,      amrive.FullName AccountManagerFullName
           label 'Invoice Account Manager'
    ,      active.name
           label 'Invoice Company Name'
    ,      active.Email
           label 'Invoice Email'
    ,      active.AddressLine1
           label 'Invoice Address Line 1'
    ,      active.Postcode
           label 'Invoice Postcode'
    ,      active.City
           label 'Invoice City'
    ,      active.Country
           label 'Invoice Country'
    ,      sie.duedate
           label 'Due Date'
    ,      gat.Code GLAccountCode
           label 'General Ledger Account'
    ,      igp.code itemgroupcode
           label 'Item Group'
    ,      sle.itemcode
           label 'Item Code'
    ,      sle.itemdescription
           label 'Item Description'
    ,      sle.description
           label 'Description'
    ,      sim.SupplierCode
           label 'Main Supplier Code'
    ,      sim.SupplierDescription
           label 'Main Supplier Name'
    ,      sle.StartTime
           label 'Start'
    ,      sle.EndTime
           label 'End'
    ,      sle.quantity
           label 'Quantity'
    ,      sle.UnitDescription
           label 'Unit Description'
    ,      sle.NetPrice
           label 'Net Price'
    ,      sle.unitprice
           label 'Unit Price'
    ,      sle.discount * 100
           label 'Discount'
    ,      sle.unitprice * ( 1 - sle.discount )
           label 'Net Price per Unit'
    ,      sle.netamountdc
           label 'Net Price Total'
    ,      sle.unitprice * sle.discount * sle.quantity
           label 'Amount Discount'
    ,      sle.VATAmountDC
           label 'VAT Amount (EUR)'
    ,      itm.costpricecurrency
           label 'Cost Price Currency'
    ,      itm.costpricestandard
           label 'Cost Price Standard'
    ,      itm.costpricestandard * sle.quantity
           label 'Standard Cost Price Total'
    ,      itm.NetWeight
           label 'Net Weight'
    ,      itm.GrossWeight
           label 'Gross Weight'
    from   exactonlinerest..salesinvoicesbulk@eol sie
    join   exactonlinerest..salesinvoicelinesBulk@eol sle
    on     sle.division  = sie.division
    and    sle.invoiceid = sie.invoiceid
    join   ItemsIncremental@eol itm
    on     itm.division = sle.division
    and    itm.id       = sle.item
    join   ItemGroups@eol igp
    on     igp.division = itm.division
    and    igp.id       = itm.ItemGroup
    join   GLAccountsIncremental@eol gat
    on     gat.Id = sle.GLAccount
    join   AccountsIncremental@eol actord
    on     actord.division = sie.division
    and    actord.id       = sie.orderedby
    left
    outer
    join   exactonlinerest..users@eol amrord
    on     amrord.userId  = actord.AccountManager
    left
    outer
    join   ContactsIncremental@eol cttord
    on     cttord.id       = sie.orderedbycontactperson
    join   AccountsIncremental@eol actdlr
    on     actdlr.id       = sie.deliverto
    left
    outer
    join   AddressesIncremental@eol adsdlr
    on     adsdlr.id       = sie.delivertoaddress
    join   AccountsIncremental@eol active
    on     active.id       = sie.invoiceto
    left
    outer
    join   exactonlinerest..users@eol amrive
    on     amrive.userId  = actord.AccountManager
    left
    outer
    join   SupplierItems@eol sim
    on     sim.division     = sle.division
    and    sim.ItemCode     = sle.itemcode
    and    sim.MainSupplier = true
    where  sie.status = 50
    and    sie.invoicedate between coalesce(p_cfn_factuur_datum_vanaf, sie.invoicedate) and coalesce(p_cfn_factuur_datum_tot, sie.invoicedate) 
    order
    by     sie.invoicenumber
    ,      sie.ordernumber
    ,      sle.linenumber
    ;
    --
    -- Colocar los artículos en la hoja de cálculo de Excel.
    --
    excel.fill_using_query(l_worksheet, 'select * except rowid$ from rpt@inmemorystorage');
    --
    -- Añadir una hoja de cálculo con un título.
    --
    l_worksheet := excel.add_worksheet
    ( l_workbook
    , 'FILTER'
    );
    excel.set_cell_contents(l_worksheet, 'A1', 'Sales Invoices');
    excel.set_cell_contents(l_worksheet, 'A3', translate_resources('{res:itgen_user}'));
    excel.set_cell_contents(l_worksheet, 'B3', sys_context('USERENV', 'USER_FULL_NAME', 'eol'));
    --
    excel.set_cell_contents(l_worksheet, 'A4', translate_resources('{res:itgen_generated}'));
    excel.set_cell_contents(l_worksheet, 'B4', to_char(sysdateutc, 'DD-MM-YYYY HH24:MI:SS'));
    --
    excel.set_cell_contents(l_worksheet, 'A6', translate_resources('{res:itgen_invoice_date_from}'));
    excel.set_cell_contents(l_worksheet, 'B6', p_cfn_factuur_datum_vanaf);
    --
    excel.set_cell_contents(l_worksheet, 'A7', translate_resources('{res:itgen_invoice_date_to}'));
    excel.set_cell_contents(l_worksheet, 'B7', p_cfn_factuur_datum_tot);
    --
    -- Obtener el archivo XLSX resultante.
    --
    l_binary := excel.export_to_xlsx(l_workbook);
    --
    -- Devolver el archivo XLSX al usuario.
    --
    cloud_http.set_response_body_binary(l_binary);
    cloud_http.set_response_content_type('application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
    cloud_http.set_response_header_value
    ( 'Content-Disposition'
    , 'attachment; filename="Sales Invoices Fixed Format.xlsx'
    );
  end if;
end;