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

Insere uma nova pessoa jurídica

Cria um novo registro de Legal Person.

Visão geral

Insere uma nova pessoa jurídica. Caso já exista um cadastro existente da PJ visível ao operador solicitante (com base no CNPJ), os dados existentes serão atualizados e o ID retornado será o do registro existente. Coleções relacionadas serão combinadas (dados bancários, documentos, etc).

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.

Request

Parâmetros

NomeEmTipoObrigatórioDescriçãoExemplo
returnValuequerystringopcional—valor

Corpo da requisição

Envie no formato application/json. Corpo opcional.

Campos

CampoTipoObrigatórioDescriçãoValoresExemplo
ownerUserobjetoopcional—objeto — ver detalhe abaixo{ … }
ownerGroupobjetoopcional—objeto — ver detalhe abaixo{ … }
registrationNumberstringobrigatórioNúmero CNPJ—"12345678909"
companyNamestringobrigatórioRazão Social—"Fulano de Tal"
namestringobrigatórioNome fantasia—"Fulano de Tal"
typeOfActivitystringopcional—Industry, services, business"Industry"
legalNaturestringopcional—MEI, EI, EIREILI, SA, LTDA, SLU, SUA, SS"MEI"
municipalRegistrationstringopcionalInscrição municipal—"texto"
stateRegistrationstringopcionalInscrição estadual—"texto"
hasOpenCapitalRegistrationCVMbooleanopcionalSe possui registro de capital aberno CVM—true
openDatestring (date-time)opcionalData de início das atividades—"2025-08-11T13:45:00Z"
emailstringobrigatórioE-mail de contato—"cliente@exemplo.com.br"
sitestringopcionalWebsite institucional—"texto"
responsiblestringopcionalResponsável legal—"texto"
addressobjetoopcional—objeto — ver detalhe abaixo{ … }
phonestringobrigatórioNúmero de telefone—"11987654321"
phoneExtensionstringopcionalRamal do telefone—"11987654321"
phone2stringopcionalNúmero de telefone alternativo—"11987654321"
phone2ExtensionstringopcionalRamal do telefone alternativo—"11987654321"
economicActivityCodeIdstring (uuid)opcionalID do Código de Atividade Econômica Principal (CNAE)—"3fa85f64-5717-4562-b3fc-2c963f66afa6"
sameBillingAddressbooleanopcionalIndica se o endereço de cobrança é o mesmo endereço da sede—true
b3AccountstringopcionalNúmero da Conta B3—"texto"
averageMonthlyRevenuenumber (double)opcionalFaturamento médio mensal dos últimos 12 meses—1000
averageGrossProfitMarginnumber (double)opcionalMargem Média de Lucro Bruto dos últimos 12 meses—1000
initialShareCapitalnumber (double)opcionalCapital social integralizado—1000
netWorthnumber (double)opcionalPatrimônio Líquido—1000
purchasesnumber (double)opcionalValor em compras nos últimos 12 meses—1000
amountRentedFinancednumber (double)opcionalValor Alugado/Financiado—1000
exportPercentagenumber (double)opcionalExportação (em % do faturamento)—1.99
costWithSuppliersnumber (double)opcionalCusto com fornecedores—1000
numberOfEmployeesintegeropcionalNúmero de funcionários—0
payrollValuenumber (double)opcionalValor da folha de pagamentos—1000
spendingAmountWithTaxnumber (double)opcionalGasto corrente com impostos—1.99
typeOfResidencestringopcional—Owner, Rent"Owner"
averageSalesPeriodintegeropcionalPeríodo média de vendas (PMV) em dias—0
fosterablePotentialnumber (double)opcionalPotencial fomentável—1000
delayedSalePercentagenumber (double)opcionalPercentual de Venda em Atraso—1.99
descriptionstringopcionalDescrição das atividades da empresa—"texto"
allowAccessToSchedulebooleanopcionalPermite contato para agendamentos—true
allowAccessToReceivablesbooleanopcionalPermite acesso à carteira de recebíveis—true
allowPartnerApiSubscriptionbooleanopcionalPermite acesso à API parceira—true
uploadsarray de objetoopcionalDocumentos carregadosobjeto — ver detalhe abaixo[ … ]
assetsarray de objetoopcionalLista de bens e diretosobjeto — ver detalhe abaixo[ … ]
externalEmployerIdintegeropcional——1
bankAccountsarray de objetoopcionalLista de contas bancáriasobjeto — ver detalhe abaixo[ … ]
relatedPersonarray de objetoopcionalLista de pessoas envolvidasobjeto — ver detalhe abaixo[ … ]
riskRatingstringopcional—Low, Intermediary, High"Low"
managerIdstring (uuid)opcionalGestor—"3fa85f64-5717-4562-b3fc-2c963f66afa6"

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"

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"
ufstringopcional—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{ … }
fileTypestringobrigatório—Document, Authorization, DriversLicense, WorkCard, ResidenceProofCompany, ResidenceProofPartners, Draft, SocialContract, RegistrationNumber, IdentificationDocumentWithPhoto, BankStatement, ManagerialBilling, RegistrationForm, Others +41"Document"
fileNamestringobrigatórioNome do arquivo (retornado pelo GET v1/Upload)—"Fulano de Tal"
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, cujos valores são comparados aos cortes da regra de elegibilidade dos benefícios 32/92 (faixa 45–54); nos demais tipos é apenas informativa.—"2025-08-11T13:45:00Z"

