Basándonos en la necesidad de algunas empresas de exportar datos masivos de EVO de todas las unidades, hemos desarrollado algunas nuevas funcionalidades en nuestra API que permiten descargar un archivo XLS directamente desde el navegador.

Intentamos proporcionar la máxima información posible en el archivo para que puedan utilizarlo de la forma más adecuada.

Para descargar el archivo con los datos deseados, solamente tienes que copiar la URL (dirección) informada aquí, pegarla en tu navegador (Chrome es el recomendado), cambiar los parámetros (cuando sea necesario) y pulsar la tecla ENTER para iniciar el proceso de descarga.

El navegador solicitará una autenticación. En este punto introducirá el DNS y la clave secreta que se encuentra en tu EVO, en Ajustes > Integraciones - API de EVO. Si desea Para acceder a los datos de todas las unidades al mismo tiempo, utiliza la clave que encontrarás en el módulo de Administración General.

Una vez hecho esto, el archivo comenzará a descargarse automáticamente. ⤵

URL: https://evo-integracao.w12app.com.br/api/v1/members/summary-excel

Para este archivo, no será necesario introducir ningún parámetro. La API siempre devolverá todos los clientes activos, suspendidos y VIP en el momento de la consulta.

URL: https://evo-integracao.w12app.com.br/api/v1/members/summary-excel?effectiveDate=2023-09-017

Colocando además el parámetro de la fecha, podremos obtener la lista de clientes activos en una fecha específica.

URL: https://evo-integracao.w12app.com.br/api/v1/managment/not-renewed?dtStart=2023-04-01&dtEnd=2023-04-30

Este reporte te mostrará todos los planes NO RENOVADOS

Filtrando por status ACTIVO/ INACTIVO será posible ver los clientes que aún tienen otro plan activo, o los que no renovaron un plan y están inactivos, por no tener ningún plan activo en ese momento.

Para este tipo de archivo, DEBE introducir al menos un parámetro de fecha. En el ejemplo anterior se utiliza la Fecha de recepción, pero es posible buscar utilizando otras fechas, y también filtrar por tipo de recepción, que se indica a continuación. Los parámetros se informan en la dirección después del signo de interrogación (?), y para separar los parámetros se utilizará el signo &.

Para filtrar por un tipo de FECHA, debes usar siempre DESDE y HASTA.

Por ejemplo: quieres consultar todos los cobros que vencen en el mes de abril de 2021.

Usarás ?dtVencimentoDe=2021-04-01&dtVencimentoAte=2021-04-30. Quedará así::

https://evo-integracao.w12app.com.br/api/v1/receivables/summary-excel?dtVencimentoDe=2021-04-01&dtVencimentoAte=2021-04-30

• Fecha de Carga en el sistema (dtLancamentoDe / dtLancamentoAte)

• Fecha de Original Carga en el sistema (dtLancamentoOriginalDe / dtLancamentoOriginalAte)

• Fecha de Vencimiento (dtVencimentoDe / dtVencimentoAte)

• Fecha de Cobro (dtRecebimentoDe / dtRecebimentoAte)

• Fecha de Venta (dtVendaDe / dtVendaAte)

• Tipo de Cobro (idTipoRecebimento)

• Fecha de Previsión de cobranza (dtPrevisaoCobrancaDe / dtPrevisaoCobrancaAte)

• bool exibirSaldoDevedor = false

• Dinero=1

• Tarjeta de crédito=2

• Tarjeta de débito=3

• Cheque=4

• Boleto Bancario=5

• PagSeguro=6

• Depósito=7

• Débito en cuenta=8

• Internet=9

• Crédito de venta=11

• Tarjeta de crédito online=12

• Transferencia=13

Por último, dejamos un ejemplo de la URL con todos los parámetros incluidos.

https://evo-integracao.w12app.com.br/api/v1/receivables/summary-excel?idTipoRecebimento=1&dtLancamentoDe=2021-01-01&dtLancamentoAte=2021-01-31&dtVencimentoDe=2021-01-01&dtVencimentoAte=2021-01-31&dtRecebimentoDe=2021-01-01&dtRecebimentoAte=2021-01-31&dtVendaDe=2021-01-31&dtVendaAte=2021=01-31

Una consulta muy útil para tu empresa son las Ventas filtrando por la fecha original de carga

https://evo-integracao.w12app.com.br/api/v1/receivables/summary-excel?dtLancamentoOriginalDe=2023-04-01&dtLancamentoOriginalAte=2023-04-31&exibirSaldoDevedor=false

api/v1/receivables/projection-summary-excel

api/v1/receivables/receivables-by-revenue-excel

api/v1/receivables/receivables-charged-excel

URL: https://evo-integracao.w12app.com.br/api/v1/invoices?dtEnvioInicio=01-01-2022&dtEnvioFim=01-01-2022&dtEmissaoInicio=01-01-2022&dtEmissaoFim=01-01-2022&status=0&idFilial=0

Para este expediente, es necesario informar del periodo de consulta, mediante el envío o fecha de emisión. No es necesario informar de ambos parámetros.

El parámetro Estado puede utilizarse para filtrar. Si quieres traer todas las notas enviadas, con todos los estados, usa 0.

0 = todos los resultados

1 = aguardando envío

2 = aguardando respuesta

3 = cancelada

4 = error

Los parámetros fecha de envío (dtSendStart/dtSendEnd) y fecha de emisión (dtEmissionsStart/dtEmissionsEnd), puede utilizarse en formato AAAAMMDD o DDMMAAAA.

Si estás utilizando un token de la Administración General, puedes filtrar por unidades o dejar el parámetro idFilial como 0.

URL: https://evo-integracao.w12app.com.br/api/v1/invoices/CSV?dtEmissaoInicio=2022-08-01&dtEmissaoFim=2022-08-23

Este enlace permite descargar un archivo CSV con todas las facturas emitidas en un periodo determinado.

El parámetro introducido en el enlace es la fecha de emisión.

Para recibir información de una sucursal concreta, debe autenticarse con el token de esa sucursal.

Para recibir información de todas las unidades, o de un grupo de sucursales, utilice el token generado en la función

Administración General o en alguna otra agrupación (oficinas centrales).

Cualquier duda, ¡estamos aquí para ayudarte!