processed-updates.md

Serviços de integração Comply x AGHUse

...

Consultar dados da solicitação e itens

Descrição

Este endpoint retorna uma lista de atos cirúrgicos que tiveram alterações recentes e precisam ser reprocessados pelo sistema AGHUse. A consulta retorna um identificador único (surgicalActGetId) que deve ser utilizado posteriormente para confirmar o processamento dos registros.

Acesso

Endereço: ~/api/surgical-act/
Método HTTP: GET
Tipo: application/json

Parâmetros do cabeçalho

Parâmetro	Descrição
Authorization	Token de autenticação

Retorno com sucesso

Código de Resposta: 200
Formato: application/json

Campos do corpo

Campo	Tipo	Descrição	Preenchimento	Exemplo
surgicalActGetId	UUID	id para sincronização de procesamento e evitar concorrencia	Obrigatório	8ba84dce-0c90-4a5a-8a18-0a5f39fde8e5
data	Array[SurgicalAct]	Lista de atos cirúrgicos	Obrigatório
data.[].id	UUID	Id do ato cirurgico	Obrigatório	654d82a8-b2a2-4e34-a680-ec6d45cffabd
data.[].register_date	datetime	Data de registro do ato cirúrgico	Opcional	2025-12-12T10:30:00Z
data.[].expected_date	datetime	Data prevista da cirurgia	Opcional	2025-12-15T14:00:00Z
data.[].nature	Nature (enum)	Natureza do procedimento	Opcional	"ELETIVA"
data.[].patient_id	UUID	Id do paciente	Opcional	123e4567-e89b-12d3-a456-426614174000
data.[].doctor_id	UUID	Id do médico responsável	Opcional	123e4567-e89b-12d3-a456-426614174001
data.[].medical_team_id	UUID	Id da equipe médica	Opcional	123e4567-e89b-12d3-a456-426614174002
data.[].healthcare_insurance_id	UUID	Id do convênio/plano de saúde	Opcional	123e4567-e89b-12d3-a456-426614174003
data.[].allergies	Array[string]	Lista de alergias do paciente	Opcional	["penicilina", "látex"]
data.[].surgical_technique	string	Descrição da técnica cirúrgica	Opcional	"Laparoscopia"
data.[].situation	Situation (enum)	Situação atual do ato cirúrgico	Opcional	"PENDENTE"
data.[].situation_date	datetime	Data da última alteração de situação	Opcional	2025-12-12T11:00:00Z
data.[].external_status	ExternalStatus (enum)	Status externo do ato	Opcional	"AGUARDANDO_APROVACAO"
data.[].external_id	integer	Id externo do sistema AGHUse	Opcional	12345
data.[].procedures_requested	Array[ProcedureRequested]	Lista de procedimentos solicitados	Opcional
data.[].procedures_requested.[].procedure_id	UUID	Id do procedimento	Obrigatório	123e4567-e89b-12d3-a456-426614174004
data.[].procedures_requested.[].opmes_requested	Array[OPMERequested]	Lista de OPMEs solicitadas para o procedimento	Opcional
data.[].procedures_requested.[].opmes_requested.id	UUID	Id da OPME solicitada	Obrigatório	123e4567-e89b-12d3-a456-426614174005
data.[].procedures_requested.[].opmes_requested...	...	Outros campos da OPME (ver detalhamento abaixo)	...	...

Detalhamento dos campos de OPME Solicitada

Campo	Tipo	Descrição	Preenchimento	Exemplo
data.[].procedures_requested.[].opmes_requested.[].id	UUID	Id da OPME solicitada	Obrigatório	123e4567-e89b-12d3-a456-426614174005
data.[].procedures_requested.[].opmes_requested.[].quantity	integer	Quantidade solicitada	Obrigatório	2
data.[].procedures_requested.[].opmes_requested.[].process_status	QuotationProcessStatus	Status do processo de cotação	Obrigatório	"PENDENTE"
data.[].procedures_requested.[].opmes_requested.[].description	string	Descrição da OPME	Opcional	"Prótese de joelho"
data.[].procedures_requested.[].opmes_requested.[].specification	string	Especificação técnica	Opcional	"Tamanho médio"
data.[].procedures_requested.[].opmes_requested.[].post_bid	boolean	Indica se é pós-licitação	Obrigatório	false
data.[].procedures_requested.[].opmes_requested.[].is_bid	boolean	Indica se está em licitação	Obrigatório	false
data.[].procedures_requested.[].opmes_requested.[].opme	Opme	Dados da OPME cadastrada	Opcional
data.[].procedures_requested.[].opmes_requested.[].opme.id	UUID	Id da OPME no catálogo	Obrigatório	123e4567-e89b-12d3-a456-426614174006
data.[].procedures_requested.[].opmes_requested.[].opme.TUSS_ID	string	Código TUSS	Obrigatório	"10101012-0"
data.[].procedures_requested.[].opmes_requested.[].opme.RMS_ID	string	Código RMS (Anvisa)	Obrigatório	"80123456789012"
data.[].procedures_requested.[].opmes_requested.[].opme.HCPA_ID	string	Código interno HCPA	Obrigatório	"HCPA12345"
data.[].procedures_requested.[].opmes_requested.[].opme.name	string	Nome da OPME	Obrigatório	"Prótese de Joelho Total"
data.[].procedures_requested.[].opmes_requested.[].opme.brand	Array[string]	Marcas disponíveis	Obrigatório	["Stryker", "Zimmer"]
data.[].procedures_requested.[].opmes_requested.[].opme.model	string	Modelo	Obrigatório	"Total Knee System"
data.[].procedures_requested.[].opmes_requested.[].opme.description	string	Descrição detalhada	Obrigatório	"Prótese completa para joelho"
data.[].procedures_requested.[].opmes_requested.[].opme.medicament	string	Medicamento associado (se aplicável)	Obrigatório	""

