1. Escopo (Em elaboração)
1.1. Vendedor
1.1.1. Acessa o app com seu usuário e senha
1.1.2. O App permanece logado, não precisando fazer novo acesso
1.1.3. Ter algum mecanismo de forçar o app se deslogar, para casos de desligamento de colaborador
1.1.4. Todos os dias, será necessário sincronizar os dados, enviando os pedidos não sincronizados, aprovações de descontos e solicitações de desconto. Puxando os dados online para atualizar as bases locais
2. Endpoints
2.1. /login
2.1.1. Método: POST
2.1.2. Tipo: Resultado único
2.1.3. Corpo:
2.1.3.1. login
2.1.3.2. Senha
2.1.4. Resultado:
2.1.4.1. int: Id do usuario
2.1.4.2. string: Nome do usuário
2.1.4.3. int: Id do grupo de autorizacao
2.1.4.4. decimal: Valor de autorizacao
2.2. /esqueci-senha
2.2.1. Método: POST
2.2.2. Tipo: Resultado único
2.2.3. Corpo:
2.2.3.1. login
2.2.4. Resultado:
2.2.4.1. string: texto de retorno api
2.3. /verificar-usuario
2.3.1. Método: GET
2.3.2. Tipo: Resultado único
2.3.3. Resultado:
2.3.3.1. boolean: Status
2.4. /cotacoes (depreciado)
2.4.1. Método: GET
2.4.2. Tipo: Lista de resultados
2.4.3. Resultado:
2.4.3.1. int: Id da unidade
2.4.3.2. int: Id da cultura
2.4.3.3. decimal: Cotação
2.4.3.4. date: Ultima atualizacao
2.5. /campanhas
2.5.1. Método: GET
2.5.2. Tipo: Lista de resultados
2.5.3. Resultado:
2.5.3.1. int: Id da campanha
2.5.3.2. string: Nome
2.5.3.3. boolean: Cadpro
2.5.3.4. date: Database
2.5.3.5. boolean: Status
2.5.3.6. list: Produtos
2.5.3.6.1. int: Id da familia
2.5.3.6.2. int: Id do grupo
2.5.3.6.3. int: Id do produto
2.5.3.6.4. string: Nome
2.5.3.6.5. obj: PrecoVencimento
2.5.3.7. list: Unidades
2.5.3.7.1. int: Id da unidade
2.5.3.8. list: Vencimentos
2.5.3.8.1. int: Id do vencimento
2.5.3.8.2. date: Data
2.5.3.8.3. boolean: Principal
2.5.3.9. obj: DescontoMix
2.5.3.9.1. int: Id
2.5.3.9.2. string: Nome: Desconto de MIX (Familia)
2.5.3.9.3. int: QuantidadeInicial: 4
2.5.3.9.4. int: QuantidadeFinal: 5
2.5.3.9.5. list: Combinacao
2.5.3.10. obj: DescontoVolume
2.5.3.10.1. int: Id
2.5.3.10.2. string: Nome
2.5.3.10.3. decimal: Valor inicial
2.5.3.10.4. decimal: Valor final
2.5.3.10.5. decimal: Percentual de desconto
2.6. /clientes
2.6.1. Método: GET
2.6.2. Tipo: Lista de resultados
2.6.3. Resultados:
2.6.3.1. int: Id do cliente
2.6.3.2. string: Nome
2.6.3.3. decimal: Área cadastral
2.6.3.4. decimal: Área agronômica
2.6.3.5. enum: Tipo (Cooperado, Não cooperado)
2.6.3.6. enum: Curva (A, B, C)
2.6.3.7. enum: Segmentação (CMV, SC, .., ..)
2.6.3.8. decimal: Limite total
2.6.3.9. decimal: Limite utilizado
2.6.3.10. decimal: Limite disponível
2.6.3.11. list: Endereços
2.6.3.11.1. int: Id do endereço
2.6.3.11.2. int: Id unidade
2.6.3.11.3. string: Nome
2.6.3.11.4. string: CadPro
2.7. /pedidos
2.7.1. Método: GET
2.7.2. Tipo: Lista de resultados
2.7.3. Resultado:
2.7.3.1. int: Id do pedido
2.7.3.2. int: Id da campanha
2.7.3.3. int: Id da cultura
2.7.3.4. int: Id do cliente
2.7.3.5. int: Id do endereço
2.7.3.6. date: Data do pedido
2.7.3.7. decimal: Total do pedido
2.7.3.8. decimal: Total desconto mix
2.7.3.9. decimal: Total desconto volume
2.7.3.10. decimal: Total negociado
2.7.3.11. decimal: Total desconto alcada
2.7.3.12. decimal: Total do pedido com desconto automático
2.7.3.13. enum: Status do pedido (Rascunho, Pendente Autorização, Pendente Assinatura, Assinado, Cancelado)
2.7.3.14. decimal: Total desconto solicitado
2.7.3.15. decimal: Total faturado
2.7.3.16. decimal: Total aprovado
2.7.3.17. decimal: Valor grãos
2.7.3.18. decimal: Percentual faturado
2.7.3.19. list: Produtos
2.7.3.19.1. int: id do produto
2.7.3.19.2. decimal: Quantidade
2.7.3.19.3. decimal: Valor Unitário
2.7.3.19.4. decimal: Valor Mercado
2.7.3.19.5. decimal: Percentual desconto
2.7.3.20. list: Vencimentos
2.7.3.20.1. int: Id do vencimento
2.7.3.20.2. date: Data
2.7.3.20.3. boolean: Selecionado
2.7.3.21. list: Descontos
2.7.3.21.1. int: Id do desconto
2.7.3.21.2. enum: Tipo desconto (Mix, Volume, Alçada)
2.7.3.21.3. string: nome
2.7.3.21.4. int: Id do pedido
2.7.3.21.5. decimal: Percentual
2.7.3.21.6. date: Data
2.7.3.21.7. int: Id do usuário solicitante
2.7.3.21.8. int: Id grupo autorizador
2.7.3.21.9. int: Id do usuário autorizador
2.7.3.21.10. text: Motivo
2.7.3.21.11. text: Devolutiva
2.7.3.21.12. enum: Situacao (Pendente, Autorizado, Reprovado)
3. Dúvidas
3.1. Qual tecnologia Backend?
3.2. Um cliente tem está em mais de uma carteira
3.3. Modelo de sincronia durante o dia e o máximo de tempo sem sincronizar
3.4. Campanha é mutável durante o processo
3.5. Objeto da venda carrega todas as caracteristicas da campanha no momento
3.6. Quando pode editar um pedido
3.6.1. Em condições de aprovado, não tem risco de edição
3.6.2. Quando há mudança de produtos, cai todas as condições de alçada