API Docs Início Documentação Referência de API Copiar para LLM
PUT/v1/LegalPerson/{id}
Crédito · Pessoas

Atualiza os dados de uma pessoa jurídica

Atualiza por completo um registro de Legal Person existente.

Visão geral

Atualiza os dados de uma pessoa jurídica. Observe que essa requisição pode excluir registros relacionados caso não sejam incluídos no corpo. Por exemplo, dados bancários e uploads não referênciados serão excluídos. Isso pode causar erros caso o dado bancário esteja relacionado à uma operação de crédito concluída ou em andamento. Neste caso, utilize a API específica de atualização de dados bancários. Essa atualização é ignorada se a coleção relacionada for informada com valor nulo.

Autenticação e pré-requisitos

Requer autenticação. Envie o token no header Authorization: Bearer {{token}} (JWT do AWS Cognito). Integrações servidor-a-servidor podem usar X-Api-Key. Todo tráfego é HTTPS e a credencial nunca vai na URL nem em query string.

Pré-requisitos: a rota exige identificador(es) de recurso já existente(s):

Request

Parâmetros

NomeEmTipoObrigatórioDescriçãoExemplo
idpathstring (uuid)obrigatório—3fa85f64-5717-4562-b3fc-2c963f66afa6
returnValuequerystringopcional—valor

Corpo da requisição

Envie no formato application/json. Corpo opcional.

Campos

CampoTipoObrigatórioDescriçãoValoresExemplo
companyNamestringobrigatório——"Fulano de Tal"
namestringobrigatório——"Fulano de Tal"
typeOfActivitystringopcional—Industry, services, business"Industry"
legalNaturestringopcional—MEI, EI, EIREILI, SA, LTDA, SLU, SUA, SS"MEI"
municipalRegistrationstringopcional——"texto"
stateRegistrationstringopcional——"texto"
hasOpenCapitalRegistrationCVMbooleanopcional——true
b3Accountstringopcional——"texto"
openDatestring (date-time)opcional——"2025-08-11T13:45:00Z"
emailstringobrigatório——"cliente@exemplo.com.br"
sitestringopcional——"texto"
responsiblestringopcional——"texto"
addressobjetoopcional—objeto — ver detalhe abaixo{ … }
phonestringobrigatório——"11987654321"
phoneExtensionstringopcional——"11987654321"
phone2stringopcional——"11987654321"
phone2Extensionstringopcional——"11987654321"
economicActivityCodeIdstring (uuid)opcional——"3fa85f64-5717-4562-b3fc-2c963f66afa6"
sameBillingAddressbooleanopcional——true
averageMonthlyRevenuenumber (double)opcional——1000
averageGrossProfitMarginnumber (double)opcional——1000
initialShareCapitalnumber (double)opcional——1000
netWorthnumber (double)opcional——1000
purchasesnumber (double)opcional——1000
amountRentedFinancednumber (double)opcional——1000
exportPercentagenumber (double)opcional——1.99
costWithSuppliersnumber (double)opcional——1000
numberOfEmployeesintegeropcional——0
payrollValuenumber (double)opcional——1000
spendingAmountWithTaxnumber (double)opcional——1.99
typeOfResidencestringopcional—Owner, Rent"Owner"
averageSalesPeriodintegeropcional——0
fosterablePotentialnumber (double)opcional——1000
delayedSalePercentagenumber (double)opcional——1.99
allowAccessToSchedulebooleanopcional——true
allowAccessToReceivablesbooleanopcional——true
allowPartnerApiSubscriptionbooleanopcional——true
descriptionstringopcional——"texto"
externalEmployerIdintegeropcional——1
uploadsarray de objetoopcional—objeto — ver detalhe abaixo[ … ]
assetsarray de objetoopcional—objeto — ver detalhe abaixo[ … ]
bankAccountsarray de objetoopcional—objeto — ver detalhe abaixo[ … ]
relatedPersonarray de objetoopcional—objeto — ver detalhe abaixo[ … ]
riskRatingstringopcional—Low, Intermediary, High"Low"
managerIdstring (uuid)opcional——"3fa85f64-5717-4562-b3fc-2c963f66afa6"

