Agora no Bluesoft ERP, é possível consulta, inclusão e atualização dos dados da Denominação Comum Brasileira (DCB) via API.

Para facilitar a gestão de medicamentos e permitir a manipulação da nomenclatura oficial de fármacos aprovada pela Anvisa fora do ambiente do ERP, desenvolvemos novos endpoints. Agora, é possível realizar a consulta, inclusão e atualização dos dados da Denominação Comum Brasileira (DCB) via integração.

Anteriormente, estes dados só podiam ser consultados e geridos através da tela de Cadastros de Denominação Comum Brasileira (DCB) no menu de Farmácia.

1. Consultar DCB (GET)

Permite realizar uma busca genérica pelos registros da base com suporte a paginação. É possível utilizar filtros opcionais para refinar a busca:

• Filtros disponíveis: codigoDcb, substancia (busca por texto parcial) e numeroCas.

• Paginação: Parâmetros currentPage e pageSize.

Endpoint: /api/comercial/produtos/medicamentos/dcb

2. Obter DCB por ID (GET)

Permite buscar os detalhes de um registro específico informando a sua chave única (dcbKey).

Endpoint: /api/comercial/produtos/medicamentos/dcb/{dcbKey}

3. Incluir DCB (POST)

Permite o cadastro de uma nova DCB no sistema. O payload deve conter os seguintes campos obrigatórios:

• codigoDcb: Código numérico do DCB (Integer).

• substancia: Descrição da substância (String, máx. 200 caracteres).

• numeroCas: Número de Registro CAS (String, máx. 15 caracteres).

Endpoint: /api/comercial/produtos/medicamentos/dcb

Exemplo de JSON:

{
    "codigoDcb": 1234,	
    "substancia": "TESTE",
    "numeroCas": "123-456-563"	
}

4. Atualizar DCB (PUT)

Permite a atualização de um registro existente. Diferente da inclusão, este endpoint permite a edição apenas dos campos substancia e numeroCas. O codigoDcb não pode ser alterado para garantir a integridade do cadastro.

Endpoint:/api/comercial/produtos/medicamentos/dcb/{dcbKey}

Exemplo de JSON:

{
    "substancia": "TESTE",
    "numeroCas": "123-456-563"	
}

Permissões Necessárias

Para utilizar os novos endpoints, o usuário da API deve possuir as permissões específicas associadas ao seu perfil de acesso:

• Consultar: 4417 - API - Denominação Comum Brasileira(Consultar)

• Incluir: 4418 - API - Denominação Comum Brasileira(Incluir)

• Atualizar: 4419 - API - Denominação Comum Brasileira(Atualizar)

Para conhecer mais sobre como é a utilização dessa ferramenta, clique aqui.

Para saber mais sobre a utilização das APIs do ERP, clique aqui.

Disponível a partir da versão r365.01