Docs/Empresas
Empresas
Cadastre e gerencie empresas (CNPJ) da sua assinatura. Cada empresa é um CNPJ operacional (certificado, emissão e cadastros) — billing e chaves de API ficam na assinatura/conta. O certificado digital A1 pode ser necessário para NF-e e, em algumas prefeituras, NFS-e — seu envio não é obrigatório na criação.
Ver requisitos de autenticaçãoHeaders
X-Api-Key
stringobrigatórioChave de API da assinatura/conta.
X-Api-Secret
stringobrigatórioSegredo da chave de API.
Content-Type
stringobrigatórioapplication/json
curl -X GET "https://api.emitfy.com/v1/companies" \
-H "X-Api-Key: SUA_API_KEY" \
-H "X-Api-Secret: SUA_API_SECRET"{
"ok": true,
"data": [
{
"id": "018f6e3b-0000-0000-0000-000000000000",
"taxId": "12.345.678/0001-90",
"legalName": "EMPRESA EXEMPLO LTDA",
"tradeName": "Empresa Exemplo"
}
]
}{
"ok": false,
"code": "VALIDATION_ERROR",
"message": "Um ou mais campos falharam na validação de entrada.",
"statusCode": 422
}Headers
X-Api-Key
stringobrigatórioChave de API da assinatura/conta.
X-Api-Secret
stringobrigatórioSegredo da chave de API.
Content-Type
stringobrigatórioapplication/json
Parâmetros do body
taxId
stringobrigatórioCNPJ da empresa.
legalName
stringobrigatórioRazão social.
tradeName
stringopcionalNome fantasia.
E-mail de contato.
curl -X POST "https://api.emitfy.com/v1/companies" \
-H "X-Api-Key: SUA_API_KEY" \
-H "X-Api-Secret: SUA_API_SECRET" \
-H "Content-Type: application/json" \
-d '{
"taxId": "12.345.678/0001-90",
"legalName": "EMPRESA EXEMPLO LTDA",
"tradeName": "Empresa Exemplo",
"email": "[email protected]"
}'{
"ok": true,
"data": {
"id": "018f6e3b-0000-0000-0000-000000000000",
"taxId": "12.345.678/0001-90",
"legalName": "EMPRESA EXEMPLO LTDA",
"tradeName": "Empresa Exemplo",
"email": "[email protected]",
"createdAt": "2026-07-06T10:28:00.000Z"
}
}{
"ok": false,
"code": "VALIDATION_ERROR",
"message": "Um ou mais campos falharam na validação de entrada.",
"statusCode": 422
}Headers
X-Api-Key
stringobrigatórioChave de API da assinatura/conta.
X-Api-Secret
stringobrigatórioSegredo da chave de API.
Content-Type
stringobrigatórioapplication/json
Parâmetros de rota
id
string (UUID)obrigatórioIdentificador único da empresa.
Parâmetros do body
tradeName
stringopcionalNome fantasia.
E-mail de contato.
curl -X PUT "https://api.emitfy.com/v1/companies/018f6e3b-0000-0000-0000-000000000000" \
-H "X-Api-Key: SUA_API_KEY" \
-H "X-Api-Secret: SUA_API_SECRET" \
-H "Content-Type: application/json" \
-d '{ "tradeName": "Novo Nome Comercial" }'{
"ok": true,
"data": {
"id": "018f6e3b-0000-0000-0000-000000000000",
"taxId": "12.345.678/0001-90",
"legalName": "EMPRESA EXEMPLO LTDA",
"tradeName": "Empresa Exemplo",
"email": "[email protected]",
"createdAt": "2026-07-06T10:28:00.000Z"
}
}{
"ok": false,
"code": "VALIDATION_ERROR",
"message": "Um ou mais campos falharam na validação de entrada.",
"statusCode": 422
}Headers
X-Api-Key
stringobrigatórioChave de API da assinatura/conta.
X-Api-Secret
stringobrigatórioSegredo da chave de API.
Content-Type
stringobrigatórioapplication/json
Parâmetros de rota
id
string (UUID)obrigatórioIdentificador único da empresa.
curl -X DELETE "https://api.emitfy.com/v1/companies/018f6e3b-0000-0000-0000-000000000000" \
-H "X-Api-Key: SUA_API_KEY" \
-H "X-Api-Secret: SUA_API_SECRET"{
"ok": true,
"data": {
"id": "018f6e3b-0000-0000-0000-000000000000",
"deleted": true
}
}{
"ok": false,
"code": "VALIDATION_ERROR",
"message": "Um ou mais campos falharam na validação de entrada.",
"statusCode": 422
}Headers
X-Api-Key
stringobrigatórioChave de API da assinatura/conta.
X-Api-Secret
stringobrigatórioSegredo da chave de API.
Content-Type
stringobrigatóriomultipart/form-data
Parâmetros do body
file
file (.pfx)obrigatórioArquivo do certificado A1.
password
stringobrigatórioSenha do certificado.
curl -X POST "https://api.emitfy.com/v1/company/certificate" \
-H "X-Api-Key: SUA_API_KEY" \
-H "X-Api-Secret: SUA_API_SECRET" \
-F "[email protected]" \
-F "password=senha123"{
"ok": true,
"data": {
"companyId": "018f6e3b-0000-0000-0000-000000000000",
"certificate": {
"expiresAt": "2027-07-06T00:00:00.000Z",
"uploadedAt": "2026-07-06T10:28:00.000Z"
}
}
}{
"ok": false,
"code": "VALIDATION_ERROR",
"message": "Um ou mais campos falharam na validação de entrada.",
"statusCode": 422
}