Cadastrar empresa, token e consumo

Cadastrar empresa chave aca_

POST /empresas

Cadastra a empresa do seu cliente e retorna o token dela (data.token) — exibido só nesta resposta. Guarde cifrado.

Campo	Tipo
`cnpj`	string	obrigatório
`razao_social`	string	obrigatório
`uf`	string(2)	opcional
`email, telefone, nome_fantasia`	string	opcional
`produtos`	string[]	já vincula

Requisição

curl -X POST .../api/v1/empresas \
  -H "Authorization: Bearer aca_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "cnpj": "11222333000181",
    "razao_social": "CLIENTE EXEMPLO LTDA",
    "uf": "MG",
    "produtos": ["fiscal","nfe","nfce"]
  }'

$dev = new Client('aca_SUA_CHAVE');
$emp = $dev->empresas()->criar([
  'cnpj'=>'11222333000181',
  'razao_social'=>'CLIENTE EXEMPLO LTDA',
  'uf'=>'MG',
  'produtos'=>['fiscal','nfe','nfce'],
]);
$token = $emp['token']; // guarde!

P := TJSONObject.Create;
P.AddPair('cnpj', '11222333000181');
P.AddPair('razao_social', 'CLIENTE EXEMPLO LTDA');
R := DevApi.CriarEmpresa(P);
Token := R.Str('token'); // guarde!

201 · data

{ "id": 12, "status": "ativa",
  "produtos": [ ... ],
  "token": "ace_9f2c...(48 hex)" }

Listar & atualizar chave aca_

GET /empresas ?pagina=1

GET /empresas/{id}

PUT /empresas/{id}

Lista (50/página) com produtos e prefixo do token; detalha; e atualiza razao_social, nome_fantasia, email, telefone, uf, status (ativa|inativa).

Requisição

curl .../api/v1/empresas?pagina=1 \
  -H "Authorization: Bearer aca_SUA_CHAVE"

$lista = $dev->empresas()->listar(1);
$uma   = $dev->empresas()->obter(12);
$dev->empresas()->atualizar(12, ['status'=>'inativa']);

R := DevApi.ListarEmpresas(1);
Arr := R.Arr('empresas');

Regenerar token chave aca_

POST /empresas/{id}/token

Gera um novo token ace_ e revoga o anterior. Use se o token vazar ou for perdido.

Requisição

curl -X POST .../api/v1/empresas/12/token \
  -H "Authorization: Bearer aca_SUA_CHAVE"

$novo = $dev->empresas()->regenerarToken(12);

R := DevApi.RegenerarToken(12);

Vincular / suspender produto chave aca_

POST /empresas/{id}/produtos/{codigo}

DELETE /empresas/{id}/produtos/{codigo}

{codigo}: fiscal, cnpj, whatsapp, nfe, nfce, mdfe, cte, dce. POST vincula; DELETE suspende.

Requisição

curl -X POST .../api/v1/empresas/12/produtos/nfe \
  -H "Authorization: Bearer aca_SUA_CHAVE"

$dev->empresas()->vincularProduto(12, 'nfe');
$dev->empresas()->suspenderProduto(12, 'nfe');

DevApi.VincularProduto(12, 'nfe').Free;

Conta & consumo chave aca_

GET /conta

GET /consumo ?mes=YYYY-MM&empresa_id=N

Consumo do mês agregado por produto e por empresa — base para o seu faturamento.

Requisição

curl .../api/v1/consumo?mes=2026-07 \
  -H "Authorization: Bearer aca_SUA_CHAVE"

$uso = $dev->empresas()->consumo('2026-07');

R := DevApi.Consumo('2026-07');