EVO API ES
Inicio
GuíasAPIs💎 API Pro📢 Novedades
Inicio
GuíasAPIs💎 API Pro📢 Novedades
  1. Casos de uso
  • ¡Bienvenido 💜
  • 📃 Guías
    • Primeros pasos con la API
      • Primeros pasos con la EVO API
      • Permisos de token
      • Límites de solicitudes
      • API Pro
    • Comprender la documentación
      • Utilizar la documentación de forma eficaz
      • Novedades
    • Casos de uso
      • Realizar ventas online a través de API
      • Integración de EVO Pay
      • Cómo usar webhooks
      • Agendamiento de una clase experimental
      • Exportar llamadas a Excel
      • Conciliación de pagos bancarios
      • Emisión de factura
    • FAQ
      • Configuraciones e integraciones
      • Gestión de clientes y relaciones
      • Operación y actividades
      • Financiero
    • Sugerencias
      • Sugerencia de implementación
  • 🌐 API Reference
    • AccessControl
      • Post access control entry authorize
      • Post access control insert manual liberation
      • Get access control turnstiles
      • Update access control serial number turnstiles
    • Activities
      • Get activities
      • Get activities schedule
      • Get activities schedule details
      • Enroll member in activity schedule
      • Change status of a member in activity schedule
      • Create a new experimental class and enroll the member on it
      • List of spots that are already filled in the activity session
      • Get activities schedule by idService or idMembership
      • Get activities enrollment by member or membership
      • Create a new enrollment for a member
      • Delete enrollment
      • Get enrollment details for a member
      • Book member in activity schedule
      • Change status of a member in activity schedule
      • Get activities schedule by enrollment
      • Create a new enrollment for a member
      • Delete enrollment
      • Get enrollment details for a member
      • Get activity sessions for a member
    • Appointments
      • Get activities
      • Retrieves detailed information about scheduled appointment sessions
      • Get blocked appointments
      • Get available activities for appointment
      • Get the available times for appointment
      • Change status of a member in a appointment
      • Enroll member in activity appointment
    • BankAccounts
      • Get bank accounts
    • Carts
      • Get cart by idCartToken
      • Get cart by idMember or idProspect
      • Add new cart
      • Forfeit cart
    • Configuration
      • Get branch configurations
      • Get gateway configurations
      • Get gateway form token
      • Get card flag
      • Get card translation
      • Get occupation
    • Employees
      • Get employees
      • Add employees
      • Update employees
      • Delete employees
      • Retrieves employee permissions.
    • Entries
      • Get entries
    • Invoices
      • Get invoices by date
    • Management
      • Get non-renewed clients
      • Get prospects
      • Get active clients
    • MemberMembership
      • Get summary of MemberMemberships (active, canceled, or specific types).
      • Get summary of MemberMemberships by id
      • Cancel MemberMembership
      • Revert scheduled membership cancellation.
    • Members
      • Get member profile
      • Get members
      • Retrieves active members from a specific branch or from all branches
      • Get member services
      • Get member credit cards
      • Update a member card number
      • Authenticate member
      • Get link for reset password
      • Update a member fitcoins
      • Get member fitcoins
      • Get basic member information.
      • Get member's latest branch transfer
      • Update basic member data
      • Transfers a member from one branch to another
      • Block/unblock member
      • Send push notification to a specific member
      • Send push notification to multiple members
    • Membership
      • Get memberships
      • Get memberships categories
    • Notifications
      • Insert a member notification
      • Insert a prospect notification
    • Parking
      • Validates parking access authorization by CPF (`document`) or by `idMember` for a specific branch.
    • Partnership
      • Get partnerships
    • Payables
      • Get payables
      • Get cost center
    • Pix
      • Get qr-code
    • Product
      • Get products
    • Prospects
      • Get prospects
      • Add prospects
      • Update prospect
      • Get prospect services
      • Transfers a prospect from one branch to another
      • Get prospect's latest branch transfer
      • Get interests list
      • Turn the opportunity into a member, returns the idMember created.
    • Receivables
      • Gets a list of debts and current status (Similar to the Collections - Default report)
      • Creates batch collection attempts for the member membership contracts.
      • Gets the details of a specific charge batch.
      • Get receivables
      • Marks a list of receivables as received (paid)
      • Reverses a list of received (paid) receivables back to open status
      • Get cost center
      • Get receivables conciliation report
      • Charge a receivable using a member's credit card
    • Sales
      • Get sale by Id
      • Get sales
      • Create a new sale
      • Get sales bySessionId
      • Return itens for sale -> site/totem
    • Service
      • Get services
    • States
      • Get all states for the current user's country
    • Voucher
      • Get vouchers
      • Get all vouchers code by voucher id
      • Creates a new voucher
      • Validate the voucher
    • Webhook
      • Add new webhook
      • Remove a specific webhook by id
      • List all webhooks created
      • List all webhooks created
    • Workout
      • Change data from a client's prescribed workout
      • Get all Exercises
      • Get all default workouts of the new prescription
      • Get all client's or prospect's or employee's workouts of the new prescription
      • Get all client's or prospect's or employee's workouts of the new prescription by month, year or idProfessor
      • Link workout of the new prescription for client
      • Create a workout of the new prescription
  • Schemas
    • Schemas
      • ClientesAtivosViewModel
      • ContratoNaoRenovadosViewModel
      • SpsRelProspectsCadastradosConvertidos
    • ActiveMembersReturnViewModel
    • ActivityAreaViewModel
    • ActivityEmployeesViewModel
    • ActivityGroupApiViewModel
    • ActivityGroupViewModel
    • ActivityResourcesViewModel
    • ActivityUnavailability
    • AreaBloqueioAgendaApiViewModel
    • AtividadeAgendaApiCustomViewModel
    • AtividadeAgendaApiViewModel
    • AtividadeAgendaListApiViewModel
    • AtividadeBasicoApiViewModel
    • AtividadeEnrollScheduleApiV2ViewModel
    • AtividadeListApiViewModel
    • AddressFamily
    • AtividadeLugarReservaApiViewModel
    • AtividadeLugarReservaViewModel
    • AtividadeSessaoAgendaViewModel
    • AtividadeSessaoParticipanteApiViewModel
    • AsnEncodedData
    • BairroViewModel
    • BandeirasBasicoViewModel
    • Assembly
    • BankAccountsViewModel
    • BasicFreezeViewModel
    • AsymmetricAlgorithm
    • BasicMemberMembershipApiViewModel
    • BloqueioAgendaApiViewModel
    • BonusSessionViewModel
    • BranchGatewayViewModel
    • BusinessHoursViewModel
    • CardDataViewModel
    • CardTranslationViewModel
    • CartIdViewModel
    • CartItemsViewModel
    • CartViewModel
    • ChargeReceivableRequestViewModel
    • ChargeReceivableResponseViewModel
    • CidadeViewModel
    • CityViewModel
    • ClienteDetalhesBasicosApiViewModel
    • ClienteEnotasRetorno
    • ClienteTransferenciaViewModel
    • CofinsEnotasRetorno
    • ColaboradoresBloqueioAgendaApiViewModel
    • ClientesAtivosRetornoViewModel
    • ConfiguracaoApiViewModel
    • ConjugadoItemRequestApiViewModel
    • ContratoEntradasApiViewModel
    • ByteReadOnlyMemory
    • ContratoFiliaisResumoApiViewModel
    • ContratosCanceladosParcelasApiViewModel
    • ByteReadOnlySpan
    • ContratosCanceladosResumoApiViewModel
    • ContratosResumoApiViewModel
    • CallingConventions
    • ContratosResumoPaginaVendaViewModel
    • ConveniosApiViewModel
    • CancellationToken
    • CostCenterApiViewModel
    • DadosContratoTrasnferenciaApiViewModel
    • DadosTrocaContratoApiViewModel
    • DebtorChargesViewModel
    • DebtorsItensViewModel
    • DefaultResponseViewModel
    • DiferenciaisApiViewModel
    • DifferentialsViewModel
    • DropsetItemRequestApiViewModel
    • EFormaContato
    • Claim
    • EFormaPagamentoTotem
    • EOrigemAgendamento
    • ClaimsIdentity
    • EStatusAtividade
    • EStatusAtividadeSessao
    • ClaimsPrincipal
    • ESubStatus
    • ESubStatusApi
    • ETemperatura
    • ETipoContrato
    • ETipoDocumento
    • ETipoGateway
    • EmployeeApiBranchPermissions
    • EmployeeApiIntegracaoAtualizacaoViewModel
    • EmployeeApiIntegracaoViewModel
    • EmpresasConveniosApiViewModel
    • ConnectionInfo
    • EmpresasFiliaisOcupacaoViewModel
    • EnderecoEnotasRetorno
    • ConstructorInfo
    • EnotasRetorno
    • EntradasResumoApiViewModel
    • ExperimentalClassResponseViewModel
    • FitcoinsResponseViewModel
    • FreezeViewModel
    • FreteEnotasRetorno
    • FuncionariosResumoApiViewModel
    • HttpResponseError
    • IcmsEnotasRetorno
    • IdMemberResponseViewModel
    • EmpresasFiliaisGatewayViewModel
    • ImpostosEnotasRetorno
    • InformacoesIndicadosViewModel
    • InstallmentViewModel
    • ItenEnotasRetorno
    • CustomAttributeData
    • ItensBloqueioAgendaApiViewModel
    • LiberacaoCatracaManualViewModel
    • CustomAttributeNamedArgument
    • LogTefApiViewModel
    • MatriculaDetalhesApiV2ViewModel
    • CustomAttributeTypedArgument
    • MatriculaDetalhesApiViewModel
    • EstadoViewModel
    • MatricularApiViewModel
    • MatricularConfiguracaoApiViewModel
    • MemberAuthenticateViewModel
    • MemberBasicResponsibleViewModel
    • MemberBlockUnblockViewModel
    • MemberCreditCardApiViewModel
    • MemberDataViewModel
    • MemberLevelViewModel
    • MemberMembershipApiViewModel
    • MemberNewSaleViewModel
    • MemberParkingViewModel
    • MemberResponsibleViewModel
    • MemberScheduleApiV2ViewModel
    • MemberServiceViewModel
    • MemberTransferViewModel
    • MembersApiResumidoVendaViewModel
    • MembersApiViewModel
    • MembersBasicApiViewModel
    • MetadadosEnotasRetorno
    • MobilePushMultiplaViewModel
    • MobilePushViewModel
    • MonthDiscountViewModel
    • NeighborhoodViewModel
    • NewSaleViewModel
    • NotificationApiViewModel
    • NotificationProspectApiViewModel
    • NotificationResponseViewModel
    • NovoVoucherViewModel
    • PagamentoEnotasRetorno
    • PayablesApiSubTypesViewModel
    • PayablesApiViewModel
    • PedidoEnotasRetorno
    • PercentualAproximadoTributosEnotasRetorno
    • PeriodizacaoApiViewModel
    • EventAttributes
    • PisEnotasRetorno
    • PixPaymentDetailsViewModel
    • EventInfo
    • PrescricaoTreinoViewModel
    • ProblemDetails
    • ProdutoResumoApiViewModel
    • FieldAttributes
    • ProgressivoItemRequestApiViewModel
    • ProspectApiIntegracaoAtualizacaoViewModel
    • FieldInfo
    • ProspectApiIntegracaoViewModel
    • ProspectIdViewModel
    • ProspectResponsavelFinanceiroViewmodel
    • ProspectTransferViewModel
    • ProspectTransferenciaViewModel
    • ProspectsResumoApiViewModel
    • GenericParameterAttributes
    • ProtocoloEnotasRetorno
    • PublicoAtividadeViewModel
    • HostString
    • ReceivablesApiResumoVendaViewModel
    • ReceivablesApiSubTypesViewModel
    • HttpContext
    • ReceivablesApiViewModel
    • ReceivablesApiViewModelListGridComQtdeViewModel
    • HttpRequest
    • ReceivablesCreditDetails
    • ReceivablesInvoiceApiViewModel
    • HttpResponse
    • ReceivablesMaskReceivedViewModel
    • RecursosBloqueioAgendaApiViewModel
    • RetornoCatracaViewModel
    • ICustomAttributeProvider
    • RetornoEntradaManualViewModel
    • RevenueCenterApiViewModel
    • IIdentity
    • ReverseReceivedResponseViewModel
    • ReverseReceivedViewModel
    • IPAddress
    • SaleItensViewModel
    • SalesItemViewModel
    • SalesItemsViewModel
    • IResponseCookies
    • SalesViewModelV2
    • SerieItemRequestApiViewModel
    • IServiceProvider
    • SeriePrescricaoRequestApiViewModel
    • ServiceDiscountViewModel
    • ISession
    • ServicoAdicionalApiViewModel
    • ServicoAnualApiViewModel
    • ServicoEnotasRetorno
    • ServicosResumoApiViewModel
    • SimplificadoEnotasRetorno
    • SpsProspectsServicosInteresses
    • StateViewModel
    • SumaryDebtorsViewModel
    • IntPtr
    • TaxDataViewModel
    • TelefoneApiViewModel
    • TransferClientResponseViewModel
    • TransporteEnotasRetorno
    • KeySizes
    • TreinoPrescricaoRequestApiViewModel
    • UnavailableSpotsResponseViewModel
    • LayoutKind
    • VendasResumoApiViewModel
    • VoucherAtributePublicViewModel
    • VoucherCriacaoViewModel
    • VoucherItemApiViewModel
    • VouchersCodigosViewModel
    • SalesViewModel
    • VouchersCodigosViewModelListWithQuantityViewModel
    • VouchersResumoApiViewModel
    • W12UtilsCategoryMembershipViewModel
    • W12UtilsWebhookHeaderViewModel
    • W12UtilsWebhookViewModel
    • W12UtilzWebHookFilterViewModel
    • YearDiscountViewModel
    • autorizaEntradaExternoViewModel
    • retornoAutorizaEntradaExternoViewModel
    • MemberInfo
    • MemberTypes
    • MethodAttributes
    • MethodBase
    • TimeSpan
    • MethodImplAttributes
    • MethodInfo
    • Module
    • ModuleHandle
    • Oid
    • ParameterAttributes
    • ParameterInfo
    • PathString
    • PipeReader
    • PipeWriter
    • PropertyAttributes
    • PropertyInfo
    • PublicKey
    • QueryString
    • RuntimeFieldHandle
    • RuntimeMethodHandle
    • RuntimeTypeHandle
    • SafeWaitHandle
    • SecurityRuleSet
    • Stream
    • StringStringKeyValuePair
    • StringStringValuesKeyValuePair
    • StructLayoutAttribute
    • Type
    • TypeAttributes
    • TypeInfo
    • TypeObjectKeyValuePair
    • WaitHandle
    • WebSocketManager
    • X500DistinguishedName
    • X509Certificate2
    • X509Extension
  1. Casos de uso

