Agora no Bluesoft ERP, é possível consultar, incluir e atualizar informações de medicamentos via API.

Para facilitar a integração de dados farmacêuticos com plataformas de E-commerce e sistemas externos, disponibilizamos novos endpoints na API de Produtos. Agora é possível consultar, incluir e atualizar informações regulatórias e técnicas de medicamentos — como o Registro no Ministério da Saúde (ANVISA) — diretamente via integração.

O objetivo é permitir que dados cruciais para a venda de medicamentos, que antes ficavam restritos à interface do ERP, possam ser sincronizados com outras plataformas.

O que mudou?

Foram criados métodos para a gestão completa dos dados de medicamentos:

1. Consulta de Medicamentos (GET)

Permite listar os medicamentos cadastrados com paginação e filtros específicos. É possível filtrar por:

• Genérico (true/false)

• Farmácia Popular (true/false)

• Uso Contínuo (true/false)

• Medicamento Controlado (true/false).

Também é possível obter os dados de um medicamento específico através do medicamentoKey.

2. Inclusão de Dados de Medicamento (POST)

Permite vincular informações de medicamento a um produto já existente no ERP (produtoKey).

• Campos Obrigatórios: produtoKey, codigoAbcFarma e registroMinisterioDaSaude.

• Campos Opcionais: Flags de genérico, uso contínuo, lista de chaves DCB (dcbKeys), entre outros.

Exemplo de JSON: 

{
    "produtoKey": 130661,
    "codigoAbcFarma": 1,
    "registroMinisterioDaSaude": "123456",
    "generico": true,
    "farmaciaPopular": true,
    "usoContinuo": false,
    "medicamentoControlado": false,
    "classeTerapeutica": "aaaaaa",
    "dcbKeys": [
        3121,
        9564
    ]
}

3. Atualização de Medicamento (PUT)

Permite alterar os dados técnicos de um medicamento já cadastrado utilizando o medicamentoKey.

Regras de Negócio Importantes

• Medicamentos Controlados: Ao marcar um medicamento como controlado (medicamentoControlado: true), torna-se obrigatório informar a classeTerapeutica (Valores aceitos: ANTIMICROBIANO ou SUJEITO_A_CONTROLE_ESPECIAL).

• Estoque por Lote: O sistema ativará automaticamente a flag “Controla estoque por lote” no cadastro do produto ao definir um medicamento como controlado via API.

• Validação ANVISA: O campo registroMinisterioDaSaude é de preenchimento obrigatório para garantir a conformidade do cadastro.

Exemplo de JSON:

{
    "codigoAbcFarma": 4,
    "registroMinisterioDaSaude": "TESTE API",
    "generico": false,
    "farmaciaPopular": false,
    "usoContinuo": true,
    "medicamentoControlado": true,
    "classeTerapeutica": "SUJEITO_A_CONTROLE_ESPECIAL",
    "dcbKeys": [
        33,
        34
    ]
}

Para utilizar os novos recursos, o usuário da API deve possuir as seguintes permissões:

• 4427 – API – Medicamentos (Consultar)

• 4428 – API – Medicamentos (Incluir)

• 4429 – API – Medicamentos (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 r366.01