Detalhes de uma empresa

Objeto que contém todas as informações de uma entidade jurídica (BUSINESS).

Este objeto é retornado apenas quando o tipo da entidade é BUSINESS.

---

Estrutura

business_details (object)

Contém os dados completos da empresa.

---

address (object)

Endereço da empresa.

⚠️ Os caracteres devem seguir validação compatível com Fedwire, pois são utilizados em múltiplos trilhos de pagamento.

Campo	Tipo	Descrição
line_1	string	Endereço linha 1
line_2	string	Endereço linha 2
city	string	Cidade
state	string	Estado (obrigatório para EUA, usar abreviações ex: CA, NY)
postal_code	string	Código postal (ver validações abaixo)
country_code	string	Código ISO 3166-1 Alpha-2 (ex: US, BR, FR)

---

Validação de Postal Code

• CN: ^\d6$
• DE: ^\d5$
• FR: ^\d5$
• GB: ^[A-Z]{1,2}\d[A-Z0-9]? ?\d[A-Z]{2}$
• JP: ^\d3-\d4$
• US: ^\d5(?:-\d4)?$

---

Informações da Empresa

Campo	Tipo	Descrição
business_name	string	Nome legal da empresa
ein	string	Tax ID (EIN ou SSN para sole proprietorship)
registration_id	object	Identificador de registro (EIN ou equivalente)
industry	string	Setor de atuação
website	string	Website da empresa (opcional, recomendado)

---

registration_id (object)

Campo	Tipo	Descrição
number	string	Número de registro
country_code	string	País de emissão (ISO 3166-1 Alpha-2)

---

Tipo Legal

legal_type (string)

Valores permitidos:

• limited-partnership
• trust
• irrevocable_trust
• revocable_trust
• sole-proprietorship
• corporation
• llc
• general-partnership
• professional-association
• government
• non-profit
• other

---

Dados adicionais (Root Entity)

Campos obrigatórios apenas para entidades raiz (is_root = true)

Campo	Tipo	Descrição
state_of_incorporation	string	Estado de incorporação (ex: DE, CA)
year_of_incorporation	string	Ano de incorporação
account_usage	array[string]	Uso esperado das contas
description	string	Descrição da empresa
payment_volumes	string	Volume esperado de transações
countries_of_operation	array[string]	Países de operação (ISO Alpha-2)

---

Flags

Campo	Tipo	Descrição
is_root	boolean	Indica se é entidade raiz
is_high_risk	boolean	Indica se foi classificada como alto risco

---

Documentos

documents (array)

Lista de documentos enviados via API.

---

Metadados

Campo	Tipo	Descrição
id	string	Identificador único
type	string	Tipo da entidade (BUSINESS)
review_reasons	array	Motivos de revisão manual
verification_status	string	Status de verificação
verification_tags	string	Tags adicionais de verificação

---

Status de Verificação

verification_status pode assumir:

• UNVERIFIED
• PENDING
• MANUAL_REVIEW
• VERIFIED
• DENIED `

---

Observações

• O objeto segue padrões globais de compliance (KYC/KYB)
• Validações são alinhadas com trilhos como Fedwire, ACH, SWIFT
• Campos adicionais aumentam a taxa de aprovação automática

---

Este objeto é fundamental para garantir validação, compliance e operação segura de entidades empresariais na Valut.