Exportar llamadas a Excel

Visión General#

Debido a la necesidad de algunos clientes de exportar datos masivos del EVO, en ocasiones datos de todas las unidades, se ofrece la posibilidad de descargar archivos XLS o CSV directamente desde el navegador.
La mayor cantidad de información posible se incluye en el archivo para que pueda utilizarse de la forma más adecuada según las necesidades de su negocio o sistema.

Cómo funciona#

Para descargar el archivo con los datos deseados, simplemente copie una de las URLs indicadas, péguela en su navegador — Chrome es el más recomendado —, modifique los parámetros cuando sea necesario y presione ENTER para iniciar el proceso.
El navegador solicitará una autenticación. En ese momento deberá ingresar el DNS y la clave secreta que se encuentran en su EVO, en
Configuraciones - Integraciones – Card EVO.
Si desea acceder a los datos de todas las unidades al mismo tiempo, utilice la clave disponible en el módulo de Administración General.
Una vez realizada la autenticación, el navegador guardará estos datos y no volverá a solicitarlos en las próximas consultas.
Si utiliza un computador compartido para descargar los archivos, recomendamos usar una ventana anónima. De esta forma, el navegador no almacenará la autenticación.
Después de esto, el archivo comenzará a descargarse automáticamente.

Datos de Clientes#

