14. Incluir Centro de Estoque

Este método é responsável por cadastrar um novo centro de estoque no sistema. O cadastro também pode ser feito na tela “Centro de Estoque” do Exati.

Deve-se definir um centro financeiro pai, onde este centro de estoque será agrupado. O endpoint “Consultar Centros Financeiros” pode ser usado para consultar os centros financeiros existentes.

O sistema criará automaticamente um centro financeiro para o novo centro de estoque, que será filho do centro financeiro pai definido, e conterá as movimentações financeiras relacionadas.
Por exemplo, para incluir o centro abaixo em vermelho, deve-se passar "ESTQ.1" como pai e, ao salvar, ele cria o "ESTQ.1.101" automaticamente.

Centros de Custo

Para vincular centros de custo ao centro de estoque, basta passar os “CENTROS_FINANCEIROS” no corpo da requisição. Para isto, os centros de custo já devem estar criados. Sua criação está descrita no endpoint “Incluir Centros Financeiros”.

Também é possível incluir esse vínculo em centros de estoque já existentes utilizando o endpoint de atualização na sequência.

Exemplo 1:
Centro financeiro pai é “ESTQ.101.2”. E o código do centro financeiro criado para este centro de estoque é “ESTQ.101.2.344”, o qual é retornado na requisição. Exemplo 1 no retorno da requisição.

{
    "CENTRO_FINANCEIRO_PAI": "ESTQ.101.2",
    "ID_PROPRIETARIO": 1,
    "DESC_CENTRO_ESTOQUE": "Estoque Teste",
    "SIGLA_TIPO": "CEI",
    "CENTROS_FINANCEIROS": [
   	 "CCUSTO.01.1000",
   	 "CCUSTO.01.2000",
   	 "CCUSTO.02.0002"
    ],
    "ID_LOCAL_EMPRESA": 1,
    "EMAIL_ESTOQUE_ZERO": "estoque.teste@exati.com.br",
    "EMAIL_ESTOQUE_MINIMO": "estoque.teste@exati.com.br",
    "NOVO_USADO": "N",
    "TANQUE_COMBUSTIVEL": 1,
    "NUM_MAX_LITROS": 200.5,
    "ATIVO": 1,
    "PERMITIR_RESERVA_ESTOQUE_NEGATIVO": 1,
    "MOVIMENTA_ESTOQUE_CONFIRMACAO_ALMOXARIFE": 1
}

Exemplo 2:

{
    "CENTRO_FINANCEIRO_PAI": "ESTQ.101.5",
    "NOME_PROPRIETARIO": "Julie",
    "DESC_CENTRO_ESTOQUE": "Estoque Teste 2",
    "SIGLA_TIPO": "CEE",
    "NOVO_USADO": "U"
}

Retorno da requisição

Um json com o status da requisição: sucesso ou erro. E com os dados identificadores do centro de estoque inserido. No caso de erro, é retornada uma mensagem descritiva do erro.

Exemplo 1: Sucesso 200 OK
Relativo ao Exemplo 1 de inclusão acima

{
   "status": "success",
   "data": {
       "ID_CENTRO_ESTOQUE": 19,
       "SIGLA_TIPO": "CEI",
       "ID_PROPRIETARIO": 1,
       "DESC_CENTRO_ESTOQUE": "Estoque Teste",
       "ATIVO": 1,
       "NOVO_USADO": "N",
       "ID_CENTRO_FINANC": 25063,
       "COD_CENTRO_FINANC": "ESTQ.101.2.344",
       "TANQUE_COMBUSTIVEL": 1,
       "NUM_MAX_LITROS": "200.500",
       "ID_LOCAL_EMPRESA": 1,
       "MOVIMENTA_ESTOQUE_CONFIRMACAO_ALMOXARIFE": 1,
       "PERMITIR_SOLICITACAO_ESTOQUE_NEGATIVO": 1,
       "EMAIL_ESTOQUE_ZERO": "estoque.teste@exati.com.br",
       "EMAIL_ESTOQUE_MINIMO": "estoque.teste@exati.com.br",
       "CENTROS_FINANCEIROS": [
           "CCUSTO.01.1000",
           "CCUSTO.01.2000",
           "CCUSTO.02.0002",
           "ESTQ.2406"
       ]
   }
}

Exemplo 2: Erro 400 Bad Request

{
    "status": "error",
    "message": "Já existe um Centro de Estoque com mesma descrição."
}

Exemplo Postman:
Captura de tela de 2024-10-01 16-28-57.png

14. Incluir Centro de Estoque

Centros de Custo#

Retorno da requisição#

Centros de Custo

Retorno da requisição