Almacenes

Movimientos de almacén - Registro

POST/suite/erp/almacenes/movimientos

Registra una entrada, salida, ajuste o traspaso de inventario. Envía exactamente uno de entrada, salida, ajuste o traspaso con valor 1; si no se envía ninguno, se procesa una entrada. La solicitud valida que los productos, almacenes, operaciones, existencias y datos de trazabilidad correspondan a la empresa autenticada.

Parámetros

Nombre	Tipo	Descripción
`entrada`	Integer	Envía `1` para registrar una entrada. No lo combines con los demás selectores de movimiento.
`salida`	Integer	Envía `1` para registrar una salida. No lo combines con los demás selectores de movimiento.
`ajuste`	Integer	Envía `1` para registrar un ajuste de existencia. No lo combines con los demás selectores de movimiento.
`traspaso`	Integer	Envía `1` para transferir inventario entre almacenes. No lo combines con los demás selectores de movimiento.
`tkAlmacen`	UUID	Identificador del almacén de una entrada, salida o ajuste. Es obligatorio para esos tres tipos de movimiento.
`tkOperacion`	String	Identificador de la operación de inventario para una entrada, salida o ajuste. Es obligatorio para esos tres tipos de movimiento.
`productos`	Array	Productos de una entrada, salida o traspaso. Cada elemento incluye `tkProducto`, `cantidad`, `unidadVenta` para entradas o `unidad` para salidas y traspasos, y opcionalmente `comentario` y `datosAdicionales`. Es obligatorio para esos tres tipos de movimiento.
`tkProducto`	UUID	Identificador del producto que se ajusta. Es obligatorio cuando `ajuste` es `1`.
`cantidad`	Decimal	Cantidad final de existencia para el ajuste. Se usa cuando `ajuste` es `1`.
`reservado`	Decimal	Cantidad reservada después del ajuste. No puede ser mayor que `cantidad`.
`comentarios`	String	Comentario del ajuste de inventario.
`tkAlmacenOrigen`	UUID	Identificador del almacén de origen. Es obligatorio cuando `traspaso` es `1` y debe ser distinto a `tkAlmacenDestino`.
`tkAlmacenDestino`	UUID	Identificador del almacén de destino. Es obligatorio cuando `traspaso` es `1` y debe ser distinto a `tkAlmacenOrigen`.
`tkOperacionSalida`	String	Identificador de la operación que se registra en el almacén de origen. Es obligatorio cuando `traspaso` es `1`.
`tkOperacionEntrada`	String	Identificador de la operación que se registra en el almacén de destino. Es obligatorio cuando `traspaso` es `1`.

Respuesta

Nombre	Tipo	Descripción
`code`	Integer	Código del resultado. Es `0` cuando el movimiento se registra correctamente.
`msg`	String	Mensaje que describe el resultado de la operación.
`details`	Array<Object>	Información adicional en forma de arreglo cuando la operación no puede completarse.

Solicitud

curl --request POST \
  --url 'https://api.upnify.com/suite/erp/almacenes/movimientos' \
  --header 'Content-Type: application/json' \
  --header 'token: 00000000-0000-4000-8000-000000000001' \
  --data '{"entrada":1,"tkAlmacen":"00000000-0000-4000-8000-000000000010","tkOperacion":"00000000-0000-4000-8000-000000000070","productos":[{"tkProducto":"00000000-0000-4000-8000-000000000040","cantidad":5,"unidadVenta":"Pieza","comentario":"Entrada de inventario"}]}'const enviarSolicitud = async () => {
  const response = await fetch("https://api.upnify.com/suite/erp/almacenes/movimientos", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      token: "00000000-0000-4000-8000-000000000001",
    },
    body: JSON.stringify({
      "entrada": 1,
      "tkAlmacen": "00000000-0000-4000-8000-000000000010",
      "tkOperacion": "00000000-0000-4000-8000-000000000070",
      "productos": [
        {
          "tkProducto": "00000000-0000-4000-8000-000000000040",
          "cantidad": 5,
          "unidadVenta": "Pieza",
          "comentario": "Entrada de inventario"
        }
      ]
    }),
  });

  return response.json();
};

