EVO API ES
Inicio
GuíasAPIs💎 API Pro📢 Novedades
Inicio
GuíasAPIs💎 API Pro📢 Novedades
  1. Receivables
  • ¡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)
        GET
      • Creates batch collection attempts for the member membership contracts.
        POST
      • Gets the details of a specific charge batch.
        GET
      • Get receivables
        GET
      • Marks a list of receivables as received (paid)
        PUT
      • Reverses a list of received (paid) receivables back to open status
        POST
      • Get cost center
        GET
      • Get receivables conciliation report
        GET
      • Charge a receivable using a member's credit card
        POST
    • 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. Receivables

Gets a list of debts and current status (Similar to the Collections - Default report)

GET
https://evo-integracao-api.w12app.com.br/api/v1/receivables/debtors
🌐 API Reference/Receivables

Obtener Historial de Deudas#

Descripción#

Devuelve una lista de deudas y su estado actual, de manera similar al informe de Cobranza - Morosidad. Permite filtrar por fechas de vencimiento, registro, pago, miembros específicos, sucursal, estado del miembro y estado de la deuda. Los resultados pueden paginarse y acompañarse de un resumen financiero con totales y promedios.

🔑 Parámetros de Consulta (Query Params)#

ParámetroTipoObligatorioDescripción
dueDateStartstring (date-time)NoFiltrar por fecha de vencimiento a partir de una fecha inicial (formato yyyy-mm-dd).
dueDateEndstring (date-time)NoFiltrar por fecha de vencimiento hasta una fecha final (formato yyyy-mm-dd).
registrationDateStartstring (date-time)NoFiltrar por fecha de registro a partir de una fecha inicial (formato yyyy-mm-dd).
registrationDateEndstring (date-time)NoFiltrar por fecha de registro hasta una fecha final (formato yyyy-mm-dd).
paymentDateStartstring (date-time)NoFiltrar por fecha de pago a partir de una fecha inicial (formato yyyy-mm-dd).
paymentDateEndstring (date-time)NoFiltrar por fecha de pago hasta una fecha final (formato yyyy-mm-dd).
membersIdsstringNoLista de IDs de miembros separados por comas.
takeint32NoCantidad de registros a devolver (máximo 50). Valor por defecto: 50.
skipint32NoCantidad de registros a omitir (paginación). Valor por defecto: 0.
idBranchint32NoFiltrar por ID de la sucursal (solo para claves multilocal y cuando membersIds no está vacío).
memberStatusstringNoFiltrar por estado del miembro. Valores posibles: 1 = Activo, 2 = Inactivo. Se pueden indicar varios valores separados por coma (ej.: 1,2).
debtStatusstringNoFiltrar por estado de la deuda. Valores posibles: 1 = Abierta, 2 = Recuperada, 3 = Cancelada. Se pueden indicar varios valores separados por coma (ej.: 1,2).

📤 Estructura de la Respuesta#

Devuelve una lista paginada de deudas con información del miembro, valores, fechas y estado, además de un resumen con totales y promedios.
CampoTipoDescripción
resultsarray<objeto>Lista de deudas encontradas.
totalint32Cantidad total de registros encontrados.
summaryobjetoResumen con valores totales y promedios de cobranza.

🧩 Estructura del Objeto results#

CampoTipoDescripción
memberIdint32ID del miembro asociado a la deuda.
namestringNombre del miembro.
memberStatusstringEstado del miembro (Activo/Inactivo).
receivableIdint32ID de la cuenta por cobrar.
receivableIdOriginint32ID de origen de la cuenta por cobrar.
branchIdint32ID de la sucursal asociada a la deuda.
branchNamestringNombre de la sucursal asociada a la deuda.
dueDatestring (date-time)Fecha de vencimiento de la deuda.
paymentDatestring (date-time)Fecha de pago de la deuda (si aplica).
registerDatestring (date-time)Fecha de registro de la deuda.
originalDueDatestring (date-time)Fecha de vencimiento original de la deuda.
chargeDatestring (date-time)Fecha de cobro.
daysLateint32Número de días de atraso.
debtAmountnumberValor de la deuda.
paymentTypestringTipo de pago utilizado (ej.: tarjeta, boleto).
idPaymentTypeint32ID del tipo de pago.
debtStatusstringEstado de la deuda (Abierta, Recuperada, Cancelada).
checkoutLinkstringEnlace para pago parcial de la deuda.
checkoutLinkFullDebtstringEnlace para pago total de la deuda.
paymentOriginstringOrigen del pago.
idMemberMembershipint32Identificador del contrato del alumno.
chargeAttemptsCountint32Cantidad de intentos de cobro.
lastAcquirerDeclineReasonstringÚltimo motivo de rechazo por el adquirente.

🧩 Estructura del Objeto summary#

CampoTipoDescripción
recoveredValuenumberValor total recuperado.
recoveryAveragenumberValor promedio recuperado por cobro.
pendingValuenumberValor total pendiente.
pendingAveragenumberValor promedio pendiente por cobro.

Solicitud

Autorización
or
Parámetros de consulta

Respuestas

🟢200OK
application/json
Success
Body

🟠400Bad Request
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location 'https://evo-integracao-api.w12app.com.br/api/v1/receivables/debtors?dueDateStart=undefined&dueDateEnd=undefined&registrationDateStart=undefined&registrationDateEnd=undefined&paymentDateStart=undefined&paymentDateEnd=undefined&membersIds=undefined&take=undefined&skip=undefined&idBranch=undefined&memberStatus=undefined&debtStatus=undefined'
Respuesta Ejemplo de Respuesta
200 - Ejemplo 1
{
    "results": [
        {
            "memberId": 0,
            "name": "string",
            "memberStatus": "string",
            "receivableId": 0,
            "receivableIdOrigin": 0,
            "branchId": 0,
            "branchName": "string",
            "dueDate": "2019-08-24T14:15:22.123Z",
            "paymentDate": "2019-08-24T14:15:22.123Z",
            "registerDate": "2019-08-24T14:15:22.123Z",
            "originalDueDate": "2019-08-24T14:15:22.123Z",
            "chargeDate": "2019-08-24T14:15:22.123Z",
            "daysLate": 0,
            "debtAmount": 0,
            "paymentType": "string",
            "idPaymentType": 0,
            "debtStatus": "string",
            "checkoutLink": "string",
            "checkoutLinkFullDebt": "string",
            "paymentOrigin": "string",
            "idMemberMembership": 0,
            "chargeAttemptsCount": 0,
            "lastAcquirerDeclineReason": "string"
        }
    ],
    "total": 0,
    "summary": {
        "recoveredValue": 0,
        "recoveryAverage": 0,
        "pendingValue": 0,
        "pendingAverage": 0
    }
}
Modificado en 2026-05-15 13:34:34
Anterior
Receivables
Siguiente
Creates batch collection attempts for the member membership contracts.
Built with