Exames agendados no seu RIS/HIS podem ser enviados ao Rdicom PACS. O aparelho consulta essa lista e recebe os dados do paciente e do exame, evitando redigitação na sala.
Do agendamento à lista do aparelho
Método: POST
Endpoint: /api/integracao/servidor-dicom/{uuid}/worklists
Autorização: Bearer Token
Troque {uuid} pelo identificador do servidor informado pela Rdicom. Em Body → raw → JSON, envie o mesmo objeto de agendamento usado pela integração. Exemplo fictício:
{
"patientId": "HML-PAC-0001",
"patientName": "PACIENTE^FICTICIO",
"patientBirthDate": "19900115",
"patientSex": "F",
"accessionNumber": "HML-EXAME-0001",
"requestedProcedureId": "HML-PROC-0001",
"requestedProcedureDescription": "ULTRASSONOGRAFIA DE ABDOME",
"scheduledProcedureStepId": "HML-AGENDA-0001",
"scheduledProcedureStepDescription": "ULTRASSONOGRAFIA DE ABDOME",
"scheduledProcedureStepStartDate": "2026-11-10T09:00:00-03:00",
"modality": "US"
}
| Campo | O que enviar |
|---|---|
patientId |
Identificador do paciente no seu sistema. Preserve zeros à esquerda. |
patientName |
Nome no formato DICOM combinado nos testes, como SOBRENOME^NOME. |
patientBirthDate |
Nascimento sem barras: ano, mês e dia (YYYYMMDD). |
patientSex |
Código do sexo aceito pelo ambiente, como F, M ou O. |
accessionNumber |
Número de acesso que liga o atendimento do seu sistema ao exame. |
requestedProcedureId e scheduledProcedureStepId |
Identificadores do procedimento e do agendamento. |
| Campos de descrição | Descrição do procedimento/exame a realizar. |
scheduledProcedureStepStartDate |
Data e hora com fuso, como no exemplo. |
modality |
Modalidade do aparelho: por exemplo CR, CT, MR, US ou MG. |
Os campos opcionais que você já utiliza continuam aceitos. Por exemplo: patientSize (altura em metros), patientWeight (peso em kg), patientComments (observações), requestingPhysician e referringPhysicianName (médico solicitante). Use ponto nos números decimais. A exibição de observações depende do aparelho.
Se sua integração utiliza scheduledProcedureStepStartTime, mantenha esse campo; ele aceita horários como 0900 ou 090000. Quando omitido, o serviço usa a hora da data enviada.
HTTP 201, com o próprio agendamento e os identificadores devolvidos pela API. A resposta não é um recibo de fila.
Guarde o studyInstanceUid retornado, junto de scheduledProcedureStepId e accessionNumber. Esses valores serão usados para consultar, atualizar ou remover o agendamento. Nos testes, confira também se a agenda aparece corretamente no aparelho.
Salve o JSON em agendamento.json:
curl --request POST "$BASE_URL/api/integracao/servidor-dicom/$SERVER_UUID/worklists" \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header 'Content-Type: application/json' \
--data-binary @agendamento.json
No Postman, use 06 — Enviar agendamento para worklist. Não acrescente envelope de evento, assinatura ou campos novos para trocar a autenticação.
Use o fluxo de atualização já combinado para sua versão do PACS. Preserve o studyInstanceUid recebido no primeiro envio e o scheduledProcedureStepId original. Não gere novos identificadores para corrigir o mesmo agendamento. Confirme esse comportamento no ambiente de testes antes de aplicar em produção.
Método: GET
Endpoint: /api/worklists