enviarSolicitud().then(console.log);// Node.js 18 o posterior
const enviarSolicitud = async () => {
  const response = await fetch("https://api.upnify.com/suite/erp/almacenes/movimientos", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      token: "00000000-0000-4000-8000-000000000001",
    },
    body: JSON.stringify({
      "entrada": 1,
      "tkAlmacen": "00000000-0000-4000-8000-000000000010",
      "tkOperacion": "00000000-0000-4000-8000-000000000070",
      "productos": [
        {
          "tkProducto": "00000000-0000-4000-8000-000000000040",
          "cantidad": 5,
          "unidadVenta": "Pieza",
          "comentario": "Entrada de inventario"
        }
      ]
    }),
  });

  return response.json();
};

enviarSolicitud().then(console.log);import requests

response = requests.post(
    "https://api.upnify.com/suite/erp/almacenes/movimientos",
    headers={
        "Content-Type": "application/json",
        "token": "00000000-0000-4000-8000-000000000001",
    },
    json={
        "entrada": 1,
        "tkAlmacen": "00000000-0000-4000-8000-000000000010",
        "tkOperacion": "00000000-0000-4000-8000-000000000070",
        "productos": [
          {
            "tkProducto": "00000000-0000-4000-8000-000000000040",
            "cantidad": 5,
            "unidadVenta": "Pieza",
            "comentario": "Entrada de inventario"
          }
        ]
    }
)
response.raise_for_status()
resultado = response.json()package main

import (
  "encoding/json"
  "net/http"
  "strings"
)

func main() {
  body := strings.NewReader(`{"entrada":1,"tkAlmacen":"00000000-0000-4000-8000-000000000010","tkOperacion":"00000000-0000-4000-8000-000000000070","productos":[{"tkProducto":"00000000-0000-4000-8000-000000000040","cantidad":5,"unidadVenta":"Pieza","comentario":"Entrada de inventario"}]}`)
  request, err := http.NewRequest(http.MethodPost, "https://api.upnify.com/suite/erp/almacenes/movimientos", body)
  if err != nil {
    panic(err)
  }
  request.Header.Set("token", "00000000-0000-4000-8000-000000000001")
  request.Header.Set("Content-Type", "application/json")

  response, err := http.DefaultClient.Do(request)
  if err != nil {
    panic(err)
  }
  defer response.Body.Close()

  var resultado any
  if err := json.NewDecoder(response.Body).Decode(&resultado); err != nil {
    panic(err)
  }
}using System.Net.Http;
using System.Net.Http.Json;

using var client = new HttpClient();
using var request = new HttpRequestMessage(
    HttpMethod.Post,
    "https://api.upnify.com/suite/erp/almacenes/movimientos"
)
{
    Content = JsonContent.Create(new
    {
        entrada = 1,
        tkAlmacen = "00000000-0000-4000-8000-000000000010",
        tkOperacion = "00000000-0000-4000-8000-000000000070",
        productos = new[]
        {
            new
            {
                tkProducto = "00000000-0000-4000-8000-000000000040",
                cantidad = 5,
                unidadVenta = "Pieza",
                comentario = "Entrada de inventario"
            }
        }
    })
};
request.Headers.Add("token", "00000000-0000-4000-8000-000000000001");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var resultado = await response.Content.ReadAsStringAsync();

curl --request POST \
  --url 'https://api.upnify.com/suite/erp/almacenes/movimientos' \
  --header 'Content-Type: application/json' \
  --header 'token: 00000000-0000-4000-8000-000000000001' \
  --data '{"salida":1,"tkAlmacen":"00000000-0000-4000-8000-000000000010","tkOperacion":"00000000-0000-4000-8000-000000000071","productos":[{"tkProducto":"00000000-0000-4000-8000-000000000040","cantidad":2,"unidad":"Pieza","comentario":"Salida de inventario"}]}'const enviarSolicitud = async () => {
  const response = await fetch("https://api.upnify.com/suite/erp/almacenes/movimientos", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      token: "00000000-0000-4000-8000-000000000001",
    },
    body: JSON.stringify({
      "salida": 1,
      "tkAlmacen": "00000000-0000-4000-8000-000000000010",
      "tkOperacion": "00000000-0000-4000-8000-000000000071",
      "productos": [
        {
          "tkProducto": "00000000-0000-4000-8000-000000000040",
          "cantidad": 2,
          "unidad": "Pieza",
          "comentario": "Salida de inventario"
        }
      ]
    }),
  });

  return response.json();
};