Detalhe de address

CampoTipoObrigatórioDescriçãoValoresExemplo
ownerUserobjetoopcional—objeto — ver detalhe abaixo{ … }
ownerGroupobjetoopcional—objeto — ver detalhe abaixo{ … }
addressNamestringobrigatório——"Fulano de Tal"
zipCodestringopcional——"01310930"
citystringobrigatório——"texto"
ufstringobrigatório—NaoSelecionado, AC, AL, AP, AM, BA, CE, DF, ES, GO, MA, MT, MS, MG +14"NaoSelecionado"
districtstringobrigatório——"texto"
numberstringopcionalNúmero do endereço deve conter apenas números—"texto"
complementstringopcional——"texto"

Detalhe de uploads

CampoTipoObrigatórioDescriçãoValoresExemplo
ownerUserobjetoopcional—objeto — ver detalhe abaixo{ … }
ownerGroupobjetoopcional—objeto — ver detalhe abaixo{ … }
idstring (uuid)opcionalId do arquivo—"3fa85f64-5717-4562-b3fc-2c963f66afa6"
fileNamestringobrigatórioNome do arquivo (retornado pelo GET v1/Upload)—"Fulano de Tal"
fileTypestringopcional—Document, Authorization, DriversLicense, WorkCard, ResidenceProofCompany, ResidenceProofPartners, Draft, SocialContract, RegistrationNumber, IdentificationDocumentWithPhoto, BankStatement, ManagerialBilling, RegistrationForm, Others +41"Document"
displayNamestringopcionalNome de exibição do arquivo—"Fulano de Tal"
documentDatestring (date-time)opcionalData do próprio documento (emissão/referência), não a data do upload. Aceita em qualquer tipo de documento e sempre opcional. Só tem efeito de negócio no laudo de deferimento INSS e na última perícia INSS (regra de elegibilidade dos benefícios 32/92).—"2025-08-11T13:45:00Z"

Detalhe de assets

CampoTipoObrigatórioDescriçãoValoresExemplo
ownerUserobjetoopcional—objeto — ver detalhe abaixo{ … }
ownerGroupobjetoopcional—objeto — ver detalhe abaixo{ … }
idstring (uuid)opcional——"3fa85f64-5717-4562-b3fc-2c963f66afa6"
assetTypestringobrigatório—Cash, AccountsReceivable, Inventory, Investments, Vehicles, Furniture, Patents, RealEstate"Cash"
descriptionstringopcional——"texto"
registerNumberstringopcional——"texto"
estimatedValuenumber (double)opcional——1000
settledbooleanopcional——true

Detalhe de bankAccounts

CampoTipoObrigatórioDescriçãoValoresExemplo
ownerUserobjetoopcional—objeto — ver detalhe abaixo{ … }
ownerGroupobjetoopcional—objeto — ver detalhe abaixo{ … }
idstring (uuid)opcional——"3fa85f64-5717-4562-b3fc-2c963f66afa6"
bankCodeintegeropcional——0
bankIspbinteger (int64)opcionalCódigo ISPB do banco—0
accountstringopcional——"texto"
accountDigitstringopcional——"texto"
agencystringopcional——"texto"
agencyDigitstringopcional——"texto"
typestringopcional—NaturalCheckingAccount, NaturalSimpleAccount, LegalCheckingAccount, PublicEntities, FinancialInstitutionsDeposits, NaturalSavingsAccount, LegalSavingsAccount, RealEstateSavingsAccount, LotteryDeposits, EscrowAccount"NaturalCheckingAccount"
jointAccountbooleanopcional——true
operationTypeValuestringobrigatório—Transfer, Pix"Transfer"
pixKeyTypeValuestringopcional—NaturalRegistrationNumber, LegalRegistrationNumber, Phone, Email, Automatic, AgencyAndAccount"NaturalRegistrationNumber"
keyPixstringopcionalChave Pix—"texto"

