Endpoints - Unidade de medida

1. Exemplo do json:

[ { "codigo": 1, "unidade": "BD", "descricao": "Balde" } ]

Campos:

  • codigo: Código do registro no banco de dados do CRM

  • unidade: Abreviação da unidade

  • descricao: Descrição da unidade

Observação: As unidades de medidas são padrões do sistema, não é possível cadastrar, atualizar ou deletar unidades de medida, apenas consulta-las.


2. Endpoints

2.1 - Buscar Unidade de medida pelo código

Endpoint: /unidade-medida

Tipo: get

Parâmetros:

  • codigoInterno: Tipo: Inteiro. Código da unidade de medida no banco de dados do CRM.

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

2.2 - Buscar todas as unidade de medida

Endpoint: /unidade-medida/todos

Tipo: get

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

2.5 - Retornar os metadados da unidade de medida

Endpoint: /unidade-medida/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 unidade de medida

2.6 - Pesquisar

Endpoint: /unidade-medida/pesquisa

Tipo: post

Notas:

  • Esse endpoint retorna as unidades de medida baseado nos filtros e na ordenação informados;

  • Exemplo do corpo da requisição:

  • { "pagina": 1, "quantidadeRegistros": 10, "filtros": [ { "campo": "unidade", "comparacao": "COMECA_COM", "valor": "K" } ], "ordenacao": [ { "campo": "descricao", "ordenacao": "ASC" } ] }
  • Nesse exemplo, estamos filtrando todas as unidades de medida cuja unidade (abreviação) começa com a letra K;