GET Listar Relatórios de Procedimentos

Lista os relatórios de procedimentos agrupados por paciente ou por procedimento dentro de um período.

Autenticação necessária

Esta rota requer o header Authorization: Bearer {accessToken}

Campos obrigatórios

Os parâmetros from e to são obrigatórios para esta requisição.

---

Endpoint

GET https://api-dev.imagemais.com.br/api/laboratories/procedures-report

---

Parâmetros de Query

Nome	Tipo	Obrigatório	Valores válidos	Descrição
from	string	✅	YYYY-MM-DD	Data inicial do período
to	string	✅	YYYY-MM-DD	Data final do período
viewType	string	❌	patients, procedures	Tipo de visualização (padrão: patients)
search	string	❌	qualquer	Busca por nome do paciente ou CPF (só tem efeito com viewType=patients)

Valores de viewType

Valor	Descrição
patients (padrão)	Retorna os pedidos (Orders) com liberação (RELEASE) no período, com os dados brutos de paciente e orçamentos vinculados
procedures	Retorna a contagem de procedimentos realizados no período, agrupados por nome

Sem paginação

Esta rota não tem parâmetros de paginação (limit/cursor) — em viewType=patients todos os pedidos do período são retornados de uma vez.

viewType=patients expõe dados brutos

Ao contrário de viewType=procedures, o modo patients não filtra nem sanitiza os campos: retorna o registro completo de Orders (incluindo IDs internos como statusId, createUserId, acceptUserId) e, dentro dele, o paciente completo (cpf, telefone, IDs de endereço/contato) e os orçamentos (budgets) vinculados com seus procedimentos e preços.

---

Requisição

curl -X 'GET' \
  'https://api-dev.imagemais.com.br/api/laboratories/procedures-report?from=2025-08-01&to=2025-08-05&viewType=procedures' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer {accessToken}'

---

Respostas

200 Sucesso (viewType=procedures)

[
  {
    "name": "HEMOGRAMA SEM REVISAO",
    "total": 36,
    "costPrice": 2.89,
    "salePrice": 12
  },
  {
    "name": "GLICOSE JEJUM",
    "total": 31,
    "costPrice": 0.71,
    "salePrice": 7
  },
  {
    "name": "CREATININA",
    "total": 28,
    "costPrice": 0.93,
    "salePrice": 8
  }
]

200 Sucesso (viewType=patients — padrão)

Array de pedidos (Orders) com o registro bruto do banco, sem seleção de campos.

[
  {
    "id": 3130,
    "statusId": 3,
    "createUserId": 19,
    "acceptUserId": 5,
    "createdAt": "2025-09-19T15:43:46.944Z",
    "expirationDate": null,
    "accountId": 1,
    "updatedAt": "2025-09-19T15:44:17.950Z",
    "ulid": null,
    "requestingDoctorId": null,
    "observationId": null,
    "patientExams": {
      "uuid": "<examUuid>",
      "prefix": "IMGM",
      "patientId": 7325,
      "createdAt": "2025-09-19T15:43:46.960Z",
      "updatedAt": "2025-09-19T15:43:46.960Z",
      "deletedAt": null,
      "orderId": 3130,
      "patient": {
        "id": 7325,
        "accountId": 1,
        "name": "NOME DO PACIENTE",
        "dateBirth": "2004-08-05T00:00:00.000Z",
        "genderId": 1,
        "rg": null,
        "cpf": "00000000000",
        "addressId": 7325,
        "contactId": 7328,
        "createdAt": "2025-09-19T15:42:03.110Z",
        "updatedAt": "2025-09-19T15:42:24.266Z",
        "deletedAt": null,
        "contact": {
          "id": 7328,
          "phone": "00000000000",
          "email": null,
          "secondary_phone": null
        },
        "gender": {
          "id": 1,
          "name": "F"
        }
      }
    },
    "budgets": [
      {
        "id": 8401,
        "createUserId": 19,
        "patientId": 7325,
        "statusId": 2,
        "createdAt": "2025-09-19T15:42:03.118Z",
        "updatedAt": "2025-09-19T15:42:24.266Z",
        "deletedAt": null,
        "discountId": null,
        "requestingDoctorId": null,
        "observationId": null,
        "budgetsProcedures": [
          {
            "id": 86215,
            "budgetId": 8401,
            "procedureId": 3627,
            "price": "20",
            "procedure": {
              "id": 3627,
              "name": "TESTE RAPIDO DE GRAVIDEZ - BETA HCG",
              "synonyms": "teste de gravidez, teste rápido de gravidez, ...",
              "price": "20",
              "accountId": 1,
              "createdAt": "2025-03-07T13:31:00.171Z",
              "updatedAt": "2026-01-19T11:50:22.436Z",
              "deletedAt": null,
              "laudoLocal": true,
              "typeId": null,
              "referralId": null
            }
          }
        ]
      }
    ]
  }
]

200 Sem resultados

Retornado quando não há pedidos/procedimentos no período informado, em qualquer viewType.

[]