https://evo-integracao.w12app.com.br/api/v1/members/summary-excel
Para este archivo no es necesario informar ningún parámetro.
La API siempre devolverá todos los clientes activos, suspendidos y con contratos especiales en el momento de la consulta.

Ingresos (Recebimientos)#

https://evo-integracao.w12app.com.br/api/v1/receivables/summary-excel?dtRecebimentoDe=AAAA-MM-DD&dtRecebimentoAte=AAAA-MM-DD
Para este archivo es necesario informar al menos un parámetro de fecha.
El ejemplo anterior utiliza la fecha de recepción, pero también es posible consultar usando otros tipos de fechas y filtrar por tipo de recepción.
Los parámetros se agregan en la URL después del símbolo ?.
Es posible incluir múltiples parámetros, separados por &.
Para filtrar por un tipo de fecha, siempre deben utilizarse los parámetros De y Ate, con el formato AAAA-MM-DD.
Ejemplo: consultar todos los ingresos con vencimiento en febrero de 2024: ?dtVencimentoDe=2024-02-01&dtVencimentoAte=2024-02-30.
La URL completa quedaría así: https://evo-integracao.w12app.com.br/api/v1/receivables/summary-excel?dtRecebimentoDe=2025-01-01&dtRecebimentoAte=2025-01-05