Detalhe de relatedPerson

CampoTipoObrigatórioDescriçãoValoresExemplo
idstring (uuid)opcional——"3fa85f64-5717-4562-b3fc-2c963f66afa6"
legalPersonIdstring (uuid)opcional——"3fa85f64-5717-4562-b3fc-2c963f66afa6"
personIdstring (uuid)opcional——"3fa85f64-5717-4562-b3fc-2c963f66afa6"
typeOfRelationshipstringopcional—Issuer, PartnerGuarantor, Guarantor, Proxy, ProxyGuarantor, Partner, Spouse, Consenter, Witness, Assignor, Assignee, Endorser, Employer, Creditor +16"Issuer"
signatureTypestringopcional—email, sms, whatsapp"email"
signatureValidationstringopcional—EletronicSignatureAndDocument, SelfieSignature, SelfieDocumentSignature, FacialBiometrics, DigitalCertificate, EletronicSignature"EletronicSignatureAndDocument"

Detalhe de ownerUser

CampoTipoObrigatórioDescriçãoValoresExemplo
userIdstringobrigatório——"3fa85f64-5717-4562-b3fc-2c963f66afa6"
tenantNamestringobrigatório——"Fulano de Tal"

Detalhe de ownerGroup

CampoTipoObrigatórioDescriçãoValoresExemplo
groupIdstringobrigatório——"3fa85f64-5717-4562-b3fc-2c963f66afa6"
tenantNamestringobrigatório——"Fulano de Tal"

Exemplo de corpo

{
  "companyName": "Fulano de Tal",
  "name": "Fulano de Tal",
  "typeOfActivity": "Industry",
  "legalNature": "MEI",
  "municipalRegistration": "texto",
  "stateRegistration": "texto",
  "hasOpenCapitalRegistrationCVM": true,
  "b3Account": "texto",
  "openDate": "2025-08-11T13:45:00Z",
  "email": "cliente@exemplo.com.br",
  "site": "texto",
  "responsible": "texto",
  "address": {
    "ownerUser": {
      "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "ownerGroup": {
      "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "addressName": "Fulano de Tal",
    "zipCode": "01310930",
    "city": "texto",
    "uf": "NaoSelecionado",
    "district": "texto",
    "number": "texto",
    "complement": "texto"
  },
  "phone": "11987654321",
  "phoneExtension": "11987654321",
  "phone2": "11987654321",
  "phone2Extension": "11987654321",
  "economicActivityCodeId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "sameBillingAddress": true,
  "averageMonthlyRevenue": 1000,
  "averageGrossProfitMargin": 1000,
  "initialShareCapital": 1000,
  "netWorth": 1000,
  "purchases": 1000,
  "amountRentedFinanced": 1000,
  "exportPercentage": 1.99,
  "costWithSuppliers": 1000,
  "numberOfEmployees": 0,
  "payrollValue": 1000,
  "spendingAmountWithTax": 1.99,
  "typeOfResidence": "Owner",
  "averageSalesPeriod": 0,
  "fosterablePotential": 1000,
  "delayedSalePercentage": 1.99,
  "allowAccessToSchedule": true,
  "allowAccessToReceivables": true,
  "allowPartnerApiSubscription": true,
  "description": "texto",
  "externalEmployerId": 1,
  "uploads": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "fileName": "Fulano de Tal",
      "fileType": "Document",
      "displayName": "Fulano de Tal",
      "documentDate": "2025-08-11T13:45:00Z"
    }
  ],
  "assets": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "assetType": "Cash",
      "description": "texto",
      "registerNumber": "texto",
      "estimatedValue": 1000,
      "settled": true
    }
  ],
  "bankAccounts": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "bankCode": 0,
      "bankIspb": 0,
      "account": "texto",
      "accountDigit": "texto",
      "agency": "texto",
      "agencyDigit": "texto",
      "type": "NaturalCheckingAccount",
      "jointAccount": true,
      "operationTypeValue": "Transfer",
      "pixKeyTypeValue": "NaturalRegistrationNumber",
      "keyPix": "texto"
    }
  ],
  "relatedPerson": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "legalPersonId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "personId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "typeOfRelationship": "Issuer",
      "signatureType": "email",
      "signatureValidation": "EletronicSignatureAndDocument"
    }
  ],
  "riskRating": "Low",
  "managerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

