{
    "tipo": "arvore-sa",
    "nome": "api",
    "criadoEm": "2026-08-03T14:15:44Z",
    "atualizadoEm": "2026-08-12T09:32:48Z",
    "filhos": [
        {
            "nome": "Visão geral [uso descricao grupos]",
            "filhos": [
                {
                    "nome": "Uso",
                    "filhos": [
                        {
                            "nome": "pp --api=<idmensagem> --dados=<json|arquivo> [opcoes]",
                            "filhos": []
                        },
                        {
                            "nome": "pp --api --ajuda:<grupo>",
                            "filhos": []
                        }
                    ]
                },
                {
                    "nome": "Descrição",
                    "filhos": [
                        {
                            "nome": "Publica uma chamada da API declarativa do SISC no espaco nativo. Consulta web-api/catalogo-mensagens.json, resolve o destino e grava uma mensagem válida em espaco/entrada para a escuta.c entregar.",
                            "filhos": []
                        }
                    ]
                },
                {
                    "nome": "Grupos de ajuda",
                    "filhos": [
                        {
                            "nome": "uso",
                            "filhos": []
                        },
                        {
                            "nome": "dados",
                            "filhos": []
                        },
                        {
                            "nome": "protocolo",
                            "filhos": []
                        },
                        {
                            "nome": "catalogo",
                            "filhos": []
                        },
                        {
                            "nome": "exemplos",
                            "filhos": []
                        }
                    ]
                }
            ]
        },
        {
            "nome": "Uso e ajuda [uso ajuda]",
            "filhos": [
                {
                    "nome": "--ajuda, --help, -h            Exibe esta ajuda completa",
                    "filhos": []
                },
                {
                    "nome": "--ajuda:<grupo>                 Abre esta árvore com procura destacada. Ex: pp --api --ajuda:uso",
                    "filhos": []
                },
                {
                    "nome": "--ajuda=<grupo>                Forma equivalente",
                    "filhos": []
                }
            ]
        },
        {
            "nome": "Dados de entrada [dados entrada]",
            "filhos": [
                {
                    "nome": "--dados='<json>'               JSON inline para payload.dados",
                    "filhos": []
                },
                {
                    "nome": "--dados=arquivo.json           Atalho para ler dados de um arquivo JSON",
                    "filhos": []
                },
                {
                    "nome": "--dados-arquivo=arquivo.json   Arquivo JSON explícito Se o JSON tiver {'idmensagem'",
                    "filhos": []
                },
                {
                    "nome": "'001', 'dados'...}, dados vira payload.dados.",
                    "filhos": []
                },
                {
                    "nome": "Exemplo com todas as flags do grupo (duas formas, --dados e --dados-arquivo são mutuamente exclusivos)",
                    "filhos": [
                        {
                            "nome": "pp --api=001 --dados='{cpf:123}'",
                            "filhos": []
                        },
                        {
                            "nome": "pp --api=001 --dados-arquivo=cliente.json",
                            "filhos": []
                        }
                    ]
                }
            ]
        },
        {
            "nome": "Protocolo da mensagem [protocolo mensagem]",
            "filhos": [
                {
                    "nome": "--origem=<entidade>            Origem SISC (padrão: SISC_API_ORIGEM ou sistema__api)",
                    "filhos": []
                },
                {
                    "nome": "--processo-id=<id>             Define processoId; se ausente, gera automaticamente",
                    "filhos": []
                },
                {
                    "nome": "--mensagem-id=<id>             Define mensagemId; se ausente, gera automaticamente",
                    "filhos": []
                },
                {
                    "nome": "--resposta-a=<id>              Define _protocolo.respostaA",
                    "filhos": []
                },
                {
                    "nome": "--idempotencia=<chave>         Define _protocolo.idempotencia.chave",
                    "filhos": []
                },
                {
                    "nome": "--prioridade=<baixa|normal|alta|critica>",
                    "filhos": []
                },
                {
                    "nome": "--tipo=<solicitacao|resposta|evento|erro|comando|consulta>",
                    "filhos": []
                },
                {
                    "nome": "--dry-run                      Imprime a mensagem gerada sem gravar no espaco",
                    "filhos": []
                },
                {
                    "nome": "Exemplo com todas as flags do grupo",
                    "filhos": [
                        {
                            "nome": "pp --api=001 --dados='{cpf:123}' --origem=agente__x --processo-id=proc-1 --mensagem-id=msg-1 --resposta-a=msg-0 --idempotencia=chave12345 --prioridade=alta --tipo=solicitacao --dry-run",
                            "filhos": []
                        }
                    ]
                }
            ]
        },
        {
            "nome": "Catálogo e regras [catalogo regras]",
            "filhos": [
                {
                    "nome": "web-api/catalogo-mensagens.json deve mapear idmensagem para destino SISC.",
                    "filhos": []
                },
                {
                    "nome": "Mensagens publicas, comandos e prioridade critica devem declarar idempotenciaObrigatoria=true e correlacaoObrigatoria=true.",
                    "filhos": []
                },
                {
                    "nome": "Destinos aceitos agente__id, conector__id ou sistema__id.",
                    "filhos": [
                        {
                            "nome": "pp --api nunca executa arquivo, URL, agente ou conector diretamente.",
                            "filhos": []
                        }
                    ]
                }
            ]
        },
        {
            "nome": "Exemplos [exemplos]",
            "filhos": [
                {
                    "nome": "pp --api=001 --dados='{cpf:12345678900}' --origem=agente__solicitante",
                    "filhos": []
                },
                {
                    "nome": "pp --api=001 --dados-arquivo=cliente-dados.json --origem=conector__web",
                    "filhos": []
                },
                {
                    "nome": "pp --api=001 --dados='{ok:true}' --dry-run",
                    "filhos": []
                }
            ]
        }
    ]
}