“As coisas mudam e nós precisamos evoluir para que o tempo nos tenha no futuro”
Estamos disponibilizando este recurso para prover de forma simples a atualização de preços ABCFARMA dos medicamentos.
As informações abaixo são para uso dos desenvolvedores/empresas de software da sua farmácia!.
O Webservice ABCFARMA para atualização dos preços está em sua primeira versão, utilizando um banco de dados SQL e um servidor dedicado com alta capacidade de resposta.
A API recebe parâmetros através de POST e retorna um objeto JSON que contem um arranjo com os dados que era importado através dos arquivos disponibilizados no portal ABCFARMA, porém, utilizando essa API, eliminamos o intermediário, facilitando o processo para seu cliente, que também é nosso associado.
1 Request
Execute um requisição ao nosso servidor HTTP, enviando os campos abaixo como POST tendo como nome o indicador abaixo, utilizaremos essas informações para autenticação e os mecanismos de segurança.
O endereço do serviço é :
https://webserviceabcfarma.org.br/webservice/ Certifique-se de terminar a URL com a barra!
Campos POST
- cnpj_cpf CNPJ do associado
- senha Senha do Associado no Portal ABCFARMA
- cnpj_sh CNPJ da Empresa de Software ¹
- pagina Número da página [default = 1]
2 Response
{ "pagina": "16", "limit": "LIMIT 1000 OFFSET 15000", "total_paginas": 16, "total_itens": "15691", "total_data": 691, "data": [ { "ID_PRODUTO":"00000", "EAN": "7890000000000", "REGISTRO_ANVISA": "0000000000000", "GGREM": null, "NOME": "NOME DO MEDICAMENTO", "DESCRICAO": "20mg cx 6 cap", "COMPOSICAO": "COMPOSTO", "QTD_EMBALAGEM": "2", "PF_20": "11.38", "PMC_20": "15.73", "PF_18": "11.10", "PMC_18": "15.35", "PF_17": "10.97", "PMC_17": "15.17", "PF_17_5": "11.03", "PMC_17_5": "15.25", "PF_12": "10.34", "PMC_12": "14.29", "PF_0": "0.00", "PMC_0": "0.00", "PERCENTUAL_IPI": "0.00", "DATA_VIGENCIA": "2017-04-03", "NOVO": "0", "VARIACAO_PRECO": "", "PF_17_ALC": "10.97", "PMC_17_ALC": "15.17", "PF_17_5_ALC": "11.03", "PMC_17_5_ALC": "15.25", "PF_18_ALC": "11.10", "PMC_18_ALC":"15.35", "NCM": null, "ID_TARJA": null, "CLASSE_TERAPEUTICA": null, "PORTARIA_344_98": null, "PRODUTO_REFERENCIA": null, "CAS": null, "DCB": null, "ATC_CODE": null, "CAP": null, "CONFAZ_87": null, "TISS_TUSS": null, "CEST": null, "ID_FABRICANTE": "000", "NOME_FABRICANTE": "ABCFARMA", "ID_LCCT": "+", "DESCRICAO_LISTA":"LISTA POSITIVA", "ID_REGIME_PRECO": "M", "DESCRICAO_REGIME_PRECO":"MONITORADO", "ID_TIPO_PRODUTO": "G", "DESCRICAO_TIPO_PRODUTO": "GENERICO" }, { "ID_PRODUTO":"00000", "EAN": "7890000000000", "REGISTRO_ANVISA": "0000000000000", "GGREM": null, "NOME": "NOME DO MEDICAMENTO", "DESCRICAO": "20mg cx 6 cap", "COMPOSICAO": "COMPOSTO", "QTD_EMBALAGEM": "2", "PF_20": "11.38", "PMC_20": "15.73", "PF_18": "11.10", "PMC_18": "15.35", "PF_17": "10.97", "PMC_17": "15.17", "PF_17_5": "11.03", "PMC_17_5": "15.25", "PF_12": "10.34", "PMC_12": "14.29", "PF_0": "0.00", "PMC_0": "0.00", "PERCENTUAL_IPI": "0.00", "DATA_VIGENCIA": "2017-04-03", "NOVO": "0", "VARIACAO_PRECO": "", "PF_17_ALC": "10.97", "PMC_17_ALC": "15.17", "PF_17_5_ALC": "11.03", "PMC_17_5_ALC": "15.25", "PF_18_ALC": "11.10", "PMC_18_ALC":"15.35", "NCM": null, "ID_TARJA": null, "CLASSE_TERAPEUTICA": null, "PORTARIA_344_98": null, "PRODUTO_REFERENCIA": null, "CAS": null, "DCB": null, "ATC_CODE": null, "CAP": null, "CONFAZ_87": null, "TISS_TUSS": null, "CEST": null, "ID_FABRICANTE": "000", "NOME_FABRICANTE": "ABCFARMA", "ID_LCCT": "+", "DESCRICAO_LISTA":"LISTA POSITIVA", "ID_REGIME_PRECO": "M", "DESCRICAO_REGIME_PRECO":"MONITORADO", "ID_TIPO_PRODUTO": "G", "DESCRICAO_TIPO_PRODUTO": "GENERICO" } ] }
3 Estrutura JSON
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_20 | PREÇO FÁBRICA 20% | DECIMAL | 12,2 | |
PMC_20 | PREÇO MÁXIMO AO CONSUMIDOR 20% | 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 | |
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 | 90 | |
DCB | CÓDIGO DENOMINAÇÕES COMNUS BRASILEIRAS - http://portal.anvisa.gov.br/denominacao-comum-brasileira | TEXTO | 240 | |
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 |
Erro 100
Detalhes do erro
O cnpj_sh informado não está cadastrado e/ou autorizado a fazer os downloads através do WEBSERVICE ABCFARMA.
Resolução
O cnpj_sh informado não está cadastrado e/ou autorizado a fazer os downloads através do WEBSERVICE ABCFARMA.
Verifique se a sua empresa de software está em acordo com as exigências da ABCFARMA, se os erros persistirem, entre em contato com o canal de suporte para a verificação.
Verifique se a sua empresa de software está em acordo com as exigências da ABCFARMA, se os erros persistirem, entre em contato com o canal de suporte para a verificação.
{ "data": "null", "status": "error", "error_message": "Empresa de software não autorizada. [cnpj]", "error_code": "100", "link": "http://webserviceabcfarma.org.br/webservice/docs/errors" }
Erro 200
Detalhes do erro
O cnpj_cpf e/ou senha informados estão incorretos ou não possuem acesso válido ao PORTAL ABCFARMA.
Resolução
Verifique os dados informados.
Se você tem certeza dos dados, e os erros persistirem, entre em contato com o canal de suporte para a verificação dos dados.
Se você tem certeza dos dados, e os erros persistirem, entre em contato com o canal de suporte para a verificação dos dados.
{ "data": "null", "status": "error", "error_message": "CNPJ ou senha inválidos. verifique os dados.", "error_code": "200", "link": "http://webserviceabcfarma.org.br/webservice/docs/errors" }
Erro 300
Detalhes do erro
O cnpj_cpf informado não possui nenhuma contribuição válida e ativa com a ABCFARMA.
Essa é uma condição para que seja autorizado o download, esse erro específico retorna um link para que essa situação seja regularizada..
Resolução
Informar o cliente da pendência quanto a sua associação a ABCFARMA, e orientar e disponibilizar o link presente no retorno do webservice.
{ "data": "null", "status": "error", "error_message": "O CNPJ não possui contribuição ativa.", "error_code": "300", "link": "http://abcfarmacomvoce.org.br/portal/associado/associe/" }
Erro 400
Detalhes do erro
A página solicitada é maior que o total a ser disponibilizado através do WEBSERVICE ABCFARMA.
Resolução
Verifique o campo total_paginas, exibido em todas as requests autorizadas.
{ "data": "null", "status": "error", "error_message": "Página excede o limite de paginação!", "error_code": "400", "link": "http://webserviceabcfarma.org.br/webservice/docs/errors" }
Erro 500
Detalhes do erro
O cnpj_cpf excedeu o limite de acessos médios do uso do WEBSERVICE ABCFARMA.
Resolução
Verificar junto ao nosso canal de atendimento, os meios para efetuar a liberação de acessos adicionais.
{ "data": "null", "status": "error", "error_message": Limite de acessos excedido!.", "error_code": "500", "link": "http://webserviceabcfarma.org.br/webservice/docs/errors" }