06. Incluir Movimentação Especial

A Movimentação Especial é uma forma simplificada e ágil de atualizar o estoque, exigindo apenas o centro de estoque de origem ou de destino e as quantidades dos itens, sem necessidade de vínculo com nota fiscal.

Por meio dela, é possível incluir ou remover materiais de um estoque sem, necessariamente, informar uma origem ou destino para eles. É útil para realizar ajustes de inventário por diversos motivos como perda, furto ou uma simples transferência de materiais.

A movimentação fica registrada no sistema com o motivo selecionado, a data da movimentação, uma justificativa, além das informações de origem, destino e quantidade dos materiais.

Para a integração, foi projetada para três situações:

Equalização do estoque inicial

Notas de devolução

Alternativa à entrada de materiais por nota fiscal

Atualmente, será utilizada apenas para notas de devolução, já que a equalização do estoque será realizada manualmente e a entrada de materiais ocorrerá exclusivamente por notas fiscais.

Este endpoint permite a inclusão de uma movimentação especial para um centro de estoque.

Para incluir materiais no estoque, o centro de estoque deve ser informado como destino da movimentação.

Para remover materiais do estoque, o centro de estoque deve ser informado como origem da movimentação.

No caso de remoção de materiais do estoque, é possível informar as identificações dos materiais que se deseja remover do centro de estoque especificado. Para isso, deve-se passar os campos do lote do produto e do número de série. Vide exemplo a seguir.

No caso de inclusão no estoque, não é possível informar as identificações para cadastro das mesmas, mas apenas os quantitativos dos materiais. O cadastro das identificações só pode ser realizado através da inclusão de notas fiscais.

Para que a operação seja bem-sucedida, é necessário que algumas entidades estejam previamente cadastradas, como centros de estoque e itens. Endpoints para o cadastro dessas entidades estão descritos adiante.

Notas de devolução

Como o Exati não possui uma entidade específica para notas de devolução, a Movimentação Especial pode ser utilizada para representá-las. Dessa forma, é possível refletir corretamente a alteração de estoque causada pela devolução.

Nesse caso, o centro de estoque deve ser informado como origem, pois os materiais serão removidos do estoque. E é possível informar as identificações dos materiais que se deseja remover do centro de estoque especificado.

Exemplo 1: será removido do estoque 3 unidades do item “1030001” com o lote e identificações passados abaixo:

{
   "ID_CENTRO_ESTOQUE": 1,
   "ORIGEM_DESTINO": "ORIGEM",
   "DATA": "2025-02-28",
   "JUSTIFICATIVA": "Remoção de materiais do estoque",
   "ITENS": [
       {
           "COD_ITEM": "1030001",
           "QUANT": 2,
           "LOTE_PRODUTO": "LOTE1",
           "IDENTIFICACOES": [
               {
                   "COD_MATERIAL_IDENT": "SERIAL001"
               },
               {
                   "COD_MATERIAL_IDENT": "SERIAL002"
               }
           ]
       },
       {
           "COD_ITEM": "1030001",
           "QUANT": 1,
           "LOTE_PRODUTO": "LOTE2",
           "IDENTIFICACOES": [
               {
                   "COD_MATERIAL_IDENT": "SERIAL003"
               }
           ]
       }
   ]
}

Exemplo 2: será incluído 4 unidades do item “1030001” no centro de estoque de id 1.

{
  "ID_CENTRO_ESTOQUE": 1,
  "ORIGEM_DESTINO": "DESTINO",
  "DATA": "2025-02-28",
  "JUSTIFICATIVA": "Inclusão no estoque",
  "ITENS": [
      {
          "COD_ITEM": "1030001",
          "QUANT": 4,
          "PRECO_UN": 32.4
      }
  ]
}

Retorno da requisição

Um json com o status da requisição: sucesso ou erro. No caso de erro, é retornada uma mensagem descritiva do erro.

Exemplo 1: Sucesso 200 OK

{
   "status": "success",
   "data": {
       "ID_MOV_ESPECIAL": 13943
   }
}

Exemplo 2: Erro 400 Bad Request

{
    "status": "error",
    "message": "O tipo de item 'Material Elétrico' dos itens não tem vínculo com o centro de estoque de destino."
}

Exemplo no Postman:

06. Incluir Movimentação Especial

Notas de devolução#

Retorno da requisição#

Notas de devolução

Retorno da requisição