Exemplo

{
  "surgicalActGetId": "8ba84dce-0c90-4a5a-8a18-0a5f39fde8e5",
  "data": [
    {
      "id": "654d82a8-b2a2-4e34-a680-ec6d45cffabd",
      "register_date": "2025-12-12T10:30:00Z",
      "expected_date": "2025-12-15T14:00:00Z",
      "nature": "ELETIVA",
      "patient_id": "123e4567-e89b-12d3-a456-426614174000",
      "doctor_id": "123e4567-e89b-12d3-a456-426614174001",
      "medical_team_id": "123e4567-e89b-12d3-a456-426614174002",
      "healthcare_insurance_id": "123e4567-e89b-12d3-a456-426614174003",
      "allergies": ["penicilina", "látex"],
      "surgical_technique": "Laparoscopia",
      "situation": "PENDENTE",
      "situation_date": "2025-12-12T11:00:00Z",
      "external_status": "AGUARDANDO_APROVACAO",
      "external_id": 12345,
      "procedures_requested": [
        {
          "procedure_id": "123e4567-e89b-12d3-a456-426614174004",
          "opmes_requested": [
            {
              "id": "123e4567-e89b-12d3-a456-426614174005",
              "quantity": 2,
              "process_status": "PENDENTE",
              "description": "Prótese de joelho",
              "specification": "Tamanho médio",
              "post_bid": false,
              "is_bid": false,
              "opme": {
                "id": "123e4567-e89b-12d3-a456-426614174006",
                "TUSS_ID": "10101012-0",
                "RMS_ID": "80123456789012",
                "HCPA_ID": "HCPA12345",
                "name": "Prótese de Joelho Total",
                "brand": ["Stryker", "Zimmer"],
                "model": "Total Knee System",
                "description": "Prótese completa para joelho",
                "medicament": ""
              }
            }
          ]
        }
      ]
    }
  ]
}

Retorno com erro

Código de Resposta: diferente de 2XX
Formato: application/json

Campos do corpo

Campo	Tipo	Descrição

Possíveis erros

tipoErro	mensagemErro

Indicar processamento das atualizações

Descrição

Este endpoint permite ao sistema AGHUse confirmar que processou os atos cirúrgicos recebidos anteriormente através da consulta. Deve-se enviar o identificador da consulta (surgicalActGetId) juntamente com a lista de IDs dos atos cirúrgicos que foram processados com sucesso. Isso garante o controle de concorrência e evita que os mesmos registros sejam processados múltiplas vezes.

Acesso

Endereço: ~/api/surgical-act/processed
Método HTTP: PUT
Tipo: application/json

Parâmetros do cabeçalho

Parâmetro	Descrição
Authorization	Token de autenticação

Parâmetros do corpo

Parâmetro	Tipo	Descrição	Preenchimento	Exemplo
surgicalActGetId	UUID	id obtido na consulta inicial para evitar concorrencia	Obrigatório	8ba84dce-0c90-4a5a-8a18-0a5f39fde8e5
processados	Array[UUID]	Lista de ids dos atos cirurgicos processados	Obrigatório	["0a982fb5-7659-4039-9074-f76f197db9f6", "7ae3bcd4-0683-4a4e-85a6-98ae60c3dca0"]

Retorno com sucesso

Código de Resposta: 200
Formato: application/json

Campos do corpo

Campo	Tipo	Descrição	Preenchimento	Exemplo
data	Array[SurgicalAct]		Obrigatório
data.[].id	UUID	Id do ato cirurgico	Obrigatório	654d82a8-b2a2-4e34-a680-ec6d45cffabd
data.[]....	...		...	...

Exemplo

{
  "data": [
    {
      "id": "654d82a8-b2a2-4e34-a680-ec6d45cffabd",
      "...": "..."
    }
  ]
}

Retorno com erro

Código de Resposta: diferente de 2XX Formato: application/json

Campos do corpo

Campo	Tipo	Descrição

Possíveis erros

tipoErro	mensagemErro