Pedidos SRFarma - Versão 1.0.0.0

A api deverá ser atualizada a cada 4 meses. No primeiro dia dos seguintes mêses janeiro, maio e setembro.

O que é o SRFarma?

É sistema de Gerenciamento de Redes e Franquias

URL

Rede Associativa Cidade / UF URL
Rede Soma Drogarias Raul Soares / MG http://soma.srfarma.com.br
Rede Omega Drogarias Ponte Nova / MG http://redeomega.srfarma.com.br
Grupo Multifarma Muriaé / MG http://multifarma.srfarma.com.br
Rede Universal Drogarias Contagem / MG http://universal.srfarma.com.br
Rede Soma
Rede Omega
Multifarma
SmallFarma
Universal


Exemplo de como pode ser o fluxo:

Drogaria Teste:
CNPJ: 18.092.664/0001-93 Programa RESTFul sugerido: Postman

HEAD Será usado em todos os URI

Nome Valor [Exemplo] Descriçao
Authorization Bearer [Solicitar Token] Envia o token de acesso.
Content-Type application/json Envie o tipo de retorno.
User-Agente Software Envia o nome do software.
Versao 1.0.4.191 Enviar o número da versão do software.

Status Code Tabela geral usada em todos os URI

Código Descriçao Schema
200 Sucesso GET – Irá exibir conteúdo
201 Criado/Atualizado
202 Aceito/Autorizado
203 Não autorizado
204 Não existe conteúdo GET – Item não existe. Ex.: Produto não encontrado
301 Movido {"uri": "string"}
400 Parâmetros Inválidos {"key": ["string"]}
401 Acesso não autorizado
402 Pagamento necessário
403 Proibido
404 Não encontrado, verifique a URL
405 Método não permitido
406 Não executado
408 Tempo esgotado [Timeout]
409 Conflito de regras
410 Url Obsoleta
412 Falha na pré-condição
500 Erro interno do servidor
501 Recurso não implementado
502 Gateway Inválido
503 Serviço indisponível
408,500,503 Observação estes status devem ser tratados para não interromper a aplicação.
No inicio da operação se houve alguma indisponibilidade no servidor,
solicitar o balconista para voltar mais tarde,
O timeout de todos os métodos é 15 segundos.

POST /v1/falta

Método para lançar faltas

Parâmetros Sempre enviar em caixa baixa (minúsculas).

Nome Requerido Descrição Schema
cnpj Sim CNPJ do cliente. String
ean Sim Código do EAN do produto a ser adquirido Integer
quant Sim Quantidade em unidade do item. Double – usar separado decimal [.] ponto final, ex: 1.00, 1.50
dtlimite Não Data Limite para compra do Produto Date – formato yyyy-mm-dd

Retorno

Código Descrição Schema
201 Criado/Atualizado