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.
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.
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
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.
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.
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.
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.
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.
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.
* Inclui as novas alíquotas de 20,5%, 19,5% e 19,5% ALC
* Para obter um exemplo dos dados, efetue uma chamada na seguinte url: https://webserviceabcfarma.org.br/webservice/exemplo/
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 |
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/
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:
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. |
Disponibilizamos neste área alguns exemplos de conexão ao Web service, utilizando linguagens variadas.