Endpoints - Peneira

1. Exemplo do json:

[
  {
    "codigo": 3,
    "descricao": "C1",
    "codigo_externo": "C1",
    "ativo": "S"
  }
]

Campos:

codigo: Código do registro no banco de dados do CRM
descricao: Descrição da peneira;
codigo_externo: Código da peneira no sistema integrado;
ativo: Campo para indicar se a peneira está ativa (S) ou inativa (N)

Todos os endpoints, com exceção do deletar, retornam o json nesse formato.

2. Endpoints

2.1 - Buscar peneira pelo código

Endpoint: /semente-peneira

Tipo: get

Parâmetros:

codigoInterno: Tipo: Inteiro. Código da peneira no banco de dados do CRM.
codigoExterno: Tipo: String. Código da peneira no banco de dados do sistema integrado

Validações: É necessário informar pelo menos um dos parâmetros. Caso informado os dois o sistema prioriza o código externo.

Resposta: Status 200 - Retorna a peneira no formato documentado na sessão Exemplo do json

2.2 - Buscar todas as peneiras

Endpoint: /semente-peneira/todos

Tipo: get

Resposta: Status 200 - Retorna a lista das peneiras no formato documentado na sessão Exemplo do json

2.3 - Cadastrar ou editar peneira

Endpoint: /semente-peneira

Tipo: post

Notas:

Informe no corpo da requisição o json conforme exemplo na sessão 1.
Para cadastrar uma nova peneira não informe o campo “codigo”;
Para editar uma peneira já existente informe o campo “codigo” com o código da peneira que deseja editar;
Serão permitidos o cadastro/edição de até 20 itens por vez.

Resposta: Status 200 - Retorna a peneira cadastrada, no formato documentado na sessão Exemplo do json

2.4 - Inativar uma peneira

Não é possível deletar uma peneira, apenas inativar, pois a peneira pode ter vinculo com pedidos e produtos. Nesse caso, a peneira continua no banco de dados porém com o status inativo.

Endpoint: /semente-peneira

Tipo: delete

Parâmetros:

codigoInterno: Tipo: Inteiro. Código da peneira no banco de dados do CRM.
codigoExterno: Tipo: String. Código da peneira no banco de dados do sistema integrado, caso existir.

Resposta: Status 200 - Mensagem: Registro inativado com sucesso.

2.5 - Retornar os metadados da peneira

Endpoint: /semente-peneira/metadados

Tipo: get

Descrição: Retorna os campos do json, com as informações de tipo, tamanho máximo, se o campo é requerido, filtrável e/ou ordenável

Resposta: Status 200 - Retorna um json com as informações dos campos da peneira

2.6 - Pesquisar

Endpoint: /semente-peneira/pesquisa

Tipo: post

Notas:

Esse endpoint retorna as peneiras baseado nos filtros e na ordenação informados;
Exemplo do corpo da requisição:

{
    "pagina": 1,
    "quantidadeRegistros": 10,
    "filtros": [
        {
            "campo": "descricao",
            "comparacao": "CONTEM",
            "valor": "2"
        }
    ],
    "ordenacao": [
        {
            "campo": "peneira",
            "ordenacao": "ASC"
        }
    ]
}

Nesse exemplo, estamos filtrando todas as peneiras cuja descrição possua o texto “VIASOFT”, também estamos ordenando os registros pela descrição de forma ascendente.