Projeto mareIA: módulo AgroSUS para telemonitoramento e apoio à identificação precoce de intoxicações por uso de defensivos agrícolas
0.1.0 - ci-build Brazil flag

Projeto mareIA: módulo AgroSUS para telemonitoramento e apoio à identificação precoce de intoxicações por uso de defensivos agrícolas, publicado por Fatec Ferraz de Vasconcelos. Este guia não é uma publicação autorizada; é a compilação contínua para a versão 0.1.0 construída pela FHIR (HL7® FHIR® Standard) CI Build. Esta versão é baseada no conteúdo atual de https://github.com/jefersonrl/AgroSUS-FHIR/tree/main e muda regularmente. Veja o Diretório de versões publicadas

CapabilityStatement: Requisitos de capacidade do servidor AgroSUS (Experimental)

Official URL: https://jefersonrl.github.io/AgroSUS-FHIR/CapabilityStatement/agrosus-server-capabilities Version: 0.1.0
Draft as of 2026-07-20 Computable Name: AgroSUSServerCapabilities

Define os recursos, interações, pesquisas e transações que devem ser suportados por uma implementação de servidor compatível com o AgroSUS.

Raw OpenAPI-Swagger Definition file | Download

Requisitos de capacidade do servidor AgroSUS

  • Guia de implementação Versão: 0.1.0
  • Versão FHIR: 4.0.1
  • Formatos suportados: json, xml
  • Publicado em: 2026-07-20
  • Publicado por: Fatec Ferraz de Vasconcelos

Nota para os implementadores: Capacidades FHIR

Qualquer capacidade FHIR pode ser "permitida" pelo sistema, exceto se for explicitamente assinalada como "NÃO DEVE". Alguns itens são marcados como MAY no Guia de Implementação para destacar a sua potencial relevância para o caso de utilização.

DEVERÁ suportar os seguintes guias de implementação

Capacidades FHIR RESTful

Mode: server

API FHIR R4 para cadastro e acompanhamento longitudinal do trabalhador rural. O aplicativo do ACS deve enviar a visita por Bundle transaction; o dashboard da UBS consulta os dados pelos parâmetros declarados neste CapabilityStatement.

Security
Ativar CORS: sim
Security services supported:

A implementação deve utilizar TLS, autenticação, autorização por função e registro de auditoria. CORS deve ser limitado às origens autorizadas em produção.

Resumo das interações a nível do sistema
  • Apoia o transactioninteração descrita da seguinte forma:

    Aceita a transação AgroSUS de sincronização da visita do ACS de forma atômica.

Capacidades por recurso/perfil

Resumo

