PNE → Xjur CM

Esta seção descreve como a PNE (Proposta de Negociação) envia propostas aprovadas para o Xjur CM através do XJUR Connect. Ao receber uma proposta válida, o Xjur abre automaticamente a pasta com os dados da negociação já carregados, dispensando digitação pelo Jurídico.

O que esta integração faz

Ao receber uma requisição, o XJUR Connect:

1. Valida a identificação da proposta e a estrutura das listas
2. Consulta o Xjur para verificar se aquela proposta já tem pasta ativa
3. Encaminha a proposta ao Xjur, que aplica as regras de negócio e cria a pasta
4. Retorna o identificador da pasta e o número do chamado

Funcionalidades principais

Funcionalidade	Descrição
Endpoint único	Um POST /pne/contratos recebe a proposta inteira
Idempotência	Reenvio da mesma proposta devolve a pasta existente, sem duplicar
Pass-through de JWT	O token informado é repassado ao Xjur automaticamente
Erros padronizados	Todos os erros retornam { codigo, descricao } com HTTP status apropriado

Como a proposta é identificada

A chave é a combinação de três campos, e é ela que liga a proposta na PNE à pasta no Xjur:

Campo	Descrição
numeroPne	Sequencial da proposta
numeroVersaoPne	Versão da proposta
numeroElaboracaoVersaoPne	Versão da elaboração

Reenviar a mesma combinação não cria uma segunda pasta. A resposta traz a pasta já existente.

Quando a proposta é desdobramento de outra, envie isNovaPasta igual a 0 e informe a proposta de origem em numeroPnePai. Sem isso a requisição é rejeitada, porque o vínculo entre as duas pastas se perderia.

Pré-requisitos

• Token JWT de usuário de serviço, obtido em POST /Autenticacao/AuthenticateUserService. É o mesmo endpoint e o mesmo tipo de credencial que a integração de anexos da PNE já usa. Veja Obtendo o token.
• Chave de assinatura do APIM
• Proposta aprovada na PNE, com o payload montado conforme a DME 12132

O token precisa ser de usuário de serviço

Um token de usuário humano é recusado com 401, ainda que seja válido. O Xjur exige que a conta esteja marcada como usuário de serviço para receber integrações. É a causa mais comum de 401 em integração nova.

Exemplo rápido

curl -X POST https://apim-xjur-prd.xjur.com.br/connect/pne/contratos \
  -H "Authorization: Bearer <seu-token-jwt>" \
  -H "X-XJUR-SUBSCRIPTION-KEY: <sua-chave>" \
  -H "Content-Type: application/json" \
  -d '{
    "numeroPne": "1711454",
    "numeroVersaoPne": "001",
    "numeroElaboracaoVersaoPne": "003",
    "isNovaPasta": 1,
    "negociacoesList": [
      {
        "codigoTipoNegociacao": 1,
        "tipoNegociacao": "Asseguramento",
        "docContabil": "88094003",
        "tipoContratoPNE": "6",
        "partesContrariasList": [
          { "papelSignatarioId": 80, "CPFCNPJParte": "23157890000114" }
        ]
      }
    ]
  }'

Resposta de sucesso, 201 Created:

{
  "contratoId": 123456,
  "numeroContrato": "10.001",
  "message": "Contrato criado com sucesso."
}

Quem dispara a chamada

O gatilho é responsabilidade exclusiva da PNE. O Xjur não consulta, não agenda e não infere o momento do envio: ele recebe, valida e processa o que chegar.

O que ainda não está disponível

O método de revisão/ajuste, que cancela a pasta quando a proposta volta para revisão, ainda não tem contrato de dados definido na DME e não está implementado.

A sugestão automática de minutas é uma fase posterior. Hoje a pasta nasce com os dados da proposta; a escolha dos instrumentos permanece com o Jurídico.