---
title: "O que falta para a empresa emitir"
method: GET
path: "/v1/companies/{id}/prontidao"
tags: ["Empresas"]
---

# O que falta para a empresa emitir

`GET /v1/companies/{id}/prontidao`

## Request

- Base URL: `https://api.sudrel.com.br/api`
- URL: `https://api.sudrel.com.br/api/v1/companies/{id}/prontidao`
- Auth: HTTP bearer

A mesma checagem que `POST /v1/nfse` faz antes de criar a nota.
Cada item vem com `situacao`:

- `bloqueio`: a emissão é recusada com **412** até resolver.
- `aviso`: emite, mas vale olhar (certificado vencendo, alíquota
  oficial do município ainda não conhecida para um código de serviço).
- `ok`.

Com a chave de sandbox (`sdr_test_`) a resposta é a do ambiente de
teste: plano de Emissão não é exigido, e empresa que emite pelo
sistema da prefeitura é `bloqueio` (a prefeitura não tem ambiente
de teste). O webhook `EMPRESA_PRONTIDAO_ALTERADA` avisa quando um
item muda.

## Path parameters

- `id` string, required

## Response `200`

OK

- object
  - `empresa_id` string
  - `ambiente` 'producao' | 'sandbox'
  - `situacao` 'ok' | 'aviso' | 'bloqueio': A pior situação entre os itens.
  - `itens` ItemProntidao[]
    - `item` 'certificado' | 'convenio_municipio' | 'regime_tributario' | 'regime_apuracao_simples' | 'municipio_emissao' | 'serie_dps' | 'padroes_emissao' | 'plano_emissao' | 'parametros_municipais' | 'sandbox_municipio_proprio' | 'nbs' | 'reducao_ibs_cbs' | 'token_municipio': Estável. Novos itens podem aparecer.
    - `situacao` 'ok' | 'aviso' | 'bloqueio'
    - `mensagem` string
    - `correcao` string, nullable
  - `verificado_em` string, date-time

## Other responses

- `401`: Chave de API ausente, inválida ou revogada.
- `404`: Recurso não encontrado nesta conta.
- `429`: 120 requisições por minuto por chave excedidas (janela fixa de 60 s, alinhada ao relógio). Sem cabeçalho `Retry-After`: espere a virada do minuto. Nas rotas de conta, empresas e documentos o corpo é este; nas de emissão, lote, webhooks e eventos é problem+json `limite_de_requisicoes`.

---

[API](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e.md) · [All operations](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e/llms.txt) · [OpenAPI document](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e/revisions/efd7baba9e37?raw)