enviarSolicitud().then(console.log);// Node.js 18 o posterior
const enviarSolicitud = async () => {
  const response = await fetch("https://api.upnify.com/suite/erp/almacenes/movimientos", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      token: "00000000-0000-4000-8000-000000000001",
    },
    body: JSON.stringify({
      "salida": 1,
      "tkAlmacen": "00000000-0000-4000-8000-000000000010",
      "tkOperacion": "00000000-0000-4000-8000-000000000071",
      "productos": [
        {
          "tkProducto": "00000000-0000-4000-8000-000000000040",
          "cantidad": 2,
          "unidad": "Pieza",
          "comentario": "Salida de inventario"
        }
      ]
    }),
  });

  return response.json();
};

enviarSolicitud().then(console.log);import requests

response = requests.post(
    "https://api.upnify.com/suite/erp/almacenes/movimientos",
    headers={
        "Content-Type": "application/json",
        "token": "00000000-0000-4000-8000-000000000001",
    },
    json={
        "salida": 1,
        "tkAlmacen": "00000000-0000-4000-8000-000000000010",
        "tkOperacion": "00000000-0000-4000-8000-000000000071",
        "productos": [
          {
            "tkProducto": "00000000-0000-4000-8000-000000000040",
            "cantidad": 2,
            "unidad": "Pieza",
            "comentario": "Salida de inventario"
          }
        ]
    }
)
response.raise_for_status()
resultado = response.json()package main

import (
  "encoding/json"
  "net/http"
  "strings"
)

func main() {
  body := strings.NewReader(`{"salida":1,"tkAlmacen":"00000000-0000-4000-8000-000000000010","tkOperacion":"00000000-0000-4000-8000-000000000071","productos":[{"tkProducto":"00000000-0000-4000-8000-000000000040","cantidad":2,"unidad":"Pieza","comentario":"Salida de inventario"}]}`)
  request, err := http.NewRequest(http.MethodPost, "https://api.upnify.com/suite/erp/almacenes/movimientos", body)
  if err != nil {
    panic(err)
  }
  request.Header.Set("token", "00000000-0000-4000-8000-000000000001")
  request.Header.Set("Content-Type", "application/json")

  response, err := http.DefaultClient.Do(request)
  if err != nil {
    panic(err)
  }
  defer response.Body.Close()

  var resultado any
  if err := json.NewDecoder(response.Body).Decode(&resultado); err != nil {
    panic(err)
  }
}using System.Net.Http;
using System.Net.Http.Json;

using var client = new HttpClient();
using var request = new HttpRequestMessage(
    HttpMethod.Post,
    "https://api.upnify.com/suite/erp/almacenes/movimientos"
)
{
    Content = JsonContent.Create(new
    {
        salida = 1,
        tkAlmacen = "00000000-0000-4000-8000-000000000010",
        tkOperacion = "00000000-0000-4000-8000-000000000071",
        productos = new[]
        {
            new
            {
                tkProducto = "00000000-0000-4000-8000-000000000040",
                cantidad = 2,
                unidad = "Pieza",
                comentario = "Salida de inventario"
            }
        }
    })
};
request.Headers.Add("token", "00000000-0000-4000-8000-000000000001");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var resultado = await response.Content.ReadAsStringAsync();

curl --request POST \
  --url 'https://api.upnify.com/suite/erp/almacenes/movimientos' \
  --header 'Content-Type: application/json' \
  --header 'token: 00000000-0000-4000-8000-000000000001' \
  --data '{"ajuste":1,"tkAlmacen":"00000000-0000-4000-8000-000000000010","tkProducto":"00000000-0000-4000-8000-000000000040","tkOperacion":"00000000-0000-4000-8000-000000000072","cantidad":20,"reservado":0,"comentarios":"Ajuste de inventario"}'const enviarSolicitud = async () => {
  const response = await fetch("https://api.upnify.com/suite/erp/almacenes/movimientos", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      token: "00000000-0000-4000-8000-000000000001",
    },
    body: JSON.stringify({
      "ajuste": 1,
      "tkAlmacen": "00000000-0000-4000-8000-000000000010",
      "tkProducto": "00000000-0000-4000-8000-000000000040",
      "tkOperacion": "00000000-0000-4000-8000-000000000072",
      "cantidad": 20,
      "reservado": 0,
      "comentarios": "Ajuste de inventario"
    }),
  });

  return response.json();
};