Detalhe de assets

CampoTipoObrigatórioDescriçãoValoresExemplo
ownerUserobjetoopcional—objeto — ver detalhe abaixo{ … }
ownerGroupobjetoopcional—objeto — ver detalhe abaixo{ … }
naturalPersonIdstring (uuid)opcional——"3fa85f64-5717-4562-b3fc-2c963f66afa6"
legalPersonIdstring (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{ … }
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
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"

Exemplo de corpo

{
  "ownerUser": {
    "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "tenantName": "Fulano de Tal"
  },
  "ownerGroup": {
    "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "tenantName": "Fulano de Tal"
  },
  "registrationNumber": "12345678909",
  "companyName": "Fulano de Tal",
  "name": "Fulano de Tal",
  "typeOfActivity": "Industry",
  "legalNature": "MEI",
  "municipalRegistration": "texto",
  "stateRegistration": "texto",
  "hasOpenCapitalRegistrationCVM": true,
  "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,
  "b3Account": "texto",
  "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,
  "description": "texto",
  "allowAccessToSchedule": true,
  "allowAccessToReceivables": true,
  "allowPartnerApiSubscription": true,
  "uploads": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "fileType": "Document",
      "fileName": "Fulano de Tal",
      "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"
      },
      "naturalPersonId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "legalPersonId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "assetType": "Cash",
      "description": "texto",
      "registerNumber": "texto",
      "estimatedValue": 1000,
      "settled": true
    }
  ],
  "externalEmployerId": 1,
  "bankAccounts": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "bankCode": 0,
      "bankIspb": 0,
      "account": "texto",
      "accountDigit": "texto",
      "agency": "texto",
      "agencyDigit": "texto",
      "type": "NaturalCheckingAccount",
      "jointAccount": true,
      "operationTypeValue": "Transfer",
      "pixKeyTypeValue": "NaturalRegistrationNumber",
      "keyPix": "texto"
    }
  ],
  "relatedPerson": [
    {
      "personId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "typeOfRelationship": "Issuer",
      "signatureType": "email",
      "signatureValidation": "EletronicSignatureAndDocument"
    }
  ],
  "riskRating": "Low",
  "managerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

Response

Resposta 200.

Sem campos estruturados no contrato (tipo primitivo ou livre).

Exemplo de resposta

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

Códigos de retorno

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

Exemplos

