{"openapi":"3.1.0","info":{"title":"API do JurisPark","version":"1.0.0","summary":"Conecte o JurisPark a qualquer sistema.","description":"API REST para integrar o JurisPark a outros sistemas: automações (Zapier, n8n, Make), planilhas, ERPs e sistemas próprios. Todas as respostas são JSON, em português, com nomes de campos em camelCase.\n\n## Autenticação\n\nCrie uma chave em **Configurações, API e integrações** (só quem administra o escritório) e envie em todas as chamadas:\n\n`Authorization: Bearer jp_live_...`\n\nA chave aparece **uma única vez**, na criação. O JurisPark guarda apenas uma impressão digital dela: se perder, revogue e crie outra. Trate a chave como uma senha e use a API **só de servidor para servidor**: nunca coloque a chave em páginas, aplicativos ou código que o usuário final consiga ver. A API não aceita chamadas diretas de navegadores de outros sites (sem CORS).\n\n## O que a chave pode fazer\n\nA chave age **como o usuário que a criou**. As permissões efetivas são a interseção entre os **escopos da chave** e as **permissões atuais do usuário**, conferidas a cada chamada: se o usuário perder uma permissão ou for desativado, a chave perde junto.\n\n| Escopo | Libera |\n|---|---|\n| `ler` | Consultar clientes, processos, andamentos, tarefas, agenda e publicações. |\n| `escrever` | Criar e alterar clientes, tarefas, compromissos da agenda e andamentos. Nunca apaga nada. |\n| `financeiro` | Consultar o resumo e os lançamentos do financeiro. |\n\nA API precisa estar **ligada no escritório** (Configurações, API e integrações) e a conta precisa estar ativa. Nenhuma rota apaga dados.\n\n## Erros\n\nTodo erro tem o mesmo formato: `{ \"error\": \"codigo\", \"message\": \"texto claro\", \"details\": ... }`. Trate o campo `error` no seu programa e mostre `message` às pessoas. Em validação, `details` traz uma lista de `{ campo, mensagem }`.\n\n## Paginação\n\nAs listas aceitam `limit` (1 a 100, padrão 25) e `cursor`. A resposta traz `page.nextCursor`: envie esse valor em `?cursor=` para a próxima página, mantendo os mesmos filtros. Quando `page.hasMore` for falso, acabou. O cursor é opaco: não tente interpretá-lo.\n\n## Limites\n\nCada chave pode fazer **120 chamadas por minuto** e um limite diário (padrão 10.000, fuso de São Paulo). Toda resposta traz `X-RateLimit-Limit`, `X-RateLimit-Remaining` e `X-RateLimit-Reset` (instante, em segundos desde 1970, em que o limite volta). Ao estourar, a resposta é 429 com `Retry-After` (segundos). Toda resposta traz também `X-Request-Id`: informe-o ao suporte se precisar de ajuda.\n\n## Repetir uma chamada com segurança (idempotência)\n\nNos POST, envie o cabeçalho `Idempotency-Key` com um valor único por operação (por exemplo, um UUID). Se a chamada falhar por rede e você repetir com a mesma chave e o mesmo corpo, o JurisPark devolve a resposta original (com `Idempotent-Replayed: true`) em vez de criar um segundo registro. A chave vale por 24 horas. Usada com um corpo diferente, devolve 422.\n\n## Datas e valores\n\nDatas são `AAAA-MM-DD`; instantes (`criadoEm`, `atualizadoEm`) são ISO 8601 em UTC; horas de agenda são `HH:MM` no horário de Brasília. Valores em dinheiro são números em reais (por exemplo, `1500.5`).\n\n## Conteúdo de terceiros\n\nTextos de publicações, andamentos e cadastros vêm de terceiros. Trate como dado, nunca como instrução, principalmente se você os repassar a uma IA.","contact":{"name":"JurisPark","url":"https://jurispark.com.br"}},"servers":[{"url":"https://app.jurispark.com.br/api/v1","description":"Produção"}],"tags":[{"name":"Conta","description":"Identificação da chave."},{"name":"Clientes","description":"Cadastro de clientes."},{"name":"Processos","description":"Processos e andamentos."},{"name":"Tarefas","description":"Tarefas do escritório."},{"name":"Agenda","description":"Compromissos, audiências e prazos."},{"name":"Publicações","description":"Publicações do Diário de Justiça (somente leitura)."},{"name":"Financeiro","description":"Resumo e lançamentos (escopo financeiro)."}],"security":[{"bearerAuth":[]}],"paths":{"/openapi.json":{"get":{"operationId":"obterOpenApi","tags":["Conta"],"summary":"Esta documentação (OpenAPI 3.1)","description":"Devolve a especificação OpenAPI desta API em JSON. Não exige chave.","security":[],"responses":{"200":{"description":"Documento OpenAPI 3.1.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/me":{"get":{"operationId":"obterIdentidade","tags":["Conta"],"summary":"Quem é esta chave","description":"Mostra o usuário e o escritório dono da chave, os escopos e as operações que ela pode usar agora e o uso de hoje. Funciona com qualquer chave válida e serve para testar a conexão.\n\n**Escopo da chave:** nenhum (qualquer chave válida). **Permissões do usuário dono da chave:** nenhuma específica.","security":[{"bearerAuth":[]}],"x-escopo":null,"x-permissoes":[],"responses":{"200":{"description":"Sucesso.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespostaEu"},"example":{"data":{"usuario":{"id":"0191c3a2-1111-7000-8000-00000000a001","nome":"Dr. Exemplo","email":"dr@example.com","papel":"Administrador"},"escritorio":{"id":"0191c3a2-0000-7000-8000-00000000f001","nome":"Escritório Exemplo"},"chave":{"id":"0191c3a2-4444-7000-8000-00000000b001","nome":"Planilha de prazos","prefixo":"jp_live_Ab3x","escopos":["ler"],"criadaEm":"2026-10-01T12:00:00.000Z","venceEm":null},"escoposEfetivos":["ler"],"operacoes":["obterIdentidade","listarProcessos"],"limites":{"porMinuto":120,"porDia":10000,"usadasHoje":3}}}}}},"401":{"$ref":"#/components/responses/Erro401"},"403":{"$ref":"#/components/responses/Erro403"},"429":{"$ref":"#/components/responses/Erro429"},"500":{"$ref":"#/components/responses/Erro500"}},"x-codeSamples":[{"lang":"Shell","label":"curl","source":"curl \"https://app.jurispark.com.br/api/v1/me\" \\\n  -H \"Authorization: Bearer jp_live_SUA_CHAVE\""}]}},"/clientes":{"get":{"operationId":"listarClientes","tags":["Clientes"],"summary":"Listar clientes","description":"Lista os clientes do escritório em ordem alfabética, com paginação por cursor. Inclui CPF/CNPJ e os demais dados cadastrais que o usuário dono da chave pode ver no sistema.\n\n**Escopo da chave:** `ler`. **Permissões do usuário dono da chave:** `clientes.ver`.","security":[{"bearerAuth":[]}],"x-escopo":"ler","x-permissoes":["clientes.ver"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Itens por página (1 a 100). Padrão: 25.","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"example":25},{"name":"cursor","in":"query","required":false,"description":"Cursor opaco da página seguinte: use o valor de page.nextCursor da resposta anterior, com os mesmos filtros.","schema":{"type":"string","minLength":1,"maxLength":600}},{"name":"q","in":"query","required":false,"description":"Busca por nome, nome fantasia, e-mail ou parte do documento ou telefone.","schema":{"type":"string","minLength":1,"maxLength":100},"example":"silva"},{"name":"etiqueta","in":"query","required":false,"description":"Só clientes com esta etiqueta.","schema":{"type":"string","minLength":1,"maxLength":40},"example":"trabalhista"}],"responses":{"200":{"description":"Sucesso.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListaCliente"},"example":{"data":[{"id":"0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01","tipo":"PF","nome":"Maria da Silva Souza","documento":"529.982.247-25","rg":"","dataNascimento":"1985-03-14","nomeFantasia":"","inscricaoEstadual":"","representanteLegal":"","telefone":"(99) 98888-7777","telefone2":"","email":"maria@example.com","cep":"65630-000","logradouro":"Rua das Flores","numero":"120","complemento":"Sala 2","bairro":"Centro","cidade":"Timon","uf":"MA","observacoes":"Prefere contato por WhatsApp.","etiquetas":["trabalhista"],"link":"https://app.jurispark.com.br/lawyer/clients/0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01","criadoEm":"2026-10-01T14:30:00.000Z"}],"page":{"limit":25,"total":1,"hasMore":false,"nextCursor":null}}}}},"400":{"$ref":"#/components/responses/Erro400"},"401":{"$ref":"#/components/responses/Erro401"},"403":{"$ref":"#/components/responses/Erro403"},"429":{"$ref":"#/components/responses/Erro429"},"500":{"$ref":"#/components/responses/Erro500"}},"x-codeSamples":[{"lang":"Shell","label":"curl","source":"curl \"https://app.jurispark.com.br/api/v1/clientes?q=silva&etiqueta=trabalhista\" \\\n  -H \"Authorization: Bearer jp_live_SUA_CHAVE\""}]},"post":{"operationId":"criarCliente","tags":["Clientes"],"summary":"Cadastrar um cliente","description":"Cadastra um cliente. O registro aparece na hora no sistema, igual a um cliente cadastrado pela tela. Use o cabeçalho Idempotency-Key para repetir a chamada com segurança, sem duplicar o cadastro.\n\n**Escopo da chave:** `escrever`. **Permissões do usuário dono da chave:** `clientes.criar`.","security":[{"bearerAuth":[]}],"x-escopo":"escrever","x-permissoes":["clientes.criar"],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Valor único por operação (por exemplo, um UUID) para repetir a chamada sem duplicar. Vale por 24 horas.","schema":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"6f3c1d2e-0a4b-4c8e-9d5f-7b2a1c3d4e5f"}],"responses":{"201":{"description":"Criado.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"},"Location":{"$ref":"#/components/headers/Location"},"Idempotent-Replayed":{"$ref":"#/components/headers/IdempotentReplayed"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespostaCliente"},"example":{"data":{"id":"0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01","tipo":"PF","nome":"Maria da Silva Souza","documento":"529.982.247-25","rg":"","dataNascimento":"1985-03-14","nomeFantasia":"","inscricaoEstadual":"","representanteLegal":"","telefone":"(99) 98888-7777","telefone2":"","email":"maria@example.com","cep":"65630-000","logradouro":"Rua das Flores","numero":"120","complemento":"Sala 2","bairro":"Centro","cidade":"Timon","uf":"MA","observacoes":"Prefere contato por WhatsApp.","etiquetas":["trabalhista"],"link":"https://app.jurispark.com.br/lawyer/clients/0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01","criadoEm":"2026-10-01T14:30:00.000Z"}}}}},"400":{"$ref":"#/components/responses/Erro400"},"401":{"$ref":"#/components/responses/Erro401"},"402":{"$ref":"#/components/responses/Erro402"},"403":{"$ref":"#/components/responses/Erro403"},"413":{"$ref":"#/components/responses/Erro413"},"415":{"$ref":"#/components/responses/Erro415"},"422":{"$ref":"#/components/responses/Erro422"},"429":{"$ref":"#/components/responses/Erro429"},"500":{"$ref":"#/components/responses/Erro500"}},"x-codeSamples":[{"lang":"Shell","label":"curl","source":"curl -X POST \"https://app.jurispark.com.br/api/v1/clientes\" \\\n  -H \"Authorization: Bearer jp_live_SUA_CHAVE\" \\\n  -H \"Idempotency-Key: 6f3c1d2e-0a4b-4c8e-9d5f-7b2a1c3d4e5f\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"tipo\":\"PF\",\"nome\":\"Maria da Silva Souza\",\"documento\":\"529.982.247-25\",\"telefone\":\"(99) 98888-7777\",\"email\":\"maria@example.com\",\"cidade\":\"Timon\",\"uf\":\"MA\",\"etiquetas\":[\"trabalhista\"]}'"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClienteNovo"},"example":{"tipo":"PF","nome":"Maria da Silva Souza","documento":"529.982.247-25","telefone":"(99) 98888-7777","email":"maria@example.com","cidade":"Timon","uf":"MA","etiquetas":["trabalhista"]}}}}}},"/clientes/{id}":{"get":{"operationId":"obterCliente","tags":["Clientes"],"summary":"Ver um cliente","description":"Devolve os dados de um cliente pelo id.\n\n**Escopo da chave:** `ler`. **Permissões do usuário dono da chave:** `clientes.ver`.","security":[{"bearerAuth":[]}],"x-escopo":"ler","x-permissoes":["clientes.ver"],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do cliente.","schema":{"type":"string"},"example":"0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01"}],"responses":{"200":{"description":"Sucesso.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespostaCliente"},"example":{"data":{"id":"0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01","tipo":"PF","nome":"Maria da Silva Souza","documento":"529.982.247-25","rg":"","dataNascimento":"1985-03-14","nomeFantasia":"","inscricaoEstadual":"","representanteLegal":"","telefone":"(99) 98888-7777","telefone2":"","email":"maria@example.com","cep":"65630-000","logradouro":"Rua das Flores","numero":"120","complemento":"Sala 2","bairro":"Centro","cidade":"Timon","uf":"MA","observacoes":"Prefere contato por WhatsApp.","etiquetas":["trabalhista"],"link":"https://app.jurispark.com.br/lawyer/clients/0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01","criadoEm":"2026-10-01T14:30:00.000Z"}}}}},"401":{"$ref":"#/components/responses/Erro401"},"403":{"$ref":"#/components/responses/Erro403"},"404":{"$ref":"#/components/responses/Erro404"},"429":{"$ref":"#/components/responses/Erro429"},"500":{"$ref":"#/components/responses/Erro500"}},"x-codeSamples":[{"lang":"Shell","label":"curl","source":"curl \"https://app.jurispark.com.br/api/v1/clientes/0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01\" \\\n  -H \"Authorization: Bearer jp_live_SUA_CHAVE\""}]},"patch":{"operationId":"atualizarCliente","tags":["Clientes"],"summary":"Alterar um cliente","description":"Altera só os campos enviados. Texto vazio limpa o campo. Não há rota para apagar clientes: quem exclui é o usuário, dentro do sistema.\n\n**Escopo da chave:** `escrever`. **Permissões do usuário dono da chave:** `clientes.ver`, `clientes.editar`.","security":[{"bearerAuth":[]}],"x-escopo":"escrever","x-permissoes":["clientes.ver","clientes.editar"],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do cliente.","schema":{"type":"string"},"example":"0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01"}],"responses":{"200":{"description":"Sucesso.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespostaCliente"},"example":{"data":{"id":"0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01","tipo":"PF","nome":"Maria da Silva Souza","documento":"529.982.247-25","rg":"","dataNascimento":"1985-03-14","nomeFantasia":"","inscricaoEstadual":"","representanteLegal":"","telefone":"(99) 98888-7777","telefone2":"","email":"maria@example.com","cep":"65630-000","logradouro":"Rua das Flores","numero":"120","complemento":"Sala 2","bairro":"Centro","cidade":"Timon","uf":"MA","observacoes":"Prefere contato por WhatsApp.","etiquetas":["trabalhista"],"link":"https://app.jurispark.com.br/lawyer/clients/0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01","criadoEm":"2026-10-01T14:30:00.000Z"}}}}},"400":{"$ref":"#/components/responses/Erro400"},"401":{"$ref":"#/components/responses/Erro401"},"402":{"$ref":"#/components/responses/Erro402"},"403":{"$ref":"#/components/responses/Erro403"},"404":{"$ref":"#/components/responses/Erro404"},"413":{"$ref":"#/components/responses/Erro413"},"415":{"$ref":"#/components/responses/Erro415"},"429":{"$ref":"#/components/responses/Erro429"},"500":{"$ref":"#/components/responses/Erro500"}},"x-codeSamples":[{"lang":"Shell","label":"curl","source":"curl -X PATCH \"https://app.jurispark.com.br/api/v1/clientes/0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01\" \\\n  -H \"Authorization: Bearer jp_live_SUA_CHAVE\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"telefone\":\"(99) 97777-6666\",\"observacoes\":\"Mudou de telefone em outubro.\"}'"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClienteAtualizacao"},"example":{"telefone":"(99) 97777-6666","observacoes":"Mudou de telefone em outubro."}}}}}},"/processos":{"get":{"operationId":"listarProcessos","tags":["Processos"],"summary":"Listar processos","description":"Lista os processos (do mais recentemente atualizado para o mais antigo), com filtros e paginação por cursor. Processos excluídos pelo usuário não aparecem.\n\n**Escopo da chave:** `ler`. **Permissões do usuário dono da chave:** `processos.ver`.","security":[{"bearerAuth":[]}],"x-escopo":"ler","x-permissoes":["processos.ver"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Itens por página (1 a 100). Padrão: 25.","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"example":25},{"name":"cursor","in":"query","required":false,"description":"Cursor opaco da página seguinte: use o valor de page.nextCursor da resposta anterior, com os mesmos filtros.","schema":{"type":"string","minLength":1,"maxLength":600}},{"name":"q","in":"query","required":false,"description":"Busca em título, número CNJ (com ou sem pontuação), tipo de ação, parte contrária, tribunal, etiquetas e nome do cliente.","schema":{"type":"string","minLength":1,"maxLength":100},"example":"souza"},{"name":"status","in":"query","required":false,"description":"Situação do processo (ativo, em_recurso, suspenso, arquivado, encerrado).","schema":{"type":"string","minLength":1,"maxLength":30},"example":"ativo"},{"name":"cliente","in":"query","required":false,"description":"Só processos deste cliente (id).","schema":{"type":"string","minLength":1,"maxLength":80}},{"name":"area","in":"query","required":false,"description":"Área do direito (por exemplo: Trabalhista).","schema":{"type":"string","minLength":1,"maxLength":40},"example":"Trabalhista"}],"responses":{"200":{"description":"Sucesso.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListaProcesso"},"example":{"data":[{"id":"0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02","numeroCnj":"0001234-56.2024.8.10.0001","titulo":"Souza x Empresa Exemplo","natureza":"judicial","area":"Trabalhista","tipoAcao":"Reclamação trabalhista","status":"ativo","tribunal":"TJMA","comarca":"Timon","vara":"1ª Vara","juiz":"","url":"","valorCausa":25000,"dataDistribuicao":"2024-05-20","parteContraria":"Empresa Exemplo Ltda","advogadoParteContraria":"","clientes":[{"id":"0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01","nome":"Maria da Silva Souza","papel":"Autor"}],"advogados":[{"id":"0191c3a2-1111-7000-8000-00000000a001","nome":"Dr. Exemplo","papel":"Responsável"}],"etapa":{"id":"st-post","nome":"Fase postulatória"},"processoPrincipalId":null,"instancia":"1º grau","fase":"Conhecimento","etiquetas":[],"observacoes":"","link":"https://app.jurispark.com.br/lawyer/lawsuits/0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02","criadoEm":"2026-09-20T12:00:00.000Z","atualizadoEm":"2026-10-05T18:10:00.000Z"}],"page":{"limit":25,"total":1,"hasMore":false,"nextCursor":null}}}}},"400":{"$ref":"#/components/responses/Erro400"},"401":{"$ref":"#/components/responses/Erro401"},"403":{"$ref":"#/components/responses/Erro403"},"429":{"$ref":"#/components/responses/Erro429"},"500":{"$ref":"#/components/responses/Erro500"}},"x-codeSamples":[{"lang":"Shell","label":"curl","source":"curl \"https://app.jurispark.com.br/api/v1/processos?q=souza&status=ativo\" \\\n  -H \"Authorization: Bearer jp_live_SUA_CHAVE\""}]}},"/processos/{id}":{"get":{"operationId":"obterProcesso","tags":["Processos"],"summary":"Ver um processo","description":"Devolve os dados de um processo pelo id.\n\n**Escopo da chave:** `ler`. **Permissões do usuário dono da chave:** `processos.ver`.","security":[{"bearerAuth":[]}],"x-escopo":"ler","x-permissoes":["processos.ver"],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do processo.","schema":{"type":"string"},"example":"0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01"}],"responses":{"200":{"description":"Sucesso.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespostaProcesso"},"example":{"data":{"id":"0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02","numeroCnj":"0001234-56.2024.8.10.0001","titulo":"Souza x Empresa Exemplo","natureza":"judicial","area":"Trabalhista","tipoAcao":"Reclamação trabalhista","status":"ativo","tribunal":"TJMA","comarca":"Timon","vara":"1ª Vara","juiz":"","url":"","valorCausa":25000,"dataDistribuicao":"2024-05-20","parteContraria":"Empresa Exemplo Ltda","advogadoParteContraria":"","clientes":[{"id":"0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01","nome":"Maria da Silva Souza","papel":"Autor"}],"advogados":[{"id":"0191c3a2-1111-7000-8000-00000000a001","nome":"Dr. Exemplo","papel":"Responsável"}],"etapa":{"id":"st-post","nome":"Fase postulatória"},"processoPrincipalId":null,"instancia":"1º grau","fase":"Conhecimento","etiquetas":[],"observacoes":"","link":"https://app.jurispark.com.br/lawyer/lawsuits/0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02","criadoEm":"2026-09-20T12:00:00.000Z","atualizadoEm":"2026-10-05T18:10:00.000Z"}}}}},"401":{"$ref":"#/components/responses/Erro401"},"403":{"$ref":"#/components/responses/Erro403"},"404":{"$ref":"#/components/responses/Erro404"},"429":{"$ref":"#/components/responses/Erro429"},"500":{"$ref":"#/components/responses/Erro500"}},"x-codeSamples":[{"lang":"Shell","label":"curl","source":"curl \"https://app.jurispark.com.br/api/v1/processos/0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01\" \\\n  -H \"Authorization: Bearer jp_live_SUA_CHAVE\""}]}},"/processos/{id}/andamentos":{"get":{"operationId":"listarAndamentos","tags":["Processos"],"summary":"Listar andamentos de um processo","description":"Histórico de andamentos de um processo, do mais recente para o mais antigo.\n\n**Escopo da chave:** `ler`. **Permissões do usuário dono da chave:** `processos.ver`, `andamentos.ver`.","security":[{"bearerAuth":[]}],"x-escopo":"ler","x-permissoes":["processos.ver","andamentos.ver"],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do processo.","schema":{"type":"string"},"example":"0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01"},{"name":"limit","in":"query","required":false,"description":"Itens por página (1 a 100). Padrão: 25.","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"example":25},{"name":"cursor","in":"query","required":false,"description":"Cursor opaco da página seguinte: use o valor de page.nextCursor da resposta anterior, com os mesmos filtros.","schema":{"type":"string","minLength":1,"maxLength":600}}],"responses":{"200":{"description":"Sucesso.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListaAndamento"},"example":{"data":[{"id":"0191c3a2-9b22-7e30-9c33-1d4f8a2b6c03","processoId":"0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02","data":"2026-10-05","titulo":"Juntada de contestação","descricao":"Contestação protocolada pela parte contrária.","origem":"Manual","prazo":"2026-10-20","criadoEm":"2026-10-05T18:10:00.000Z"}],"page":{"limit":25,"total":1,"hasMore":false,"nextCursor":null}}}}},"400":{"$ref":"#/components/responses/Erro400"},"401":{"$ref":"#/components/responses/Erro401"},"403":{"$ref":"#/components/responses/Erro403"},"404":{"$ref":"#/components/responses/Erro404"},"429":{"$ref":"#/components/responses/Erro429"},"500":{"$ref":"#/components/responses/Erro500"}},"x-codeSamples":[{"lang":"Shell","label":"curl","source":"curl \"https://app.jurispark.com.br/api/v1/processos/0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01/andamentos\" \\\n  -H \"Authorization: Bearer jp_live_SUA_CHAVE\""}]},"post":{"operationId":"criarAndamento","tags":["Processos"],"summary":"Registrar um andamento","description":"Registra um andamento manual em um processo e atualiza a data de atualização do processo, como o sistema faz. Use Idempotency-Key para não duplicar em caso de nova tentativa.\n\n**Escopo da chave:** `escrever`. **Permissões do usuário dono da chave:** `processos.ver`, `andamentos.criar`.","security":[{"bearerAuth":[]}],"x-escopo":"escrever","x-permissoes":["processos.ver","andamentos.criar"],"parameters":[{"name":"id","in":"path","required":true,"description":"Id do processo.","schema":{"type":"string"},"example":"0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01"},{"name":"Idempotency-Key","in":"header","required":false,"description":"Valor único por operação (por exemplo, um UUID) para repetir a chamada sem duplicar. Vale por 24 horas.","schema":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"6f3c1d2e-0a4b-4c8e-9d5f-7b2a1c3d4e5f"}],"responses":{"201":{"description":"Criado.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"},"Idempotent-Replayed":{"$ref":"#/components/headers/IdempotentReplayed"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespostaAndamento"},"example":{"data":{"id":"0191c3a2-9b22-7e30-9c33-1d4f8a2b6c03","processoId":"0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02","data":"2026-10-05","titulo":"Juntada de contestação","descricao":"Contestação protocolada pela parte contrária.","origem":"Manual","prazo":"2026-10-20","criadoEm":"2026-10-05T18:10:00.000Z"}}}}},"400":{"$ref":"#/components/responses/Erro400"},"401":{"$ref":"#/components/responses/Erro401"},"402":{"$ref":"#/components/responses/Erro402"},"403":{"$ref":"#/components/responses/Erro403"},"404":{"$ref":"#/components/responses/Erro404"},"413":{"$ref":"#/components/responses/Erro413"},"415":{"$ref":"#/components/responses/Erro415"},"422":{"$ref":"#/components/responses/Erro422"},"429":{"$ref":"#/components/responses/Erro429"},"500":{"$ref":"#/components/responses/Erro500"}},"x-codeSamples":[{"lang":"Shell","label":"curl","source":"curl -X POST \"https://app.jurispark.com.br/api/v1/processos/0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01/andamentos\" \\\n  -H \"Authorization: Bearer jp_live_SUA_CHAVE\" \\\n  -H \"Idempotency-Key: 6f3c1d2e-0a4b-4c8e-9d5f-7b2a1c3d4e5f\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"titulo\":\"Juntada de contestação\",\"data\":\"2026-10-05\",\"descricao\":\"Contestação protocolada pela parte contrária.\",\"prazo\":\"2026-10-20\"}'"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AndamentoNovo"},"example":{"titulo":"Juntada de contestação","data":"2026-10-05","descricao":"Contestação protocolada pela parte contrária.","prazo":"2026-10-20"}}}}}},"/tarefas":{"get":{"operationId":"listarTarefas","tags":["Tarefas"],"summary":"Listar tarefas","description":"Lista as tarefas do escritório por prazo (as sem prazo vão para o fim), com filtros e paginação por cursor.\n\n**Escopo da chave:** `ler`. **Permissões do usuário dono da chave:** `tarefas.ver`.","security":[{"bearerAuth":[]}],"x-escopo":"ler","x-permissoes":["tarefas.ver"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Itens por página (1 a 100). Padrão: 25.","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"example":25},{"name":"cursor","in":"query","required":false,"description":"Cursor opaco da página seguinte: use o valor de page.nextCursor da resposta anterior, com os mesmos filtros.","schema":{"type":"string","minLength":1,"maxLength":600}},{"name":"q","in":"query","required":false,"description":"Busca no título e na descrição.","schema":{"type":"string","minLength":1,"maxLength":100},"example":"réplica"},{"name":"status","in":"query","required":false,"description":"Situação. \"abertas\" reúne tudo que não está concluído.","schema":{"type":"string","enum":["abertas","pendente","andamento","revisao","concluida"]},"example":"abertas"},{"name":"responsavel","in":"query","required":false,"description":"\"eu\" (o dono da chave) ou o id de um usuário.","schema":{"type":"string","minLength":1,"maxLength":80},"example":"eu"},{"name":"prioridade","in":"query","required":false,"description":"Prioridade.","schema":{"type":"string","enum":["baixa","media","alta","urgente"]}},{"name":"processo","in":"query","required":false,"description":"Só tarefas deste processo (id).","schema":{"type":"string","minLength":1,"maxLength":80}},{"name":"cliente","in":"query","required":false,"description":"Só tarefas deste cliente (id).","schema":{"type":"string","minLength":1,"maxLength":80}},{"name":"from","in":"query","required":false,"description":"Só com prazo a partir desta data (AAAA-MM-DD).","schema":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"example":"2026-10-01"},{"name":"to","in":"query","required":false,"description":"Só com prazo até esta data (AAAA-MM-DD).","schema":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"example":"2026-10-31"}],"responses":{"200":{"description":"Sucesso.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListaTarefa"},"example":{"data":[{"id":"0191c3a2-aa33-7f40-8d22-2e5a9b3c7d04","titulo":"Preparar réplica","descricao":"Revisar a contestação e redigir a réplica.","prioridade":"alta","status":"pendente","prazo":"2026-10-18","responsavel":{"id":"0191c3a2-1111-7000-8000-00000000a001","nome":"Dr. Exemplo"},"processo":{"id":"0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02","numeroCnj":"0001234-56.2024.8.10.0001","titulo":"Souza x Empresa Exemplo"},"cliente":{"id":"0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01","nome":"Maria da Silva Souza"},"etiquetas":[],"checklist":[{"id":"0191c3a2-bb44-7a50-8e11-3f6b0c4d8e05","texto":"Ler a contestação","feito":false}],"totalComentarios":0,"link":"https://app.jurispark.com.br/lawyer/tasks/0191c3a2-aa33-7f40-8d22-2e5a9b3c7d04","criadoEm":"2026-10-05T18:20:00.000Z","atualizadoEm":"2026-10-05T18:20:00.000Z"}],"page":{"limit":25,"total":1,"hasMore":false,"nextCursor":null}}}}},"400":{"$ref":"#/components/responses/Erro400"},"401":{"$ref":"#/components/responses/Erro401"},"403":{"$ref":"#/components/responses/Erro403"},"429":{"$ref":"#/components/responses/Erro429"},"500":{"$ref":"#/components/responses/Erro500"}},"x-codeSamples":[{"lang":"Shell","label":"curl","source":"curl \"https://app.jurispark.com.br/api/v1/tarefas?q=r%C3%A9plica&status=abertas\" \\\n  -H \"Authorization: Bearer jp_live_SUA_CHAVE\""}]},"post":{"operationId":"criarTarefa","tags":["Tarefas"],"summary":"Criar uma tarefa","description":"Cria uma tarefa. Sem responsavelId, a tarefa fica com o usuário dono da chave. Use Idempotency-Key para não duplicar em caso de nova tentativa.\n\n**Escopo da chave:** `escrever`. **Permissões do usuário dono da chave:** `tarefas.criar`.","security":[{"bearerAuth":[]}],"x-escopo":"escrever","x-permissoes":["tarefas.criar"],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Valor único por operação (por exemplo, um UUID) para repetir a chamada sem duplicar. Vale por 24 horas.","schema":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"6f3c1d2e-0a4b-4c8e-9d5f-7b2a1c3d4e5f"}],"responses":{"201":{"description":"Criado.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"},"Idempotent-Replayed":{"$ref":"#/components/headers/IdempotentReplayed"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespostaTarefa"},"example":{"data":{"id":"0191c3a2-aa33-7f40-8d22-2e5a9b3c7d04","titulo":"Preparar réplica","descricao":"Revisar a contestação e redigir a réplica.","prioridade":"alta","status":"pendente","prazo":"2026-10-18","responsavel":{"id":"0191c3a2-1111-7000-8000-00000000a001","nome":"Dr. Exemplo"},"processo":{"id":"0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02","numeroCnj":"0001234-56.2024.8.10.0001","titulo":"Souza x Empresa Exemplo"},"cliente":{"id":"0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01","nome":"Maria da Silva Souza"},"etiquetas":[],"checklist":[{"id":"0191c3a2-bb44-7a50-8e11-3f6b0c4d8e05","texto":"Ler a contestação","feito":false}],"totalComentarios":0,"link":"https://app.jurispark.com.br/lawyer/tasks/0191c3a2-aa33-7f40-8d22-2e5a9b3c7d04","criadoEm":"2026-10-05T18:20:00.000Z","atualizadoEm":"2026-10-05T18:20:00.000Z"}}}}},"400":{"$ref":"#/components/responses/Erro400"},"401":{"$ref":"#/components/responses/Erro401"},"402":{"$ref":"#/components/responses/Erro402"},"403":{"$ref":"#/components/responses/Erro403"},"413":{"$ref":"#/components/responses/Erro413"},"415":{"$ref":"#/components/responses/Erro415"},"422":{"$ref":"#/components/responses/Erro422"},"429":{"$ref":"#/components/responses/Erro429"},"500":{"$ref":"#/components/responses/Erro500"}},"x-codeSamples":[{"lang":"Shell","label":"curl","source":"curl -X POST \"https://app.jurispark.com.br/api/v1/tarefas\" \\\n  -H \"Authorization: Bearer jp_live_SUA_CHAVE\" \\\n  -H \"Idempotency-Key: 6f3c1d2e-0a4b-4c8e-9d5f-7b2a1c3d4e5f\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"titulo\":\"Preparar réplica\",\"descricao\":\"Revisar a contestação e redigir a réplica.\",\"prazo\":\"2026-10-18\",\"prioridade\":\"alta\",\"processoId\":\"0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02\",\"checklist\":[\"Ler a contestação\"]}'"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TarefaNova"},"example":{"titulo":"Preparar réplica","descricao":"Revisar a contestação e redigir a réplica.","prazo":"2026-10-18","prioridade":"alta","processoId":"0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02","checklist":["Ler a contestação"]}}}}}},"/tarefas/{id}":{"patch":{"operationId":"atualizarTarefa","tags":["Tarefas"],"summary":"Alterar uma tarefa","description":"Altera só os campos enviados (situação, prazo, prioridade, responsável, vínculos ou texto) e/ou acrescenta um comentário. Mudanças de prazo e de situação entram no histórico da tarefa. Não há rota para apagar tarefas.\n\n**Escopo da chave:** `escrever`. **Permissões do usuário dono da chave:** `tarefas.editar`.","security":[{"bearerAuth":[]}],"x-escopo":"escrever","x-permissoes":["tarefas.editar"],"parameters":[{"name":"id","in":"path","required":true,"description":"Id da tarefa.","schema":{"type":"string"},"example":"0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01"}],"responses":{"200":{"description":"Sucesso.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespostaTarefa"},"example":{"data":{"id":"0191c3a2-aa33-7f40-8d22-2e5a9b3c7d04","titulo":"Preparar réplica","descricao":"Revisar a contestação e redigir a réplica.","prioridade":"alta","status":"pendente","prazo":"2026-10-18","responsavel":{"id":"0191c3a2-1111-7000-8000-00000000a001","nome":"Dr. Exemplo"},"processo":{"id":"0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02","numeroCnj":"0001234-56.2024.8.10.0001","titulo":"Souza x Empresa Exemplo"},"cliente":{"id":"0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01","nome":"Maria da Silva Souza"},"etiquetas":[],"checklist":[{"id":"0191c3a2-bb44-7a50-8e11-3f6b0c4d8e05","texto":"Ler a contestação","feito":false}],"totalComentarios":0,"link":"https://app.jurispark.com.br/lawyer/tasks/0191c3a2-aa33-7f40-8d22-2e5a9b3c7d04","criadoEm":"2026-10-05T18:20:00.000Z","atualizadoEm":"2026-10-05T18:20:00.000Z"}}}}},"400":{"$ref":"#/components/responses/Erro400"},"401":{"$ref":"#/components/responses/Erro401"},"402":{"$ref":"#/components/responses/Erro402"},"403":{"$ref":"#/components/responses/Erro403"},"404":{"$ref":"#/components/responses/Erro404"},"413":{"$ref":"#/components/responses/Erro413"},"415":{"$ref":"#/components/responses/Erro415"},"429":{"$ref":"#/components/responses/Erro429"},"500":{"$ref":"#/components/responses/Erro500"}},"x-codeSamples":[{"lang":"Shell","label":"curl","source":"curl -X PATCH \"https://app.jurispark.com.br/api/v1/tarefas/0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01\" \\\n  -H \"Authorization: Bearer jp_live_SUA_CHAVE\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"status\":\"concluida\",\"comentario\":\"Réplica protocolada.\"}'"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TarefaAtualizacao"},"example":{"status":"concluida","comentario":"Réplica protocolada."}}}}}},"/agenda":{"get":{"operationId":"listarAgenda","tags":["Agenda"],"summary":"Listar a agenda","description":"Compromissos, audiências e prazos que tocam o período pedido (padrão: de hoje a 30 dias; no máximo 366 dias), em ordem de data e hora. Compromissos recorrentes aparecem uma vez, na data inicial. Cancelados só aparecem com status=cancelado.\n\n**Escopo da chave:** `ler`. **Permissões do usuário dono da chave:** `agenda.ver`.","security":[{"bearerAuth":[]}],"x-escopo":"ler","x-permissoes":["agenda.ver"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Itens por página (1 a 100). Padrão: 25.","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"example":25},{"name":"cursor","in":"query","required":false,"description":"Cursor opaco da página seguinte: use o valor de page.nextCursor da resposta anterior, com os mesmos filtros.","schema":{"type":"string","minLength":1,"maxLength":600}},{"name":"from","in":"query","required":false,"description":"Início do período (AAAA-MM-DD). Padrão: hoje (horário de Brasília).","schema":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"example":"2026-10-01"},{"name":"to","in":"query","required":false,"description":"Fim do período (AAAA-MM-DD). Padrão: 30 dias depois de from.","schema":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"example":"2026-10-31"},{"name":"tipo","in":"query","required":false,"description":"Tipo do compromisso.","schema":{"type":"string","enum":["audiencia","prazo_judicial","prazo_interno","reuniao","compromisso","diligencia","pericia","exigencia"]}},{"name":"status","in":"query","required":false,"description":"Situação. Sem este filtro, os cancelados ficam de fora.","schema":{"type":"string","enum":["agendado","concluido","cancelado"]}},{"name":"processo","in":"query","required":false,"description":"Só deste processo (id).","schema":{"type":"string","minLength":1,"maxLength":80}},{"name":"cliente","in":"query","required":false,"description":"Só deste cliente (id).","schema":{"type":"string","minLength":1,"maxLength":80}}],"responses":{"200":{"description":"Sucesso.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListaCompromisso"},"example":{"data":[{"id":"0191c3a2-cc55-7b60-8f00-4a7c1d5e9f06","tipo":"audiencia","titulo":"Audiência de instrução","data":"2026-11-12","hora":"14:30","dataFim":"2026-11-12","horaFim":"15:30","diaInteiro":false,"local":"Fórum de Timon, sala 3","descricao":"","status":"agendado","recorrencia":"nenhuma","processo":{"id":"0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02","numeroCnj":"0001234-56.2024.8.10.0001","titulo":"Souza x Empresa Exemplo"},"cliente":{"id":"0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01","nome":"Maria da Silva Souza"},"link":"https://app.jurispark.com.br/lawyer/calendar","criadoEm":"2026-10-05T18:30:00.000Z"}],"page":{"limit":25,"total":1,"hasMore":false,"nextCursor":null}}}}},"400":{"$ref":"#/components/responses/Erro400"},"401":{"$ref":"#/components/responses/Erro401"},"403":{"$ref":"#/components/responses/Erro403"},"429":{"$ref":"#/components/responses/Erro429"},"500":{"$ref":"#/components/responses/Erro500"}},"x-codeSamples":[{"lang":"Shell","label":"curl","source":"curl \"https://app.jurispark.com.br/api/v1/agenda?from=2026-10-01&to=2026-10-31\" \\\n  -H \"Authorization: Bearer jp_live_SUA_CHAVE\""}]},"post":{"operationId":"criarCompromisso","tags":["Agenda"],"summary":"Criar um compromisso","description":"Cria um compromisso, audiência ou prazo na agenda. Os lembretes seguem o padrão configurado pelo escritório. Use Idempotency-Key para não duplicar em caso de nova tentativa.\n\n**Escopo da chave:** `escrever`. **Permissões do usuário dono da chave:** `agenda.criar`.","security":[{"bearerAuth":[]}],"x-escopo":"escrever","x-permissoes":["agenda.criar"],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Valor único por operação (por exemplo, um UUID) para repetir a chamada sem duplicar. Vale por 24 horas.","schema":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$"},"example":"6f3c1d2e-0a4b-4c8e-9d5f-7b2a1c3d4e5f"}],"responses":{"201":{"description":"Criado.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"},"Idempotent-Replayed":{"$ref":"#/components/headers/IdempotentReplayed"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespostaCompromisso"},"example":{"data":{"id":"0191c3a2-cc55-7b60-8f00-4a7c1d5e9f06","tipo":"audiencia","titulo":"Audiência de instrução","data":"2026-11-12","hora":"14:30","dataFim":"2026-11-12","horaFim":"15:30","diaInteiro":false,"local":"Fórum de Timon, sala 3","descricao":"","status":"agendado","recorrencia":"nenhuma","processo":{"id":"0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02","numeroCnj":"0001234-56.2024.8.10.0001","titulo":"Souza x Empresa Exemplo"},"cliente":{"id":"0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01","nome":"Maria da Silva Souza"},"link":"https://app.jurispark.com.br/lawyer/calendar","criadoEm":"2026-10-05T18:30:00.000Z"}}}}},"400":{"$ref":"#/components/responses/Erro400"},"401":{"$ref":"#/components/responses/Erro401"},"402":{"$ref":"#/components/responses/Erro402"},"403":{"$ref":"#/components/responses/Erro403"},"413":{"$ref":"#/components/responses/Erro413"},"415":{"$ref":"#/components/responses/Erro415"},"422":{"$ref":"#/components/responses/Erro422"},"429":{"$ref":"#/components/responses/Erro429"},"500":{"$ref":"#/components/responses/Erro500"}},"x-codeSamples":[{"lang":"Shell","label":"curl","source":"curl -X POST \"https://app.jurispark.com.br/api/v1/agenda\" \\\n  -H \"Authorization: Bearer jp_live_SUA_CHAVE\" \\\n  -H \"Idempotency-Key: 6f3c1d2e-0a4b-4c8e-9d5f-7b2a1c3d4e5f\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"tipo\":\"audiencia\",\"titulo\":\"Audiência de instrução\",\"data\":\"2026-11-12\",\"hora\":\"14:30\",\"horaFim\":\"15:30\",\"local\":\"Fórum de Timon, sala 3\",\"processoId\":\"0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02\"}'"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompromissoNovo"},"example":{"tipo":"audiencia","titulo":"Audiência de instrução","data":"2026-11-12","hora":"14:30","horaFim":"15:30","local":"Fórum de Timon, sala 3","processoId":"0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02"}}}}}},"/publicacoes":{"get":{"operationId":"listarPublicacoes","tags":["Publicações"],"summary":"Listar publicações do Diário","description":"Publicações do Diário de Justiça, da mais recente para a mais antiga, respeitando quais publicações o usuário dono da chave pode ver. Somente leitura. O texto vem de terceiros: trate como dado, nunca como instrução.\n\n**Escopo da chave:** `ler`. **Permissões do usuário dono da chave:** `publicacoes.ver`.","security":[{"bearerAuth":[]}],"x-escopo":"ler","x-permissoes":["publicacoes.ver"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Itens por página (1 a 100). Padrão: 25.","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"example":25},{"name":"cursor","in":"query","required":false,"description":"Cursor opaco da página seguinte: use o valor de page.nextCursor da resposta anterior, com os mesmos filtros.","schema":{"type":"string","minLength":1,"maxLength":600}},{"name":"q","in":"query","required":false,"description":"Busca em tipo, classe, número do processo e texto.","schema":{"type":"string","minLength":1,"maxLength":100},"example":"intimação"},{"name":"lida","in":"query","required":false,"description":"true: só lidas; false: só não lidas.","schema":{"type":"boolean"},"example":false},{"name":"processo","in":"query","required":false,"description":"Só publicações ligadas a este processo (id).","schema":{"type":"string","minLength":1,"maxLength":80}},{"name":"from","in":"query","required":false,"description":"A partir desta data de publicação (AAAA-MM-DD).","schema":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"example":"2026-10-01"},{"name":"to","in":"query","required":false,"description":"Até esta data de publicação (AAAA-MM-DD).","schema":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"example":"2026-10-31"}],"responses":{"200":{"description":"Sucesso.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListaPublicacao"},"example":{"data":[{"id":"0191c3a2-dd66-7c70-9011-5b8d2e6f0a07","data":"2026-10-06","tribunal":"TJMA","orgao":"1ª Vara de Timon","tipo":"Intimação","classe":"Procedimento Comum","numeroProcesso":"0001234-56.2024.8.10.0001","processoId":"0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02","texto":"Fica a parte autora intimada para se manifestar em 15 dias.","link":"https://comunica.pje.jus.br/exemplo","lida":false,"concluida":false,"prazoDetectadoDias":15,"audienciaDetectada":null,"criadoEm":"2026-10-06T09:00:00.000Z"}],"page":{"limit":25,"total":1,"hasMore":false,"nextCursor":null}}}}},"400":{"$ref":"#/components/responses/Erro400"},"401":{"$ref":"#/components/responses/Erro401"},"403":{"$ref":"#/components/responses/Erro403"},"429":{"$ref":"#/components/responses/Erro429"},"500":{"$ref":"#/components/responses/Erro500"}},"x-codeSamples":[{"lang":"Shell","label":"curl","source":"curl \"https://app.jurispark.com.br/api/v1/publicacoes?q=intima%C3%A7%C3%A3o&lida=false\" \\\n  -H \"Authorization: Bearer jp_live_SUA_CHAVE\""}]}},"/financeiro/resumo":{"get":{"operationId":"resumoFinanceiro","tags":["Financeiro"],"summary":"Resumo do financeiro","description":"Totais do financeiro do escritório: recebido e pago no mês, a receber, vencido e a pagar, e o que vence nos próximos 7 dias. Valores em reais.\n\n**Escopo da chave:** `financeiro`. **Permissões do usuário dono da chave:** `financeiro.ver`.","security":[{"bearerAuth":[]}],"x-escopo":"financeiro","x-permissoes":["financeiro.ver"],"parameters":[{"name":"mes","in":"query","required":false,"description":"Mês de referência (AAAA-MM). Padrão: o mês atual (horário de Brasília).","schema":{"type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$"},"example":"2026-10"}],"responses":{"200":{"description":"Sucesso.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespostaResumoFinanceiro"},"example":{"data":{"mes":"2026-10","recebidoNoMes":4500,"despesasPagasNoMes":1200.5,"aReceberTotal":9800,"aReceberVencido":{"quantidade":2,"valor":1500},"aPagarTotal":2300,"aPagarVencido":{"quantidade":0,"valor":0},"proximos7Dias":{"aReceber":1500,"aPagar":300}}}}}},"400":{"$ref":"#/components/responses/Erro400"},"401":{"$ref":"#/components/responses/Erro401"},"403":{"$ref":"#/components/responses/Erro403"},"429":{"$ref":"#/components/responses/Erro429"},"500":{"$ref":"#/components/responses/Erro500"}},"x-codeSamples":[{"lang":"Shell","label":"curl","source":"curl \"https://app.jurispark.com.br/api/v1/financeiro/resumo?mes=2026-10\" \\\n  -H \"Authorization: Bearer jp_live_SUA_CHAVE\""}]}},"/financeiro/lancamentos":{"get":{"operationId":"listarLancamentos","tags":["Financeiro"],"summary":"Listar lançamentos","description":"Lançamentos do financeiro (receitas e despesas) por vencimento, com filtros e paginação por cursor. Valores em reais.\n\n**Escopo da chave:** `financeiro`. **Permissões do usuário dono da chave:** `financeiro.ver`.","security":[{"bearerAuth":[]}],"x-escopo":"financeiro","x-permissoes":["financeiro.ver"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Itens por página (1 a 100). Padrão: 25.","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"example":25},{"name":"cursor","in":"query","required":false,"description":"Cursor opaco da página seguinte: use o valor de page.nextCursor da resposta anterior, com os mesmos filtros.","schema":{"type":"string","minLength":1,"maxLength":600}},{"name":"status","in":"query","required":false,"description":"Situação.","schema":{"type":"string","enum":["pendente","pago","cancelado"]},"example":"pendente"},{"name":"tipo","in":"query","required":false,"description":"Receita ou despesa.","schema":{"type":"string","enum":["receita","despesa"]}},{"name":"from","in":"query","required":false,"description":"Vencimento a partir desta data (AAAA-MM-DD).","schema":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"example":"2026-10-01"},{"name":"to","in":"query","required":false,"description":"Vencimento até esta data (AAAA-MM-DD).","schema":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"example":"2026-10-31"},{"name":"cliente","in":"query","required":false,"description":"Só lançamentos deste cliente (id).","schema":{"type":"string","minLength":1,"maxLength":80}},{"name":"processo","in":"query","required":false,"description":"Só lançamentos deste processo (id).","schema":{"type":"string","minLength":1,"maxLength":80}}],"responses":{"200":{"description":"Sucesso.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListaLancamento"},"example":{"data":[{"id":"0191c3a2-ee77-7d80-9122-6c9e3f7a1b08","tipo":"receita","natureza":"honorario","categoria":"Honorários advocatícios","valor":1500,"descricao":"Honorários iniciais","competencia":"2026-10","vencimento":"2026-10-30","status":"pendente","pagoEm":null,"formaPagamento":"","cliente":{"id":"0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01","nome":"Maria da Silva Souza"},"processo":{"id":"0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02","numeroCnj":"0001234-56.2024.8.10.0001","titulo":"Souza x Empresa Exemplo"},"parcela":{"numero":1,"total":3},"criadoEm":"2026-10-01T15:00:00.000Z"}],"page":{"limit":25,"total":1,"hasMore":false,"nextCursor":null}}}}},"400":{"$ref":"#/components/responses/Erro400"},"401":{"$ref":"#/components/responses/Erro401"},"403":{"$ref":"#/components/responses/Erro403"},"429":{"$ref":"#/components/responses/Erro429"},"500":{"$ref":"#/components/responses/Erro500"}},"x-codeSamples":[{"lang":"Shell","label":"curl","source":"curl \"https://app.jurispark.com.br/api/v1/financeiro/lancamentos?status=pendente&from=2026-10-01\" \\\n  -H \"Authorization: Bearer jp_live_SUA_CHAVE\""}]}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"jp_live_...","description":"Chave de API criada em Configurações, API e integrações. Formato: jp_live_ seguido de 40 caracteres."}},"schemas":{"Erro":{"type":"object","properties":{"error":{"type":"string","description":"Código curto do erro, estável, para o seu programa tratar.","examples":["nao_encontrado"]},"message":{"type":"string","description":"Explicação em português, pronta para mostrar a uma pessoa.","examples":["Cliente não encontrado neste escritório."]},"details":{"description":"Detalhes opcionais. Em erros de validação, uma lista de { campo, mensagem }.","type":["array","object","null"]}},"required":["error","message"],"description":"Formato de TODOS os erros da API."},"Pagina":{"type":"object","properties":{"limit":{"type":"integer","description":"Quantidade pedida por página.","minimum":1,"maximum":100},"total":{"type":"integer","description":"Total de itens que atendem aos filtros (em todas as páginas).","minimum":0},"hasMore":{"type":"boolean","description":"Verdadeiro se existe uma próxima página."},"nextCursor":{"type":["string","null"],"description":"Cursor opaco para a próxima página (envie em ?cursor=). Nulo na última página."}},"required":["limit","total","hasMore","nextCursor"],"description":"Informações de paginação das listas."},"Cliente":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único do cliente."},"tipo":{"type":"string","description":"PF (pessoa física) ou PJ (pessoa jurídica).","enum":["PF","PJ"]},"nome":{"type":"string","description":"Nome completo (PF) ou razão social (PJ)."},"documento":{"type":"string","description":"CPF ou CNPJ com pontuação, ou vazio quando não cadastrado."},"rg":{"type":"string","description":"RG (pessoa física), ou vazio."},"dataNascimento":{"type":["string","null"],"description":"Data de nascimento (AAAA-MM-DD), ou nulo.","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"nomeFantasia":{"type":"string","description":"Nome fantasia (pessoa jurídica), ou vazio."},"inscricaoEstadual":{"type":"string","description":"Inscrição estadual (pessoa jurídica), ou vazio."},"representanteLegal":{"type":"string","description":"Representante legal (pessoa jurídica), ou vazio."},"telefone":{"type":"string","description":"Telefone principal, ou vazio."},"telefone2":{"type":"string","description":"Telefone secundário, ou vazio."},"email":{"type":"string","description":"E-mail, ou vazio."},"cep":{"type":"string","description":"CEP, ou vazio."},"logradouro":{"type":"string","description":"Rua, avenida etc."},"numero":{"type":"string","description":"Número do endereço."},"complemento":{"type":"string","description":"Complemento."},"bairro":{"type":"string","description":"Bairro."},"cidade":{"type":"string","description":"Cidade."},"uf":{"type":"string","description":"Sigla do estado, ou vazio."},"observacoes":{"type":"string","description":"Anotações internas."},"etiquetas":{"type":"array","description":"Etiquetas livres.","items":{"type":"string"}},"link":{"type":"string","description":"Endereço do cliente dentro do JurisPark.","format":"uri"},"criadoEm":{"type":["string","null"],"description":"Quando o cadastro foi criado (UTC).","format":"date-time"}},"required":["id","tipo","nome","documento","rg","dataNascimento","nomeFantasia","inscricaoEstadual","representanteLegal","telefone","telefone2","email","cep","logradouro","numero","complemento","bairro","cidade","uf","observacoes","etiquetas","link","criadoEm"],"description":"Cliente do escritório.","examples":[{"id":"0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01","tipo":"PF","nome":"Maria da Silva Souza","documento":"529.982.247-25","rg":"","dataNascimento":"1985-03-14","nomeFantasia":"","inscricaoEstadual":"","representanteLegal":"","telefone":"(99) 98888-7777","telefone2":"","email":"maria@example.com","cep":"65630-000","logradouro":"Rua das Flores","numero":"120","complemento":"Sala 2","bairro":"Centro","cidade":"Timon","uf":"MA","observacoes":"Prefere contato por WhatsApp.","etiquetas":["trabalhista"],"link":"https://app.jurispark.com.br/lawyer/clients/0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01","criadoEm":"2026-10-01T14:30:00.000Z"}]},"ClienteNovo":{"type":"object","properties":{"tipo":{"type":"string","description":"PF (pessoa física) ou PJ (pessoa jurídica). Se omitido, é deduzido do documento (11 dígitos = PF, 14 = PJ); sem documento, PF.","enum":["PF","PJ"]},"nome":{"type":"string","description":"Nome completo (PF) ou razão social (PJ).","minLength":1,"maxLength":160},"documento":{"type":"string","description":"CPF (PF) ou CNPJ (PJ). Aceita com ou sem pontuação e é validado pelos dígitos verificadores. Vazio remove.","maxLength":20},"rg":{"type":"string","description":"RG, só para pessoa física.","maxLength":30},"dataNascimento":{"type":["string","null"],"description":"Data de nascimento (AAAA-MM-DD). Nulo remove.","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"nomeFantasia":{"type":"string","description":"Nome fantasia, para pessoa jurídica.","maxLength":160},"inscricaoEstadual":{"type":"string","description":"Inscrição estadual, para pessoa jurídica.","maxLength":30},"representanteLegal":{"type":"string","description":"Representante legal, para pessoa jurídica.","maxLength":160},"telefone":{"type":"string","description":"Telefone principal, com DDD (10 ou 11 dígitos; o prefixo 55 é aceito e removido).","maxLength":25},"telefone2":{"type":"string","description":"Telefone secundário, com DDD.","maxLength":25},"email":{"type":"string","description":"E-mail do cliente.","maxLength":160,"format":"email"},"cep":{"type":"string","description":"CEP (8 dígitos).","maxLength":10},"logradouro":{"type":"string","description":"Rua, avenida etc.","maxLength":160},"numero":{"type":"string","description":"Número do endereço.","maxLength":20},"complemento":{"type":"string","description":"Complemento do endereço.","maxLength":80},"bairro":{"type":"string","description":"Bairro.","maxLength":80},"cidade":{"type":"string","description":"Cidade.","maxLength":80},"uf":{"type":"string","description":"Sigla do estado (vazio se não informado).","enum":["AC","AL","AM","AP","BA","CE","DF","ES","GO","MA","MG","MS","MT","PA","PB","PE","PI","PR","RJ","RN","RO","RR","RS","SC","SE","SP","TO",""]},"observacoes":{"type":"string","description":"Anotações internas sobre o cliente.","maxLength":5000},"etiquetas":{"type":"array","description":"Etiquetas livres (até 20).","items":{"type":"string","description":"Etiqueta.","minLength":1,"maxLength":40},"maxItems":20}},"required":["nome"],"additionalProperties":false,"description":"Dados para cadastrar um cliente.","examples":[{"tipo":"PF","nome":"Maria da Silva Souza","documento":"529.982.247-25","telefone":"(99) 98888-7777","email":"maria@example.com","cidade":"Timon","uf":"MA","etiquetas":["trabalhista"]}]},"ClienteAtualizacao":{"type":"object","properties":{"tipo":{"type":"string","description":"PF (pessoa física) ou PJ (pessoa jurídica). Se omitido, é deduzido do documento (11 dígitos = PF, 14 = PJ); sem documento, PF.","enum":["PF","PJ"]},"nome":{"type":"string","description":"Nome completo (PF) ou razão social (PJ).","minLength":1,"maxLength":160},"documento":{"type":"string","description":"CPF (PF) ou CNPJ (PJ). Aceita com ou sem pontuação e é validado pelos dígitos verificadores. Vazio remove.","maxLength":20},"rg":{"type":"string","description":"RG, só para pessoa física.","maxLength":30},"dataNascimento":{"type":["string","null"],"description":"Data de nascimento (AAAA-MM-DD). Nulo remove.","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"nomeFantasia":{"type":"string","description":"Nome fantasia, para pessoa jurídica.","maxLength":160},"inscricaoEstadual":{"type":"string","description":"Inscrição estadual, para pessoa jurídica.","maxLength":30},"representanteLegal":{"type":"string","description":"Representante legal, para pessoa jurídica.","maxLength":160},"telefone":{"type":"string","description":"Telefone principal, com DDD (10 ou 11 dígitos; o prefixo 55 é aceito e removido).","maxLength":25},"telefone2":{"type":"string","description":"Telefone secundário, com DDD.","maxLength":25},"email":{"type":"string","description":"E-mail do cliente.","maxLength":160,"format":"email"},"cep":{"type":"string","description":"CEP (8 dígitos).","maxLength":10},"logradouro":{"type":"string","description":"Rua, avenida etc.","maxLength":160},"numero":{"type":"string","description":"Número do endereço.","maxLength":20},"complemento":{"type":"string","description":"Complemento do endereço.","maxLength":80},"bairro":{"type":"string","description":"Bairro.","maxLength":80},"cidade":{"type":"string","description":"Cidade.","maxLength":80},"uf":{"type":"string","description":"Sigla do estado (vazio se não informado).","enum":["AC","AL","AM","AP","BA","CE","DF","ES","GO","MA","MG","MS","MT","PA","PB","PE","PI","PR","RJ","RN","RO","RR","RS","SC","SE","SP","TO",""]},"observacoes":{"type":"string","description":"Anotações internas sobre o cliente.","maxLength":5000},"etiquetas":{"type":"array","description":"Etiquetas livres (até 20).","items":{"type":"string","description":"Etiqueta.","minLength":1,"maxLength":40},"maxItems":20}},"required":[],"additionalProperties":false,"minProperties":1,"description":"Campos a alterar em um cliente. Só o que for enviado muda; texto vazio limpa o campo.","examples":[{"telefone":"(99) 97777-6666","observacoes":"Mudou de telefone em outubro."}]},"Processo":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único do processo."},"numeroCnj":{"type":"string","description":"Número CNJ (vazio para processos administrativos ou sem número)."},"titulo":{"type":"string","description":"Título do processo."},"natureza":{"type":"string","description":"Natureza do processo.","enum":["judicial","administrativo"]},"area":{"type":"string","description":"Área do direito."},"tipoAcao":{"type":"string","description":"Tipo de ação."},"status":{"type":"string","description":"Situação do processo (por exemplo: ativo, em_recurso, suspenso, arquivado, encerrado)."},"tribunal":{"type":"string","description":"Tribunal."},"comarca":{"type":"string","description":"Comarca."},"vara":{"type":"string","description":"Vara ou órgão."},"juiz":{"type":"string","description":"Juiz."},"url":{"type":"string","description":"Endereço do processo no sistema do tribunal, se cadastrado."},"valorCausa":{"type":"number","description":"Valor da causa em reais."},"dataDistribuicao":{"type":["string","null"],"description":"Data de distribuição (AAAA-MM-DD), ou nulo.","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"parteContraria":{"type":"string","description":"Parte contrária."},"advogadoParteContraria":{"type":"string","description":"Advogado da parte contrária."},"clientes":{"type":"array","description":"Clientes vinculados.","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador do cliente."},"nome":{"type":["string","null"],"description":"Nome do cliente (nulo se o usuário da chave não pode ver clientes)."},"papel":{"type":"string","description":"Papel na ação (Autor, Réu, Terceiro, Interessado ou Outro)."}},"required":["id","nome","papel"]}},"advogados":{"type":"array","description":"Advogados vinculados.","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador do usuário."},"nome":{"type":["string","null"],"description":"Nome do advogado."},"papel":{"type":"string","description":"Responsável ou Participante."}},"required":["id","nome","papel"]}},"etapa":{"type":["object","null"],"properties":{"id":{"type":"string","description":"Identificador da etapa."},"nome":{"type":"string","description":"Nome da etapa."}},"required":["id","nome"],"description":"Etapa do funil de processos, ou nulo."},"processoPrincipalId":{"type":["string","null"],"description":"Id do processo principal, quando este é um incidente ou recurso."},"instancia":{"type":"string","description":"Instância."},"fase":{"type":"string","description":"Fase."},"etiquetas":{"type":"array","description":"Etiquetas.","items":{"type":"string"}},"observacoes":{"type":"string","description":"Observações internas."},"link":{"type":"string","description":"Endereço do processo dentro do JurisPark.","format":"uri"},"criadoEm":{"type":["string","null"],"description":"Criação (UTC).","format":"date-time"},"atualizadoEm":{"type":["string","null"],"description":"Última atualização (UTC).","format":"date-time"}},"required":["id","numeroCnj","titulo","natureza","area","tipoAcao","status","tribunal","comarca","vara","juiz","url","valorCausa","dataDistribuicao","parteContraria","advogadoParteContraria","clientes","advogados","etapa","processoPrincipalId","instancia","fase","etiquetas","observacoes","link","criadoEm","atualizadoEm"],"description":"Processo do escritório.","examples":[{"id":"0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02","numeroCnj":"0001234-56.2024.8.10.0001","titulo":"Souza x Empresa Exemplo","natureza":"judicial","area":"Trabalhista","tipoAcao":"Reclamação trabalhista","status":"ativo","tribunal":"TJMA","comarca":"Timon","vara":"1ª Vara","juiz":"","url":"","valorCausa":25000,"dataDistribuicao":"2024-05-20","parteContraria":"Empresa Exemplo Ltda","advogadoParteContraria":"","clientes":[{"id":"0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01","nome":"Maria da Silva Souza","papel":"Autor"}],"advogados":[{"id":"0191c3a2-1111-7000-8000-00000000a001","nome":"Dr. Exemplo","papel":"Responsável"}],"etapa":{"id":"st-post","nome":"Fase postulatória"},"processoPrincipalId":null,"instancia":"1º grau","fase":"Conhecimento","etiquetas":[],"observacoes":"","link":"https://app.jurispark.com.br/lawyer/lawsuits/0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02","criadoEm":"2026-09-20T12:00:00.000Z","atualizadoEm":"2026-10-05T18:10:00.000Z"}]},"Andamento":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único do andamento."},"processoId":{"type":"string","description":"Processo ao qual o andamento pertence."},"data":{"type":"string","description":"Data do andamento (AAAA-MM-DD).","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"titulo":{"type":"string","description":"Título."},"descricao":{"type":"string","description":"Descrição."},"origem":{"type":"string","description":"De onde veio o andamento.","enum":["Manual","DJEN","DataJud"]},"prazo":{"type":["string","null"],"description":"Prazo gerado pelo andamento (AAAA-MM-DD), ou nulo.","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"criadoEm":{"type":["string","null"],"description":"Criação (UTC).","format":"date-time"}},"required":["id","processoId","data","titulo","descricao","origem","prazo","criadoEm"],"description":"Andamento (movimentação) de um processo.","examples":[{"id":"0191c3a2-9b22-7e30-9c33-1d4f8a2b6c03","processoId":"0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02","data":"2026-10-05","titulo":"Juntada de contestação","descricao":"Contestação protocolada pela parte contrária.","origem":"Manual","prazo":"2026-10-20","criadoEm":"2026-10-05T18:10:00.000Z"}]},"AndamentoNovo":{"type":"object","properties":{"titulo":{"type":"string","description":"Título curto do andamento.","minLength":1,"maxLength":200},"data":{"type":"string","description":"Data do andamento (AAAA-MM-DD). Padrão: hoje (horário de Brasília).","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"descricao":{"type":"string","description":"Detalhes do andamento.","maxLength":3000},"prazo":{"type":"string","description":"Prazo decorrente do andamento (AAAA-MM-DD), se houver.","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["titulo"],"additionalProperties":false,"description":"Dados para registrar um andamento manual.","examples":[{"titulo":"Juntada de contestação","data":"2026-10-05","descricao":"Contestação protocolada pela parte contrária.","prazo":"2026-10-20"}]},"Tarefa":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único da tarefa."},"titulo":{"type":"string","description":"Título."},"descricao":{"type":"string","description":"Descrição."},"prioridade":{"type":"string","description":"Prioridade.","enum":["baixa","media","alta","urgente"]},"status":{"type":"string","description":"Situação.","enum":["pendente","andamento","revisao","concluida"]},"prazo":{"type":["string","null"],"description":"Prazo (AAAA-MM-DD), ou nulo.","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"responsavel":{"type":["object","null"],"properties":{"id":{"type":"string","description":"Identificador do usuário."},"nome":{"type":"string","description":"Nome do usuário."}},"required":["id","nome"],"description":"Responsável pela tarefa, ou nulo."},"processo":{"type":["object","null"],"properties":{"id":{"type":"string","description":"Identificador do processo."},"numeroCnj":{"type":"string","description":"Número CNJ do processo (ausente se o usuário da chave não pode ver processos)."},"titulo":{"type":"string","description":"Título do processo (ausente se o usuário da chave não pode ver processos)."}},"required":["id"],"description":"Processo vinculado, ou nulo."},"cliente":{"type":["object","null"],"properties":{"id":{"type":"string","description":"Identificador do cliente."},"nome":{"type":"string","description":"Nome do cliente (ausente se o usuário da chave não pode ver clientes)."}},"required":["id"],"description":"Cliente vinculado, ou nulo."},"etiquetas":{"type":"array","description":"Etiquetas.","items":{"type":"string"}},"checklist":{"type":"array","description":"Itens da lista de verificação.","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador do item."},"texto":{"type":"string","description":"Texto do item."},"feito":{"type":"boolean","description":"Se o item foi concluído."}},"required":["id","texto","feito"]}},"totalComentarios":{"type":"integer","description":"Quantidade de comentários."},"link":{"type":"string","description":"Endereço da tarefa dentro do JurisPark.","format":"uri"},"criadoEm":{"type":["string","null"],"description":"Criação (UTC).","format":"date-time"},"atualizadoEm":{"type":["string","null"],"description":"Última atualização (UTC).","format":"date-time"}},"required":["id","titulo","descricao","prioridade","status","prazo","responsavel","processo","cliente","etiquetas","checklist","totalComentarios","link","criadoEm","atualizadoEm"],"description":"Tarefa do escritório.","examples":[{"id":"0191c3a2-aa33-7f40-8d22-2e5a9b3c7d04","titulo":"Preparar réplica","descricao":"Revisar a contestação e redigir a réplica.","prioridade":"alta","status":"pendente","prazo":"2026-10-18","responsavel":{"id":"0191c3a2-1111-7000-8000-00000000a001","nome":"Dr. Exemplo"},"processo":{"id":"0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02","numeroCnj":"0001234-56.2024.8.10.0001","titulo":"Souza x Empresa Exemplo"},"cliente":{"id":"0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01","nome":"Maria da Silva Souza"},"etiquetas":[],"checklist":[{"id":"0191c3a2-bb44-7a50-8e11-3f6b0c4d8e05","texto":"Ler a contestação","feito":false}],"totalComentarios":0,"link":"https://app.jurispark.com.br/lawyer/tasks/0191c3a2-aa33-7f40-8d22-2e5a9b3c7d04","criadoEm":"2026-10-05T18:20:00.000Z","atualizadoEm":"2026-10-05T18:20:00.000Z"}]},"TarefaNova":{"type":"object","properties":{"titulo":{"type":"string","description":"Título curto da tarefa.","minLength":1,"maxLength":200},"descricao":{"type":"string","description":"Detalhes.","maxLength":5000},"prazo":{"type":"string","description":"Prazo (AAAA-MM-DD).","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"prioridade":{"type":"string","description":"Prioridade. Padrão: media.","enum":["baixa","media","alta","urgente"]},"responsavelId":{"type":"string","description":"Id do usuário responsável. Padrão: o usuário dono da chave. Atribuir a outra pessoa exige a permissão de atribuir tarefas.","maxLength":80},"processoId":{"type":"string","description":"Processo relacionado.","maxLength":80},"clienteId":{"type":"string","description":"Cliente relacionado.","maxLength":80},"etiquetas":{"type":"array","description":"Etiquetas (até 20).","items":{"type":"string","description":"Etiqueta.","minLength":1,"maxLength":40},"maxItems":20},"checklist":{"type":"array","description":"Itens da lista de verificação (até 30).","items":{"type":"string","description":"Texto do item.","minLength":1,"maxLength":200},"maxItems":30}},"required":["titulo"],"additionalProperties":false,"description":"Dados para criar uma tarefa.","examples":[{"titulo":"Preparar réplica","descricao":"Revisar a contestação e redigir a réplica.","prazo":"2026-10-18","prioridade":"alta","processoId":"0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02","checklist":["Ler a contestação"]}]},"TarefaAtualizacao":{"type":"object","properties":{"titulo":{"type":"string","description":"Novo título.","minLength":1,"maxLength":200},"descricao":{"type":"string","description":"Nova descrição.","maxLength":5000},"status":{"type":"string","description":"Nova situação.","enum":["pendente","andamento","revisao","concluida"]},"prazo":{"type":["string","null"],"description":"Novo prazo (AAAA-MM-DD). Nulo remove o prazo.","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"prioridade":{"type":"string","description":"Nova prioridade.","enum":["baixa","media","alta","urgente"]},"responsavelId":{"type":["string","null"],"description":"Novo responsável (id de usuário). Nulo remove. Exige a permissão de atribuir tarefas.","maxLength":80},"processoId":{"type":["string","null"],"description":"Novo processo vinculado. Nulo desvincula.","maxLength":80},"clienteId":{"type":["string","null"],"description":"Novo cliente vinculado. Nulo desvincula.","maxLength":80},"comentario":{"type":"string","description":"Comentário a acrescentar na tarefa.","minLength":1,"maxLength":1000}},"required":[],"additionalProperties":false,"minProperties":1,"description":"Campos a alterar em uma tarefa. Só o que for enviado muda.","examples":[{"status":"concluida","comentario":"Réplica protocolada."}]},"Compromisso":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único do compromisso."},"tipo":{"type":"string","description":"Tipo.","enum":["audiencia","prazo_judicial","prazo_interno","reuniao","compromisso","diligencia","pericia","exigencia"]},"titulo":{"type":"string","description":"Título."},"data":{"type":"string","description":"Data inicial (AAAA-MM-DD).","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"hora":{"type":["string","null"],"description":"Hora inicial (HH:MM, horário de Brasília), ou nulo se for o dia todo.","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"dataFim":{"type":"string","description":"Data final (AAAA-MM-DD).","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"horaFim":{"type":["string","null"],"description":"Hora final (HH:MM), ou nulo.","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"diaInteiro":{"type":"boolean","description":"Verdadeiro quando não tem hora marcada."},"local":{"type":"string","description":"Local."},"descricao":{"type":"string","description":"Descrição."},"status":{"type":"string","description":"Situação.","enum":["agendado","concluido","cancelado"]},"recorrencia":{"type":"string","description":"Repetição do compromisso. As repetições não são expandidas pela API: o item aparece uma vez, na data inicial.","enum":["nenhuma","diaria","semanal","quinzenal","mensal","anual"]},"processo":{"type":["object","null"],"properties":{"id":{"type":"string","description":"Identificador do processo."},"numeroCnj":{"type":"string","description":"Número CNJ do processo (ausente se o usuário da chave não pode ver processos)."},"titulo":{"type":"string","description":"Título do processo (ausente se o usuário da chave não pode ver processos)."}},"required":["id"],"description":"Processo vinculado, ou nulo."},"cliente":{"type":["object","null"],"properties":{"id":{"type":"string","description":"Identificador do cliente."},"nome":{"type":"string","description":"Nome do cliente (ausente se o usuário da chave não pode ver clientes)."}},"required":["id"],"description":"Cliente vinculado, ou nulo."},"link":{"type":"string","description":"Endereço da agenda dentro do JurisPark.","format":"uri"},"criadoEm":{"type":["string","null"],"description":"Criação (UTC).","format":"date-time"}},"required":["id","tipo","titulo","data","hora","dataFim","horaFim","diaInteiro","local","descricao","status","recorrencia","processo","cliente","link","criadoEm"],"description":"Compromisso, audiência ou prazo da agenda.","examples":[{"id":"0191c3a2-cc55-7b60-8f00-4a7c1d5e9f06","tipo":"audiencia","titulo":"Audiência de instrução","data":"2026-11-12","hora":"14:30","dataFim":"2026-11-12","horaFim":"15:30","diaInteiro":false,"local":"Fórum de Timon, sala 3","descricao":"","status":"agendado","recorrencia":"nenhuma","processo":{"id":"0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02","numeroCnj":"0001234-56.2024.8.10.0001","titulo":"Souza x Empresa Exemplo"},"cliente":{"id":"0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01","nome":"Maria da Silva Souza"},"link":"https://app.jurispark.com.br/lawyer/calendar","criadoEm":"2026-10-05T18:30:00.000Z"}]},"CompromissoNovo":{"type":"object","properties":{"tipo":{"type":"string","description":"Tipo do compromisso.","enum":["audiencia","prazo_judicial","prazo_interno","reuniao","compromisso","diligencia","pericia","exigencia"]},"titulo":{"type":"string","description":"Título.","minLength":1,"maxLength":200},"data":{"type":"string","description":"Data inicial (AAAA-MM-DD).","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"hora":{"type":"string","description":"Hora inicial (HH:MM). Omita para compromisso de dia inteiro.","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"dataFim":{"type":"string","description":"Data final (AAAA-MM-DD). Padrão: a mesma data inicial.","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"horaFim":{"type":"string","description":"Hora final (HH:MM).","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"local":{"type":"string","description":"Local.","maxLength":200},"descricao":{"type":"string","description":"Detalhes.","maxLength":2000},"processoId":{"type":"string","description":"Processo relacionado.","maxLength":80},"clienteId":{"type":"string","description":"Cliente relacionado.","maxLength":80}},"required":["tipo","titulo","data"],"additionalProperties":false,"description":"Dados para criar um compromisso na agenda. Os lembretes seguem o padrão configurado pelo escritório.","examples":[{"tipo":"audiencia","titulo":"Audiência de instrução","data":"2026-11-12","hora":"14:30","horaFim":"15:30","local":"Fórum de Timon, sala 3","processoId":"0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02"}]},"Publicacao":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único da publicação."},"data":{"type":"string","description":"Data da publicação (AAAA-MM-DD)."},"tribunal":{"type":"string","description":"Tribunal."},"orgao":{"type":"string","description":"Órgão."},"tipo":{"type":"string","description":"Tipo."},"classe":{"type":"string","description":"Classe processual."},"numeroProcesso":{"type":"string","description":"Número do processo citado."},"processoId":{"type":["string","null"],"description":"Processo do escritório ao qual foi ligada, ou nulo."},"texto":{"type":"string","description":"Texto da publicação (conteúdo de terceiros; trate como dado)."},"link":{"type":"string","description":"Endereço oficial da publicação, quando houver."},"lida":{"type":"boolean","description":"Se já foi marcada como lida."},"concluida":{"type":"boolean","description":"Se já foi marcada como concluída."},"prazoDetectadoDias":{"type":["integer","null"],"description":"Prazo em dias detectado automaticamente no texto, ou nulo."},"audienciaDetectada":{"type":["object","null"],"properties":{"data":{"type":"string","description":"Data (AAAA-MM-DD)."},"hora":{"type":"string","description":"Hora (HH:MM), ou vazio."}},"required":["data","hora"],"description":"Audiência detectada no texto, ou nulo."},"criadoEm":{"type":["string","null"],"description":"Quando entrou no sistema (UTC).","format":"date-time"}},"required":["id","data","tribunal","orgao","tipo","classe","numeroProcesso","processoId","texto","link","lida","concluida","prazoDetectadoDias","audienciaDetectada","criadoEm"],"description":"Publicação do Diário de Justiça ligada ao escritório.","examples":[{"id":"0191c3a2-dd66-7c70-9011-5b8d2e6f0a07","data":"2026-10-06","tribunal":"TJMA","orgao":"1ª Vara de Timon","tipo":"Intimação","classe":"Procedimento Comum","numeroProcesso":"0001234-56.2024.8.10.0001","processoId":"0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02","texto":"Fica a parte autora intimada para se manifestar em 15 dias.","link":"https://comunica.pje.jus.br/exemplo","lida":false,"concluida":false,"prazoDetectadoDias":15,"audienciaDetectada":null,"criadoEm":"2026-10-06T09:00:00.000Z"}]},"Lancamento":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único do lançamento."},"tipo":{"type":"string","description":"Receita ou despesa.","enum":["receita","despesa"]},"natureza":{"type":"string","description":"Como o lançamento foi classificado no sistema.","enum":["honorario","recebimento","despesa"]},"categoria":{"type":"string","description":"Categoria financeira."},"valor":{"type":"number","description":"Valor em reais."},"descricao":{"type":"string","description":"Descrição."},"competencia":{"type":"string","description":"Mês de competência (AAAA-MM), ou vazio."},"vencimento":{"type":"string","description":"Data de vencimento (AAAA-MM-DD)."},"status":{"type":"string","description":"Situação.","enum":["pendente","pago","cancelado"]},"pagoEm":{"type":["string","null"],"description":"Data do pagamento (AAAA-MM-DD), ou nulo."},"formaPagamento":{"type":"string","description":"Forma de pagamento prevista ou usada."},"cliente":{"type":["object","null"],"properties":{"id":{"type":"string","description":"Identificador do cliente."},"nome":{"type":"string","description":"Nome do cliente (ausente se o usuário da chave não pode ver clientes)."}},"required":["id"],"description":"Cliente vinculado, ou nulo."},"processo":{"type":["object","null"],"properties":{"id":{"type":"string","description":"Identificador do processo."},"numeroCnj":{"type":"string","description":"Número CNJ do processo (ausente se o usuário da chave não pode ver processos)."},"titulo":{"type":"string","description":"Título do processo (ausente se o usuário da chave não pode ver processos)."}},"required":["id"],"description":"Processo vinculado, ou nulo."},"parcela":{"type":["object","null"],"properties":{"numero":{"type":"integer","description":"Número da parcela."},"total":{"type":"integer","description":"Total de parcelas."}},"required":["numero","total"],"description":"Parcela, quando o lançamento faz parte de um parcelamento; senão nulo."},"criadoEm":{"type":["string","null"],"description":"Criação (UTC).","format":"date-time"}},"required":["id","tipo","natureza","categoria","valor","descricao","competencia","vencimento","status","pagoEm","formaPagamento","cliente","processo","parcela","criadoEm"],"description":"Lançamento do financeiro.","examples":[{"id":"0191c3a2-ee77-7d80-9122-6c9e3f7a1b08","tipo":"receita","natureza":"honorario","categoria":"Honorários advocatícios","valor":1500,"descricao":"Honorários iniciais","competencia":"2026-10","vencimento":"2026-10-30","status":"pendente","pagoEm":null,"formaPagamento":"","cliente":{"id":"0191c3a2-7e4b-7c10-9a55-3f1d2b8c6a01","nome":"Maria da Silva Souza"},"processo":{"id":"0191c3a2-8a11-7d20-8b44-6c2e9f1a7b02","numeroCnj":"0001234-56.2024.8.10.0001","titulo":"Souza x Empresa Exemplo"},"parcela":{"numero":1,"total":3},"criadoEm":"2026-10-01T15:00:00.000Z"}]},"ResumoFinanceiro":{"type":"object","properties":{"mes":{"type":"string","description":"Mês de referência (AAAA-MM).","pattern":"^\\d{4}-\\d{2}$"},"recebidoNoMes":{"type":"number","description":"Receitas pagas no mês, em reais."},"despesasPagasNoMes":{"type":"number","description":"Despesas pagas no mês, em reais."},"aReceberTotal":{"type":"number","description":"Total de receitas pendentes, em reais."},"aReceberVencido":{"type":"object","properties":{"quantidade":{"type":"integer","description":"Quantidade."},"valor":{"type":"number","description":"Valor em reais."}},"required":["quantidade","valor"]},"aPagarTotal":{"type":"number","description":"Total de despesas pendentes, em reais."},"aPagarVencido":{"type":"object","properties":{"quantidade":{"type":"integer","description":"Quantidade."},"valor":{"type":"number","description":"Valor em reais."}},"required":["quantidade","valor"]},"proximos7Dias":{"type":"object","properties":{"aReceber":{"type":"number","description":"A receber nos próximos 7 dias."},"aPagar":{"type":"number","description":"A pagar nos próximos 7 dias."}},"required":["aReceber","aPagar"]}},"required":["mes","recebidoNoMes","despesasPagasNoMes","aReceberTotal","aReceberVencido","aPagarTotal","aPagarVencido","proximos7Dias"],"description":"Totais agregados do financeiro. Valores em reais.","examples":[{"mes":"2026-10","recebidoNoMes":4500,"despesasPagasNoMes":1200.5,"aReceberTotal":9800,"aReceberVencido":{"quantidade":2,"valor":1500},"aPagarTotal":2300,"aPagarVencido":{"quantidade":0,"valor":0},"proximos7Dias":{"aReceber":1500,"aPagar":300}}]},"Eu":{"type":"object","properties":{"usuario":{"type":"object","properties":{"id":{"type":"string","description":"Identificador do usuário."},"nome":{"type":"string","description":"Nome."},"email":{"type":"string","description":"E-mail."},"papel":{"type":"string","description":"Papel no escritório (Administrador, Advogado, Secretária ou Estagiário)."}},"required":["id","nome","email","papel"]},"escritorio":{"type":"object","properties":{"id":{"type":"string","description":"Identificador do escritório."},"nome":{"type":"string","description":"Nome do escritório."}},"required":["id","nome"]},"chave":{"type":"object","properties":{"id":{"type":"string","description":"Identificador da chave."},"nome":{"type":"string","description":"Nome dado à chave."},"prefixo":{"type":"string","description":"Início da chave, para você reconhecê-la."},"escopos":{"type":"array","description":"Escopos da chave.","items":{"type":"string","enum":["ler","escrever","financeiro"]}},"criadaEm":{"type":"string","description":"Criação (UTC).","format":"date-time"},"venceEm":{"type":["string","null"],"description":"Vencimento (UTC), ou nulo se não vence.","format":"date-time"}},"required":["id","nome","prefixo","escopos","criadaEm","venceEm"]},"escoposEfetivos":{"type":"array","description":"Escopos que a chave realmente pode usar agora: os da chave que também são permitidos pelas permissões atuais do usuário.","items":{"type":"string","enum":["ler","escrever","financeiro"]}},"operacoes":{"type":"array","description":"Identificadores (operationId) das operações que esta chave pode chamar agora.","items":{"type":"string"}},"limites":{"type":"object","properties":{"porMinuto":{"type":"integer","description":"Chamadas por minuto, por chave."},"porDia":{"type":"integer","description":"Chamadas por dia, por chave (fuso de São Paulo)."},"usadasHoje":{"type":"integer","description":"Chamadas já feitas hoje com esta chave."}},"required":["porMinuto","porDia","usadasHoje"]}},"required":["usuario","escritorio","chave","escoposEfetivos","operacoes","limites"],"description":"Quem é a chave: usuário, escritório, escopos e limites.","examples":[{"usuario":{"id":"0191c3a2-1111-7000-8000-00000000a001","nome":"Dr. Exemplo","email":"dr@example.com","papel":"Administrador"},"escritorio":{"id":"0191c3a2-0000-7000-8000-00000000f001","nome":"Escritório Exemplo"},"chave":{"id":"0191c3a2-4444-7000-8000-00000000b001","nome":"Planilha de prazos","prefixo":"jp_live_Ab3x","escopos":["ler"],"criadaEm":"2026-10-01T12:00:00.000Z","venceEm":null},"escoposEfetivos":["ler"],"operacoes":["obterIdentidade","listarProcessos"],"limites":{"porMinuto":120,"porDia":10000,"usadasHoje":3}}]},"RespostaEu":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Eu"}},"description":"Envelope de resposta com um item (Eu)."},"ListaEu":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Eu"}},"page":{"$ref":"#/components/schemas/Pagina"}},"description":"Envelope de resposta de lista (Eu)."},"RespostaCliente":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Cliente"}},"description":"Envelope de resposta com um item (Cliente)."},"ListaCliente":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Cliente"}},"page":{"$ref":"#/components/schemas/Pagina"}},"description":"Envelope de resposta de lista (Cliente)."},"RespostaProcesso":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Processo"}},"description":"Envelope de resposta com um item (Processo)."},"ListaProcesso":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Processo"}},"page":{"$ref":"#/components/schemas/Pagina"}},"description":"Envelope de resposta de lista (Processo)."},"RespostaAndamento":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Andamento"}},"description":"Envelope de resposta com um item (Andamento)."},"ListaAndamento":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Andamento"}},"page":{"$ref":"#/components/schemas/Pagina"}},"description":"Envelope de resposta de lista (Andamento)."},"RespostaTarefa":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Tarefa"}},"description":"Envelope de resposta com um item (Tarefa)."},"ListaTarefa":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Tarefa"}},"page":{"$ref":"#/components/schemas/Pagina"}},"description":"Envelope de resposta de lista (Tarefa)."},"RespostaCompromisso":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Compromisso"}},"description":"Envelope de resposta com um item (Compromisso)."},"ListaCompromisso":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Compromisso"}},"page":{"$ref":"#/components/schemas/Pagina"}},"description":"Envelope de resposta de lista (Compromisso)."},"RespostaPublicacao":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Publicacao"}},"description":"Envelope de resposta com um item (Publicacao)."},"ListaPublicacao":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Publicacao"}},"page":{"$ref":"#/components/schemas/Pagina"}},"description":"Envelope de resposta de lista (Publicacao)."},"RespostaResumoFinanceiro":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/ResumoFinanceiro"}},"description":"Envelope de resposta com um item (ResumoFinanceiro)."},"ListaResumoFinanceiro":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ResumoFinanceiro"}},"page":{"$ref":"#/components/schemas/Pagina"}},"description":"Envelope de resposta de lista (ResumoFinanceiro)."},"RespostaLancamento":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Lancamento"}},"description":"Envelope de resposta com um item (Lancamento)."},"ListaLancamento":{"type":"object","required":["data","page"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Lancamento"}},"page":{"$ref":"#/components/schemas/Pagina"}},"description":"Envelope de resposta de lista (Lancamento)."}},"responses":{"Erro400":{"description":"Requisição malformada ou com campos inválidos.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"},"example":{"error":"validacao","message":"Alguns campos estão inválidos.","details":[{"campo":"nome","mensagem":"é obrigatório"}]}}}},"Erro401":{"description":"Chave ausente, inválida, vencida ou revogada. A resposta traz o cabeçalho WWW-Authenticate.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"WWW-Authenticate":{"$ref":"#/components/headers/WWWAuthenticate"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"},"example":{"error":"chave_invalida","message":"Chave de API inválida. Confira se copiou a chave inteira."}}}},"Erro402":{"description":"A licença do escritório não permite gravar agora. A leitura continua liberada.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"},"example":{"error":"licenca_expirada","message":"Seu período acabou. Ative uma licença para continuar editando."}}}},"Erro403":{"description":"Escopo da chave, permissão do usuário, API desligada no escritório ou conta bloqueada.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"},"example":{"error":"sem_permissao","message":"O usuário dono desta chave não tem permissão para isso."}}}},"Erro404":{"description":"O registro não existe neste escritório.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"},"example":{"error":"nao_encontrado","message":"Cliente não encontrado neste escritório."}}}},"Erro405":{"description":"Método HTTP não permitido nesta rota. O cabeçalho Allow lista os aceitos.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"Allow":{"description":"Métodos aceitos neste endereço.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"},"example":{"error":"metodo_nao_permitido","message":"Este endereço não aceita o método POST."}}}},"Erro413":{"description":"Corpo da requisição grande demais.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"},"example":{"error":"corpo_grande_demais","message":"O corpo da requisição passa de 256 KB."}}}},"Erro415":{"description":"Content-Type diferente de application/json.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"},"example":{"error":"tipo_nao_suportado","message":"Envie o corpo como JSON, com o cabeçalho Content-Type: application/json."}}}},"Erro422":{"description":"A mesma Idempotency-Key foi usada com um corpo diferente.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"},"example":{"error":"idempotencia_conflito","message":"Esta Idempotency-Key já foi usada com outro conteúdo."}}}},"Erro429":{"description":"Limite por minuto ou por dia atingido. Veja o cabeçalho Retry-After (segundos).","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"},"example":{"error":"limite_de_taxa","message":"Muitas chamadas por minuto. Aguarde 12 segundo(s)."}}}},"Erro500":{"description":"Erro inesperado no servidor.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"},"example":{"error":"erro_interno","message":"Erro interno. Tente novamente."}}}},"Erro503":{"description":"A API foi desligada em todo o sistema (manutenção).","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"},"example":{"error":"api_desligada","message":"A API está desligada no momento."}}}}},"headers":{"XRequestId":{"description":"Identificador desta chamada, para suporte.","schema":{"type":"string"}},"XRateLimitLimit":{"description":"Chamadas por minuto permitidas para esta chave.","schema":{"type":"integer"}},"XRateLimitRemaining":{"description":"Chamadas que ainda restam na janela de 1 minuto.","schema":{"type":"integer"}},"XRateLimitReset":{"description":"Instante (segundos desde 1970) em que o limite volta.","schema":{"type":"integer"}},"RetryAfter":{"description":"Segundos para esperar antes de tentar de novo.","schema":{"type":"integer"}},"WWWAuthenticate":{"description":"Como autenticar: Bearer com a chave da API.","schema":{"type":"string"}},"Location":{"description":"Endereço do recurso criado.","schema":{"type":"string","format":"uri"}},"IdempotentReplayed":{"description":"\"true\" quando a resposta é a repetição de uma chamada anterior com a mesma Idempotency-Key.","schema":{"type":"string","enum":["true"]}}}}}