RPA 1.0.0 • FISCAL • PLAYWRIGHT

Declaração Eletrônica de Conformidade automatizada

Automação para criação, retomada, envio e reimpressão da DEC do Município de Porto Alegre, com geração de PDF e execução controlada pelo PES2B Agent.

Ver entrada Contrato via Agent

A automação não possui API própria. O endpoint exibido no Swagger pertence ao PES2B Agent.

PROCESSAMENTO

Fluxo de decisão

Login

Acessa o DEC Web.

Declarante

Seleciona por IM ou CNPJ.

Competência

Identifica o estado atual.

Enviar ou reimprimir

Executa o caminho apropriado.

PDF

Baixa declaração e recibo.

AMBIENTE

Requisitos

Node.js 20 ou superior.
Playwright e Chromium instalados.
Acesso válido ao portal DEC Web.
PES2B Agent v1.1.0 ou superior para execução orquestrada.

ENTRADA

Payload

{
  "empresas": [
    {
      "razaoSocial": "EMPRESA EXEMPLO LTDA",
      "cnpj": "00000000000000",
      "senha": "senha-do-portal",
      "inscricaoMunicipal": "00000000",
      "competenciaAno": "2026",
      "competenciaMes": "01"
    }
  ],
  "headless": false,
  "slowMo": 300
}

Credenciais: nunca registre senhas em Git, prints, logs ou workflows exportados.

ESTADOS

Modos de processamento

Modo	Condição	Ação
`REPRINT`	Competência já enviada.	Reimprime declaração e recibo.
`RESUMED_AND_SENT`	Competência existente e aberta.	Retoma, envia e imprime.
`CREATED_AND_SENT`	Competência inexistente.	Cria, envia e imprime.

RESULTADO

Saída estruturada

{
  "success": true,
  "total": 1,
  "succeeded": 1,
  "failed": 0,
  "items": [
    {
      "success": true,
      "cnpj": "00000000000000",
      "competencia": "01/2026",
      "download": "downloads/empresa__01-2026_declaracao_recibo.pdf",
      "mode": "REPRINT"
    }
  ]
}

ORQUESTRAÇÃO

Execução pelo PES2B Agent

curl -X POST 'http://127.0.0.1:3000/api/v1/automations/dec-poa/run' \
  -H 'Content-Type: application/json' \
  -H 'X-PES2B-API-KEY: SUA_CHAVE' \
  -d @payload.json

O Agent cria um job assíncrono. O n8n deve consultar o job até SUCCEEDED ou FAILED.

ARTEFATOS

PDFs gerados

O pacote registra a declaração e o recibo como artefato PDF. O arquivo pode ser listado e baixado pelos endpoints de arquivos do Agent.

OPERAÇÃO

Diagnóstico

Processamento sequencial de empresas.
Timeout padrão do pacote: 10 minutos.
Execução singleton com fila.
Retorno final em linha PES2B_RESULT_JSON=.

FALHAS

Tratamento de erros

Cada empresa possui resultado individual. Uma falha não deve eliminar a rastreabilidade dos itens já processados. Consulte o job, logs do pacote e arquivos de diagnóstico autorizados.

SEGURANÇA

Dados sensíveis

Não versionar empresas.json.
Não registrar senhas reais.
Não publicar PDFs de clientes.
Ignorar downloads, runtime, logs e temp.

ARQUIVOS

Downloads

Documentação Markdown Contrato OpenAPI Postman