Radar
O Radar é a solução da WebApiAlcance que integra a plataforma ao Integra Contador do Serpro, cobrindo os domínios Simples Nacional (SN), DCTFWeb e MIT (Módulo de Inclusão de Tributos). Cada endpoint atua como um proxy autenticado sobre o Serpro: a WebApi valida o payload, injeta o contratante e o autor (fixos via .env), repassa a chamada e devolve a resposta no envelope padrão da plataforma.
Além das operações unitárias por CNPJ, a solução oferece automações em lote que percorrem um CNPJ ou toda a carteira interna (usar_lista_interna) por competência: emissão e coleta de guias, download de recibos de transmissão e confirmação de pagamentos (PAGTOWEB), com os PDFs persistidos em disco. O grupo /integra-contador/* compartilha o mesmo recurso de escopo integra_contador, derivado do primeiro segmento da rota.
A superfície DCTFWeb foi consolidada em `/api/v1/dctfweb`
Guias, recibos, emissão em lote, catálogos e a transmissão da DCTFWeb agora vivem sob o prefixo único /api/v1/dctfweb, com os escopos dctfweb:read / dctfweb:write. Os caminhos antigos (/dctfweb-guias, /dctfweb-recibos, /integra-contador/radar/guias, /integra-contador/radar/recibos) continuam funcionando como alias deprecado e serão removidos numa versão futura.
Comece por DCTFWeb: visão geral, que traz o mapa de migração rota a rota. /integra-contador/sn, /dctf, /mit e /radar/pagamentos não mudaram.
A transmissão da declaração (/dctfweb/transmissao, /dctfweb/situacao) nasceu no prefixo novo e não tem caminho legado - as rotas antigas POST /integra-contador/dctf/transmitir e .../consultar-xml foram removidas, sem alias.
A emissão sob demanda (POST /dctfweb/emissao/guias/emitir) também nasceu ali, sem alias: é a única rota de emissão em que os sistemas de origem da guia são escolhidos por quem chama.
Autenticação e envelope
Todos os endpoints exigem Authorization: Bearer <API_KEY> com os escopos apropriados. A maioria responde no envelope padrão { status, message, data } - as rotas de emissão em lote são exceção e devolvem o objeto direto. Veja Autenticação e Conceitos.