logo ABCFARMA

O que é

O Web service ABCFARMA é um serviço disponibilizado aos associados, visando facilitar a atualização mensal de preços.
Através deste serviço, o associado poderá efetuar o download da lista de produtos e preços diretamente em seu sistema de gestão.

Como obter acesso

Associado ABCFARMA

Se você já é associado, basta informar os dados de acesso (CNPJ e senha) utilizados no portal do associado em seu sistema.
O local onde estas informações são inseridas varia conforme o sistema utilizado.
Consulte o desenvolvedor de seu sistema para verificar onde é feita a atualização via ABCFARMA.

Desenvolvedor

Se você é desenvolvedor de sistemas, será necessário efetuar um cadastro para utilizar o Web service ABCFARMA.
Para solicitar o cadastro, envie um e-mail contendo seu CNPJ e os dados de sua empresa para o endereço: webservice@abcfarma.org.br

Características

Atualização

A lista de produtos é atualizada mensalmente.
No geral, a atualização é disponibilizada todo dia 1 de cada mês, porém, podem haver correções e inclusões durante o mês.
Para verificar a data de atualização, o associado deverá consultar o portal do associado.

Formato de resposta

O Web service ABCFARMA trabalha com o formato JSON.
Este é um formato bastante utilizado, ficando a critério do desenvolvedor de sistemas, tratar os dados conforme a necessidade de seu cliente.

Paginação

A lista completa está dividida em paginas contendo 1000 registros.
Para obter a lista completa, será necessário consumir todas as páginas existentes.
O total de páginas será informado no retorno de cada chamada ao Web service.

Limite de consumo mensal

Visando manter a velocidade de acesso ao serviço, o Web service ABCFARMA disponibiliza um total de 6 acessos mensais.
Isto permite ao associado atualizar seu sistema toda semana, se necessário.
Caso o acesso seja bloqueado, basta entrar em contato conosco e solicitar a liberação de mais acessos.
A liberação de acessos pode ser solicitada também pelo e-mail: webservice@abcfarma.org.br
A contabilização de acesso será feita após o consumo de toda a lista.

Conexão

Para obter a lista de produtos, o desenvolvedor deverá programar seu sistema para efetuar uma chamada POST com os seguinte parâmetros:

Atenção:
Envie os dados utilizando um objeto no formato "multipart/form-data" ou no formato x-www-form-urlencoded, pois esta API não é REST.

Endereço de chamada: https://webserviceabcfarma.org.br/webservice/

Obs: Caso esteja utilizando o ambiente de testes, informe apenas o campo "cnpj_sh" e "pagina"
Para ver um exemplo de chamada utilizando o aplicativo POSTMAN, clique aqui.

Dados de retorno

Após realizar a chamada ao Web service, será retornado uma lista de produtos conforme a estrutura abaixo.
Caso receba alguma informação diferente, consulte a guia de erros do Web service.

Nova estrutura do JSON

Identificação dos campos