Parámetros#

Fecha de registro: dtLancamentoDe / dtLancamentoAte
Fecha de vencimiento: dtVencimentoDe / dtVencimentoAte
Fecha de recepción: dtRecebimentoDe / dtRecebimentoAte
Fecha de venta: dtVendaDe / dtVendaAte
Tipo de recepción: idTipoRecebimento

Tipos de recepción#

Dinero = 1
Tarjeta de crédito = 2
Tarjeta de débito = 3
Cheque = 4
Boleto = 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
Ejemplo con todos los parámetros:
https://evo-integracao.w12app.com.br/api/v1/receivables/summaryexcel?idTipoRecebimento=1&dtLancamentoDe=2024-02-01&dtLancamentoAte=2024-02-31&dtVencimentoDe=2024-02-01&dtVencimentoAte=2024-04-31&dtRecebimentoDe=2021-01-01&dtRecebimentoAte=2021-01-31&dtVendaDe=2021-01-31&dtVendaAte=2021=01-31

Cobros (XLS)#

https://evo-integracao.w12app.com.br/api/v1/receivables/receivables-charged-excel?idFilial=N&data=AAAA-MM-DD&dataAte=AAAA-MM-DD
Para este archivo es necesario informar el período de consulta por fecha de cobro.
El archivo devolverá datos de los ingresos divididos por centros de ingresos, incluyendo detalles sobre ítems de venta y facturas relacionadas.