enviarSolicitud().then(console.log);// Node.js 18 o posterior
const enviarSolicitud = async () => {
  const response = await fetch("https://api.upnify.com/suite/erp/almacenes/movimientos", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      token: "00000000-0000-4000-8000-000000000001",
    },
    body: JSON.stringify({
      "ajuste": 1,
      "tkAlmacen": "00000000-0000-4000-8000-000000000010",
      "tkProducto": "00000000-0000-4000-8000-000000000040",
      "tkOperacion": "00000000-0000-4000-8000-000000000072",
      "cantidad": 20,
      "reservado": 0,
      "comentarios": "Ajuste de inventario"
    }),
  });

  return response.json();
};

enviarSolicitud().then(console.log);import requests

response = requests.post(
    "https://api.upnify.com/suite/erp/almacenes/movimientos",
    headers={
        "Content-Type": "application/json",
        "token": "00000000-0000-4000-8000-000000000001",
    },
    json={
        "ajuste": 1,
        "tkAlmacen": "00000000-0000-4000-8000-000000000010",
        "tkProducto": "00000000-0000-4000-8000-000000000040",
        "tkOperacion": "00000000-0000-4000-8000-000000000072",
        "cantidad": 20,
        "reservado": 0,
        "comentarios": "Ajuste de inventario"
    }
)
response.raise_for_status()
resultado = response.json()package main

import (
  "encoding/json"
  "net/http"
  "strings"
)

func main() {
  body := strings.NewReader(`{"ajuste":1,"tkAlmacen":"00000000-0000-4000-8000-000000000010","tkProducto":"00000000-0000-4000-8000-000000000040","tkOperacion":"00000000-0000-4000-8000-000000000072","cantidad":20,"reservado":0,"comentarios":"Ajuste de inventario"}`)
  request, err := http.NewRequest(http.MethodPost, "https://api.upnify.com/suite/erp/almacenes/movimientos", body)
  if err != nil {
    panic(err)
  }
  request.Header.Set("token", "00000000-0000-4000-8000-000000000001")
  request.Header.Set("Content-Type", "application/json")

  response, err := http.DefaultClient.Do(request)
  if err != nil {
    panic(err)
  }
  defer response.Body.Close()

  var resultado any
  if err := json.NewDecoder(response.Body).Decode(&resultado); err != nil {
    panic(err)
  }
}using System.Net.Http;
using System.Net.Http.Json;

using var client = new HttpClient();
using var request = new HttpRequestMessage(
    HttpMethod.Post,
    "https://api.upnify.com/suite/erp/almacenes/movimientos"
)
{
    Content = JsonContent.Create(new
    {
        ajuste = 1,
        tkAlmacen = "00000000-0000-4000-8000-000000000010",
        tkProducto = "00000000-0000-4000-8000-000000000040",
        tkOperacion = "00000000-0000-4000-8000-000000000072",
        cantidad = 20,
        reservado = 0,
        comentarios = "Ajuste de inventario"
    })
};
request.Headers.Add("token", "00000000-0000-4000-8000-000000000001");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var resultado = await response.Content.ReadAsStringAsync();

curl --request POST \
  --url 'https://api.upnify.com/suite/erp/almacenes/movimientos' \
  --header 'Content-Type: application/json' \
  --header 'token: 00000000-0000-4000-8000-000000000001' \
  --data '{"traspaso":1,"tkAlmacenOrigen":"00000000-0000-4000-8000-000000000010","tkAlmacenDestino":"00000000-0000-4000-8000-000000000011","tkOperacionSalida":"00000000-0000-4000-8000-000000000071","tkOperacionEntrada":"00000000-0000-4000-8000-000000000070","productos":[{"tkProducto":"00000000-0000-4000-8000-000000000040","cantidad":2,"unidad":"Pieza","comentario":"Traspaso interno"}]}'const enviarSolicitud = async () => {
  const response = await fetch("https://api.upnify.com/suite/erp/almacenes/movimientos", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      token: "00000000-0000-4000-8000-000000000001",
    },
    body: JSON.stringify({
      "traspaso": 1,
      "tkAlmacenOrigen": "00000000-0000-4000-8000-000000000010",
      "tkAlmacenDestino": "00000000-0000-4000-8000-000000000011",
      "tkOperacionSalida": "00000000-0000-4000-8000-000000000071",
      "tkOperacionEntrada": "00000000-0000-4000-8000-000000000070",
      "productos": [
        {
          "tkProducto": "00000000-0000-4000-8000-000000000040",
          "cantidad": 2,
          "unidad": "Pieza",
          "comentario": "Traspaso interno"
        }
      ]
    }),
  });

  return response.json();
};

