1. Parceiros
Docs Unnotech
  • Visão geral da API
  • Guia: Originação FGTS
  • Guia: Originação CLT
  • Guia: Quota diária
  • Changelog e avisos de mudança
  • Autenticação
    • Gera um access_token
      POST
  • Originação
    • FGTS
      • Busca applications pelo id externo do consumidor
      • Cria uma solicitação (application) e dispara a cotação
      • Status enxuto da application (para polling)
      • Detalha uma application pelo id
      • Re-cota uma application (ofertas antigas invalidadas)
      • Lê o KYC (pré-preenchido quando disponível na plataforma)
      • Submete o KYC (cadastro completo) exigido antes do aceite
      • Aceita uma oferta e inicia a contratação
    • CLT
      • Busca solicitações pelo id externo do consumidor
      • Cria uma solicitação (application) de consignado CLT
      • Status enxuto da solicitação (para polling)
      • Detalha uma solicitação pelo id
      • Consulta o consentimento do trabalhador
      • Força uma nova verificação do consentimento
      • Consulta a margem consignável por vínculo
      • Simula e monta o menu de ofertas
      • Completa o cadastro do cliente
      • Lê o KYC (pré-preenchido quando disponível)
      • Submete o KYC exigido antes do aceite
      • Aceita uma oferta e inicia a contratação
  • Propostas
    • Lista propostas com filtros e paginação
      GET
    • Detalha uma proposta pelo UUID
      GET
  • Admin
    • Usuários
      • Lista usuários com filtros e paginação
      • Cadastra um novo usuário
      • Remove o usuário dos seus parceiros
      • Detalha um usuário pelo UUID
      • Atualiza um usuário (parcial) — e liga/desliga o acesso dele aos seus parceiros
    • Parceiros
      • Lista parceiros com filtros e paginação
        GET
      • Cadastra um novo parceiro
        POST
      • Detalha um parceiro pelo UUID
        GET
      • Remove um parceiro
        DELETE
      • Atualiza um parceiro (parcial)
        PATCH
      • Ativa ou inativa um usuário dentro do parceiro
        PUT
    • Grupos
      • Lista grupos disponíveis
  • Esquemas
    • CreateUserRequest
    • CreateUserResponse
    • UserDetail
    • Data
    • CreateUserResponseData
    • BankerizeErrorResponse
    • UserPartnerEntry
    • Address
    • BankAccount
    • CreatePartnerRequest
    • Partner
    • Pix
    • CreatePartnerResponse
    • CreatePartnerResponseData
    • Customer
    • ApiError
    • ApiErrorResponse
    • CreateFgtsApplicationRequest
    • ErrorDetail
    • FieldErrorCode
    • ApiErrorCode
    • ApplicationStatus
    • FgtsInstallment
    • FgtsQuote
    • OfferStatus
    • FgtsApplication
    • QuoteStatus
    • RejectionKind
    • FgtsOffer
    • RejectionReason
    • AcceptFgtsOfferRequest
    • AcceptFgtsOfferResponse
    • AccountType
    • CivilStatus
    • DisbursementMethod
    • FgtsKyc
    • FgtsKycAddress
    • FgtsKycBank
    • Gender
    • PixKeyType
    • TokenRequest
    • TokenResponse
    • CltCustomer
    • OAuth2ErrorResponse
    • AuthorizationStatus
    • Group
    • UserDetailResponse
    • CreateCltApplicationRequest
    • CltCustomerCompleteness
    • UpdatePartnerRequest
    • CltApplication
    • CltEmploymentAlert
    • CltAuthorization
    • CltInstallment
    • PartnerDetail
    • PartnerDetailResponse
    • PageInfo
    • CltEmployment
    • CltQuote
    • SortInfo
    • CltSimulation
    • CustomerField
    • CltIneligibilityReason
    • UsersPage
    • CltOffer
    • ProposalsPage
    • AcceptCltOfferRequest
    • PublicProposalListItem
    • PublicCustomerSummary
    • QuoteBasis
    • AcceptCltOfferResponse
    • PublicDisbursementAccount
    • CltSimulationRequest
    • OfferNotice
    • PublicLoanSummary
    • CltKycAddress
    • CltKycBank
    • PublicProposalDetailResponse
    • CltKyc
    • PartnerListItem
    • PartnersPage
    • ListOfGroupsResponse
    • CltKycEmployer
    • FgtsApplicationList
    • FgtsApplicationStatus
    • UpdateUserRequest
    • UpdateCltCustomerRequest
    • UserListItem
    • PublicProposalDetail
    • CltApplicationList
    • CltApplicationStatus
    • CltMargin
  1. Parceiros

Ativa ou inativa um usuário dentro do parceiro

PUT
/api/v1/partners/{partner_uuid}/users/{user_uuid}/status/{status}
Liga ou desliga o vínculo entre um usuário e este parceiro. O cadastro do usuário não
é alterado: quem opera em mais de um parceiro continua operando nos outros normalmente.
É a diferença entre "esse usuário não trabalha mais nesta revenda" e "esse usuário não
trabalha mais aqui" — para o segundo caso use DELETE /api/v1/users/{user_uuid} ou
PATCH /api/v1/users/{user_uuid} com {"status": "INACTIVE"}.

Situações aceitas#

statusEfeito
INACTIVEO usuário perde o acesso a este parceiro já na próxima requisição.
ACTIVEDevolve o acesso a este parceiro, com o mesmo grupo que ele tinha.
O valor vai na URL, em maiúsculas:
PUT /api/v1/partners/0e751e4f-.../users/166baa40-.../status/INACTIVE

Detalhes que valem conhecer#

Idempotente — reenviar a mesma situação responde 200 e não altera nada.
Vale na hora — o bloqueio não espera o token do usuário expirar.
status na resposta é o do vínculo com este parceiro, não o da plataforma.
Usuário inativado pela Unno não é reativável por aqui — a chamada responde 422
e o desbloqueio depende do suporte.
O parceiro precisa estar na hierarquia do chamador; fora dela a resposta é 403.

Requisição

Authorization
JWT Bearer
Adicionar o parâmetro
Authorization
a Cabeçalhos
Exemplo:
Authorization: ********************
or
Parâmetros de Caminho

Parâmetros Header

Respostas

🟢200OK
application/json
Situação do vínculo atualizada.
Bodyapplication/json

🟠401Não Autorizado
🟠403Proibido
🟠404Registo Não Encontrado
🟠422Erro de Parâmetro
🔴500Erro do Servidor
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://gtw.unnotech.com.br/public/api/v1/partners//users//status/INACTIVE' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - Exemplo 1
{
    "data": {
        "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",
        "name": "string",
        "email": "string",
        "phone": "string",
        "cpf": "string",
        "status": "ACTIVE",
        "partners": [
            {
                "group": {
                    "slug": "gerente-corban",
                    "label": "GERENTE CORBAN",
                    "group_id": "c57d9d45-552c-4c02-870e-f086cb09c57d"
                },
                "status": "ACTIVE",
                "partner_id": "6a3a39f6-861b-4a48-b868-5de838400e06",
                "partner_name": "string"
            }
        ],
        "must_change_password": true,
        "created_at": "2019-08-24T14:15:22.123Z"
    }
}
Modificado em 2026-08-20 20:00:50
Página anterior
Atualiza um parceiro (parcial)
Próxima página
Lista grupos disponíveis
Built with