Parámetros#

Fecha: data / dataAte
idFilial: número de la sucursal
Si utiliza un token de Administración General, podrá filtrar por unidad o dejar el parámetro idFilial = 0.

Facturas (XLS) (BR)#

https://evo-integracao.w12app.com.br/api/v1/invoices?dtEnvioInicio=DD-MM-AAAA&dtEnvioFim=DD-MM-AAAA&dtEmissaoInicio=DD-MM-AAAA&dtEmissaoFim=DD-MM-AAAA&status=0&idFilial=0
Para este archivo es necesario informar el período de consulta por fecha de envío o emisión.
No es obligatorio informar ambos.
El parámetro status puede utilizarse para filtrar resultados.
Para obtener todas las facturas enviadas con cualquier estado, utilice 0.

Estados#

0 = todos los resultados
1 = esperando envío
2 = esperando respuesta
3 = cancelada
4 = error
Las fechas pueden utilizarse en formato:
AAAA-MM-DD
DD-MM-AAAA
Si utiliza un token de Administración General, puede filtrar por sucursal o dejar idFilial = 0.

Facturas (CSV) (BR)#

https://evo-integracao.w12app.com.br/api/v1/invoices/CSV?dtEmissaoInicio=AAAA-MM-DD&dtEmissaoFim=AAAA-MM-DD
Este enlace permite descargar un archivo CSV con todas las facturas emitidas en un período determinado.
Los parámetros definen el período de emisión: dtEmissaoInicio=AAAA-MM-DD dtEmissaoFim=AAAA-MM-DD
Para obtener datos de una sucursal específica, autentíquese con el token de esa sucursal.
Para obtener datos de todas las unidades o de un grupo de sucursales, utilice el token generado en Administración General.

Entradas de Clientes#

https://evo-integracao.w12app.com.br/api/v1/entries/all-excel?monthStart=MM&monthEnd=MM&year=AAAA&dailyPass=true&dailyPrint=false
Este enlace permite descargar un archivo XLS con información sobre las entradas de los clientes.
Puede consultarse utilizando la clave de acceso de una unidad específica o la de Administración General, obteniendo los datos de todas las unidades.
El reporte contiene tres pestañas:
Reporte completo: muestra todos los clientes con acceso en el período, indicando unidad de origen, unidad de acceso y cantidad de accesos.
Entradas en otra sucursal: misma estructura, pero muestra solo clientes que accedieron a una sucursal distinta a la de origen.
Entradas con fecha: muestra todas las entradas con la fecha en que ocurrieron. Considera solo una entrada por día.

Parámetros#

Período de entrada
monthStart=MM
monthEnd=MM
year=AAAA
No es obligatorio. Si no se informa, el reporte traerá los datos del mes anterior a la consulta.
Entradas de agregadores (Gympass, Totalpass, Classpass)
dailyPass=true → solo entradas de agregadores
dailyPass=false → no incluir agregadores
No es obligatorio. Si no se informa, no se incluirán entradas de agregadores.
Entradas por impresión de entrenamiento
dailyPrint=false → excluye entradas generadas al imprimir entrenamientos
No es obligatorio. Si no se informa, estas entradas serán consideradas en el reporte.
Modificado en 2026-05-15 03:33:02
Anterior
Agendamiento de una clase experimental
Siguiente
Conciliación de pagos bancarios
Built with