enviarSolicitud().then(console.log);// Node.js 18 o posterior
const enviarSolicitud = async () => {
  const response = await fetch("https://api.upnify.com/suite/erp/almacenes/movimientos", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      token: "00000000-0000-4000-8000-000000000001",
    },
    body: JSON.stringify({
      "traspaso": 1,
      "tkAlmacenOrigen": "00000000-0000-4000-8000-000000000010",
      "tkAlmacenDestino": "00000000-0000-4000-8000-000000000011",
      "tkOperacionSalida": "00000000-0000-4000-8000-000000000071",
      "tkOperacionEntrada": "00000000-0000-4000-8000-000000000070",
      "productos": [
        {
          "tkProducto": "00000000-0000-4000-8000-000000000040",
          "cantidad": 2,
          "unidad": "Pieza",
          "comentario": "Traspaso interno"
        }
      ]
    }),
  });

  return response.json();
};

enviarSolicitud().then(console.log);import requests

response = requests.post(
    "https://api.upnify.com/suite/erp/almacenes/movimientos",
    headers={
        "Content-Type": "application/json",
        "token": "00000000-0000-4000-8000-000000000001",
    },
    json={
        "traspaso": 1,
        "tkAlmacenOrigen": "00000000-0000-4000-8000-000000000010",
        "tkAlmacenDestino": "00000000-0000-4000-8000-000000000011",
        "tkOperacionSalida": "00000000-0000-4000-8000-000000000071",
        "tkOperacionEntrada": "00000000-0000-4000-8000-000000000070",
        "productos": [
          {
            "tkProducto": "00000000-0000-4000-8000-000000000040",
            "cantidad": 2,
            "unidad": "Pieza",
            "comentario": "Traspaso interno"
          }
        ]
    }
)
response.raise_for_status()
resultado = response.json()package main

import (
  "encoding/json"
  "net/http"
  "strings"
)

func main() {
  body := strings.NewReader(`{"traspaso":1,"tkAlmacenOrigen":"00000000-0000-4000-8000-000000000010","tkAlmacenDestino":"00000000-0000-4000-8000-000000000011","tkOperacionSalida":"00000000-0000-4000-8000-000000000071","tkOperacionEntrada":"00000000-0000-4000-8000-000000000070","productos":[{"tkProducto":"00000000-0000-4000-8000-000000000040","cantidad":2,"unidad":"Pieza","comentario":"Traspaso interno"}]}`)
  request, err := http.NewRequest(http.MethodPost, "https://api.upnify.com/suite/erp/almacenes/movimientos", body)
  if err != nil {
    panic(err)
  }
  request.Header.Set("token", "00000000-0000-4000-8000-000000000001")
  request.Header.Set("Content-Type", "application/json")

  response, err := http.DefaultClient.Do(request)
  if err != nil {
    panic(err)
  }
  defer response.Body.Close()

  var resultado any
  if err := json.NewDecoder(response.Body).Decode(&resultado); err != nil {
    panic(err)
  }
}using System.Net.Http;
using System.Net.Http.Json;

using var client = new HttpClient();
using var request = new HttpRequestMessage(
    HttpMethod.Post,
    "https://api.upnify.com/suite/erp/almacenes/movimientos"
)
{
    Content = JsonContent.Create(new
    {
        traspaso = 1,
        tkAlmacenOrigen = "00000000-0000-4000-8000-000000000010",
        tkAlmacenDestino = "00000000-0000-4000-8000-000000000011",
        tkOperacionSalida = "00000000-0000-4000-8000-000000000071",
        tkOperacionEntrada = "00000000-0000-4000-8000-000000000070",
        productos = new[]
        {
            new
            {
                tkProducto = "00000000-0000-4000-8000-000000000040",
                cantidad = 2,
                unidad = "Pieza",
                comentario = "Traspaso interno"
            }
        }
    })
};
request.Headers.Add("token", "00000000-0000-4000-8000-000000000001");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var resultado = await response.Content.ReadAsStringAsync();

Respuesta

[
  {
    "code": 0,
    "msg": "Ok"
  }
]

Movimientos de almacén - Registro

Parámetros

Respuesta

Solicitud

Registrar una entrada

Registrar una salida

Registrar un ajuste

Registrar un traspaso

Respuesta

Movimiento registrado