Inventory
  1. Docs
Inventory
  • Docs
    • 00. Autenticação
    • 01. Incluir Movimentação Especial
    • 02. Incluir Nota Fiscal de Entrada
    • 03. Cancelar Nota Fiscal de Entrada
    • 04. Gerar Lote de Garantia para Item da Nota Fiscal
    • 05. Incluir Fornecedor
    • 06. Consultar Materiais/Itens
    • 07. Incluir Material/Item
    • 08. Consultar Tipos de Item
    • 09. Incluir Tipo de Item
    • 10. Vincular Tipo de Item a Centro de Estoque
    • 11. Consultar Famílias
    • 12. Incluir Família de Itens
    • 13. Consultar Centros de Estoque
    • 14. Incluir Centro de Estoque
    • 15. Atualizar Centro de Estoque
    • 16. Consultar Centros Financeiros
    • 17. Incluir Centros Financeiros
  • RM
    • Incluir movimentação especial
      POST
    • Incluir nota fiscal de entrada
      POST
    • Cancelar nota fiscal de entrada
      POST
    • Gerar lote de garantia para item da nota fiscal
      POST
    • Incluir fornecedor
      POST
    • Consultar materiais
      GET
    • Incluir material
      POST
    • Consultar tipos de item
      GET
    • Incluir tipo de item
      POST
    • Vincular tipo de item a centro de estoque
      POST
    • Consultar famílias
      GET
    • Incluir família
      POST
    • Consultar centros de estoque
      GET
    • Incluir centro de estoque
      POST
    • Atualizar centro de estoque
      PATCH
    • Consultar centros financeiros
      GET
    • Incluir centros financeiros
      POST
  1. Docs

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
Previous
13. Consultar Centros de Estoque
Next
15. Atualizar Centro de Estoque