Empresas
Listar empresas
Lista las empresas de su cuenta con estado de análisis y resumen del certificado.
GET
/openapi/v2/empresasRequiere las cabeceras de firma
token, timestamp y sign, vea Autenticación.Devuelve solo las empresas de la cuenta de integrador dueña de la aplicación, de la más reciente a la más antigua. Úselo para recuperar el empresaId de empresas ya registradas y seguir el análisis sin abrir la consola. Para los tipos de documento habilitados, la dirección y las fechas de análisis consulte Consultar empresa. Usa la misma suscripción de interfaz que Registrar empresa y no se cobra.
Parámetros de consulta
cnpj | string | CNPJ |
status | string | Filtro de estado |
nome | string | Nombre |
pagina | int | Página |
tamanho | int | Tamaño de página |
* Campo obligatorio
200
Una página de empresas. Sin coincidencias,
itens es un array vacío.pagina | int | Página devuelta |
tamanho | int | Tamaño de página aplicado |
total | int | Total de empresas |
totalLimitado | bool | Total limitado |
| array | Empresas de la página |
statusEstado de la empresa
Mismos valores para el filtro y para itens[].status.
| Valores | Significado |
|---|---|
| Rascunho | Guardada y todavía no enviada a análisis; camposPendentes lista lo que falta |
| AguardandoAprovacao | En análisis por la plataforma; todavía no puede emitir |
| Ativa | Aprobada; puede emitir cuando haya un certificado válido |
| Rejeitada | Rechazada en el análisis; motivoStatus trae el motivo. Corrija y reenvíe por la consola; si tenía campos en camposPendentes, completarlos con Registrar empresa (cuerpo con id) la devuelve a análisis manual |
| Inativa | Desactivada; no emite hasta reactivarse en la consola |
itens[].ambienteEmissaoAmbiente
| Valores | Significado |
|---|---|
| Homologacao | Homologación (pruebas); predeterminado de toda empresa recién registrada |
| Producao | Producción; el cambio lo hace la operación de la plataforma |
itens[].certificado.statusEstado del certificado
| Valores | Significado |
|---|---|
| Nenhum | Ningún certificado vinculado |
| Valido | Certificado vigente |
| ProximoVencimento | Vigente pero vence pronto; todavía emite |
| Vencido | Vencido; vincule un nuevo certificado para volver a emitir |
| Código | HTTP | |
|---|---|---|
| 10001001 | 400 | status fuera de la enumeración, cnpj inválido, o pagina / tamanho fuera de rango. |
