Atualiza um parceiro (parcial)

Produção

https://gtw.unnotech.com.br/public

PATCH

/api/v1/partners/{partner_uuid}

Atualiza apenas os campos enviados no body. Todos os campos são opcionais.

Imutáveis: type (pf/pj) e document_number (CPF/CNPJ) não podem ser alterados.

A operação só é permitida se o parceiro alvo estiver dentro da hierarquia do caller
(verificada via JWT partner_snapshot_uuid). Caso contrário, retorna 403.

Requisição

Authorization

JWT Bearer

Adicionar o parâmetro

Authorization

a Cabeçalhos

Exemplo:

Authorization: ********************

Parâmetros de Caminho

Parâmetros Header

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200

application/json

Parceiro atualizado.

Body

🟠401

🟠403

🟠404

🟠422

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://gtw.unnotech.com.br/public/api/v1/partners/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "partner": {
        "type": "pf",
        "name": "Fulano de Tal",
        "email": "fulano@detal.com.br",
        "phone": "11987654321",
        "document_number": "12345678901",
        "is_retailer": true,
        "parent_uuid": "a52a555d-68f8-4560-b544-8ebc76a447ac"
    },
    "address": {
        "zipcode": "01310100",
        "uf": "SP",
        "city": "São Paulo",
        "district": "Centro",
        "neighborhood": "Bela Vista",
        "street": "Avenida Paulista",
        "number": "1000",
        "complement": "Sala 202"
    },
    "bank_account": {
        "type": "CPP",
        "agency": "1234",
        "bank_id": "001",
        "bank_name": "Banco do Brasil",
        "agency_digit": "1",
        "account_number": "567890123",
        "account_digit": "5",
        "pix_key": "fulano@detal.com.br",
        "pix_type": "EMAIL"
    }
}'

Response Example

200 - Exemplo 1

{
    "data": {
        "partner_id": "3ea1d784-4c6f-4dd0-bfa3-5e027c172fd1",
        "name": "Fulano de Tal",
        "status": "active",
        "email": "fulano@detal.com.br",
        "phone": "11987654321",
        "address": {
            "zipcode": "01310100",
            "uf": "SP",
            "city": "São Paulo",
            "district": "Centro",
            "neighborhood": "Bela Vista",
            "street": "Avenida Paulista",
            "number": "1000",
            "complement": "Sala 202"
        },
        "document_number": "12345678901",
        "person_type": "pf",
        "is_retailer": true,
        "created_at": "2026-05-08T13:45:00Z",
        "parent_id": "1c6ca187-e61f-4301-8dcb-0e9749e89eef",
        "bank_account": {
            "type": "CPP",
            "agency": "1234",
            "bank_id": "001",
            "bank_name": "Banco do Brasil",
            "agency_digit": "1",
            "account_number": "567890123",
            "account_digit": "5",
            "pix_key": "fulano@detal.com.br",
            "pix_type": "EMAIL"
        }
    }
}

Modificado em 2026-05-09 02:17:11

Página anterior

Remove um parceiro

Próxima página

Lista usuários com filtros e paginação