curl -X POST "{{baseUrl}}/v1/LegalPerson" \
  -H "Authorization: Bearer {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "ownerUser": {
    "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "tenantName": "Fulano de Tal"
  },
  "ownerGroup": {
    "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "tenantName": "Fulano de Tal"
  },
  "registrationNumber": "12345678909",
  "companyName": "Fulano de Tal",
  "name": "Fulano de Tal",
  "typeOfActivity": "Industry",
  "legalNature": "MEI",
  "municipalRegistration": "texto",
  "stateRegistration": "texto",
  "hasOpenCapitalRegistrationCVM": true,
  "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,
  "b3Account": "texto",
  "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,
  "description": "texto",
  "allowAccessToSchedule": true,
  "allowAccessToReceivables": true,
  "allowPartnerApiSubscription": true,
  "uploads": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "fileType": "Document",
      "fileName": "Fulano de Tal",
      "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"
      },
      "naturalPersonId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "legalPersonId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "assetType": "Cash",
      "description": "texto",
      "registerNumber": "texto",
      "estimatedValue": 1000,
      "settled": true
    }
  ],
  "externalEmployerId": 1,
  "bankAccounts": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "bankCode": 0,
      "bankIspb": 0,
      "account": "texto",
      "accountDigit": "texto",
      "agency": "texto",
      "agencyDigit": "texto",
      "type": "NaturalCheckingAccount",
      "jointAccount": true,
      "operationTypeValue": "Transfer",
      "pixKeyTypeValue": "NaturalRegistrationNumber",
      "keyPix": "texto"
    }
  ],
  "relatedPerson": [
    {
      "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";

var corpo = new StringContent(
    """
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "registrationNumber": "12345678909",
      "companyName": "Fulano de Tal",
      "name": "Fulano de Tal",
      "typeOfActivity": "Industry",
      "legalNature": "MEI",
      "municipalRegistration": "texto",
      "stateRegistration": "texto",
      "hasOpenCapitalRegistrationCVM": true,
      "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,
      "b3Account": "texto",
      "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,
      "description": "texto",
      "allowAccessToSchedule": true,
      "allowAccessToReceivables": true,
      "allowPartnerApiSubscription": true,
      "uploads": [
        {
          "ownerUser": {
            "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "tenantName": "Fulano de Tal"
          },
          "ownerGroup": {
            "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "tenantName": "Fulano de Tal"
          },
          "fileType": "Document",
          "fileName": "Fulano de Tal",
          "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"
          },
          "naturalPersonId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "legalPersonId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "assetType": "Cash",
          "description": "texto",
          "registerNumber": "texto",
          "estimatedValue": 1000,
          "settled": true
        }
      ],
      "externalEmployerId": 1,
      "bankAccounts": [
        {
          "ownerUser": {
            "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "tenantName": "Fulano de Tal"
          },
          "ownerGroup": {
            "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "tenantName": "Fulano de Tal"
          },
          "bankCode": 0,
          "bankIspb": 0,
          "account": "texto",
          "accountDigit": "texto",
          "agency": "texto",
          "agencyDigit": "texto",
          "type": "NaturalCheckingAccount",
          "jointAccount": true,
          "operationTypeValue": "Transfer",
          "pixKeyTypeValue": "NaturalRegistrationNumber",
          "keyPix": "texto"
        }
      ],
      "relatedPerson": [
        {
          "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.PostAsync(rota, corpo);
resp.EnsureSuccessStatusCode();
var json = await resp.Content.ReadAsStringAsync();
const baseUrl = '{{baseUrl}}';
const token   = '{{token}}';

const payload = {
  "ownerUser": {
    "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "tenantName": "Fulano de Tal"
  },
  "ownerGroup": {
    "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "tenantName": "Fulano de Tal"
  },
  "registrationNumber": "12345678909",
  "companyName": "Fulano de Tal",
  "name": "Fulano de Tal",
  "typeOfActivity": "Industry",
  "legalNature": "MEI",
  "municipalRegistration": "texto",
  "stateRegistration": "texto",
  "hasOpenCapitalRegistrationCVM": true,
  "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,
  "b3Account": "texto",
  "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,
  "description": "texto",
  "allowAccessToSchedule": true,
  "allowAccessToReceivables": true,
  "allowPartnerApiSubscription": true,
  "uploads": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "fileType": "Document",
      "fileName": "Fulano de Tal",
      "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"
      },
      "naturalPersonId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "legalPersonId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "assetType": "Cash",
      "description": "texto",
      "registerNumber": "texto",
      "estimatedValue": 1000,
      "settled": true
    }
  ],
  "externalEmployerId": 1,
  "bankAccounts": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "bankCode": 0,
      "bankIspb": 0,
      "account": "texto",
      "accountDigit": "texto",
      "agency": "texto",
      "agencyDigit": "texto",
      "type": "NaturalCheckingAccount",
      "jointAccount": true,
      "operationTypeValue": "Transfer",
      "pixKeyTypeValue": "NaturalRegistrationNumber",
      "keyPix": "texto"
    }
  ],
  "relatedPerson": [
    {
      "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`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(payload),
});

if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
const data = await resp.json();

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