EVO API EN
Home
GuidesAPIs💎 API Pro📢 News
Home
GuidesAPIs💎 API Pro📢 News
  1. Sales
  • Welcome 💜
  • 📃 Guias
    • Primeiros passos com a API
      • Começando a usar a EVO API
      • Permissões do token
      • Limites de requisições
      • API Pro
    • Conhecendo a documentação
      • Utilizar a documentação de forma eficaz
      • Novidades
    • Casos de uso
      • Realizar venda online via API
      • Integração EVO Pay
      • Como usar o webhook
      • Agendamento de aula experimental
      • Chamadas de exportação para Excel
      • Conciliação de pagamentos via banco
      • Emissão de Nota Fiscal
      • Controle de acesso de aluno via serviço externo
      • Integrar landing page
    • FAQ
      • Gestão de clientes e relacionamentos
      • Operações e atividades
      • Financeiro
      • Configurações e integrações
    • Sugestões
      • Sugestão de implementação
  • 🌐 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
      • 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
      • 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.
      • Validates parking access authorization and information by CPF (`document`)
    • 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
      • Get sales
        GET
      • Create a new sale
        POST
      • Get sales bySessionId
        GET
      • Return itens for sale -> site/totem
        GET
    • 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
    • ActivityGroupApiViewModel
    • ActivityAreaViewModel
    • ActiveMembersReturnViewModel
    • AtividadeAgendaApiViewModel
    • ActivityEmployeesViewModel
    • ActivityGroupViewModel
    • AtividadeBasicoApiViewModel
    • AtividadeAgendaApiCustomViewModel
    • ActivityResourcesViewModel
    • AtividadeListApiViewModel
    • ActivityUnavailability
    • AddressFamily
    • AtividadeLugarReservaApiViewModel
    • AreaBloqueioAgendaApiViewModel
    • AtividadeLugarReservaViewModel
    • AsnEncodedData
    • AtividadeSessaoParticipanteApiViewModel
    • AtividadeAgendaListApiViewModel
    • BairroViewModel
    • Assembly
    • AsymmetricAlgorithm
    • BandeirasBasicoViewModel
    • BankAccountsViewModel
    • BasicFreezeViewModel
    • AtividadeEnrollScheduleApiV2ViewModel
    • BasicMemberMembershipApiViewModel
    • AtividadeSessaoAgendaViewModel
    • BonusSessionViewModel
    • BusinessHoursViewModel
    • CardDataViewModel
    • CardTranslationViewModel
    • CartIdViewModel
    • CartItemsViewModel
    • CartViewModel
    • CidadeViewModel
    • BloqueioAgendaApiViewModel
    • ClienteDetalhesBasicosApiViewModel
    • ClienteEnotasRetorno
    • BranchGatewayViewModel
    • ClienteTransferenciaViewModel
    • ClientesAtivosRetornoViewModel
    • CofinsEnotasRetorno
    • ByteReadOnlyMemory
    • ConfiguracaoApiViewModel
    • ByteReadOnlySpan
    • ContratoEntradasApiViewModel
    • CallingConventions
    • ContratoFiliaisResumoApiViewModel
    • CityViewModel
    • CancellationToken
    • ChargeReceivableRequestViewModel
    • ContratosCanceladosParcelasApiViewModel
    • ChargeReceivableResponseViewModel
    • ContratosCanceladosResumoApiViewModel
    • ContratosResumoApiViewModel
    • ContratosResumoPaginaVendaViewModel
    • ColaboradoresBloqueioAgendaApiViewModel
    • ConveniosApiViewModel
    • CostCenterApiViewModel
    • ConjugadoItemRequestApiViewModel
    • Claim
    • DadosContratoTrasnferenciaApiViewModel
    • ClaimsIdentity
    • DadosTrocaContratoApiViewModel
    • ClaimsPrincipal
    • DebtorChargesViewModel
    • DebtorsItensViewModel
    • DefaultResponseViewModel
    • DiferenciaisApiViewModel
    • DifferentialsViewModel
    • EFormaContato
    • EFormaPagamentoTotem
    • EOrigemAgendamento
    • EStatusAtividade
    • ConnectionInfo
    • EStatusAtividadeSessao
    • ConstructorInfo
    • ETemperatura
    • ETipoContrato
    • ETipoDocumento
    • ETipoGateway
    • DropsetItemRequestApiViewModel
    • EmployeeApiIntegracaoAtualizacaoViewModel
    • EmployeeApiBranchPermissions
    • EmployeeApiIntegracaoViewModel
    • EmpresasConveniosApiViewModel
    • ESubStatus
    • EmpresasFiliaisGatewayViewModel
    • EmpresasFiliaisOcupacaoViewModel
    • ESubStatusApi
    • CustomAttributeData
    • EnderecoEnotasRetorno
    • CustomAttributeNamedArgument
    • EnotasRetorno
    • CustomAttributeTypedArgument
    • EntradasResumoApiViewModel
    • EstadoViewModel
    • ExperimentalClassResponseViewModel
    • FitcoinsResponseViewModel
    • FreezeViewModel
    • FreteEnotasRetorno
    • FuncionariosResumoApiViewModel
    • HttpResponseError
    • IcmsEnotasRetorno
    • ImpostosEnotasRetorno
    • InformacoesIndicadosViewModel
    • InstallmentViewModel
    • ItenEnotasRetorno
    • LiberacaoCatracaManualViewModel
    • LogTefApiViewModel
    • MemberAuthenticateViewModel
    • MemberBasicResponsibleViewModel
    • MemberBlockUnblockViewModel
    • MemberDataViewModel
    • MemberMembershipApiViewModel
    • MemberNewSaleViewModel
    • MemberResponsibleViewModel
    • IdMemberResponseViewModel
    • MemberServiceViewModel
    • MemberTransferViewModel
    • ItensBloqueioAgendaApiViewModel
    • MembersApiViewModel
    • MembersBasicApiViewModel
    • MetadadosEnotasRetorno
    • MonthDiscountViewModel
    • NewSaleViewModel
    • MatriculaDetalhesApiV2ViewModel
    • NotificationApiViewModel
    • MatricularApiViewModel
    • EventAttributes
    • NotificationProspectApiViewModel
    • MatricularConfiguracaoApiViewModel
    • EventInfo
    • NotificationResponseViewModel
    • NovoVoucherViewModel
    • FieldAttributes
    • PagamentoEnotasRetorno
    • FieldInfo
    • PayablesApiSubTypesViewModel
    • PayablesApiViewModel
    • PedidoEnotasRetorno
    • PercentualAproximadoTributosEnotasRetorno
    • MemberCreditCardApiViewModel
    • ReceivablesApiResumoVendaViewModel
    • PeriodizacaoApiViewModel
    • GenericParameterAttributes
    • PisEnotasRetorno
    • HostString
    • PixPaymentDetailsViewModel
    • HttpContext
    • PrescricaoTreinoViewModel
    • MembersApiResumidoVendaViewModel
    • MemberScheduleApiV2ViewModel
    • HttpRequest
    • ProblemDetails
    • HttpResponse
    • ProspectApiIntegracaoAtualizacaoViewModel
    • ProspectApiIntegracaoViewModel
    • ICustomAttributeProvider
    • ProspectIdViewModel
    • IIdentity
    • ProspectResponsavelFinanceiroViewmodel
    • IPAddress
    • ProspectTransferViewModel
    • NeighborhoodViewModel
    • IResponseCookies
    • ProspectTransferenciaViewModel
    • IServiceProvider
    • ProspectsResumoApiViewModel
    • ISession
    • ProtocoloEnotasRetorno
    • PublicoAtividadeViewModel
    • ReceivablesApiSubTypesViewModel
    • ReceivablesApiViewModel
    • ReceivablesApiViewModelListGridComQtdeViewModel
    • ReceivablesCreditDetails
    • IntPtr
    • ReceivablesInvoiceApiViewModel
    • VendasResumoApiViewModel
    • ProgressivoItemRequestApiViewModel
    • ReceivablesMaskReceivedViewModel
    • RetornoCatracaViewModel
    • KeySizes
    • RetornoEntradaManualViewModel
    • LayoutKind
    • RevenueCenterApiViewModel
    • SaleItensViewModel
    • SalesItemViewModel
    • SalesItemsViewModel
    • MatriculaDetalhesApiViewModel
    • SalesViewModel
    • ProdutoResumoApiViewModel
    • ServiceDiscountViewModel
    • ServicoAdicionalApiViewModel
    • ServicoAnualApiViewModel
    • ServicoEnotasRetorno
    • ServicosResumoApiViewModel
    • RecursosBloqueioAgendaApiViewModel
    • MemberInfo
    • SimplificadoEnotasRetorno
    • SpsProspectsServicosInteresses
    • MemberLevelViewModel
    • SumaryDebtorsViewModel
    • TaxDataViewModel
    • MemberParkingViewModel
    • TelefoneApiViewModel
    • TransferClientResponseViewModel
    • TransporteEnotasRetorno
    • MemberTypes
    • UnavailableSpotsResponseViewModel
    • VouchersResumoApiViewModel
    • W12UtilsCategoryMembershipViewModel
    • SerieItemRequestApiViewModel
    • W12UtilsWebhookHeaderViewModel
    • SeriePrescricaoRequestApiViewModel
    • MethodAttributes
    • W12UtilsWebhookViewModel
    • MethodBase
    • W12UtilzWebHookFilterViewModel
    • MethodImplAttributes
    • YearDiscountViewModel
    • TimeSpan
    • MethodInfo
    • autorizaEntradaExternoViewModel
    • ReverseReceivedResponseViewModel
    • retornoAutorizaEntradaExternoViewModel
    • MobilePushMultiplaViewModel
    • ReverseReceivedViewModel
    • MobilePushViewModel
    • Module
    • ModuleHandle
    • SalesViewModelV2
    • TreinoPrescricaoRequestApiViewModel
    • Oid
    • VoucherCriacaoViewModel
    • StateViewModel
    • ParameterAttributes
    • VouchersCodigosViewModel
    • ParameterInfo
    • VouchersCodigosViewModelListWithQuantityViewModel
    • PathString
    • PipeReader
    • VoucherAtributePublicViewModel
    • PipeWriter
    • VoucherItemApiViewModel
    • PropertyAttributes
    • PropertyInfo
    • PublicKey
    • QueryString
    • RuntimeFieldHandle
    • RuntimeMethodHandle
    • RuntimeTypeHandle
    • SafeWaitHandle
    • SecurityRuleSet
    • Stream
    • StringStringKeyValuePair
    • StringStringValuesKeyValuePair
    • StructLayoutAttribute
    • Type
    • TypeAttributes
    • TypeInfo
    • TypeObjectKeyValuePair
    • WaitHandle
    • WebSocketManager
    • X500DistinguishedName
    • X509Certificate2
    • X509Extension
  1. Sales

