> ## Documentation Index
> Fetch the complete documentation index at: https://docs.judit.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Schema Communication (Diário Oficial de Justiça)

> Estrutura do objeto Communication retornado pelo monitoramento do Diário de Justiça Eletrônico Nacional (DJEN) na Judit API. Inclui dados da publicação, destinatários, advogados vinculados e texto integral.

> 🤖 O monitoramento do Diário de Justiça Eletrônico Nacional (DJEN) retorna o objeto `communication`. Cada objeto representa uma publicação do DJEN em que houve correspondência com o termo monitorado. A raiz contém os metadados da publicação (datas, tribunal, tipo). Os destinatários ficam no array `recipients` e os advogados vinculados a eles em `recipient_lawyers`.

## Estrutura Geral

O JSON de uma comunicação é organizado em 4 blocos principais:

* **Metadados da Publicação (raiz):** Identificação, datas, status, tribunal e tipo da comunicação.
* **Destinatários (`recipients`):** Partes do processo diretamente citadas na publicação — podem ser advogados ou não-advogados.
* **Destinatários Advogados (`recipient_lawyers`):** Advogados vinculados às partes, com dados de OAB.
* **Texto Integral (`text`):** Conteúdo completo da publicação conforme extraído do DJEN.

***

## Dicionário de Dados

### 1. Metadados da Publicação (Raiz do Objeto)

Estas propriedades vêm diretamente na raiz do objeto `response_data`.

#### Campos obrigatórios

| Propriedade | Tipo | Descrição |
| :- | :- | :- |
| `communication_id` | string | Identificador único da comunicação no sistema da Judit. |
| `active` | boolean | Indica se a comunicação está ativa (`true`) ou foi cancelada (`false`). |
| `date_availability` | string (ISO 8601) | Data em que a publicação ficou disponível no DJEN para consulta. |
| `date_shipping` | string (ISO 8601) | Data de expedição/envio da comunicação pelo tribunal. |
| `hash` | string | Hash único da publicação, identificador do DJEN. |
| `lawsuit_code` | string | Número do processo vinculado no formato CNJ (ex: `"0000000-00.0000.8.00.0000"`). |
| `tribunal_acronym` | string | Sigla oficial do tribunal emissor (ex: `"TJSP"`, `"TJRJ"`, `"TRT2"`). |
| `status` | string | Status da publicação no DJEN (ex: `"P"` para publicado). |
| `text` | string | Texto integral da publicação conforme extraído do Diário de Justiça Eletrônico Nacional. |
| `source` | string | Sistema de origem da publicação (ex: `"pje"`, `"esaj"`). |

#### Campos opcionais

| Propriedade | Tipo | Descrição |
| :- | :- | :- |
| `classification_code` | string | Código da classe processual associada à comunicação. |
| `classification_name` | string | Nome da classe processual (ex: `"EXECUÇÃO DE TÍTULO EXTRAJUDICIAL"`). |
| `date_cancellation` | string (ISO 8601) | Data de cancelamento da comunicação, quando aplicável. |
| `reason_cancellation` | string | Motivo do cancelamento da comunicação, quando aplicável. |
| `api_id` | number | ID interno da comunicação no sistema de origem. |
| `middle` | string | Código abreviado do veículo de publicação (ex: `"D"` para DJEN). |
| `full_middle` | string | Nome completo do veículo de publicação (ex: `"DIÁRIO DE JUSTIÇA ELETRÔNICO NACIONAL"`). |
| `name_organ` | string | Nome do órgão responsável pela publicação (ex: `"1ª VARA CÍVEL"`). |
| `communication_number` | number | Número sequencial da comunicação dentro da edição do DJEN. |
| `communication_type` | string | Tipo da comunicação (ex: `"INTIMAÇÃO"`, `"CITAÇÃO"`). |
| `document_type` | string | Tipo do documento publicado (ex: `"DECISÃO"`, `"DESPACHO"`, `"SENTENÇA"`). |
| `integrate_api` | boolean | Indica se a comunicação foi integrada via API externa. |

***

### 2. Destinatários (`recipients`)

Array com as pessoas diretamente citadas na publicação — podem ser advogados ou não-advogados (partes do processo). Todos os campos são obrigatórios.