CAMPO DESCRIÇÃO TIPO TAMANHO IDENTIFICADORES
ID_PRODUTO CODIGO ABCFARMA DO PRODUTO NUMÉRICO 9
EAN CÓDIGO DE BARRA DO PRODUTO TEXTO 13
REGISTRO_ANVISA REGISTRO ANVISA DO PRODUTO TEXTO 13
GGREM CODIGO DO PRODUTO NA CMED TEXTO 15
NOME NOME DO PRODUTO TEXTO 50
DESCRIÇÃO APRESENTAÇÃO / DESCRIÇÃO DO PRODUTO TEXTO 45
COMPOSIÇÃO PRINCIPIO ATIVO / COMPOSIÇÃO DO PRODUTO TEXTO 254
QTD_EMBALAGEM UNIDADE DE VENDA DECIMAL 3,0
PF_22 PREÇO FÁBRICA 22% DECIMAL 12,2
PMC_22 PREÇO MÁXIMO AO CONSUMIDOR 22% DECIMAL 12,2
PF_21 PREÇO FÁBRICA 21% DECIMAL 12,2
PMC_21 PREÇO MÁXIMO AO CONSUMIDOR 21% DECIMAL 12,2
PF_20 PREÇO FÁBRICA 20% DECIMAL 12,2
PMC_20 PREÇO MÁXIMO AO CONSUMIDOR 20% DECIMAL 12,2
PF_20_5 PREÇO FÁBRICA 20,5% DECIMAL 12,2
PMC_20_5 PREÇO MÁXIMO AO CONSUMIDOR 20,5% DECIMAL 12,2
PF_19 PREÇO FÁBRICA 19% DECIMAL 12,2
PMC_19 PREÇO MÁXIMO AO CONSUMIDOR 19% DECIMAL 12,2
PF_19_5 PREÇO FÁBRICA 19,5% DECIMAL 12,2
PMC_19_5 PREÇO MÁXIMO AO CONSUMIDOR 19,5% DECIMAL 12,2
PF_18 PREÇO FÁBRICA 18% DECIMAL 12,2
PMC_18 PREÇO MÁXIMO AO CONSUMIDOR 18% DECIMAL 12,2
PF_17 PREÇO FÁBRICA 17% DECIMAL 12,2
PMC_17 PREÇO MÁXIMO AO CONSUMIDOR 17% DECIMAL 12,2
PF_17_5 PREÇO FÁBRICA 17,5% DECIMAL 12,2
PMC_17_5 PREÇO MÁXIMO AO CONSUMIDOR 17,5% DECIMAL 12,2
PF_12 PREÇO FÁBRICA 12% DECIMAL 12,2
PMC_12 PREÇO MÁXIMO AO CONSUMIDOR 12% DECIMAL 12,2
PF_0 PREÇO FÁBRICA 0% - DISPONÍVEL APENAS PARA PRODUTOS ISENTOS ICMS OU PERTENCENTES AO CONVENIO 162/94 DECIMAL 12,2
PMC_0 PREÇO MÁXIMO AO CONSUMIDOR 0% DECIMAL 12,2
PERCENTUAL_IPI PERCENTUAL DO IPI DECIMAL 6,2
DATA_VIGENCIA DATA DE VIGÊNCIA DO PRODUTO DATA 10
NOVO INFORMA SE O PRODUTO É NOVO BOOLEANO 1
VARIACAO_PRECO INDICA SE HOUVE VARIAÇÃO DE PREÇO NO PRODUTO TEXTO 1
PF_17_ALC PREÇO FÁBRICA 17% ÁREAS DE LIVRE COMÉRCIO DECIMAL 12,2
PMC_17_ALC PREÇO MÁXIMO AO CONSUMIDOR 17% ALC DECIMAL 12,2
PF_17_5_ALC PREÇO FÁBRICA 17,5% ÁREAS DE LIVRE COMÉRCIO DECIMAL 12,2
PMC_17_5_ALC PREÇO MÁXIMO AO CONSUMIDOR 17,5% ALC DECIMAL 12,2
PF_18_ALC PREÇO FÁBRICA 18% ÁREAS DE LIVRE COMÉRCIO DECIMAL 12,2
PMC_18_ALC PREÇO MÁXIMO AO CONSUMIDOR 18% ALC DECIMAL 12,2
PF_19_ALC PREÇO FÁBRICA 19% ÁREAS DE LIVRE COMÉRCIO DECIMAL 12,2
PMC_19_ALC PREÇO MÁXIMO AO CONSUMIDOR 19% ALC DECIMAL 12,2
PF_19_5_ALC PREÇO FÁBRICA 19,5% ÁREAS DE LIVRE COMÉRCIO DECIMAL 12,2
PMC_19_5_ALC PREÇO MÁXIMO AO CONSUMIDOR 19,5% ALC DECIMAL 12,2
PF_20_ALC PREÇO FÁBRICA 20% ÁREAS DE LIVRE COMÉRCIO DECIMAL 12,2
PMC_20_ALC PREÇO MÁXIMO AO CONSUMIDOR 20% ALC DECIMAL 12,2
NCM CÓDIGO NOMENCLATURA COMUM DO MERCOSUL TEXTO 10
ID_TARJA IDENTIFICADOR DO TIPO DE TARJA DO PRODUTO TEXTO 2 TV = VERMELHA / TP = PRETA / VL = VENDA LIVRE
CLASSE_TERAPEUTICA CLASSE TERAPEUTICA DO PRODUTO TEXTO 100
PORTARIA_344_98 CÓDIGO REFERENTE A PORTARIA 344/98 TEXTO 2
PRODUTO_REFERENCIA NOME DO PRODUTO REFERÊNCIA TEXTO 50
CAS CÓDIGO CAS, CONFORME TABELA DCB - http://portal.anvisa.gov.br/denominacao-comum-brasileira TEXTO 240
DCB CÓDIGO DENOMINAÇÕES COMNUS BRASILEIRAS - http://portal.anvisa.gov.br/denominacao-comum-brasileira TEXTO 90
ATC_CODE ANATOMICAL THERAPEUTIC CHEMICAL - http://www7.anvisa.gov.br/datavisa/Substancia/ATC.htm TEXTO 7
CAP INDICA SE O PRODUTO FAZ PARTE DO CAP - http://portal.anvisa.gov.br/perguntas-e-respostas-preco-cap BOOLEANO 1
CONFAZ_87 INDICA SE O PRODUTO FAZ PARTE DO CONVENIO 87/02 - SEFAZ - http://bit.ly/2C4iJ5O BOOLEANO 1
TISS_TUSS CÓDIGO DA ANS - http://www.ans.gov.br/prestadores/tiss-troca-de-informacao-de-saude-suplementar TEXTO 8
CEST CÓDIGO ESPECIFICADOR DA SUBSTITUIÇÃO TRIBUTÁRIA TEXTO 9
ID_FABRICANTE CÓDIGO DO LABORATORIO NA ABCFARMA NUMÉRICO 9
NOME_FABRICANTE NOME DO LABORATÓRIO NA ABCFARMA TEXTO 30
ID_LCCT CÓDIGO DA LISTA TRIBUTÁRIA DO PRODUTO TEXTO 1 "+" = LISTA POSITIVA / "-" = LISTA NEGATIVA / "N" = LISTA NEUTRA / O = OUTROS
DESCRICAO_LISTA NOME DA LISTA TRIBUTÁRIA DO PRODUTO TEXTO 15
ID_REGIME_PRECO IDENTIFICADOR DO REGIME DE PREÇOS DO PRODUTO TEXTO 1 M = MONITORADO / L = LIBERADO FABRICANTE VAREJO / X = LIBERADO FABRICANTE / H = HOSPITALAR
DESCRICAO_REGIME_PRECO DESCRIÇÃO DO REGIME DE PREÇOS TEXTO 30
ID_TIPO_PRODUTO IDENTIFICADOR DO TIPO DO PRODUTO TEXTO 1 G = GENERICO, R = REFERENCIA, S = SIMILAR, P = PATENTE, O = OUTROS
DESCRICAO_TIPO_PRODUTO DESCRIÇÃO DO TIPO DO PRODUTO TEXTO 20
PAGINA INFORMA O NUMERO DA PÁGINA ATUAL NUMÉRICO
TOTAL_PAGINAS INFORMA O NUMERO DA PÁGINA EXISTENTES NA LISTA DO MÊS NUMÉRICO
TOTAL_ITENS INFORMA A QUANTIDADE DE PRODUTOS EXISTENTES NA LISTA DO MÊS NUMÉRICO
TOTAL_DATA INFORMA A QUANTIDADE DE PRODUTOS NA PÁGINA ATUAL NUMÉRICO