Return itens for sale -> site/totem

GET
https://evo-integracao-api.w12app.com.br/api/v1/sales/sales-items
🌐 API Reference/Sales

Obter itens que estão a venda#

Descrição#

Esse endpoint permite obter os itens que estão a venda.
🚧 OBS. São retornados itens que estiverem com o campo de "Autoatendimento" marcado dentro da página de vendas do EVO.

🔑 Parâmetros de Consulta#

Recomendamos informar o idBranch para que sejam filtrados os itens que estão a venda por unidade.

📤 Estrutura da Resposta#

CampoTipoDescrição
nameSalePagestringNome da página de vendas.
orderint32Ordem de exibição da página de vendas.
idEmployeeCommissionint32ID do funcionário responsável pela comissão de venda.
idBranchint32ID da filial associada à página de vendas.
idSaleItemint32Identificador do item de venda.
checkoutUrlstringURL de checkout para finalização da compra.
notInauguratedbooleanIndica se a filial ainda não foi inaugurada.
itensarrayLista de itens disponíveis para venda nesta página.

🧩 Estrutura de ìtens#

CampoTipoDescrição
idMembershipint32ID da matrícula associada ao item (quando aplicável).
membershipstringNome da matrícula.
loyaltyInstallmentbooleanIndica se o item possui parcelamento com fidelidade.
membershipTypeint32Tipo da matrícula.
loyaltyTimeint32Tempo de fidelidade associado à matrícula.
validityDescriptionstringDescrição da validade do plano.
reverseInstallmentsDescriptionstringDescrição do parcelamento reverso, quando aplicável.
valueDaysMonthsDefinedValidityint32Valor numérico referente à validade definida (dias ou meses).
serviceValuenumberValor do serviço.
serviceNamestringNome do serviço associado.
remarkstringObservações adicionais sobre o item.
membershipTextstringTexto descritivo da matrícula.
annuityServiceNamestringNome do serviço de anuidade.
annuityServiceValuenumberValor do serviço de anuidade.
annuityDayint32Dia de cobrança da anuidade.
annuityMonthint32Mês de cobrança da anuidade.
annuityChargeTypeint32Tipo de cobrança da anuidade.
annuityInstallmentsCountint32Quantidade de parcelas da anuidade.
promotionalDaysCountint32Quantidade de dias promocionais.
promoDayMonthTypeint32Tipo de unidade da promoção (dia/mês).
installmentsCountint32Quantidade total de parcelas disponíveis.
promotionalValueDescriptionstringDescrição do valor promocional.
annuityInstallmentsarrayLista de parcelas da anuidade.
idServiceint32ID do serviço associado ao item.
namestringNome do item exibido na venda.
flSpotlightbooleanIndica se o item está em destaque.
orderint32Ordem de exibição do item.
typeint32Tipo do item de venda.
chargeValuenumberValor de cobrança do item.
chargeValueDescriptionstringDescrição do valor de cobrança.
totalValuenumberValor total do item.
taxValuenumberValor de taxa aplicada.
percentageTypebooleanIndica se o valor é percentual.
flChargeServiceAutomaticRenewbooleanIndica se o serviço possui renovação automática.
flBankSlipbooleanIndica se o pagamento via boleto é permitido.
flCardbooleanIndica se o pagamento via cartão é permitido.
flCreditBalancebooleanIndica se o pagamento via saldo de crédito é permitido.
flRegisterRequiredAddressbooleanIndica se o endereço é obrigatório no cadastro.
flPrioritizeRegistrationSalebooleanIndica se a venda prioriza o cadastro antes da compra.
ageFromint32Idade mínima permitida para o item.
ageToint32Idade máxima permitida para o item.
differentialsarrayLista de diferenciais do item.
membershipBranchesarrayLista de IDs das filiais associadas à matrícula.
🧩 Estrutura de annuityInstallments#
CampoTipoDescrição
totalValuenumberValor total da parcela.
valuenumberValor individual da parcela.
datestring (date-time)Data de vencimento da parcela.
serviceNamestringNome do serviço relacionado à parcela.
serviceValuenumberValor do serviço relacionado.
loyaltyMonthlyPaymentDescriptionstringDescrição do pagamento mensal com fidelidade.
loyaltyMonthlyPaymentValueDescriptionstringDescrição do valor do pagamento mensal com fidelidade.
annuityServiceNamestringNome do serviço de anuidade.
annuityServiceValuenumberValor do serviço de anuidade.
🧩 Estrutura de differentials#
CampoTipoDescrição
titlestringTítulo do diferencial do item.
orderint32Ordem de exibição do diferencial.

