# Monitor de Sanções CEIS/CNEP — Empresas Punidas por CNPJ (`paulovitor18/ceis-cnep-delta-monitor-br`) Actor Monitora CEIS e CNEP por CNPJ e alerta quando um fornecedor entra, sai ou muda de status nos cadastros de sanção do governo federal. Delta entre execuções, match por CNPJ, dado oficial da CGU. Pague por resultado. - **URL**: https://apify.com/paulovitor18/ceis-cnep-delta-monitor-br.md - **Developed by:** [MoreLock](https://apify.com/paulovitor18) (community) - **Categories:** Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Monitor de Sanções CEIS/CNEP — Alerta de Empresas Punidas por CNPJ Vigie uma carteira de CNPJs e receba alerta quando uma empresa **entra, sai ou muda de status** nos cadastros oficiais de sanção do governo federal. Não é consulta pontual: é monitoramento contínuo do delta. ### O que ele faz Cruza a sua watchlist de CNPJs contra o **CEIS** (Cadastro de Empresas Inidôneas e Suspensas) e o **CNEP** (Cadastro Nacional de Empresas Punidas), publicados diariamente pela Controladoria-Geral da União no Portal da Transparência. A cada execução ele compara o estado de hoje com o da run anterior e reporta **só o que mudou** — sanção nova, sanção que caiu, ou mudança material (prazo, categoria, órgão). Rodando em agenda, vira um vigia de compliance de fornecedores que trabalha sozinho. Screening pontual você já encontra na Store. O que ninguém entrega é o **alerta de mudança** — e é exatamente para isso que este actor existe. ### Recursos - **Duas fontes oficiais num registro só:** CEIS + CNEP casados por CNPJ, com o cadastro de origem sempre explícito. - **Delta entre execuções:** ADDED (sanção nova), REMOVED (saiu da lista), MODIFIED (mudou prazo/status). A primeira run é a linha de base; as seguintes só reportam a diferença. - **Estado isolado por watchlist:** cada carteira mantém o próprio histórico — duas listas diferentes nunca cegam uma à outra. - **Match determinístico por CNPJ**, nunca por nome — homônimo não cola sanção errada. - **Honesto quando a fonte cai:** se o download da CGU falha, o actor não inventa "sem sanção" — marca `INDISPONIVEL_nao_verificado` e não cobra o screening. - **Agendável:** ligue um schedule diário/semanal e receba só os alertas materiais. ### Exemplo de entrada ```json { "watchCnpjs": ["13.582.233/0001-91", "47.960.950/0001-21"], "cadastro": "ambos", "mode": "auto" } ```` ### Exemplo de saída Um registro `snapshot` por CNPJ vigiado + um registro `change` por mudança detectada: ```json [ { "record_type": "snapshot", "cnpj": "13.582.233/0001-91", "status": "SANCIONADO", "risk": "CRITICAL", "cadastros_verificados": ["CEIS", "CNEP"], "sancoes": [ { "cadastro": "CEIS", "codigo_sancao": "106965", "categoria": "Declaração de Inidoneidade com prazo determinado", "orgao": "Governo do Estado da Bahia (BA)", "data_inicio": "16/01/2020", "data_final": null, "ativa": true } ], "first_seen": "2026-07-11T03:31:07Z", "is_baseline": true }, { "record_type": "snapshot", "cnpj": "47.960.950/0001-21", "status": "LIMPO", "risk": "NONE", "sancoes": [] }, { "record_type": "change", "cnpj": "13.582.233/0001-91", "change_type": "ADDED", "cadastro": "CEIS", "codigo_sancao": "106965" } ] ``` ### Parâmetros | Campo | Tipo | Default | O que faz | |---|---|---|---| | `watchCnpjs` | array | `[]` | CNPJs a vigiar (com ou sem pontuação). | | `cadastro` | enum | `ambos` | Quais bases varrer: `ceis`, `cnep` ou `ambos`. | | `stateStoreName` | string | *(derivado da watchlist)* | Nome do store de estado. Vazio = isola automático por hash da carteira; informe um nome para fixar o histórico de uma watchlist específica. | | `mode` | enum | `auto` | `auto` = baseline na 1ª run, delta nas seguintes; `baseline` força regravar a linha de base. | ### Dicas - **Agende** o actor (diário ou semanal) apontando para o mesmo `stateStoreName` — é o que transforma a consulta em monitor. - Uma watchlist por schedule. Se você vigia carteiras diferentes (clientes, fornecedores críticos, um setor), use um `stateStoreName` por carteira. - A base da CGU é substituída diariamente; rodar mais de uma vez no mesmo dia devolve delta vazio (nada a reportar) — é o comportamento correto. ### Casos de uso - **Compliance contínuo de fornecedores:** saiba no dia em que um fornecedor da sua base é declarado inidôneo. - **Onboarding e KYB:** trave o cadastro de quem já está sancionado antes de assinar contrato. - **Due diligence de M\&A:** monitore o alvo e a cadeia dele durante a negociação. - **Setor público / licitações:** acompanhe impedidos de licitar em tempo quase real. - **Crédito e factoring:** sanção é sinal de risco que antecede default. - **Auditoria e ESG:** rastro documental de quando cada mudança de status aconteceu. ### Perguntas frequentes **Qual a diferença para um "sanctions check" comum?** A consulta comum responde "esta empresa está sancionada agora?". Este actor responde "o que mudou na minha carteira desde a última vez?" — é monitoramento, não foto. **Preciso de token ou login da CGU?** Não. A fonte é dado aberto do Portal da Transparência, baixado direto. **O que acontece se a base do governo estiver fora do ar?** O actor reporta `INDISPONIVEL_nao_verificado` e preserva a linha de base. Ele nunca afirma "sem sanção" sem ter consultado a fonte — e não cobra o screening que não conseguiu fazer. **CEIS e CNEP são a mesma coisa?** Não. CEIS lista inidôneas e suspensas (impedidas de contratar/licitar); CNEP lista punidas pela Lei Anticorrupção. Este actor cobre as duas e diz de qual cadastro veio cada sanção. **E se o CNPJ não tiver nenhuma sanção?** Ele retorna status `LIMPO`. "Sem sanção" é uma resposta legítima — e não gera cobrança de alerta. **Casa por nome ou por CNPJ?** Só por CNPJ (dígitos). Nome nunca — para não colar a sanção de um homônimo na empresa errada. ### Preço Pague por resultado, com três eventos: | Evento | Preço | Quando cobra | |---|---|---| | Execução do monitor | US$ 0,15 | Uma vez por run (baixa e varre CEIS + CNEP). | | CNPJ verificado | US$ 0,04 | Por CNPJ da watchlist efetivamente checado. | | Mudança de sanção detectada | US$ 0,80 | Por mudança real (nova, saída ou alteração material). Nunca na linha de base. | Você só é cobrado pelo que o monitor entrega. **CNPJ limpo, documento inválido, watchlist vazia ou base fora do ar não geram cobrança de alerta** — a mudança de sanção, que é onde está o valor, só cobra quando de fato acontece. Exemplo: vigiar 30 fornecedores uma vez por semana, sem nenhuma mudança na semana, custa US$ 0,15 + 30 × US$ 0,04 = **US$ 1,35 por run**. Um alerta de inidoneidade nova adiciona US$ 0,80. ### Actors relacionados - [Consulta CNPJ em Lote — Dados da Receita Federal](https://apify.com/paulovitor18/cnpj-bulk-lookup) — situação cadastral, QSA, CNAE por CNPJ. - [Brazil Due Diligence — CNPJ Registry + Reclame Aqui](https://apify.com/paulovitor18/brazil-company-due-diligence) — registro + reputação num relatório. - [Certidões de Regularidade BR por CNPJ — FGTS + Trabalhista](https://apify.com/paulovitor18/certidoes-regularidade-br) — regularidade fiscal para editais. ### Changelog - **v1.0** — Lançamento: CEIS + CNEP, delta entre runs, estado isolado por watchlist, degradação honesta quando a fonte cai. ### Contato Problemas ou sugestões: abra uma issue na aba **Issues** do actor. # Actor input Schema ## `watchCnpjs` (type: `array`): Lista de CNPJs a monitorar nas bases CEIS/CNEP. Aceita com ou sem pontuacao. O casamento e feito SEMPRE por digitos do CNPJ, nunca por nome — nunca cola empresa homonima. Documento que nao tenha 14 digitos e ignorado (abstem, nao cobra). ## `cadastro` (type: `string`): ambos = CEIS (inidoneas/suspensas) + CNEP (empresas punidas Lei Anticorrupcao). Ou so um deles. ## `mode` (type: `string`): auto = primeira execucao vira baseline, seguintes reportam so o delta. baseline = forca re-emitir o estado completo e regravar o baseline. ## `stateStoreName` (type: `string`): Key-value store nomeado onde o baseline e guardado entre execucoes. Deixe VAZIO para derivar automaticamente um nome isolado por watchlist (recomendado). Informe um nome explicito so se quiser controlar/compartilhar o historico de delta entre execucoes do mesmo monitor. ## `debugForceSourceFail` (type: `string`): Uso interno de teste: simula queda da fonte para exercitar a degradacao graciosa. none|ceis|cnep|both. Nao usar em producao. ## Actor input object example ```json { "watchCnpjs": [ "13.582.233/0001-91", "47.960.950/0001-21" ], "cadastro": "ambos", "mode": "auto", "stateStoreName": "", "debugForceSourceFail": "none" } ``` # Actor output Schema ## `sancoes` (type: `string`): Itens emitidos nesta execucao: um snapshot por CNPJ vigiado + um item por mudanca de sancao detectada (ADDED/REMOVED/MODIFIED), no formato descrito em dataset\_schema.json. ## `resumo` (type: `string`): Contadores da execucao: CNPJs vigiados, invalidos, mudancas reais, bases verificadas e datas das fontes. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "watchCnpjs": [ "13.582.233/0001-91", "47.960.950/0001-21" ] }; // Run the Actor and wait for it to finish const run = await client.actor("paulovitor18/ceis-cnep-delta-monitor-br").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "watchCnpjs": [ "13.582.233/0001-91", "47.960.950/0001-21", ] } # Run the Actor and wait for it to finish run = client.actor("paulovitor18/ceis-cnep-delta-monitor-br").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "watchCnpjs": [ "13.582.233/0001-91", "47.960.950/0001-21" ] }' | apify call paulovitor18/ceis-cnep-delta-monitor-br --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=paulovitor18/ceis-cnep-delta-monitor-br", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Monitor de Sanções CEIS/CNEP — Empresas Punidas por CNPJ", "description": "Monitora CEIS e CNEP por CNPJ e alerta quando um fornecedor entra, sai ou muda de status nos cadastros de sanção do governo federal. Delta entre execuções, match por CNPJ, dado oficial da CGU. Pague por resultado.", "version": "1.0", "x-build-id": "tNaUhH4LnppJsMwEn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/paulovitor18~ceis-cnep-delta-monitor-br/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-paulovitor18-ceis-cnep-delta-monitor-br", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/paulovitor18~ceis-cnep-delta-monitor-br/runs": { "post": { "operationId": "runs-sync-paulovitor18-ceis-cnep-delta-monitor-br", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/paulovitor18~ceis-cnep-delta-monitor-br/run-sync": { "post": { "operationId": "run-sync-paulovitor18-ceis-cnep-delta-monitor-br", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "watchCnpjs" ], "properties": { "watchCnpjs": { "title": "CNPJs a vigiar", "type": "array", "description": "Lista de CNPJs a monitorar nas bases CEIS/CNEP. Aceita com ou sem pontuacao. O casamento e feito SEMPRE por digitos do CNPJ, nunca por nome — nunca cola empresa homonima. Documento que nao tenha 14 digitos e ignorado (abstem, nao cobra).", "default": [ "13.582.233/0001-91", "47.960.950/0001-21" ], "items": { "type": "string" } }, "cadastro": { "title": "Cadastro(s) a consultar", "enum": [ "ambos", "ceis", "cnep" ], "type": "string", "description": "ambos = CEIS (inidoneas/suspensas) + CNEP (empresas punidas Lei Anticorrupcao). Ou so um deles.", "default": "ambos" }, "mode": { "title": "Modo de execucao", "enum": [ "auto", "baseline" ], "type": "string", "description": "auto = primeira execucao vira baseline, seguintes reportam so o delta. baseline = forca re-emitir o estado completo e regravar o baseline.", "default": "auto" }, "stateStoreName": { "title": "Nome do armazenamento de estado (delta)", "type": "string", "description": "Key-value store nomeado onde o baseline e guardado entre execucoes. Deixe VAZIO para derivar automaticamente um nome isolado por watchlist (recomendado). Informe um nome explicito so se quiser controlar/compartilhar o historico de delta entre execucoes do mesmo monitor.", "default": "" }, "debugForceSourceFail": { "title": "(interno) forcar falha de download", "enum": [ "none", "ceis", "cnep", "both" ], "type": "string", "description": "Uso interno de teste: simula queda da fonte para exercitar a degradacao graciosa. none|ceis|cnep|both. Nao usar em producao.", "default": "none" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```