Response

Resposta 200 sem corpo (Success).

Códigos de retorno

CódigoSignificadoDetalhe do contrato
200Requisição bem-sucedida.Success

Exemplos

curl -X PUT "{{baseUrl}}/v1/LegalPerson/3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -H "Authorization: Bearer {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "companyName": "Fulano de Tal",
  "name": "Fulano de Tal",
  "typeOfActivity": "Industry",
  "legalNature": "MEI",
  "municipalRegistration": "texto",
  "stateRegistration": "texto",
  "hasOpenCapitalRegistrationCVM": true,
  "b3Account": "texto",
  "openDate": "2025-08-11T13:45:00Z",
  "email": "cliente@exemplo.com.br",
  "site": "texto",
  "responsible": "texto",
  "address": {
    "ownerUser": {
      "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "ownerGroup": {
      "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "addressName": "Fulano de Tal",
    "zipCode": "01310930",
    "city": "texto",
    "uf": "NaoSelecionado",
    "district": "texto",
    "number": "texto",
    "complement": "texto"
  },
  "phone": "11987654321",
  "phoneExtension": "11987654321",
  "phone2": "11987654321",
  "phone2Extension": "11987654321",
  "economicActivityCodeId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "sameBillingAddress": true,
  "averageMonthlyRevenue": 1000,
  "averageGrossProfitMargin": 1000,
  "initialShareCapital": 1000,
  "netWorth": 1000,
  "purchases": 1000,
  "amountRentedFinanced": 1000,
  "exportPercentage": 1.99,
  "costWithSuppliers": 1000,
  "numberOfEmployees": 0,
  "payrollValue": 1000,
  "spendingAmountWithTax": 1.99,
  "typeOfResidence": "Owner",
  "averageSalesPeriod": 0,
  "fosterablePotential": 1000,
  "delayedSalePercentage": 1.99,
  "allowAccessToSchedule": true,
  "allowAccessToReceivables": true,
  "allowPartnerApiSubscription": true,
  "description": "texto",
  "externalEmployerId": 1,
  "uploads": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "fileName": "Fulano de Tal",
      "fileType": "Document",
      "displayName": "Fulano de Tal",
      "documentDate": "2025-08-11T13:45:00Z"
    }
  ],
  "assets": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "assetType": "Cash",
      "description": "texto",
      "registerNumber": "texto",
      "estimatedValue": 1000,
      "settled": true
    }
  ],
  "bankAccounts": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "bankCode": 0,
      "bankIspb": 0,
      "account": "texto",
      "accountDigit": "texto",
      "agency": "texto",
      "agencyDigit": "texto",
      "type": "NaturalCheckingAccount",
      "jointAccount": true,
      "operationTypeValue": "Transfer",
      "pixKeyTypeValue": "NaturalRegistrationNumber",
      "keyPix": "texto"
    }
  ],
  "relatedPerson": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "legalPersonId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "personId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "typeOfRelationship": "Issuer",
      "signatureType": "email",
      "signatureValidation": "EletronicSignatureAndDocument"
    }
  ],
  "riskRating": "Low",
  "managerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}'
var baseUrl = "{{baseUrl}}";
var token   = "{{token}}";

using var http = new HttpClient { BaseAddress = new Uri(baseUrl) };
http.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", token);

