Criar peça jurídica a partir de um modelo

Cria a peça em Meus Documentos com o modelo preenchido e devolve o id. A peça abre no editor como as criadas pelo Juridiq: leva o papel timbrado quando o escritório o aplica automaticamente e dispara as automações de peça criada.

De onde sai cada valor (campos em GET /docs/templates/):

• values vence todos: a chave é o marcador sem chaves (PERSONALIZED.valor, PERSON.name.2) e "" apaga o marcador. Chave que o modelo não tem é ignorada;
• {{PERSON.<campo>}} e {{PERSON.<campo>.1}}: o cliente de personId, com os dados de GET /person/. Só personId preenche PERSON e põe a peça na pasta do cliente; lawSuitId sozinho não escolhe cliente;
• {{LAW_SUIT.<campo>}}: o processo de lawSuitId, com os dados de GET /lawSuit/ (ex.: valor da causa em R$);
• {{GENERAL.date}} e {{GENERAL.time}}: agora, no horário de Brasília.

O que fica sem valor (inclusive campo vazio no cadastro) continua como marcador no texto e volta em unresolved, para completar no editor ou criar de novo com values. Marcador partido entre trechos de formatação diferente e campo antigo do editor não são trocados nem entram em unresolved.

Com personId e lawSuitId juntos, o cliente tem de ser parte do processo.

Permissão: qualquer usuário do escritório da chave; cliente e processo privados seguem a privacidade dele.

Erros: 400 com campo fora do contrato ou quando o cliente não é parte do processo. 403 quando o cliente ou o processo é privado e o dono da chave não tem acesso; também 403 quando a chave é do Claude e o plano do escritório não inclui o MCP, ou quando o acesso do escritório está bloqueado. 404 quando o modelo, o cliente ou o processo não existe neste escritório. 413 quando o corpo passa de 1 MB.

POST /docs/from-template

Criar peça jurídica a partir de um modelo

cURL

curl --request POST \
  --url https://api.juridiq.com.br/docs/from-template \
  --header 'Content-Type: application/json' \
  --header 'x-juridiq-api-key: <api-key>' \
  --data '
{
  "templateId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "personId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "lawSuitId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "values": {}
}
'

201

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "personId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "createdAt": "2023-11-07T05:31:56Z",
  "unresolved": [
    "<string>"
  ]
}

Authorizations

x-juridiq-api-key · string · header · required

Chave de API do escritório (criada no painel). Envie o valor no header x-juridiq-api-key. A API aberta aplica rate limit por chave (veja a documentação de integradores).

Body

application/json

templateId · string<uuid> · required

ID do modelo (campo id de GET /docs/templates)

name · string

Nome da peça em Meus Documentos; sem ele, o nome do modelo

Required string length: 1 - 255

personId · string<uuid>

Cliente (GET /person): preenche {{PERSON.}} e {{PERSON..1}} e põe a peça na pasta dele

lawSuitId · string<uuid>

Processo (GET /lawSuit): preenche {{LAW_SUIT.}}

values · object

Valor por marcador, com a chave igual ao key de GET /docs/templates/{id} (ex.: { "PERSONALIZED.valor": "R$ 1.000,00", "PERSON.name.2": "Banco X" }). Vence o cliente, o processo e a data; "" apaga o marcador. Até 100 valores de até 10.000 caracteres

Show child attributes

Response

201

application/json

Default Response

id · string<uuid> · required

ID da peça criada

name · string · required

Nome da peça

personId · string<uuid> | null · required

Cliente em cuja pasta a peça está

createdAt · string<date-time> · required

Criação da peça (UTC)

unresolved · string[] · required

Marcadores que ficaram sem valor, no formato de key, sem repetição e na ordem do modelo