Request

Authorization
Basic Auth
Send your HTTP requests with an
Authorization
header that contains the word Basic followed by a space and a base64-encoded string username:password
Example:
Authorization: Basic *****************
or
Query Params

Responses

🟢200OK
application/json
Success
Body

🟠400Bad Request
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://evo-integracao-api.w12app.com.br/api/v1/sales/sales-items?idBranch=undefined' \
--header 'Authorization: Basic <encoded-value>'
Response Response Example
200 - Example 1
[
    {
        "nameSalePage": "string",
        "order": 0,
        "idEmployeeCommission": 0,
        "idBranch": 0,
        "idSaleItem": 0,
        "checkoutUrl": "string",
        "notInaugurated": true,
        "itens": [
            {
                "promotionalValueCompleteDescription": "string",
                "promotionalValueCompleteDescriptionDay": "string",
                "completeValidityDescription": "string",
                "membershipLoyaltyDescription": "string",
                "validityMonthsAmount": 0,
                "installmentsDescription": "string",
                "installmentsLoyaltyDescription": "string",
                "firstInstallments": [
                    {
                        "totalValue": 0,
                        "value": 0,
                        "date": "2019-08-24T14:15:22.123Z",
                        "serviceName": "string",
                        "serviceValue": 0,
                        "loyaltyMonthlyPaymentDescription": "string",
                        "loyaltyMonthlyPaymentValueDescription": "string",
                        "annuityServiceName": "string",
                        "annuityServiceValue": 0
                    }
                ],
                "paymentDescription": "string",
                "cardInstallments": [
                    "string"
                ],
                "nextInstallment": 0,
                "annuityDate": "2019-08-24T14:15:22.123Z",
                "sessionsCountDescription": "string",
                "recurrency": true,
                "calculatedValue": 0,
                "valueDescription": "string",
                "valueTextDescription": "string",
                "valueWithoutCentsDescription": "string",
                "valueCentsDescription": "string",
                "textMonthDescription": "string",
                "promotionalValueDayDescription": "string",
                "nextChargeDate": "2019-08-24T14:15:22.123Z",
                "idMembership": 0,
                "membership": "string",
                "loyaltyInstallment": true,
                "membershipType": 1,
                "loyaltyTime": 0,
                "validityDescription": "string",
                "reverseInstallmentsDescription": "string",
                "valueDaysMonthsDefinedValidity": 0,
                "serviceValue": 0,
                "serviceName": "string",
                "remark": "string",
                "membershipText": "string",
                "annuityServiceName": "string",
                "annuityServiceValue": 0,
                "annuityDay": 0,
                "annuityMonth": 0,
                "annuityChargeType": 0,
                "annuityInstallmentsCount": 0,
                "promotionalDaysCount": 0,
                "promoDayMonthType": 0,
                "installmentsCount": 0,
                "promotionalValueDescription": "string",
                "annuityInstallments": [
                    {
                        "totalValue": 0,
                        "value": 0,
                        "date": "2019-08-24T14:15:22.123Z",
                        "serviceName": "string",
                        "serviceValue": 0,
                        "loyaltyMonthlyPaymentDescription": "string",
                        "loyaltyMonthlyPaymentValueDescription": "string",
                        "annuityServiceName": "string",
                        "annuityServiceValue": 0
                    }
                ],
                "idService": 0,
                "name": "string",
                "flSpotlight": true,
                "order": 0,
                "type": 0,
                "chargeValue": 0,
                "chargeValueDescription": "string",
                "totalValue": 0,
                "taxValue": 0,
                "percentageType": true,
                "flChargeServiceAutomaticRenew": true,
                "flBankSlip": true,
                "flCard": true,
                "flCreditBalance": true,
                "flRegisterRequiredAddress": true,
                "flPrioritizeRegistrationSale": true,
                "ageFrom": 0,
                "ageTo": 0,
                "differentials": [
                    {
                        "title": "string",
                        "order": 0
                    }
                ],
                "membershipBranches": [
                    0
                ]
            }
        ]
    }
]
Modified at 2026-05-15 04:38:45
Previous
Get sales bySessionId
Next
Get services
Built with