Gerenciar Empresas

Endpoints para consultar, atualizar e excluir empresas (emissores).

Consultar CNPJ na Receita Federal

GET /companies/consult/{cnpj}

Consulta dados de um CNPJ diretamente na Receita Federal antes de cadastrar a empresa.

Parâmetro	Tipo	Descrição
cnpj	string	CNPJ (apenas números, 14 dígitos)

curl -X GET "https://api.engineapi.com.br/companies/consult/12345678000195" \
  -H "Authorization: Bearer seu-token"

---

Buscar Empresa por ID

GET /companies/{id}

Retorna os detalhes de uma empresa específica.

Parâmetro	Tipo	Descrição
id	string	ID da empresa

curl -X GET "https://api.engineapi.com.br/companies/uuid-da-empresa" \
  -H "Authorization: Bearer seu-token"

---

Atualizar Empresa

PATCH /companies/{id}

Atualiza os dados de uma empresa cadastrada.

Body

Campo	Tipo	Descrição
name	string	Razão social
tradeName	string	Nome fantasia
email	string	E-mail
phone	string	Telefone
address	string	Endereço
city	string	Cidade
state	string	UF
zipCode	string	CEP

curl -X PATCH "https://api.engineapi.com.br/companies/uuid" \
  -H "Authorization: Bearer seu-token" \
  -H "Content-Type: application/json" \
  -d '{ "tradeName": "Nova Fantasia LTDA" }'

---

Excluir Empresa

DELETE /companies/{id}

Remove uma empresa do cadastro. Atenção: documentos fiscais emitidos permanecem no sistema.

curl -X DELETE "https://api.engineapi.com.br/companies/uuid" \
  -H "Authorization: Bearer seu-token"

Respostas

Status	Descrição
200	Operação realizada com sucesso
404	Empresa não encontrada