A tabela de resumo enumera os recursos que fazem parte desta configuração e, para cada recurso, enumera-os:

  • Os perfis relevantes (se existirem)
  • As interações suportadas por cada recurso (Read, Search, Update, and Create, are always shown, while VRead, Patch, Delete, History on Instance, or History on Tsó estão presentes se pelo menos um dos recursos os suportar.
  • Os parâmetros de pesquisa obrigatórios, recomendados e alguns opcionais (se existirem).
  • Os recursos ligados activados para _include
  • Os outros recursos activados para _revinclude
  • As operações sobre o recurso (se existirem)
Tipo de recursoPerfilRSUCPesquisas_include_revincludeOperações
Patienthttps://jefersonrl.github.io/AgroSUS-FHIR/StructureDefinition/agrosus-patientyyyyidentifier, name
PractitionerPerfis suportados
  Agente Comunitário de Saúde AgroSUS
  Profissional Assistencial da UBS AgroSUS
yyidentifier, name
PractitionerRolePerfis suportados
  Função do ACS no AgroSUS
  Função do Profissional Assistencial da UBS AgroSUS
yypractitioner, organization, role, active
OrganizationPerfis suportados
  Unidade Básica de Saúde AgroSUS
  Laboratório AgroSUS
yyidentifier, name, active
Questionnaire yyurl, version, status
QuestionnaireResponsehttps://jefersonrl.github.io/AgroSUS-FHIR/StructureDefinition/agrosus-anamnese-responseyyyysubject, encounter, author, authored, status
EncounterPerfis suportados
  Visita do ACS AgroSUS
  Atendimento Clínico da UBS AgroSUS
yyyypatient, date, status, participant
ServiceRequesthttps://jefersonrl.github.io/AgroSUS-FHIR/StructureDefinition/agrosus-solicitacao-exameyyyypatient, authored, requester, status, code
Observationhttps://jefersonrl.github.io/AgroSUS-FHIR/StructureDefinition/agrosus-resultado-laboratorialyyyypatient, date, code, status, based-on
DiagnosticReporthttps://jefersonrl.github.io/AgroSUS-FHIR/StructureDefinition/agrosus-laudo-laboratorialyyyypatient, date, code, status, based-on
Conditionhttps://jefersonrl.github.io/AgroSUS-FHIR/StructureDefinition/agrosus-intoxicacao-pesticidayyyypatient, clinical-status, verification-status, code, onset-date
CarePlanhttps://jefersonrl.github.io/AgroSUS-FHIR/StructureDefinition/agrosus-plano-acompanhamentoyyyypatient, status, date, category
Provenancehttps://jefersonrl.github.io/AgroSUS-FHIR/StructureDefinition/agrosus-provenanceyyyytarget, agent, recorded
AuditEventhttps://jefersonrl.github.io/AgroSUS-FHIR/StructureDefinition/agrosus-audit-eventyyagent, date, entity, action

Perfil do sistema de base
Paciente AgroSUS
Conformidade do perfil
SHALL
Política de referência
literal, local

Resumo da interação
  • Apoios create, read, update, search-type.

Parâmetros de pesquisa
ConformidadeParâmetroTipoDocumentação
SHALLidentifiertoken

Localiza o trabalhador por CPF ou CNS usando system|value.

SHALLnamestring
 
Recurso FHIR principal
Practitioner
Política de referência
literal
Resumo da interação
  • Apoios read, search-type.

Parâmetros de pesquisa
ConformidadeParâmetroTipoDocumentação
SHALLidentifiertoken
SHALLnamestring
 
Recurso FHIR principal
PractitionerRole
Política de referência
literal
Resumo da interação
  • Apoios read, search-type.

Parâmetros de pesquisa
ConformidadeParâmetroTipoDocumentação
SHALLpractitionerreference
SHALLorganizationreference
SHALLroletoken
SHALLactivetoken
 
Recurso FHIR principal
Organization
Política de referência
literal
Resumo da interação
  • Apoios read, search-type.

Parâmetros de pesquisa
ConformidadeParâmetroTipoDocumentação
SHALLidentifiertoken
SHALLnamestring
SHALLactivetoken
 
Recurso FHIR principal
Questionnaire
Política de referência
Resumo da interação
  • Apoios read, search-type.

Parâmetros de pesquisa
ConformidadeParâmetroTipoDocumentação
SHALLurluri
SHALLversiontoken
SHALLstatustoken
 
Perfil do sistema de base
Resposta da Anamnese AgroSUS
Conformidade do perfil
SHALL
Política de referência
literal, local

Resumo da interação
  • Apoios create, read, update, search-type.

Parâmetros de pesquisa
ConformidadeParâmetroTipoDocumentação
SHALLsubjectreference
SHALLencounterreference
SHALLauthorreference
SHALLauthoreddate
SHALLstatustoken
 
Recurso FHIR principal
Encounter
Política de referência
literal, local
Resumo da interação
  • Apoios create, read, update, search-type.

Parâmetros de pesquisa
ConformidadeParâmetroTipoDocumentação
SHALLpatientreference
SHALLdatedate
SHALLstatustoken
SHALLparticipantreference
 
Perfil do sistema de base
Solicitação de Exame AgroSUS
Conformidade do perfil
SHALL
Política de referência
literal

Resumo da interação
  • Apoios create, read, update, search-type.

Parâmetros de pesquisa
ConformidadeParâmetroTipoDocumentação
SHALLpatientreference
SHALLauthoreddate
SHALLrequesterreference
SHALLstatustoken
SHALLcodetoken
 
Perfil do sistema de base
Resultado Laboratorial AgroSUS
Conformidade do perfil
SHALL
Política de referência
literal

Resumo da interação
  • Apoios create, read, update, search-type.

Parâmetros de pesquisa
ConformidadeParâmetroTipoDocumentação
SHALLpatientreference
SHALLdatedate
SHALLcodetoken
SHALLstatustoken
SHALLbased-onreference
 
Perfil do sistema de base
Laudo Laboratorial AgroSUS
Conformidade do perfil
SHALL
Política de referência
literal

Resumo da interação
  • Apoios create, read, update, search-type.

Parâmetros de pesquisa
ConformidadeParâmetroTipoDocumentação
SHALLpatientreference
SHALLdatedate
SHALLcodetoken
SHALLstatustoken
SHALLbased-onreference
 
Conformidade do perfil
SHALL
Política de referência
literal

Resumo da interação
  • Apoios create, read, update, search-type.

Parâmetros de pesquisa
ConformidadeParâmetroTipoDocumentação
SHALLpatientreference
SHALLclinical-statustoken
SHALLverification-statustoken
SHALLcodetoken
SHALLonset-datedate
 
Perfil do sistema de base
Plano de Acompanhamento AgroSUS
Conformidade do perfil
SHALL
Política de referência
literal

Resumo da interação
  • Apoios create, read, update, search-type.

Parâmetros de pesquisa
ConformidadeParâmetroTipoDocumentação
SHALLpatientreference
SHALLstatustoken
SHALLdatedate
SHALLcategorytoken
 
Perfil do sistema de base
Proveniência dos Registros AgroSUS
Conformidade do perfil
SHALL
Política de referência
literal, local

Resumo da interação
  • Apoios create, read, update, search-type.

Parâmetros de pesquisa
ConformidadeParâmetroTipoDocumentação
SHALLtargetreference
SHALLagentreference
SHALLrecordeddate
 
Perfil do sistema de base
Evento de Auditoria AgroSUS
Conformidade do perfil
SHALL
Política de referência
literal

Resumo da interação
  • Apoios read, search-type.

Parâmetros de pesquisa
ConformidadeParâmetroTipoDocumentação
SHALLagentreference
SHALLdatedate
SHALLentityreference
SHALLactiontoken