cURL
curl --request POST \
--url https://app.stockshift.io/api/v1/inventory/bulk-previews \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"lines": [
{
"item": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"quantity": "<string>",
"location_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"lot": "<string>",
"serial": "<string>",
"piece": "<string>"
}
]
}
'import requests
url = "https://app.stockshift.io/api/v1/inventory/bulk-previews"
payload = { "lines": [
{
"item": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"quantity": "<string>",
"location_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"lot": "<string>",
"serial": "<string>",
"piece": "<string>"
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.stockshift.io/api/v1/inventory/bulk-previews",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'lines' => [
[
'item' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'quantity' => '<string>',
'location_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'lot' => '<string>',
'serial' => '<string>',
'piece' => '<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.stockshift.io/api/v1/inventory/bulk-previews"
payload := strings.NewReader("{\n \"lines\": [\n {\n \"item\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"quantity\": \"<string>\",\n \"location_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"lot\": \"<string>\",\n \"serial\": \"<string>\",\n \"piece\": \"<string>\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"data": {
"action": "move",
"destination_id": "<string>",
"lines": [
{
"line": 123,
"item": "<string>",
"location_id": "<string>",
"lot": "<string>",
"serial": "<string>",
"piece": "<string>",
"quantity": "<string>",
"flags": [
{
"flag": "blocked",
"facts": {
"reason": "<string>",
"status": "<string>",
"held": "<string>",
"expires_on": "<string>",
"days_left": 123,
"minimum_days": 123,
"reserved": "<string>",
"free": "<string>",
"lots": [
"<string>"
],
"merged_into": 123,
"permission": "<string>",
"entitlement": "<string>"
},
"choices": [
"leave"
]
}
]
}
]
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}Vistas previas masivas
Previsualiza una acción masiva de existencias
Revisa una lista de hasta 100 líneas antes de moverlas, ajustarlas, retenerlas o imprimirlas, con un comando por línea. No se cambia nada.
Cada línea se devuelve con sus indicadores:
blocked: las existencias están retenidas o vencidas, las cubre una regla de testigo o son un lote que el destino rechaza.reserved: los documentos retienen parte de las existencias.mixed_lots: el destino ya tiene otro lote.short_dated: el lote vence antes de lo que permite la regla del destino.duplicate: la línea se fusionó con otra.not_permitted: el miembro detrás del token no puede ver las existencias, le falta el permiso o el plan no incluye la función.
Cada indicador trae sus datos y las opciones que permite. Un indicador sin opciones saca la línea de la lista. Al aplicar los comandos, envía las opciones elegidas como decisions de cada comando, con el mismo bulk_id en cada línea. Un indicador sin decidir se rechaza con decision_required.
Las cantidades están en la unidad base del artículo. Las líneas de un ajuste son negativas para sacar existencias.
Requiere el permiso inventory.stock.view y un token con inventory:read. Desde un dispositivo, el plan necesita operaciones móviles.
POST
/
inventory
/
bulk-previews
cURL
curl --request POST \
--url https://app.stockshift.io/api/v1/inventory/bulk-previews \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"lines": [
{
"item": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"quantity": "<string>",
"location_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"lot": "<string>",
"serial": "<string>",
"piece": "<string>"
}
]
}
'import requests
url = "https://app.stockshift.io/api/v1/inventory/bulk-previews"
payload = { "lines": [
{
"item": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"quantity": "<string>",
"location_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"lot": "<string>",
"serial": "<string>",
"piece": "<string>"
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.stockshift.io/api/v1/inventory/bulk-previews",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'lines' => [
[
'item' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'quantity' => '<string>',
'location_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'lot' => '<string>',
'serial' => '<string>',
'piece' => '<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.stockshift.io/api/v1/inventory/bulk-previews"
payload := strings.NewReader("{\n \"lines\": [\n {\n \"item\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"quantity\": \"<string>\",\n \"location_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"lot\": \"<string>\",\n \"serial\": \"<string>\",\n \"piece\": \"<string>\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"data": {
"action": "move",
"destination_id": "<string>",
"lines": [
{
"line": 123,
"item": "<string>",
"location_id": "<string>",
"lot": "<string>",
"serial": "<string>",
"piece": "<string>",
"quantity": "<string>",
"flags": [
{
"flag": "blocked",
"facts": {
"reason": "<string>",
"status": "<string>",
"held": "<string>",
"expires_on": "<string>",
"days_left": 123,
"minimum_days": 123,
"reserved": "<string>",
"free": "<string>",
"lots": [
"<string>"
],
"merged_into": 123,
"permission": "<string>",
"entitlement": "<string>"
},
"choices": [
"leave"
]
}
]
}
]
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}Autorizaciones
apiKeyoauth2
Para tus propios scripts e integraciones de servidor a servidor. Crea una clave en la app en Configuración > Acceso > Claves de API y cópiala entonces, porque se muestra una sola vez. Envíala como Authorization: Bearer <key>. La clave actúa como el miembro que la creó, en la organización en la que se creó. Una llamada necesita el permiso del miembro y uno de los alcances de la clave, como inventory:read o sales:write. Una clave con * tiene todos los alcances.
Cuerpo
application/json
Una lista masiva para revisar antes de aplicarla: una acción, un destino solo para un movimiento, un motivo solo para un ajuste y de 1 a 100 líneas. Las cantidades están en la unidad base del artículo. Las líneas de un ajuste pueden ser negativas, para sacar existencias.
Lo que hace la lista masiva con cada línea: move, adjust, hold o print.
move Mueve cada línea a la ubicación de destino. Requiere inventory.transfers.manage. |
adjust Ajusta las existencias de cada línea hacia arriba o hacia abajo. Requiere inventory.stock.adjust. |
hold Retiene las existencias de cada línea con un cambio de estado. Requiere inventory.stock.adjust. |
print Imprime una etiqueta para cada línea. Requiere labels.print. |
Opciones disponibles:
move, adjust, hold, print Las líneas de la lista, de 1 a 100.
Required array length:
1 - 100 elementsShow child attributes
Show child attributes
El ID de la ubicación a la que se mueven las existencias. Es obligatorio para move y no se permite en ninguna otra acción.
Por qué cambian las existencias, solo para adjust: found, damaged, lost, destroyed, correction,
opening_balance u other.
Opciones disponibles:
found, damaged, lost, destroyed, correction, opening_balance, other, null Respuesta
BulkPreviewResource
Una lista masiva revisada, con cada línea y sus indicadores.
Show child attributes
Show child attributes
¿Esta página le ayudó?