var rota = "/v1/LegalPerson/3fa85f64-5717-4562-b3fc-2c963f66afa6";

var corpo = new StringContent(
    """
    {
      "companyName": "Fulano de Tal",
      "name": "Fulano de Tal",
      "typeOfActivity": "Industry",
      "legalNature": "MEI",
      "municipalRegistration": "texto",
      "stateRegistration": "texto",
      "hasOpenCapitalRegistrationCVM": true,
      "b3Account": "texto",
      "openDate": "2025-08-11T13:45:00Z",
      "email": "cliente@exemplo.com.br",
      "site": "texto",
      "responsible": "texto",
      "address": {
        "ownerUser": {
          "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "tenantName": "Fulano de Tal"
        },
        "ownerGroup": {
          "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "tenantName": "Fulano de Tal"
        },
        "addressName": "Fulano de Tal",
        "zipCode": "01310930",
        "city": "texto",
        "uf": "NaoSelecionado",
        "district": "texto",
        "number": "texto",
        "complement": "texto"
      },
      "phone": "11987654321",
      "phoneExtension": "11987654321",
      "phone2": "11987654321",
      "phone2Extension": "11987654321",
      "economicActivityCodeId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "sameBillingAddress": true,
      "averageMonthlyRevenue": 1000,
      "averageGrossProfitMargin": 1000,
      "initialShareCapital": 1000,
      "netWorth": 1000,
      "purchases": 1000,
      "amountRentedFinanced": 1000,
      "exportPercentage": 1.99,
      "costWithSuppliers": 1000,
      "numberOfEmployees": 0,
      "payrollValue": 1000,
      "spendingAmountWithTax": 1.99,
      "typeOfResidence": "Owner",
      "averageSalesPeriod": 0,
      "fosterablePotential": 1000,
      "delayedSalePercentage": 1.99,
      "allowAccessToSchedule": true,
      "allowAccessToReceivables": true,
      "allowPartnerApiSubscription": true,
      "description": "texto",
      "externalEmployerId": 1,
      "uploads": [
        {
          "ownerUser": {
            "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "tenantName": "Fulano de Tal"
          },
          "ownerGroup": {
            "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "tenantName": "Fulano de Tal"
          },
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "fileName": "Fulano de Tal",
          "fileType": "Document",
          "displayName": "Fulano de Tal",
          "documentDate": "2025-08-11T13:45:00Z"
        }
      ],
      "assets": [
        {
          "ownerUser": {
            "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "tenantName": "Fulano de Tal"
          },
          "ownerGroup": {
            "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "tenantName": "Fulano de Tal"
          },
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "assetType": "Cash",
          "description": "texto",
          "registerNumber": "texto",
          "estimatedValue": 1000,
          "settled": true
        }
      ],
      "bankAccounts": [
        {
          "ownerUser": {
            "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "tenantName": "Fulano de Tal"
          },
          "ownerGroup": {
            "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "tenantName": "Fulano de Tal"
          },
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "bankCode": 0,
          "bankIspb": 0,
          "account": "texto",
          "accountDigit": "texto",
          "agency": "texto",
          "agencyDigit": "texto",
          "type": "NaturalCheckingAccount",
          "jointAccount": true,
          "operationTypeValue": "Transfer",
          "pixKeyTypeValue": "NaturalRegistrationNumber",
          "keyPix": "texto"
        }
      ],
      "relatedPerson": [
        {
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "legalPersonId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "personId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "typeOfRelationship": "Issuer",
          "signatureType": "email",
          "signatureValidation": "EletronicSignatureAndDocument"
        }
      ],
      "riskRating": "Low",
      "managerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    }
    """,
    Encoding.UTF8, "application/json");

var resp = await http.PutAsync(rota, corpo);
resp.EnsureSuccessStatusCode();
// Sem corpo de resposta neste endpoint.
const baseUrl = '{{baseUrl}}';
const token   = '{{token}}';