Data de atualização da lista

Para verificar a data de atualização da lista de preços, efetue uma chamada POST com os seguinte parâmetros:

Endereço de chamada para obter a data de atualização: https://webserviceabcfarma.org.br/webservice/info/


Estando a empresa de software devidamente habilitada na ABCFARMA, serão retornados os dados conforme o exemplo abaixo:

Mensagens de erro

O Web service irá gerar uma mensagem de erro, caso ocorra alguma inconsistência de dados.
A mensagem de erro retornada, segue a estrutura abaixo:


Identificação dos erros


error_code error_message Resolução
100 Empresa de software não autorizada. [cnpj] Solicite o cadastro de sua empresa de software para obter acesso a lista
200 CNPJ ou senha inválidos. verifique os dados. Verifique se o CNPJ e senha estão corretos. Efetue o acesso ao portal do associado para testar ou recuperar a senha
300 O CNPJ não possui contribuição ativa. Renove sua contribuição ou entre em contato com o setor de associados
400 Página excede o limite de paginação! Provavelmente o sistema solicitou a uma página inexistente. Verifique se a página chamada existe dentro do range informado pelo Web service
500 Limite de acessos excedido! O CNPJ associado excedeu o limite mensal de acessos. Para liberação, entre em contato com a ABCFARMA.

Exemplos

Disponibilizamos neste área alguns exemplos de conexão ao Web service, utilizando linguagens variadas.

PHP