| Propriedade | Tipo | Descrição |
| :- | :- | :- |
| `communication_id` | number | ID interno da comunicação à qual o destinatário está vinculado. |
| `name` | string | Nome completo do destinatário conforme consta na publicação. |
| `side` | string | Polo da parte no processo: `"Active"` (polo ativo) ou `"Passive"` (polo passivo). |

***

### 3. Advogados dos Destinatários (`recipient_lawyers`)

Array com os advogados vinculados aos destinatários da comunicação. Todos os campos são obrigatórios.

#### Objeto raiz do vínculo

| Propriedade | Tipo | Descrição |
| :- | :- | :- |
| `id` | number | Identificador único do vínculo advogado-comunicação. |
| `lawyer_id` | number | ID do advogado (referência ao objeto `lawyer`). |
| `communication_id` | number | ID interno da comunicação à qual o advogado está vinculado. |
| `created_at` | string | Data de criação do registro do vínculo. |
| `updated_at` | string | Data da última atualização do registro do vínculo. |

#### Objeto `lawyer` (aninhado)

| Propriedade | Tipo | Descrição |
| :- | :- | :- |
| `id` | number | Identificador único do advogado no sistema. |
| `name` | string | Nome completo do advogado. |
| `license_code` | string | Número de registro na OAB. |
| `license_state` | string | UF da seccional da OAB (ex: `"SP"`, `"RJ"`). |

***

## Exemplo de Payload (Communication)

<CodeGroup>
  ```json Resposta theme={null}
  {
    "page": 1,
    "page_count": 1,
    "all_count": 1,
    "all_pages_count": 1,
    "page_data": [
      {
        "request_id": "186e0ed5-4656-4fd8-8e07-76f755c44a9d",
        "response_id": "dd47b9fc-8f66-46b8-a31a-50a4718c9774",
        "origin": "tracking",
        "origin_id": "a94db796-9e35-4d0c-8e05-2a6b60f32a74",
        "response_type": "communication",
        "response_data": {
          "communication_id": "0E6hgZvG",
          "active": true,
          "classification_code": "12154",
          "classification_name": "EXECUÇÃO DE TÍTULO EXTRAJUDICIAL",
          "date_availability": "2026-05-20T00:00:00.000Z",
          "date_shipping": "2026-05-19T03:00:00.000Z",
          "recipient_lawyers": [
            {
              "lawyer": {
                "id": 10001,
                "name": "ADVOGADO EXEMPLO 1",
                "license_code": "0001",
                "license_state": "SP"
              },
              "lawyer_id": 10001,
              "communication_id": 600000001,
              "id": 1100000001,
              "created_at": "2026-05-19 11:44:08",
              "updated_at": "2026-05-19 11:44:08"
            }
          ],
          "recipients": [
            {
              "communication_id": 600000001,
              "name": "PARTE ATIVA EXEMPLO",
              "side": "Active"
            },
            {
              "communication_id": 600000001,
              "name": "PARTE PASSIVA EXEMPLO 1",
              "side": "Passive"
            }
          ],
          "hash": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
          "api_id": 600000001,
          "middle": "D",
          "full_middle": "DIÁRIO DE JUSTIÇA ELETRÔNICO NACIONAL",
          "name_organ": "COMARCA - 1ª VARA CÍVEL",
          "communication_number": 2674,
          "lawsuit_code": "0000000-00.0000.8.00.0000",
          "tribunal_acronym": "TJXX",
          "status": "P",
          "text": "Texto completo da publicação conforme extraído do DJEN...",
          "communication_type": "INTIMAÇÃO",
          "document_type": "DECISÃO",
          "integrate_api": false,
          "source": "pje"
        },
        "user_id": "00000000-0000-0000-0000-000000000000",
        "created_at": "2026-05-20T20:12:47.839Z",
        "updated_at": "2026-05-20T20:12:47.839Z"
      }
    ]
  }
  ```
</CodeGroup>

***

## Próximos Passos

* 👉 **[Monitoramento do Diário Oficial](/tracking/tracking-communication):** Veja como configurar o monitoramento do DJEN e receber publicações via webhook.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.