Atualizar Documento de Empresa

put

https://sandbox.auth.flowfinance.com.br/banking//originator/business/{business_id}/documents/{document_id}

Atualiza um documento previamente associado ao cadastro de uma Empresa.

Este endpoint é utilizado para substituir ou versionar documentos já enviados, garantindo que, durante a Solicitação de Crédito, todos os documentos obrigatórios — conforme a configuração do Produto — estejam válidos, atualizados e consistentes.

Descrição

Este endpoint permite atualizar um documento específico, identificado pelo document_id, vinculado a uma Empresa identificada pelo business_id.

A operação cria uma nova versão do documento, mantendo o histórico de alterações.

Método HTTP

PUT

URL

https://sandbox.platform.credit.celcoin.com.br/business/api/v1/businesses/{business_id}/documents/{document_id}

Path Parameters

Nome	Tipo	Obrigatório	Descrição
business_id	string (UUID v4)	Sim	Identificador único do cadastro da Empresa.
document_id	string (UUID v4)	Sim	Identificador único do documento que será atualizado.

Headers

Nome	Tipo	Obrigatório	Descrição
Authorization	string	Sim	Token de autenticação no formato `Bearer {token}`.
Content-Type	string	Sim	Deve ser informado como `multipart/form-data`.

Body Parameters (multipart/form-data)

Dados do Documento

Campo	Tipo	Obrigatório	Descrição
file	file	Sim	Arquivo do documento que será atualizado.
type	string	Sim	Tipo do documento (ver lista de tipos aceitos).
observations	string	Não	Observações ou comentários sobre o documento enviado.

Tipos de Documentos Aceitos (`type`)

Valor	Descrição
NATIONAL_ID	Documento de Identidade
DRIVERS_LICENSE	Carteira Nacional de Habilitação (CNH)
MILITARY_ID	Identificação Militar
PROOF_OF_INCOME	Comprovante de Renda
BALANCE_SHEETS	Balanço Patrimonial
INCOME_STATEMENT	Comprovante de Faturamento
PROOF_OF_ADDRESS	Comprovante de Endereço
BYLAWS	Estatuto Social
INCORPORATION_CERTIFICATE	Registro de Incorporação
FEDERAL_REGISTER_CERTIFICATE	Cartão CNPJ
INVOICE	Comprovante
CERTIFICATE	Certidão
LETTER_OF_ATTORNEY	Procuração
CONTRACT	Contrato
OTHER	Outro

Exemplo de Requisição

Form-data

Key	Tipo	Value
file	file	comprovante_endereco.pdf
type	text	PROOF_OF_ADDRESS
observations	text	Documento atualizado em 20 de janeiro de 2026

Resposta de Sucesso

Status: 200 OK

Documento atualizado com sucesso. Uma nova versão é criada e retornada.

Exemplo de Resposta

{
  "id": "d7e11ae5-2252-4c12-bb0e-27e2d86ee034",
  "type": "BALANCE_SHEETS",
  "observations": "Documento atualizado em 20 de janeiro de 2026",
  "status": "OK",
  "file_extension": "pdf",
  "file_name": "balanco_patrimonial_teste_v.2.pdf",
  "entity_id": "c47ea1c9-0f67-429f-a1b7-ace6f6bea704",
  "created_at": "2026-01-20T17:38:26.392671Z",
  "updated_at": "2026-01-20T17:50:13.579503Z",
  "version": 2
}

Estrutura da Resposta

Campo	Tipo	Descrição
id	string (UUID v4)	Identificador único do documento.
type	string	Tipo do documento enviado.
observations	string	Observações associadas ao documento.
status	string	Status do processamento do documento.
file_extension	string	Extensão do arquivo armazenado.
file_name	string	Nome do arquivo armazenado.
entity_id	string (UUID v4)	Identificador da entidade (Empresa) associada.
created_at	datetime	Data e hora de criação do documento.
updated_at	datetime	Data e hora da última atualização.
version	integer	Versão do documento.

Códigos de Retorno HTTP

Código	Descrição
200 OK	Documento atualizado com sucesso.
400 Bad Request	Dados inválidos ou parâmetros obrigatórios ausentes.
401 Unauthorized	Token de autenticação inválido ou ausente.
403 Forbidden	Acesso não autorizado à Empresa ou documento informado.
404 Not Found	Empresa ou documento não encontrado.
409 Conflict	Conflito de versão ou estado inválido do documento.
422 Unprocessable Entity	Tipo de documento inválido ou arquivo incompatível.
500 Internal Server Error	Erro interno inesperado.

Language

URL

Click Try It! to start a request and see the response here!