const payload = {
  "companyName": "Fulano de Tal",
  "name": "Fulano de Tal",
  "typeOfActivity": "Industry",
  "legalNature": "MEI",
  "municipalRegistration": "texto",
  "stateRegistration": "texto",
  "hasOpenCapitalRegistrationCVM": true,
  "b3Account": "texto",
  "openDate": "2025-08-11T13:45:00Z",
  "email": "cliente@exemplo.com.br",
  "site": "texto",
  "responsible": "texto",
  "address": {
    "ownerUser": {
      "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "ownerGroup": {
      "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "addressName": "Fulano de Tal",
    "zipCode": "01310930",
    "city": "texto",
    "uf": "NaoSelecionado",
    "district": "texto",
    "number": "texto",
    "complement": "texto"
  },
  "phone": "11987654321",
  "phoneExtension": "11987654321",
  "phone2": "11987654321",
  "phone2Extension": "11987654321",
  "economicActivityCodeId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "sameBillingAddress": true,
  "averageMonthlyRevenue": 1000,
  "averageGrossProfitMargin": 1000,
  "initialShareCapital": 1000,
  "netWorth": 1000,
  "purchases": 1000,
  "amountRentedFinanced": 1000,
  "exportPercentage": 1.99,
  "costWithSuppliers": 1000,
  "numberOfEmployees": 0,
  "payrollValue": 1000,
  "spendingAmountWithTax": 1.99,
  "typeOfResidence": "Owner",
  "averageSalesPeriod": 0,
  "fosterablePotential": 1000,
  "delayedSalePercentage": 1.99,
  "allowAccessToSchedule": true,
  "allowAccessToReceivables": true,
  "allowPartnerApiSubscription": true,
  "description": "texto",
  "externalEmployerId": 1,
  "uploads": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "fileName": "Fulano de Tal",
      "fileType": "Document",
      "displayName": "Fulano de Tal",
      "documentDate": "2025-08-11T13:45:00Z"
    }
  ],
  "assets": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "assetType": "Cash",
      "description": "texto",
      "registerNumber": "texto",
      "estimatedValue": 1000,
      "settled": true
    }
  ],
  "bankAccounts": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "bankCode": 0,
      "bankIspb": 0,
      "account": "texto",
      "accountDigit": "texto",
      "agency": "texto",
      "agencyDigit": "texto",
      "type": "NaturalCheckingAccount",
      "jointAccount": true,
      "operationTypeValue": "Transfer",
      "pixKeyTypeValue": "NaturalRegistrationNumber",
      "keyPix": "texto"
    }
  ],
  "relatedPerson": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "legalPersonId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "personId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "typeOfRelationship": "Issuer",
      "signatureType": "email",
      "signatureValidation": "EletronicSignatureAndDocument"
    }
  ],
  "riskRating": "Low",
  "managerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
};

const resp = await fetch(`${baseUrl}/v1/LegalPerson/3fa85f64-5717-4562-b3fc-2c963f66afa6`, {
  method: 'PUT',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(payload),
});

if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
// Sem corpo de resposta neste endpoint.

Troque apenas {{baseUrl}} e {{token}}. No Postman, defina-os como variáveis de environment; o cURL importa em Import > Raw text.

Downloads

Este endpoint já vem configurado nas collections abaixo, na pasta da etapa correspondente.

Collection completaConsignado privado e FGTS, em pastas espelhando a documentação.Baixar →Collection do Consignado privadoCadastros, operação e consultas do módulo.Baixar →Collection do FGTSCadastros, operação e consultas do módulo.Baixar →Environment do PostmanAs variáveis fora da collection, para versionar uma sem versionar o token.Baixar →Documentação consolidada para LLMToda a documentação em um arquivo de texto, na ordem da navegação.Baixar →Referência em MarkdownEste contrato, campo a campo, gerado do spec.Baixar →

Guia de importação: Como importar no Postman · Todos os downloads: Downloads